Partager via

Outils DevOps autonomes pour SQL Server Integration Services (SSIS)

Les outils SSIS DevOps autonomes fournissent un ensemble d’exécutables pour effectuer des tâches d'ICDC SSIS. Sans dépendance vis-à-vis de l’installation de Visual Studio ou du runtime SSIS, ces exécutables peuvent être facilement intégrés à n’importe quelle plateforme CICD. Les exécutables fournis sont les suivants :

  • SSISBuild.exe: générez des projets SSIS dans un modèle de déploiement de projet ou un modèle de déploiement de package.
  • SSISDeploy.exe: déployez des fichiers ISPAC dans le catalogue SSIS ou des fichiers DTSX et leurs dépendances sur le système de fichiers.

Installation

.NET Framework 4.6.2 ou version ultérieure est requis.

Téléchargez le programme d’installation le plus récent à partir du centre de téléchargement. En outre, le lien de téléchargement direct est disponible pour le script d’automatisation.

Ensuite, installez-le via l'assistant d'installation ou la ligne de commande :

  • Installation avec l’Assistant

Double-cliquez sur le fichier .exe à installer, puis spécifiez un dossier pour extraire les fichiers exécutables et les fichiers de dépendance.

emplacement d’installation

  • Installer via la ligne de commande
SSISDevOpsTools.exe /Q /C /T:<full path>

Ligne de commande d'installation

SSISBuild.exe

Syntaxe

SSISBuild.exe -project|-p:<dtproj file path> [-configuration|-c:<configuration name>] [-projectPassword|-pp:<project password>] [-stripSensitive|-ss] [-output|-o:<output path>] [-log|-l:<log level>[;<log path>]] [-quiet|-q] [-help|-h|-?]

Paramètres

