Créer un Azure-SSIS Integration Runtime dans Azure Data FactoryCreate Azure-SSIS Integration Runtime in Azure Data Factory

Ce tutoriel décrit les différentes étapes de provisionnement d’un runtime d’intégration (IR) Azure SQL Server Integration Services (SSIS) dans Azure Data Factory.This tutorial provides steps for provisioning an Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) in Azure Data Factory (ADF). Azure-SSIS IR prend en charge l’exécution de packages déployés dans le catalogue SSIS (SSISDB) hébergé par le serveur Azure SQL Database/Managed Instance (modèle de déploiement de projet) et de ceux déployés dans les systèmes de fichiers/les partages de fichiers/Azure Files (modèle de déploiement de package).Azure-SSIS IR supports running packages deployed into SSIS catalog (SSISDB) hosted by Azure SQL Database server/Managed Instance (Project Deployment Model) and those deployed into file systems/file shares/Azure Files (Package Deployment Model). Une fois qu’Azure-SSIS IR est provisionné, vous pouvez utiliser des outils familiers, comme SQL Server Data Tools (SSDT)/SQL Server Management Studio (SSMS), et des utilitaires en ligne de commande, comme dtinstall/dtutil/dtexec, pour déployer et exécuter vos packages dans Azure.Once Azure-SSIS IR is provisioned, you can then use familiar tools, such as SQL Server Data Tools (SSDT)/SQL Server Management Studio (SSMS), and command line utilities, such as dtinstall/dtutil/dtexec, to deploy and run your packages in Azure.

Le Tutoriel : Provisionnement d’Azure-SSIS IR vous montre comment créer un runtime d’intégration Azure-SSIS à l’aide du portail Azure/de l’application ADF et éventuellement utiliser le serveur Azure SQL Database/Managed Instance pour héberger SSISDB.The Tutorial: Provisioning Azure-SSIS IR shows you how to create an Azure-SSIS IR via the Azure portal/ADF app and optionally use Azure SQL Database server/Managed Instance to host SSISDB. Cet article s’appuie sur le didacticiel et vous montre comment effectuer les opérations suivantes :This article expands on the tutorial and shows you how to do the following things:

  • Si vous le souhaitez, vous pouvez utiliser le serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance dans un réseau virtuel pour héberger SSISDB.Optionally use Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network to host SSISDB. Vous devez au préalable configurer les autorisations/paramètres de réseau virtuel pour que votre runtime d’intégration Azure-SSIS soit joint à un réseau virtuel.As a prerequisite, you need to configure virtual network permissions/settings for your Azure-SSIS IR to join a virtual network.

  • Utilisez éventuellement l’authentification Azure Active Directory (AAD) avec l’identité managée pour que votre service ADF se connecte à un serveur Azure SQL Database/Managed Instance.Optionally use Azure Active Directory (AAD) authentication with the managed identity for your ADF to connect to Azure SQL Database server/Managed Instance. Vous devez au préalable ajouter l’identité managée pour votre ADF comme utilisateur de base de données capable de créer une base de données SSISDB.As a prerequisite, you will need to add the managed identity for your ADF as a database user capable of creating SSISDB.

Vue d'ensembleOverview

Cet article présente différentes façons de provisionner Azure-SSIS IR :This article shows different ways of provisioning Azure-SSIS IR:

PrérequisPrerequisites

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.

  • Abonnement Azure.Azure subscription. Si vous n’avez pas encore d’abonnement, vous pouvez créer un compte d’essai gratuit.If you do not already have a subscription, you can create a free trial account.
  • Serveur Azure SQL Database/Managed Instance (facultatif) .Azure SQL Database server/Managed Instance (optional). Si vous n’avez pas encore de serveur de base de données, créez-en un dans le portail Azure avant de commencer.If you do not already have a database server, create one in the Azure portal before you get started. ADF crée à son tour une base de données SSISDB sur ce serveur de base de données.ADF will in turn create SSISDB on this database server. Nous vous recommandons de créer le serveur de base de données dans la même région Azure que le runtime d’intégration.We recommend that you create the database server in the same Azure region as the integration runtime. Cette configuration permet au runtime d’intégration d’écrire des journaux des exécutions dans SSISDB sans dépasser les régions Azure.This configuration lets the integration runtime write execution logs into SSISDB without crossing Azure regions.
    • En fonction du serveur de base de données sélectionné, SSISDB peut être créée à votre place en tant que base de données unique, faisant partie d’un pool élastique ou dans une instance gérée de type Managed Instance, et accessible sur un réseau public ou en rejoignant un réseau virtuel.Based on the selected database server, SSISDB can be created on your behalf as a single database, part of an elastic pool, or in a Managed Instance and accessible in public network or by joining a virtual network. Pour obtenir de l’aide sur le choix du type de serveur de base de données pour héberger SSISDB, consultez Comparer une base de données unique/un pool élastique Azure SQL Database et Managed Instance.For guidance in choosing the type of database server to host SSISDB, see Compare Azure SQL Database single database/elastic pool/Managed Instance. Si vous utilisez un serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance pour héberger SSISDB, ou que vous avez besoin d’accéder à des données locales, vous devez joindre votre runtime d’intégration Azure-SSIS à un réseau virtuel. Consultez Joindre le runtime d’intégration Azure-SSIS à un réseau virtuel.If you use Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network to host SSISDB or require access to on-premises data, you need to join your Azure-SSIS IR to a virtual network, see Join Azure-SSIS IR to a virtual network.
    • Vérifiez que le paramètre Autoriser l’accès aux services Azure est activé pour votre serveur de base de données.Confirm that the Allow access to Azure services setting is enabled for the database server. Cela ne s’applique pas quand vous utilisez le serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance dans un réseau virtuel pour héberger SSISDB.This is not applicable when you use Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network to host SSISDB. Pour en savoir plus, consultez Sécuriser votre base de données Azure SQL.For more information, see Secure your Azure SQL database. Pour savoir comment activer ce paramètre à l’aide de PowerShell, consultez New-AzSqlServerFirewallRule.To enable this setting by using PowerShell, see New-AzSqlServerFirewallRule.
    • Ajoutez l’adresse IP de l’ordinateur client ou une plage d’adresses IP qui inclut l’adresse IP de l’ordinateur client à la liste d’adresses IP client dans les paramètres de pare-feu du serveur de base de données.Add the IP address of client machine, or a range of IP addresses that includes the IP address of client machine, to the client IP address list in the firewall settings for the database server. Pour plus d’informations, consultez Règles de pare-feu au niveau du serveur et de la base de données Azure SQL Database.For more information, see Azure SQL Database server-level and database-level firewall rules.
    • Vous pouvez vous connecter au serveur de base de données à l’aide de l’authentification SQL avec vos informations d’identification d’administrateur de serveur ou l’authentification Azure Active Directory (AAD) avec l’identité managée de votre ADF.You can connect to the database server using SQL authentication with your server admin credentials or Azure Active Directory (AAD) authentication with the managed identity for your ADF. Pour cette dernière, vous devez ajouter l’identité managée de votre ADF à un groupe AAD avec autorisations d’accès au serveur de base de données. Pour cela, consultez Activer l’authentification Azure Active Directory pour Azure-SSIS Integration Runtime.For the latter, you need to add the managed identity for your ADF into an AAD group with access permissions to the database server, see Enable AAD authentication for Azure-SSIS IR.
    • Vérifiez que votre serveur de base de données n’a pas déjà une base de données SSISDB.Confirm that your database server does not have an SSISDB already. Le provisionnement d’un runtime d’intégration Azure-SSIS ne prend pas en charge l’utilisation d’une base de données SSISDB existante.The provisioning of an Azure-SSIS IR does not support using an existing SSISDB.
  • Réseau virtuel Azure Resource Manager (facultatif) .Azure Resource Manager virtual network (optional). Vous devez disposer d’un réseau virtuel Azure Resource Manager si au moins l’une des conditions suivantes est remplie :You must have an Azure Resource Manager virtual network if at least one of the following conditions is true:
    • Vous hébergez SSISDB sur le serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance dans un réseau virtuel.You are hosting SSISDB on Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network.
    • Vous souhaitez vous connecter à des banques de données locales à partir de packages SSIS en cours d’exécution sur votre Azure-SSIS IR.You want to connect to on-premises data stores from SSIS packages running on your Azure-SSIS IR.
  • Azure PowerShell (facultatif) .Azure PowerShell (optional). Suivez les instructions de la rubrique Guide pratique pour installer et configurer Azure PowerShell si vous souhaitez exécuter un script PowerShell pour provisionner votre runtime d’intégration Azure-SSIS.Follow the instructions on How to install and configure Azure PowerShell, if you want to run a PowerShell script to provision your Azure-SSIS IR.

