Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Eingänge
TaskType
-
Bereitstellen von SQL mithilfe von
string
. Erforderlich. Zulässige Werte: dacpac
(Sql Dacpac), sqlQuery
(SQL-Abfragedatei), sqlInline
(Inline SQL). Standardwert: dacpac
.
Gibt die Art und Weise an, wie Sie die Datenbank bereitstellen möchten: verwenden Sie Dacpac- oder SQL-Skripts.
DacpacFile
-
DACPAC-Datei
string
. Erforderlich, wenn TaskType = dacpac
.
Gibt den Speicherort der DACPAC-Datei auf den Zielcomputern oder auf einem UNC-Pfad an, z. B. \\BudgetIT\Web\Deploy\FabrikamDB.dacpac
. Der UNC-Pfad sollte für das Administratorkonto des Computers zugänglich sein. Umgebungsvariablen werden auch unterstützt, z. B. $env:windir
, $env:systemroot
oder $env:windir\FabrikamFibre\DB
. 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 für das Ziel an. Stellen Sie eine durch Semikolons 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 werden auch unterstützt, z. B. $env:windir
, $env:systemroot
oder $env:windir\FabrikamFibre\DB
. Platzhalter können verwendet werden. Beispiel: **/*.sql
für die SQL-Datei, die in allen Unterordnern vorhanden ist.
ExecuteInTransaction
-
Innerhalb einer Transaktion ausführen
boolean
. Wahlfrei. Wird verwendet, wenn TaskType = sqlQuery
. Standardwert: false
.
Führt die SQL-Skripts innerhalb einer Transaktion aus.
ExclusiveLock
-
Erwerben einer exklusiven App-Sperre beim Ausführen von Skripts
boolean
. Wahlfrei. Wird verwendet, wenn ExecuteInTransaction = true
. Standardwert: false
.
Erwirbt eine exklusive App-Sperre beim Ausführen von Skripts.
AppLockName
-
App-Sperrname
string
. Erforderlich, wenn ExclusiveLock = true
.
Gibt den App-Sperrnamen an.
InlineSql
-
Inline-SQL-
string
. Erforderlich, wenn TaskType = sqlInline
.
Gibt die SQL-Abfragen inline an.
TargetMethod
-
Sql mithilfe von angeben
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 SQL Server-Zieldatenbank an. Sie können die SQL Server-Datenbankdetails, die SQL Server-Verbindungszeichenfolge oder die XML-Datei zum Veröffentlichen von Profilen angeben.
ServerName
-
Servername
string
. Erforderlich, wenn TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
. Standardwert: localhost
.
Gibt den SQL Server-Namen an, z. B. machinename\FabriakmSQL,1433
, localhost
oder .\SQL2012R2
. Wenn Sie localhost
angeben, wird eine Verbindung mit der SQL Server-Standardinstanz 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 sql Server an. Im Windows-Authentifizierungsmodus wird das Konto zum Konfigurieren des Bereitstellungs-Agents verwendet, um eine Verbindung mit sql Server herzustellen. Im SQL Server-Authentifizierungsmodus muss die SQL-Anmeldung und das Kennwort in den folgenden Parametern angegeben werden.
SqlUsername
-
SQL-Benutzernamen
string
. Erforderlich, wenn AuthScheme = sqlServerAuthentication
.
Gibt die SQL-Anmeldung an, die mit sql Server verbunden werden soll. Diese Option ist nur verfügbar, wenn der SQL Server-Authentifizierungsmodus ausgewählt wurde.
SqlPassword
-
SQL-Kennwort
string
. Erforderlich, wenn AuthScheme = sqlServerAuthentication
.
Gibt das Kennwort der SQL-Anmeldung an. Diese Option ist nur verfügbar, wenn der SQL Server-Authentifizierungsmodus ausgewählt wurde.
ConnectionString
-
Verbindungszeichenfolge
string
. Erforderlich, wenn TargetMethod = connectionString
.
Gibt die SQL Server-Verbindungszeichenfolge an, z. B. Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;
.
PublishProfile
-
Profil veröffentlichen
string
. Wahlfrei. Wird verwendet, wenn TaskType = dacpac
.
Bietet eine differenzierte Kontrolle über SQL Server-Datenbankbereitstellungen.
Gibt den Pfad zur Veröffentlichungsprofil-XML-Datei auf dem Zielcomputer oder auf einer UNC-Freigabe an, auf die von den Anmeldeinformationen des Computeradministrators zugegriffen werden kann.
AdditionalArguments
-
zusätzliche Argumente
string
. Wahlfrei. Wird verwendet, wenn TaskType = dacpac
.
Gibt zusätzliche SqlPackage.exe
Argumente an, die beim Bereitstellen der SQL Server-Datenbank angewendet werden, z. B. /p:IgnoreAnsiNulls=True
oder /p:IgnoreComments=True
. Diese Argumente überschreiben die Einstellungen in der XML-Datei zum Veröffentlichen von Profilen (sofern angegeben).
AdditionalArgumentsSql
-
zusätzliche Argumente
string
. Wahlfrei. Wird verwendet, 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 ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.
Ausgabevariablen
Keiner.
Anforderungen
Anforderung | BESCHREIBUNG |
---|---|
Pipelinetypen | Klassische Version |
Läuft auf | Agent, DeploymentGroup |
Anforderungen | Nichts |
Funktionen | Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag. |
Befehlseinschränkungen | Jegliche |
Settable-Variablen | Jegliche |
Agentversion | 1.102.0 oder höher |
Vorgangskategorie | Einsetzen |