Risoluzione dei problemi del gateway dati localeTroubleshooting the on-premises data gateway

Questo articolo illustra alcuni problemi comuni che possono verificarsi quando si usa il gateway dati locale.This article discusses some common issues you may encounter when using the on-premises data gateway.

Nota

Se si verifica un errore diverso da quelli elencati di seguito, è possibile richiedere ulteriore assistenza nei posti indicati di seguito.If you encounter an issue that is not listed below, you can ask for further assistance in the following locations.

Aggiornare alla versione più recenteUpdate to the latest version

Quando la versione del gateway non è aggiornata, possono verificarsi molti problemi.A lot of issues can surface when the gateway version is out of date. In generale, è consigliabile assicurarsi di usare sempre la versione più recente.It is a good general practice to make sure you are on the latest version. Se il gateway non è stato aggiornato da un mese o più, potrebbe essere utile provare a installare la versione più recente del gateway e provare a riprodurre il problema.If you haven't updated the gateway for a month, or longer, you may want to consider installing the latest version of the gateway and see if you can reproduce the issue.

Problemi comuniCommon issues

Ecco alcuni problemi comuni e risoluzioni risultati utili per diversi clienti in ambienti che limitano l'accesso a Internet.Here are a few common issues and resolutions that have helped a number of customers in environments that restrict internet access.

Autenticazione al server proxyAuthentication to proxy server

Il proxy può richiedere l'autenticazione da un account utente di dominio.Your proxy may require authentication from a domain user account. Per impostazione predefinita, il gateway usa un SID del servizio per l'utente di accesso al servizio di Windows.By default, the gateway uses a Service SID for the windows service log on user. La modifica dell'utente di accesso in utente di dominio può risultare utile a questo scopo.Changing the log on user to a domain user can help with this. Per altre informazioni, vedere Modifica dell'account del servizio gateway in un account utente di dominio.For more information, see Changing the gateway service account to a domain user.

Il proxy consente il traffico solo sulle porte 80 e 443Your proxy only allows ports 80 and 443 traffic

Alcuni proxy limitano il traffico solo alle porte 80 e 443.Some proxies restrict traffic to only ports 80 and 443. Per impostazione predefinita, la comunicazione con il bus di servizio avviene su porte diverse dalla 443.By default, communication to Azure Service Bus will occur on ports other than 443.

È possibile forzare il gateway per comunicare con il bus di servizio di Azure usando HTTPS anziché il TCP diretto.You can force the gateway to communicate with Azure Service Bus using HTTPS instead of direct TCP. È necessario modificare il file Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.You will need to modify the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file. Modificare il valore da AutoDetect a Https.Change the value from AutoDetect to Https. Per impostazione predefinita, questo file si trova in C:\Programmi\Gateway dati locale.This file is located, by default, at C:\Program Files\On-premises data gateway.

<setting name="ServiceBusSystemConnectivityModeString" serializeAs="String">
    <value>Https</value>
</setting>

InstallazioneInstallation

Errore: Non è stato possibile aggiungere l'utente al gruppo.Error: Failed to add user to group. (-2147463168 PBIEgwService Performance Log Users )(-2147463168 PBIEgwService Performance Log Users )

Questo errore può verificarsi se si sta provando a installare il gateway in un controller di dominio.You may receive this error if you are trying to install the gateway on a domain controller. La distribuzione in un controller di dominio non è supportata.Deploying on a domain controller is not supported. Il gateway deve essere distribuito in un computer che non sia un controller di dominio.You will need to deploy the gateway on a machine that is not a domain controller.

ConfigurazioneConfiguration

Come riavviare il gatewayHow to restart the gateway

Il gateway viene eseguito come servizio di Windows, quindi è possibile avviarlo e arrestarlo in diversi modi.The gateway runs as a Windows service, so you can start and stop it in multiple ways. Ad esempio, è possibile aprire un prompt dei comandi con autorizzazioni elevate nel computer in cui il gateway è in esecuzione e quindi eseguire uno di questi comandi:For example, you can open a command prompt with elevated permissions on the machine where the gateway is running and then run either of these commands:

  • Per arrestare il servizio, eseguire questo comando:To stop the service, run this command:

    ''' net stop PBIEgwService '''''' net stop PBIEgwService '''

  • Per avviare il servizio, eseguire questo comando:To start the service, run this command:

    ''' net start PBIEgwService '''''' net start PBIEgwService '''

Errore: Non è stato possibile creare il gateway.Error: Failed to create gateway. Riprovare.Please try again.

Tutti i dettagli sono disponibili, ma la chiamata al servizio Power BI ha restituito un errore.All of the details are available, but the call to the Power BI service returned an error. Verranno visualizzati l'errore e un id attività.The error, and an activity id, will be displayed. Questo potrebbe verificarsi per diverse ragioni.This could happen for different reasons. È possibile raccogliere e rivedere i registri, come indicato di seguito, per ottenere maggiori dettagli.You can collect, and review, the logs, as mentioned below, to get more details.

Questo potrebbe essere dovuto a problemi di configurazione del proxy.This could also be due to proxy configuration issues. L'interfaccia utente consente ora la configurazione del proxy.The user interface does now allow for proxy configuration. Sono disponibili altre informazioni sulle modifiche alla configurazione del proxy.You can learn more about making proxy configuration changes

Errore: Non è stato possibile aggiornare i dettagli del gateway.Error: Failed to update gateway details. Riprovare.Please try again.

Le informazioni sono state ricevute dal servizio Power BI, al gateway.Information was received from the Power BI service, to the gateway. Le informazioni state passate al servizio di windows locale, ma quest’ultimo non è riuscito a restituirle.The information was passed onto the local windows service, but it failed to return. In alternativa, una generazione della chiave simmetrica ha avuto esito negativo.Or, a symmetric key generation failed. In Mostra dettagliverrà visualizzata l'eccezione interna.The inner exception will be displayed under Show details. È possibile raccogliere e rivedere i registri, come indicato di seguito, per ottenere maggiori dettagli.You can collect, and review, the logs, as mentioned below, to get more details.