Prise en charge de la régionRegion support

Pour obtenir la liste des régions Azure dans lesquelles ADF et Azure-SSIS IR sont actuellement disponibles, consultez Disponibilité d’Azure Data Factory et de SSIS IR par région.For a list of Azure regions, in which ADF and Azure-SSIS IR are currently available, see ADF + SSIS IR availability by region.

Comparer une base de données unique/un pool élastique Azure SQL Database et SQL Database Managed InstanceCompare SQL Database single database/elastic pool and SQL Database Managed Instance

Le tableau suivant compare certaines fonctionnalités du serveur Azure SQL Database et Managed Instance concernant l’IR Azure-SSIR :The following table compares certain features of Azure SQL Database server and Managed Instance as they relate to Azure-SSIR IR:

FonctionnalitéFeature base de données unique/pool élastiquesingle database/elastic pool Instance géréeManaged Instance
PlanificationScheduling SQL Server Agent n’est pas disponible.SQL Server Agent is not available.

Consultez Planifier l’exécution de packages SSIS (SQL Server Integration Services) déployés dans Azure.See Schedule a package execution in ADF pipeline.
L’agent Managed Instance est disponible.Managed Instance Agent is available.
AuthentificationAuthentication Vous pouvez créer SSISDB avec un utilisateur de base de données autonome représentant un groupe AAD avec l’identité managée de votre service ADF en tant que membre du rôle db_owner.You can create SSISDB with a contained database user representing any AAD group with the managed identity of your ADF as a member in the db_owner role.

Consultez Activer l’authentification Azure AD pour créer SSISDB sur le serveur Azure SQL Database.See Enable Azure AD authentication to create SSISDB in Azure SQL Database server.
Vous pouvez créer SSISDB avec un utilisateur de base de données autonome représentant l’identité managée de votre service ADF.You can create SSISDB with a contained database user representing the managed identity of your ADF.

Consultez Activer l’authentification Azure AD pour créer SSISDB dans Azure SQL Database Managed Instance.See Enable Azure AD authentication to create SSISDB in Azure SQL Database Managed Instance.
Niveau de serviceService tier Quand vous créez un IR Azure-SSIS avec votre serveur Azure SQL Database, vous pouvez sélectionner le niveau de service pour SSISDB.When you create Azure-SSIS IR with your Azure SQL Database server, you can select the service tier for SSISDB. Il existe plusieurs niveaux de service.There are multiple service tiers. Quand vous créez un Azure-SSIS IR avec votre Managed Instance, vous ne pouvez pas sélectionner le niveau de service pour SSISDB.When you create Azure-SSIS IR with your Managed Instance, you cannot select the service tier for SSISDB. Toutes les bases de données dans votre Managed Instance partagent la même ressource allouée à cette instance.All databases in your Managed Instance share the same resource allocated to that instance.
Réseau virtuelVirtual network Prend en charge uniquement les réseaux virtuels Azure Resource Manager pour la jonction de votre Azure-SSIS IR si vous utilisez un serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel ou que vous nécessitez un accès aux banques de données locales.Supports only Azure Resource Manager virtual networks for your Azure-SSIS IR to join if you use Azure SQL Database server with virtual network service endpoints or require access to on-premises data stores. Prend uniquement en charge les réseaux virtuels Azure Resource Manager pour la jonction de votre Azure-SSIS IR.Supports only Azure Resource Manager virtual networks for your Azure-SSIS IR to join. Le réseau virtuel est toujours obligatoire.The virtual network is always required.

Si vous associez votre Azure-SSIS IR au même réseau virtuel que votre Managed Instance, vérifiez que votre Azure-SSIS IR est sur un sous-réseau différent de celui de votre Managed Instance.If you join your Azure-SSIS IR to the same virtual network as your Managed Instance, make sure that your Azure-SSIS IR is in a different subnet than your Managed Instance. Si vous associez votre Azure-SSIS IR à un réseau virtuel différent de celui de votre Managed Instance, nous recommandons l’appairage de réseau virtuel ou une connexion de réseau virtuel à réseau virtuel.If you join your Azure-SSIS IR to a different virtual network than your Managed Instance, we recommend either a virtual network peering or virtual network to virtual network connection. Consultez Connecter votre application à Azure SQL Database Managed Instance.See Connect your application to Azure SQL Database Managed Instance.
Transactions distribuéesDistributed transactions Prises en charge par le biais des Transactions élastiques.Supported through Elastic Transactions. Les transactions MSDTC (Microsoft Distributed Transaction Coordinator) ne sont pas prises en charge.Microsoft Distributed Transaction Coordinator (MSDTC) transactions are not supported. Si vos packages SSIS utilisent MSDTC pour coordonner les transactions distribuées, envisagez la migration vers les transactions élastiques pour Azure SQL Database.If your SSIS packages use MSDTC to coordinate distributed transactions, consider migrating to Elastic Transactions for Azure SQL Database. Pour plus d’informations, consultez Transactions distribuées entre bases de données cloud.For more info, see Distributed transactions across cloud databases. Non pris en charge.Not supported.

Portail AzureAzure portal

Dans cette section, vous utilisez le portail Azure, plus précisément l’application/interface utilisateur ADF, pour créer Azure-SSIS IR.In this section, you use Azure portal, specifically ADF User Interface (UI)/app, to create Azure-SSIS IR.

Créer une fabrique de donnéesCreate a data factory

  1. Lancez le navigateur web Microsoft Edge ou Google Chrome.Launch Microsoft Edge or Google Chrome web browser. L’interface utilisateur de Data Factory n’est actuellement prise en charge que par les navigateurs web Microsoft Edge et Google Chrome.Currently, Data Factory UI is supported only in Microsoft Edge and Google Chrome web browsers.

  2. Connectez-vous au Portail Azure.Sign in to the Azure portal.

  3. Cliquez sur Nouveau dans le menu de gauche, puis sur Données + analyse et sur Data Factory.Click New on the left menu, click Data + Analytics, and click Data Factory.

    Nouveau -> DataFactory

  4. Sur la page Nouvelle fabrique de données, saisissez ADFTutorialDataFactory comme nom.In the New data factory page, enter MyAzureSsisDataFactory for the name.

    Page Nouvelle fabrique de données

    Le nom de la fabrique de données Azure doit être un nom global unique.The name of the Azure data factory must be globally unique. Si l’erreur suivante s’affiche, changez le nom de la fabrique de données (par exemple, votrenomMyAzureSsisDataFactory), puis tentez de la recréer.If you receive the following error, change the name of the data factory (for example, yournameMyAzureSsisDataFactory) and try creating again. Consultez l’article Data Factory - Règles d’affectation des noms pour savoir comment nommer les artefacts Data Factory.See Data Factory - Naming Rules article for naming rules for Data Factory artifacts.

    Data factory name “MyAzureSsisDataFactory” is not available

  5. Sélectionnez l’abonnement Azure dans lequel vous voulez créer la fabrique de données.Select your Azure subscription in which you want to create the data factory.

  6. Pour le groupe de ressources, effectuez l’une des opérations suivantes :For the Resource Group, do one of the following steps:

    • Sélectionnez Utiliser l’existant, puis sélectionnez un groupe de ressources existant dans la liste déroulante.Select Use existing, and select an existing resource group from the drop-down list.
    • Sélectionnez Créer, puis entrez le nom d’un groupe de ressources.Select Create new, and enter the name of a resource group.

    Pour plus d’informations sur les groupes de ressources, consultez Utilisation des groupes de ressources pour gérer vos ressources Azure.To learn about resource groups, see Using resource groups to manage your Azure resources.

  7. Sélectionnez V2 pour la version.Select V2 for the version.

  8. Sélectionnez l’emplacement de la fabrique de données.Select the location for the data factory. Seuls les emplacements pris en charge pour la création de fabriques de données sont affichés dans la liste.Only locations that are supported for creation of data factories are shown in the list.

  9. Sélectionnez Épingler au tableau de bord.Select Pin to dashboard.

  10. Cliquez sur Créer.Click Create.

  11. Sur le tableau de bord, vous voyez la vignette suivante avec l’état : Déploiement de Data Factory.On the dashboard, you see the following tile with status: Deploying data factory.

    mosaïque déploiement de fabrique de données

  12. Une fois la création terminée, la page Data Factory s’affiche comme sur l’image.After the creation is complete, you see the Data Factory page as shown in the image.

    Page d’accueil Data Factory

  13. Cliquez sur Créer et surveiller pour lancer l’interface utilisateur (IU) de Data Factory dans un onglet séparé.Click Author & Monitor to launch the Data Factory User Interface (UI) in a separate tab.

