Foretag fejlfinding af datagateways i det lokale miljø

I denne artikel beskrives almindelige problemer, der kan opstå, når du bruger datagatewayen i det lokale miljø sammen med Power BI-tjeneste. Hvis du støder på et problem, der ikke er angivet her, skal du gå til Power BI-community'et eller oprette en supportanmodning.

Konfiguration

Fejl: Power BI-tjeneste rapporterede lokal gateway som utilgængelig

I slutningen af konfigurationen kaldes Power BI-tjeneste igen for at validere gatewayen. Den Power BI-tjeneste rapporterer ikke gatewayen som live. Genstart af Windows-tjenesten kan tillade, at kommunikationen lykkes. Hvis du vil have flere oplysninger, kan du indsamle og gennemse loggene som beskrevet i Indsaml logge fra appen datagateway i det lokale miljø.

Medbring dit eget Azure Relay

Hvis du har aktiveret BYO (BYO) Azure Relay (Bring Your Own) og oplever forbindelsesproblemer, skal du sikre dig, at Private Link ikke er aktiveret på det pågældende Relay-navneområde – denne konfiguration understøttes i øjeblikket ikke med gatewayens BYO-relæfunktion. Hvis du ikke har brug for brugerdefinerede relækontrolelementer, skal du vende tilbage til det administrerede relæ, der er standard, ved at deaktivere BYO-relæ.

Datakilder

Fejl! Der kunne ikke oprettes forbindelse. Detaljer: "Legitimationsoplysninger for forbindelsen er ugyldige"

I Vis detaljer vises den fejlmeddelelse, der blev modtaget fra datakilden. For SQL Server kan du se en meddelelse som den, der følger:

Login failed for user 'username'.

Kontrollér, at du har det korrekte brugernavn og den korrekte adgangskode. Kontrollér også, at disse legitimationsoplysninger kan oprette forbindelse til datakilden. Sørg for, at den konto, der bruges, svarer til godkendelsesmetoden.

Fejl! Der kunne ikke oprettes forbindelse. Detaljer: "Der kan ikke oprettes forbindelse til databasen"

Du kunne oprette forbindelse til serveren, men ikke til den angivne database. Kontrollér navnet på databasen, og at brugernavnet og adgangskoden har den rette tilladelse til at få adgang til databasen.

I Vis detaljer vises den fejlmeddelelse, der blev modtaget fra datakilden. For SQL Server kan du se noget i stil med følgende meddelelse:

Cannot open database "AdventureWorks" requested by the login. The login failed. Login failed for user 'username'.

Fejl! Der kunne ikke oprettes forbindelse. Detaljer: "Ukendt fejl i datagateway"

Denne fejl kan opstå af forskellige årsager. Sørg for at validere, at du kan oprette forbindelse til datakilden fra den computer, der er vært for gatewayen. Denne situation kan skyldes, at serveren ikke er tilgængelig.

I Vis detaljer kan du se en fejlkode for DM_GWPipeline_UnknownError.

Du kan også se i Hændelseslogfiler Programmer og tjenestelogge> Se Hændelseslogge for at få en detaljeret beskrivelse.

Fejl: Der opstod en fejl under forsøg på at oprette forbindelse til <serveren>. Detaljer: "Vi har nået datagatewayen, men gatewayen kan ikke få adgang til datakilden i det lokale miljø.".

Du kunne ikke oprette forbindelse til den angivne datakilde. Sørg for at validere de oplysninger, der er angivet for den pågældende datakilde.

I Vis detaljer kan du se en fejlkode for DM_GWPipeline_Gateway_DataSourceAccessError.

Hvis den underliggende fejlmeddelelse ligner den efterfølgende, betyder det, at den konto, du bruger til datakilden, ikke er serveradministrator for den pågældende Analysis Services-forekomst. Du kan få flere oplysninger under Tildel serveradministratorrettigheder til en Analysis Services-forekomst.

The 'CONTOSO\account' value of the 'EffectiveUserName' XML for Analysis property is not valid.

Hvis den underliggende fejlmeddelelse ligner den efterfølgende, kan det betyde, at tjenestekontoen for Analysis Services mangler katalogattributten Token-Groups-Global-And-Universal (TGGAU).

The username or password is incorrect.

Domæner med kompatibilitetsadgang fra før Windows 2000 har TGGAU-attributten aktiveret. De fleste nyoprettede domæner aktiverer ikke denne attribut som standard. Du kan få flere oplysninger under Nogle programmer og API'er kræver adgang til godkendelsesoplysninger om kontoobjekter.

Følg disse trin for at bekræfte, om attributten er aktiveret.

1. Opret forbindelse til Analysis Services-computeren i SQL Server Management Studio. I egenskaberne for avanceret forbindelse skal du inkludere EffectiveUserName for den pågældende bruger og se, om denne tilføjelse genskaber fejlen.

