Résoudre les problèmes liés à l’utilisation de la passerelle de gestion des donnéesTroubleshoot issues with using Data Management Gateway

Cet article fournit des informations sur la résolution des problèmes liés à l’utilisation de la passerelle de gestion des données.This article provides information on troubleshooting issues with using Data Management Gateway.

Notes

Cet article s’applique à la version 1 d’Azure Data Factory.This article applies to version 1 of Azure Data Factory. Si vous utilisez la version actuelle du service Data Factory, consultez Guide pratique pour créer et configurer le runtime d’intégration auto-hébergé dans Data Factory.If you are using the current version of the Data Factory service, see self-hosted integration runtime in Data Factory.

Pour obtenir des informations détaillées sur la passerelle, consultez l’article Passerelle de gestion des données.See the Data Management Gateway article for detailed information about the gateway. Pour connaître la procédure de déplacement de données d’une base de données SQL Server locale vers un stockage Blob Microsoft Azure avec la passerelle, consultez l’article Déplacer des données entre un site local et le cloud.See the Move data between on-premises and cloud article for a walkthrough of moving data from an on-premises SQL Server database to Microsoft Azure Blob storage by using the gateway.

Échec de l’inscription ou de l’installation de la passerelleFailed to install or register gateway

1. Problème1. Problem

Ce message d’erreur s’affiche lors de l’installation et de l’enregistrement d’une passerelle, en particulier lors du téléchargement du fichier d’installation de la passerelle.You see this error message when installing and registering a gateway, specifically, while downloading the gateway installation file.

Unable to connect to the remote server". Please check your local settings (Error Code: 10003).

Cause :Cause

L’ordinateur sur lequel vous essayez d’installer la passerelle n’a pas pu télécharger le fichier d’installation de la dernière version de la passerelle à partir du Centre de téléchargement en raison d’un problème réseau.The machine on which you are trying to install the gateway has failed to download the latest gateway installation file from the download center due to a network issue.

Résolution :Resolution

Vérifiez si les paramètres de serveur proxy de votre pare-feu bloquent la connexion réseau de l’ordinateur vers le Centre de téléchargement et modifiez ces paramètres si nécessaire.Check your firewall proxy server settings to see whether the settings block the network connection from the computer to the download center, and update the settings accordingly.

Vous pouvez également télécharger le fichier d’installation de la dernière version de la passerelle à partir du Centre de téléchargement sur d’autres ordinateurs qui peuvent accéder à ce dernier.Alternatively, you can download the installation file for the latest gateway from the download center on other machines that can access the download center. Copiez ensuite le fichier du programme d’installation sur l’ordinateur hôte de la passerelle et exécutez-le manuellement pour installer et mettre à jour la passerelle.You can then copy the installer file to the gateway host computer and run it manually to install and update the gateway.

2. Problème2. Problem

Cette erreur s’affiche lorsque vous tentez d’installer une passerelle en cliquant sur Installer directement sur cet ordinateur dans le portail Azure.You see this error when you're attempting to install a gateway by clicking install directly on this computer in the Azure portal.

Error: Abort installing a new gateway on this computer because this computer has an existing installed gateway and a computer without any installed gateway is required for installing a new gateway.

Cause :Cause

Une passerelle est déjà installée sur l’ordinateur.A gateway is already installed on the machine.

Résolution :Resolution

Désinstallez la passerelle existante sur l’ordinateur et cliquez de nouveau sur le lien Installer directement sur cet ordinateur.Uninstall the existing gateway on the machine and click the install directly on this computer link again.

3. Problème3. Problem

Cette erreur peut s’afficher lorsque vous inscrivez une nouvelle passerelle.You might see this error when registering a new gateway.

Error: The gateway has encountered an error during registration.

Cause :Cause

Ce message peut s’afficher pour l’une des raisons suivantes :You might see this message for one of the following reasons:

  • Le format de la clé de passerelle n’est pas valide.The format of the gateway key is invalid.
  • La clé de passerelle a été invalidée.The gateway key has been invalidated.
  • La clé de passerelle a été régénérée à partir du portail.The gateway key has been regenerated from the portal.

Résolution :Resolution

