Passerelle de gestion de donnéesData Management Gateway

Notes

Cet article s’applique à la version 1 de Data Factory.This article applies to version 1 of 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 autohébergé dans Data Factory.If you are using the current version of the Data Factory service, see self-hosted integration runtime in.

Notes

La passerelle de gestion des données a été renommée runtime d’intégration autohébergé.Data Management Gateway has now been rebranded as Self-hosted Integration Runtime.

La passerelle de gestion des données est un agent client que vous devez installer dans votre environnement local pour permettre la copie des données entre les magasins de données cloud et locaux.The Data management gateway is a client agent that you must install in your on-premises environment to copy data between cloud and on-premises data stores. Les magasins de données locaux pris en charge par Data Factory sont répertoriés dans la section Sources de données prises en charge .The on-premises data stores supported by Data Factory are listed in the Supported data sources section.

Cet article vient compléter la procédure pas à pas de l’article Déplacement de données entre des sources locales et le cloud à l’aide de la passerelle de gestion des données .This article complements the walkthrough in the Move data between on-premises and cloud data stores article. Dans cette procédure pas à pas, vous créez un pipeline qui utilise la passerelle qui déplace les données d’une base de données SQL Server locale vers un objet blob Azure.In the walkthrough, you create a pipeline that uses the gateway to move data from an on-premises SQL Server database to an Azure blob. Cet article fournit des informations détaillées sur la passerelle de gestion des données.This article provides detailed in-depth information about the data management gateway.

Vous pouvez augmenter le nombre des instances d’une passerelle de gestion des données en associant plusieurs machines locales avec la passerelle.You can scale out a data management gateway by associating multiple on-premises machines with the gateway. Vous pouvez monter en puissance une passerelle en augmentant le nombre de travaux de déplacement des données qui peuvent s’exécuter simultanément sur un nœud.You can scale up by increasing number of data movement jobs that can run concurrently on a node. Cette fonctionnalité est également disponible pour une passerelle logique à nœud unique.This feature is also available for a logical gateway with a single node. Consultez l’article Mise à l’échelle de la passerelle de gestion des données dans Azure Data Factory pour plus d’informations.See Scaling data management gateway in Azure Data Factory article for details.

Notes

Actuellement, la passerelle prend en charge uniquement l’activité de copie et l’activité de procédure stockée dans Data Factory.Currently, gateway supports only the copy activity and stored procedure activity in Data Factory. Il n’est pas possible d’utiliser la passerelle à partir d’une activité personnalisée pour accéder à des sources de données locales.It is not possible to use the gateway from a custom activity to access on-premises data sources.

Notes

Cet article a été mis à jour pour tenir compte de l’utilisation du nouveau module Az d’Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Vous pouvez toujours utiliser le module AzureRM, qui continue à recevoir des correctifs de bogues jusqu’à au moins décembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Pour en savoir plus sur le nouveau module Az et la compatibilité avec AzureRM, consultez Présentation du nouveau module Az d’Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pour des instructions d’installation du module Az, consultez Installer Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Vue d'ensembleOverview

Fonctionnalités de la passerelle de gestion des donnéesCapabilities of data management gateway

La passerelle de gestion des données offre les fonctionnalités suivantes :Data management gateway provides the following capabilities:

  • Modélisation des sources de données locales et des sources de données sur le cloud au sein de la même fabrique de données, et déplacement des données.Model on-premises data sources and cloud data sources within the same data factory and move data.
  • Un point unique de surveillance et de gestion avec une visibilité de l’état de la passerelle à partir de la page Data Factory.Have a single pane of glass for monitoring and management with visibility into gateway status from the Data Factory page.
  • Gestion sécurisée de l’accès aux sources de données locales.Manage access to on-premises data sources securely.
    • Aucune modification du pare-feu d’entreprise n’est requise.No changes required to corporate firewall. La passerelle établit uniquement des connexions HTTP sortantes pour l’accès à Internet.Gateway only makes outbound HTTP-based connections to open internet.
    • Chiffrement des informations d’identification pour vos magasins de données locaux à l’aide de votre certificat.Encrypt credentials for your on-premises data stores with your certificate.
  • Déplacer les données efficacement : les données sont transférées en parallèle et résistent aux problèmes intermittents du réseau, grâce à la logique de nouvelle tentative automatique.Move data efficiently - data is transferred in parallel, resilient to intermittent network issues with auto retry logic.

Flux de commandes et flux de donnéesCommand flow and data flow

Lorsque vous utilisez une activité de copie pour copier des données entre des machines locales et cloud, l’activité utilise une passerelle pour transférer les données à partir de la source de données locale vers le cloud et vice versa.When you use a copy activity to copy data between on-premises and cloud, the activity uses a gateway to transfer data from on-premises data source to cloud and vice versa.

Voici le flux de données global et un résumé des étapes pour la copie à l’aide de la passerelle de données : Flux de données à l’aide de la passerelleHere is the high-level data flow for and summary of steps for copy with data gateway: Data flow using gateway

  1. Le développeur des données crée une passerelle pour une fabrique de données Azure à l’aide du portail Azureou d’une applet de commande PowerShell.Data developer creates a gateway for an Azure Data Factory using either the Azure portal or PowerShell Cmdlet.
  2. Le développeur de données crée un service lié pour un magasin de données local en spécifiant la passerelle.Data developer creates a linked service for an on-premises data store by specifying the gateway. Dans le cadre de la configuration du service lié, le développeur des données utilise l’application de configuration des informations d’identification pour spécifier les types d’authentification et les informations d’identification.As part of setting up the linked service, data developer uses the Setting Credentials application to specify authentication types and credentials. La boîte de dialogue de l’application de configuration des informations d’identification communique avec le magasin de données pour tester la connexion et la passerelle afin d’enregistrer les informations d’identification.The Setting Credentials application dialog communicates with the data store to test connection and the gateway to save credentials.
  3. La passerelle chiffre les informations d’identification avec le certificat associé à la passerelle (fourni par le développeur des données) avant d’enregistrer les informations d’identification dans le cloud.Gateway encrypts the credentials with the certificate associated with the gateway (supplied by data developer), before saving the credentials in the cloud.
  4. Le service Data Factory communique avec la passerelle pour la planification et la gestion des tâches via un canal de contrôle qui utilise une file d’attente Azure Service Bus partagée.Data Factory service communicates with the gateway for scheduling & management of jobs via a control channel that uses a shared Azure service bus queue. Lorsqu’une tâche de l’activité de copie doit être lancée, Data Factory place en file d’attente la requête ainsi que les informations d’identification.When a copy activity job needs to be kicked off, Data Factory queues the request along with credential information. La passerelle lance la tâche après avoir interrogé la file d'attente.Gateway kicks off the job after polling the queue.
  5. La passerelle déchiffre les informations d’identification avec le même certificat puis se connecte au magasin de données local avec le type d’authentification et les informations d’identification appropriés.The gateway decrypts the credentials with the same certificate and then connects to the on-premises data store with proper authentication type and credentials.
  6. La passerelle copie les données d’un magasin local vers un stockage cloud, ou vice versa selon la configuration de l'activité de copie dans le pipeline de données.The gateway copies data from an on-premises store to a cloud storage, or vice versa depending on how the Copy Activity is configured in the data pipeline. Pour cette étape, la passerelle communique directement avec le service de stockage basé sur le cloud comme le stockage d'objets blob Azure via un canal sécurisé (HTTPS).For this step, the gateway directly communicates with cloud-based storage services such as Azure Blob Storage over a secure (HTTPS) channel.

