Risolvere i problemi relativi ai gateway - Power BI

  • Articolo

Nota

La documentazione del gateway dati locale è stata suddivisa in contenuto specifico di Power BI e contenuto generale applicabile a tutti i servizi supportati dal gateway. Attualmente si è nel contenuto di Power BI. Per fornire commenti e suggerimenti su questo articolo o sull'esperienza generale della documentazione del gateway, scorrere fino alla fine dell'articolo.

Questo articolo illustra alcuni problemi comuni quando si usa il gateway dati locale con Power BI. Se si verifica un problema non elencato qui, è possibile usare il sito della community di Power BI. In alternativa, è possibile creare un ticket di supporto.

Impostazione

Errore: servizio Power BI gateway locale segnalato come non raggiungibile. Riavviare il gateway e riprovare.

Alla fine della configurazione, il servizio Power BI viene chiamato di nuovo per convalidare il gateway. Il servizio Power BI non segnala il gateway come attivo. Il riavvio del servizio Windows potrebbe consentire la corretta esecuzione della comunicazione. Per ottenere altre informazioni, è possibile raccogliere ed esaminare i log come descritto in Raccogliere i log dall'app gateway dati locale.

Origini dati

Nota

Non tutte le origini dati hanno articoli dedicati che illustrano in dettaglio le impostazioni di connessione o la configurazione. Per molte origini dati e connettori non Microsoft, le opzioni di connessione possono variare tra Power BI Desktop e Gestire le impostazioni dell'origine dati dei gateway > nella servizio Power BI. In questi casi, le impostazioni predefinite fornite sono gli scenari attualmente supportati per Power BI.

Errore: impossibile Connessione. Dettagli: "Credenziali di connessione non valide"

In Mostra dettagli viene visualizzato il messaggio di errore ricevuto dall'origine dati. Per SQL Server viene visualizzato un messaggio simile al seguente:

Login failed for user 'username'.

Verificare di avere il nome utente e la password corretti. Verificare anche che tali credenziali possano connettersi correttamente all'origine dati. Assicurarsi che l'account usato corrisponda al metodo di autenticazione.

Errore: impossibile Connessione. Dettagli: "Impossibile connettersi al database"

È stato possibile connettersi al server ma non al database fornito. Verificare il nome del database e che le credenziali utente dispongano dell'autorizzazione appropriata per accedere al database.

In Mostra dettagli viene visualizzato il messaggio di errore ricevuto dall'origine dati. Per SQL Server, viene visualizzato un aspetto simile al seguente:

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

Errore: impossibile Connessione. Dettagli: "Errore sconosciuto nel gateway dati"

Questo errore può verificarsi per diversi motivi. Assicurarsi di verificare che sia possibile connettersi all'origine dati dal computer che ospita il gateway. Questa situazione potrebbe essere il risultato che il server non è accessibile.

In Mostra dettagli è possibile visualizzare un codice di errore di DM_GWPipeline_UnknownError.

Per altre informazioni, vedere anche Registri eventi>Applicazioni e log>dei servizi Servizio gateway dati locale.

Errore: si è verificato un errore durante il tentativo di connessione al <server>. Dettagli: "È stato raggiunto il gateway dati, ma il gateway non può accedere all'origine dati locale".

Non è stato possibile connettersi all'origine dati specificata. Assicurarsi di convalidare le informazioni fornite per l'origine dati.

In Mostra dettagli è possibile visualizzare un codice di errore di DM_GWPipeline_Gateway_DataSourceAccessError.

Se il messaggio di errore sottostante è simile al seguente, significa che l'account usato per l'origine dati non è un amministratore del server per l'istanza di Analysis Services. Per altre informazioni, vedere Concedere i diritti di amministratore del server a un'istanza di Analysis Services.

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

Se il messaggio di errore sottostante è simile al seguente, potrebbe significare che l'account del servizio per Analysis Services potrebbe non avere l'attributo della directory token-groups-global-and-universal (TG ROUTE).

The username or password is incorrect.

I domini con accesso alla compatibilità pre-Windows 2000 hanno l'attributo TG ROUTE abilitato. La maggior parte dei domini appena creati non abilita questo attributo per impostazione predefinita. Per altre informazioni, vedere Alcune applicazioni e API richiedono l'accesso alle informazioni di autorizzazione sugli oggetti account.

