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.

Syntaxis

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

Invoer

azureConnectionType - azure-serviceverbindingstype
Invoeralias: ConnectedServiceNameSelector. string. Toegestane waarden: ConnectedServiceName (klassiek Azure), ConnectedServiceNameARM (Azure Resource Manager). Standaardwaarde: ConnectedServiceNameARM.

azureClassicSubscription - klassieke 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. Verplicht. 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. Het 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 context van het Active Directory-account.

Geef de optie op om verbinding te maken met de Azure SQL Server-database. U kunt de azure SQL Server-databasegegevens, de SQL Server-verbindingsreeks, AD-verificatie (wachtwoord of geïntegreerd) opgeven of een service-principal gebruiken. Voor SQL Server-verificatie gebruikt u de gebruikersreferenties van SQL Server. Voor AD-verificatie gebruikt u 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 Server-naam, zoals Fabrikam.database.windows.net.placeholder,1433 of Fabrikam.database.windows.net.placeholder.

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

Hiermee geeft u de naam op van de Azure SQL-database waar de bestanden worden geïmplementeerd.

SqlUsername - aanmeldings-
string. Vereist wanneer AuthenticationType = server.

Hiermee geeft u de aanmelding van de Azure SQL Server-beheerder op.

SqlPassword - wachtwoord
string. Vereist wanneer AuthenticationType = server.

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

aadSqlUsername - aanmeldings-
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 in de build- of release-pijplijnen zijn gedefinieerd als $(passwordVariable) worden geaccepteerd. U kunt het variabeletype markeren als secret om het te beveiligen.

ConnectionString - verbindingsreeks
string. Vereist wanneer AuthenticationType = connectionString.

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

deployType - Type implementeren
Invoeralias: TaskNameSelector. string. Verplicht. Toegestane waarden: DacpacTask (SQL DACPAC-bestand), SqlTask (SQL Script File), 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. Facultatief. Gebruiken wanneer TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Biedt gedetailleerde controle over het maken of upgraden van Azure SQL-databases.
Hiermee geeft u het pad naar het XML-bestand van het publicatieprofiel op de automatiseringsagentcomputer of op een UNC-share. Als het publicatieprofiel geheimen bevat, zoals referenties, uploadt u het naar de beveiligde bestanden bibliotheek waar het veilig wordt opgeslagen met versleuteling. Gebruik vervolgens het Beveiligd bestand downloaden taak aan het begin van de pijplijn om het 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 - Extra SqlPackage.exe argumenten
string. Facultatief. Gebruiken wanneer TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

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

SqlAdditionalArguments - Extra Invoke-Sqlcmd argumenten
string. Facultatief. Gebruiken 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 - Extra Invoke-Sqlcmd argumenten
string. Facultatief. Gebruiken 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 behulp van
string. Verplicht. Toegestane waarden: AutoDetect, IPAddressRange. Standaardwaarde: AutoDetect.

Om de taak uit te voeren, moet het IP-adres van de automatiseringsagent worden toegevoegd aan de toegestane IP-adressen in de firewall van Azure SQL Server. Selecteer automatisch detecteren om automatisch de firewall-uitzondering 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 automatiseringsagent, 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 automation-agent, 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 met toegestane IP-adressen lijst in de firewall van Azure SQL Server.

Opties voor taakbeheer

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

Uitvoervariabelen

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

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

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 verificatie van Azure Active Directory (Azure AD) wilt gebruiken, moet u een privéagent maken. Geïntegreerde Azure AD-verificatie wordt niet ondersteund voor gehoste agents.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Vertegenwoordiger
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen om taken uit te voeren die gebruikmaken van deze taak: sqlpackage
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.103.0 of hoger
Taakcategorie	Implementeren