Considérations relatives à l’utilisation de la passerelleConsiderations for using gateway

  • Une seule instance de passerelle de gestion des données peut être utilisée pour plusieurs sources de données locales.A single instance of data management gateway can be used for multiple on-premises data sources. Toutefois, une seule instance de passerelle est liée à une instance d’Azure Data Factory et ne peut pas être partagée avec une autre instance d’Azure Data Factory.However, a single gateway instance is tied to only one Azure data factory and cannot be shared with another data factory.
  • Vous ne pouvez installer qu’une seule instance de la passerelle de gestion de données sur un même ordinateur.You can have only one instance of data management gateway installed on a single machine. Si deux fabriques de données doivent accéder aux sources de données locales, vous devez installer des passerelles sur deux ordinateurs locaux.Suppose, you have two data factories that need to access on-premises data sources, you need to install gateways on two on-premises computers. En d’autres termes, une passerelle est liée à une instance d’Azure Data Factory spécifiqueIn other words, a gateway is tied to a specific data factory
  • La passerelle n’a pas besoin d’être sur la même machine que la source de données.The gateway does not need to be on the same machine as the data source. Toutefois, avoir une passerelle plus proche de la source de données réduit le temps de connexion de la passerelle à la source de données.However, having gateway closer to the data source reduces the time for the gateway to connect to the data source. Nous vous recommandons d’installer la passerelle sur un ordinateur différent de celui qui héberge la source de données locale.We recommend that you install the gateway on a machine that is different from the one that hosts on-premises data source. Lorsque la source de données et la passerelle se trouvent sur des machines différentes, la passerelle ne demande pas de ressources de la source de données.When the gateway and data source are on different machines, the gateway does not compete for resources with data source.
  • Vous pouvez avoir plusieurs passerelles sur différents ordinateurs connectés à la même source de données locale.You can have multiple gateways on different machines connecting to the same on-premises data source. Par exemple, vous pouvez avoir deux passerelles desservant deux fabriques de données, alors que la même source de données locale est enregistrée auprès des deux fabriques de données.For example, you may have two gateways serving two data factories but the same on-premises data source is registered with both the data factories.
  • Si une passerelle est déjà installée sur votre ordinateur desservant un scénario Power BI, installez une passerelle distincte pour Azure Data Factory sur un autre ordinateur.If you already have a gateway installed on your computer serving a Power BI scenario, install a separate gateway for Azure Data Factory on another machine.
  • Vous devez utiliser la passerelle même lorsque vous utilisez ExpressRoute.Gateway must be used even when you use ExpressRoute.
  • Considérez votre source de données comme une source de données locale (derrière un pare-feu), même lorsque vous utilisez ExpressRoute.Treat your data source as an on-premises data source (that is behind a firewall) even when you use ExpressRoute. Utilisez la passerelle pour établir la connectivité entre le service et la source de données.Use the gateway to establish connectivity between the service and the data source.
  • Vous devez utiliser la passerelle même si la banque de données se trouve dans le cloud sur une machine virtuelle IaaS Azure.You must use the gateway even if the data store is in the cloud on an Azure IaaS VM.

InstallationInstallation

PrérequisPrerequisites

  • Les versions de système d’exploitation prises en charge sont Windows 7, Windows 8/8.1, Windows 10, Windows Server 2008 R2, Windows Server 2012 et Windows Server 2012 R2.The supported Operating System versions are Windows 7, Windows 8/8.1, Windows 10, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2. L’installation de la passerelle de gestion des données sur un contrôleur de domaine n’est pas prise en charge.Installation of the data management gateway on a domain controller is currently not supported.
  • .NET framework 4.5.1 ou version ultérieure est requis..NET Framework 4.5.1 or above is required. Si vous installez la passerelle sur un ordinateur Windows 7, installez .NET Framework 4.5 ou une version ultérieure.If you are installing gateway on a Windows 7 machine, install .NET Framework 4.5 or later. Consultez Configuration système requise pour .NET Framework pour plus d’informations.See .NET Framework System Requirements for details.
  • La configuration recommandée pour l’ordinateur de passerelle est la suivante : au moins 2 GHz, 4 cœurs, 8 Go de RAM et 80 Go d’espace disque.The recommended configuration for the gateway machine is at least 2 GHz, 4 cores, 8-GB RAM, and 80-GB disk.
  • Si l’ordinateur hôte est en veille prolongée, la passerelle ne répond pas à la demande de données.If the host machine hibernates, the gateway does not respond to data requests. Vous devez donc configurer un plan de gestion de l’alimentation approprié sur l’ordinateur avant d’installer la passerelle.Therefore, configure an appropriate power plan on the computer before installing the gateway. L’installation de la passerelle ouvre un message si l’ordinateur est configuré pour la mise en veille prolongée.If the machine is configured to hibernate, the gateway installation prompts a message.
  • Vous devez être administrateur sur la machine pour installer et configurer la passerelle de gestion des données avec succès.You must be an administrator on the machine to install and configure the data management gateway successfully. Vous pouvez ajouter des utilisateurs supplémentaires au groupe Windows local Utilisateurs de la passerelle de gestion des données.You can add additional users to the data management gateway Users local Windows group. Les membres de ce groupe sont en mesure d’utiliser l’outil Gestionnaire de configuration de passerelle de gestion des données pour configurer la passerelle.The members of this group are able to use the Data Management Gateway Configuration Manager tool to configure the gateway.

Étant donné que l’activité de copie s’exécute selon une fréquence spécifique, l’utilisation des ressources (processeur, mémoire) sur l’ordinateur suit également le même modèle avec des pics et des baisses d’inactivité.As copy activity runs happen on a specific frequency, the resource usage (CPU, memory) on the machine also follows the same pattern with peak and idle times. L'utilisation des ressources dépend également en grande partie de la quantité de données déplacées.Resource utilization also depends heavily on the amount of data being moved. Lorsque plusieurs travaux sont en cours, vous constaterez une augmentation des ressources utilisées pendant les heures de pointe.When multiple copy jobs are in progress, you see resource usage go up during peak times.

Options d’installationInstallation options

La passerelle de gestion des données peut être installée comme suit :Data management gateway can be installed in the following ways:

  • En téléchargeant un package d’installation MSI à partir du Centre de téléchargement Microsoft.By downloading an MSI setup package from the Microsoft Download Center. Le fichier MSI peut également servir à mettre à niveau la passerelle de gestion des données existante vers la version la plus récente, en conservant tous les paramètres.The MSI can also be used to upgrade existing data management gateway to the latest version, with all settings preserved.
  • En cliquant sur le lien Télécharger et installer la passerelle de données sous INSTALLATION MANUELLE ou Installer directement sur cet ordinateur sous INSTALLATION RAPIDE.By clicking Download and install data gateway link under MANUAL SETUP or Install directly on this computer under EXPRESS SETUP. Pour des instructions pas à pas sur l’utilisation de l’installation rapide, consultez l’article Déplacement de données entre des sources locales et le cloud à l’aide de la passerelle de gestion des données .See Move data between on-premises and cloud article for step-by-step instructions on using express setup. L’étape manuelle vous amène au centre de téléchargement.The manual step takes you to the download center. Les instructions pour télécharger et installer la passerelle à partir du centre de téléchargement se trouvent dans la section suivante.The instructions for downloading and installing the gateway from download center are in the next section.

Meilleures pratiques d’installation :Installation best practices:

  1. Définissez un plan d'alimentation sur l'ordinateur hôte de la passerelle afin d’empêcher la mise en veille prolongée.Configure power plan on the host machine for the gateway so that the machine does not hibernate. Si l’ordinateur hôte est en veille prolongée, la passerelle ne répond pas à la demande de données.If the host machine hibernates, the gateway does not respond to data requests.
  2. Sauvegardez le certificat associé à la passerelle.Back up the certificate associated with the gateway.

Installer la passerelle à partir du Centre de téléchargementInstall the gateway from download center

  1. Accédez à la page de téléchargement de la passerelle de gestion des données Microsoft.Navigate to Microsoft Data Management Gateway download page.
  2. Cliquez sur Télécharger, sélectionnez la version 64 bits (la version 32 bits n’est plus prise en charge), puis cliquez sur Suivant.Click Download, select the 64-bit version (32-bit is no more supported), and click Next.
  3. Exécutez le MSI directement ou enregistrez-le sur votre disque dur avant de l’exécuter.Run the MSI directly or save it to your hard disk and run.
  4. Dans la page Bienvenue, sélectionnez une langue et cliquez sur Suivant.On the Welcome page, select a language click Next.
  5. Acceptez le Contrat de Licence Utilisateur Final et cliquez sur Suivant.Accept the End-User License Agreement and click Next.
  6. Sélectionnez le dossier d’installation de la passerelle, puis cliquez sur Suivant.Select folder to install the gateway and click Next.
  7. Dans la page Prêt pour l’installation, cliquez sur Installer.On the Ready to install page, click Install.
  8. Cliquez sur Terminer pour terminer l’installation.Click Finish to complete installation.
  9. Obtenez la clé à partir du portail Azure.Get the key from the Azure portal. Pour des instructions pas à pas, consultez la section suivante.See the next section for step-by-step instructions.
  10. Sur la page Enregistrer la passerelle du Gestionnaire de configuration de passerelle de gestion de données en cours d’exécution sur votre machine, procédez comme suit :On the Register gateway page of Data Management Gateway Configuration Manager running on your machine, do the following steps:
    1. Collez la clé dans le texte.Paste the key in the text.
    2. Éventuellement, cliquez sur Afficher la clé de passerelle pour afficher le texte de la clé.Optionally, click Show gateway key to see the key text.
    3. Cliquez sur S'inscrire.Click Register.