Per verificare se l'attributo è abilitato, seguire questa procedura.

  1. Connessione al computer Analysis Services in SQL Server Management Studio. All'interno delle proprietà di connessione avanzate includere EffectiveUserName per l'utente in questione e verificare se questa aggiunta riproduce l'errore.

  2. È possibile usare lo strumento active Directory dsacls per verificare se l'attributo è elencato. Questo strumento è disponibile in un controller di dominio. È necessario sapere qual è il nome di dominio distinto per l'account e passare tale nome allo strumento.

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

    Nei risultati si vuole visualizzare qualcosa di simile al seguente:

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

Per risolvere il problema, è necessario abilitare TGGAU nell'account usato per il servizio Windows Analysis Services.

Un'altra possibilità per "Il nome utente o la password non è corretto".

Questo errore può essere causato anche se il server Analysis Services si trova in un dominio diverso rispetto agli utenti e non esiste un trust bidirezionale stabilito.

Collaborare con gli amministratori di dominio per verificare la relazione di trust tra domini.

Impossibile visualizzare le origini dati del gateway dati nell'esperienza Recupera dati per Analysis Services dal servizio Power BI

Assicurarsi che l'account sia elencato nella scheda Utenti dell'origine dati all'interno della configurazione del gateway. Se non si ha accesso al gateway, rivolgersi all'amministratore del gateway e chiedere loro di verificare. Solo gli account nell'elenco Utenti possono visualizzare l'origine dati elencata nell'elenco di Analysis Services.

Errore: nel set di dati non è installato o configurato alcun gateway per le origini dati.

Assicurarsi di aver aggiunto una o più origini dati al gateway, come descritto in Aggiungere un'origine dati. Se il gateway non viene visualizzato nel portale di amministrazione in Gestisci gateway, cancellare la cache del browser o disconnettersi dal servizio e quindi eseguire nuovamente l'accesso.

Errore: l'origine dati non può essere aggiornata perché le credenziali non sono valide. Please update your credentials and try again.

È stato possibile connettersi e aggiornare il set di dati, senza errori di runtime per la connessione, ma nella servizio Power BI viene visualizzata questa barra degli errori. Quando l'utente tenta di aggiornare le credenziali con credenziali valide note, viene visualizzato un errore che indica che le credenziali specificate non sono valide.

Questo errore può verificarsi quando il gateway tenta una connessione di test, anche se le credenziali fornite sono accettabili e l'operazione di aggiornamento ha esito positivo. Ciò si verifica perché quando il gateway esegue un test di connessione, non include parametri facoltativi durante il tentativo di connessione e alcuni connettori dati, ad esempio Snowflake, richiedono parametri di connessione facoltativi per la connessione.

Quando l'aggiornamento viene completato correttamente e non si verificano errori di runtime, è possibile ignorare questi errori di connessione di test per le origini dati che richiedono parametri facoltativi.

Modelli semantici

Errore: spazio insufficiente per questa riga.

Questo errore si verifica se si dispone di una singola riga con dimensioni maggiori di 4 MB. Determinare quale riga proviene dall'origine dati e tentare di filtrarla o ridurre le dimensioni per tale riga.

Errore: il nome del server specificato non corrisponde al nome del server nel certificato SSL di SQL Server.

Questo errore può verificarsi quando il nome comune del certificato è relativo al nome di dominio completo (FQDN) del server, ma è stato specificato solo il nome NetBIOS per il server. Questa situazione causa una mancata corrispondenza per il certificato. Per risolvere questo problema, impostare il nome del server all'interno dell'origine dati del gateway e il file PBIX usa il nome di dominio completo del server.

Errore: il gateway dati locale non viene visualizzato quando si configura l'aggiornamento pianificato.

