SqlAzureDacpacDeployment@1 - Azure SQL Database-implementatie v1-taak

Gebruik deze taak om een Azure SQL Database te implementeren met DACPAC of scripts uit te voeren met behulp van SQLCMD.

Syntax

# Azure SQL Database deployment v1
# Deploy an Azure SQL Database using DACPAC or run scripts using SQLCMD.
- task: SqlAzureDacpacDeployment@1
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Service Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
  # SQL Database
    AuthenticationType: 'server' # 'server' | 'aadAuthenticationPassword' | 'aadAuthenticationIntegrated' | 'connectionString' | 'servicePrincipal'. Required. Authentication Type. Default: server.
    #ServerName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Azure SQL Server. 
    #DatabaseName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Database. 
    SqlUsername: # string. Required when AuthenticationType = server. Login. 
    SqlPassword: # string. Required when AuthenticationType = server. Password. 
    #aadSqlUsername: # string. Required when AuthenticationType = aadAuthenticationPassword. Login. 
    #aadSqlPassword: # string. Required when AuthenticationType = aadAuthenticationPassword. Password. 
    #ConnectionString: # string. Required when AuthenticationType = connectionString. Connection String. 
  # Deployment Package
    deployType: 'DacpacTask' # 'DacpacTask' | 'SqlTask' | 'InlineSqlTask'. Alias: TaskNameSelector. Required. Deploy type. Default: DacpacTask.
    DeploymentAction: 'Publish' # 'Publish' | 'Extract' | 'Export' | 'Import' | 'Script' | 'DriftReport' | 'DeployReport'. Required when TaskNameSelector = DacpacTask. Action. Default: Publish.
    #DacpacFile: # string. Required when DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport. DACPAC File. 
    #BacpacFile: # string. Required when DeploymentAction = Import. BACPAC File. 
    #SqlFile: # string. Required when TaskNameSelector = SqlTask. SQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline SQL Script. 
    #PublishProfile: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport. Publish Profile. 
    #AdditionalArguments: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport. Additional SqlPackage.exe Arguments. 
    #SqlAdditionalArguments: # string. Optional. Use when TaskNameSelector = SqlTask. Additional Invoke-Sqlcmd Arguments. 
    #InlineAdditionalArguments: # string. Optional. Use when TaskNameSelector = InlineSqlTask. Additional Invoke-Sqlcmd Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

Invoerwaarden

azureConnectionType - Verbindingstype azure-service
Invoeralias: ConnectedServiceNameSelector. string. Toegestane waarden: ConnectedServiceName (Klassiek van Azure), ConnectedServiceNameARM (Azure Resource Manager). Standaardwaarde: ConnectedServiceNameARM.

azureClassicSubscription - Klassiek Azure-abonnement
Invoeralias: ConnectedServiceName. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

Hiermee geeft u het klassieke Azure-doelabonnement op voor het implementeren van SQL-bestanden.

azureSubscription - Azure-abonnement
Invoeralias: ConnectedServiceNameARM. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameARM.

Hiermee geeft u het Azure Resource Manager-doelabonnement op voor het implementeren van SQL-bestanden.

AuthenticationType - Verificatietype
string. Vereist. Toegestane waarden: server (SQL Server Verificatie), aadAuthenticationPassword (Active Directory - Wachtwoord), aadAuthenticationIntegrated (Active Directory - Geïntegreerd), connectionString (Verbindingsreeks), servicePrincipal (Service-principal). Standaardwaarde: server.

Hiermee geeft u het type databaseverificatie op. Dit kan een SQL Server, Active Directory (geïntegreerd), Active Directory (wachtwoord), verbindingsreeks of service-principalverificatie zijn. Geïntegreerde verificatie betekent dat de agent toegang heeft tot de database met behulp van de huidige Active Directory-accountcontext.

Geef de optie op om verbinding te maken met de Azure SQL Server-database. U kunt de Azure SQL Server-databasedetails, de SQL Server verbindingsreeks, AD-verificatie (wachtwoord of geïntegreerd) opgeven of een service-principal gebruiken. Gebruik voor SQL Server verificatie de gebruikersreferenties van de SQL Server. Gebruik voor AD-verificatie de referenties voor de AD-gebruiker die is geconfigureerd voor de SQL Server.