Inscrire la passerelle à l’aide de la cléRegister gateway using key

Si vous n’avez pas déjà créé une passerelle logique dans le portailIf you haven't already created a logical gateway in the portal

Pour créer une passerelle dans le portail et obtenir la clé à partir de la page Configurer, suivez les étapes de la procédure pas à pas de l’article Déplacement de données entre des sources locales et le cloud.To create a gateway in the portal and get the key from the Configure page, Follow steps from walkthrough in the Move data between on-premises and cloud article.

Si vous avez déjà créé la passerelle logique dans le portailIf you have already created the logical gateway in the portal

  1. Dans le portail Azure, accédez à la page Data Factory, puis cliquez sur la vignette Services liés.In Azure portal, navigate to the Data Factory page, and click Linked Services tile.

    Page Data Factory

  2. Dans la page Services liés, sélectionnez la passerelle logique que vous avez créée dans le portail.In the Linked Services page, select the logical gateway you created in the portal.

    passerelle logique

  3. Dans la page Passerelle de données, cliquez sur Télécharger et installer la passerelle de données.In the Data Gateway page, click Download and install data gateway.

    Lien de téléchargement dans le portail

  4. Dans la page Configurer, cliquez sur Recréer une clé.In the Configure page, click Recreate key. Dans le message d’avertissement, cliquez sur Oui après l’avoir lu attentivement.Click Yes on the warning message after reading it carefully.

    Recréer une clé

  5. Cliquez sur le bouton Copier en regard de la clé.Click Copy button next to the key. La clé est copiée dans le Presse-papiers.The key is copied to the clipboard.

    Copier la clé

Icônes de la barre d’état système/notificationsSystem tray icons/ notifications

L’illustration suivante représente certaines des icônes de barre d’état qui s’affichent.The following image shows some of the tray icons that you see.

Icônes de la barre d’état système

Si vous déplacez le curseur sur les icônes/messages de notification de la barre d’état système, vous afficherez des informations supplémentaires sur l’état d’opération de la passerelle/la progression de la mise à jour dans une fenêtre contextuelle.If you move cursor over the system tray icon/notification message, you see details about the state of the gateway/update operation in a popup window.

Ports et pare-feuPorts and firewall

Vous devez porter votre attention sur deux pare-feu : le pare-feu d’entreprise, exécuté sur le routeur central de l’organisation et le Pare-feu Windows, configuré en tant que démon sur l’ordinateur local sur lequel la passerelle est installée.There are two firewalls you need to consider: corporate firewall running on the central router of the organization, and Windows firewall configured as a daemon on the local machine where the gateway is installed.

Pare-feu

Au niveau du pare-feu d’entreprise, vous devez configurer les domaines et ports de sortie suivants :At corporate firewall level, you need configure the following domains and outbound ports:

Noms de domaineDomain names PortsPorts DescriptionDescription
*.servicebus.windows.net*.servicebus.windows.net 443443 Utilisé pour la communication avec le serveur principal du service Déplacement des donnéesUsed for communication with Data Movement Service backend
*.core.windows.net*.core.windows.net 443443 Utilisé pour une copie intermédiaire à l’aide d’objets Blob Azure (si configuré)Used for Staged copy using Azure Blob (if configured)
*.frontend.clouddatahub.net*.frontend.clouddatahub.net 443443 Utilisé pour la communication avec le serveur principal du service Déplacement des donnéesUsed for communication with Data Movement Service backend
*.servicebus.windows.net*.servicebus.windows.net 9350-9354, 56719350-9354, 5671 Service Bus Relay facultatif sur TCP utilisé par l’Assistant de copieOptional service bus relay over TCP used by the Copy Wizard

Au niveau du pare-feu Windows, ces ports de sortie sont normalement activés.At Windows firewall level, these outbound ports are normally enabled. Sinon, vous pouvez configurer en conséquence les domaines et les ports sur l’ordinateur de passerelle.If not, you can configure the domains and ports accordingly on gateway machine.

Notes

  1. Selon votre source/vos récepteurs, vous devrez peut-être ajouter des domaines et des ports de sortie supplémentaires à la liste verte de votre pare-feu d’entreprise/Windows.Based on your source/ sinks, you may have to whitelist additional domains and outbound ports in your corporate/Windows firewall.
  2. Pour certaines bases de données cloud (par exemple : Azure SQL Database, Azure Data Lake, etc.), vous aurez besoin d’ajouter sur liste verte l’adresse IP de la machine passerelle dans la configuration de pare-feu.For some Cloud Databases (For example: Azure SQL Database, Azure Data Lake, etc.), you may need to whitelist IP address of Gateway machine on their firewall configuration.

Copier des données d’une banque de données source vers une banque de données de récepteurCopy data from a source data store to a sink data store

Assurez-vous que les règles de pare-feu sont correctement activées sur le pare-feu d’entreprise, sur le pare-feu Windows de l’ordinateur de passerelle, ainsi que sur le magasin de données lui-même.Ensure that the firewall rules are enabled properly on the corporate firewall, Windows firewall on the gateway machine, and the data store itself. Activer ces règles permet à la passerelle de se connecter correctement à la source et au récepteur.Enabling these rules allows the gateway to connect to both source and sink successfully. Activez les règles pour chaque magasin de données impliqué dans l’opération de copie.Enable rules for each data store that is involved in the copy operation.

Par exemple, pour copier à partir d’une banque de données locale vers un récepteur Azure SQL Database ou un récepteur Azure SQL Data Warehouse, effectuez les opérations suivantes :For example, to copy from an on-premises data store to an Azure SQL Database sink or an Azure SQL Data Warehouse sink, do the following steps:

  • Autorisez le trafic TCP sortant sur le port 1433 pour le pare-feu Windows et le pare-feu d’entreprise.Allow outbound TCP communication on port 1433 for both Windows firewall and corporate firewall.
  • Configurez les paramètres de pare-feu du serveur SQL Azure pour ajouter l’adresse IP de l’ordinateur de passerelle à la liste d’adresses IP autorisées.Configure the firewall settings of Azure SQL server to add the IP address of the gateway machine to the list of allowed IP addresses.

Notes

Si votre pare-feu n’autorise pas le port de sortie 1433, la passerelle ne peut pas accéder directement à Azure SQL.If your firewall does not allow outbound port 1433, Gateway can't access Azure SQL directly. Dans ce cas, vous pouvez utiliser la copie intermédiaire sur SQL Azure Database/SQL Azure DW.In this case, you may use Staged Copy to SQL Azure Database/ SQL Azure DW. Dans ce scénario, vous auriez uniquement besoin du protocole HTTPS (port 443) pour le déplacement des données.In this scenario, you would only require HTTPS (port 443) for the data movement.

Considérations relatives aux serveurs proxyProxy server considerations

Si votre environnement de réseau d’entreprise utilise un serveur proxy pour accéder à Internet, configurez la passerelle de gestion des données pour utiliser les bons paramètres de proxy.If your corporate network environment uses a proxy server to access the internet, configure data management gateway to use appropriate proxy settings. Vous pouvez définir le proxy lors de la phase initiale de l’enregistrement.You can set the proxy during the initial registration phase.

Définir le serveur proxy lors de l’inscription

La passerelle utilise le serveur proxy pour se connecter au service cloud.Gateway uses the proxy server to connect to the cloud service. Cliquez sur le lien Modifier pendant l’installation initiale.Click Change link during initial setup. La boîte de dialogue Paramètre proxy s’affiche.You see the proxy setting dialog.

Définir le proxy avec le gestionnaire de configuration

