Partager via


SqlDacpacDeploymentOnMachineGroup@0 - SQL Server tâche de déploiement de base de données v0

Utilisez cette tâche pour déployer une base de données SQL Server à l’aide de scripts DACPAC ou SQL.

Syntax

# This task is supported on classic release pipelines only.
# Use the classic designer to add and configure this task in a classic release pipeline.
# See the following Inputs section for details on the inputs that this task supports.

Entrées

TaskType - Déployer SQL à l’aide de
string. Obligatoire. Valeurs autorisées : dacpac (Sql Dacpac), sqlQuery (Fichier de requête Sql), sqlInline (Sql Inline). Valeur par défaut : dacpac.

Spécifie la façon dont vous souhaitez déployer la base de données : à l’aide de Dacpac ou de scripts SQL.


DacpacFile - Fichier DACPAC
string. Obligatoire quand TaskType = dacpac.

Spécifie l’emplacement du fichier DACPAC sur les ordinateurs cibles ou sur un chemin UNC, comme \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Le chemin d’accès UNC doit être accessible au compte d’administrateur de l’ordinateur. Les variables d’environnement sont également prises en charge, comme $env:windir, $env:systemrootou $env:windir\FabrikamFibre\DB. Des caractères génériques peuvent être utilisés. Par exemple, **/*.dacpac pour le fichier DACPAC présent dans tous les sous-dossiers.


SqlFile - Fichier Sql
string. Obligatoire quand TaskType = sqlQuery.

Spécifie l’emplacement du fichier SQL sur la cible. Fournissez une liste séparée par des points-virgules de fichiers de script SQL pour exécuter plusieurs fichiers. Les scripts SQL sont exécutés dans l’ordre indiqué. L’emplacement peut également être un chemin UNC, comme \\BudgetIT\Web\Deploy\FabrikamDB.sql. Le chemin d’accès UNC doit être accessible au compte d’administrateur de l’ordinateur. Les variables d’environnement sont également prises en charge, comme $env:windir, $env:systemrootou $env:windir\FabrikamFibre\DB. Des caractères génériques peuvent être utilisés. Par exemple, **/*.sql pour le fichier SQL présent dans tous les sous-dossiers.


ExecuteInTransaction - Exécuter dans une transaction
boolean. facultatif. Utilisez quand TaskType = sqlQuery. Valeur par défaut : false.

Exécute le ou les scripts SQL dans une transaction.


ExclusiveLock - Acquérir un verrou d’application exclusif lors de l’exécution du ou des scripts
boolean. facultatif. Utilisez quand ExecuteInTransaction = true. Valeur par défaut : false.

Acquiert un verrou d’application exclusif lors de l’exécution du ou des scripts.


AppLockName - Nom du verrou d’application
string. Obligatoire quand ExclusiveLock = true.

Spécifie le nom du verrou d’application.


InlineSql - Inline Sql
string. Obligatoire quand TaskType = sqlInline.

Spécifie les requêtes SQL inline.


TargetMethod - Spécifier SQL à l’aide de
string. Obligatoire quand TaskType = dacpac. Valeurs autorisées : server, connectionString (chaîne de connexion), publishProfile (profil de publication). Valeur par défaut : server.

Spécifie l’option permettant de se connecter à la base de données SQL Server cible. Vous pouvez fournir les détails de la base de données SQL Server, la chaîne de connexion SQL Server ou le fichier XML du profil de publication.


ServerName - Nom du serveur
string. Obligatoire quand TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline. Valeur par défaut : localhost.

Spécifie le nom SQL Server, comme machinename\FabriakmSQL,1433, localhostou .\SQL2012R2. Si vous spécifiezlocalhost, vous vous connecterez à l’instance de SQL Server par défaut sur l’ordinateur.


DatabaseName - Nom de la base de données
string. Obligatoire quand TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline.

Spécifie le nom de la base de données SQL Server.


AuthScheme - Authentification
string. Obligatoire quand TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline. Valeurs autorisées : windowsAuthentication (Authentification Windows), sqlServerAuthentication (Authentification SQL Server). Valeur par défaut : windowsAuthentication.

Spécifie le mode d’authentification pour la connexion au SQL Server. En mode Authentification Windows, le compte utilisé pour configurer l’agent de déploiement est utilisé pour se connecter à l’SQL Server. Dans SQL Server mode d’authentification, la connexion ET le mot de passe SQL doivent être fournis dans les paramètres ci-dessous.


SqlUsername - Nom d’utilisateur SQL
string. Obligatoire quand AuthScheme = sqlServerAuthentication.

Spécifie la connexion SQL pour se connecter au SQL Server. Cette option est disponible uniquement si SQL Server mode d’authentification a été sélectionné.


SqlPassword - Mot de passe SQL
string. Obligatoire quand AuthScheme = sqlServerAuthentication.

Spécifie le mot de passe de la connexion SQL. Cette option est disponible uniquement si SQL Server mode d’authentification a été sélectionné.


ConnectionString - Chaîne de connexion
string. Obligatoire quand TargetMethod = connectionString.

Spécifie la chaîne de connexion SQL Server, comme Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.


PublishProfile - Publier un profil
string. facultatif. Utilisez quand TaskType = dacpac.

Fournit un contrôle précis sur SQL Server déploiements de base de données.
Spécifie le chemin d’accès au fichier XML de profil de publication sur l’ordinateur cible ou sur un partage UNC accessible par les informations d’identification de l’administrateur de l’ordinateur.


AdditionalArguments - Arguments supplémentaires
string. facultatif. Utilisez quand TaskType = dacpac.

Spécifie des arguments supplémentaires SqlPackage.exe qui seront appliqués lors du déploiement de la base de données SQL Server, comme /p:IgnoreAnsiNulls=True ou /p:IgnoreComments=True. Ces arguments remplacent les paramètres dans le fichier XML du profil de publication (s’ils sont fournis).


AdditionalArgumentsSql - Arguments supplémentaires
string. facultatif. Utilisez quand TaskType = sqlQuery || TaskType = sqlInline.

Spécifie des arguments supplémentaires Invoke-Sqlcmd qui sont appliqués lors du déploiement de la base de données SQL Server.


Options de contrôle des tâches

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Spécifications

Condition requise Description
Types de pipelines Version classique
S’exécute sur Agent, DeploymentGroup
Demandes Aucun
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande Quelconque
Variables paramétrables Quelconque
Version de l’agent 1.102.0 ou version ultérieure
Catégorie de la tâche Déployer
Condition requise Description
Types de pipelines Version classique
S’exécute sur DeploymentGroup
Demandes Aucun
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande Quelconque
Variables paramétrables Quelconque
Version de l’agent 1.102.0 ou version ultérieure
Catégorie de la tâche Déployer