Errore: Il servizio Power BI ha segnalato che il gateway locale non è raggiungibile.Error: Power BI service reported local gateway as unreachable. Riavviare il gateway e riprovare.Please restart the gateway and try again.

Al termine della configurazione, il servizio Power BI verrà chiamato nuovamente a convalidare il gateway.At the end of configuration, the Power BI service will be called again to validate the gateway. Il servizio Power BI non dichiara il gateway come live.The Power BI service does not report the gateway as live. Il riavvio del servizio windows potrebbe consentire la riuscita della comunicazione.Restarting the windows service may allow the communication to be successful. È possibile raccogliere e rivedere i registri, come indicato di seguito, per ottenere maggiori dettagli.You can collect, and review, the logs, as mentioned below, to get more details.

Errore di script durante l'accesso a Power BIScript error during sign into Power BI

Potrebbe verificarsi un errore di script quando si accede a Power BI nell'ambito della configurazione del gateway dati locale.You may receive a script error when signing into Power BI as part of the on-premises data gateway configuration. L'installazione dell'aggiornamento di sicurezza seguente dovrebbe risolvere il problema.Installing the following security update should resolve the issue. Può essere installato tramite Windows Update.This can be installed via Windows Update.

MS16-051: Aggiornamento della sicurezza per Internet Explorer: 10 maggio 2016 (KB 3154070)MS16-051: Security update for Internet Explorer: May 10, 2016 (KB 3154070)

Configurazione del gateway non riuscita con eccezione di riferimento NullGateway configuration failed with a null reference exception

Potrebbe essere visualizzato un errore simile al seguente.You may encounter an error similar to the following.

    Failed to update gateway details.  Please try again.
    Error updating gateway configuration.

Verrà inclusa un'analisi dello stack e tale analisi dello stack potrebbe includere gli elementi seguenti.This will include a stack trace, and that stack trace will may include the following.

    Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.CouldNotUpdateGatewayConfigurationException: Error updating gateway configuration. ----> System.ArgumentNullException: Value cannot be null.
    Parameter name: serviceSection

Se si esegue l'aggiornamento da un gateway precedente, viene conservato il file di configurazione.If you are upgrading from an older gateway, we preserve the config file. Potrebbe mancare una sezione.There may be a section that is missing. Quando il gateway prova a leggerla, viene visualizzata l'eccezione di riferimento Null precedente.When the gateway tries to read it, we will get the above null reference exception.

Per correggere questo errore, seguire questa procedura.To correct this, do the following.

  1. Disinstallare il gateway.Uninstall the gateway.
  2. Eliminare la cartella seguente.Delete the following folder.

     c:\Program Files\on-premises data gateway
    
  3. Reinstallare il gateway.Reinstall the gateway.
  4. Applicare facoltativamente la chiave di ripristino per ripristinare un gateway esistente.Optionally apply the recovery key to restore an existing gateway.

Supporto per TLS 1.1/1.2Support for TLS 1.1/1.2

A partire dall'aggiornamento di agosto 2017 e versioni successive, per impostazione predefinita il gateway dati locale usa il protocollo TLS (Transport Layer Security) 1.1 o 1.2 per comunicare con il servizio Power BI.With the August 2017 update and beyond, the on-premises data gateway uses Transport Layer Security (TLS) 1.1 or 1.2 to communicate with the Power BI service by default. Le versioni precedenti del gateway dati locale usano TLS 1.0 per impostazione predefinita.Previous versions of the on-premises data gateway use TLS 1.0 by default. A partire dall'1 novembre 2017 il supporto per TLS 1.0 terminerà, quindi entro tale data è necessario aggiornare le installazioni del gateway dati locale alla versione di agosto 2017 o a una versione più recente, in modo da assicurare che i gateway continuino a funzionare.On November 1st 2017 support for TLS 1.0 will end, so by then you must upgrade your on-premises data gateway installations to the August 2017 release or newer to ensure your gateways continue to operate.

È importante notare che TLS 1.0 è ancora supportato dal gateway dati locale prima dell'1 novembre e viene usato dal gateway come meccanismo di fallback.It's important to note that TLS 1.0 is still supported by the on-premises data gateway prior to November 1st, and is used by the gateway as a fallback mechanism. Per assicurare che tutto il traffico del gateway usi TLS 1.1 o 1.2 e per evitare l'uso di TLS 1.0 nel gateway, è necessario aggiungere o modificare le chiavi del Registro di sistema seguenti nel computer che esegue il servizio gateway:To ensure all gateway traffic uses TLS 1.1 or 1.2 (and to prevent the use of TLS 1.0 on your gateway), you must add or modify the following registry keys on the machine running the gateway service:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]"SchUseStrongCrypto"=dword:00000001
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319]"SchUseStrongCrypto"=dword:00000001

Nota

L'aggiunta o la modifica di queste chiavi del Registro di sistema viene applicata a tutte le applicazioni .NET.Adding or modifying these registry keys applies the change to all .NET applications. Per informazioni sulle modifiche del Registro di sistema che influiscono su TLS per altre applicazioni, vedere Impostazioni del Registro di sistema per TLS (Transport Layer Security).For information about registry changes that affect TLS for other applications, see Transport Layer Security (TLS) registry settings.

Origini datiData sources

Errore: La connessione non è riuscita.Error: Unable to Connect. Dettagli: "Le credenziali di connessione non sono valide"Details: "Invalid connection credentials"

In Mostra dettagli, viene visualizzato il messaggio di errore ricevuto dall'origine dati.Within Show details, it should display the error message received from the data source. Per SQL Server, dovrebbe avere un aspetto simile al seguente.For SQL Server, you should see something like the following.