2. Du kan bruge værktøjet dsacls Active Directory til at validere, om attributten er angivet. Dette værktøj findes på en domænecontroller. Du skal vide, hvad det entydige domænenavn er for kontoen, og overføre dette navn til værktøjet.

   dsacls "CN=John Doe,CN=UserAccounts,DC=contoso,DC=com"
   

   Du vil se noget, der ligner følgende output, i resultaterne:

   Allow BUILTIN\Windows Authorization Access Group
                                   SPECIAL ACCESS for tokenGroupsGlobalAndUniversal
                                   READ PROPERTY
   

Du kan løse dette problem ved at aktivere TGGAU på den konto, der bruges til Analysis Services Windows-tjenesten.

En anden mulighed for "Brugernavnet eller adgangskoden er forkert."

Denne fejl kan også opstå, hvis Analysis Services-serveren er i et andet domæne end brugerne, og der ikke er etableret en tovejstillid.

Samarbejd med domæneadministratorerne om at bekræfte tillidsforholdet mellem domæner.

Det var ikke muligt at se datakilderne for datagatewayen i Hent data-oplevelsen for Analysis Services fra Power BI-tjeneste

Sørg for, at din konto er angivet under fanen Brugere i datakilden i gatewaykonfigurationen. Hvis du ikke har adgang til gatewayen, skal du kontakte administratoren af gatewayen og bede vedkommende om at bekræfte. Det er kun konti på listen Brugere , der kan se datakilden på Analysis Services-listen.

Fejl: Du har ikke nogen gateway installeret eller konfigureret for datakilderne i dette datasæt

Sørg for, at du har føjet en eller flere datakilder til gatewayen, som beskrevet i Tilføj en datakilde. Hvis gatewayen ikke vises på administrationsportalen under Administrer forbindelser og gateways, skal du rydde browsercachen eller logge af tjenesten og derefter logge på igen. I indstillingerne for den semantiske model viser gatewaysektionen kun gateways, der har matchende datakildedefinitioner for hver kilde, der bruges i det lokale miljø.

Fejl: Din datakilde kan ikke opdateres, fordi legitimationsoplysningerne er ugyldige

Du kunne oprette forbindelse til og opdatere den semantiske model uden kørselsfejl for forbindelsen, men i Power BI-tjeneste vises denne fejllinje. Når brugeren forsøger at opdatere legitimationsoplysningerne med kendte gode legitimationsoplysninger, vises der en fejl, der angiver, at de angivne legitimationsoplysninger er ugyldige.

Denne fejl kan opstå, når gatewayen forsøger at oprette en testforbindelse, selvom de angivne legitimationsoplysninger er acceptable, og opdateringshandlingen lykkes. Når gatewayen udfører en forbindelsestest, udelader den i øjeblikket valgfrie parametre (f.eks. Snowflake-lagersted, rolle eller andre avancerede indstillinger), og nogle connectorer kræver disse værdier.

Hvis opdateringen fuldføres korrekt, og du ikke oplever kørselsfejl, kan du ignorere disse testforbindelsesfejl for datakilder, der kræver valgfrie parametre.

Semantiske modeller

Fejl: Der er ikke plads nok til denne række

Denne fejl opstår, hvis en enkelt importeret række overskrider ca. 4 MB (grænse for komprimeret lagerprogram). Identificer den forkerte række i kilden, og filtrer eller opdel kolonner (f.eks. reducer store tekst-/blobfelter) før import.

Fejl: Det angivne servernavn stemmer ikke overens med servernavnet på SQL Server SSL-certifikatet

Denne fejl kan opstå, når det fælles certifikatnavn er for serverens fuldt kvalificerede domænenavn (FQDN), men du kun har angivet NetBIOS-navnet for serveren. Denne situation medfører en uoverensstemmelse for certifikatet. Du kan løse dette problem ved at gøre servernavnet i gatewaydatakilden og PBIX-filen til at bruge serverens FQDN.

Fejl: Du kan ikke se datagatewayen i det lokale miljø, når du konfigurerer planlagt opdatering

Nogle få forskellige scenarier kan være ansvarlige for denne fejl:

• Server- og databasenavnet stemmer ikke overens med det, der blev angivet i Power BI Desktop, og den datakilde, der er konfigureret for gatewayen. Disse navne skal være de samme (der skelnes ikke mellem store og små bogstaver).
• Din konto er ikke angivet under fanen Brugere i datakilden i gatewaykonfigurationen. Du skal føjes til denne liste af en gatewayadministrator.
• Din Power BI Desktop-fil har flere datakilder, og ikke alle disse datakilder er defineret i gatewayen. Alle kilder i det lokale miljø skal have en tilsvarende gatewaydatakildepost.

Fejl: De modtagne ukomprimerede data på gatewayklienten har overskredet grænsen

