SqlAzureDacpacDeployment@1 - Tâche de déploiement d’Azure SQL Database v1

Utilisez cette tâche pour déployer une base de données Azure SQL à l’aide de DACPAC ou exécuter des scripts à l’aide de SQLCMD.

Syntaxe

# Azure SQL Database deployment v1
# Deploy an Azure SQL Database using DACPAC or run scripts using SQLCMD.
- task: SqlAzureDacpacDeployment@1
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Service Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
  # SQL Database
    AuthenticationType: 'server' # 'server' | 'aadAuthenticationPassword' | 'aadAuthenticationIntegrated' | 'connectionString' | 'servicePrincipal'. Required. Authentication Type. Default: server.
    #ServerName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Azure SQL Server. 
    #DatabaseName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Database. 
    SqlUsername: # string. Required when AuthenticationType = server. Login. 
    SqlPassword: # string. Required when AuthenticationType = server. Password. 
    #aadSqlUsername: # string. Required when AuthenticationType = aadAuthenticationPassword. Login. 
    #aadSqlPassword: # string. Required when AuthenticationType = aadAuthenticationPassword. Password. 
    #ConnectionString: # string. Required when AuthenticationType = connectionString. Connection String. 
  # Deployment Package
    deployType: 'DacpacTask' # 'DacpacTask' | 'SqlTask' | 'InlineSqlTask'. Alias: TaskNameSelector. Required. Deploy type. Default: DacpacTask.
    DeploymentAction: 'Publish' # 'Publish' | 'Extract' | 'Export' | 'Import' | 'Script' | 'DriftReport' | 'DeployReport'. Required when TaskNameSelector = DacpacTask. Action. Default: Publish.
    #DacpacFile: # string. Required when DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport. DACPAC File. 
    #BacpacFile: # string. Required when DeploymentAction = Import. BACPAC File. 
    #SqlFile: # string. Required when TaskNameSelector = SqlTask. SQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline SQL Script. 
    #PublishProfile: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport. Publish Profile. 
    #AdditionalArguments: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport. Additional SqlPackage.exe Arguments. 
    #SqlAdditionalArguments: # string. Optional. Use when TaskNameSelector = SqlTask. Additional Invoke-Sqlcmd Arguments. 
    #InlineAdditionalArguments: # string. Optional. Use when TaskNameSelector = InlineSqlTask. Additional Invoke-Sqlcmd Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

Entrées

azureConnectionType - type de connexion de service Azure
Alias d’entrée : ConnectedServiceNameSelector. string. Valeurs autorisées : ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valeur par défaut : ConnectedServiceNameARM.

azureClassicSubscription - d’abonnement Azure Classic
Alias d’entrée : ConnectedServiceName. string. Obligatoire lorsque ConnectedServiceNameSelector = ConnectedServiceName.

Spécifie l’abonnement Azure Classic cible pour le déploiement de fichiers SQL.

azureSubscription - abonnement Azure
Alias d’entrée : ConnectedServiceNameARM. string. Obligatoire lorsque ConnectedServiceNameSelector = ConnectedServiceNameARM.

Spécifie l’abonnement Azure Resource Manager cible pour le déploiement de fichiers SQL.

AuthenticationType - Type d’authentification
string. Obligatoire. Valeurs autorisées : server (Authentification SQL Server), aadAuthenticationPassword (Active Directory - Mot de passe), aadAuthenticationIntegrated (Active Directory - Intégré), connectionString (chaîne de connexion), servicePrincipal (principal de service). Valeur par défaut : server.

Spécifie le type d'authentification de la base de données. Il peut s’agir d’un serveur SQL Server, d’Active Directory (intégré), d’Active Directory (mot de passe), d’une chaîne de connexion ou d’une authentification par principal de service. L’authentification intégrée signifie que l’agent accède à la base de données à l’aide de son contexte de compte Active Directory actuel.

Spécifiez l’option permettant de se connecter à la base de données Azure SQL Server. Vous pouvez fournir les détails de la base de données Azure SQL Server, la chaîne de connexion SQL Server, l’authentification AD (mot de passe ou intégré) ou utiliser un principal de service. Pour l’authentification SQL Server, utilisez les informations d’identification de l’utilisateur de SQL Server. Pour l’authentification AD, utilisez les informations d’identification de l’utilisateur AD configuré sur SQL Server.

ServerName - Azure SQL Server
string. Obligatoire lorsque AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Spécifie le nom d’Azure SQL Server, tel que Fabrikam.database.windows.net.placeholder,1433 ou Fabrikam.database.windows.net.placeholder.

DatabaseName - base de données
string. Obligatoire lorsque AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Spécifie le nom de la base de données Azure SQL dans laquelle les fichiers sont déployés.

SqlUsername - connexion
string. Obligatoire lorsque AuthenticationType = server.

Spécifie la connexion de l’administrateur Azure SQL Server.

SqlPassword - mot de passe
string. Obligatoire lorsque AuthenticationType = server.

Spécifie le mot de passe de l’administrateur Azure SQL Server. Les variables définies dans les pipelines de build ou de mise en production comme $(passwordVariable) sont acceptées. Vous pouvez marquer le type de variable comme secret pour le sécuriser.

aadSqlUsername - connexion
string. Obligatoire lorsque AuthenticationType = aadAuthenticationPassword.

Spécifie le nom d’utilisateur Active Directory.

aadSqlPassword - mot de passe
string. Obligatoire lorsque AuthenticationType = aadAuthenticationPassword.

Spécifie le mot de passe de l’utilisateur Active Directory. Les variables définies dans les pipelines de build ou de mise en production comme $(passwordVariable) sont acceptées. Vous pouvez marquer le type de variable comme secret pour le sécuriser.

ConnectionString - chaîne de connexion
string. Obligatoire lorsque AuthenticationType = connectionString.

Spécifie la chaîne de connexion Azure SQL Server, telle que Server=testServer.database.windows.net.placeholder;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Déployer le type
Alias d’entrée : TaskNameSelector. string. Obligatoire. Valeurs autorisées : DacpacTask (fichier SQL DACPAC), SqlTask (fichier de script SQL), InlineSqlTask (script SQL inline). Valeur par défaut : DacpacTask.

DeploymentAction - action
string. Obligatoire lorsque TaskNameSelector = DacpacTask. Valeurs autorisées : Publish, Extract, Export, Import, Script, DriftReport (Rapport de dérive), DeployReport (Déployer le rapport). Valeur par défaut : Publish.

Spécifie l’une des actions SQL de la liste. En savoir plus sur la liste des actions SQL .

DacpacFile - fichier DACPAC
string. Obligatoire lorsque DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Spécifie l’emplacement du fichier DACPAC sur l’agent Automation ou sur un chemin UNC accessible à l’agent Automation, comme \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Les variables système prédéfinies, telles que $(agent.releaseDirectory), peuvent également être utilisées.

BacpacFile - fichier BACPAC
string. Obligatoire lorsque DeploymentAction = Import.

Spécifie l’emplacement du fichier BACPAC sur l’agent Automation ou sur un chemin UNC accessible à l’agent Automation, comme \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Les variables système prédéfinies, telles que $(agent.releaseDirectory), peuvent également être utilisées.

SqlFile - de script SQL
string. Obligatoire lorsque TaskNameSelector = SqlTask.

Spécifie l’emplacement du fichier de script SQL sur l’agent Automation ou sur un chemin UNC accessible à l’agent Automation, comme \\BudgetIT\Web\Deploy\FabrikamDB.sql. Les variables système prédéfinies, telles que $(agent.releaseDirectory), peuvent également être utilisées.

SqlInline - script SQL inline
string. Obligatoire lorsque TaskNameSelector = InlineSqlTask.

Spécifie le script SQL à exécuter sur la base de données précédemment sélectionnée.