Login failed for user 'username'.

Verificare la correttezza del nome utente e della password.Verify that you have the correct username and password. Verificare inoltre che tali credenziali possono connettersi all'origine dati.Also verify that those credentials can successfully connect to the data source. Assicurarsi che l'account utilizzato corrisponda al Metodo di autenticazione.Make sure the account being used matches the Authentication Method.

Errore: La connessione non è riuscita.Error: Unable to Connect. Dettagli: "Non è possibile stabilire la connessione al database"Details: "Cannot connect to the database"

Siamo in grado di effettuare la connessione al server, ma non per il database specificato.We were able to connect to the server, but not to the database supplied. Verificare il nome del database, e che la credenziale dell'utente disponga dell'autorizzazione per accedere al database.Verify the name of the database, and that the user credential as the proper permission to access that database.

In Mostra dettagli, viene visualizzato il messaggio di errore ricevuto dall'origine dati.Within Show details, it should display the error message received from the data source. Per SQL Server, dovrebbe avere un aspetto simile al seguente.For SQL Server, you should see something like the following.

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

Errore: La connessione non è riuscita.Error: Unable to Connect. Dettagli: "Si è verificato un errore sconosciuto nel gateway dati"Details: "Unknown error in data gateway"

Questo errore può verificarsi per diversi motivi.This error could occur for different reasons. Assicurarsi che sia possibile connettersi all'origine dati dal computer che ospita il gateway.Be sure to validate that you can connect to the data source from the machine hosting the gateway. Questo può essere il risultato dell’inaccessibilità al server.This could be the result of the server not being accessible.

In Mostra dettagli, verrà visualizzato il codice di errore DM_GWPipeline_UnknownError.Within Show details, you will see an error code of DM_GWPipeline_UnknownError.

Per altre informazioni, è anche possibile cercare in Registri eventi > Registri applicazioni e servizi > Servizio Gateway dati locale.You can also look in the Event Logs > Applications and Services Logs > on-premises data gateway Service for more details.

Errore: Si è verificato un errore durante il tentativo di connessione a.Error: We encountered an error while trying to connect to . Dettagli: "Il data gateway è raggiungibile ma non può accedere all'origine dati locale".Details: "We reached the data gateway, but the gateway can't access the on-premises data source."

Non è stato possibile connettersi all'origine dati specificata.We were unable to connect to the specified data source. Controllare le informazioni fornite per l'origine dati.Be sure to validate the information provided for that data source.

In Mostra dettagliverrà visualizzato il codice di errore DM_GWPipeline_Gateway_DataSourceAccessError.Within Show details, you will see an error code of DM_GWPipeline_Gateway_DataSourceAccessError.

Se il messaggio di errore sottostante è simile al seguente, significa che l'account in uso per l'origine dati non è un amministratore del server per l'istanza di Analysis Services.If the underlying error message is similar to the following, this means that the account you are using for the data source is not a server admin for that Analysis Services instance. Altre informazioniLearn more

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

Se il messaggio di errore sottostante è simile al seguente, l'account del servizio per Analysis Services potrebbe non includere l'attributo token-groups-global-and-universal (TGGAU) della directory.If the underlying error message is similar to the following, it could mean that the service account for Analysis Services may be missing the token-groups-global-and-universal (TGGAU) directory attribute.

The user name or password is incorrect.

L'attributo TGGAU sarà abilitato nei domini con accesso compatibile con le versioni precedenti a Windows 2000.Domains with Pre-Windows 2000 compatibility access will have the TGGAU attribute enabled. La maggior parte dei domini creati di recente, tuttavia, non abiliterà questo attributo per impostazione predefinita.However, most newly created domains will not enable this attribute by default. Per altre informazioni, vedere qui.You can read more about this here.

Per confermare, seguire questa procedura.You can confirm this by doing the following.

  1. Connettersi al computer di Analysis Services in SQL Server Management Studio.Connect to the Analysis Services machine within SQL Server Management Studio. All'interno delle proprietà avanzate di connessione includere il valore EffectiveUserName per l'utente specifico e verificare se l'errore viene riprodotto.Within the Advanced connection properties, include EffectiveUserName for the user in question and see if this reproduces the error.
  2. È possibile usare lo strumento dsacls di Active Directory per verificare che l'attributo sia incluso nell'elenco.You can use the dsacls Active Directory tool to validate whether the attribute is listed. Questo strumento è in genere disponibile in un controller di dominio.This is tool is normally found on a domain controller. Sarà necessario conoscere il nome di dominio distinto per l'account e passarlo allo strumento.You will need to know what the distinguished domain name is for the account and pass that to the tool.

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

    I risultati dovrebbero avere un aspetto simile al seguente.You want to see something similar to the following in the results.

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

Per risolvere il problema, sarà necessario abilitare TGGAU nell'account usato per il servizio di Windows Analysis Services.To correct this issue, you will need to enable TGGAU on account used for the Analysis Services windows service.

Password o nome non validoAnother possibility for user name or password incorrect

Questo errore può dipendere anche dal fatto che il server di Analysis Services si trova in un dominio diverso rispetto a quello dell'utente e che non è stato stabilito alcun trust bidirezionale.This error could also be caused if the Analysis Services server is in a different domain than the users and there is not a two-way trust established.

Sarà necessario collaborare con gli amministratori del dominio per verificare la relazione di trust tra i domini.You will need to work with your domain administrators to verify the trust relationship between domains.

Non è possibile visualizzare le origini dati del gateway dati nell'esperienza "Recupera dati" per Analysis Services dal servizio Power BIUnable to see the data gateway data sources in the 'Get Data' experience for Analysis Services from the Power BI service

