SqlAzureDacpacDeployment@1: Task "Azure SQL Datenbankbereitstellung v1"

Verwenden Sie diese Aufgabe, um eine Azure SQL-Datenbank mithilfe von DACPAC bereitzustellen oder Skripts mithilfe von SQLCMD auszuführen.

Syntax

# 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.

Eingaben

azureConnectionType - Azure-Dienstverbindungstyp
Eingabealias: ConnectedServiceNameSelector. string. Zulässige Werte: ConnectedServiceName (klassische Azure), ConnectedServiceNameARM (Azure Resource Manager). Standardwert. ConnectedServiceNameARM.

azureClassicSubscription - Klassisches Azure-Abonnement
Eingabealias: ConnectedServiceName. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName.

Gibt das klassische Azure-Zielabonnement für die Bereitstellung von SQL-Dateien an.

azureSubscription - Azure-Abonnement
Eingabealias: ConnectedServiceNameARM. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameARM.

Gibt das Azure Resource Manager Zielabonnement für die Bereitstellung von SQL-Dateien an.

AuthenticationType - Authentifizierungstyp
string. Erforderlich. Zulässige Werte: server (SQL Server Authentication), aadAuthenticationPassword (Active Directory – Password), aadAuthenticationIntegrated (Active Directory – Integrated), connectionString (Verbindungszeichenfolge), servicePrincipal (Dienstprinzipal). Standardwert. server.

Gibt den Typ der Datenbankauthentifizierung an. Es kann sich um eine SQL Server, Active Directory (integriert), Active Directory (Kennwort), Verbindungszeichenfolge oder Dienstprinzipalauthentifizierung handeln. Integrierte Authentifizierung bedeutet, dass der Agent über seinen aktuellen Active Directory-Kontokontext auf die Datenbank zugreift.

Geben Sie die Option zum Herstellen einer Verbindung mit der Azure SQL Server-Datenbank an. Sie können die Azure SQL Server-Datenbankdetails, die SQL Server Verbindungszeichenfolge, die AD-Authentifizierung (Kennwort oder integriert) angeben oder einen Dienstprinzipal verwenden. Verwenden Sie für SQL Server Authentifizierung die Benutzeranmeldeinformationen des SQL Server. Verwenden Sie für die AD-Authentifizierung die Anmeldeinformationen für den AD-Benutzer, der für die SQL Server konfiguriert ist.

ServerName - Azure SQL Server
string. Erforderlich, wenn AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Gibt den Azure SQL Servernamen an, zFabrikam.database.windows.net,1433. B. oder Fabrikam.database.windows.net.

DatabaseName - Datenbank
string. Erforderlich, wenn AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Gibt den Namen der Azure SQL-Datenbank an, in der die Dateien bereitgestellt werden.

SqlUsername - Einloggen
string. Erforderlich, wenn AuthenticationType = server.

Gibt die Azure SQL Serveradministratoranmeldung an.

SqlPassword - Passwort
string. Erforderlich, wenn AuthenticationType = server.

Gibt das Kennwort für den Azure SQL Serveradministrator an. In den Build- oder Releasepipelines definierte Variablen werden akzeptiert $(passwordVariable) . Sie können den Variablentyp als secret markieren, um ihn zu schützen.

aadSqlUsername - Einloggen
string. Erforderlich, wenn AuthenticationType = aadAuthenticationPassword.

Gibt den Active Directory-Benutzernamen an.

aadSqlPassword - Passwort
string. Erforderlich, wenn AuthenticationType = aadAuthenticationPassword.

Gibt das Kennwort für den Active Directory-Benutzer an. In den Build- oder Releasepipelines definierte Variablen werden akzeptiert $(passwordVariable) . Sie können den Variablentyp als secret markieren, um ihn zu schützen.

ConnectionString - Verbindungszeichenfolge
string. Erforderlich, wenn AuthenticationType = connectionString.

Gibt die Azure SQL Server-Verbindungszeichenfolge an, zServer=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);. B. .

deployType - Bereitstellungstyp
Eingabealias: TaskNameSelector. string. Erforderlich. Zulässige Werte: DacpacTask (SQL DACPAC-Datei), SqlTask (SQL-Skriptdatei), InlineSqlTask (Inline-SQL-Skript). Standardwert. DacpacTask.

DeploymentAction - Aktion
string. Erforderlich, wenn TaskNameSelector = DacpacTask. Zulässige Werte: Publish, Extract, Export, Import, Script, DriftReport ( Driftbericht), DeployReport (Bericht bereitstellen). Standardwert. Publish.

Gibt eine der SQL-Aktionen aus der Liste an. Erfahren Sie mehr über die Liste der SQL-Aktionen.

DacpacFile - DACPAC-Datei
string. Erforderlich, wenn DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Gibt den Speicherort der DACPAC-Datei im Automatisierungs-Agent oder in einem UNC-Pfad an, auf den der Automatisierungs-Agent zugreifen kann, z. B \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. . Vordefinierte Systemvariablen wie $(agent.releaseDirectory)können ebenfalls verwendet werden.

BacpacFile - BACPAC-Datei
string. Erforderlich, wenn DeploymentAction = Import.

Gibt den Speicherort der BACPAC-Datei im Automatisierungs-Agent oder in einem UNC-Pfad an, auf den der Automatisierungs-Agent zugreifen kann, z. B \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. . Vordefinierte Systemvariablen wie $(agent.releaseDirectory)können ebenfalls verwendet werden.

SqlFile - SQL-Skript
string. Erforderlich, wenn TaskNameSelector = SqlTask.

