Risolvere i problemi relativi al gateway dati locale

Questo articolo illustra alcuni problemi comuni quando si usa il gateway dati locale.

Nota

Se si verifica un problema che non è elencato qui, creare un ticket di supporto per il servizio cloud specifico che esegue il gateway.

Aggiornare alla versione più recente

È consigliabile assicurarsi di usare una versione supportata. Viene rilasciato un nuovo aggiornamento del gateway dati locale ogni mese. Attualmente, Microsoft supporta attivamente solo le ultime sei versioni del gateway dati locale. Se si verificano problemi con la versione in uso, provare ad eseguire l'aggiornamento alla versione più recente perché il problema potrebbe essere risolto nella versione più recente.

Versioni incoerenti tra i membri del gateway in un cluster

Mantenere sincronizzate le versioni dei membri del gateway in un cluster. La disponibilità di tutte le stesse versioni in un cluster consente di evitare errori di aggiornamento imprevisti. Questi errori di aggiornamento potrebbero verificarsi perché il membro del gateway a cui viene instradata una query specifica potrebbe non essere in grado di eseguirlo a causa di una versione precedente.

Risolvere i problemi di gestione del gateway

Ecco alcuni problemi di gestione comuni e le soluzioni che hanno aiutato altri clienti.

Errore durante la rimozione del nodo primario di un cluster gateway

Il nodo primario di un gateway non può essere rimosso se nel cluster sono presenti altri membri. La rimozione del nodo primario implica anche la rimozione del cluster del gateway.

Risolvere i problemi di installazione comuni

Ecco alcuni problemi di installazione comuni e le soluzioni che hanno aiutato altri clienti.

Errore: Impossibile aggiungere l'utente al gruppo. (Utenti del log delle prestazioni PBIEgwService -2147463168)

Questo errore potrebbe verificarsi se si sta provando a installare il gateway in un controller di dominio. La distribuzione in un controller di dominio non è supportata. È necessario distribuire il gateway in un computer che non è un controller di dominio.

Software antivirus non aggiornato

Se il software antivirus nel computer di installazione non è aggiornato, potrebbero verificarsi errori di installazione. È possibile aggiornare l'installazione dell'antivirus o disabilitare il software antivirus solo durante l'installazione del gateway. Al termine dell'installazione, riattivare il software antivirus.

Software McAfee Endpoint Defender abilitato

È possibile che si verifichi un errore di installazione quando il software antivirus, ad esempio McAfee Endpoint Defender, è abilitato. Configurare il software antivirus per ignorare il processo del gateway.

Stessa versione del gateway o versione precedente

Se si tenta di installare la stessa versione o una versione precedente del gateway rispetto a quella già presente, potrebbe verificarsi l'errore seguente.

Errore: il profilo utente è un profilo temporaneo

Si è verificato un problema con il computer. Contattare il team IT interno per rimuovere il profilo temporaneo.

Errore durante la generazione di una chiave asimmetrica

Un antivirus, ad esempio McCafee, può causare il danneggiamento o l'eliminazione dei file necessari per consentire al gateway di completare la configurazione. Disabilitare temporaneamente l'antivirus o configurarlo per ignorare il processo del gateway. Eliminare quindi la cartella RSA dal percorso c:\Users<GW Service Account User>\AppData\Roaming\Microsoft\Crypto\RSA. In alcuni casi, a seconda che si effettui l'accesso come utente o profilo di servizio, il percorso radice potrebbe essere diverso. Infine, riavviare il computer e completare l'installazione e l'accesso del gateway.

Risolvere i problemi relativi alla configurazione

Firewall o proxy

Per verificare se il gateway ha accesso a tutte le porte necessarie, eseguire il test delle porte di rete. I risultati del test sono Completato (Riuscito) o Completato (Fallito, vedi gli ultimi risultati del test). Se il test ha avuto esito positivo, il gateway è connesso correttamente a tutte le porte necessarie. Se il test non è riuscito, l'ambiente di rete potrebbe bloccare queste porte e server necessari.

Per informazioni su come fornire informazioni sul proxy per il gateway dati in locale, vedere Configurare le impostazioni proxy per il gateway dati in locale.

Un firewall potrebbe anche bloccare le connessioni che il relay di Azure stabilisce con i data center di Azure. In tal caso, sbloccare gli indirizzi IP per la tua regione per quei data center. È possibile ottenere un elenco di indirizzi IP di Azure da questo sito Web. Per trovare l'area del data center corrente in cui ci si trova, passare a Impostare l'area del data center.