Assicurarsi che il proprio account sia elencato nella scheda Utenti dell'origine dati all'interno della configurazione del gateway.Make sure that your account is listed in the Users tab of the data source within the gateway configuration. Se non si ha accesso al gateway, rivolgersi all'amministratore del gateway e chiedere di verificare.If you don't have access to the gateway, check with the administrator of the gateway and ask them to verify. Solo gli account presenti nell’elenco Utenti possono visualizzare l'origine dati riportata nell'elenco di Analysis Services.Only accounts in the Users list will see the data source listed in the Analysis Services list.

Set di datiDatasets

Errore: Non è disponibile spazio sufficiente per questa riga.Error: There is not enough space for this row.

Questo accade in presenza di una riga singola le cui dimensioni superano 4 MB.This will occur if you have a single row greater than 4 MB in size. È necessario determinare quale sia la riga dall'origine dati e tentare di filtrarla o di ridurne le dimensioni.You will need to determine what the row is from your data source and attempt to filter it out or reduce the size for that row.

Errore: Il nome del server specificato non corrisponde al nome del server nel certificato SSL di SQL Server.Error: The server name provided doesn't match the server name on the SQL Server SSL Certificate.

Questo errore può verificarsi quando il certificato CN è relativo al nome di dominio completo del server (FQDN), ma si è fornito solo il nome netbios per il server.This can occur when the certificate CN is for the servers fully qualified domain name (FQDN) but you only supplied the netbios name for the server. Ciò provocherà una mancata corrispondenza con il certificato.This will cause a mismatch for the certificate. Per risolvere questo problema, è necessario far sì che per il nome del server all'interno dell'origine dati di gateway e il file PBIX venga usato il nome dominio completo del server.To resolve this issue, you will need to make the server name within the gateway data source, and the PBIX file, to use the FQDN of the server.

La percentuale del gateway dati locale non è visibile durante la configurazione dell'aggiornamento pianificato.I don't see the on-premises data gateway persent when configuring scheduled refresh.

Questo problema può essere dovuto ad alcuni scenari diversi.This could be because of a few different scenarios.

  1. I nomi del server e del database non corrispondono a quelli immessi in Power BI Desktop e all'origine dati configurata per il gateway.The server and database name don't match between what was entered in Power BI Desktop and the data source configured for the gateway. Deve trattarsi degli stessi valori,These need to be the same values. senza distinzione tra maiuscole e minuscole.They are not case sensitive.
  2. L'account non è elencato nella scheda Utenti dell'origine dati all'interno della configurazione del gateway.Your account is not listed in the Users tab of the data source within the gateway configuration. È necessario chiedere all'amministratore del gateway di essere aggiunti all'elenco.You will need to get with the administrator of the gateway to be added to that list.
  3. All'interno del file di Power BI Desktop sono presenti più origini dati, ma non tutte configurate con il gateway.Your Power BI Desktop file has multiple data sources within it and not all of those data sources are configured with the gateway. È necessario definire ogni origine dati con il gateway in modo da visualizzarlo in Aggiornamento pianificato.You will need to have each data source defined with the gateway for the gateway to show up within Scheduled Refresh.

Errore: La quantità di dati non compressi ricevuti nel client del gateway ha superato il limite.Error: The received uncompressed data on the gateway client has exceeded limit.

La limitazione esatta è di 10 GB di dati non compressi per ogni tabella.The exact limitation is 10 GB of uncompressed data per table. Se si verifica questo problema, ci sono buone opzioni per ottimizzare ed evitare il problema.If you are hitting this issue, there are good options to optimize and avoid the issue. In particolare, aiuta ridurre l'uso di valori stringa lunghi e molto ripetitivi, usando invece una chiave normalizzata o rimuovendo la colonna (se non usata).In particular, reducing the use of highly repetitive, long string values and instead using a normalized key or removing the column (if not in use) will help.

RelazioniReports

Il report non è riuscito ad accedere all'origine dati perché non si ha accesso all’origine dati tramite un gateway dati locale.Report could not access the data source because you do not have access to our data source via an on-premises data gateway.

Questo è in genere dovuto a uno dei motivi seguenti.This is usually caused by one of the following.

  1. Le informazioni sull’origine dati non corrispondono al contenuto del set di dati sottostante.The data source information does not match what is in the underlying dataset. Il nome del server e del database devono corrispondere tra l'origine dati definita per il gateway dati locale e i dati forniti all'interno di Power BI Desktop.The server and database name need to match between the data source defined for the on-premises data gateway and what you supply within 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.If you use an IP Address in Power BI Desktop, the data source, for the on-premises data gateway, needs to use an IP Address as well.
  2. Non sono disponibili origini dati in alcun gateway dell'organizzazione.There is not a data source available on any gateway within your organization. È possibile configurare l'origine dati in un gateway dati locale nuovo o esistente.You can configure the data source on a new, or existing, on-premises data gateway.

Errore: Si è verificato un errore di accesso all'origine dati.Error: Data source access error. Contattare l'amministratore del gateway.Please contact the gateway administrator.

Se questo report usa una connessione dinamica di Analysis Services, potrebbe verificarsi un problema con un valore passato a EffectiveUserName non valido o privo delle autorizzazioni per il computer di Analysis Services.If this report is making use of a live Analysis Services connection, you could be encountering an issue with a value being passed to EffectiveUserName that is either not valid, or doesn't have permissions on the Analysis Services machine. Un problema di autenticazione dipende in genere dal fatto che il valore passato per EffectiveUserName non corrisponde al nome dell'entità utente locale.Typically, an authentication issue is due to the fact that the value being passed for EffectiveUserName doesn't match a local user principal name (UPN).

Per risolvere il problema, seguire questa procedura.To confirm this, you can do the following.

  1. Trovare il nome utente effettivo entro i log del gateway.Find the effective username within the gateway logs.
  2. Dopo avere passato il valore, verificarne la correttezza.Once you have the value being passed, validate that it is correct. Se corrisponde all'utente, è possibile usare il comando seguente da un prompt dei comandi per verificare il valore previsto per il nome dell'entità utente.If it is your user, you can use the following command from a command prompt to see what the UPN should be. Il nome dell'entità utente avrà un aspetto simile a un indirizzo di posta elettronica.The UPN will look like an email address.

     whoami /upn
    

