SqlAzureDacpacDeployment@1 — zadanie wdrażania bazy danych Azure SQL w wersji 1

To zadanie służy do wdrażania bazy danych Azure SQL przy użyciu pakietu DACPAC lub uruchamiania skryptów przy użyciu narzędzia SQLCMD.

Składnia

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

Dane wejściowe

azureConnectionType - Typ połączenia z usługą platformy Azure
Alias wejściowy: ConnectedServiceNameSelector. string. Dozwolone wartości: ConnectedServiceName (wersja klasyczna platformy Azure), ConnectedServiceNameARM (Azure Resource Manager). Wartość domyślna: ConnectedServiceNameARM.

azureClassicSubscription - Klasyczna subskrypcja platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

Określa docelową subskrypcję klasyczną platformy Azure na potrzeby wdrażania plików SQL.

azureSubscription - Subskrypcja platformy Azure
Alias wejściowy: ConnectedServiceNameARM. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameARM.

Określa docelową subskrypcję usługi Azure Resource Manager na potrzeby wdrażania plików SQL.

AuthenticationType - Typ uwierzytelniania
string. Wymagane. Dozwolone wartości: server (SQL Server Authentication), aadAuthenticationPassword (Active Directory — hasło), aadAuthenticationIntegrated (Active Directory — zintegrowane), (parametry połączenia), connectionStringservicePrincipal (jednostka usługi). Wartość domyślna: server.

Określa typ uwierzytelniania bazy danych. Może to być SQL Server, Active Directory (zintegrowane), Active Directory (hasło), parametry połączenia lub uwierzytelnianie jednostki usługi. Zintegrowane uwierzytelnianie oznacza, że agent uzyskuje dostęp do bazy danych przy użyciu bieżącego kontekstu konta usługi Active Directory.

Określ opcję nawiązywania połączenia z bazą danych serwera Azure SQL. Możesz podać szczegóły bazy danych serwera Azure SQL, SQL Server parametry połączenia, uwierzytelnianie usługi AD (hasło lub zintegrowane) lub użyć jednostki usługi. W przypadku uwierzytelniania SQL Server użyj poświadczeń użytkownika SQL Server. W przypadku uwierzytelniania w usłudze AD użyj poświadczeń dla użytkownika usługi AD skonfigurowanego do SQL Server.

ServerName - Azure SQL Server
string. Wymagane, gdy AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Określa nazwę serwera Azure SQL, na przykład Fabrikam.database.windows.net,1433 lub Fabrikam.database.windows.net.

DatabaseName - Bazy danych
string. Wymagane, gdy AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Określa nazwę Azure SQL bazy danych, w której są wdrażane pliki.

SqlUsername - Logowania
string. Wymagane, gdy AuthenticationType = server.

Określa identyfikator logowania administratora serwera Azure SQL.

SqlPassword - Hasło
string. Wymagane, gdy AuthenticationType = server.

Określa hasło administratora serwera Azure SQL. Zmienne zdefiniowane w potokach kompilacji lub wydania, które $(passwordVariable) są akceptowane. Możesz oznaczyć typ zmiennej jako secret , aby ją zabezpieczyć.

aadSqlUsername - Logowania
string. Wymagane, gdy AuthenticationType = aadAuthenticationPassword.

Określa nazwę użytkownika usługi Active Directory.

aadSqlPassword - Hasło
string. Wymagane, gdy AuthenticationType = aadAuthenticationPassword.

Określa hasło użytkownika usługi Active Directory. Zmienne zdefiniowane w potokach kompilacji lub wydania, które $(passwordVariable) są akceptowane. Możesz oznaczyć typ zmiennej jako secret , aby ją zabezpieczyć.

ConnectionString - Parametry połączenia
string. Wymagane, gdy AuthenticationType = connectionString.

Określa parametry połączenia serwera Azure SQL, na przykład Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Typ wdrożenia
Alias wejściowy: TaskNameSelector. string. Wymagane. Dozwolone wartości: DacpacTask (plik SQL DACPAC), SqlTask (plik skryptu SQL), InlineSqlTask (wbudowany skrypt SQL). Wartość domyślna: DacpacTask.

DeploymentAction - Działania
string. Wymagane, gdy TaskNameSelector = DacpacTask. Dozwolone wartości: Publish, , ExportExtractImport, , Script, DriftReport (Raport driftu), DeployReport (Wdróż raport). Wartość domyślna: Publish.

Określa jedną z akcji SQL z listy. Dowiedz się więcej o liście akcji SQL.

DacpacFile - Plik DACPAC
string. Wymagane, gdy DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Określa lokalizację pliku DACPAC w agencie automatyzacji lub ścieżkę UNC dostępną dla agenta automatyzacji, na przykład \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Wstępnie zdefiniowane zmienne systemowe, takie jak $(agent.releaseDirectory), mogą być również używane.

BacpacFile - Plik BACPAC
string. Wymagane, gdy DeploymentAction = Import.

Określa lokalizację pliku BACPAC w agencie automatyzacji lub ścieżkę UNC dostępną dla agenta automatyzacji, na przykład \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Wstępnie zdefiniowane zmienne systemowe, takie jak $(agent.releaseDirectory), mogą być również używane.

SqlFile - Skrypt SQL
string. Wymagane, gdy TaskNameSelector = SqlTask.

Określa lokalizację pliku skryptu SQL w agencie automatyzacji lub ścieżkę UNC dostępną dla agenta automatyzacji, na przykład \\BudgetIT\Web\Deploy\FabrikamDB.sql. Wstępnie zdefiniowane zmienne systemowe, takie jak $(agent.releaseDirectory), mogą być również używane.

SqlInline - Wbudowany skrypt SQL
string. Wymagane, gdy TaskNameSelector = InlineSqlTask.

Określa skrypt SQL do wykonania w wcześniej wybranej bazie danych.

PublishProfile - Publikowanie profilu
string. Opcjonalny. Użyj polecenia , gdy TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Zapewnia szczegółową kontrolę nad tworzeniem lub uaktualnianiem bazy danych Azure SQL.
Określa ścieżkę do pliku XML profilu publikowania na maszynie agenta automatyzacji lub w udziale UNC. Jeśli profil publikowania zawiera wpisy tajne, takie jak poświadczenia, przekaż go do bezpiecznej biblioteki plików , w której jest bezpiecznie przechowywany przy użyciu szyfrowania. Następnie użyj zadania Pobierz bezpieczny plik na początku potoku, aby pobrać go na maszynę agenta po uruchomieniu potoku. Usuń go po zakończeniu potoku. Można również użyć wstępnie zdefiniowanych zmiennych systemowych, takich jak $(agent.buildDirectory) lub $(agent.releaseDirectory), .

AdditionalArguments - Dodatkowe argumenty SqlPackage.exe
string. Opcjonalny. Użyj polecenia , gdy TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Określa dodatkowe SqlPackage.exe argumenty, które zostaną zastosowane podczas wdrażania bazy danych Azure SQL, jeśli wybrano opcję DACPAC, na przykład /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Te argumenty zastąpią ustawienia w pliku XML profilu publikowania (jeśli podano).

SqlAdditionalArguments - Dodatkowe argumenty Invoke-Sqlcmd
string. Opcjonalny. Użyj polecenia , gdy TaskNameSelector = SqlTask.

Określa dodatkowe argumenty Invoke-Sqlcmd, które są stosowane podczas wykonywania danego zapytania SQL w bazie danych Azure SQL, na przykład -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Dodatkowe argumenty Invoke-Sqlcmd
string. Opcjonalny. Użyj polecenia , gdy TaskNameSelector = InlineSqlTask.

Określa dodatkowe argumenty Invoke-Sqlcmd, które są stosowane podczas wykonywania danego zapytania SQL w usłudze Azure SQL Database, na przykład -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Określanie reguł zapory przy użyciu
string. Wymagane. Dozwolone wartości: AutoDetect, IPAddressRange. Wartość domyślna: AutoDetect.

Aby zadanie było uruchamiane, należy dodać adres IP agenta automatyzacji do dozwolonych adresów IP w zaporze serwera Azure SQL. Wybierz opcję automatycznego wykrywania, aby automatycznie dodać wyjątek zapory dla zakresu możliwego adresu IP agenta automatyzacji lub jawnie określić zakres.

StartIpAddress - Początkowy adres IP
string. Wymagane, gdy IpDetectionMethod = IPAddressRange.

Określa początkowy adres IP puli maszyn agenta automatyzacji, na przykład 196.21.30.50.

EndIpAddress - Końcowy adres IP
string. Wymagane, gdy IpDetectionMethod = IPAddressRange.

Określa końcowy adres IP puli maszyn agenta automatyzacji, na przykład 196.21.30.65.

DeleteFirewallRule - Usuń regułę po zakończeniu zadania
boolean. Wartość domyślna: true.

W przypadku wybrania opcji po zakończeniu zadania adresy IP określone w tym miejscu zostaną usunięte z listy Dozwolone adresy IP w zaporze serwera Azure SQL.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

To zadanie definiuje następujące zmienne wyjściowe, które można używać w krokach podrzędnych, zadaniach i etapach.

SqlDeploymentOutputFile
Wygenerowana ścieżka pliku wyjściowego, gdy akcja pakietu wdrożenia to Extract, , ScriptExport, DriftReportlub DeployReport.

Uwagi

To zadanie służy do wdrażania bazy danych Azure SQL przy użyciu pakietu DACPAC lub uruchamiania skryptów przy użyciu narzędzia SQLCMD.

Ważne

To zadanie jest obsługiwane tylko w środowisku systemu Windows. Jeśli próbujesz użyć zintegrowanego uwierzytelniania usługi Azure Active Directory (Azure AD), musisz utworzyć prywatnego agenta. Zintegrowane uwierzytelnianie usługi Azure AD nie jest obsługiwane w przypadku hostowanych agentów.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: sqlpackage
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	1.103.0 lub nowsza
Kategoria zadania	Wdrażanie