Autenticazione al server proxy

Il proxy potrebbe richiedere l'autenticazione da un account utente di dominio. Per impostazione predefinita, il gateway usa un SID del servizio per l'utente di accesso al servizio Windows. La modifica dell'utente di accesso a un utente di dominio può aiutare a risolvere questa situazione. Per ulteriori informazioni, vedere Modificare l'account del servizio gateway in un account utente di dominio.

Il tuo proxy consente solo il traffico sulle porte 80 e 443.

Alcuni proxy limitano il traffico solo alle porte 80 e 443. Per impostazione predefinita, la comunicazione con Inoltro di Azure si verifica su porte diverse da 443.

È possibile forzare il gateway a comunicare con Azure Relay usando HTTPS anziché il TCP diretto.

Il proxy del gateway non è in grado di connettersi al data lake gestito

Se si usa un proxy per accedere ai dati locali usando un gateway dati locale, potrebbe non essere possibile connettersi a un data lake gestito (MDL) usando le impostazioni proxy predefinite. Per connettersi a MDL, assicurarsi di aggiungere gli indirizzi *.dfs.core.windows.net e *.blob.core.windows.net all'elenco consentito sul server proxy.

I dati del contatore delle prestazioni del sistema non sono disponibili

Se l'account del servizio corrente usato dall'applicazione gateway dati locale non è membro del gruppo di sicurezza locale Performance Log Users, si potrebbe osservare nel rapporto di aggregazione del contatore di sistema che è disponibile solo il valore di utilizzo della memoria del sistema.

Per risolvere questo comportamento, aggiungere l'account del servizio gateway dati locale al gruppo di sicurezza locale Performance Log Users e riavviare il servizio gateway dati locale.

Porta il tuo Azure Relay

I gateway che riscontrano problemi di connettività durante l'uso di Bring Your Own Relay devono assicurarsi che il collegamento privato non sia abilitato nell'inoltro, perché questa configurazione non è supportata.

Errori di connettività

Quando un gateway riscontra problemi di connettività, è possibile osservare sintomi diversi. Ecco alcuni dei sintomi comuni.

Errore: il gateway mostra lo stato offline nella pagina Gestisci gateway

È possibile riscontrare una delle indicazioni seguenti nella pagina Gestisci gateway se si verifica un problema di connettività.

Errore: il gateway dati è offline o non può essere raggiunto

Se si verifica un problema di connettività, potrebbe verificarsi uno degli errori di aggiornamento dei dati seguenti.

Errore: richiesta di rete ha restituito un errore imprevisto

Se si verifica un problema di connettività, potrebbe verificarsi uno degli errori seguenti quando si tenta di accedere al configuratore del gateway.

I problemi di connettività possono avere diverse cause. Pertanto, se si verifica uno dei sintomi menzionati in precedenza, eseguire le verifiche seguenti:

1. I FQDN e le porte indicati nella documentazione sono aperti/permessi nel firewall e/o nel proxy?

2. Se si usa un server proxy nell'ambiente:

   1. Assicurarsi che il server proxy sia configurato correttamente nei file di configurazione del gateway.
   2. Verificare se la configurazione del proxy è coerente.
   3. Controllare i log del proxy per verificare se sono presenti richieste bloccate a livello di proxy.

3. Il firewall consente solo la comunicazione sulle porte 80 e 443?

   1. In caso affermativo, verificare che la modalità HTTPS nel gateway sia abilitata.

Errori comuni

Errore: impossibile creare un gateway. Riprovare.

Questo errore potrebbe essere dovuto a problemi di configurazione del proxy. Il log del gateway fornisce altri dettagli per la risoluzione dei problemi. Per altre informazioni, vedere Configurare le impostazioni proxy per il gateway dati locali.

Errore: Il servizio Power BI ha segnalato che il gateway locale non è raggiungibile. Riavviare il gateway e riprovare.

Al termine della configurazione, il servizio Power BI viene chiamato di nuovo per convalidare il gateway. Il servizio Power BI non segnala il gateway come attivo. Riavviare il servizio Windows potrebbe consentire alla comunicazione di avere successo. Per ottenere altri dettagli, raccogliere ed esaminare i log, come descritto nella sezione seguente.

Errore: le informazioni sono necessarie per combinare i dati

