Partager via

Déployer un projet SSIS à partir de Visual Studio Code avec Transact-SQL

  • Article

S’applique à : SQL Server SSIS Integration Runtime dans Azure Data Factory

Ce guide de démarrage rapide montre comment utiliser Visual Studio Code pour se connecter à la base de données du catalogue SSIS, puis utiliser des instructions Transact-SQL pour déployer un projet SSIS dans le catalogue SSIS.

Visual Studio Code est un éditeur de code pour Windows, macOS et Linux qui prend en charge les extensions, notamment l’extension mssql pour la connexion à Microsoft SQL Server, à Azure SQL Database et à Azure Synapse Analytics. Pour plus d’informations sur VS Code, consultez Visual Studio Code.

Prérequis

Avant de commencer, vérifiez que vous avez installé la dernière version de Visual Studio Code et chargé l’extension mssql. Pour télécharger ces outils, consultez les pages suivantes :

Plateformes prises en charge

Vous pouvez utiliser les informations de ce guide de démarrage rapide pour déployer un projet SSIS sur les plateformes suivantes :

  • SQL Server sur Windows.

Vous ne pouvez pas utiliser les informations de ce guide de démarrage rapide pour déployer un package SSIS sur Azure SQL Database. La procédure stockée catalog.deploy_project attend le chemin du fichier .ispac dans le système de fichiers local. Pour plus d’informations sur le déploiement et l’exécution de packages dans Azure, consultez Effectuer un « lift-and-shift » des charges de travail SQL Server Integration Services vers le cloud.

Vous ne pouvez pas utiliser les informations de ce guide de démarrage rapide pour déployer un package SSIS sur SQL Server sur Linux. Pour plus d’informations sur l’exécution de packages sur Linux, consultez Extraire, transformer et charger des données sur Linux avec SSIS.

Définir SQL comme mode de langage dans VS Code

Pour activer les commandes mssql et T-SQL IntelliSense, définissez SQL comme mode de langage dans Visual Studio Code.

  1. Ouvrez Visual Studio Code, puis ouvrez une nouvelle fenêtre.

  2. Cliquez sur Texte brut dans le coin inférieur droit de la barre d’état.

  3. Dans le menu déroulant Sélectionner le mode de langage qui s’affiche, sélectionnez ou entrez SQL, puis appuyez sur Entrée pour définir SQL comme mode de langage.

Méthode d’authentification prise en charge

Consultez Méthodes d’authentification pour le déploiement.

Se connecter à la base de données du catalogue SSIS

Utilisez Visual Studio Code pour établir une connexion au catalogue SSIS.

  1. Dans VS Code, appuyez sur CTRL+MAJ+P (ou F1) pour ouvrir la Palette de commandes.

  2. Tapez sqlcon, puis appuyez sur ENTRÉE.

  3. Appuyez sur ENTRÉE pour sélectionner Créer un profil de connexion. Cette étape crée un profil de connexion pour votre instance de SQL Server.

  4. Suivez les invites pour spécifier les propriétés de connexion de ce nouveau profil de connexion. Après avoir spécifié chaque valeur, appuyez sur ENTRÉE pour continuer.

    Paramètre Valeur suggérée En savoir plus
    Nom du serveur Nom complet du serveur
    Nom de la base de données SSISDB Nom de la base de données à laquelle se connecter.
    Authentification Connexion SQL
    Nom d’utilisateur Compte d’administrateur de serveur Il s’agit du compte que vous avez spécifié quand vous avez créé le serveur.
    Mot de passe (connexion SQL) Mot de passe de votre compte d’administrateur de serveur Il s’agit du mot de passe que vous avez spécifié quand vous avez créé le serveur.
    Enregistrer le mot de passe ? Oui ou Non Si vous ne souhaitez pas entrer le mot de passe à chaque fois, sélectionnez Oui.
    Entrez un nom pour ce profil Nom d’un profil, tel que mySSISServer Un nom de profil enregistré permet d’accélérer votre connexion lors des connexions suivantes.

  5. Appuyez sur la touche ÉCHAP pour fermer le message d’information qui vous informe que le profil est créé et connecté.

  6. Vérifiez votre connexion dans la barre d’état.

Exécuter le code T-SQL

Exécutez le code Transact-SQL suivant pour déployer un projet SSIS.

  1. Dans la fenêtre Éditeur, entrez la requête suivante dans la fenêtre de requête vide.

  2. Mettez à jour les valeurs de paramètres dans la procédure stockée catalog.deploy_project pour votre système.

  3. Appuyez sur Ctrl+Maj+E pour exécuter le code et déployer le projet.

DECLARE @ProjectBinary AS varbinary(max)
DECLARE @operation_id AS bigint
SET @ProjectBinary = (SELECT * FROM OPENROWSET(BULK '<project_file_path>.ispac', SINGLE_BLOB) AS BinaryData)

EXEC catalog.deploy_project @folder_name = '<target_folder>',
    @project_name = '<project_name',
    @Project_Stream = @ProjectBinary,
    @operation_id = @operation_id out

Étapes suivantes