Il existe trois options de configuration :There are three configuration options:

  • Ne pas utiliser de proxy : la passerelle n’utilise pas explicitement de proxy pour se connecter aux services cloud.Do not use proxy: Gateway does not explicitly use any proxy to connect to cloud services.
  • Utiliser le proxy système : la passerelle utilise le paramètre de proxy configuré dans diahost.exe.config et diawp.exe.config. Si aucun proxy n’est configuré dans diahost.exe.config et diawp.exe.config, la passerelle se connecte au service cloud directement sans passer par le proxy.Use system proxy: Gateway uses the proxy setting that is configured in diahost.exe.config and diawp.exe.config. If no proxy is configured in diahost.exe.config and diawp.exe.config, gateway connects to cloud service directly without going through proxy.
  • Utiliser un proxy personnalisé : configurez les paramètres du proxy HTTP à utiliser pour la passerelle, au lieu d’utiliser les configurations dans diahost.exe.config et diawp.exe.config. L’adresse et le port sont requis.Use custom proxy: Configure the HTTP proxy setting to use for gateway, instead of using configurations in diahost.exe.config and diawp.exe.config. Address and Port are required. Le nom d’utilisateur et le mot de passe sont facultatifs, en fonction du paramètre d’authentification de votre proxy.User Name and Password are optional depending on your proxy's authentication setting. Tous les paramètres sont chiffrés avec le certificat d’informations d’identification de la passerelle et stockés localement sur la machine hôte de passerelle.All settings are encrypted with the credential certificate of the gateway and stored locally on the gateway host machine.

Le service hôte de la passerelle de gestion des données redémarre automatiquement après avoir enregistré les paramètres de proxy mis à jour.The data management gateway Host Service restarts automatically after you save the updated proxy settings.

Une fois la passerelle enregistrée avec succès, si vous souhaitez afficher ou mettre à jour les paramètres de proxy, utilisez le gestionnaire de configuration de la passerelle de gestion des données.After gateway has been successfully registered, if you want to view or update proxy settings, use Data Management Gateway Configuration Manager.

  1. Lancez le Gestionnaire de configuration de la passerelle de gestion des données.Launch Data Management Gateway Configuration Manager.
  2. Basculez vers l’onglet Paramètres .Switch to the Settings tab.
  3. Cliquez sur le lien Modifier dans la section Serveur proxy HTTP pour lancer la boîte de dialogue Définir le proxy HTTP.Click Change link in HTTP Proxy section to launch the Set HTTP Proxy dialog.
  4. Après avoir cliqué sur le bouton Suivant , vous verrez une boîte de dialogue d’avertissement demandant l’autorisation d’enregistrer les paramètres de proxy et de redémarrer le service hôte de la passerelle.After you click the Next button, you see a warning dialog asking for your permission to save the proxy setting and restart the Gateway Host Service.

Vous pouvez afficher et mettre à jour le proxy HTTP à l’aide de l’outil Gestionnaire de Configuration.You can view and update HTTP proxy by using Configuration Manager tool.

Définir le proxy avec le gestionnaire de configuration

Notes

Si vous configurez un serveur proxy avec l’authentification NTLM, le service hôte de la passerelle s’exécute sous le compte du domaine.If you set up a proxy server with NTLM authentication, Gateway Host Service runs under the domain account. Si vous modifiez le mot de passe du compte du domaine ultérieurement, veillez à mettre à jour les paramètres de configuration pour le service et à redémarrer ce dernier en conséquence.If you change the password for the domain account later, remember to update configuration settings for the service and restart it accordingly. En raison de cette exigence, nous vous conseillons d’utiliser un compte de domaine dédié qui ne nécessite pas de mettre à jour le mot de passe fréquemment pour accéder au serveur proxy.Due to this requirement, we suggest you use a dedicated domain account to access the proxy server that does not require you to update the password frequently.

Configurer les paramètres du serveur proxyConfigure proxy server settings

Si vous sélectionnez le paramètre Utiliser le proxy système pour le proxy HTTP, la passerelle utilise le paramètre du proxy dans diahost.exe.config et diawp.exe.config. Si aucun proxy n’est spécifié dans diahost.exe.config et diawp.exe.config, la passerelle se connecte au service cloud directement sans passer par le proxy.If you select Use system proxy setting for the HTTP proxy, gateway uses the proxy setting in diahost.exe.config and diawp.exe.config. If no proxy is specified in diahost.exe.config and diawp.exe.config, gateway connects to cloud service directly without going through proxy. La procédure suivante fournit des instructions pour mettre à jour le fichier de configuration diahost.exe.config.The following procedure provides instructions for updating the diahost.exe.config file.

  1. Dans l’Explorateur de fichiers, effectuez une copie de sauvegarde de C:\\Program Files\Microsoft Data Management Gateway\2.0\Shared\diahost.exe.config pour sauvegarder le fichier d’origine.In File Explorer, make a safe copy of C:\\Program Files\Microsoft Data Management Gateway\2.0\Shared\diahost.exe.config to back up the original file.

  2. Lancez Notepad.exe en tant qu’administrateur, puis ouvrez le fichier texte C:\\Program Files\Microsoft Data Management Gateway\2.0\Shared\diahost.exe.config. La balise par défaut pour system.net apparaît dans le code suivant :Launch Notepad.exe running as administrator, and open text file C:\\Program Files\Microsoft Data Management Gateway\2.0\Shared\diahost.exe.config. You find the default tag for system.net as shown in the following code:

    <system.net>
        <defaultProxy useDefaultCredentials="true" />
    </system.net>
    

    Vous pouvez ensuite ajouter les détails du serveur proxy comme illustré dans l’exemple suivant :You can then add proxy server details as shown in the following example:

    <system.net>
        <defaultProxy enabled="true">
            <proxy bypassonlocal="true" proxyaddress="http://proxy.domain.org:8888/" />
        </defaultProxy>
    </system.net>
    

    Vous pouvez ajouter des propriétés supplémentaires à l’intérieur de la balise de proxy pour spécifier les paramètres requis comme scriptLocation.Additional properties are allowed inside the proxy tag to specify the required settings like scriptLocation. Reportez-vous à la page de syntaxe <proxy>, élément (paramètres réseau) .Refer to proxy Element (Network Settings) on syntax.

    <proxy autoDetect="true|false|unspecified" bypassonlocal="true|false|unspecified" proxyaddress="uriString" scriptLocation="uriString" usesystemdefault="true|false|unspecified "/>
    
  3. Enregistrez le fichier de configuration à l’emplacement d’origine, puis redémarrez le service hôte de passerelle de gestion des données, qui relève les modifications.Save the configuration file into the original location, then restart the Data Management Gateway Host service, which picks up the changes. Pour redémarrer le service, utilisez l’applet de services du panneau de configuration, ou allez dans le Gestionnaire de configuration de passerelle de gestion des données, cliquez sur le bouton Arrêter le service, puis sur Démarrer le service.To restart the service: use services applet from the control panel, or from the Data Management Gateway Configuration Manager > click the Stop Service button, then click the Start Service. Si le service ne démarre pas, il est probable qu’une syntaxe de balise XML incorrecte ait été ajoutée dans le fichier de configuration d’application que vous avez modifié.If the service does not start, it is likely that an incorrect XML tag syntax has been added into the application configuration file that was edited.

Important

N’oubliez pas de mettre à jour diahost.exe.config et diawp.exe.config.Do not forget to update both diahost.exe.config and diawp.exe.config.

Outre ces points, vous devez également vérifier que Microsoft Azure figure dans la liste verte de votre entreprise.In addition to these points, you also need to make sure Microsoft Azure is in your company's whitelist. Vous pouvez télécharger la liste des adresses IP Microsoft Azure valides à partir du Centre de téléchargement Microsoft.The list of valid Microsoft Azure IP addresses can be downloaded from the Microsoft Download Center.

Si vous rencontrez l’une des erreurs suivantes, cela signifie que vous avez probablement mal configuré le serveur proxy ou le pare-feu, et que la passerelle ne peut pas se connecter à Data Factory pour s’authentifier.If you encounter errors similar to the following ones, it is likely due to improper configuration of the firewall or proxy server, which blocks gateway from connecting to Data Factory to authenticate itself. Reportez-vous à la section précédente pour vous assurer que votre pare-feu et votre serveur proxy sont correctement configurés.Refer to previous section to ensure your firewall and proxy server are properly configured.

  1. Quand vous tentez d’inscrire la passerelle, vous recevez le message d’erreur suivant : « Nous n’avons pas pu enregistrer la clé de passerelle.When you try to register the gateway, you receive the following error: "Failed to register the gateway key. Avant de réessayer d’enregistrer la clé de passerelle, vérifiez que la passerelle de gestion des données est connectée et que le service d’hébergement de la passerelle de gestion des données est en cours d’exécution. »Before trying to register the gateway key again, confirm that the data management gateway is in a connected state and the Data Management Gateway Host Service is Started."
  2. Quand vous ouvrez le Gestionnaire de configuration, l’état indiqué est « Déconnecté » ou « En cours de connexion ».When you open Configuration Manager, you see status as "Disconnected" or "Connecting." Quand vous affichez les journaux des événements Windows, sous « Observateur d’événements » > « Journaux des applications et services » > « Passerelle de gestion des données », des messages d’erreur tels que le suivant s’affichent : Unable to connect to the remote server A component of Data Management Gateway has become unresponsive and restarts automatically. Component name: Gateway.When viewing Windows event logs, under "Event Viewer" > "Application and Services Logs" > "Data Management Gateway", you see error messages such as the following error: Unable to connect to the remote server A component of Data Management Gateway has become unresponsive and restarts automatically. Component name: Gateway.

