Résolution des problèmes de passerelle de données localeTroubleshooting the on-premises data gateway

Cet article décrit certains problèmes courants que vous pouvez rencontrer lors de l’utilisation de la passerelle de données locale.This article discusses some common issues you may encounter when using the on-premises data gateway.

Note

Si vous rencontrez un problème ne figurant pas dans la liste ci-dessous, vous pouvez suivre ces méthodes pour obtenir de l’aide.If you encounter an issue that is not listed below, you can ask for further assistance in the following locations.

Procéder à une mise à jour vers la dernière versionUpdate to the latest version

De nombreux problèmes peuvent faire surface quand la version de la passerelle est obsolète.A lot of issues can surface when the gateway version is out of date. Nous vous recommandons de vérifier que vous possédez bien la dernière version.It is a good general practice to make sure you are on the latest version. Si vous n’avez pas mis à jour la passerelle depuis un mois ou plus, vous pouvez envisager d’installer la dernière version de la passerelle pour voir si vous pouvez reproduire le problème.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.

Problèmes courantsCommon issues

Voici quelques problèmes courants et solutions qui ont aidé un certain nombre de clients dans les environnements qui limitent l’accès à Internet.Here are a few common issues and resolutions that have helped a number of customers in environments that restrict internet access.

Authentification auprès du serveur proxyAuthentication to proxy server

Votre proxy peut nécessiter l’authentification à partir d’un compte utilisateur de domaine.Your proxy may require authentication from a domain user account. Par défaut, la passerelle utilise un SID de service pour l’utilisateur de connexion au service Windows.By default, the gateway uses a Service SID for the windows service log on user. Remplacer l’utilisateur de connexion par un utilisateur de domaine peut vous y aider.Changing the log on user to a domain user can help with this. Pour plus d’informations, voir Remplacement du compte de service de passerelle par un utilisateur de domaine.For more information, see Changing the gateway service account to a domain user.

Votre proxy autorise uniquement le trafic vers les ports 80 et 443.Your proxy only allows ports 80 and 443 traffic

Certains proxys limitent le trafic aux ports 80 et 443.Some proxies restrict traffic to only ports 80 and 443. Par défaut, la communication avec Azure Service Bus a lieu sur des ports différents du port 443.By default, communication to Azure Service Bus will occur on ports other than 443.

Vous pouvez forcer la passerelle pour communiquer avec Azure Service Bus à l’aide de HTTPS au lieu de Direct TCP.You can force the gateway to communicate with Azure Service Bus using HTTPS instead of direct TCP. Vous devez modifier le fichier Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.You will need to modify the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file. Modifiez la valeur de AutoDetect à Https.Change the value from AutoDetect to Https. Ce fichier se trouve, par défaut, dans C:\Program Files\On-premises data gateway.This file is located, by default, at C:\Program Files\On-premises data gateway.

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

InstallationInstallation

Erreur : Impossible d’ajouter l’utilisateur au groupe.Error: Failed to add user to group. (-2147463168 PBIEgwService Utilisateurs du journal de performances )(-2147463168 PBIEgwService Performance Log Users )

Vous pouvez recevoir cette erreur si vous essayez d’installer la passerelle sur un contrôleur de domaine.You may receive this error if you are trying to install the gateway on a domain controller. Le déploiement sur un contrôleur de domaine n’est pas pris en charge.Deploying on a domain controller is not supported. Vous devez déployer la passerelle sur un ordinateur qui n’est pas un contrôleur de domaine.You will need to deploy the gateway on a machine that is not a domain controller.

ConfigurationConfiguration

Comment redémarrer la passerelleHow to restart the gateway

La passerelle s’exécute comme un service Windows. Vous pouvez donc la démarrer et l’arrêter de plusieurs façons.The gateway runs as a Windows service, so you can start and stop it in multiple ways. Par exemple, vous pouvez ouvrir une invite de commandes avec des autorisations élevées sur l’ordinateur sur lequel la passerelle est exécutée, puis exécuter l’une des commandes suivantes :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:

  • Pour arrêter le service, exécutez la commande suivante :To stop the service, run this command:

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

  • Pour démarrer le service, exécutez la commande suivante :To start the service, run this command:

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

Erreur : Échec de la création de la passerelle.Error: Failed to create gateway. Réessayez.Please try again.

Tous les détails sont disponibles, mais l’appel au service Power BI a renvoyé une erreur.All of the details are available, but the call to the Power BI service returned an error. L’erreur et un ID d’activité sont affichés.The error, and an activity id, will be displayed. Cela peut se produire pour différentes raisons.This could happen for different reasons. Pour plus d’informations, vous pouvez collecter et examiner les journaux comme indiqué ci-dessous.You can collect, and review, the logs, as mentioned below, to get more details.

Cela peut également être dû à des problèmes de configuration de proxy.This could also be due to proxy configuration issues. L’interface utilisateur ne permet pas de configurer le proxy.The user interface does now allow for proxy configuration. Plus d’informations sur la façon d’apporter des modifications à la configuration du proxy.You can learn more about making proxy configuration changes

Erreur : Échec de la mise à jour des détails de la passerelle.Error: Failed to update gateway details. Réessayez.Please try again.