Alcuni scenari diversi potrebbero essere responsabili di questo errore:

  • Il nome del server e del database non corrisponde a quello immesso in Power BI Desktop e all'origine dati configurata per il gateway. Questi nomi devono essere uguali. Non fanno distinzione tra maiuscole e minuscole.
  • L'account non è elencato nella scheda Utenti dell'origine dati all'interno della configurazione del gateway. È necessario essere aggiunti a tale elenco dall'amministratore del gateway.
  • Il file di Power BI Desktop include più origini dati e non tutte le origini dati sono configurate con il gateway. È necessario che ogni origine dati sia definita con il gateway affinché il gateway sia visualizzato all'interno dell'aggiornamento pianificato.

Errore: i dati non compressi ricevuti nel client del gateway hanno superato il limite.

La limitazione esatta è di 10 GB di dati non compressi per tabella. Se si verifica questo problema, sono disponibili opzioni valide per ottimizzare ed evitarlo. In particolare, ridurre l'uso di valori stringa lunghi e altamente costanti e usare invece una chiave normalizzata. In alternativa, rimuovere la colonna se non è in uso.

Errore: DM_GWPipeline_Gateway_SpooledOperationMissing

Alcuni scenari diversi potrebbero essere responsabili di questo errore

  • Il processo del gateway potrebbe essere stato riavviato quando l'aggiornamento del set di dati era in corso.
  • Il computer gateway viene clonato in cui è in esecuzione il gateway. Non è consigliabile clonare il computer gateway.

Report

Errore: il report non è riuscito ad accedere all'origine dati perché non si ha accesso all'origine dati tramite un gateway dati locale.

Questo errore è in genere causato da uno dei seguenti:

  • Le informazioni sull'origine dati non corrispondono a ciò che si trova nel set di dati sottostante. Il nome del server e del database deve corrispondere tra l'origine dati definita per il gateway dati locale e l'elemento fornito in Power BI Desktop. Se si usa un indirizzo IP in Power BI Desktop, anche l'origine dati per il gateway dati locale deve usare un indirizzo IP.
  • Nessuna origine dati disponibile in alcun gateway all'interno dell'organizzazione. È possibile configurare l'origine dati in un gateway dati locale nuovo o esistente.

Errore: errore di accesso all'origine dati. Contattare l'amministratore del gateway.

Se questo report usa una connessione dinamica di Analysis Services, è possibile che si verifichi un problema con un valore passato a EffectiveUserName che non è valido o che non dispone delle autorizzazioni per il computer Analysis Services. In genere, un problema di autenticazione è dovuto al fatto che il valore passato per EffectiveUserName non corrisponde a un nome dell'entità utente locale (UPN).

Per confermare il nome utente effettivo, seguire questa procedura.

  1. Trovare il nome utente effettivo nei log del gateway.

  2. Dopo aver passato il valore, verificare che sia corretto. Se si tratta dell'utente, è possibile usare il comando seguente da un prompt dei comandi per visualizzare l'UPN. L'UPN è simile a un indirizzo di posta elettronica.

    whoami /upn

Facoltativamente, è possibile visualizzare ciò che Power BI ottiene dall'ID Entra Microsoft.

  1. Passa a https://developer.microsoft.com/graph/graph-explorer.

  2. Selezionare Accedi nell'angolo superiore destro.

  3. Eseguire la query seguente. Viene visualizzata una risposta JSON piuttosto grande.

    https://graph.windows.net/me?api-version=1.5

  4. Cercare userPrincipalName.

Se l'UPN di Microsoft Entra non corrisponde all'UPN di Active Directory locale, è possibile usare la funzionalità Mapping dei nomi utente per sostituirla con un valore valido. In alternativa, è possibile usare l'amministratore di Power BI o l'amministratore locale di Active Directory per modificare l'UPN.

Kerberos

Se il server di database sottostante e il gateway dati locale non sono configurati in modo appropriato per la delega vincolata Kerberos, abilitare la registrazione dettagliata nel gateway. Esaminare quindi in base agli errori o alle tracce nei file di log del gateway come punto di partenza per la risoluzione dei problemi. Per raccogliere i log del gateway per la visualizzazione, vedere Raccogliere i log dall'app gateway dati locale.

ImpersonationLevel

ImpersonationLevel è correlato all'installazione del nome SPN o all'impostazione dei criteri locali.

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

Soluzione

Seguire questa procedura per risolvere il problema.

  1. Configurare un nome SPN per il gateway locale.
  2. Configurare la delega vincolata in Active Directory.