Approvisionner un runtime d’intégration Azure SSISProvision an Azure SSIS integration runtime

  1. Dans la page de prise en main, cliquez sur la vignette Configurer un runtime d’intégration SSIS.In the get started page, click Configure SSIS Integration Runtime tile.

    Vignette Configurer un runtime d’intégration SSIS

  2. Sur la page Paramètres généraux de Configuration du runtime d’intégration, procédez comme suit :On the General Settings page of Integration Runtime Setup, complete the following steps:

    Paramètres généraux :

    a.a. Dans Nom, saisissez le nom de votre runtime d’intégration.For Name, enter the name of your integration runtime.

    b.b. Dans Description, saisissez la description de votre runtime d’intégration.For Description, enter the description of your integration runtime.

    c.c. Pour Emplacement, sélectionnez l’emplacement de votre runtime d’intégration.For Location, select the location of your integration runtime. Seuls les emplacements pris en charge sont affichés.Only supported locations are displayed. Nous vous conseillons de sélectionner le même emplacement que votre serveur de base de données pour héberger SSISDB.We recommend that you select the same location of your database server to host SSISDB.

    d.d. Pour Taille du nœud, sélectionnez la taille du nœud du cluster de votre runtime d’intégration.For Node Size, select the size of node in your integration runtime cluster. Seules les tailles de nœuds prises en charge sont affichées.Only supported node sizes are displayed. Sélectionnez une taille de nœud importante si vous voulez exécuter de nombreux packages nécessitant beaucoup de calcul/mémoire.Select a large node size (scale up), if you want to run many compute/memory –intensive packages.

    e.e. Pour Nombre de nœud, sélectionnez le nombre de nœuds du cluster de votre runtime d’intégration.For Node Number, select the number of nodes in your integration runtime cluster. Seuls les nombres de nœuds pris en charge sont affichés.Only supported node numbers are displayed. Sélectionnez un grand cluster avec plusieurs nœuds, si vous voulez exécuter de nombreux packages en parallèle.Select a large cluster with many nodes (scale out), if you want to run many packages in parallel.

    f.f. Pour Édition/Licence, sélectionnez l’édition/licence de SQL Server pour votre runtime d’intégration : Standard ou Entreprise.For Edition/License, select SQL Server edition/license for your integration runtime: Standard or Enterprise. Sélectionnez Entreprise, si vous voulez utiliser les fonctionnalités avancées/premium de votre runtime d’intégration.Select Enterprise, if you want to use advanced/premium features on your integration runtime.

    g.g. Pour Économiser de l’argent, sélectionnez l’option Azure Hybrid Benefit (AHB) pour votre runtime d’intégration : Oui ou Non.For Save Money, select Azure Hybrid Benefit (AHB) option for your integration runtime: Yes or No. Sélectionnez Oui si vous souhaitez mettre votre propre licence SQL Server avec Software Assurance pour faire des économies grâce à une utilisation hybride.Select Yes, if you want to bring your own SQL Server license with Software Assurance to benefit from cost savings with hybrid use.

    h.h. Cliquez sur Suivant.Click Next.

  3. Sur la page Paramètres SQL, procédez comme suit :On the SQL Settings page, complete the following steps:

    Paramètres SQL

    a.a. Sur la case Créer un catalogue SSIS... , cochez le modèle de déploiement approprié pour que les packages s’exécutent sur votre runtime d’intégration Azure-SSIS : Le modèle de déploiement de projet dans lequel les packages sont déployés dans SSISDB hébergé par votre serveur de base de données ou votre modèle de déploiement de package dans lequel les packages sont déployés dans vos systèmes de fichiers/partages de fichiers/Azure Files.On Create SSIS catalog... checkbox, select the deployment model for packages to run on your Azure-SSIS IR: Project Deployment Model where packages are deployed into SSISDB hosted by your database server or Package Deployment Model where packages are deployed into your file systems/file shares/Azure Files. Si vous cochez cette option, vous devez apporter votre propre serveur de base de données pour héberger la base de données SSISDB que nous allons créer et gérer à votre place.If you check it, you will need to bring your own database server to host SSISDB that we will create and manage on your behalf.

    b.b. Pour Abonnement, sélectionnez l’abonnement Azure comprenant votre serveur de base de données pour héberger la base de données SSISDB.For Subscription, select the Azure subscription that has your database server to host SSISDB.

    c.c. Pour Emplacement, sélectionnez l’emplacement de votre serveur de base de données pour héberger la base de données SSISDB.For Location, select the location of your database server to host SSISDB. Nous vous recommandons de sélectionner le même emplacement que celui de runtime d’intégration.We recommend that you select the same location of your integration runtime.

    d.d. Pour Point de terminaison du serveur de base de données du catalogue, sélectionnez le point de terminaison de votre serveur de base de données pour héberger SSISDB.For Catalog Database Server Endpoint, select the endpoint of your database server to host SSISDB. En fonction du serveur de base de données sélectionné, SSISDB peut être créée à votre place en tant que base de données unique, faisant partie d’un pool élastique ou dans une instance gérée de type Managed Instance, et accessible sur un réseau public ou en rejoignant un réseau virtuel.Based on the selected database server, SSISDB can be created on your behalf as a single database, part of an elastic pool, or in a Managed Instance and accessible in public network or by joining a virtual network. Pour obtenir de l’aide sur le choix du type de serveur de base de données pour héberger SSISDB, consultez Comparer une base de données unique/un pool élastique Azure SQL Database et Managed Instance.For guidance in choosing the type of database server to host SSISDB, see Compare Azure SQL Database single database/elastic pool/Managed Instance. Si vous sélectionnez un serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance pour héberger SSISDB, ou que vous avez besoin d’accéder à des données locales, vous devez joindre votre runtime d’intégration Azure-SSIS à un réseau virtuel. Consultez Joindre le runtime d’intégration Azure-SSIS à un réseau virtuel.If you select Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network to host SSISDB or require access to on-premises data, you need to join your Azure-SSIS IR to a virtual network, see Join Azure-SSIS IR to a virtual network.

    e.e. Dans la case à cocher Utiliser l’authentification AAD, sélectionnez la méthode d’authentification pour l’hébergement de SSISDB par votre serveur de base de données : l’authentification SQL ou l’authentification AAD avec l’identité managée pour votre ADF.On Use AAD authentication... checkbox, select the authentication method for your database server to host SSISDB: SQL authentication or AAD authentication with the managed identity for your ADF. Si vous cochez cette option, vous devez ajouter l’identité managée de votre service Azure Data Factory à un groupe AAD avec autorisations d’accès à votre serveur de base de données. Pour cela, consultez Activer l’authentification Azure Active Directory pour Azure-SSIS Integration Runtime.If you check it, you need to add the managed identity for your ADF into an AAD group with access permissions to your database server, see Enable AAD authentication for Azure-SSIS IR.

    f.f. Pour Nom d’utilisateur administrateur, entrez le nom d’utilisateur d’authentification SQL pour votre serveur de base de données accueillant la base de données SSISDB.For Admin Username, enter SQL authentication username for your database server to host SSISDB.

    g.g. Pour Mot de passe administrateur, entrez le mot de passe d’authentification SQL pour votre serveur de base de données accueillant la base de données SSISDB.For Admin Password, enter SQL authentication password for your database server to host SSISDB.

    h.h. Pour Niveau de service de base de données de catalogue, sélectionnez le niveau de service pour l’hébergement de SSISDB par votre serveur de base de données : niveau De base/Standard/Premium ou nom du pool élastique.For Catalog Database Service Tier, select the service tier for your database server to host SSISDB: Basic/Standard/Premium tier or elastic pool name.

    i.i. Cliquez sur Tester la connexion et en cas de réussite, cliquez sur Suivant.Click Test Connection and if successful, click Next.

  4. Sur la page Paramètres avancés, procédez comme suit :On the Advanced Settings page, complete the following steps:

    Paramètres avancés

    a.a. Pour Exécutions parallèles maximales par nœud, sélectionnez le nombre maximal de packages exécutables simultanément par nœud au sein de votre cluster de runtime d’intégration.For Maximum Parallel Executions Per Node, select the maximum number of packages to execute concurrently per node in your integration runtime cluster. Seuls les numéros des packages pris en charge sont affichés.Only supported package numbers are displayed. Sélectionnez un petit nombre, si vous souhaitez utiliser plusieurs cœurs pour exécuter un package volumineux/lourd intensif sur le calcul/la mémoire.Select a low number, if you want to use more than one core to run a single large/heavy-weight package that is compute/memory -intensive. Sélectionnez un nombre plus élevé, si vous souhaitez exécuter un ou plusieurs packages petits/légers dans un seul cœur.Select a high number, if you want to run one or more small/light-weight packages in a single core.

    b.b. Pour une URI SAS de conteneur d’installation personnalisée, vous pouvez également entrer l’URI (Uniform Resource Identifier) de la signature d’accès partagé (SAS) de votre conteneur Azure Storage Blob dans lequel votre script d’installation et les fichiers associés sont stockés, consultez Installation personnalisée du runtime d’intégration SSIS Azure.For Custom Setup Container SAS URI, optionally enter Shared Access Signature (SAS) Uniform Resource Identifier (URI) of your Azure Storage Blob container where your setup script and its associated files are stored, see Custom setup for Azure-SSIS IR.

  5. Dans la case à cocher Sélectionner un réseau virtuel... , indiquez si vous voulez joindre votre runtime d'intégration à un réseau virtuel.On Select a virtual network... checkbox, select whether you want to join your integration runtime to a virtual network. Vérifiez si vous utilisez un serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance dans un réseau virtuel pour héberger SSISDB ou si vous avez besoin d’accéder à des données locales, autrement dit si vous avez des sources/destinations de données locales dans vos packages SSIS. Consultez Joindre le runtime d’intégration Azure-SSIS à un réseau virtuel.Check it if you use Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network to host SSISDB or require access to on-premises data; that is, you have on-premises data sources/destinations in your SSIS packages, see Join Azure-SSIS IR to a virtual network. Si vous la cochez, effectuez les tâches suivantes :If you check it, complete the following steps:

    Paramètres avancés avec un réseau virtuel

    a.a. Dans Abonnement, sélectionnez l’abonnement Azure possédant votre réseau virtuel.For Subscription, select the Azure subscription that has your virtual network.

    b.b. Pour Emplacement, sélectionnez le même emplacement que celui de votre runtime d’intégration.For Location, the same location of your integration runtime is selected.

    c.c. Pour Type, sélectionnez le type de votre réseau virtuel : Classique ou Azure Resource Manager.For Type, select the type of your virtual network: Classic or Azure Resource Manager. Nous vous recommandons de sélectionner le réseau virtuel Azure Resource Manager, car le réseau virtuel classique sera bientôt déconseillé.We recommend that you select Azure Resource Manager virtual network, since Classic virtual network will be deprecated soon.

    d.d. Pour Nom du réseau virtuel, sélectionnez le nom de votre réseau virtuel.For VNet Name, select the name of your virtual network. Ce réseau virtuel doit être le même que celui utilisé pour le serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance dans un réseau virtuel pour héberger la base de données SSISDB ou celui connecté à votre réseau local.This virtual network should be the same one used for Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network to host SSISDB or the one connected to your on-premises network.

    e.e. Pour Nom du sous-réseau, sélectionnez le nom du sous-réseau de votre réseau virtuel.For Subnet Name, select the name of subnet for your virtual network. Ce doit être un sous-réseau différent de celui utilisé pour Managed Instance dans un réseau virtuel pour héberger SSISDB.This should be a different subnet than the one used for Managed Instance in a virtual network to host SSISDB.

  6. Cliquez sur Validation du réseau virtuel et en cas de réussite, cliquez sur Terminer pour démarrer la création de votre runtime d'intégration SSIS Azure.Click VNet Validation and if successful, click Finish to start the creation of your Azure-SSIS integration runtime.

    Notes

    En dehors des réglages personnalisés, ce processus devrait se terminer dans les 5 minutes. Toutefois, il peut prendre de 20 à 30 minutes environ pour le runtime d’intégration Azure-SSIS se joignant à un réseau virtuel.Excluding any custom setup time, this process should be completed within 5 minutes, but could take approximately 20 - 30 minutes for Azure-SSIS IR joining a virtual network.

    Si vous utilisez SSISDB, le service ADF se connecte à votre serveur de base de données pour préparer SSISDB.If you use SSISDB, ADF service will connect to your database server to prepare SSISDB. Il configure également les autorisations et les paramètres de votre réseau virtuel, s’ils sont spécifiés, et joint votre runtime d’intégration Azure-SSIS au réseau virtuel.It also configures permissions and settings for your virtual network, if specified, and joins your Azure-SSIS IR to the virtual network.

    Quand vous provisionnez un runtime d’intégration Azure-SSIS, les composants Access Redistributable et Azure Feature Pack pour SSIS sont également installés.When you provision an Azure-SSIS IR, Access Redistributable and Azure Feature Pack for SSIS are also installed. Ces composants fournissent la connectivité aux fichiers Excel/Access et à diverses sources de données Azure, en plus des sources de données déjà prises en charge par les composants intégrés.These components provide connectivity to Excel/Access files and various Azure data sources, in addition to the data sources already supported by built-in components. Vous pouvez également installer des composants supplémentaires ; consultez Configuration personnalisée pour Azure-SSIS IR pour en savoir plus.You can also install additional components, see Custom setup for Azure-SSIS IR.

  7. Dans la fenêtre Connexions, basculez vers Runtimes d’intégration si nécessaire.In the Connections window, switch to Integration Runtimes if needed. Cliquez sur Actualiser pour actualiser l’état.Click Refresh to refresh the status.

    État de la création

  8. Utilisez les liens sous la colonne Actions pour arrêter/démarrer, modifier ou supprimer le runtime d’intégration.Use the links under Actions column to stop/start, edit, or delete the integration runtime. Le dernier lien permet d’afficher le code JSON pour le runtime d’intégration.Use the last link to view JSON code for the integration runtime. Les boutons Modifier et Supprimer sont activés uniquement lorsque le runtime d’intégration est arrêté.The edit and delete buttons are enabled only when the IR is stopped.

    Runtime d’intégration Azure SSIS - actions