Les informations ont été reçues du service Power BI vers la passerelle.Information was received from the Power BI service, to the gateway. Elles ont été transmises au service Windows local, mais celui-ci n’a rien pu renvoyer.The information was passed onto the local windows service, but it failed to return. Il est également possible que la génération d’une clé symétrique ait échoué.Or, a symmetric key generation failed. L’exception interne apparaît sous Afficher les détails.The inner exception will be displayed under Show details. Pour plus d’informations, vous pouvez collecter et examiner les journaux comme indiqué ci-dessous.You can collect, and review, the logs, as mentioned below, to get more details.

Erreur : Le service Power BI a signalé que la passerelle locale est inaccessible.Error: Power BI service reported local gateway as unreachable. Redémarrez la passerelle et réessayez.Please restart the gateway and try again.

À la fin de la configuration, le service Power BI est rappelé pour valider la passerelle.At the end of configuration, the Power BI service will be called again to validate the gateway. Le service Power BI ne signale pas la passerelle comme étant active.The Power BI service does not report the gateway as live. Le redémarrage du service Windows peut permettre à la communication d’aboutir.Restarting the windows service may allow the communication to be successful. Pour plus d’informations, vous pouvez collecter et examiner les journaux comme indiqué ci-dessous.You can collect, and review, the logs, as mentioned below, to get more details.

Erreur de script lors de la connexion à Power BIScript error during sign into Power BI

Vous pouvez recevoir une erreur de script lorsque vous vous connectez à Power BI dans le cadre de la configuration de la passerelle de données locale.You may receive a script error when signing into Power BI as part of the on-premises data gateway configuration. L’installation de la mise à jour de sécurité suivante devrait résoudre le problème.Installing the following security update should resolve the issue. L’installation peut être effectuée via Windows Update.This can be installed via Windows Update.

MS16-051 : Mise à jour de sécurité pour Internet Explorer : 10 mai 2016 (KB 3154070)MS16-051: Security update for Internet Explorer: May 10, 2016 (KB 3154070)

La configuration de la passerelle a échoué avec une exception de référence nullGateway configuration failed with a null reference exception

Vous pouvez rencontrer une erreur similaire à ce qui suit.You may encounter an error similar to the following.

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

Cela inclut une arborescence des appels de procédure qui peut comprendre les éléments suivants.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

Si vous mettez à niveau à partir d’une ancienne passerelle, nous conservons le fichier de configuration.If you are upgrading from an older gateway, we preserve the config file. Il se peut qu’une section soit manquante.There may be a section that is missing. Quand la passerelle tente de la lire, nous obtenons l’exception de référence null ci-dessus.When the gateway tries to read it, we will get the above null reference exception.

Pour corriger cela, procédez comme suit :To correct this, do the following.

  1. Désinstallez la passerelle.Uninstall the gateway.
  2. Supprimez le dossier suivant.Delete the following folder.

     c:\Program Files\on-premises data gateway
    
  3. Réinstallez la passerelle.Reinstall the gateway.
  4. Vous pouvez éventuellement appliquer la clé de récupération pour restaurer une passerelle existante.Optionally apply the recovery key to restore an existing gateway.

Prise en charge de TLS 1.1/1.2Support for TLS 1.1/1.2

À partir de la mise à jour d’août 2017, la passerelle de données locale utilise, par défaut, le protocole TLS 1.1 ou 1.2 pour communiquer avec le service 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. Les versions précédentes de la passerelle de données locale utilisent le protocole TLS 1.0 par défaut.Previous versions of the on-premises data gateway use TLS 1.0 by default. Le 1er novembre 2017, le protocole TLS 1.0 ne sera plus pris en charge. Vous devez mettre à niveau vos installations de passerelle de données locale vers la version d’août 2017 ou une version ultérieure avant cette date, afin que vos passerelles continuent à fonctionner.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.

Il est important de noter que le protocole TLS 1.0 reste pris en charge par la passerelle de données locale jusqu’au 31 octobre, et est utilisé par celle-ci en tant que mécanisme de secours.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. Pour vous assurer que tout le trafic de passerelle utilise les protocoles TLS 1.1 ou 1.2 (et pour empêcher l’utilisation du protocole TLS 1.0 sur votre passerelle), vous devez ajouter ou modifier les clés de Registre suivantes sur l’ordinateur exécutant le service de passerelle :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

Note

L’ajout ou la modification de ces clés de Registre s’appliquent à toutes les applications .NET.Adding or modifying these registry keys applies the change to all .NET applications. Pour plus d’informations sur les modifications du Registre qui affectent le protocole TLS pour d’autres applications, voir Paramètres de Registre pour le protocole TLS.For information about registry changes that affect TLS for other applications, see Transport Layer Security (TLS) registry settings.

Sources de donnéesData sources

Erreur : connexion impossible.Error: Unable to Connect. Détails : « Informations d’identification de connexion non valides »Details: "Invalid connection credentials"

Le message d’erreur reçu de la source de données doit apparaître dans Afficher les détails.Within Show details, it should display the error message received from the data source. Pour SQL Server, un message comme celui-ci doit apparaître.For SQL Server, you should see something like the following.

Login failed for user 'username'.

Vérifiez l’exactitude du nom d’utilisateur et du mot de passe.Verify that you have the correct username and password. Vérifiez également que les informations d’identification permettent bien de se connecter à la source de données.Also verify that those credentials can successfully connect to the data source. Vérifiez que le compte utilisé correspond à la méthode d’authentification.Make sure the account being used matches the Authentication Method.

