"Referenties zijn ongeldig" is een van de meest voorkomende fouten bij het vernieuwen van Power BI en een van de meest frustrerende om te diagnosticeren, omdat het foutbericht niet aangeeft welke referenties onjuist zijn of waarom ze zijn geweigerd.
Waar referenties in Power BI worden opgeslagen
Power BI slaat referenties op verschillende plaatsen op, afhankelijk van het verbindingstype:
- Gateway-verbonden datasets: Referenties worden opgeslagen in de gateway-clusterconfiguratie (Gateways beheren → Instellingen voor gegevensbronnen). Deze zijn gescheiden van uw Windows- of databasereferenties; ze moeten expliciet worden bijgewerkt wanneer het onderliggende wachtwoord wordt gewijzigd.
- Cloud-to-cloud-verbindingen: Referenties worden opgeslagen in de instellingen voor gegevensbronnen van de dataset in Power BI Service (toegankelijk via Datasetinstellingen → Referenties voor gegevensbronnen). Deze zijn ook gescheiden van de referentieopslag van het onderliggende bronsysteem.
- OAuth-verbonden bronnen (SharePoint, Dynamics, Salesforce): Referenties hebben de vorm van een OAuth-token dat is opgeslagen bij uw gebruikersaccount. Deze verlopen en vereisen herautorisatie via de workflow 'Referenties bewerken'.
Veelvoorkomende oorzaken en oplossingen
Wachtwoordwijziging serviceaccount: Dit is de meest voorkomende oorzaak voor on-premises SQL Server- en Azure SQL-datasets. Het databasewachtwoord is gewijzigd door IT-beveiligingsrotatie, maar de opgeslagen referenties van de gateway zijn niet bijgewerkt. Oplossing: ga naar Gateways beheren, zoek de gegevensbron en voer het bijgewerkte wachtwoord opnieuw in.
Verlopen OAuth-token: Voor SharePoint Online-, Dynamics 365- of Salesforce-verbindingen die OAuth gebruiken, verloopt het opgeslagen token na een periode van inactiviteit of wanneer de machtigingen van het gebruikersaccount wijzigen. Oplossing: ga naar Datasetinstellingen → Referenties van gegevensbron en klik op 'Referenties bewerken' om opnieuw te autoriseren.
Account geblokkeerd: Het serviceaccount dat voor de databaseverbinding wordt gebruikt, is geblokkeerd vanwege mislukte aanmeldpogingen (vaak door een gelijktijdig proces met een verouderd wachtwoord). Oplossing: deblokkeer het account in Active Directory en werk de gatewayreferenties bij.
Verloopdatum Azure AD-serviceprincipal: Voor beheerde identiteiten of serviceprincipalverbindingen met Azure-services is het certificaat of geheim mogelijk verlopen. Oplossing: vernieuw het geheim/certificaat in Azure AD en werk de verbindingsconfiguratie bij.
Verloopdatum SAS-token: Voor Azure Blob Storage- of ADLS-verbindingen met SAS-tokens heeft het token een vastgestelde vervaldatum. Oplossing: genereer een nieuw SAS-token met een geschikte vervaldatum en werk de referenties van de gegevensbron bij.
Diagnose wanneer referenties geldig zijn maar de fout blijft bestaan
Soms lost het opnieuw invoeren van de juiste referenties de fout niet op. Controleer: het account heeft mogelijk geen leesrechten op de database (een machtigingsprobleem, niet alleen een verkeerd wachtwoord), de server vereist mogelijk Kerberos-authenticatie en het account kan dit niet uitvoeren of de gateway-gegevensbron is gekoppeld aan de verkeerde server/databasecombinatie.