Runtimes d’intégration Azure SSIS sur le portailAzure SSIS integration runtimes in the portal

  1. Dans l’interface utilisateur de Azure Data Factory, basculez vers l’onglet Modifier, cliquez sur Connexions, puis basculez vers l’onglet Runtimes d’intégration pour afficher les runtimes d’intégration existants dans votre Data Factory.In the Azure Data Factory UI, switch to the Edit tab, click Connections, and then switch to Integration Runtimes tab to view existing integration runtimes in your data factory.

    Afficher les runtimes d’intégration existants

  2. Cliquez sur Nouveau pour créer un nouveau runtime d’intégration Azure SSIS.Click New to create a new Azure-SSIS IR.

    Runtime d’intégration via le menu

  3. Pour créer un runtime d’intégration Azure-SSIS, cliquez sur Nouveau comme indiqué sur l’image.To create an Azure-SSIS integration runtime, click New as shown in the image.

  4. Dans la fenêtre de configuration de runtime d’intégration, sélectionnez Faire une migration lift-and-shift des packages SSIS existants à exécuter dans Azure, puis cliquez sur Suivant.In the Integration Runtime Setup window, select Lift-and-shift existing SSIS packages to execute in Azure, and then click Next.

    Spécifier le type de runtime d’intégration

  5. Consultez la section Approvisionner un runtime d’intégration Azure SSIS pour connaître les autres étapes de configuration d’un runtime d’intégration Azure-SSIS.See the Provision an Azure SSIS integration runtime section for the remaining steps to set up an Azure-SSIS IR.

