catalog.deploy_project (base de données SSISDB)

  • Article

Déploie un projet dans un dossier dans le catalogue Integration Services ou met à jour un projet existant qui a été déployé précédemment.

Syntaxe

deploy_project [ @folder_name = ] folder_name 
      , [ @project_name = ] project_name 
      , [ @project_stream = ] projectstream 
    [ , [@operation_id ] = operation_id OUTPUT ]

Arguments

  • [ @folder\_name = ] folder_name
    Nom du dossier où le projet sera déployé. folder_name est nvarchar(128).

  • [ @project\_name = ] project_name
    Nom du nouveau projet ou du projet mis à jour dans le dossier. project_name est nvarchar(128).

  • [@ projectstream =] projectstream
    Contenu binaire du fichier de déploiement d'un projet Integration Services (extension .ispac).

    Vous pouvez utiliser une instruction SELECT avec la fonction OPENROWSET et le fournisseur d'ensembles de lignes BULK pour récupérer le contenu binaire du fichier. Pour un exemple, consultez Déployer et exécuter des packages SSIS à l'aide de procédures stockées. Pour plus d'informations sur OPENROWSET, consultez OPENROWSET (Transact-SQL).

    Le paramètre projectstream est de type varbinary(MAX).

  • [ @operation\_id = ] operation_id
    Retourne l'identificateur unique de l'opération de déploiement. operation_id est bigint.

Valeurs des codes de retour

0 (succès)

Jeux de résultats

Aucun

Autorisations

Cette procédure stockée requiert l'une des autorisations suivantes :

  • Autorisations CREATE_OBJECTS sur le dossier pour déployer un nouveau projet ou des autorisations MODIFY sur le projet pour mettre à jour un projet

  • Appartenance au rôle de base de données ssis_admin

  • Appartenance au rôle de serveur sysadmin

Erreurs et avertissements

La liste suivante décrit quelques conditions qui peuvent générer une erreur de cette procédure stockée :

  • Un paramètre fait référence à un objet qui n'existe pas, un paramètre essaie de créer un objet qui existe déjà, ou un paramètre n'est pas valide d'une autre manière

  • La valeur du paramètre @project\_name ne correspond pas au nom du projet dans le fichier de déploiement

  • L'utilisateur n'a pas des autorisations suffisantes.

Notes

Pendant un déploiement ou une mise à jour de projet, la procédure stockée ne vérifie pas le niveau de protection des packages individuels dans le projet.