Ouvrir le port 8050 pour le chiffrement des informations d’identificationOpen port 8050 for credential encryption

Le port de trafic entrant 8050 est utilisé par l’application Définition des informations d’identification pour relayer les informations d’identification à la passerelle lorsque vous configurez un service lié local dans le portail Azure.The Setting Credentials application uses the inbound port 8050 to relay credentials to the gateway when you set up an on-premises linked service in the Azure portal. Lors de l’installation de la passerelle, l’installation de la passerelle ouvre cette dernière par défaut sur l’ordinateur de passerelle.During gateway setup, by default, the gateway installation opens it on the gateway machine.

Si vous utilisez un pare-feu tiers, vous pouvez ouvrir manuellement le port 8050.If you are using a third-party firewall, you can manually open the port 8050. Si vous rencontrez des problèmes de pare-feu lors de l’installation de la passerelle, vous pouvez essayer d’utiliser la commande suivante pour installer la passerelle sans configurer le pare-feu.If you run into firewall issue during gateway setup, you can try using the following command to install the gateway without configuring the firewall.

msiexec /q /i DataManagementGateway.msi NOFIREWALL=1

Si vous préférez ne pas ouvrir le port 8050 sur l’ordinateur passerelle, utilisez d’autres mécanismes que l’application Définition des informations d’identification pour configurer les informations d’identification de la banque de données.If you choose not to open the port 8050 on the gateway machine, use mechanisms other than using the Setting Credentials application to configure data store credentials. Vous pouvez par exemple utiliser la cmdlet PowerShell New-AzDataFactoryEncryptValue.For example, you could use New-AzDataFactoryEncryptValue PowerShell cmdlet. Consultez la section Configuration des informations d’identification et de la sécurité pour savoir comment configurer les informations d’identification de la banque de données.See Setting Credentials and Security section on how data store credentials can be set.

Mettre à jourUpdate

Par défaut, la passerelle de gestion des données est automatiquement mise à jour lorsqu’une version plus récente est disponible.By default, data management gateway is automatically updated when a newer version of the gateway is available. La passerelle n’est pas mise à jour tant que toutes les tâches planifiées ne sont pas terminées.The gateway is not updated until all the scheduled tasks are done. Aucune autre tâche n’est traitée par la passerelle avant la fin de l’opération de mise à jour.No further tasks are processed by the gateway until the update operation is completed. Si la mise à jour échoue, la passerelle est restaurée vers son ancienne version.If the update fails, gateway is rolled back to the old version.

L’heure de mise à jour planifiée s’affiche aux emplacements suivants :You see the scheduled update time in the following places:

  • Page Propriétés de la passerelle dans le portail Azure.The gateway properties page in the Azure portal.
  • Page d’accueil du gestionnaire de configuration de la passerelle de gestion des donnéesHome page of the Data Management Gateway Configuration Manager
  • Message de notification de la barre d’état du système.System tray notification message.

L’onglet Accueil du Gestionnaire de configuration de passerelle de gestion des données affiche la planification de la mise à jour, ainsi que la date de la dernière mise à jour/installation de la passerelle.The Home tab of the Data Management Gateway Configuration Manager displays the update schedule and the last time the gateway was installed/updated.

Planifier les mises à jour

Vous pouvez installer la mise à jour immédiatement ou attendre que la passerelle soit mise à jour automatiquement à l’heure planifiée.You can install the update right away or wait for the gateway to be automatically updated at the scheduled time. Par exemple, l’image suivante montre le message de notification affiché dans le Gestionnaire de configuration de passerelle, ainsi que le bouton de mise à jour qui vous permet d’installer cette dernière immédiatement.For example, the following image shows you the notification message shown in the Gateway Configuration Manager along with the Update button that you can click to install it immediately.

Mise à jour dans DMG Configuration Manager

Le message de notification dans la barre d’état système se présenterait comme l’image suivante :The notification message in the system tray would look as shown in the following image:

Message de barre d’état système

Vous voyez s’afficher la progression de l’opération de mise à jour (manuelle ou automatique) dans la barre d’état système.You see the status of update operation (manual or automatic) in the system tray. À la prochaine ouverture du Gestionnaire de configuration de passerelle, un message s’affiche dans la barre de notification, vous indiquant que la passerelle a été mise à jour, et contenant un lien vers la rubrique relative aux nouveautés.When you launch Gateway Configuration Manager next time, you see a message on the notification bar that the gateway has been updated along with a link to what's new topic.

Pour activer/désactiver une fonctionnalité de mise à jour automatiqueTo disable/enable auto-update feature

Vous pouvez désactiver/activer la fonctionnalité de mise à jour automatique comme suit :You can disable/enable the auto-update feature by doing the following steps:

[Pour une passerelle à nœud unique][For single node gateway]

  1. Lancez Windows PowerShell sur l’ordinateur de passerelle.Launch Windows PowerShell on the gateway machine.

  2. Accédez au dossier C:\\Program Files\Microsoft Integration Runtime\3.0\PowerShellScript\ .Switch to the C:\\Program Files\Microsoft Integration Runtime\3.0\PowerShellScript\ folder.

  3. Exécutez la commande suivante pour désactiver la fonctionnalité de mise à jour automatique.Run the following command to turn the auto-update feature OFF (disable).

    .\IntegrationRuntimeAutoUpdateToggle.ps1 -off
    
  4. Pour la réactiver :To turn it back on:

    .\IntegrationRuntimeAutoUpdateToggle.ps1 -on
    

    Pour une passerelle multinœud à haute disponibilité et scalableFor multi-node highly available and scalable gateway

  5. Lancez Windows PowerShell sur l’ordinateur de passerelle.Launch Windows PowerShell on the gateway machine.

  6. Accédez au dossier C:\\Program Files\Microsoft Integration Runtime\3.0\PowerShellScript\ .Switch to the C:\\Program Files\Microsoft Integration Runtime\3.0\PowerShellScript\ folder.

  7. Exécutez la commande suivante pour désactiver la fonctionnalité de mise à jour automatique.Run the following command to turn the auto-update feature OFF (disable).

    Pour une passerelle avec une fonctionnalité de haute disponibilité, un paramètre AuthKey supplémentaire est nécessaire.For gateway with high availability feature, an extra AuthKey param is required.

    .\IntegrationRuntimeAutoUpdateToggle.ps1 -off -AuthKey <your auth key>
    
  8. Pour la réactiver :To turn it back on:

    .\IntegrationRuntimeAutoUpdateToggle.ps1 -on -AuthKey <your auth key>
    

Gestionnaire de configurationConfiguration Manager

Une fois la passerelle installée, vous pouvez lancer le Gestionnaire de configuration de passerelle de gestion des données de l’une des manières suivantes :Once you install the gateway, you can launch Data Management Gateway Configuration Manager in one of the following ways:

  1. Dans la fenêtre Rechercher, saisissez passerelle de gestion de données pour accéder à cet utilitaire.In the Search window, type Data Management Gateway to access this utility.
  2. Exécutez le fichier exécutable ConfigManager.exe dans le dossier : C:\\Program Files\Microsoft Data Management Gateway\2.0\Shared.Run the executable ConfigManager.exe in the folder: C:\\Program Files\Microsoft Data Management Gateway\2.0\Shared.

page d'accueilHome page

La page d’accueil permet d’effectuer les actions suivantes :The Home page allows you to do the following actions:

  • Afficher l’état de la passerelle (connectée au service cloud ou non, etc.).View status of the gateway (connected to the cloud service etc.).
  • Inscrire à l’aide d’une clé à partir du portail.Register using a key from the portal.
  • Arrêter et démarrer le service hôte de passerelle de gestion des données sur l’ordinateur de passerelle.Stop and start the Data Management Gateway Host service on the gateway machine.
  • Planifier les mises à jour à un moment spécifique de la journée.Schedule updates at a specific time of the days.
  • Afficher la date de la dernière mise à jourde la passerelle.View the date when the gateway was last updated.

Page ParamètresSettings page