Azure PowerShellAzure PowerShell

Dans cette section, vous utilisez Azure PowerShell pour créer un runtime d’intégration Azure-SSIS.In this section, you use the Azure PowerShell to create an Azure-SSIS IR.

Créer des variablesCreate variables

Copiez et collez le script suivant. Spécifiez des valeurs pour les variables.Copy and paste the following script - Specify values for the variables.

### Azure Data Factory information
# If your input contains a PSH special character, e.g. "$", precede it with the escape character "`" like "`$"
$SubscriptionName = "[your Azure subscription name]"
$ResourceGroupName = "[your Azure resource group name]"
# Data factory name - Must be globally unique
$DataFactoryName = "[your data factory name]"
# For supported regions, see https://azure.microsoft.com/global-infrastructure/services/?products=data-factory&regions=all
$DataFactoryLocation = "EastUS"

### Azure-SSIS integration runtime information - This is a Data Factory compute resource for running SSIS packages
$AzureSSISName = "[your Azure-SSIS IR name]"
$AzureSSISDescription = "[your Azure-SSIS IR description]"
# For supported regions, see https://azure.microsoft.com/global-infrastructure/services/?products=data-factory&regions=all
$AzureSSISLocation = "EastUS"
# For supported node sizes, see https://azure.microsoft.com/pricing/details/data-factory/ssis/
$AzureSSISNodeSize = "Standard_D8_v3"
# 1-10 nodes are currently supported
$AzureSSISNodeNumber = 2
# Azure-SSIS IR edition/license info: Standard or Enterprise
$AzureSSISEdition = "Standard" # Standard by default, while Enterprise lets you use advanced/premium features on your Azure-SSIS IR
# Azure-SSIS IR hybrid usage info: LicenseIncluded or BasePrice
$AzureSSISLicenseType = "LicenseIncluded" # LicenseIncluded by default, while BasePrice lets you bring your own on-premises SQL Server license with Software Assurance to earn cost savings from Azure Hybrid Benefit (AHB) option
# For a Standard_D1_v2 node, up to 4 parallel executions per node are supported, but for other nodes, up to (2 x number of cores) are currently supported
$AzureSSISMaxParallelExecutionsPerNode = 8
# Custom setup info
$SetupScriptContainerSasUri = "" # OPTIONAL to provide SAS URI of blob container where your custom setup script and its associated files are stored
# Virtual network info: Classic or Azure Resource Manager
$VnetId = "[your virtual network resource ID or leave it empty]" # REQUIRED if you use Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network/on-premises data, Azure Resource Manager virtual network is recommended, Classic virtual network will be deprecated soon
$SubnetName = "[your subnet name or leave it empty]" # WARNING: Please use the same subnet as the one used with your Azure SQL Database server with virtual network service endpoints or a different subnet than the one used for your Managed Instance in a virtual network

### SSISDB info
$SSISDBServerEndpoint = "[your Azure SQL Database server name.database.windows.net or Managed Instance name.DNS prefix.database.windows.net or Managed Instance name.public.DNS prefix.database.windows.net,3342 or leave it empty if you do not use SSISDB]" # WARNING: If you use SSISDB, please ensure that there is no existing SSISDB on your database server, so we can prepare and manage one on your behalf
# Authentication info: SQL or Azure Active Directory (AAD)
$SSISDBServerAdminUserName = "[your server admin username for SQL authentication or leave it empty for AAD authentication]"
$SSISDBServerAdminPassword = "[your server admin password for SQL authentication or leave it empty for AAD authentication]"
# For the basic pricing tier, specify "Basic", not "B" - For standard/premium/elastic pool tiers, specify "S0", "S1", "S2", "S3", etc., see https://docs.microsoft.com/azure/sql-database/sql-database-resource-limits-database-server
$SSISDBPricingTier = "[Basic|S0|S1|S2|S3|S4|S6|S7|S9|S12|P1|P2|P4|P6|P11|P15|…|ELASTIC_POOL(name = <elastic_pool_name>) for Azure SQL Database server or leave it empty for Managed Instance]"

Se connecter et sélectionner un abonnementSign in and select subscription

Ajoutez le code suivant au script pour vous connecter et sélectionner votre abonnement Azure :Add the following code the script to sign in and select your Azure subscription:

Connect-AzAccount
Select-AzSubscription -SubscriptionName $SubscriptionName

Valider la connexion au serveur de base de donnéesValidate the connection to database server

Ajoutez le script suivant pour valider votre serveur Azure SQL Database/Managed Instance.Add the following script to validate your Azure SQL Database server/Managed Instance.

# Validate only if you use SSISDB and do not use VNet or AAD authentication
if(![string]::IsNullOrEmpty($SSISDBServerEndpoint))
{
    if([string]::IsNullOrEmpty($VnetId) -and [string]::IsNullOrEmpty($SubnetName))
    {
        if(![string]::IsNullOrEmpty($SSISDBServerAdminUserName) -and ![string]::IsNullOrEmpty($SSISDBServerAdminPassword))
        {
            $SSISDBConnectionString = "Data Source=" + $SSISDBServerEndpoint + ";User ID=" + $SSISDBServerAdminUserName + ";Password=" + $SSISDBServerAdminPassword
            $sqlConnection = New-Object System.Data.SqlClient.SqlConnection $SSISDBConnectionString;
            Try
            {
                $sqlConnection.Open();
            }
            Catch [System.Data.SqlClient.SqlException]
            {
                Write-Warning "Cannot connect to your Azure SQL Database server, exception: $_";
                Write-Warning "Please make sure the server you specified has already been created. Do you want to proceed? [Y/N]"
                $yn = Read-Host
                if(!($yn -ieq "Y"))
                {
                    Return;
                }
            }
        }
    }
}

Configurer un réseau virtuelConfigure virtual network

Ajoutez le script suivant afin de configurer automatiquement les paramètres/autorisations du réseau virtuel pour le runtime d’intégration Azure-SSIS.Add the following script to automatically configure virtual network permissions/settings for your Azure-SSIS integration runtime to join.

# Make sure to run this script against the subscription to which the virtual network belongs
if(![string]::IsNullOrEmpty($VnetId) -and ![string]::IsNullOrEmpty($SubnetName))
{
    # Register to the Azure Batch resource provider
    $BatchApplicationId = "ddbf3205-c6bd-46ae-8127-60eb93363864"
    $BatchObjectId = (Get-AzADServicePrincipal -ServicePrincipalName $BatchApplicationId).Id
    Register-AzResourceProvider -ProviderNamespace Microsoft.Batch
    while(!(Get-AzResourceProvider -ProviderNamespace "Microsoft.Batch").RegistrationState.Contains("Registered"))
    {
    Start-Sleep -s 10
    }
    if($VnetId -match "/providers/Microsoft.ClassicNetwork/")
    {
        # Assign the VM contributor role to Microsoft.Batch
        New-AzRoleAssignment -ObjectId $BatchObjectId -RoleDefinitionName "Classic Virtual Machine Contributor" -Scope $VnetId
    }
}