Paramètre Description
-project |-p:<dtproj file path> Chemin du fichier dtproj à générer.
-configuration|-c :<nom de configuration> Nom de la configuration du projet à utiliser pour la compilation. S’il n’est pas fourni, il est défini par défaut sur la première configuration de projet définie dans le fichier dtproj.
-projectPassword|-pp :<mot de passe de projet> Mot de passe du projet SSIS et de ses packages. Cet argument est valide uniquement lorsque le niveau de protection du projet et des packages SSIS est EncryptSensitiveWithPassword ou EncryptAllWithPassword. Pour le modèle de déploiement de package, tous les packages doivent partager le même mot de passe spécifié par cet argument.
-stripSensitive|-ss Convertissez le niveau de protection du projet SSIS en DontSaveSensitive. Lorsque le niveau de protection est EncryptSensitiveWithPassword ou EncryptAllWithPassword, l’argument -projectPassword doit être correctement défini. Cette option est valide uniquement pour le modèle de déploiement de projet.
-output|-o:<output path> Chemin de sortie de l’artefact de build. La valeur de cet argument remplace le chemin de sortie par défaut dans la configuration du projet.
-log|-l:<log level>[;<log path>] Paramètres relatifs aux journaux.
  • niveau de log : seuls les logs avec un niveau de journalisation égal ou supérieur seront consignés dans le fichier de log. Il existe quatre niveaux de journalisation (de faible à élevé) : DIAG, INFO, WRN, ERR. Le niveau de journalisation par défaut est INFO s’il n’est pas spécifié.
  • chemin du journal : chemin du fichier pour stocker les journaux. Le fichier journal ne sera pas généré si le chemin d’accès n’est pas spécifié.
    		•
    -quiet|-q Ne pas afficher les logs dans la sortie standard.
    -help|-h|-? Affichez des informations détaillées sur l’utilisation de cet utilitaire de ligne de commande.

    Exemples

    • Générez un dtproj avec la première configuration de projet définie, et non chiffrée avec mot de passe :

      SSISBuild.exe -p:"C:\projects\demo\demo.dtproj"

    • Générez un dtproj avec la configuration « DevConfiguration », chiffré avec un mot de passe, et déposez les artefacts de build dans un dossier spécifique :

      SSISBuild.exe -p:C:\projects\demo\demo.dtproj -c:DevConfiguration -pp:encryptionpassword -o:D:\folder

    • Générer un dtproj avec la configuration « DevConfiguration », chiffré par mot de passe, en entrelaçant ses données sensibles et le niveau de journalisation DIAG :

      SSISBuild.exe -p:C:\projects\demo\demo.dtproj -c:DevConfiguration -pp:encryptionpassword -ss -l:diag

    SSISDeploy.exe

    Syntaxe

    SSISDeploy.exe -source|-s:<source path> -destination|-d:<type>;<path>[;server] [-authType|-at:<auth type name>] [-connectionStringSuffix|-css:<connection string suffix>] [-projectPassword|-pp:<project password>] [-username|-u:<username>] [-password|-p:<password>] [-log|-l:<log level>[;<log path>]] [-quiet|-q] [-help|-h|-?]

    Paramètres

    Paramètre Description
    -source|-s:<source path> Chemin de fichier local des artefacts à déployer. ISPAC, DTSX, chemin d’accès du dossier pour DTSX, SSISDeploymentManifest sont autorisés.
    -destination|-d:<type>;<path>[;server] Type de destination, chemin du dossier de destination et nom du serveur du catalogue SSIS dans lequel le fichier source sera déployé. Actuellement, nous prenons en charge les deux types de destination suivants :
  • CATALOG: déployez des fichiers ISPAC uniques ou multiples dans le catalogue SSIS spécifié. Le chemin d’accès de la destination CATALOG doit être au format suivant :
    /SSISDB/<nom du dossier>[/<nom du projet>]
    Le nom de projet facultatif <> n’est valide que lorsque la source spécifie un chemin de fichier ISPAC unique. Le nom du serveur doit être spécifié pour la destination CATALOG.
  • FILE: déployez des packages ou des fichiers SSIS spécifiés dans un ou plusieurs fichiers SSISDeploymentManifest dans le chemin d’accès spécifié du système de fichiers. Le chemin d’accès de la destination FILE peut être un chemin d’accès de dossier local ou un chemin d’accès de dossier réseau au format suivant :
    \\<nom de l’ordinateur>\<nom du dossier>[\<nom du sous-dossier>...]
    		•
    -authType|-at :<nom de type d’authentification> Type d’authentification pour accéder à SQL Server. Obligatoire pour la destination CATALOG. Les types suivants sont pris en charge :
  • WIN : Authentification Windows
  • SQL : Authentification du serveur SQL
  • ADPWD : Active Directory - Mot de passe
  • ADINT : Active Directory - Intégré
    		•
    -connectionStringSuffix|-css:<connection string suffix> Suffixe de la chaîne de connexion, utilisée pour se connecter au catalogue SSIS.
    -projectPassword|-pp :<mot de passe de projet> Mot de passe pour déchiffrer les fichiers ISPAC ou DTSX.
    -username|-u :<nom d’utilisateur> Nom d’utilisateur pour accéder au catalogue SSIS ou au système de fichiers spécifié. Le préfixe avec le nom de domaine est autorisé pour l’accès au système de fichiers.
    -password|-p :<mot de passe> Mot de passe pour accéder au catalogue SSIS ou au système de fichiers spécifié.
    -log|-l:<log level>[;<log path>] Journaliser les paramètres associés à l’exécution de cet utilitaire.
  • Niveau de log : seuls les logs avec un niveau de journalisation égal ou supérieur seront écrits dans le fichier de log. Il existe quatre niveaux de journalisation (de faible à élevé) : DIAG, INFO, WRN, ERR. Le niveau de journalisation par défaut est INFO s’il n’est pas spécifié.
  • chemin du journal : chemin du fichier pour stocker les journaux. Le fichier journal ne sera pas généré si le chemin d’accès n’est pas spécifié.
    		•
    -quiet|-q N’affichez pas les journaux d’activité dans la sortie standard.
    -help|-h|-? Affichez des informations détaillées sur l’utilisation de cet utilitaire de ligne de commande.

    Exemples

    • Déployez un ISPAC unique non chiffré avec mot de passe dans le catalogue SSIS avec l’authentification Windows.

      SSISDeploy.exe -s:D:\myfolder\demo.ispac -d:catalog;/SSISDB/destfolder;myssisserver -at:win

    • Déployez un seul ISPAC chiffré avec mot de passe dans le catalogue SSIS avec l’authentification SQL et renommez le nom du projet.

      SSISDeploy.exe -s:D:\myfolder\test.ispac -d:catalog;/SSISDB/folder/testproj;myssisserver -at:sql -u:sqlusername -p:sqlpassword -pp:encryptionpassword

    • Déployez un seul SSISDeploymentManifest et ses fichiers associés sur le partage de fichiers Azure.

      SSISDeploy.exe -s:D:\myfolder\mypackage.SSISDeploymentManifest -d:file;\\myssisshare.file.core.windows.net\destfolder -u:Azure\myssisshare -p:storagekey

    • Déployez un dossier de fichiers DTSX sur le système de fichiers local.

      SSISDeploy.exe -s:D:\myfolder -d:file;\\myssisshare\destfolder

    Notes de publication

    Version 1.0.0.0

    Date de publication : 1er septembre 2021

    • Version de disponibilité générale (GA).

    Version 0.1.3.1 Preview

    Date de publication : 10 juin 2021

    • Correction d’un problème où SSISDeploy.exe n’a pas réussi à déployer des projets SSIS en raison de l’erreur « Exception non gérée : System.IO.FileLoadException : Impossible de charger le fichier ou l’assembly « Microsoft.SqlServer.IntegrationServices.ProjectDeployment, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35 » ou l’une de ses dépendances. Échec de la validation de nom fort. (Exception de HRESULT : 0x8013141A) ---> System.Security.SecurityException : La validation de nom fort a échoué. (Exception de HRESULT : 0x8013141A)".

    Version 0.1.3 Aperçu

    Date de publication : 2 juin 2021

    • Correction d’un problème où « SSISBuild.exe » échouait à générer des projets avec l’erreur « Échec de la vérification de cohérence du projet ». Les incohérences suivantes ont été détectées » lorsque le nom du package dans le projet contient des caractères spéciaux.
    • Correction d’un problème entraînant l'échec de la construction des projets par SSISBUild.exe en cas d’incompatibilité entre le nom dans dtproj et le nom de fichier.
    • Correction d’un problème qui empêchait SSISBuild.exe de construire des projets avec le niveau de protection encryptSensitiveWithPassword/EncryptAllWithPassword lorsque le projet cible SQL Server 2016.

    Version 0.1.2 Aperçu

    Date de publication : 14 janvier 2021

    • Correction d’un problème qui provoquait l’échec de la génération du projet par SSISBuild.exe, avec l’exception NullReference, lorsque les métadonnées de paramètre du package dans le fichier projet SSIS et le package SSIS ne correspondaient pas.
    • Correction d’un problème d’exécution du package avec une erreur commençant par « Échec du déchiffrement du nœud XML protégé » alors que le package est déployé avec succès sur SSISDB avec SSISDeploy.exe, lorsque le projet SSIS contenant le package est chiffré avec EncryptSensitiveWithUserKey et que le package contient cm avec des données sensibles.

    Version 0.1.1 Aperçu

    Date de publication : 11 novembre 2020

    • Correction d’un problème où SSISDeploy.exe échoue à charger une assembly lors du déploiement d’ispac dans le catalogue SSIS.

    Version 0.1.0 Preview

    Date de publication : 16 octobre 2020

    Première version préliminaire autonome de SSIS DevOps Tools.

    Étapes suivantes

    • Obtenez les outils SSIS DevOps autonomes
    • Si vous avez des questions, visitez Q&A