Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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 |