SqlDacpacDeploymentOnMachineGroup@0 - SQL Server-database v0-taak implementeren

Gebruik deze taak om een SQL Server-database te implementeren met DACPAC- of SQL-scripts.

Syntaxis

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

Invoer

TaskType - SQL implementeren met behulp van
string. Verplicht. Toegestane waarden: dacpac (Sql Dacpac), sqlQuery (Sql Query-bestand), sqlInline (Inline Sql). Standaardwaarde: dacpac.

Hiermee geeft u de manier op waarop u de database wilt implementeren: met 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:systemrootof $env:windir\FabrikamFibre\DB. U kunt jokertekens gebruiken. 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:systemrootof $env:windir\FabrikamFibre\DB. U kunt jokertekens gebruiken. Bijvoorbeeld **/*.sql voor het SQL-bestand dat aanwezig is in alle submappen.

ExecuteInTransaction - uitvoeren binnen een transactie
boolean. Facultatief. Gebruiken 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 scripts
boolean. Facultatief. Gebruiken wanneer ExecuteInTransaction = true. Standaardwaarde: false.

Hiermee verkrijgt u een exclusieve app-vergrendeling tijdens het uitvoeren van scripts.

AppLockName - app-vergrendelingsnaam
string. Vereist wanneer ExclusiveLock = true.

Hiermee geeft u de naam van de app-vergrendeling.

InlineSql - Inline Sql-
string. Vereist wanneer TaskType = sqlInline.

Hiermee geeft u de SQL-query's inline op.

TargetMethod - SQL opgeven met behulp van
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 doel-SQL Server-database. U kunt de gegevens van de SQL Server-database, de SQL Server-verbindingsreeks 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, localhostof .\SQL2012R2. Als u localhost opgeeft, wordt 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 op voor het maken van verbinding met de SQL Server. In de Windows-verificatiemodus wordt het account gebruikt om de implementatieagent te configureren om verbinding te maken met de SQL Server. In de 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 de 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 de SQL Server-verificatiemodus is geselecteerd.

ConnectionString - verbindingsreeks
string. Vereist wanneer TargetMethod = connectionString.

Hiermee geeft u de SQL Server-verbindingsreeks, zoals Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.

PublishProfile - Profiel publiceren
string. Facultatief. Gebruiken wanneer TaskType = dacpac.

Biedt gedetailleerde controle over SQL Server-database-implementaties.
Hiermee geeft u het pad naar het XML-bestand van het publicatieprofiel op de doelcomputer of op een UNC-share die toegankelijk is via de referenties van de computerbeheerder.

AdditionalArguments - Aanvullende argumenten
string. Facultatief. Gebruiken 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. Met deze argumenten worden de instellingen in het XML-bestand van het publicatieprofiel overschreven (indien opgegeven).

AdditionalArgumentsSql - Aanvullende argumenten
string. Facultatief. Gebruiken wanneer TaskType = sqlQuery || TaskType = sqlInline.

Hiermee geeft u extra Invoke-Sqlcmd argumenten die worden toegepast bij het implementeren van de SQL Server-database.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	Klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.102.0 of hoger
Taakcategorie	Implementeren