SqlServerDacpacDeployment@1 - SQL Server tâche de déploiement de base de données (déconseillée) v1

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

Important

Cette tâche est déconseillée et sera mise hors service le 31 janvier 2024. Utiliser le déploiement d’applications web IIS à l’aide de WinRM - Place de marché Viual Studio.

Syntax

# SQL Server database deploy (Deprecated) v1
# Deploy a SQL Server database using DACPAC.
- task: SqlServerDacpacDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    DacpacFile: # string. Required. DACPAC File. 
  # Target
    TargetMethod: 'server' # 'server' | 'connectionString' | 'publishProfile'. Required. Specify SQL Using. Default: server.
    ServerName: 'localhost' # string. Required when TargetMethod = server. Server Name. Default: localhost.
    DatabaseName: # string. Required when TargetMethod = server. Database Name. 
    #SqlUsername: # string. Optional. Use when TargetMethod = server. SQL Username. 
    #SqlPassword: # string. Optional. Use when TargetMethod = server. SQL Password. 
    #ConnectionString: # string. Required when TargetMethod = connectionString. Connection String. 
    #PublishProfile: # string. Publish Profile. 
    #AdditionalArguments: # string. Additional Arguments. 
  # Advanced
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

Entrées

EnvironmentName - Machines
string. Obligatoire.

Spécifie une liste séparée par des virgules d’adresses IP ou de noms de domaine complets de l’ordinateur, ainsi que des ports. Le port par défaut est basé sur le protocole sélectionné. Par exemple : dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 des variables de sortie d’autres tâches peuvent également être fournies, par exemple $(variableName).

AdminUserName - Connexion administrateur
string.

Spécifie la connexion administrateur pour les ordinateurs cibles.

AdminPassword - Mot de passe
string.

Spécifie le mot de passe administrateur pour les machines cibles. Les variables définies dans les définitions de build ou de mise en production sont acceptées en tant que $(passwordVariable). Vous pouvez marquer le type de variable comme secret pour le sécuriser.

Protocol - Protocole
string. Valeurs autorisées : Http, Https.

Spécifie le protocole à utiliser pour la connexion WinRM avec la ou les machines. La valeur par défaut est HTTPS.

TestCertificate - Certificat de test
boolean. facultatif. Utilisez quand Protocol = Https. Valeur par défaut : true.

Ignore la validation d’authenticité du certificat de la machine par une autorité de certification approuvée. Le paramètre est requis pour le protocole HTTPS WinRM.

DacpacFile - Fichier DACPAC
string. Obligatoire.

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:systemrootet $env:windir\FabrikamFibre\Web.

TargetMethod - Spécifier SQL à l’aide de
string. Obligatoire. 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 SQL Server détails de base de données, un SQL Server chaîne de connexion ou un fichier XML de profil de publication.

ServerName - Nom du serveur
string. Nécessaire lorsque TargetMethod = server. Valeur par défaut : localhost.

Spécifie le nom SQL Server, comme machinename\FabriakmSQL,1433 ou ou localhost.\SQL2012R2. La spécification se localhost connecte à la SQL Server instance par défaut sur l’ordinateur.

DatabaseName - Nom de la base de données
string. Nécessaire lorsque TargetMethod = server.

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

SqlUsername - Nom d’utilisateur SQL
string. facultatif. Utilisez quand TargetMethod = server.

Si la connexion SQL Server est spécifiée, elle est utilisée pour se connecter au SQL Server. La valeur par défaut, l’authentification intégrée, utilise les informations d’identification de l’administrateur de la machine.

SqlPassword - Mot de passe SQL
string. facultatif. Utilisez quand TargetMethod = server.

Si le nom d’utilisateur de connexion SQL Server est spécifié, indiquez le mot de passe SQL Server. La valeur par défaut, l’authentification intégrée, utilise les informations d’identification de l’administrateur de la machine.

ConnectionString - Chaîne de connexion
string. Nécessaire lorsque TargetMethod = connectionString.

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

PublishProfile - Publier un profil
string.

Fournit un contrôle précis sur SQL Server création ou mise à niveau de bases 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.

Spécifie des arguments supplémentaires SqlPackage.exe qui sont appliqués lors de la création ou de la mise à jour 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 (le cas échéant).

DeployInParallel - Déployer en parallèle
boolean. Valeur par défaut : true.

Quand la valeur est définie truesur , exécute la tâche de déploiement de base de données en parallèle sur les machines cibles.

ResourceFilteringMethod - Sélectionner les machines par
string. Valeurs autorisées : machineNames (Noms des ordinateurs), tags. Valeur par défaut : machineNames.

facultatif. Spécifie un sous-ensemble de machines en fournissant des noms ou des balises de machine.

MachineFilter - Déployer sur des machines
string.

Cette entrée est uniquement valide pour les groupes d’ordinateurs et n’est pas encore prise en charge pour une liste plate de machines ou de variables de sortie.
Spécifie une liste d’ordinateurs, comme dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34, ou des balises, comme Role:DB; OS:Win8.1. Si plusieurs balises sont fournies, la tâche s’exécute sur tous les ordinateurs avec les balises spécifiées. Pour groupes de ressources Azure, indiquez le nom de la machine virtuelle, par exemple ffweb ou ffdb. La valeur par défaut exécute la tâche sur tous les ordinateurs.

Options de contrôle de la tâche

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.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
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.96.2 ou version ultérieure
Catégorie de la tâche	Déployer