Begrænsningen er 10 GB ukomprimerede data pr. tabelsegment under opdateringen. Sådan optimerer du:

• Erstat gentagne lange strenge med surrogatnøgler.
• Fjern ubrugte tekstkolonner med høj kardinalitet.
• Opdel meget brede tabeller eller filtrer historiske partitioner.
• Overvej DirectQuery til ekstremt store faktatabeller.

Fejl! DM_GWPipeline_Gateway_SpooledOperationMissing

Et par forskellige scenarier kan forårsage denne fejl:

• Windows-gatewaytjenesten genstartede, mens opdateringen af den semantiske model eller forespørgslen var i gang (f.eks. programrettelse af operativsystemet eller tjenestenedbrud).
• En afbildning af en virtuel maskine blev klonet efter installation af gatewayen, hvilket forårsagede duplikeret flygtig tilstand.

Undgå kloning af maskiner efter installation – udfør en ny gatewayinstallation på nye værter. Gennemse gatewaytjenestelogge omkring fejltidsstemplet for genstartshændelser.

Rapporter

Fejl: Rapporten kunne ikke få adgang til datakilden, fordi du ikke har adgang til vores datakilde via en datagateway i det lokale miljø

Denne fejl skyldes normalt en af følgende:

• Oplysningerne om datakilden stemmer ikke overens med indholdet i det underliggende datasæt. Server- og databasenavnet skal matche mellem den datakilde, der er defineret for datagatewayen i det lokale miljø, og det, du angiver i Power BI Desktop. Hvis du bruger en IP-adresse i Power BI Desktop, skal datakilden for datagatewayen i det lokale miljø også bruge en IP-adresse.
• Der er ingen tilgængelig datakilde på nogen gateway i din organisation. Du kan konfigurere datakilden på en ny eller eksisterende datagateway i det lokale miljø.

Fejl: Adgangsfejl til datakilde (kontakt gatewayadministratoren)

Hvis denne rapport bruger en direkte Analysis Services-forbindelse, kan du støde på et problem, hvor den værdi, der overføres til EffectiveUserName, enten ikke er gyldig eller mangler tilladelser på Analysis Services-serveren. Der opstår typisk et godkendelsesproblem, fordi værdien EffectiveUserName ikke stemmer overens med et lokalt UPN (User Principal Name).

Følg disse trin for at bekræfte det effektive brugernavn.

1. Find det effektive brugernavn i gatewayloggene.

2. Når du har angivet værdien, skal du bekræfte, at den er korrekt. Hvis det er din bruger, kan du bruge følgende kommando fra en kommandoprompt til at se UPN'et. UPN ligner en mailadresse.

   whoami /upn
   

Du kan også se, hvad Power BI får fra Microsoft Entra ID.

1. Gå til Graph Explorer.
2. Vælg Log på i øverste højre hjørne.
3. Kør følgende Microsoft Graph-forespørgsel (Azure AD Graph er udgået):

https://graph.microsoft.com/v1.0/me

1. Søg efter egenskaben userPrincipalName i JSON-svaret.

Hvis dit Microsoft Entra UPN ikke svarer til dit lokale Active Directory-UPN, kan du bruge funktionen Tilknyt brugernavne til at erstatte det med en gyldig værdi. Du kan også arbejde sammen med din Power BI-administrator eller lokale Active Directory-administrator for at justere UPN'erne.

Kerberos

Hvis den underliggende databaseserver og datagateway i det lokale miljø ikke er konfigureret korrekt til begrænset Kerberos-delegering, skal du aktivere yderligere logføring på gatewayen. Derefter skal du undersøge baseret på fejlene eller sporene i gatewayens logfiler som udgangspunkt for fejlfinding. Hvis du vil indsamle gatewaylogge til visning, skal du se Indsaml logge fra appen datagateway i det lokale miljø.

Repræsentationsniveau

ImpersonationLevel er relateret til konfigurationen af serverens hovednavn (SPN) eller den lokale politikindstilling.

[DataMovement.PipeLine.GatewayDataAccess] About to impersonate user DOMAIN\User (IsAuthenticated: True, ImpersonationLevel: Identification)

Løsning (repræsentationsniveau)

Følg disse trin for at løse problemet.

1. Konfigurer et SPN for gatewayen i det lokale miljø.
2. Konfigurer begrænset delegering i Active Directory.

FailedToImpersonateUserException: Windows-identiteten kunne ikke oprettes for bruger-id'et

FailedToImpersonateUserException opstår, når gatewayen ikke kan repræsentere på vegne af en anden bruger. Denne fejl kan også opstå, hvis den konto, der repræsenteres, befinder sig i et andet domæne uden den nødvendige tillid konfigureret.

Løsning (FailedToImpersonateUserException)