Vérifiez que vous utilisez la bonne clé de passerelle du portail.Verify whether you are using the right gateway key from the portal. Si besoin, régénérez une clé et utilisez cette clé pour inscrire la passerelle.If needed, regenerate a key and use the key to register the gateway.

4. Problème4. Problem

Le message d’erreur suivant peut s’afficher lors de l’inscription d’une passerelle.You might see the following error message when you're registering a gateway.

Error: The content or format of the gateway key "{gatewayKey}" is invalid, please go to azure portal to create one new gateway or regenerate the gateway key.

Contenu ou format de clé non valide

Cause :Cause

Le contenu ou le format de la clé de passerelle est incorrect.The content or format of the input gateway key is incorrect. Vous avez peut-être copié uniquement une partie de la clé dans le portail ou vous utilisez une clé non valide.One of the reasons can be that you copied only a portion of the key from the portal or you're using an invalid key.

Résolution :Resolution

Générez une clé de passerelle dans le portail et utilisez le bouton Copier pour copier la clé entière.Generate a gateway key in the portal, and use the copy button to copy the whole key. Collez-la ensuite dans cette fenêtre pour inscrire la passerelle.Then paste it in this window to register the gateway.

5. Problème5. Problem

Le message d’erreur suivant peut s’afficher lors de l’inscription d’une passerelle.You might see the following error message when you're registering a gateway.

Error: The gateway key is invalid or empty. Specify a valid gateway key from the portal.

La clé de passerelle n’est pas valide ou est vide.

Cause :Cause

La clé de passerelle a été régénérée ou la passerelle a été supprimée dans le portail Azure.The gateway key has been regenerated or the gateway has been deleted in the Azure portal. Cela peut également se produire si vous n’utilisez pas la configuration de passerelle de gestion des données la plus récente.It can also happen if the Data Management Gateway setup is not latest.

Résolution :Resolution

Vérifiez que la configuration de la passerelle de gestion des données correspond à la dernière version (vous trouverez la dernière version dans le centre de téléchargement Microsoft).Check if the Data Management Gateway setup is the latest version, you can find the latest version on the Microsoft download center.

Si la configuration est à jour/correspond à la dernière version et que la passerelle existe encore sur le portail, régénérez la clé de la passerelle dans le portail Azure, utilisez le bouton Copier pour copier la clé et collez-la dans cette fenêtre pour inscrire la passerelle.If setup is current/ latest and gateway still exists on Portal, regenerate the gateway key in the Azure portal, and use the copy button to copy the whole key, and then paste it in this window to register the gateway. Sinon, recréez la passerelle et recommencez.Otherwise, recreate the gateway and start over.

6. Problème6. Problem

Le message d’erreur suivant peut s’afficher lors de l’inscription d’une passerelle.You might see the following error message when you're registering a gateway.

Error: Gateway has been online for a while, then shows “Gateway is not registered” with the status “Gateway key is invalid”

La clé de passerelle n’est pas valide ou est vide.

Cause :Cause

Cette erreur peut se produire si la passerelle a été supprimée ou la clé de passerelle associée a été régénérée.This error might happen because either the gateway has been deleted or the associated gateway key has been regenerated.

Résolution :Resolution

Si la passerelle a été supprimée, recréez-la à partir du portail, cliquez sur Inscrire, copiez la clé dans le portail, collez-la et essayez d’inscrire la passerelle.If the gateway has been deleted, re-create the gateway from the portal, click Register, copy the key from the portal, paste it, and try to register the gateway.

Si la passerelle existe encore, mais que sa clé a été régénérée, utilisez la nouvelle clé pour inscrire la passerelle.If the gateway still exists but its key has been regenerated, use the new key to register the gateway. Si vous n’avez pas la clé, régénérez-la sur le portail.If you don’t have the key, regenerate the key again from the portal.

7. Problème7. Problem

Lorsque vous inscrivez une passerelle, il se peut que vous deviez entrer le chemin d’accès et le mot de passe d’un certificat.When you're registering a gateway, you might need to enter path and password for a certificate.

Indiquer un certificat

Cause :Cause

La passerelle a été inscrite sur d’autres ordinateurs auparavant.The gateway has been registered on other machines before. Lors de l’inscription initiale de la passerelle, un certificat de chiffrement lui a été associé.During the initial registration of a gateway, an encryption certificate has been associated with the gateway. Le certificat peut avoir été généré automatiquement par la passerelle ou fourni par l’utilisateur.The certificate can either be self-generated by the gateway or provided by the user. Ce certificat est utilisé pour chiffrer les informations d’identification de la banque de données (service lié).This certificate is used to encrypt credentials of the data store (linked service).

Exportation du certificat

Lorsque vous restaurez la passerelle sur un autre ordinateur hôte, l’Assistant Inscription demande ce certificat afin de déchiffrer les informations d’identification précédemment chiffrées avec ce certificat.When restoring the gateway on a different host machine, the registration wizard asks for this certificate to decrypt credentials previously encrypted with this certificate. Sans ce certificat, les informations d’identification ne peuvent pas être déchiffrées par la nouvelle passerelle et les exécutions d’activités de copie suivantes associées à cette nouvelle passerelle échouent.Without this certificate, the credentials cannot be decrypted by the new gateway and subsequent copy activity executions associated with this new gateway will fail.

Résolution :Resolution

Si vous avez exporté le certificat d’informations d’identification de l’ordinateur d’origine de la passerelle avec le bouton Exporter de l’onglet Paramètres du Gestionnaire de configuration de passerelle de gestion des données, utilisez le certificat ici.If you have exported the credential certificate from the original gateway machine by using the Export button on the Settings tab in Data Management Gateway Configuration Manager, use the certificate here.

Vous ne pouvez pas ignorer cette étape lors de la récupération d’une passerelle.You cannot skip this stage when recovering a gateway. Si le certificat est manquant, vous devez supprimer la passerelle depuis le portail et en recréer une.If the certificate is missing, you need to delete the gateway from the portal and re-create a new gateway. Mettez également à jour tous les services liés associés à la passerelle en entrant à nouveau leurs informations d’identification.In addition, update all linked services that are related to the gateway by reentering their credentials.

8. Problème8. Problem

Le message d’erreur suivant peut s’afficher.You might see the following error message.

Error: The remote server returned an error: (407) Proxy Authentication Required.

Cause :Cause

Cette erreur se produit lorsque votre passerelle se trouve dans un environnement qui exige un proxy HTTP pour accéder aux ressources Internet ou lorsque le mot de passe d’authentification de votre serveur proxy est modifié, mais n’est pas actualisé dans votre passerelle.This error happens when your gateway is in an environment that requires an HTTP proxy to access Internet resources, or your proxy's authentication password is changed but it's not updated accordingly in your gateway.

Résolution :Resolution

Suivez les instructions de la section Considérations relatives aux serveurs proxy de cet article et configurez les paramètres de proxy à l’aide du Gestionnaire de configuration de passerelle de gestion des données.Follow the instructions in the Proxy server considerations section of this article, and configure proxy settings with Data Management Gateway Configuration Manager.

La passerelle est en ligne avec des fonctionnalités limitéesGateway is online with limited functionality

1. Problème1. Problem

Vous constatez que la passerelle est connectée avec des fonctionnalités limitées.You see the status of the gateway as online with limited functionality.

Cause :Cause

La passerelle peut être connectée avec des fonctionnalités limitées pour l’une des raisons suivantes :You see the status of the gateway as online with limited functionality for one of the following reasons:

  • La passerelle ne peut pas se connecter au service cloud via Azure Service Bus.Gateway cannot connect to cloud service through Azure Service Bus.
  • Le service cloud ne peut pas se connecter à la passerelle via Service Bus.Cloud service cannot connect to gateway through Service Bus.

Lorsque la passerelle est connectée avec des fonctionnalités limitées, il se peut que vous ne soyez pas en mesure d’utiliser l’Assistant de copie Data Factory afin de créer des pipelines de données pour la copie de données vers des banques de données locales ou à partir de celles-ci.When the gateway is online with limited functionality, you might not be able to use the Data Factory Copy Wizard to create data pipelines for copying data to or from on-premises data stores. Pour résoudre ce problème, vous pouvez utiliser Data Factory Editor dans le portail, Visual Studio ou Azure PowerShell.As a workaround, you can use Data Factory Editor in the portal, Visual Studio, or Azure PowerShell.

Résolution :Resolution