È facoltativamente possibile verificare i dati che Power BI riceve da Azure Active Directory.Optionally, you can see what Power BI gets from Azure Active Directory.

  1. Passare a https://graphexplorer.cloudapp.net.Browse to https://graphexplorer.cloudapp.net.
  2. Selezionare Sign in (Accedi) in alto a destra.Select Sign in in the upper right.
  3. Eseguire la query seguente.Run the following query. Verrà visualizzata una risposta JSON di dimensioni abbastanza elevate.You will see a rather large JSON response.

     https://graph.windows.net/me?api-version=1.5
    
  4. Cercare userPrincipalName.Look for userPrincipalName.

Se il nome dell'entità utente di Azure Active Directory non corrisponde al nome dell'entità utente di Active Directory locale, è possibile usare la funzionalità Mapping nomi utente per sostituirlo con un valore valido.If your Azure Active Directory UPN doesn't match your local Active Directory UPN, you can use the Map user names feature to replace it with a valid value. In alternativa, è possibile collaborare con l'amministratore del tenant o l'amministratore locale di Active Directory per ottenere una modifica del nome dell'entità utente.Or you can work with either your tenant admin, or local Active Directory admin, to get your UPN changed.

Firewall o proxyFirewall or Proxy

Per informazioni su come specificare le informazioni del proxy per il gateway, vedere Configurazione delle impostazioni del proxy per Power BI Gateway.For information on providing proxy information for your gateway, see Configuring proxy settings for the Power BI gateways.

È possibile verificare se il firewall o il proxy blocca le connessioni eseguendo Test-NetConnection da un prompt dei comandi di PowerShell.You can test to see if your firewall, or proxy, may be blocking conections by running Test-NetConnection from a PowerShell prompt. Verrà così testata la connettività al bus di servizio di Azure.This will test connectivity to the Azure Service Bus. Viene testata solo la connettività di rete e non vengono eseguite operazioni relative al servizio del server cloud o al gateway.This only tests network connectivity and doesn't have anything to do with the cloud server service or the gateway. Questa operazione è utile per determinare se il computer riesce effettivamente a connettersi a Internet.It helps to determine if your machine can actually get out to the internet.

Test-NetConnection -ComputerName watchdog.servicebus.windows.net -Port 9350

Nota

Test-NetConnection è disponibile solo in Windows Server 2012 R2 e versioni successive.Test-NetConnection is only available on Windows Server 2012 R2 and later. È anche disponibile in Windows 8.1 e versioni successive.It is also available on Windows 8.1 and later. Nelle versioni precedenti del sistema operativo, è possibile usare Telnet per testare la connettività di porta.On earlier OS versions, you can use Telnet to test port connectivity.

I risultati dovrebbero essere simile ai seguenti.The results should look similar to the following. La differenza riguarderà TcpTestSucceeded.The difference will be with TcpTestSucceeded. Se TcpTestSucceeded non è true, è possibile che le connessioni vengano bloccate da un firewall.If TcpTestSucceeded is not true, then you may be blocked by a firewall.

ComputerName           : watchdog.servicebus.windows.net
RemoteAddress          : 70.37.104.240
RemotePort             : 5672
InterfaceAlias         : vEthernet (Broadcom NetXtreme Gigabit Ethernet - Virtual Switch)
SourceAddress          : 10.120.60.105
PingSucceeded          : False
PingReplyDetails (RTT) : 0 ms
TcpTestSucceeded       : True

Per completezza, sostituire i valori di ComputerName e Port valori con quelli elencati per le porte.If you want to be exhaustive, substitute the ComputerName and Port values with those listed for ports

È anche possibile che il firewall blocchi le connessioni effettuate dal bus di servizio di Azure ai data center di Azure.The firewall may also be blocking the connections that the Azure Service Bus makes to the Azure data centers. In questo caso, è consigliabile aggiungere all'elenco elementi consentiti (sbloccare) gli indirizzi IP per l'area di questi data center.If that is the case, you will want to whitelist (unblock) the IP addresses for your region for those data centers. Per un elenco di indirizzi IP di Azure, vedere qui.You can get a list of Azure IP addresses here.

Per trovare l'area del data center in cui ci si trova, seguire questa procedura:You can find the data center region you are in by doing the following:

  1. Selezionare ?Select the ? in alto a destra nel servizio Power BI.in the upper right of the Power BI service.
  2. Selezionare Informazioni su Power BI.Select About Power BI.
  3. L'area del data center in cui ci si trova verrà elencata in I dati sono archiviati in.Your data region will be listed in Your data is stored in.

Se non si ottengono comunque le informazioni necessarie, è possibile provare a ottenere una traccia di rete usando uno strumento come fiddler o netsh, anche se questi sono metodi di raccolta avanzati e potrebbe essere necessaria assistenza nell'analisi dei dati raccolti.If you are still not getting anywhere, you could try getting a network trace using a tool like fiddler or netsh, although these are advanced collection methods and you may need assistance in analyzing the collected data. Per ottenere assistenza, è possibile contattare il supporto tecnico.You can contact support for assistance.

PrestazioniPerformance

Contatori delle prestazioniPerformance Counters

Esiste una serie di contatori delle prestazioni che possono essere usati per misurare le attività per il gateway.There are a number of performance counters that can be used to gauge the activities for the gateway. Possono essere utili per comprendere se è presente un carico elevato di attività e può essere necessario creare un nuovo gateway.These can be helpful to understanding if we have a large load of activity and may need to make a new gateway. Questi contatori non indicano il tempo necessario a effettuare questa operazione.These counters will not reflect how long something takes.