• Kontrollér, at konfigurationen er korrekt i henhold til trinnene i det forrige afsnit "ImpersonationLevel".
• Kontrollér, at det bruger-id, det forsøger at repræsentere, er en gyldig Active Directory-konto.

Generel fejl: 1033-fejl, mens du fortolker protokollen

Du får vist 1033-fejlen, når dit eksterne id, der er konfigureret i SAP HANA, ikke svarer til logon, hvis brugeren repræsenteres ved hjælp af UPN (alias@domain.com). Du kan se "Original UPN 'alias@domain.com' erstattet med et nyt UPN 'alias@domain.com'" øverst i fejlloggene, som vist her:

[DM.GatewayCore] SingleSignOn Required. Original UPN 'alias@domain.com' replaced with new UPN 'alias@domain.com.'

Løsning (1033-fejl)

• SAP HANA kræver, at den repræsenterede bruger bruger attributten sAMAccountName (brugeralias) i Active Directory. Hvis denne attribut ikke er korrekt, får du vist 1033-fejlen.

  

• I logfilerne kan du se sAMAccountName (alias) og ikke UPN, som er aliaset efterfulgt af domænet (alias@domain.com).

  

  <setting name="ADUserNameReplacementProperty" serializeAs="String">
    <value>sAMAccountName</value>
  </setting>
  <setting name="ADServerPath" serializeAs="String">
    <value />
  </setting>
  <setting name="CustomASDataSource" serializeAs="String">
    <value />
  </setting>
  <setting name="ADUserNameLookupProperty" serializeAs="String">
    <value>AADEmail</value>
  </setting>

SAP HANA-kommunikationslinkfejl: -10709 forbindelse mislykkedes (Kerberos-legitimationsoplysninger er ikke tilgængelige)

Du får vist fejlmeddelelsen "-10709 Connection failed", hvis delegering ikke er konfigureret korrekt i Active Directory.

Løsning (SAP HANA Kerberos -10709)

• Sørg for, at du har SAP HANA-serveren under fanen Delegering i Active Directory for gatewaytjenestekontoen.

  

Eksportér logge for en supportanmodning

Gatewaylogge kræves til fejlfinding og oprettelse af en supportanmodning. Brug følgende trin til at udtrække disse logge.

1. Identificer gatewayklynge.

   Hvis du er ejer af en semantisk model, skal du først kontrollere navnet på den gatewayklynge, der er knyttet til din semantiske model. På følgende billede er IgniteGateway gatewayklynge.

   

2. Kontrollér egenskaberne for gatewayen.

   Gatewayadministratoren skal derefter kontrollere antallet af gatewaymedlemmer i klyngen, og om justering af belastning er aktiveret.

   Hvis justering af belastning er aktiveret, skal trin 3 gentages for alle gatewaymedlemmer. Hvis den ikke er aktiveret, er eksport af logge på den primære gateway tilstrækkelig.

3. Hent og eksportér gatewayloggene.

   Derefter skal gatewayadministratoren, som også er administrator af gatewaysystemet, udføre følgende trin:

   1. Log på gatewaycomputeren, og start derefter appen til datagatewayen i det lokale miljø for at logge på gatewayen.
   2. Aktivér yderligere logføring.
   3. (Valgfrit) Aktivér funktionerne til overvågning af ydeevnen , og medtag ydelseslogge.
   4. Kør det scenarie, du forsøger at hente gatewaylogge for.
   5. Eksportér gatewayloggene.

Opdateringshistorik

Når du bruger gatewayen til en planlagt opdatering, kan opdateringshistorikken hjælpe dig med at se, hvilke fejl der opstod. Den kan også levere nyttige data, hvis du har brug for at oprette en supportanmodning. Du kan få vist planlagte opdateringer og opdateringer efter behov. Følgende billeder viser, hvordan du kan få vist opdateringshistorikken.

På detaljesiden for den semantiske model skal du vælge Opdater på båndet og derefter vælge Opdater historik.

Du kan også få adgang til opdateringshistorikken fra indstillingerne for semantiske modeller. Vælg Filer på båndet, og vælg derefter Indstillinger.

Du kan finde flere oplysninger om fejlfinding af opdateringsscenarier i Fejlfinding af opdateringsscenarier. Hvis din planlagte opdatering stoppede med at køre uventet, skal du gennemse den inaktivitetsfunktion, der er beskrevet i Konfigurer planlagt opdatering.

Relateret indhold

• Foretag fejlfinding af datagatewayen i det lokale miljø
• Konfigurer proxyindstillinger for datagatewayen i det lokale miljø
• Administrer SQL Server Analysis Services-datakilder
• Administrer din datakilde – SAP HANA
• Administrer en SQL Server-datakilde
• Administrer din datakilde – import og planlagt opdatering

Har du flere spørgsmål? Prøv Power BI-community'et.