FailedToImpersonateUserException: Impossibile creare l'identità di Windows per userid

L'eccezione FailedToImpersonateUserException si verifica se non è possibile rappresentare per conto di un altro utente. Questo errore può verificarsi anche se l'account che si sta tentando di rappresentare proviene da un altro dominio rispetto a quello in cui si trova il dominio del servizio gateway. Si tratta di una limitazione.

Soluzione

  • Verificare che la configurazione sia corretta in base ai passaggi della sezione precedente "ImpersonationLevel".
  • Assicurarsi che l'ID utente che sta tentando di rappresentare sia un account Active Directory valido.

Errore generale: errore 1033 durante l'analisi del protocollo

Viene visualizzato l'errore 1033 quando l'ID esterno configurato in SAP HANA non corrisponde all'accesso se l'utente viene rappresentato usando l'UPN (alias@domain.com). Nei log viene visualizzato "UPN originale "alias@domain.com" sostituito con un nuovo UPN 'alias@domain.com'" nella parte superiore dei log degli errori, come illustrato di seguito:

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

Soluzione

  • SAP HANA richiede all'utente rappresentato di usare l'attributo sAMAccountName in Active Directory (alias utente). Se questo attributo non è corretto, viene visualizzato l'errore 1033.

    Attribute editor

  • Nei log viene visualizzato sAMAccountName (alias) e non l'UPN, ovvero l'alias seguito dal dominio (alias@doimain.com).

    Account info in logs

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

Viene visualizzato il messaggio di errore "-10709 Connessione ion non riuscito" se la delega non è configurata correttamente in Active Directory.

Soluzione

  • Assicurarsi di disporre del server SAP Hana nella scheda delega in Active Directory per l'account del servizio gateway.

    Delegation tab

Esportare i log per un ticket di supporto

I log del gateway sono necessari per la risoluzione dei problemi e la creazione di un ticket di supporto. Per estrarre questi log, seguire questa procedura.

  1. Identificare il cluster del gateway.

    Se si è un proprietario del set di dati, controllare prima di tutto il nome del cluster del gateway associato al set di dati. Nell'immagine seguente IgniteGateway è il cluster gateway.

    Gateway cluster

  2. Controllare le proprietà del gateway.

    L'amministratore del gateway deve quindi controllare il numero di membri del gateway nel cluster e se il bilanciamento del carico è abilitato.

    Se il bilanciamento del carico è abilitato, il passaggio 3 deve essere ripetuto per tutti i membri del gateway. Se non è abilitata, l'esportazione dei log nel gateway primario è sufficiente.

  3. Recuperare ed esportare i log del gateway.

    Successivamente, l'amministratore del gateway, che è anche l'amministratore del sistema gateway, deve eseguire la procedura seguente:

    a. Accedere al computer gateway e quindi avviare l'app gateway dati locale per accedere al gateway.

    b. Abilitare la registrazione aggiuntiva.

    c. Facoltativamente, è possibile abilitare le funzionalità di monitoraggio delle prestazioni e includere i log delle prestazioni per fornire dettagli aggiuntivi per la risoluzione dei problemi.

    d. Eseguire lo scenario per cui si sta tentando di acquisire i log del gateway.

    e. Esportare i log del gateway.

Cronologia aggiornamenti

Quando si usa il gateway per un aggiornamento pianificato, la cronologia degli aggiornamenti consente di visualizzare gli errori che si sono verificati. Può anche fornire dati utili se è necessario creare una richiesta di supporto. È possibile visualizzare gli aggiornamenti pianificati e su richiesta. I passaggi seguenti illustrano come accedere alla cronologia degli aggiornamenti.

  1. Nel riquadro di spostamento di Power BI selezionare un set di dati in Modelli semantici. Aprire il menu e selezionare Pianifica aggiornamento.

    How to select schedule refresh

  2. In Impostazioni per... selezionare Cronologia aggiornamenti.

    Select refresh history

    Refresh history display

Per altre informazioni sulla risoluzione dei problemi relativi agli scenari di aggiornamento, vedere Risolvere i problemi relativi agli scenari di aggiornamento.

Contenuto correlato

Altre domande? Provare il Community di Power BI.