SqlDacpacDeploymentOnMachineGroup@0: SQL Server Task "Datenbankbereitstellung v0"
Verwenden Sie diese Aufgabe, um eine SQL Server Datenbank mithilfe von DACPAC- oder SQL-Skripts bereitzustellen.
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.
Eingaben
TaskType
- Bereitstellen von SQL mit
string
. Erforderlich. Zulässige Werte: dacpac
(Sql Dacpac), sqlQuery
(Sql-Abfragedatei), sqlInline
(Inline-Sql). Standardwert. dacpac
.
Gibt an, wie Sie die Datenbank bereitstellen möchten: mithilfe von Dacpac oder SQL-Skripts.
DacpacFile
- DACPAC-Datei
string
. Erforderlich, wenn TaskType = dacpac
.
Gibt den Speicherort der DACPAC-Datei auf den Zielcomputern oder in einem UNC-Pfad wie \\BudgetIT\Web\Deploy\FabrikamDB.dacpac
an. Der UNC-Pfad sollte für das Administratorkonto des Computers zugänglich sein. Umgebungsvariablen wie $env:windir
, $env:systemroot
oder $env:windir\FabrikamFibre\DB
werden ebenfalls unterstützt. Platzhalter können verwendet werden. Beispielsweise **/*.dacpac
für die DACPAC-Datei, die in allen Unterordnern vorhanden ist.
SqlFile
- Sql-Datei
string
. Erforderlich, wenn TaskType = sqlQuery
.
Gibt den Speicherort der SQL-Datei auf dem Ziel an. Stellen Sie eine durch Semikolon getrennte Liste von SQL-Skriptdateien bereit, um mehrere Dateien auszuführen. Die SQL-Skripts werden in der angegebenen Reihenfolge ausgeführt. Der Speicherort kann auch ein UNC-Pfad sein, z. B \\BudgetIT\Web\Deploy\FabrikamDB.sql
. . Der UNC-Pfad sollte für das Administratorkonto des Computers zugänglich sein. Umgebungsvariablen wie $env:windir
, $env:systemroot
oder $env:windir\FabrikamFibre\DB
werden ebenfalls unterstützt. Platzhalter können verwendet werden. Beispielsweise für die SQL-Datei, **/*.sql
die in allen Unterordnern vorhanden ist.
ExecuteInTransaction
- Ausführen innerhalb einer Transaktion
boolean
. Optional. Verwenden Sie , wenn TaskType = sqlQuery
. Standardwert. false
.
Führt die SQL-Skripts innerhalb einer Transaktion aus.
ExclusiveLock
- Abrufen einer exklusiven App-Sperre beim Ausführen von Skripts
boolean
. Optional. Verwenden Sie , wenn ExecuteInTransaction = true
. Standardwert. false
.
Ruft beim Ausführen von Skripts eine exklusive App-Sperre ab.
AppLockName
- Name der App-Sperre
string
. Erforderlich, wenn ExclusiveLock = true
.
Gibt den Namen der App-Sperre an.
InlineSql
- Inline-Sql
string
. Erforderlich, wenn TaskType = sqlInline
.
Gibt die SQL-Abfragen inline an.
TargetMethod
- Angeben von SQL mit
string
. Erforderlich, wenn TaskType = dacpac
. Zulässige Werte: server
, connectionString
(Verbindungszeichenfolge), publishProfile
(Veröffentlichungsprofil). Standardwert. server
.
Gibt die Option zum Herstellen einer Verbindung mit der Zieldatenbank SQL Server an. Sie können die SQL Server Datenbankdetails, die SQL Server-Verbindungszeichenfolge oder die XML-Datei des Veröffentlichungsprofils angeben.
ServerName
- Servername
string
. Erforderlich, wenn TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
. Standardwert. localhost
.
Gibt den SQL Server Namen an, z. Bmachinename\FabriakmSQL,1433
. , localhost
oder .\SQL2012R2
. Wenn Sie angeben, localhost
wird eine Verbindung mit der Standardinstanz SQL Server auf dem Computer hergestellt.
DatabaseName
- Datenbankname
string
. Erforderlich, wenn TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
.
Gibt den Namen der SQL Server-Datenbank an.
AuthScheme
- Authentifizierung
string
. Erforderlich, wenn TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
. Zulässige Werte: windowsAuthentication
(Windows-Authentifizierung), sqlServerAuthentication
(SQL Server-Authentifizierung). Standardwert. windowsAuthentication
.
Gibt den Authentifizierungsmodus für die Verbindung mit dem SQL Server an. Im Windows-Authentifizierung Modus wird das Konto zum Konfigurieren des Bereitstellungs-Agents verwendet, um eine Verbindung mit dem SQL Server herzustellen. In SQL Server Authentifizierungsmodus müssen der SQL-Anmeldenamen und das Kennwort in den folgenden Parametern angegeben werden.
SqlUsername
- SQL-Benutzername
string
. Erforderlich, wenn AuthScheme = sqlServerAuthentication
.
Gibt den SQL-Anmeldenamen an, um eine Verbindung mit dem SQL Server herzustellen. Diese Option ist nur verfügbar, wenn SQL Server Authentifizierungsmodus ausgewählt wurde.
SqlPassword
- SQL-Kennwort
string
. Erforderlich, wenn AuthScheme = sqlServerAuthentication
.
Gibt das Kennwort des SQL-Anmeldenamens an. Diese Option ist nur verfügbar, wenn SQL Server Authentifizierungsmodus ausgewählt wurde.
ConnectionString
- Verbindungszeichenfolge
string
. Erforderlich, wenn TargetMethod = connectionString
.
Gibt die SQL Server Verbindungszeichenfolge an, z. BServer=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;
. .
PublishProfile
- Profil veröffentlichen
string
. Optional. Verwenden Sie , wenn TaskType = dacpac
.
Bietet eine differenzierte Kontrolle über SQL Server Datenbankbereitstellungen.
Gibt den Pfad zur XML-Datei zum Veröffentlichen des Profils auf dem Zielcomputer oder auf einer UNC-Freigabe an, auf die die Anmeldeinformationen des Computeradministrators zugreifen können.
AdditionalArguments
- Zusätzliche Argumente
string
. Optional. Verwenden Sie , wenn TaskType = dacpac
.
Gibt zusätzliche SqlPackage.exe
Argumente an, die beim Bereitstellen der SQL Server-Datenbank angewendet werden, z/p:IgnoreAnsiNulls=True
. B. oder /p:IgnoreComments=True
. Diese Argumente überschreiben die Einstellungen in der XML-Datei des Veröffentlichungsprofils (sofern angegeben).
AdditionalArgumentsSql
- Zusätzliche Argumente
string
. Optional. Verwenden Sie , wenn TaskType = sqlQuery || TaskType = sqlInline
.
Gibt zusätzliche Invoke-Sqlcmd
Argumente an, die beim Bereitstellen der SQL Server-Datenbank angewendet werden.
Aufgabensteuerungsoptionen
Alle Aufgaben verfügen zusätzlich zu den Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.
Ausgabevariablen
Keine
Anforderungen
Anforderung | Beschreibung |
---|---|
Pipelinetypen | Klassische Version |
Wird ausgeführt auf | Agent, DeploymentGroup |
Forderungen | Keine |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Einstellbare Variablen | Any |
Agent-Version | 1.102.0 oder höher |
Aufgabenkategorie | Bereitstellen |
Anforderung | Beschreibung |
---|---|
Pipelinetypen | Klassische Version |
Wird ausgeführt auf | DeploymentGroup |
Forderungen | Keine |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Einstellbare Variablen | Any |
Agent-Version | 1.102.0 oder höher |
Aufgabenkategorie | Bereitstellen |