Gibt den Speicherort der SQL-Skriptdatei im Automatisierungs-Agent oder in einem UNC-Pfad an, auf den der Automatisierungs-Agent zugreifen kann, z. B \\BudgetIT\Web\Deploy\FabrikamDB.sql. . Vordefinierte Systemvariablen wie $(agent.releaseDirectory)können ebenfalls verwendet werden.

SqlInline - Sql-Inlineskript
string. Erforderlich, wenn TaskNameSelector = InlineSqlTask.

Gibt das SQL-Skript an, das für die zuvor ausgewählte Datenbank ausgeführt werden soll.

PublishProfile - Veröffentlichungsprofil
string. Optional. Verwenden Sie , wenn TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Bietet eine differenzierte Steuerung Azure SQL Datenbankerstellung oder -upgrades.
Gibt den Pfad zur Veröffentlichungsprofil-XML-Datei auf dem Computer des Automatisierungs-Agents oder auf einer UNC-Freigabe an. Wenn das Veröffentlichungsprofil Geheimnisse wie Anmeldeinformationen enthält, laden Sie es in die Bibliothek für sichere Dateien hoch, wo es sicher mit Verschlüsselung gespeichert wird. Verwenden Sie als Nächstes den Task Sichere Datei herunterladen am Anfang ihrer Pipeline, um sie auf den Agent-Computer herunterzuladen, wenn die Pipeline ausgeführt wird. Löschen Sie sie, wenn die Pipeline abgeschlossen ist. Vordefinierte Systemvariablen wie $(agent.buildDirectory) oder $(agent.releaseDirectory)können ebenfalls verwendet werden.

AdditionalArguments - Zusätzliche SqlPackage.exe Argumente
string. Optional. Verwenden Sie , wenn TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Gibt die zusätzlichen SqlPackage.exe Argumente an, die beim Bereitstellen der Azure SQL-Datenbank angewendet werden, wenn die Option DACPAC ausgewählt ist, z/p:IgnoreAnsiNulls=True /p:IgnoreComments=True. B. . Diese Argumente überschreiben die Einstellungen in der XML-Datei für das Veröffentlichungsprofil (sofern angegeben).

SqlAdditionalArguments - Zusätzliche Invoke-Sqlcmd Argumente
string. Optional. Verwenden Sie , wenn TaskNameSelector = SqlTask.

Gibt die zusätzlichen Invoke-Sqlcmd Argumente an, die angewendet werden, wenn die angegebene SQL-Abfrage für die Azure SQL-Datenbank ausgeführt wird, z-ConnectionTimeout 100 -OutputSqlErrors. B. .

InlineAdditionalArguments - Zusätzliche Invoke-Sqlcmd Argumente
string. Optional. Verwenden Sie , wenn TaskNameSelector = InlineSqlTask.

Gibt die zusätzlichen Invoke-Sqlcmd Argumente an, die angewendet werden, wenn die angegebene SQL-Abfrage für die Azure SQL-Datenbank ausgeführt wird, z-ConnectionTimeout 100 -OutputSqlErrors. B. .

IpDetectionMethod - Angeben von Firewallregeln mit
string. Erforderlich. Zulässige Werte: AutoDetect, IPAddressRange. Standardwert. AutoDetect.

Damit die Aufgabe ausgeführt werden kann, muss die IP-Adresse des Automatisierungs-Agents den zulässigen IP-Adressen in der Firewall des Azure SQL Servers hinzugefügt werden. Wählen Sie Automatische Erkennung aus, um automatisch die Firewall-Ausnahme für den Bereich der möglichen IP-Adresse des Automatisierungs-Agents hinzuzufügen, oder geben Sie den Bereich explizit an.

StartIpAddress - Start-IP-Adresse
string. Erforderlich, wenn IpDetectionMethod = IPAddressRange.

Gibt die Start-IP-Adresse des Computerpools des Automation-Agents an, z. B 196.21.30.50. .

EndIpAddress - End-IP-Adresse
string. Erforderlich, wenn IpDetectionMethod = IPAddressRange.

Gibt die endende IP-Adresse des Computerpools des Automation-Agents an, z. B 196.21.30.65. .

DeleteFirewallRule - Löschregel nach Taskende
boolean. Standardwert. true.

Wenn diese Option ausgewählt ist, werden die hier angegebenen IP-Adressen nach Beendigung der Aufgabe aus der Liste Zulässige IP-Adressen in der Firewall des Azure SQL Servers gelöscht.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Diese Aufgabe definiert die folgenden Ausgabevariablen, die Sie in Downstreamschritten, Aufträgen und Phasen verwenden können.

SqlDeploymentOutputFile
Der generierte Ausgabedateipfad, wenn die Bereitstellungspaketaktion , Export, ScriptDriftReportoder DeployReportlautetExtract.

Hinweise

Verwenden Sie diese Aufgabe, um eine Azure SQL-Datenbank mithilfe einer DACPAC-Instanz bereitzustellen oder Skripts mithilfe von SQLCMD auszuführen.

Wichtig

Diese Aufgabe wird nur in einer Windows-Umgebung unterstützt. Wenn Sie die integrierte Azure AD-Authentifizierung (Azure Active Directory) verwenden möchten, müssen Sie einen privaten Agent erstellen. Die integrierte Azure AD-Authentifizierung wird für gehostete Agents nicht unterstützt.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen , um Aufträge auszuführen, die diese Aufgabe verwenden: sqlpackage
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.103.0 oder höher
Aufgabenkategorie	Bereitstellen