SqlDacpacDeploymentOnMachineGroup@0 – SQL Server-databasdistribution v0-uppgift

Använd den här uppgiften för att distribuera en SQL Server-databas med hjälp av DACPAC- eller SQL-skript.

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.

Ingångar

TaskType - distribuera SQL med
string. Obligatoriskt. Tillåtna värden: dacpac (Sql Dacpac), sqlQuery (Sql Query File), sqlInline (infogad Sql). Standardvärde: dacpac.

Anger hur du vill distribuera databasen: med Dacpac eller SQL-skript.

DacpacFile - DACPAC-fil
string. Krävs när TaskType = dacpac.

Anger platsen för DACPAC-filen på måldatorerna eller på en UNC-sökväg, till exempel \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. UNC-sökvägen ska vara tillgänglig för datorns administratörskonto. Miljövariabler stöds också, till exempel $env:windir, $env:systemrooteller $env:windir\FabrikamFibre\DB. Jokertecken kan användas. Till exempel **/*.dacpac för DACPAC-filen som finns i alla undermappar.

SqlFile - Sql File
string. Krävs när TaskType = sqlQuery.

Anger platsen för SQL-filen på målet. Ange en semikolonavgränsad lista över SQL-skriptfiler för att köra flera filer. SQL-skripten körs i den ordning som anges. Platsen kan också vara en UNC-sökväg, till exempel \\BudgetIT\Web\Deploy\FabrikamDB.sql. UNC-sökvägen ska vara tillgänglig för datorns administratörskonto. Miljövariabler stöds också, till exempel $env:windir, $env:systemrooteller $env:windir\FabrikamFibre\DB. Jokertecken kan användas. Till exempel **/*.sql för SQL-filen som finns i alla undermappar.

ExecuteInTransaction - kör i en transaktion
boolean. Valfritt. Använd när TaskType = sqlQuery. Standardvärde: false.

Kör SQL-skripten i en transaktion.

ExclusiveLock - Hämta ett exklusivt applås när skript körs
boolean. Valfritt. Använd när ExecuteInTransaction = true. Standardvärde: false.

Hämtar ett exklusivt applås när skript körs.

AppLockName - Applåsnamn
string. Krävs när ExclusiveLock = true.

Anger namnet på applåset.

InlineSql - Infogad Sql
string. Krävs när TaskType = sqlInline.

Anger SQL-frågorna infogade.

TargetMethod - Ange SQL med hjälp av
string. Krävs när TaskType = dacpac. Tillåtna värden: server, connectionString (anslutningssträng), publishProfile (publiceringsprofil). Standardvärde: server.

Anger alternativet för att ansluta till SQL Server-måldatabasen. Du kan ange SQL Server-databasinformation, SQL Server-anslutningssträngen eller XML-filen för publiceringsprofilen.

ServerName - servernamn
string. Krävs när TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline. Standardvärde: localhost.

Anger SQL Server-namnet, till exempel machinename\FabriakmSQL,1433, localhosteller .\SQL2012R2. Om du anger localhost ansluts till SQL Server-standardinstansen på datorn.

DatabaseName - databasnamn
string. Krävs när TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline.

Anger namnet på SQL Server-databasen.

AuthScheme - autentisering
string. Krävs när TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline. Tillåtna värden: windowsAuthentication (Windows-autentisering), sqlServerAuthentication (SQL Server-autentisering). Standardvärde: windowsAuthentication.

Anger autentiseringsläget för anslutning till SQL Server. I Windows-autentiseringsläge används det konto som används för att konfigurera distributionsagenten för att ansluta till SQL Server. I SQL Server-autentiseringsläge måste SQL-inloggningen och lösenordet anges i parametrarna nedan.

SqlUsername - SQL-användarnamn
string. Krävs när AuthScheme = sqlServerAuthentication.

Anger SQL-inloggningen för att ansluta till SQL Server. Det här alternativet är bara tillgängligt om SQL Server-autentiseringsläget har valts.

SqlPassword - SQL-lösenord
string. Krävs när AuthScheme = sqlServerAuthentication.

Anger lösenordet för SQL-inloggningen. Det här alternativet är bara tillgängligt om SQL Server-autentiseringsläget har valts.

ConnectionString - anslutningssträng
string. Krävs när TargetMethod = connectionString.

Anger SQL Server-anslutningssträngen, till exempel Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.

PublishProfile - Publicera profil
string. Valfritt. Använd när TaskType = dacpac.

Ger detaljerad kontroll över SQL Server-databasdistributioner.
Anger sökvägen till XML-filen för publiceringsprofilen på måldatorn eller på en UNC-resurs som är tillgänglig för datoradministratörens autentiseringsuppgifter.

AdditionalArguments - ytterligare argument
string. Valfritt. Använd när TaskType = dacpac.

Anger ytterligare SqlPackage.exe argument som ska användas vid distribution av SQL Server-databasen, till exempel /p:IgnoreAnsiNulls=True eller /p:IgnoreComments=True. Dessa argument åsidosätter inställningarna i XML-filen för publiceringsprofilen (om så anges).

AdditionalArgumentsSql - ytterligare argument
string. Valfritt. Använd när TaskType = sqlQuery || TaskType = sqlInline.

Anger ytterligare Invoke-Sqlcmd argument som tillämpas vid distribution av SQL Server-databasen.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Krav

Krav	Beskrivning
Pipelinetyper	Klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	1.102.0 eller senare
Aktivitetskategori	Gruppera