Erreur : connexion impossible.Error: Unable to Connect. Détails : « Impossible de se connecter à la base de données »Details: "Cannot connect to the database"

Nous avons établi la connexion au serveur, mais pas à la base de données fournie.We were able to connect to the server, but not to the database supplied. Vérifiez le nom de la base de données et que les informations d’identification de l’utilisateur possèdent les autorisations appropriées pour accéder à cette base de données.Verify the name of the database, and that the user credential as the proper permission to access that database.

Le message d’erreur reçu de la source de données doit apparaître dans Afficher les détails.Within Show details, it should display the error message received from the data source. Pour SQL Server, un message comme celui-ci doit apparaître.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'.

Erreur : connexion impossible.Error: Unable to Connect. Détails : « Erreur inconnue dans la passerelle de données »Details: "Unknown error in data gateway"

Cette erreur peut se produire pour différentes raisons.This error could occur for different reasons. Veillez à valider que vous pouvez vous connecter à la source de données à partir de l’ordinateur qui héberge la passerelle.Be sure to validate that you can connect to the data source from the machine hosting the gateway. Cela peut être dû au fait que le serveur ne soit pas accessible.This could be the result of the server not being accessible.

Le code d’erreur DM_GWPipeline_UnknownErrorapparaît dans Afficher les détails.Within Show details, you will see an error code of DM_GWPipeline_UnknownError.

Pour plus d’informations, vous pouvez également consulter les journaux d’événements > Journaux des applications et des services > Service Passerelle de données locale.You can also look in the Event Logs > Applications and Services Logs > on-premises data gateway Service for more details.

Erreur : Nous avons rencontré une erreur lors de la tentative de connexion à Error: We encountered an error while trying to connect to . Détails : « Nous avons pu accéder à la data gateway, mais celle-ci ne peut pas accéder à la source de données locale ».Details: "We reached the data gateway, but the gateway can't access the on-premises data source."

Nous n’avons pas pu nous connecter à la source de données spécifiée.We were unable to connect to the specified data source. Veillez à valider les informations fournies pour cette source de données.Be sure to validate the information provided for that data source.

Le code d’erreur DM_GWPipeline_Gateway_DataSourceAccessErrorapparaît dans Afficher les détails.Within Show details, you will see an error code of DM_GWPipeline_Gateway_DataSourceAccessError.

Si le message d’erreur sous-jacent est similaire à ce qui suit, cela signifie que le compte que vous utilisez pour la source de données n’est pas un administrateur de serveur pour cette instance d’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. En savoir plusLearn more

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

Si le message d’erreur sous-jacent est similaire à ce qui suit, cela peut signifier qu’un attribut d’annuaire token-groups-global-and-universal (TGGAU) peut être absent du compte de service Analysis Services.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.

Dans les domaines avec un accès de compatibilité pré-Windows 2000, l’attribut TGGAU est activé.Domains with Pre-Windows 2000 compatibility access will have the TGGAU attribute enabled. Par contre, il n’est pas activé par défaut dans les domaines les plus récents.However, most newly created domains will not enable this attribute by default. D’autres informations sur ce sujet sont disponible ici.You can read more about this here.

Pour confirmer cela, procédez comme suit.You can confirm this by doing the following.

  1. Connectez-vous à l’ordinateur Analysis Services dans SQL Server Management Studio.Connect to the Analysis Services machine within SQL Server Management Studio. Dans les propriétés de connexion avancées, incluez EffectiveUserName pour l’utilisateur en question et voyez si cela reproduit l’erreur.Within the Advanced connection properties, include EffectiveUserName for the user in question and see if this reproduces the error.
  2. Vous pouvez utiliser l’outil dsacls d’Active Directory pour vérifier si l’attribut est répertorié.You can use the dsacls Active Directory tool to validate whether the attribute is listed. Cet outil se trouve normalement sur un contrôleur de domaine.This is tool is normally found on a domain controller. Vous devez connaître le nom de domaine unique du compte et le transmettre à l’outil.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"
    

    Les résultats doivent avoir l’aspect suivant.You want to see something similar to the following in the results.

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

Pour corriger ce problème, vous devez activer TGGAU sur le compte utilisé pour le service Analysis Services.To correct this issue, you will need to enable TGGAU on account used for the Analysis Services windows service.

Autre motif pouvant expliquer un nom d'utilisateur ou mot de passe incorrectAnother possibility for user name or password incorrect

Cette erreur peut également se produire si le serveur Analysis Services est situé dans un autre domaine que les utilisateurs et s’il n’est pas configuré pour une approbation bidirectionnelle.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.

Vous devez collaborer avec les administrateurs de domaine pour vérifier la relation d’approbation entre les domaines.You will need to work with your domain administrators to verify the trust relationship between domains.

Impossible de voir les sources de données de la passerelle de données dans l’expérience « Obtenir les données » pour Analysis Services à partir du service Power BIUnable to see the data gateway data sources in the 'Get Data' experience for Analysis Services from the Power BI service

Vérifiez que votre compte est répertorié sous l’onglet Utilisateurs de la source de données dans la configuration de la passerelle.Make sure that your account is listed in the Users tab of the data source within the gateway configuration. Si vous n’avez pas accès à la passerelle, contactez son administrateur pour lui demander d’effectuer des vérifications.If you don't have access to the gateway, check with the administrator of the gateway and ask them to verify. Seuls les comptes figurant dans la liste Utilisateurs verront la source de données répertoriée dans la liste Analysis Services.Only accounts in the Users list will see the data source listed in the Analysis Services list.

Jeux de donnéesDatasets

Erreur : espace insuffisant pour cette ligne.Error: There is not enough space for this row.

Cela se produit si la taille d’une seule ligne est supérieure à 4 Mo.This will occur if you have a single row greater than 4 MB in size. Vous devez identifier la ligne dans votre source de données et essayer de l’éliminer ou d’en réduire la taille.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.

Erreur : Le nom de serveur fourni ne correspond pas au nom de serveur du certificat SSL SQL Server.Error: The server name provided doesn't match the server name on the SQL Server SSL Certificate.

Cela peut se produire lorsque le nom commun du certificat correspond au nom de domaine complet du serveur mais que vous avez fourni uniquement le nom netbios du serveur.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. Cela provoque une incompatibilité du certificat.This will cause a mismatch for the certificate. Pour résoudre ce problème, vous devez indiquer au nom de serveur de la source de données de la passerelle et au fichier PBIX d’utiliser le nom de domaine complet du serveur.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.

Je ne vois pas le pourcentage de la passerelle de données locale lorsque je configure l’actualisation planifiée.I don't see the on-premises data gateway persent when configuring scheduled refresh.

Cela peut être dû à différents scénarios.This could be because of a few different scenarios.

  1. Le nom du serveur et celui de la base de données ne correspondent pas à ce qui a été entré dans Power BI Desktop et la source de données configurée pour la passerelle.The server and database name don't match between what was entered in Power BI Desktop and the data source configured for the gateway. Ces valeurs doivent être identiques.These need to be the same values. Elles ne sont pas sensibles à la casse.They are not case sensitive.
  2. Votre compte n’est pas répertorié sous l’onglet Utilisateurs de la source de données dans la configuration de la passerelle.Your account is not listed in the Users tab of the data source within the gateway configuration. Vous devez contacter l’administrateur de la passerelle pour que celui-ci l’ajoute à cette liste.You will need to get with the administrator of the gateway to be added to that list.
  3. Votre fichier Power BI Desktop a plusieurs sources de données et celles-ci ne sont pas toutes configurées avec la passerelle.Your Power BI Desktop file has multiple data sources within it and not all of those data sources are configured with the gateway. Chaque source de données définie avec la passerelle doit s’afficher dans l’actualisation planifiée.You will need to have each data source defined with the gateway for the gateway to show up within Scheduled Refresh.

Erreur : Les données non compressées reçues sur le client de la passerelle ont dépassé la limite.Error: The received uncompressed data on the gateway client has exceeded limit.

La limitation exacte est de 10 Go de données non compressées par table.The exact limitation is 10 GB of uncompressed data per table. Si vous rencontrez ce problème, il existe plusieurs options pour l’optimiser et l’éviter.If you are hitting this issue, there are good options to optimize and avoid the issue. Une solution conseillée est de réduire l’utilisation de longues valeurs de chaîne très répétitives et à la place d’utiliser une clé normalisée ou de supprimer la colonne (si celle-ci n’est pas utilisée).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.

RapportsReports

Le rapport n’a pas pu accéder à la source de données, car vous n’avez pas accès à notre source de données via une passerelle de données locale.Report could not access the data source because you do not have access to our data source via an on-premises data gateway.

Ceci est généralement dû à une des causes suivantes.This is usually caused by one of the following.

  1. Les informations de la source de données ne correspondent pas à ce qui est dans le jeu de données sous-jacent.The data source information does not match what is in the underlying dataset. Le nom du serveur et celui de la base de données doivent correspondre entre la source de données définie pour la passerelle de données locale et ce que vous indiquez dans 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. Si vous utilisez une adresse IP dans Power BI Desktop, la source de données pour la passerelle de données locale doit également utiliser une adresse 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. Aucune source de données n’est disponible sur les passerelles au sein de votre organisation.There is not a data source available on any gateway within your organization. Vous pouvez configurer la source de données sur une passerelle de données locale nouvelle ou existante.You can configure the data source on a new, or existing, on-premises data gateway.

Erreur : Erreur d’accès à la source de données.Error: Data source access error. Contactez l’administrateur de la passerelle.Please contact the gateway administrator.

Si ce rapport utilise une connexion Analysis Services en direct, vous pouvez rencontrer un problème dans lequel une valeur est passée à un élément EffectiveUserName qui n’est pas valide ou ne dispose pas des autorisations sur l’ordinateur 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. En règle générale, un problème d’authentification est dû au fait que la valeur transmise pour EffectiveUserName ne correspond pas au nom d’utilisateur principal local (UPN).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).

Pour confirmer cela, procédez comme suit.To confirm this, you can do the following.

  1. Recherchez le nom d’utilisateur en vigueur dans les journaux de la passerelle.Find the effective username within the gateway logs.
  2. Une fois la valeur transmise, validez qu’elle est correcte.Once you have the value being passed, validate that it is correct. S’il s’agit de votre utilisateur, vous pouvez utiliser la commande suivante à partir d’une invite de commandes pour voir quel doit être le nom d’utilisateur principal.If it is your user, you can use the following command from a command prompt to see what the UPN should be. Ce dernier ressemble à une adresse de messagerie.The UPN will look like an email address.

     whoami /upn
    

Si vous le souhaitez, vous pouvez voir ce que Power BI obtient d’Azure Active Directory.Optionally, you can see what Power BI gets from Azure Active Directory.

  1. Accédez à https://graphexplorer.cloudapp.net.Browse to https://graphexplorer.cloudapp.net.
  2. Sélectionnez Se connecter dans le coin supérieur droit.Select Sign in in the upper right.
  3. Exécutez la requête suivante.Run the following query. Une réponse JSON plutôt volumineuse s’affiche.You will see a rather large JSON response.

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

Si votre nom d’utilisateur principal Azure Active Directory ne correspond pas à votre nom d’utilisateur principal Active Directory local, vous pouvez utiliser la fonctionnalité Mapper les noms d’utilisateur pour la remplacer par une valeur valide.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. Vous pouvez également contacter votre administrateur de locataire ou l’administrateur Active Directory local pour qu’il modifie votre nom d’utilisateur principal.Or you can work with either your tenant admin, or local Active Directory admin, to get your UPN changed.

Pare-feu ou proxyFirewall or Proxy

Pour plus d’informations sur la fourniture d’informations de proxy pour votre passerelle, consultez Configuration des paramètres de proxy pour les passerelles Power BI.For information on providing proxy information for your gateway, see Configuring proxy settings for the Power BI gateways.

Vous pouvez effectuer un test pour voir si votre pare-feu ou votre proxy risque de bloquer des connexions en exécutant la commande Test-NetConnection à partir d’une invite PowerShell.You can test to see if your firewall, or proxy, may be blocking conections by running Test-NetConnection from a PowerShell prompt. Cette opération teste la connectivité à Azure Service Bus.This will test connectivity to the Azure Service Bus. Ce test s’applique uniquement à la connectivité réseau et ne concerne pas le service du serveur cloud ni la passerelle.This only tests network connectivity and doesn't have anything to do with the cloud server service or the gateway. Il permet de déterminer si votre ordinateur peut réellement atteindre Internet.It helps to determine if your machine can actually get out to the internet.

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

Note

La commande Test-NetConnection est uniquement disponible sur Windows Server 2012 R2 et versions ultérieures.Test-NetConnection is only available on Windows Server 2012 R2 and later. Elle est également disponible sur Windows 8.1 et versions ultérieures.It is also available on Windows 8.1 and later. Dans les versions antérieures du système d’exploitation, vous pouvez utiliser Telnet pour tester la connectivité des ports.On earlier OS versions, you can use Telnet to test port connectivity.

Le résultat doit ressembler à ce qui suit.The results should look similar to the following. La différence sera avec TcpTestSucceeded.The difference will be with TcpTestSucceeded. Si TcpTestSucceeded n’a pas la valeur true, vous pouvez être bloqué par un pare-feu.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

Si vous voulez être exhaustif, remplacez les valeurs ComputerName et Port par celles répertoriées pour les portsIf you want to be exhaustive, substitute the ComputerName and Port values with those listed for ports

Le pare-feu peut également bloquer les connexions effectuées par Azure Service Bus vers les centres de données Azure.The firewall may also be blocking the connections that the Azure Service Bus makes to the Azure data centers. Si tel est le cas, nous vous conseillons d’ajouter à la liste verte (débloquer) les adresses IP de votre région pour ces centres de données.If that is the case, you will want to whitelist (unblock) the IP addresses for your region for those data centers. Vous pouvez obtenir une liste des adresses IP Azure ici.You can get a list of Azure IP addresses here.

Pour trouver la région dans laquelle est situé votre centre de données, procédez comme suit :You can find the data center region you are in by doing the following:

  1. Sélectionnez le signe ?Select the ? dans le coin supérieur droit du service Power BI.in the upper right of the Power BI service.
  2. Sélectionnez À propos de Power BI.Select About Power BI.
  3. La région de vos données s’affiche dans Vos données sont stockées dans.Your data region will be listed in Your data is stored in.

Si vous n’obtenez pas les informations souhaitées, vous pouvez essayer d’obtenir une trace réseau à l’aide d’un outil tel que fiddler ou netsh. Sachez toutefois que ces méthodes de collecte nécessitent un niveau avancé et que vous aurez peut-être besoin d’aide pour analyser les données collectées.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. Vous pouvez contacter le support pour obtenir de l’aide.You can contact support for assistance.

PerformancesPerformance

Compteurs de performancePerformance Counters

Plusieurs compteurs de performance permettent d’évaluer les activités de la passerelle.There are a number of performance counters that can be used to gauge the activities for the gateway. Ils peuvent être utiles pour comprendre si la charge d’activité est conséquente, et s’il faut envisager de mettre en place une nouvelle passerelle.These can be helpful to understanding if we have a large load of activity and may need to make a new gateway. Ces compteurs ne reflètent pas la durée d’exécution d’une opération.These counters will not reflect how long something takes.

Il sont accessibles via l’outil Analyseur de performances Windows.These counters can be access through the Windows Performance Monitor tool.