È possibile accedervi attraverso lo strumento Monitoraggio prestazioni di Windows.These counters can be access through the Windows Performance Monitor tool.

I contatori sono raccolti in raggruppamenti generali.There are general groupings of these counters.

Tipo di contatoreCounter Type DescrizioneDescription
ADO.NETADO.NET Usato per qualsiasi connessione di DirectQuery.This is used for any DirectQuery connection.
ADOMDADOMD Usato per Analysis Services 2014 e versioni precedenti.This is used for Analysis Services 2014 and earlier.
OLEDBOLEDB Usato da alcune origini dati.This is used by certain data sources. Include SAP HANA e Analysis Services 2016 o versioni successive.This includes SAP HANA and Analysis Service 2016 or later.
MashupMashup Include qualsiasi origine dati importata.This includes any imported data source. Se si sta pianificando l'aggiornamento o si esegue un aggiornamento su richiesta, passerà attraverso il motore mashup.If you are scheduling refresh or doing an on-demand refresh, it will go through the mashup engine.

Di seguito è riportato un elenco di contatori delle prestazioni disponibili.Here is a listing of the available performance counters.

ContatoreCounter DescrizioneDescription
# of ADO.NET open connection executed / sec# of ADO.NET open connection executed / sec Numero di azioni di connessione aperta ADO.NET eseguite al secondo (esito positivo o negativo).Number of ADO.NET open connection actions executed per second (succeeded or failed).
# of ADO.NET open connection failed / sec# of ADO.NET open connection failed / sec Numero di azioni di connessione aperta ADO.NET non riuscite al secondo.Number of ADO.NET open connections actions failed per second.
# of ADO.NET queries executed / sec# of ADO.NET queries executed / sec Numero di query ADO.NET eseguite al secondo (esito positivo o negativo).Number of ADO.NET queries executed per second (succeeded or failed).
# of ADO.NET queries failed / sec# of ADO.NET queries failed / sec Numero di query ADO.NET non eseguite al secondo.Number of ADO.NET failed queries executed per second.
# of ADOMD open connection executed / sec# of ADOMD open connection executed / sec Numero di azioni di connessione aperta ADOMD eseguite al secondo (esito positivo o negativo).Number of ADOMD open connection actions executed per second (succeeded or failed).
# of ADOMD open connection failed / sec# of ADOMD open connection failed / sec Numero di azioni di connessione aperta ADOMD non eseguite al secondo.Number of ADOMD open connection actions failed per second.
# of ADOMD queries executed / sec# of ADOMD queries executed / sec Numero di query ADOMD eseguite al secondo (esito positivo o negativo).Number of ADOMD queries executed per second (succeeded or failed).
# of ADOMD queries failed / sec# of ADOMD queries failed / sec Numero di query ADOMD non eseguite al secondo.Number of ADOMD failed queries executed per second.
# of all open connection executed / sec# of all open connection executed / sec Numero di azioni di connessione aperta eseguite al secondo (esito positivo o negativo).Number of open connection actions executed per second (succeeded or failed).
# of all open connection failed / sec# of all open connection failed / sec Numero di azioni di connessione aperta non riuscite eseguite al secondo.Number of failed open connection actions executed per second.
# of all queries executed / sec# of all queries executed / sec Numero di query eseguite al secondo (esito positivo o negativo).Number of queries executed per second (succeeded or failed).
# of items in the ADO.NET connection pool# of items in the ADO.NET connection pool Numero di elementi nel pool di connessioni ADO.NET.Number of items in the ADO.NET connection pool.
# of items in the OLEDB connection pool# of items in the OLEDB connection pool Numero di elementi nel pool di connessioni OLEDB.Number of items in the OLEDB connection pool.
# of items in the Service Bus pool# of items in the Service Bus pool Numero di elementi nel pool del bus di servizio.Number of items in the Service Bus pool.
# of Mashup open connection executed / sec# of Mashup open connection executed / sec Numero di azioni di connessione aperta Mashup eseguite al secondo (esito positivo o negativo).Number of Mashup open connection actions executed per second (succeeded or failed).
# of Mashup open connection failed / sec# of Mashup open connection failed / sec Numero di azioni di connessione aperta Mashup non riuscite al secondo.Number of Mashup open connection actions failed per second.
# of Mashup queries executed / sec# of Mashup queries executed / sec Numero di query Mashup eseguite al secondo (esito positivo o negativo).Number of Mashup queries executed per second (succeeded or failed).
# of Mashup queries failed / sec# of Mashup queries failed / sec Numero di query Mashup non riuscite al secondo.Number of Mashup failed queries executed per second
# of multiple result set OLEDB queries failed / sec# of multiple result set OLEDB queries failed / sec Numero di query OLEDB con set di risultati multipli eseguite al secondo.Number of multiple resultset OLEDB failed queries executed per second.
# of OLEDB multiple resultset queries executed / sec# of OLEDB multiple resultset queries executed / sec Numero di query con set di risultati multipli OLEDB eseguite al secondo (esito positivo o negativo).Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
# of OLEDB open connection executed / sec# of OLEDB open connection executed / sec Numero di azioni di connessione aperta OLEDB eseguite al secondo (esito positivo o negativo).Number of OLEDB open connection actions executed per second (succeeded or failed).
# of OLEDB open connection failed / sec# of OLEDB open connection failed / sec Numero di azioni di connessione aperta OLEDB non riuscite al secondo.Number of OLEDB open connection actions failed per second.
# of OLEDB queries executed / sec# of OLEDB queries executed / sec Numero di query con set di risultati multipli OLEDB eseguite al secondo (esito positivo o negativo).Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
# of OLEDB queries failed / sec# of OLEDB queries failed / sec Numero di query OLEDB non riuscite con set di risultati multipli OLEDB eseguite al secondo.Number of OLEDB mutiple resultset failed queries executed per second.
# of OLEDB single resultset queries executed / sec# of OLEDB single resultset queries executed / sec Numero di query con set di risultati singolo OLEDB eseguite al secondo (esito positivo o negativo).Number of OLEDB single resultset queries executed per second (succeeded or failed).
# of queries failed / sec# of queries failed / sec Numero di query non riuscite eseguite al secondo.Number of failed queries executed per second.
# of single result set OLEDB queries failed / sec# of single result set OLEDB queries failed / sec Numero di query OLEDB con set di risultati singolo eseguite al secondo.Number of single resultset OLEDB failed queries executed per second.