Créer un groupe de ressourcesCreate a resource group

Créez un groupe de ressources Azure avec la commande New-AzResourceGroup.Create an Azure resource group using the New-AzResourceGroup command. Un groupe de ressources est un conteneur logique dans lequel les ressources Azure sont déployées et gérées en tant que groupe.A resource group is a logical container into which Azure resources are deployed and managed as a group.

Si votre groupe de ressources existe déjà, ne copiez pas ce code dans votre script.If your resource group already exists, do not copy this code to your script.

New-AzResourceGroup -Location $DataFactoryLocation -Name $ResourceGroupName

Créer une fabrique de donnéesCreate a data factory

Exécutez la commande suivante pour créer la fabrique de données.Run the following command to create a data factory.

Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName `
                         -Location $DataFactoryLocation `
                         -Name $DataFactoryName

Créer un runtime d’intégrationCreate an integration runtime

Exécutez les commandes suivantes pour créer un runtime d’intégration Azure-SSIS qui exécute des packages SSIS dans Azure.Run the following commands to create an Azure-SSIS integration runtime that runs SSIS packages in Azure.

Si vous n’utilisez pas SSISDB, vous pouvez omettre les paramètres CatalogServerEndpoint, CatalogPricingTier et CatalogAdminCredential.If you do not use SSISDB, you can omit CatalogServerEndpoint, CatalogPricingTier, and CatalogAdminCredential parameters.

Si vous n’utilisez pas de serveur Azure SQL Database avec des points de terminaison de service de réseau virtuel/Managed Instance dans un réseau virtuel pour héberger SSISDB ou que vous avez besoin d’accéder à des données locales, vous pouvez omettre les paramètres VNetId et Subnet ou passer des valeurs vides pour eux.If you do not use Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network to host SSISDB or require access to on-premises data, you can omit VNetId and Subnet parameters or pass empty values for them. Dans le cas contraire, vous ne pouvez pas les omettre et vous devez passer les valeurs valides de votre configuration de réseau virtuel, voir Joindre un runtime d'intégration SSIS Azure à un réseau virtuel.Otherwise, you cannot omit them and must pass valid values from your virtual network configuration, see Join Azure-SSIS IR to a virtual network.

Si vous utilisez Managed Instance pour accueillir une base de données SSISDB, vous pouvez omettre le paramètre CatalogPricingTier ou passer une valeur vide pour lui.If you use Managed Instance to host SSISDB, you can omit CatalogPricingTier parameter or pass an empty value for it. Dans le cas contraire, vous ne pouvez pas l’omettre et vous devez passer une valeur valide à partir des niveaux tarifaires pris en charge pour Azure SQL Database, consultez Limites des ressources SQL Database.Otherwise, you cannot omit it and must pass a valid value from the list of supported pricing tiers for Azure SQL Database, see SQL Database resource limits.

Si vous utilisez l’authentification Azure Active Directory (AAD) avec l’identité managée pour que votre ADF se connecte au serveur de base de données, vous pouvez omettre le paramètre CatalogAdminCredential, mais vous devez ajouter l’identité managée de votre ADF à un groupe AAD avec autorisations d’accès au serveur de base de données. Pour cela, consultez Activer l’authentification Azure Active Directory pour Azure-SSIS Integration Runtime.If you use Azure Active Directory (AAD) authentication with the managed identity for your ADF to connect to the database server, you can omit CatalogAdminCredential parameter, but you must add the managed identity for your ADF into an AAD group with access permissions to the database server, see Enable AAD authentication for Azure-SSIS IR. Sinon, vous ne pouvez pas l’omettre et vous devez passer un objet valide formé à partir de votre nom d’utilisateur et mot de passe d’administrateur de serveur pour l’authentification SQL.Otherwise, you cannot omit it and must pass a valid object formed from your server admin username and password for SQL authentication.

Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                           -DataFactoryName $DataFactoryName `
                                           -Name $AzureSSISName `
                                           -Description $AzureSSISDescription `
                                           -Type Managed `
                                           -Location $AzureSSISLocation `
                                           -NodeSize $AzureSSISNodeSize `
                                           -NodeCount $AzureSSISNodeNumber `
                                           -Edition $AzureSSISEdition `
                                           -LicenseType $AzureSSISLicenseType `
                                           -MaxParallelExecutionsPerNode $AzureSSISMaxParallelExecutionsPerNode `
                                           -VnetId $VnetId `
                                           -Subnet $SubnetName
       
# Add CatalogServerEndpoint, CatalogPricingTier, and CatalogAdminCredential parameters if you use SSISDB
if(![string]::IsNullOrEmpty($SSISDBServerEndpoint))
{
    Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                               -DataFactoryName $DataFactoryName `
                                               -Name $AzureSSISName `
                                               -CatalogServerEndpoint $SSISDBServerEndpoint `
                                               -CatalogPricingTier $SSISDBPricingTier

    if(![string]::IsNullOrEmpty($SSISDBServerAdminUserName) –and ![string]::IsNullOrEmpty($SSISDBServerAdminPassword)) # Add CatalogAdminCredential parameter if you do not use AAD authentication
    {
        $secpasswd = ConvertTo-SecureString $SSISDBServerAdminPassword -AsPlainText -Force
        $serverCreds = New-Object System.Management.Automation.PSCredential($SSISDBServerAdminUserName, $secpasswd)

        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                                   -DataFactoryName $DataFactoryName `
                                                   -Name $AzureSSISName `
                                                   -CatalogAdminCredential $serverCreds
    }
}

# Add SetupScriptContainerSasUri parameter if you use custom setup
if(![string]::IsNullOrEmpty($SetupScriptContainerSasUri))
{
    Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                               -DataFactoryName $DataFactoryName `
                                               -Name $AzureSSISName `
                                               -SetupScriptContainerSasUri $SetupScriptContainerSasUri
}

Démarrer le runtime d’intégrationStart integration runtime

Exécutez les commandes suivantes pour démarrer le runtime d’intégration Azure-SSIS.Run the following commands to start the Azure-SSIS integration runtime.

write-host("##### Starting #####")
Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                             -DataFactoryName $DataFactoryName `
                                             -Name $AzureSSISName `
                                             -Force

write-host("##### Completed #####")
write-host("If any cmdlet is unsuccessful, please consider using -Debug option for diagnostics.")

Notes

En dehors des réglages personnalisés, ce processus devrait se terminer dans les 5 minutes. Toutefois, il peut prendre de 20 à 30 minutes environ pour le runtime d’intégration Azure-SSIS se joignant à un réseau virtuel.Excluding any custom setup time, this process should be completed within 5 minutes, but could take approximately 20 - 30 minutes for Azure-SSIS IR joining a virtual network.

Si vous utilisez SSISDB, le service ADF se connecte à votre serveur de base de données pour préparer SSISDB.If you use SSISDB, ADF service will connect to your database server to prepare SSISDB. Il configure également les autorisations et les paramètres de votre réseau virtuel, s’ils sont spécifiés, et joint votre runtime d’intégration Azure-SSIS au réseau virtuel.It also configures permissions and settings for your virtual network, if specified, and joins your Azure-SSIS IR to the virtual network.

Quand vous provisionnez un runtime d’intégration Azure-SSIS, les composants Access Redistributable et Azure Feature Pack pour SSIS sont également installés.When you provision an Azure-SSIS IR, Access Redistributable and Azure Feature Pack for SSIS are also installed. Ces composants fournissent la connectivité aux fichiers Excel/Access et à diverses sources de données Azure, en plus des sources de données déjà prises en charge par les composants intégrés.These components provide connectivity to Excel/Access files and various Azure data sources, in addition to the data sources already supported by built-in components. Vous pouvez également installer des composants supplémentaires ; consultez Configuration personnalisée pour Azure-SSIS IR pour en savoir plus.You can also install additional components, see Custom setup for Azure-SSIS IR.