Il existe des groupements généraux de ces compteurs.There are general groupings of these counters.

Type de compteurCounter Type DescriptionDescription
ADO.NETADO.NET Utilisé pour toute connexion DirectQuery.This is used for any DirectQuery connection.
ADOMDADOMD Utilisé pour Analysis Services 2014 et versions antérieures.This is used for Analysis Services 2014 and earlier.
OLEDBOLEDB Utilisé par certaines sources de données.This is used by certain data sources. Celles-ci incluent SAP HANA et Analysis Services 2016 ou version ultérieure.This includes SAP HANA and Analysis Service 2016 or later.
MashupMashup Inclut toute source de données importées.This includes any imported data source. Si vous projetez d’actualiser ou d’effectuer une actualisation à la demande, cette opération passe par le moteur Mashup.If you are scheduling refresh or doing an on-demand refresh, it will go through the mashup engine.

Voici la liste des compteurs de performance disponibles.Here is a listing of the available performance counters.

CompteurCounter DescriptionDescription
Nombre d’ouvertures de connexion ADO.NET exécutées par seconde# of ADO.NET open connection executed / sec Nombre d’actions d’ouverture de connexion ADO.NET exécutées par seconde (ayant réussi ou échoué).Number of ADO.NET open connection actions executed per second (succeeded or failed).
Nombre d’ouvertures de connexion ADO.NET ayant échoué par seconde# of ADO.NET open connection failed / sec Nombre d’actions d’ouverture de connexion ADO.NET ayant échoué par seconde.Number of ADO.NET open connections actions failed per second.
Nombre de requêtes ADO.NET exécutées par seconde# of ADO.NET queries executed / sec Nombre de requêtes ADO.NET exécutées par seconde (ayant réussi ou échoué).Number of ADO.NET queries executed per second (succeeded or failed).
Nombre de requêtes ADO.NET ayant échoué par seconde# of ADO.NET queries failed / sec Nombre de requêtes ADO.NET ayant échoué exécutées par seconde.Number of ADO.NET failed queries executed per second.
Nombre d’ouvertures de connexion ADOMD exécutées par seconde# of ADOMD open connection executed / sec Nombre d’actions d’ouverture de connexion ADOMD exécutées par seconde (ayant réussi ou échoué).Number of ADOMD open connection actions executed per second (succeeded or failed).
Nombre d’ouvertures de connexion ADOMD ayant échoué par seconde# of ADOMD open connection failed / sec Nombre d’actions d’ouverture de connexion ADOMD ayant échoué par seconde.Number of ADOMD open connection actions failed per second.
Nombre de requêtes ADOMD exécutées par seconde# of ADOMD queries executed / sec Nombre de requêtes ADOMD exécutées par seconde (ayant réussi ou échoué).Number of ADOMD queries executed per second (succeeded or failed).
Nombre de requêtes ADOMD ayant échoué par seconde# of ADOMD queries failed / sec Nombre de requêtes ADOMD ayant échoué exécutées par seconde.Number of ADOMD failed queries executed per second.
Nombre d’ouvertures de connexion exécutées par seconde# of all open connection executed / sec Nombre d’actions d’ouverture de connexion exécutées par seconde (ayant réussi ou échoué).Number of open connection actions executed per second (succeeded or failed).
Nombre d’ouvertures de connexion ayant échoué par seconde# of all open connection failed / sec Nombre d’actions d’ouverture de connexion ayant échoué exécutées par seconde.Number of failed open connection actions executed per second.
Nombre de requêtes exécutées par seconde# of all queries executed / sec Nombre de requêtes exécutées par seconde (ayant réussi ou échoué).Number of queries executed per second (succeeded or failed).
Nombre d’éléments dans le pool de connexions ADO.NET# of items in the ADO.NET connection pool Nombre d’éléments dans le pool de connexions ADO.NET.Number of items in the ADO.NET connection pool.
Nombre d’éléments dans le pool de connexions OLEDB# of items in the OLEDB connection pool Nombre d’éléments dans le pool de connexions OLEDB.Number of items in the OLEDB connection pool.
Nombre d’éléments dans le pool Service Bus# of items in the Service Bus pool Nombre d’éléments dans le pool Service Bus.Number of items in the Service Bus pool.
Nombre d’ouvertures de connexion Mashup exécutées par seconde# of Mashup open connection executed / sec Nombre d’actions d’ouverture de connexion Mashup exécutées par seconde (ayant réussi ou échoué).Number of Mashup open connection actions executed per second (succeeded or failed).
Nombre d’ouvertures de connexion Mashup ayant échoué par seconde# of Mashup open connection failed / sec Nombre d’actions d’ouverture de connexion Mashup ayant échoué par seconde.Number of Mashup open connection actions failed per second.
Nombre de requêtes Mashup exécutées par seconde# of Mashup queries executed / sec Nombre de requêtes Mashup exécutées par seconde (ayant réussi ou échoué).Number of Mashup queries executed per second (succeeded or failed).
Nombre de requêtes Mashup ayant échoué par seconde# of Mashup queries failed / sec Nombre de requêtes Mashup ayant échoué exécutées par seconde.Number of Mashup failed queries executed per second
Nombre de requêtes OLEDB de jeux de résultats multiples ayant échoué par seconde# of multiple result set OLEDB queries failed / sec Nombre de requêtes OLEDB de jeux de résultats multiples ayant échoué exécutées par seconde.Number of multiple resultset OLEDB failed queries executed per second.
Nombre de requêtes OLEDB de jeux de résultats multiples exécutées par seconde# of OLEDB multiple resultset queries executed / sec Nombre de requêtes OLEDB de jeux de résultats multiples exécutées par seconde (ayant réussi ou échoué).Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
Nombre d’ouvertures de connexion OLEDB exécutées par seconde# of OLEDB open connection executed / sec Nombre d’actions d’ouverture de connexion OLEDB exécutées par seconde (ayant réussi ou échoué).Number of OLEDB open connection actions executed per second (succeeded or failed).
Nombre d’ouvertures de connexion OLEDB ayant échoué par seconde# of OLEDB open connection failed / sec Nombre d’actions d’ouverture de connexion OLEDB ayant échoué par seconde.Number of OLEDB open connection actions failed per second.
Nombre de requêtes OLEDB exécutées par seconde# of OLEDB queries executed / sec Nombre de requêtes OLEDB de jeux de résultats multiples exécutées par seconde (ayant réussi ou échoué).Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
Nombre de requêtes OLEDB ayant échoué par seconde# of OLEDB queries failed / sec Nombre de requêtes OLEDB de jeux de résultats multiples ayant échoué exécutées par seconde.Number of OLEDB mutiple resultset failed queries executed per second.
Nombre de requêtes OLEDB de jeu de résultats unique exécutées par seconde# of OLEDB single resultset queries executed / sec Nombre de requêtes OLEDB de jeu de résultats unique exécutées par seconde (ayant réussi ou échoué).Number of OLEDB single resultset queries executed per second (succeeded or failed).
Nombre de requêtes ayant échoué par seconde# of queries failed / sec Nombre de requêtes ayant échoué exécutées par seconde.Number of failed queries executed per second.
Nombre de requêtes OLEDB de jeu de résultats unique ayant échoué par seconde# of single result set OLEDB queries failed / sec Nombre de requêtes OLEDB de jeu de résultats unique ayant échoué exécutées par seconde.Number of single resultset OLEDB failed queries executed per second.

Examen des requêtes lentesReviewing slow performing queries

Il se peut que la réponse via la passerelle soit lente.You may find that response through the gateway is slow. Par exemple lors de requêtes DirectQuery ou lors de l’actualisation de votre jeu de données importé.This could be for DirectQuery queries or when refreshing your imported dataset. Vous pouvez activer une journalisation supplémentaire des requêtes de sortie et de leurs durées pour comprendre quel élément s’exécute lentement.You can enable additional logging to output queries and their timings to help understand what is performing slow. Lorsque vous trouvez une requête dont l’exécution est longue, une modification supplémentaire de votre source de données peut être nécessaire pour ajuster les performances de la requête.When you find a long running query, it may require additional modification on your data source to tune query performance. Par exemple le réglage des index pour une requête SQL Server.For example, adjusting indexes for a SQL Server query.

Pour déterminer la durée d’une requête, vous devez modifier deux fichiers de configuration.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

Dans le fichier Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, modifiez la valeur EmitQueryTraces de False en True.Within the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file, change the EmitQueryTraces value from False to True. Ce fichier se trouve, par défaut, dans C:\Program Files\On-premises data gateway.This file is located, by default, at C:\Program Files\On-premises data gateway. L’activation de EmitQueryTraces entraîne la journalisation des requêtes envoyées de la passerelle à une source de données.Enabling EmitQueryTraces will begin to log queries that are sent from the gateway to a data source.

Important

L’activation de EmitQueryTraces peut augmenter considérablement la taille du journal en fonction de l’utilisation de la passerelle.Enabling EmitQueryTraces could increase the log size significantly depending on gateway usage. Lorsque vous avez terminé d’examiner les journaux, vous pouvez définir EmitQueryTraces sur False.Once you are done reviewing the logs, you will want to set EmitQueryTraces to False. Il est déconseillé de laisser ce paramètre activé à long terme.It is not recommended to leave this setting enabled long term.

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

Exemple d’entrée de requêteExample 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

Dans le fichier Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config, modifiez la valeur TraceVerbosity de 4 en 5.Within the Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config file, change the TraceVerbosity value from 4 to 5. Ce fichier se trouve, par défaut, dans C:\Program Files\On-premises data gateway.This file is located, by default, at C:\Program Files\On-premises data gateway. La modification de ce paramètre entraîne la journalisation d’entrées détaillées dans le journal de la passerelle.Changing this setting will begin to log verbose entries to the gateway log. Celles-ci incluent les entrées indiquant une durée.This includes entries that show duration.

Important

L’activation de TraceVerbosity sur 5 peut augmenter considérablement la taille du journal en fonction de l’utilisation de la passerelle.Enabling TraceVerbosity to 5 could increase the log size significantly depending on gateway usage. Lorsque vous avez terminé d’examiner les journaux, vous pouvez définir TraceVerbosity sur 4.Once you are done reviewing the logs, you will want to set TraceVerbosity to 4. Il est déconseillé de laisser ce paramètre activé à long terme.It is not recommended to leave this setting enabled long term.

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

Types d’activitésActivity Types