Analisi delle query con prestazioni ridotteReviewing slow performing queries

È possibile che la risposta tramite il gateway risulti lenta.You may find that response through the gateway is slow. Ciò può verificarsi per le query DirectQuery o durante l'aggiornamento del set di dati importato.This could be for DirectQuery queries or when refreshing your imported dataset. È possibile abilitare una registrazione aggiuntiva per le query di output e la relativa tempistica per comprendere la causa del rallentamento delle prestazioni.You can enable additional logging to output queries and their timings to help understand what is performing slow. Quando si rileva una query a lunga esecuzione, per ottimizzare le prestazioni delle query potrebbe essere necessaria una modifica aggiuntiva nell'origine dati.When you find a long running query, it may require additional modification on your data source to tune query performance. Ad esempio, la modifica degli indici per una query di SQL Server.For example, adjusting indexes for a SQL Server query.

È necessario modificare due file di configurazione per determinare la durata di una query.You will need to modify two configuration files to determine the duration of a query.

Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configMicrosoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config

Nel file Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config cambiare il valore EmitQueryTraces da False in True.Within the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file, change the EmitQueryTraces value from False to True. Per impostazione predefinita, questo file si trova in C:\Programmi\Gateway dati locale.This file is located, by default, at C:\Program Files\On-premises data gateway. Se si abilita EmitQueryTraces verrà avviare la registrazione delle query inviate dal gateway a un'origine dati.Enabling EmitQueryTraces will begin to log queries that are sent from the gateway to a data source.

Importante

A seconda dell'utilizzo di gateway, l'abilitazione di EmitQueryTraces può aumentare notevolmente le dimensioni del log.Enabling EmitQueryTraces could increase the log size significantly depending on gateway usage. Dopo aver esaminato i log, è opportuno impostare EmitQueryTraces su False.Once you are done reviewing the logs, you will want to set EmitQueryTraces to False. Non è consigliabile lasciare questa impostazione abilitata a lungo termine.It is not recommended to leave this setting enabled long term.

<setting name="EmitQueryTraces" serializeAs="String">
    <value>True</value>
</setting>

Esempio di immissione queryExample query entry

DM.EnterpriseGateway Information: 0 : 2016-09-15T16:09:27.2664967Z DM.EnterpriseGateway    4af2c279-1f91-4c33-ae5e-b3c863946c41    d1c77e9e-3858-4b21-3e62-1b6eaf28b176    MGEQ    c32f15e3-699c-4360-9e61-2cc03e8c8f4c    FF59BC20 [DM.GatewayCore] Executing query (timeout=224) "<pi>
SELECT
TOP (1000001) [t0].[ProductCategoryName],[t0].[FiscalYear],SUM([t0].[Amount])
 AS [a0]
FROM
(
(select [$Table].[ProductCategoryName] as [ProductCategoryName],
    [$Table].[ProductSubcategory] as [ProductSubcategory],
    [$Table].[Product] as [Product],
    [$Table].[CustomerKey] as [CustomerKey],
    [$Table].[Region] as [Region],
    [$Table].[Age] as [Age],
    [$Table].[IncomeGroup] as [IncomeGroup],
    [$Table].[CalendarYear] as [CalendarYear],
    [$Table].[FiscalYear] as [FiscalYear],
    [$Table].[Month] as [Month],
    [$Table].[OrderNumber] as [OrderNumber],
    [$Table].[LineNumber] as [LineNumber],
    [$Table].[Quantity] as [Quantity],
    [$Table].[Amount] as [Amount]
from [dbo].[V_CustomerOrders] as [$Table])
)
 AS [t0]
GROUP BY [t0].[ProductCategoryName],[t0].[FiscalYear] </pi>"

Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configMicrosoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config

Nel file Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config cambiare il valore TraceVerbosity da 4 in 5.Within the Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config file, change the TraceVerbosity value from 4 to 5. Per impostazione predefinita, questo file si trova in C:\Programmi\Gateway dati locale.This file is located, by default, at C:\Program Files\On-premises data gateway. La modifica questa impostazione inizierà a registrare voci dettagliate nel log del gateway.Changing this setting will begin to log verbose entries to the gateway log. Sono incluse le voci che mostrano la durata.This includes entries that show duration.

Importante

A seconda dell'utilizzo di gateway, l'abilitazione di TraceVerbosity su 5 può aumentare notevolmente le dimensioni del log.Enabling TraceVerbosity to 5 could increase the log size significantly depending on gateway usage. Dopo aver esaminato i log, è opportuno impostare TraceVerbosity su 4.Once you are done reviewing the logs, you will want to set TraceVerbosity to 4. Non è consigliabile lasciare questa impostazione abilitata a lungo termine.It is not recommended to leave this setting enabled long term.

<setting name="TracingVerbosity" serializeAs="String">
    <value>5</value>
</setting>

Tipi di attivitàActivity Types

Tipo di attivitàActivty Type DescrizioneDescription
MGEQMGEQ Query eseguite su ADO.NET.Queries executed over ADO.NET. Sono incluse le origini dati DirectQuery.This includes DirectQuery data sources.
MGEOMGEO Query eseguite su OLEDB.Queries executed over OLEDB. Include SAP HANA e Analysis Services 2016.This includes SAP HANA and Analysis Services 2016.
MGEMMGEM Query eseguite dal motore Mashup.Queries executed from the Mashup engine. Usate con set di dati importati che usano l'aggiornamento pianificato o su richiesta.This is used with imported datasets that use scheduled refresh or refresh on-demand.

Determinare la durata di una queryDetermine the duration of a query

Per determinare il tempo impiegato per eseguire una query sull'origine dati, è possibile eseguire le operazioni seguenti.To determine the time it took to query the data source, you can do the following.

  1. Aprire il log di gateway.Open the gateway log.
  2. Cercare un tipo di attività per trovare la query.Search for an Activity Type to find the query. Un esempio sarebbe MGEQ.An example of this would be MGEQ.
  3. Prendere nota del secondo GUID perché è l'ID della richiesta.Make note of the second GUID as this is the request id.
  4. Continuare a cercare MGEQ finché si trova la voce FireActivityCompletedSuccessfullyEvent con la durata.Continue to search for MGEQ until you find the FireActivityCompletedSuccessfullyEvent entry with the duration. È possibile verificare che la voce abbia lo stesso ID richiesta. La durata sarà espressa in millisecondi.You can verify the entry has the same request id. Duration will be in milliseconds.

     DM.EnterpriseGateway Verbose: 0 : 2016-09-26T23:08:56.7940067Z DM.EnterpriseGateway    baf40f21-2eb4-4af1-9c59-0950ef11ec4a    5f99f566-106d-c8ac-c864-c0808c41a606    MGEQ    21f96cc4-7496-bfdd-748c-b4915cb4b70c    B8DFCF12 [DM.Pipeline.Common.TracingTelemetryService] Event: FireActivityCompletedSuccessfullyEvent (duration=5004)
    

    Nota

    FireActivityCompletedSuccessfullyEvent è una voce dettagliata.FireActivityCompletedSuccessfullyEvent is a verbose entry. Questa voce non verrà registrata a meno che TraceVerbosity sia al livello 5.This entry will not be logged unless TraceVerbosity is at level 5.

Strumenti per la risoluzione dei problemiTools for troubleshooting

Raccolta di registri dallo strumento di configurazione del gatewayCollecting logs from the gateway configurator

È possibile raccogliere diversi log per il gateway ed è necessario iniziare sempre dai log.There are several logs you can collect for the gateway, and you should always start with the logs. Il modo più semplice per raccogliere i log dopo l'installazione del gateway consiste nell'usare l'interfaccia utente.The simplest way to collect logs after installing the gateway is through the user interface. Nell'interfaccia utente Gateway dati locale selezionare Diagnostica e quindi selezionare il collegamento Esporta log nella parte inferiore della pagina, come mostrato nell'immagine seguente.In the On-premises data gateway user interface, select Diagnostics and then select the Export logs link near the bottom of the page, as shown in the following image.

On-prem-data-gateway-UI-logs

Registri di installazioneInstaller logs

%localappdata%\Temp\On-premises_data_gateway_*.log

Registri di configurazioneConfiguration logs

%localappdata%\Microsoft\On-premises Data Gateway\GatewayConfigurator*.log

Registri eventi del gateway dati localeOn-premises data gateway service logs

C:\Users\PBIEgwService\AppData\Local\Microsoft\On-premises Data Gateway\Gateway*.log

Registri eventiEvent Logs

I registri eventi del Gateway dati locale sono presenti in Registri applicazioni e servizi.The On-premises data gateway service event logs are present under Application and Services Logs.

On-prem-data-gateway-event-logs

Traccia di FiddlerFiddler Trace

Fiddler è uno strumento gratuito di Telerik che monitora il traffico HTTP.Fiddler is a free tool from Telerik that monitors HTTP traffic. È possibile visualizzare il traffico dal servizio Power BI al computer client e viceversa.You can see the back and forth with the Power BI service from the client machine. Potrebbero essere illustrati errori e altre informazioni correlate.This may show errors and other related information.

Cronologia aggiornamentiRefresh History

Quando si usa il gateway per l'aggiornamento pianificato, Cronologia aggiornamenti consente di visualizzare gli errori che si sono verificati, nonché di fornire dati utili nel caso in cui sia necessario creare una richiesta di supporto.When using the gateway for scheduled refresh, Refresh History can help you see what errors have occurred, as well as provide useful data if you should need to create a support request. È possibile visualizzare sia gli aggiornamenti pianificati che quelli su richiesta.You can view both scheduled, as well as on demand, refreshes. Per accedere alla Cronologia aggiornamenti, eseguire le operazioni seguenti.Here is how you can get to the Refresh History.

  1. In Set di dati nel riquadro di spostamento di Power BI selezionare un set di dati > Apri menu >Pianifica aggiornamento.In the Power BI navigation pane, in Datasets, select a dataset > Open Menu > Schedule Refresh.

  2. In Impostazioni per... > Pianifica aggiornamento selezionare Cronologia aggiornamenti.In Settings for... > Schedule Refresh, select Refresh History.

Per altre informazioni sulla risoluzione degli scenari per la risoluzione dei problemi di aggiornamento, vedere l'articolo Scenari per la risoluzione dei problemi di aggiornamento.For additional information about troubleshooting refresh scenarios, take a look at the Troubleshooting Refresh Scenarios article.

Passaggi successiviNext steps

Configurazione delle impostazioni del proxy per Power BI GatewayConfiguring proxy settings for the Power BI gateways
Gateway dati localeOn-premises data gateway
Analisi approfondita del gateway dati localeOn-premises data gateway - in-depth
Gestire l'origine dati - Analysis ServicesManage your data source - Analysis Services
Gestire l'origine dati - SAP HANAManage your data source - SAP HANA
Gestire l'origine dati - SQL ServerManage your data source - SQL Server
Gestire l'origine dati - Importazione/aggiornamento pianificatoManage your data source - Import/Scheduled refresh
Altre domande?More questions? Provare la community di Power BITry the Power BI Community