Script completFull script

Voici le script complet qui crée un runtime d’intégration Azure-SSIS.Here is the full script that creates an Azure-SSIS integration runtime.

### Azure Data Factory information
# If your input contains a PSH special character, e.g. "$", precede it with the escape character "`" like "`$"
$SubscriptionName = "[your Azure subscription name]"
$ResourceGroupName = "[your Azure resource group name]"
# Data factory name - Must be globally unique
$DataFactoryName = "[your data factory name]"
# For supported regions, see https://azure.microsoft.com/global-infrastructure/services/?products=data-factory&regions=all
$DataFactoryLocation = "EastUS"

### Azure-SSIS integration runtime information - This is a Data Factory compute resource for running SSIS packages
$AzureSSISName = "[your Azure-SSIS IR name]"
$AzureSSISDescription = "[your Azure-SSIS IR description]"
# For supported regions, see https://azure.microsoft.com/global-infrastructure/services/?products=data-factory&regions=all
$AzureSSISLocation = "EastUS"
# For supported node sizes, see https://azure.microsoft.com/pricing/details/data-factory/ssis/
$AzureSSISNodeSize = "Standard_D8_v3"
# 1-10 nodes are currently supported
$AzureSSISNodeNumber = 2
# Azure-SSIS IR edition/license info: Standard or Enterprise
$AzureSSISEdition = "Standard" # Standard by default, while Enterprise lets you use advanced/premium features on your Azure-SSIS IR
# Azure-SSIS IR hybrid usage info: LicenseIncluded or BasePrice
$AzureSSISLicenseType = "LicenseIncluded" # LicenseIncluded by default, while BasePrice lets you bring your own on-premises SQL Server license with Software Assurance to earn cost savings from Azure Hybrid Benefit (AHB) option
# For a Standard_D1_v2 node, up to 4 parallel executions per node are supported, but for other nodes, up to (2 x number of cores) are currently supported
$AzureSSISMaxParallelExecutionsPerNode = 8
# Custom setup info
$SetupScriptContainerSasUri = "" # OPTIONAL to provide SAS URI of blob container where your custom setup script and its associated files are stored
# Virtual network info: Classic or Azure Resource Manager
$VnetId = "[your virtual network resource ID or leave it empty]" # REQUIRED if you use Azure SQL Database server with virtual network service endpoints/Managed Instance in a virtual network/on-premises data, Azure Resource Manager virtual network is recommended, Classic virtual network will be deprecated soon
$SubnetName = "[your subnet name or leave it empty]" # WARNING: Please use the same subnet as the one used with your Azure SQL Database server with virtual network service endpoints or a different subnet than the one used for your Managed Instance in a virtual network

### SSISDB info
$SSISDBServerEndpoint = "[your Azure SQL Database server name.database.windows.net or Managed Instance name.DNS prefix.database.windows.net or Managed Instance name.public.DNS prefix.database.windows.net,3342 or leave it empty if you do not use SSISDB]" # WARNING: If you use SSISDB, please ensure that there is no existing SSISDB on your database server, so we can prepare and manage one on your behalf
# Authentication info: SQL or Azure Active Directory (AAD)
$SSISDBServerAdminUserName = "[your server admin username for SQL authentication or leave it empty for AAD authentication]"
$SSISDBServerAdminPassword = "[your server admin password for SQL authentication or leave it empty for AAD authentication]"
# For the basic pricing tier, specify "Basic", not "B" - For standard/premium/elastic pool tiers, specify "S0", "S1", "S2", "S3", etc., see https://docs.microsoft.com/azure/sql-database/sql-database-resource-limits-database-server
$SSISDBPricingTier = "[Basic|S0|S1|S2|S3|S4|S6|S7|S9|S12|P1|P2|P4|P6|P11|P15|…|ELASTIC_POOL(name = <elastic_pool_name>) for Azure SQL Database server or leave it empty for Managed Instance]"

### Sign in and select subscription
Connect-AzAccount
Select-AzSubscription -SubscriptionName $SubscriptionName

### Validate the connection to database server
# Validate only if you use SSISDB and do not use VNet or AAD authentication
if(![string]::IsNullOrEmpty($SSISDBServerEndpoint))
{
    if([string]::IsNullOrEmpty($VnetId) -and [string]::IsNullOrEmpty($SubnetName))
    {
        if(![string]::IsNullOrEmpty($SSISDBServerAdminUserName) -and ![string]::IsNullOrEmpty($SSISDBServerAdminPassword))
        {
            $SSISDBConnectionString = "Data Source=" + $SSISDBServerEndpoint + ";User ID=" + $SSISDBServerAdminUserName + ";Password=" + $SSISDBServerAdminPassword
            $sqlConnection = New-Object System.Data.SqlClient.SqlConnection $SSISDBConnectionString;
            Try
            {
                $sqlConnection.Open();
            }
            Catch [System.Data.SqlClient.SqlException]
            {
                Write-Warning "Cannot connect to your Azure SQL Database server, exception: $_";
                Write-Warning "Please make sure the server you specified has already been created. Do you want to proceed? [Y/N]"
                $yn = Read-Host
                if(!($yn -ieq "Y"))
                {
                    Return;
                }
            }
        }
    }
}

### Configure virtual network
# Make sure to run this script against the subscription to which the virtual network belongs
if(![string]::IsNullOrEmpty($VnetId) -and ![string]::IsNullOrEmpty($SubnetName))
{
    # Register to the Azure Batch resource provider
    $BatchApplicationId = "ddbf3205-c6bd-46ae-8127-60eb93363864"
    $BatchObjectId = (Get-AzADServicePrincipal -ServicePrincipalName $BatchApplicationId).Id
    Register-AzResourceProvider -ProviderNamespace Microsoft.Batch
    while(!(Get-AzResourceProvider -ProviderNamespace "Microsoft.Batch").RegistrationState.Contains("Registered"))
    {
    Start-Sleep -s 10
    }
    if($VnetId -match "/providers/Microsoft.ClassicNetwork/")
    {
        # Assign the VM contributor role to Microsoft.Batch
        New-AzRoleAssignment -ObjectId $BatchObjectId -RoleDefinitionName "Classic Virtual Machine Contributor" -Scope $VnetId
    }
}

### Create a data factory
Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName `
                         -Location $DataFactoryLocation `
                         -Name $DataFactoryName

### Create an integration runtime
Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                           -DataFactoryName $DataFactoryName `
                                           -Name $AzureSSISName `
                                           -Description $AzureSSISDescription `
                                           -Type Managed `
                                           -Location $AzureSSISLocation `
                                           -NodeSize $AzureSSISNodeSize `
                                           -NodeCount $AzureSSISNodeNumber `
                                           -Edition $AzureSSISEdition `
                                           -LicenseType $AzureSSISLicenseType `
                                           -MaxParallelExecutionsPerNode $AzureSSISMaxParallelExecutionsPerNode `
                                           -VnetId $VnetId `
                                           -Subnet $SubnetName
       
# Add CatalogServerEndpoint, CatalogPricingTier, and CatalogAdminCredential parameters if you use SSISDB
if(![string]::IsNullOrEmpty($SSISDBServerEndpoint))
{
    Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                               -DataFactoryName $DataFactoryName `
                                               -Name $AzureSSISName `
                                               -CatalogServerEndpoint $SSISDBServerEndpoint `
                                               -CatalogPricingTier $SSISDBPricingTier

    if(![string]::IsNullOrEmpty($SSISDBServerAdminUserName) –and ![string]::IsNullOrEmpty($SSISDBServerAdminPassword)) # Add CatalogAdminCredential parameter if you do not use AAD authentication
    {
        $secpasswd = ConvertTo-SecureString $SSISDBServerAdminPassword -AsPlainText -Force
        $serverCreds = New-Object System.Management.Automation.PSCredential($SSISDBServerAdminUserName, $secpasswd)

        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                                   -DataFactoryName $DataFactoryName `
                                                   -Name $AzureSSISName `
                                                   -CatalogAdminCredential $serverCreds
    }
}