Type d’activitéActivty Type DescriptionDescription
MGEQMGEQ Requêtes exécutées sur ADO.NET.Queries executed over ADO.NET. Incluent les sources de données DirectQuery.This includes DirectQuery data sources.
MGEOMGEO Requêtes exécutées sur OLEDB.Queries executed over OLEDB. Incluent SAP HANA et Analysis Services 2016.This includes SAP HANA and Analysis Services 2016.
MGEMMGEM Requêtes exécutées à partir du moteur Mashup.Queries executed from the Mashup engine. Sont utilisées avec des jeux de données importés qui utilisent une actualisation planifiée ou actualisent à la demande.This is used with imported datasets that use scheduled refresh or refresh on-demand.

Déterminer la durée d’une requêteDetermine the duration of a query

Pour déterminer le temps nécessaire pour interroger la source de données, vous pouvez procédez comme suit.To determine the time it took to query the data source, you can do the following.

  1. Ouvrez le journal de la passerelle.Open the gateway log.
  2. Recherchez un Activity Type (Type d’activité) pour trouver la requête.Search for an Activity Type to find the query. Un exemple serait MGEQ.An example of this would be MGEQ.
  3. Notez le second GUID, car il s’agit de l’ID de la demande.Make note of the second GUID as this is the request id.
  4. Continuez à rechercher MGEQ jusqu’à trouver l’entrée FireActivityCompletedSuccessfullyEvent indiquant la durée.Continue to search for MGEQ until you find the FireActivityCompletedSuccessfullyEvent entry with the duration. Vous pouvez vérifier que l’entrée a le même ID de demande. La durée est exprimée en millisecondes.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)
    

    Note

    FireActivityCompletedSuccessfullyEvent est une entrée détaillée.FireActivityCompletedSuccessfullyEvent is a verbose entry. Cette entrée n’est journalisée que si TraceVerbosity est au niveau 5.This entry will not be logged unless TraceVerbosity is at level 5.

Outils de résolution des problèmesTools for troubleshooting

Collecte de journaux à partir de l’outil de configuration de passerelleCollecting logs from the gateway configurator

Il existe plusieurs journaux que vous pouvez collecter pour la passerelle et vous devez toujours commencer avec eux.There are several logs you can collect for the gateway, and you should always start with the logs. L’interface utilisateur est le moyen le plus simple de collecter des journaux après l’installation de la passerelle.The simplest way to collect logs after installing the gateway is through the user interface. Dans l’interface utilisateur Passerelle de données locale, sélectionnez Diagnostics, puis le lien Exporter les journaux vers le bas de la page, comme indiqué dans l’image suivante.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

Journaux du programme d’installationInstaller logs

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

Journaux de configurationConfiguration logs

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

Journaux du service de passerelle de données localeOn-premises data gateway service logs

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

Journaux d’événementsEvent Logs

Les journaux d’événements du service de passerelle de données locale se trouvent à l’emplacement Journaux des applications et des services.The On-premises data gateway service event logs are present under Application and Services Logs.

On-prem-data-gateway-event-logs

Trace FiddlerFiddler Trace

Fiddler est un outil gratuit de Telerik qui surveille le trafic HTTP.Fiddler is a free tool from Telerik that monitors HTTP traffic. Vous pouvez voir les allers et retours au niveau du service Power BI à partir de l’ordinateur client.You can see the back and forth with the Power BI service from the client machine. Vous pouvez ainsi repérer les erreurs et d’autres informations connexes.This may show errors and other related information.

Historique des actualisationsRefresh History

Lors de l’utilisation de la passerelle pour un actualisation planifiée, l’historique des actualisations peut vous aider à déterminer les erreurs qui se sont produites. Vous pouvez aussi y trouver des données utiles au cas où vous auriez besoin de créer une demande de support.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. Vous pouvez visualiser à la fois les actualisations planifiées et les actualisations à la demande.You can view both scheduled, as well as on demand, refreshes. Voici comment accéder à l’historique des actualisations.Here is how you can get to the Refresh History.

  1. Dans le volet de navigation Power BI, dans Jeux de données, sélectionnez un jeu de données > Menu Ouvrir > Planifier l’actualisationIn the Power BI navigation pane, in Datasets, select a dataset > Open Menu > Schedule Refresh.

  2. Dans Paramètres pour... >Planifier l’actualisation, sélectionnez Historique des actualisations.In Settings for... > Schedule Refresh, select Refresh History.

Pour plus d’informations sur la résolution des problèmes d’actualisation, consultez Scénarios de résolution de problèmes liés à l’actualisation.For additional information about troubleshooting refresh scenarios, take a look at the Troubleshooting Refresh Scenarios article.

Étapes suivantesNext steps

Configuration des paramètres de proxy pour les passerelles Power BIConfiguring proxy settings for the Power BI gateways
Passerelle de données localeOn-premises data gateway
Informations approfondies sur la passerelle de données localeOn-premises data gateway - in-depth
Gérer votre source de données - Analysis ServicesManage your data source - Analysis Services
Gérer votre source de données - SAP HANAManage your data source - SAP HANA
Gérer votre source de données - SQL ServerManage your data source - SQL Server
Gérer votre source de données - Importation/actualisation planifiéeManage your data source - Import/Scheduled refresh
D’autres questions ?More questions? Posez vos questions à la communauté Power BITry the Power BI Community