È possibile che si verifichi un errore di aggiornamento nel servizio Power BI con un errore "Le informazioni sono necessarie per combinare i dati", anche se l'aggiornamento in Power BI Desktop funziona. Questo problema si verifica quando l'aggiornamento in Power BI Desktop funziona con l'opzione File>Opzioni e impostazioni>Opzioni>Privacy>Ignora sempre le impostazioni del livello di privacy impostata, ma genera un errore del firewall quando sono selezionate altre opzioni. Se si tenta di preformare questo aggiornamento nel servizio Power BI, l'aggiornamento non funziona perché ignorare sempre le impostazioni del livello di privacy non è disponibile nel servizio Power BI. Per risolvere questo errore, cercare di modificare il livello di privacy nelle Opzioni>Globali>Privacy e nelle Opzioni>File Corrente>Privacy in modo che non ignori la privacy dei dati. Ripubblicare il file in servizio Power BI e aggiornare le credenziali in "Organizzazione" in servizio Power BI.

Errore: sono presenti troppi aggiornamenti che si verificano contemporaneamente

Il gateway ha un limite di concorrenza pari a 30. Se si riceve questo errore, significa che è stato raggiunto il limite di concorrenza. È possibile monitorare il conteggio della concorrenza con il modello di diagnostica del gateway. Per evitare di incorrere in questo problema, aumentare il numero di gateway in un cluster o avviare un nuovo cluster per bilanciare il carico della richiesta.

Strumenti per la risoluzione dei problemi

Raccogliere i log dall'app gateway dati locale

Sono disponibili diversi log che è possibile raccogliere per il gateway ed è consigliabile iniziare sempre con i log. Il modo più semplice per raccogliere i log dopo l'installazione del gateway è tramite l'app gateway dati locale. Nell'app del gateway dati in locale, scegli Diagnostica e quindi il collegamento Esporta log.

Questo file viene salvato nella cartella ODGLogs sul desktop di Windows in formato .zip.

Registri eventi

Per trovare i log degli eventi per il servizio gateway dati in locale, seguire questi passaggi:

1. Nel computer con l'installazione del gateway aprire il Visualizzatore eventi.

2. Espandere Visualizzatore eventi>Log applicazioni e servizi.

3. Selezionare On-premises data gateway service (Gateway di servizio dati locale).

Risolvere gli errori di aggiornamento per un'origine specifica

Gli aggiornamenti che usano il gateway richiedono che l'origine sia accessibile dal computer con l'installazione del gateway. Per risolvere un problema di origine dati, usare Power BI Desktop in locale nel computer gateway per testare la connessione. Questo test è particolarmente utile se l'origine dati richiede l'installazione di altri componenti nel computer, ad esempio un driver di database di terze parti. Inoltre, un test locale consente di testare le connessioni all'origine dati che richiedono impostazioni di ambiente aggiuntive, ad esempio l'accesso a un file o una cartella di unità di rete condivisa. Questa tecnica consente di testare in modo iterativo la connessione nel computer gateway dopo ogni modifica della configurazione.

Anche se non è una garanzia di un aggiornamento corretto tramite il gateway, un aggiornamento riuscito di Power BI Desktop dal computer gateway è un forte indicatore che tutto è configurato correttamente nel computer gateway. In altre parole, se non è possibile eseguire l'aggiornamento in Power BI Desktop dal computer gateway, è molto improbabile che un aggiornamento attraverso il gateway abbia esito positivo. Dopo un aggiornamento riuscito in Desktop, è possibile restringere i passaggi per la risoluzione dei problemi alla configurazione dell'origine dati e al modello semantico nel servizio Power BI.

Limitazioni e considerazioni

Quando si utilizzano le credenziali OAuth2, il gateway al momento non supporta l'aggiornamento automatico dei token quando quelli di accesso scadono (un'ora dopo l'inizio del refresh). Se vengono visualizzati gli errori "InvalidConnectionCredentials" o "AccessUnauthorized" durante l'accesso alle origini dati cloud usando le credenziali OAuth2 anche se le credenziali sono state aggiornate di recente, è possibile che venga visualizzato questo errore. Questa limitazione per gli aggiornamenti a esecuzione prolungata esiste sia per i gateway di rete virtuale che per i gateway dati locali.

Le API REST dei gateway di Power BI non supportano cluster di gateway.

Contenuti correlati

• Domande frequenti sul gateway dati locale