La page Paramètres permet d’effectuer les actions suivantes :The Settings page allows you to do the following actions:

  • Afficher, modifier et exporter le certificat utilisé par la passerelle.View, change, and export certificate used by the gateway. Ce certificat est utilisé pour chiffrer les informations d’identification de la source de données.This certificate is used to encrypt data source credentials.
  • Modifier le port HTTPS du point de terminaison.Change HTTPS port for the endpoint. La passerelle ouvre un port pour définir les informations d’identification de la source de données.The gateway opens a port for setting the data source credentials.
  • l’état du point de terminaison.Status of the endpoint
  • Afficher le Certificat SSL qui est utilisé pour la communication SSL entre le portail et la passerelle pour définir les informations d’identification pour les sources de données.View SSL certificate is used for SSL communication between portal and the gateway to set credentials for data sources.

Accès à distance à partir de l’intranetRemote access from intranet

Cette fonctionnalité sera activée plus tard.This functionality will be enabled in the future. Dans les futures mises à jour (version 3.4 ou ultérieure), nous vous autoriserons à activer / désactiver une connexion à distance qui se fait via le port 8050 (voir la section ci-dessus) tout en utilisant l’application Gestionnaire des informations d’identification ou PowerShell pour chiffrer les informations d’identification.In the upcoming updates (v3.4 or later) we will let you enable/ disable any remote connectivity that today happens using port 8050 (see section above) while using PowerShell or Credential Manager application for encrypting credentials.

Page DiagnosticsDiagnostics page

La page Diagnostics permet d’effectuer les actions suivantes :The Diagnostics page allows you to do the following actions:

  • Activer la journalisationdétaillée, afficher les journaux d’activité dans l’observateur d’événements et envoyer des journaux d’activité à Microsoft en cas de défaillance.Enable verbose logging, view logs in event viewer, and send logs to Microsoft if there was a failure.
  • Tester la connexion à une source de données.Test connection to a data source.

Help pageHelp page

Cette page d’aide affiche les informations suivantes :The Help page displays the following information:

  • Brève description de la passerelleBrief description of the gateway
  • Numéro de versionVersion number
  • Liens vers l’aide en ligne, la déclaration de confidentialité et le contrat de licence.Links to online help, privacy statement, and license agreement.

Passerelle de surveillance dans le portailMonitor gateway in the portal

Dans le portail Azure, vous pouvez afficher un instantané en quasi temps réel de l’utilisation des ressources (processeur, mémoire, réseau (entrée/sortie), etc.) sur un ordinateur de passerelle.In the Azure portal, you can view near-real time snapshot of resource utilization (CPU, memory, network(in/out), etc.) on a gateway machine.

  1. Dans le portail Azure, accédez à la page d’accueil de votre fabrique de données, puis cliquez sur la vignette Services liés.In Azure portal, navigate to the home page for your data factory, and click Linked services tile.

    Page d’accueil Data Factory

  2. Sélectionnez la passerelle dans la page Services liés.Select the gateway in the Linked services page.

    Page Services liés

  3. Dans la page Passerelle, vous pouvez consulter l’utilisation de la mémoire et du processeur de la passerelle.In the Gateway page, you can see the memory and CPU usage of the gateway.

    Utilisation du processeur et de la mémoire de la passerelle

  4. Activez Paramètres avancés pour plus d’informations, notamment sur l’utilisation du réseau.Enable Advanced settings to see more details such as network usage.

    Surveillance avancée de la passerelle

Le tableau suivant fournit les descriptions des colonnes utilisées dans la liste Nœuds de passerelle :The following table provides descriptions of columns in the Gateway Nodes list:

Propriété de surveillanceMonitoring Property DescriptionDescription
NomName Nom de la passerelle logique et nœuds associés à la passerelle.Name of the logical gateway and nodes associated with the gateway. Le nœud est un ordinateur Windows local sur lequel la passerelle est installée.Node is an on-premises Windows machine that has the gateway installed on it. Pour plus d’informations sur la multitude de nœuds (jusqu’à quatre) dans une seule passerelle logique, consultez Passerelle de gestion des données - Haute disponibilité et scalabilité.For information on having more than one node (up to four nodes) in a single logical gateway, see Data Management Gateway - high availability and scalability.
StatutStatus État de la passerelle logique et des nœuds de passerelle.Status of the logical gateway and the gateway nodes. Exemple : En ligne/Hors connexion/Limité/etc. Pour plus d’informations sur ces états, consultez la section État de la passerelle.Example: Online/Offline/Limited/etc. For information about these statuses, See Gateway status section.
VersionVersion Indique la version de la passerelle logique et de chaque nœud de passerelle.Shows the version of the logical gateway and each gateway node. La version de la passerelle logique est déterminée selon la version de la majorité des nœuds dans le groupe.The version of the logical gateway is determined based on version of majority of nodes in the group. S’il existe des nœuds de différentes versions dans l’installation de la passerelle logique, seuls les nœuds dont le numéro de version est identique à celui de la passerelle logique fonctionnent correctement.If there are nodes with different versions in the logical gateway setup, only the nodes with the same version number as the logical gateway function properly. Les autres sont en mode limité et ont besoin d’une mise à jour manuelle (uniquement si la mise à jour automatique échoue).Others are in the limited mode and need to be manually updated (only in case auto-update fails).
Mémoire disponibleAvailable memory Mémoire disponible sur un nœud de passerelle.Available memory on a gateway node. Cette valeur est un instantané en quasi temps réel.This value is a near real-time snapshot.
Utilisation du processeurCPU utilization Utilisation du processeur d’un nœud de passerelle.CPU utilization of a gateway node. Cette valeur est un instantané en quasi temps réel.This value is a near real-time snapshot.
Réseau (entrée/sortie)Networking (In/Out) Utilisation du réseau d’un nœud de passerelle.Network utilization of a gateway node. Cette valeur est un instantané en quasi temps réel.This value is a near real-time snapshot.
Tâches simultanées (en cours d’exécution/limite)Concurrent Jobs (Running/ Limit) Nombre de travaux ou tâches qui s’exécutent sur chaque nœud.Number of jobs or tasks running on each node. Cette valeur est un instantané en quasi temps réel.This value is a near real-time snapshot. La limite correspond au nombre maximal de travaux simultanés pour chaque nœud.Limit signifies the maximum concurrent jobs for each node. Cette valeur est définie selon la taille de l’ordinateur.This value is defined based on the machine size. Vous pouvez augmenter la limite pour monter en puissance l’exécution de tâches simultanées dans les scénarios avancés, où le processeur/la mémoire /le réseau sont sous-utilisés, alors que les activités expirent. Cette fonctionnalité est également disponible avec une passerelle à nœud unique (même quand la fonctionnalité Haute disponibilité et scalabilité n’est pas activée).You can increase the limit to scale up concurrent job execution in advanced scenarios, where CPU/memory/network is under-utilized, but activities are timing out. This capability is also available with a single-node gateway (even when the scalability and availability feature is not enabled).
RôleRole Il existe deux types de rôles dans une passerelle à plusieurs nœuds : répartiteur et rôle de travail.There are two types of roles in a multi-node gateway - Dispatcher and worker. Tous les nœuds sont des rôles de travail, ce qui signifie qu’ils peuvent tous être utilisés pour exécuter des tâches.All nodes are workers, which means they can all be used to execute jobs. Il n’existe qu’un seul nœud répartiteur, utilisé pour extraire des tâches/travaux auprès de services cloud et les répartir entre les différents nœuds rôles de travail (y compris lui-même).There is only one dispatcher node, which is used to pull tasks/jobs from cloud services and dispatch them to different worker nodes (including itself).

Dans cette page figurent des paramètres plus significatifs en présence de deux nœuds ou plus (scénario d’augmentation du nombre des instances) dans la passerelle.In this page, you see some settings that make more sense when there are two or more nodes (scale out scenario) in the gateway. Consultez Passerelle de gestion des données - Haute disponibilité et scalabilité pour plus d’informations sur la configuration d’une passerelle à plusieurs nœud.See Data Management Gateway - high availability and scalability for details about setting up a multi-node gateway.

État de la passerelleGateway status

Le tableau suivant indique les états possibles d’un nœud de passerelle :The following table provides possible statuses of a gateway node:

StatutStatus Commentaires/ScénariosComments/Scenarios
En ligneOnline Nœud connecté au service Data Factory.Node connected to Data Factory service.
Hors ligneOffline Le nœud est hors connexion.Node is offline.
Mise à niveauUpgrading Le nœud est en cours de mise à jour automatique.The node is being auto-updated.
LimitéLimited Dû à un problème de connectivité.Due to Connectivity issue. Éventuellement dû à un problème de port HTTP 8050, à un problème de connectivité du bus de service ou à un problème de synchronisation des informations d’identification.May be due to HTTP port 8050 issue, service bus connectivity issue, or credential sync issue.
InactifInactive La configuration du nœud est différente de celle de la majorité des autres nœuds.Node is in a configuration different from the configuration of other majority nodes.

Un nœud peut être inactif quand il ne parvient pas à se connecter à d’autres nœuds.A node can be inactive when it cannot connect to other nodes.

Le tableau suivant indique les états possibles d’une passerelle logique.The following table provides possible statuses of a logical gateway. L’état de la passerelle dépend des états des nœuds de passerelle.The gateway status depends on statuses of the gateway nodes.

StatutStatus CommentairesComments
Doit être inscriteNeeds Registration Aucun nœud n’est encore inscrit sur cette passerelle logique.No node is yet registered to this logical gateway
En ligneOnline Les nœuds de passerelle sont en ligne.Gateway Nodes are online
Hors ligneOffline Aucun nœud n’est en ligne.No node in online status.
LimitéLimited Tous les nœuds inclus dans cette passerelle ne sont pas dans un état intègre.Not all nodes in this gateway are in healthy state. Cet état est un avertissement pouvant indiquer que certains nœuds sont en panne !This status is a warning that some node might be down!

Peut être dû à un problème de synchronisation des informations d’identification sur le nœud répartiteur/rôle de travail.Could be due to credential sync issue on dispatcher/worker node.

Monter en puissance la passerelleScale up gateway

Vous pouvez configurer le nombre de travaux de déplacement de données simultanés qui peuvent s’exécuter sur un nœud pour augmenter la capacité de déplacement des données entre les magasins de données locaux et dans le cloud.You can configure the number of concurrent data movement jobs that can run on a node to scale up the capability of moving data between on-premises and cloud data stores.

Quand la mémoire disponible et le processeur ne sont pas correctement utilisés, mais que la capacité inactive s’élève à 0, vous devez monter en puissance en augmentant le nombre de travaux simultanés pouvant s’exécuter sur un nœud.When the available memory and CPU are not utilized well, but the idle capacity is 0, you should scale up by increasing the number of concurrent jobs that can run on a node. Vous pouvez également monter en puissance quand les activités expirent parce que la passerelle est surchargée.You may also want to scale up when activities are timing out because the gateway is overloaded. Dans les paramètres avancés d’un nœud de passerelle, vous pouvez augmenter la capacité maximale d’un nœud.In the advanced settings of a gateway node, you can increase the maximum capacity for a node.

Résolution des problèmes de la passerelleTroubleshooting gateway issues

Consultez l’article Résolution des problèmes de la passerelle pour plus d’informations/de conseils pour résoudre les problèmes liés à la passerelle de gestion des données.See Troubleshooting gateway issues article for information/tips for troubleshooting issues with using the data management gateway.

Déplacer la passerelle d’une machine vers une autreMove gateway from one machine to another

Cette section décrit les opérations pour déplacer une passerelle client d’une machine vers une autre.This section provides steps for moving gateway client from one machine to another machine.

  1. Dans le portail, accédez à la page d’accueil de Data Factory, puis cliquez sur la vignette Services liés.In the portal, navigate to the Data Factory home page, and click the Linked Services tile.

    Lien de passerelles de données

  2. Sélectionnez votre passerelle dans la section PASSERELLES DE DONNÉES de la page Services liés.Select your gateway in the DATA GATEWAYS section of the Linked Services page.

    Page Services liés avec une passerelle sélectionnée

  3. Dans la page Passerelle de données, cliquez sur Télécharger et installer la passerelle de données.In the Data gateway page, click Download and install data gateway.

    Télécharger le lien de passerelle

  4. Dans la page Configurer, cliquez sur Télécharger et installer la passerelle de données, puis suivez les instructions pour installer la passerelle de données sur la machine.In the Configure page, click Download and install data gateway, and follow instructions to install the data gateway on the machine.

    Page Configurer

  5. Laissez le Gestionnaire de configuration de la passerelle de gestion des données ouvert.Keep the Microsoft Data Management Gateway Configuration Manager open.

    Gestionnaire de configuration

  6. Dans la page Configurer du portail, cliquez sur Recréer une clé dans la barre de commandes, puis, dans le message d’avertissement, cliquez sur Oui.In the Configure page in the portal, click Recreate key on the command bar, and click Yes for the warning message. Cliquez sur le bouton de copie en regard du texte de la clé qui copie la clé dans le presse-papiers.Click copy button next to key text that copies the key to the clipboard. La passerelle de l’ancienne machine cesse de fonctionner dès que vous recréez la clé.The gateway on the old machine stops functioning as soon you recreate the key.

    Recréer une clé

  7. Collez la clé dans la zone de texte sur la page Inscrire la passerelle du Gestionnaire de configuration de passerelle de gestion des données sur votre machine.Paste the key into text box in the Register Gateway page of the Data Management Gateway Configuration Manager on your machine. (Facultatif) Cochez la case Afficher la clé de passerelle pour afficher le texte de la clé.(optional) Click Show gateway key check box to see the key text.

    Copier la clé et s’inscrire

  8. Cliquez sur S’inscrire pour enregistrer la passerelle auprès du service cloud.Click Register to register the gateway with the cloud service.

  9. Dans l’onglet Paramètres, cliquez sur Modifier pour sélectionner le certificat utilisé avec l’ancienne passerelle, entrez le mot de passe, puis cliquez sur Terminer.On the Settings tab, click Change to select the same certificate that was used with the old gateway, enter the password, and click Finish.

    Spécifier le certificat

    Vous pouvez exporter un certificat à partir de l’ancienne passerelle en procédant comme suit : lancez le Gestionnaire de configuration de passerelle de gestion des données sur l’ancien panneau, basculez vers l’onglet Certificat, cliquez sur le bouton Exporter et suivez les instructions.You can export a certificate from the old gateway by doing the following steps: launch Data Management Gateway Configuration Manager on the old machine, switch to the Certificate tab, click Export button and follow the instructions.

  10. Une fois l’inscription de la passerelle terminée, vous devez voir Inscription définie sur Inscrit et État défini sur la valeur Démarré sur la page d’accueil du Gestionnaire de configuration de passerelle.After successful registration of the gateway, you should see the Registration set to Registered and Status set to Started on the Home page of the Gateway Configuration Manager.

Chiffrement des informations d’identificationEncrypting credentials

Pour chiffrer les informations d’identification dans Data Factory Editor, procédez comme suit :To encrypt credentials in the Data Factory Editor, do the following steps:

  1. Lancez le navigateur web sur l’ordinateur passerelle, accédez au portail Azure.Launch web browser on the gateway machine, navigate to Azure portal. Recherchez votre fabrique de données si nécessaire, ouvrez-la dans la page DATA FACTORY, puis cliquez sur Créer et déployer pour démarrer Data Factory Editor.Search for your data factory if needed, open data factory in the DATA FACTORY page and then click Author & Deploy to launch Data Factory Editor.

  2. Cliquez sur un service lié existant dans l’arborescence pour afficher sa définition JSON, ou créez un autre service lié qui nécessite une passerelle de gestion des données (par exemple, SQL Server ou Oracle).Click an existing linked service in the tree view to see its JSON definition or create a linked service that requires a data management gateway (for example: SQL Server or Oracle).

  3. Dans l’éditeur JSON, entrez le nom de la passerelle pour la propriété gatewayName .In the JSON editor, for the gatewayName property, enter the name of the gateway.

  4. Entrez le nom du serveur pour la propriété Data Source dans connectionString.Enter server name for the Data Source property in the connectionString.

  5. Entrez le nom de la base de données pour la propriété Initial Catalog dans connectionString.Enter database name for the Initial Catalog property in the connectionString.

  6. Cliquez sur le bouton Chiffrer dans la barre de commandes qui lance l’application ClickOnce Gestionnaire d’informations d’identification.Click Encrypt button on the command bar that launches the click-once Credential Manager application. La boîte de dialogue Définition des informations d’identification doit s’afficher.You should see the Setting Credentials dialog box.

    Boîte de dialogue de définition des informations d’identification

  7. Dans la boîte de dialogue Configuration des informations d’identification , procédez comme suit :In the Setting Credentials dialog box, do the following steps:

    1. Sélectionnez l’ authentification que le service de Data Factory doit utiliser pour se connecter à la base de données.Select authentication that you want the Data Factory service to use to connect to the database.
    2. Entrez le nom de l’utilisateur ayant accès à la base de données dans le paramètre USERNAME .Enter name of the user who has access to the database for the USERNAME setting.
    3. Entrez le mot de passe de l’utilisateur dans le paramètre PASSWORD .Enter password for the user for the PASSWORD setting.
    4. Cliquez sur OK pour chiffrer les informations d’identification et fermer la boîte de dialogue.Click OK to encrypt credentials and close the dialog box.
  8. Vous devez maintenant voir une propriété encryptedCredential dans connectionString.You should see a encryptedCredential property in the connectionString now.

    {
        "name": "SqlServerLinkedService",
        "properties": {
            "type": "OnPremisesSqlServer",
            "description": "",
            "typeProperties": {
                "connectionString": "data source=myserver;initial catalog=mydatabase;Integrated Security=False;EncryptedCredential=eyJDb25uZWN0aW9uU3R",
                "gatewayName": "adftutorialgateway"
            }
        }
    }
    

    Si vous accédez au portail à partir d’un ordinateur différent de l’ordinateur de passerelle, vous devrez peut-être vous assurer que l’application Gestionnaire d’informations d’identification peut se connecter à l’ordinateur de passerelle.If you access the portal from a machine that is different from the gateway machine, you must make sure that the Credentials Manager application can connect to the gateway machine. Sinon, vous ne pourrez pas définir les informations d’identification de la source de données, ni tester la connexion à la source de données.If the application cannot reach the gateway machine, it does not allow you to set credentials for the data source and to test connection to the data source.