La procédure de résolution de ce problème (passerelle connectée avec des fonctionnalités limitées) n’est pas la même si la passerelle ne peut pas se connecter au service cloud ou si c’est l’inverse.Resolution for this issue (online with limited functionality) is based on whether the gateway cannot connect to the cloud service or the other way. Les sections suivantes fournissent des solutions.The following sections provide these resolutions.

2. Problème2. Problem

Vous obtenez l’erreur suivante.You see the following error.

Error: Gateway cannot connect to cloud service through service bus

La passerelle ne peut pas se connecter au service cloud

Cause :Cause

La passerelle ne peut pas se connecter au service cloud via Service Bus.Gateway cannot connect to the cloud service through Service Bus.

Résolution :Resolution

Suivez ces étapes pour remettre la passerelle en ligne :Follow these steps to get the gateway back online:

  1. Autorisez les règles de trafic sortant d’adresse IP sur l’ordinateur de la passerelle et le pare-feu d’entreprise.Allow IP address outbound rules on the gateway machine and the corporate firewall. Vous pouvez trouver les adresses IP dans le journal des événements Windows (ID == 401) : Tentative d’accès à un socket de manière interdite par ses autorisations d’accès XX.XX.XX.XX:9350.You can find IP addresses from the Windows Event Log (ID == 401): An attempt was made to access a socket in a way forbidden by its access permissions XX.XX.XX.XX:9350.
  2. Configurez les paramètres de proxy de la passerelle.Configure proxy settings on the gateway. Pour plus d’informations, consultez la section Considérations relatives aux serveurs proxy.See the Proxy server considerations section for details.
  3. Activez les ports sortants 5671 et 9350 à 9354 sur le pare-feu Windows de l’ordinateur passerelle et le pare-feu d’entreprise.Enable outbound ports 5671 and 9350-9354 on both the Windows Firewall on the gateway machine and the corporate firewall. Pour plus d’informations, consultez la section Ports et pare-feu.See the Ports and firewall section for details. Cette étape est facultative, mais elle est recommandée pour des questions de performances.This step is optional, but we recommend it for performance consideration.

3. Problème3. Problem

Vous obtenez l’erreur suivante.You see the following error.

Error: Cloud service cannot connect to gateway through service bus.

Cause :Cause

erreur temporaire de connectivité réseau.A transient error in network connectivity.

Résolution :Resolution

Suivez ces étapes pour remettre la passerelle en ligne :Follow these steps to get the gateway back online:

  1. Attendez quelques minutes. La connectivité est récupérée automatiquement une fois que l’erreur a disparu.Wait for a couple of minutes, the connectivity will be automatically recovered when the error is gone.
  2. Si l’erreur persiste, redémarrez le service de passerelle.If the error persists, restart the gateway service.

Impossible de créer le service liéFailed to author linked service

ProblèmeProblem

Cette erreur peut s’afficher lorsque vous essayez d’utiliser le Gestionnaire d’informations d’identification dans le portail pour entrer les informations d’identification d’un nouveau service lié ou pour mettre à jour les informations d’identification d’un service lié existant.You might see this error when you try to use Credential Manager in the portal to input credentials for a new linked service, or update credentials for an existing linked service.

Error: The data store '<Server>/<Database>' cannot be reached. Check connection settings for the data source.

Lorsque vous obtenez cette erreur, la page de paramètres du Gestionnaire de configuration de passerelle de gestion des données peut se présenter comme dans la capture d’écran suivante.When you see this error, the settings page of Data Management Gateway Configuration Manager might look like the following screenshot.

Impossible de contacter la base de données

Cause :Cause

Le certificat SSL a peut-être été perdu sur l’ordinateur de la passerelle.The SSL certificate might have been lost on the gateway machine. L’ordinateur de la passerelle ne peut pas charger le certificat actuellement utilisé pour le chiffrement SSL.The gateway computer cannot load the certificate currently that is used for SSL encryption. Un message d’erreur similaire au message suivant peut également être affiché dans le journal des événements.You might also see an error message in the event log that is similar to the following message.

Unable to get the gateway settings from cloud service. Check the gateway key and the network connection. (Certificate with thumbprint cannot be loaded.)

Résolution :Resolution

Procédez comme suit pour résoudre le problème :Follow these steps to solve the problem:

  1. Lancez le Gestionnaire de configuration de passerelle de gestion des données.Start Data Management Gateway Configuration Manager.

  2. Basculez vers l’onglet Paramètres .Switch to the Settings tab.

  3. Cliquez sur le bouton Modifier pour modifier le certificat SSL.Click the Change button to change the SSL certificate.

    Bouton de modification du certificat

  4. Sélectionnez un nouveau certificat comme certificat SSL.Select a new certificate as the SSL certificate. Vous pouvez utiliser n’importe quel certificat SSL généré par vos soins ou par une organisation quelconque.You can use any SSL certificate that is generated by you or any organization.

    Indiquer un certificat

Échec de l’activité de copieCopy activity fails

ProblèmeProblem

Vous pouvez obtenir l’erreur « UserErrorFailedToConnectToSqlserver » suivante après avoir configuré un pipeline dans le portail.You might notice the following "UserErrorFailedToConnectToSqlserver" failure after you set up a pipeline in the portal.

Error: Copy activity encountered a user error: ErrorCode=UserErrorFailedToConnectToSqlServer,'Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException,Message=Cannot connect to SQL Server

Cause :Cause

Cela peut se produire pour différentes raisons et la procédure de résolution varie en conséquence.This can happen for different reasons, and mitigation varies accordingly.

Résolution :Resolution

Autorisez les connexions TCP sortantes sur le port TCP/1433 côté client de la passerelle de gestion des données avant la connexion à une base de données SQL.Allow outbound TCP connections over port TCP/1433 on the Data Management Gateway client side before connecting to an SQL database.

Si la base de données cible est une base de données Azure SQL, vérifiez également les paramètres de pare-feu SQL Server pour Azure.If the target database is an Azure SQL database, check SQL Server firewall settings for Azure as well.

Consultez la section suivante pour tester la connexion à la banque de données locale.See the following section to test the connection to the on-premises data store.

Si vous obtenez des erreurs liées à la connexion à la banque de données ou au pilote, procédez comme suit :If you see data store connection or driver-related errors, complete the following steps:

  1. Lancez le Gestionnaire de configuration de passerelle de gestion des données sur l’ordinateur de la passerelle.Start Data Management Gateway Configuration Manager on the gateway machine.
  2. Basculez vers l’onglet Diagnostics .Switch to the Diagnostics tab.
  3. Dans Tester la connexion, ajoutez les valeurs de groupe de la passerelle.In Test Connection, add the gateway group values.
  4. Cliquez sur Tester la connexion pour vérifier si vous pouvez vous connecter à la source de données locale à partir de l’ordinateur de la passerelle en utilisant les informations de connexion et d’identification.Click Test to see if you can connect to the on-premises data source from the gateway machine by using the connection information and credentials. Si le test de connexion échoue encore après l'installation d'un pilote, redémarrez la passerelle pour récupérer les dernières modifications.If the test connection still fails after you install a driver, restart the gateway for it to pick up the latest change.

Tester la connexion dans l’onglet Diagnostics

Journaux d’activité de la passerelleGateway logs

Envoyer les journaux d’activité de la passerelle à MicrosoftSend gateway logs to Microsoft