PublishProfile - publier le profil
string. Optionnel. Utilisez quand TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Fournit un contrôle précis sur la création ou les mises à niveau de base de données Azure SQL.
Spécifie le chemin d’accès au fichier XML de profil de publication sur l’ordinateur de l’agent Automation ou sur un partage UNC. Si le profil de publication contient des secrets, comme les informations d’identification, chargez-le dans le fichiers sécurisés bibliothèque où il est stocké en toute sécurité avec le chiffrement. Ensuite, utilisez la tâche Télécharger le fichier sécurisé tâche au début de votre pipeline pour la télécharger sur l’ordinateur de l’agent lors de l’exécution du pipeline. Supprimez-le lorsque le pipeline est terminé. Les variables système prédéfinies, telles que $(agent.buildDirectory) ou $(agent.releaseDirectory), peuvent également être utilisées.

AdditionalArguments - arguments de SqlPackage.exe supplémentaires
string. Optionnel. Utilisez quand TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Spécifie les arguments SqlPackage.exe supplémentaires qui seront appliqués lors du déploiement de la base de données Azure SQL si l’option DACPAC est sélectionnée, comme /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Ces arguments remplacent les paramètres dans le fichier XML du profil de publication (le cas échéant).

SqlAdditionalArguments - arguments de Invoke-Sqlcmd supplémentaires
string. Optionnel. Utilisez quand TaskNameSelector = SqlTask.

Spécifie les arguments de Invoke-Sqlcmd supplémentaires appliqués lors de l’exécution de la requête SQL donnée sur la base de données Azure SQL, comme -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - arguments de Invoke-Sqlcmd supplémentaires
string. Optionnel. Utilisez quand TaskNameSelector = InlineSqlTask.

Spécifie les arguments de Invoke-Sqlcmd supplémentaires appliqués lors de l’exécution de la requête SQL donnée sur Azure SQL Database, comme -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - spécifier des règles de pare-feu à l’aide de
string. Obligatoire. Valeurs autorisées : AutoDetect, IPAddressRange. Valeur par défaut : AutoDetect.

Pour que la tâche s’exécute, l’adresse IP de l’agent Automation doit être ajoutée au adresses IP autorisées dans le pare-feu d’Azure SQL Server. Sélectionnez détection automatique pour ajouter automatiquement l’exception de pare-feu pour la plage de l’adresse IP possible de l’agent Automation, ou spécifiez explicitement la plage.

StartIpAddress - l’adresse IP de démarrage
string. Obligatoire lorsque IpDetectionMethod = IPAddressRange.

Spécifie l’adresse IP de départ du pool d’ordinateurs de l’agent Automation, comme 196.21.30.50.

EndIpAddress - adresse IP de fin
string. Obligatoire lorsque IpDetectionMethod = IPAddressRange.

Spécifie l’adresse IP de fin du pool d’ordinateurs de l’agent Automation, comme 196.21.30.65.

DeleteFirewallRule - Supprimer la règle une fois la tâche terminée
boolean. Valeur par défaut : true.

Si cette option est sélectionnée, une fois la tâche terminée, les adresses IP spécifiées ici sont supprimées de la liste adresses IP autorisées dans le pare-feu d’Azure SQL Server.

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

Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser en aval, les travaux et les étapes.

SqlDeploymentOutputFile
Chemin du fichier de sortie généré lorsque l’action du package de déploiement est Extract, Export, Script, DriftReportou DeployReport.

Remarques

Utilisez cette tâche pour déployer une base de données Azure SQL à l’aide d’un DACPAC ou exécuter des scripts à l’aide de SQLCMD.

Important

Cette tâche est uniquement prise en charge dans un environnement Windows. Si vous essayez d’utiliser l’authentification intégrée Azure Active Directory (Azure AD), vous devez créer un agent privé. L’authentification intégrée Azure AD n’est pas prise en charge pour les agents hébergés.

Spécifications

Besoin	Description
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent
demandes	Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux exigences de suivantes pour exécuter des travaux qui utilisent cette tâche : sqlpackage
fonctionnalités de	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	N'importe quel
variables settables	N'importe quel
Version de l’agent	1.103.0 ou version ultérieure
Catégorie de tâche	Déployer