ServerName - Azure SQL Server
string. Vereist wanneer AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Hiermee geeft u de Azure SQL servernaam, zoals Fabrikam.database.windows.net,1433 of Fabrikam.database.windows.net.

DatabaseName - Database
string. Vereist wanneer AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Hiermee geeft u de naam van de Azure SQL database waarin de bestanden worden geïmplementeerd.

SqlUsername - Login
string. Vereist wanneer AuthenticationType = server.

Hiermee geeft u de Azure SQL Server beheerdersaanmelding.

SqlPassword - Wachtwoord
string. Vereist wanneer AuthenticationType = server.

Hiermee geeft u het wachtwoord voor de Azure SQL Server-beheerder. Variabelen die zijn gedefinieerd in de build- of release-pijplijnen zoals $(passwordVariable) worden geaccepteerd. U kunt het type variabele markeren als secret om het te beveiligen.

aadSqlUsername - Login
string. Vereist wanneer AuthenticationType = aadAuthenticationPassword.

Hiermee geeft u de Active Directory-gebruikersnaam.

aadSqlPassword - Wachtwoord
string. Vereist wanneer AuthenticationType = aadAuthenticationPassword.

Hiermee geeft u het wachtwoord voor de Active Directory-gebruiker. Variabelen die zijn gedefinieerd in de build- of release-pijplijnen zoals $(passwordVariable) worden geaccepteerd. U kunt het type variabele markeren als secret om het te beveiligen.

ConnectionString - Verbindingsreeks
string. Vereist wanneer AuthenticationType = connectionString.

Hiermee geeft u de verbindingsreeks Azure SQL Server op, zoals Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Type implementatie
Invoeralias: TaskNameSelector. string. Vereist. Toegestane waarden: DacpacTask (SQL DACPAC-bestand), SqlTask (SQL-scriptbestand), InlineSqlTask (inline SQL-script). Standaardwaarde: DacpacTask.

DeploymentAction - Actie
string. Vereist wanneer TaskNameSelector = DacpacTask. Toegestane waarden: Publish, Extract, Export, Import, Script, ( DriftReport Driftrapport), DeployReport (Rapport implementeren). Standaardwaarde: Publish.

Hiermee geeft u een van de SQL-acties uit de lijst. Meer informatie over de lijst met SQL-acties.

DacpacFile - DACPAC-bestand
string. Vereist wanneer DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Hiermee geeft u de locatie van het DACPAC-bestand op de automatiseringsagent of op een UNC-pad dat toegankelijk is voor de automatiseringsagent, zoals \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Vooraf gedefinieerde systeemvariabelen, zoals $(agent.releaseDirectory), kunnen ook worden gebruikt.

BacpacFile - BACPAC-bestand
string. Vereist wanneer DeploymentAction = Import.

Hiermee geeft u de locatie van het BACPAC-bestand op de automatiseringsagent of op een UNC-pad dat toegankelijk is voor de automatiseringsagent, zoals \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Vooraf gedefinieerde systeemvariabelen, zoals $(agent.releaseDirectory), kunnen ook worden gebruikt.

SqlFile - SQL-script
string. Vereist wanneer TaskNameSelector = SqlTask.

Hiermee geeft u de locatie van het SQL-scriptbestand op de automatiseringsagent of op een UNC-pad dat toegankelijk is voor de automatiseringsagent, zoals \\BudgetIT\Web\Deploy\FabrikamDB.sql. Vooraf gedefinieerde systeemvariabelen, zoals $(agent.releaseDirectory), kunnen ook worden gebruikt.

SqlInline - Inline SQL-script
string. Vereist wanneer TaskNameSelector = InlineSqlTask.

Hiermee geeft u het SQL-script op dat moet worden uitgevoerd op de eerder geselecteerde database.

PublishProfile - Profiel publiceren
string. Optioneel. Gebruik wanneer TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Biedt gedetailleerde controle over het maken of upgraden van Azure SQL database.
Hiermee geeft u het pad naar het XML-bestand voor het publiceren van profielen op de automatiseringsagentcomputer of op een UNC-share. Als het publicatieprofiel geheimen bevat, zoals referenties, uploadt u het naar de beveiligde bestandsbibliotheek waar het veilig wordt opgeslagen met versleuteling. Gebruik vervolgens de taak Beveiligd bestand downloaden aan het begin van uw pijplijn om deze te downloaden naar de agentcomputer wanneer de pijplijn wordt uitgevoerd. Verwijder deze wanneer de pijplijn is voltooid. Vooraf gedefinieerde systeemvariabelen, zoals $(agent.buildDirectory) of $(agent.releaseDirectory), kunnen ook worden gebruikt.

AdditionalArguments - Aanvullende SqlPackage.exe argumenten
string. Optioneel. Gebruik wanneer TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Hiermee geeft u de aanvullende SqlPackage.exe argumenten op die worden toegepast bij het implementeren van de Azure SQL-database als de DACPAC-optie is geselecteerd, zoals /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Deze argumenten overschrijven de instellingen in het XML-bestand van het publicatieprofiel (indien opgegeven).

SqlAdditionalArguments - Aanvullende Invoke-Sqlcmd argumenten
string. Optioneel. Gebruik wanneer TaskNameSelector = SqlTask.

Hiermee geeft u de extra Invoke-Sqlcmd argumenten die worden toegepast bij het uitvoeren van de opgegeven SQL-query op de Azure SQL database, zoals -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Aanvullende Invoke-Sqlcmd argumenten
string. Optioneel. Gebruik wanneer TaskNameSelector = InlineSqlTask.

Hiermee geeft u de extra Invoke-Sqlcmd argumenten die worden toegepast bij het uitvoeren van de opgegeven SQL-query op de Azure SQL Database, zoals -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Firewallregels opgeven met
string. Vereist. Toegestane waarden: AutoDetect, IPAddressRange. Standaardwaarde: AutoDetect.

De taak kan alleen worden uitgevoerd als het IP-adres van de automatiseringsagent wordt toegevoegd aan toegestane IP-adressen in de firewall van de Azure SQL server. Selecteer Automatisch detecteren om automatisch de firewalluitzondering toe te voegen voor het bereik van het mogelijke IP-adres van de automatiseringsagent, of geef het bereik expliciet op.

StartIpAddress - IP-adres starten
string. Vereist wanneer IpDetectionMethod = IPAddressRange.

Hiermee geeft u het begin-IP-adres van de machinegroep van de automatiseringsagent op, zoals 196.21.30.50.

EndIpAddress - EIND-IP-adres
string. Vereist wanneer IpDetectionMethod = IPAddressRange.

Hiermee geeft u het eind-IP-adres van de machinegroep van de automatiseringsagent op, zoals 196.21.30.65.

DeleteFirewallRule - Regel verwijderen nadat de taak is beëindigd
boolean. Standaardwaarde: true.

Als deze optie is geselecteerd, worden de IP-adressen die hier zijn opgegeven, verwijderd uit de lijst Toegestane IP-adressen in de firewall van de Azure SQL Server.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

SqlDeploymentOutputFile
Het pad naar het gegenereerde uitvoerbestand wanneer de actie voor het implementatiepakket , Export, Script, DriftReportof DeployReportisExtract.

Opmerkingen

Gebruik deze taak om een Azure SQL-database te implementeren met behulp van een DACPAC of scripts uit te voeren met behulp van SQLCMD.

Belangrijk

Deze taak wordt alleen ondersteund in een Windows-omgeving. Als u geïntegreerde Azure AD-verificatie (Azure Active Directory) wilt gebruiken, moet u een privéagent maken. Geïntegreerde Azure AD-verificatie wordt niet ondersteund voor gehoste agents.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die gebruikmaken van deze taak: sqlpackage
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.103.0 of hoger
Taakcategorie	Implementeren