Lorsque vous contactez le Support Microsoft pour résoudre des problèmes de passerelle, il peut vous être demandé de fournir les journaux d’activité de votre passerelle.When you contact Microsoft Support to get help with troubleshooting gateway issues, you might be asked to share your gateway logs. Avec la dernière version de la passerelle, vous pouvez partager les journaux d’activité de passerelle requis en deux clics de bouton dans le Gestionnaire de configuration de passerelle de gestion des données.With the release of the gateway, you can share required gateway logs with two button clicks in Data Management Gateway Configuration Manager.

  1. Basculez vers l’onglet Diagnostics du Gestionnaire de configuration de passerelle de gestion des données.Switch to the Diagnostics tab in Data Management Gateway Configuration Manager.

    Onglet Diagnostics de la passerelle de gestion des données

  2. Cliquez sur Envoyer des journaux d’activité pour afficher la boîte de dialogue suivante.Click Send Logs to see the following dialog box.

    Lien Envoyer des journaux d’activité de la passerelle de gestion des données

  3. (Facultatif) Cliquez sur Afficher les journaux d’activité pour consulter les journaux d’activité dans l’Observateur d’événements.(Optional) Click view logs to review logs in the event viewer.

  4. (Facultatif) Cliquez sur Confidentialité pour consulter la déclaration de confidentialité relative aux services web Microsoft.(Optional) Click privacy to review Microsoft web services privacy statement.

  5. Lorsque vous êtes satisfait des éléments que vous vous apprêtez à charger, cliquez sur Envoyer des journaux d’activité pour envoyer les journaux d’activité des sept derniers jours à Microsoft en vue de résoudre les problèmes.When you are satisfied with what you are about to upload, click Send Logs to actually send the logs from the last seven days to Microsoft for troubleshooting. L’état de l’opération d’envoi des journaux devrait s’afficher comme dans la capture d’image suivante.You should see the status of the send-logs operation as shown in the following screenshot.

    État de l’opération Envoyer des journaux d’activité pour la passerelle de gestion des données

  6. Une fois l’opération terminée, la boîte de dialogue illustrée dans la capture d’écran suivante s’affiche.After the operation is complete, you see a dialog box as shown in the following screenshot.

    État de l’opération Envoyer des journaux d’activité pour la passerelle de gestion des données

  7. Notez l’ID du rapport et communiquez-le au Support Microsoft.Save the Report ID and share it with Microsoft Support. L’ID du rapport permet de localiser les journaux d’activité de la passerelle que vous avez chargés pour la résolution des problèmes.The report ID is used to locate the gateway logs that you uploaded for troubleshooting. L’ID du rapport est également enregistré dans l’Observateur d’événements.The report ID is also saved in the event viewer. Vous pouvez le trouver en recherchant l’ID d’événement « 25 » et en vérifiant la date et l’heure.You can find it by looking at the event ID “25”, and check the date and time.

    ID du rapport de l’opération Envoyer des journaux d’activité pour la passerelle de gestion des données

La passerelle d’archive ouvre une session sur l’ordinateur hôte de la passerelleArchive gateway logs on gateway host machine

Dans certains cas, il se peut que vous ayez des problèmes avec la passerelle et que vous ne puissiez pas partager directement les journaux d’activité de la passerelle :There are some scenarios where you have gateway issues and you cannot share gateway logs directly:

  • Vous installez et inscrivez manuellement la passerelle.You manually install the gateway and register the gateway.
  • Vous essayez d’inscrire la passerelle avec une clé régénérée dans le Gestionnaire de configuration de passerelle de gestion des données.You try to register the gateway with a regenerated key in Data Management Gateway Configuration Manager.
  • Vous tentez d’envoyer des journaux d’activité et le service hôte de la passerelle ne peut pas être connecté.You try to send logs and the gateway host service cannot be connected.

Dans ces cas de figure, vous pouvez enregistrer les journaux d’activité de la passerelle dans un fichier zip et fournir celui-ci au Support Microsoft.For these scenarios, you can save gateway logs as a zip file and share it when you contact Microsoft support. Par exemple, si vous recevez une erreur lorsque vous inscrivez la passerelle, comme illustré dans la capture d’écran suivante.For example, if you receive an error while you register the gateway as shown in the following screenshot.

Erreur d’inscription de la passerelle de gestion des données

Cliquez sur le lien Archiver les journaux d’activité de la passerelle pour archiver et enregistrer les journaux d’activité, puis fournissez le fichier zip au Support Microsoft.Click the Archive gateway logs link to archive and save logs, and then share the zip file with Microsoft support.

Lien Archiver les journaux d’activité de la passerelle de gestion de données

Rechercher dans les journaux d’activité de la passerelleLocate gateway logs

Vous pouvez accéder à des informations détaillées sur les journaux d’activité de la passerelle dans les journaux d’événements Windows.You can find detailed gateway log information in the Windows event logs.

  1. Démarrez l’Observateur d’événements Windows.Start Windows Event Viewer.

  2. Localisez les journaux d’activité dans le dossier Journaux des applications et services > Passerelle de gestion des données.Locate logs in the Application and Services Logs > Data Management Gateway folder.

    Lors de la résolution de problèmes liés à la passerelle, recherchez les événements de niveau Erreur dans l’Observateur d’événements.When you're troubleshooting gateway-related issues, look for error level events in the event viewer.

Journaux d’activité de la passerelle de gestion des données dans l’Observateur d’événements