SqlDacpacDeploymentOnMachineGroup@0- SQL Server database v0-taak implementeren
Gebruik deze taak om een SQL Server-database te implementeren met behulp van DACPAC- of SQL-scripts.
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.
Invoerwaarden
TaskType
-
SQL implementeren met behulp van
string
. Vereist. Toegestane waarden: dacpac
(Sql Dacpac), sqlQuery
(SQL-querybestand) sqlInline
(inline SQL). Standaardwaarde: dacpac
.
Hiermee geeft u de manier op waarop u de database wilt implementeren: met behulp van Dacpac- of SQL-scripts.
DacpacFile
-
DACPAC-bestand
string
. Vereist wanneer TaskType = dacpac
.
Hiermee geeft u de locatie van het DACPAC-bestand op de doelcomputers of op een UNC-pad, zoals \\BudgetIT\Web\Deploy\FabrikamDB.dacpac
. Het UNC-pad moet toegankelijk zijn voor het beheerdersaccount van de computer. Omgevingsvariabelen worden ook ondersteund, zoals $env:windir
, $env:systemroot
of $env:windir\FabrikamFibre\DB
. Jokertekens kunnen worden gebruikt. Bijvoorbeeld **/*.dacpac
voor het DACPAC-bestand dat aanwezig is in alle submappen.
SqlFile
-
SQL-bestand
string
. Vereist wanneer TaskType = sqlQuery
.
Hiermee geeft u de locatie van het SQL-bestand op het doel. Geef een door puntkomma's gescheiden lijst met SQL-scriptbestanden op om meerdere bestanden uit te voeren. De SQL-scripts worden uitgevoerd in de opgegeven volgorde. De locatie kan ook een UNC-pad zijn, zoals \\BudgetIT\Web\Deploy\FabrikamDB.sql
. Het UNC-pad moet toegankelijk zijn voor het beheerdersaccount van de computer. Omgevingsvariabelen worden ook ondersteund, zoals $env:windir
, $env:systemroot
of $env:windir\FabrikamFibre\DB
. Jokertekens kunnen worden gebruikt. Bijvoorbeeld **/*.sql
voor het SQL-bestand dat aanwezig is in alle submappen.
ExecuteInTransaction
-
Uitvoeren binnen een transactie
boolean
. Optioneel. Gebruik wanneer TaskType = sqlQuery
. Standaardwaarde: false
.
Hiermee worden de SQL-script(s) binnen een transactie uitgevoerd.
ExclusiveLock
-
Een exclusieve app-vergrendeling verkrijgen tijdens het uitvoeren van script(s)
boolean
. Optioneel. Gebruik wanneer ExecuteInTransaction = true
. Standaardwaarde: false
.
Hiermee verkrijgt u een exclusieve app-vergrendeling tijdens het uitvoeren van scripts.
AppLockName
-
Naam van app-vergrendeling
string
. Vereist wanneer ExclusiveLock = true
.
Hiermee geeft u de naam van de app-vergrendeling op.
InlineSql
-
Inline Sql
string
. Vereist wanneer TaskType = sqlInline
.
Hiermee geeft u de SQL-query's inline op.
TargetMethod
-
SQL opgeven met
string
. Vereist wanneer TaskType = dacpac
. Toegestane waarden: server
, connectionString
(verbindingsreeks), publishProfile
(publicatieprofiel). Standaardwaarde: server
.
Hiermee geeft u de optie om verbinding te maken met de doeldatabase SQL Server database. U kunt de SQL Server databasedetails, de SQL Server connection string of het XML-bestand met het publicatieprofiel opgeven.
ServerName
-
Servernaam
string
. Vereist wanneer TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
. Standaardwaarde: localhost
.
Hiermee geeft u de SQL Server naam, zoals machinename\FabriakmSQL,1433
, localhost
of .\SQL2012R2
.
localhost
Als u opgeeft, wordt er verbinding gemaakt met het standaard SQL Server exemplaar op de computer.
DatabaseName
-
Databasenaam
string
. Vereist wanneer TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
.
Hiermee geeft u de naam van de SQL Server database.
AuthScheme
-
Verificatie
string
. Vereist wanneer TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
. Toegestane waarden: windowsAuthentication
(Windows-verificatie), sqlServerAuthentication
(SQL Server-verificatie). Standaardwaarde: windowsAuthentication
.
Hiermee geeft u de verificatiemodus voor het maken van verbinding met de SQL Server. In de Windows-verificatiemodus wordt het account dat wordt gebruikt om de implementatieagent te configureren, gebruikt om verbinding te maken met de SQL Server. In SQL Server verificatiemodus moeten de SQL-aanmelding en het wachtwoord worden opgegeven in de onderstaande parameters.
SqlUsername
-
SQL-gebruikersnaam
string
. Vereist wanneer AuthScheme = sqlServerAuthentication
.
Hiermee geeft u de SQL-aanmelding op om verbinding te maken met de SQL Server. Deze optie is alleen beschikbaar als SQL Server verificatiemodus is geselecteerd.
SqlPassword
-
SQL-wachtwoord
string
. Vereist wanneer AuthScheme = sqlServerAuthentication
.
Hiermee geeft u het wachtwoord van de SQL-aanmelding. Deze optie is alleen beschikbaar als SQL Server verificatiemodus is geselecteerd.
ConnectionString
-
Verbindingsreeks
string
. Vereist wanneer TargetMethod = connectionString
.
Hiermee geeft u de SQL Server connection string, zoals Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;
.
PublishProfile
-
Profiel publiceren
string
. Optioneel. Gebruik wanneer TaskType = dacpac
.
Biedt gedetailleerde controle over SQL Server database-implementaties.
Hiermee geeft u het pad naar het XML-bestand voor het publiceren van profielen op de doelcomputer of op een UNC-share die toegankelijk is voor de referenties van de computerbeheerder.
AdditionalArguments
-
Aanvullende argumenten
string
. Optioneel. Gebruik wanneer TaskType = dacpac
.
Hiermee geeft u aanvullende SqlPackage.exe
argumenten op die worden toegepast bij het implementeren van de SQL Server-database, zoals /p:IgnoreAnsiNulls=True
of /p:IgnoreComments=True
. Deze argumenten overschrijven de instellingen in het XML-bestand met het publicatieprofiel (indien opgegeven).
AdditionalArgumentsSql
-
Aanvullende argumenten
string
. Optioneel. Gebruik wanneer TaskType = sqlQuery || TaskType = sqlInline
.
Hiermee geeft u aanvullende Invoke-Sqlcmd
argumenten op die worden toegepast bij het implementeren van de SQL Server-database.
Opties voor taakbeheer
Alle taken hebben naast de taakinvoer besturingsopties. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.
Uitvoervariabelen
Geen.
Vereisten
Vereiste | Beschrijving |
---|---|
Pijplijntypen | Klassieke release |
Wordt uitgevoerd op | Agent, DeploymentGroup |
Eisen | Geen |
Functies | Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak. |
Opdrachtbeperkingen | Alle |
Instelbare variabelen | Alle |
Agentversie | 1.102.0 of hoger |
Taakcategorie | Implementeren |
Vereiste | Beschrijving |
---|---|
Pijplijntypen | Klassieke release |
Wordt uitgevoerd op | DeploymentGroup |
Eisen | Geen |
Functies | Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak. |
Opdrachtbeperkingen | Alle |
Instelbare variabelen | Alle |
Agentversie | 1.102.0 of hoger |
Taakcategorie | Implementeren |