Quand vous utilisez l’application Définition des informations d’identification, le portail chiffre les informations d’identification avec le certificat que vous avez spécifié dans l’onglet Certificat du Gestionnaire de configuration de passerelle sur l’ordinateur de passerelle.When you use the Setting Credentials application, the portal encrypts the credentials with the certificate specified in the Certificate tab of the Gateway Configuration Manager on the gateway machine.

Si vous recherchez une approche basée sur une API pour chiffrer les informations d’identification, vous pouvez utiliser la cmdlet PowerShell New-AzDataFactoryEncryptValue pour chiffrer les informations d’identification.If you are looking for an API-based approach for encrypting the credentials, you can use the New-AzDataFactoryEncryptValue PowerShell cmdlet to encrypt credentials. L'applet de commande utilise le certificat qui a servi à configurer la passerelle pour chiffrer les informations d'identification.The cmdlet uses the certificate that gateway is configured to use to encrypt the credentials. Vous ajoutez des informations d’identification chiffrées pour l’élément EncryptedCredential de connectionString dans JSON.You add encrypted credentials to the EncryptedCredential element of the connectionString in the JSON. Vous utilisez JSON avec la cmdlet New-AzDataFactoryLinkedService ou dans Data Factory Editor.You use the JSON with the New-AzDataFactoryLinkedService cmdlet or in the Data Factory Editor.

"connectionString": "Data Source=<servername>;Initial Catalog=<databasename>;Integrated Security=True;EncryptedCredential=<encrypted credential>",

Il existe une autre approche pour définir les informations d’identification à l’aide de Data Factory Editor.There is one more approach for setting credentials using Data Factory Editor. Si vous créez un service SQL Server lié à l’aide de l’éditeur et entrez les informations d’identification en texte brut, ces informations d’identification sont chiffrées à l’aide d’un certificat appartenant au service Data Factory.If you create a SQL Server linked service by using the editor and you enter credentials in plain text, the credentials are encrypted using a certificate that the Data Factory service owns. Il n’utilise PAS le certificat que passerelle est configurée pour utiliser.It does NOT use the certificate that gateway is configured to use. Bien que cette approche puisse être un peu plus rapide dans certains cas, elle reste moins sécurisée.While this approach might be a little faster in some cases, it is less secure. Par conséquent, nous vous recommandons de suivre cette approche uniquement à des fins de développement/test.Therefore, we recommend that you follow this approach only for development/testing purposes.

Applets de commande PowerShellPowerShell cmdlets

Cette section décrit comment créer et enregistrer une passerelle à l’aide des applets de commande Azure PowerShell.This section describes how to create and register a gateway using Azure PowerShell cmdlets.

  1. Lancez Azure PowerShell en mode administrateur.Launch Azure PowerShell in administrator mode.

  2. Connectez-vous à votre compte Azure en exécutant la commande suivante et en entrant vos informations d’identification Azure.Log in to your Azure account by running the following command and entering your Azure credentials.

    Connect-AzAccount
    
  3. Utilisez la cmdlet New-AzDataFactoryGateway pour créer une passerelle logique, comme suit :Use the New-AzDataFactoryGateway cmdlet to create a logical gateway as follows:

    $MyDMG = New-AzDataFactoryGateway -Name <gatewayName> -DataFactoryName <dataFactoryName> -ResourceGroupName ADF –Description <desc>
    

    Exemple de commande et de sortie:Example command and output:

    PS C:\> $MyDMG = New-AzDataFactoryGateway -Name MyGateway -DataFactoryName $df -ResourceGroupName ADF –Description “gateway for walkthrough”
    
    Name              : MyGateway
    Description       : gateway for walkthrough
    Version           :
    Status            : NeedRegistration
    VersionStatus     : None
    CreateTime        : 9/28/2014 10:58:22
    RegisterTime      :
    LastConnectTime   :
    ExpiryTime        :
    ProvisioningState : Succeeded
    Key               : ADF#00000000-0000-4fb8-a867-947877aef6cb@fda06d87-f446-43b1-9485-78af26b8bab0@4707262b-dc25-4fe5-881c-c8a7c3c569fe@wu#nfU4aBlq/heRyYFZ2Xt/CD+7i73PEO521Sj2AFOCmiI
    
  4. Dans Azure PowerShell, accédez au dossier : C:\\Program Files\Microsoft Integration Runtime\3.0\PowerShellScript\ .In Azure PowerShell, switch to the folder: C:\\Program Files\Microsoft Integration Runtime\3.0\PowerShellScript\. Exécutez le script RegisterGateway.ps1 associé à la variable locale $Key, comme indiqué dans la commande suivante.Run RegisterGateway.ps1 associated with the local variable $Key as shown in the following command. Ce script enregistre l’agent client installé sur votre ordinateur avec la passerelle logique que vous avez créée précédemment.This script registers the client agent installed on your machine with the logical gateway you create earlier.

    PS C:\> .\RegisterGateway.ps1 $MyDMG.Key
    
    Agent registration is successful!
    

    Vous pouvez inscrire la passerelle sur un ordinateur distant en utilisant le paramètre IsRegisterOnRemoteMachine.You can register the gateway on a remote machine by using the IsRegisterOnRemoteMachine parameter. Exemple :Example:

    .\RegisterGateway.ps1 $MyDMG.Key -IsRegisterOnRemoteMachine true
    
  5. Vous pouvez utiliser la cmdlet Get-AzDataFactoryGateway pour obtenir la liste des passerelles dans votre fabrique de données.You can use the Get-AzDataFactoryGateway cmdlet to get the list of Gateways in your data factory. Lorsque l’état est online, cela signifie que votre passerelle est prête.When the Status shows online, it means your gateway is ready to use.

    Get-AzDataFactoryGateway -DataFactoryName <dataFactoryName> -ResourceGroupName ADF
    

    Vous pouvez supprimer une passerelle à l’aide de la cmdlet Remove-AzDataFactoryGateway et mettre à jour la description de la passerelle en utilisant les cmdlets Set-AzDataFactoryGateway.You can remove a gateway using the Remove-AzDataFactoryGateway cmdlet and update description for a gateway using the Set-AzDataFactoryGateway cmdlets. Pour obtenir la syntaxe et d’autres détails sur ces applets de commande, consultez la rubrique Référence des applets de commande Azure Data Factory.For syntax and other details about these cmdlets, see Data Factory Cmdlet Reference.

Répertorier les passerelles à l’aide de PowerShellList gateways using PowerShell

Get-AzDataFactoryGateway -DataFactoryName jasoncopyusingstoredprocedure -ResourceGroupName ADF_ResourceGroup

Supprimer une passerelle à l’aide de PowerShellRemove gateway using PowerShell

Remove-AzDataFactoryGateway -Name JasonHDMG_byPSRemote -ResourceGroupName ADF_ResourceGroup -DataFactoryName jasoncopyusingstoredprocedure -Force

Étapes suivantesNext steps