# Add SetupScriptContainerSasUri parameter when you use custom setup
if(![string]::IsNullOrEmpty($SetupScriptContainerSasUri))
{
    Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                               -DataFactoryName $DataFactoryName `
                                               -Name $AzureSSISName `
                                               -SetupScriptContainerSasUri $SetupScriptContainerSasUri
}

### Start integration runtime
write-host("##### Starting #####")
Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
                                             -DataFactoryName $DataFactoryName `
                                             -Name $AzureSSISName `
                                             -Force

write-host("##### Completed #####")
write-host("If any cmdlet is unsuccessful, please consider using -Debug option for diagnostics.")

Modèle Azure Resource ManagerAzure Resource Manager template

Dans cette section, vous utilisez le modèle Azure Resource Manager pour créer un runtime d’intégration Azure-SSIS.In this section, you use the Azure Resource Manager template to create Azure-SSIS integration runtime. Voici un exemple de procédure :Here is a sample walkthrough:

  1. Créez un fichier JSON avec le modèle Azure Resource Manager suivant.Create a JSON file with the following Azure Resource Manager template. Remplacez les valeurs entre chevrons (espaces réservés) par vos propres valeurs.Replace values in the angled brackets (place holders) with your own values.

    {
      "contentVersion": "1.0.0.0",
        "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
        "parameters": {},
        "variables": {},
        "resources": [{
            "name": "<Specify a name for your data factory>",
            "apiVersion": "2018-06-01",
            "type": "Microsoft.DataFactory/factories",
            "location": "East US",
            "properties": {},
            "resources": [{
                "type": "integrationruntimes",
                "name": "<Specify a name for your Azure-SSIS IR>",
                "dependsOn": [ "<The name of the data factory you specified at the beginning>" ],
                "apiVersion": "2018-06-01",
                "properties": {
                    "type": "Managed",
                    "typeProperties": {
                        "computeProperties": {
                            "location": "East US",
                            "nodeSize": "Standard_D8_v3",
                            "numberOfNodes": 1,
                            "maxParallelExecutionsPerNode": 8
                        },
                        "ssisProperties": {
                            "catalogInfo": {
                                "catalogServerEndpoint": "<Azure SQL Database server name>.database.windows.net",
                                "catalogAdminUserName": "<Azure SQL Database server admin username>",
                                "catalogAdminPassword": {
                                    "type": "SecureString",
                                    "value": "<Azure SQL Database server admin password>"
                                },
                                "catalogPricingTier": "Basic"
                            }
                        }
                    }
                }
            }]
        }]
    }
    
  2. Pour déployer le modèle Azure Resource Manager, exécutez la commande New-AzResourceGroupDeployment comme indiqué dans l’exemple suivant, où ADFTutorialResourceGroup est le nom de votre groupe de ressources et ADFTutorialARM.json est le fichier qui contient la définition JSON de votre fabrique de données et d’Azure-SSIS Integration Runtime.To deploy the Azure Resource Manager template, run New-AzResourceGroupDeployment command as shown in the following example, where ADFTutorialResourceGroup is the name of your resource group and ADFTutorialARM.json is the file that contains JSON definition for your data factory and Azure-SSIS IR.

    New-AzResourceGroupDeployment -Name MyARMDeployment -ResourceGroupName ADFTutorialResourceGroup -TemplateFile ADFTutorialARM.json
    

    Cette commande crée votre fabrique de données et un runtime d’intégration Azure-SSIS dans cette fabrique, mais elle ne démarre pas le runtime d’intégration.This command creates your data factory and Azure-SSIS IR in it, but it does not start the IR.

  3. Pour démarrer Azure-SSIS Runtime Integration, exécutez la commande Start-AzDataFactoryV2IntegrationRuntime :To start your Azure-SSIS IR, run Start-AzDataFactoryV2IntegrationRuntime command:

    Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName "<Resource Group Name>" `
                                                 -DataFactoryName "<Data Factory Name>" `
                                                 -Name "<Azure SSIS IR Name>" `
                                                 -Force
    

Notes

En dehors des réglages personnalisés, ce processus devrait se terminer dans les 5 minutes. Toutefois, il peut prendre de 20 à 30 minutes environ pour le runtime d’intégration Azure-SSIS se joignant à un réseau virtuel.Excluding any custom setup time, this process should be completed within 5 minutes, but could take approximately 20 - 30 minutes for Azure-SSIS IR joining a virtual network.

Si vous utilisez SSISDB, le service ADF se connecte à votre serveur de base de données pour préparer SSISDB.If you use SSISDB, ADF service will connect to your database server to prepare SSISDB. Il configure également les autorisations et les paramètres de votre réseau virtuel, s’ils sont spécifiés, et joint votre runtime d’intégration Azure-SSIS au réseau virtuel.It also configures permissions and settings for your virtual network, if specified, and joins your Azure-SSIS IR to the virtual network.

Quand vous provisionnez un runtime d’intégration Azure-SSIS, les composants Access Redistributable et Azure Feature Pack pour SSIS sont également installés.When you provision an Azure-SSIS IR, Access Redistributable and Azure Feature Pack for SSIS are also installed. Ces composants fournissent la connectivité aux fichiers Excel/Access et à diverses sources de données Azure, en plus des sources de données déjà prises en charge par les composants intégrés.These components provide connectivity to Excel/Access files and various Azure data sources, in addition to the data sources already supported by built-in components. Vous pouvez également installer des composants supplémentaires ; consultez Configuration personnalisée pour Azure-SSIS IR pour en savoir plus.You can also install additional components, see Custom setup for Azure-SSIS IR.

Déployer des packages SSISDeploy SSIS packages

Si vous utilisez SSISDB, vous pouvez déployer vos packages dedans et les exécuter sur le runtime d’intégration Azure-SSIS à l’aide des outils SSDT/SSMS qui se connectent à votre serveur de base de données par le biais de son point de terminaison de serveur.If you use SSISDB, you can deploy your packages into it and run them on Azure-SSIS IR using SSDT/SSMS tools that connect to your database server via its server endpoint. Pour un serveur Azure SQL Database/Managed Instance dans un réseau virtuel/Managed instance avec un point de terminaison public, le format de point de terminaison de serveur est <server name>.database.windows.net/<server name>.<dns prefix>.database.windows.net/<server name>.public.<dns prefix>.database.windows.net,3342, respectivement.For Azure SQL Database server/Managed Instance in a virtual network/Managed instance with a public endpoint, the server endpoint format is <server name>.database.windows.net/<server name>.<dns prefix>.database.windows.net/<server name>.public.<dns prefix>.database.windows.net,3342, respectively. Si vous n’utilisez pas SSISDB, vous pouvez déployer vos packages dans les systèmes de fichiers/partages de fichiers/Azure Files et les exécuter sur le runtime d’intégration Azure-SSIS à l’aide des utilitaires en ligne de commande dtinstall/dtutil/dtexec.If you do not use SSISDB, you can deploy your packages into file systems/file shares/Azure Files and run them on Azure-SSIS IR using dtinstall/dtutil/dtexec command line utilities. Pour plus d’informations, consultez Déployer des packages SSIS.For more information, see Deploy SSIS packages. Dans les deux cas, vous pouvez également exécuter vos packages déployés sur le runtime d’intégration Azure-SSIS à l’aide de l’activité Exécuter le package SSIS dans des pipelines ADF ; consultez Appeler une exécution de package SSIS comme activité ADF de première classe pour en savoir plus.In both cases, you can also run your deployed packages on Azure-SSIS IR using Execute SSIS Package activity in ADF pipelines, see Invoke SSIS package execution as a first-class ADF activity.

Étapes suivantesNext steps

Consultez également d’autres rubriques relatives au runtime d’intégration Azure-SSIS de cette documentation :See also other Azure-SSIS IR topics in this documentation: