SqlAzureDacpacDeployment@1 — zadanie wdrażania usługi Azure SQL Database w wersji 1

To zadanie służy do wdrażania usługi Azure SQL Database 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 usługi platformy Azure
Alias wejściowy: ConnectedServiceNameSelector. string. Dozwolone wartości: ConnectedServiceName (wersja klasyczna platformy Azure), ConnectedServiceNameARM (Azure Resource Manager). Wartość domyślna: ConnectedServiceNameARM.

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

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

azureSubscription - subskrypcji 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 uwierzytelnienia
string. To jest wymagane. Dozwolone wartości: server (uwierzytelnianie programu SQL Server), aadAuthenticationPassword (Active Directory — hasło), aadAuthenticationIntegrated (Active Directory — integrated), connectionString (parametry połączenia), servicePrincipal (jednostka usługi). Wartość domyślna: server.

Określa typ uwierzytelniania bazy danych. Może to być program SQL Server, usługa Active Directory (zintegrowana), usługa Active Directory (hasło), parametry połączenia lub uwierzytelnianie jednostki usługi. Zintegrowane uwierzytelnianie oznacza, że agent będzie miał 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 programu Azure SQL Server. Możesz podać szczegóły bazy danych programu Azure SQL Server, parametry połączenia programu SQL Server, uwierzytelnianie usługi AD (hasło lub zintegrowane) lub użyć jednostki usługi. W przypadku uwierzytelniania programu SQL Server użyj poświadczeń użytkownika programu SQL Server. W przypadku uwierzytelniania usługi AD użyj poświadczeń dla użytkownika usługi AD skonfigurowanego do programu SQL Server.

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

Określa nazwę programu Azure SQL Server, taką jak Fabrikam.database.windows.net.placeholder,1433 lub Fabrikam.database.windows.net.placeholder.

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

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

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

Określa identyfikator logowania administratora programu Azure SQL Server.

haseł SqlPassword -
string. Wymagane, gdy AuthenticationType = server.

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

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

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

haseł aadSqlPassword -
string. Wymagane, gdy AuthenticationType = aadAuthenticationPassword.

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

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

Określa parametry połączenia programu Azure SQL Server, takie jak Server=testServer.database.windows.net.placeholder;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Wdróż typ
Alias wejściowy: TaskNameSelector. string. To jest wymagane. Dozwolone wartości: DacpacTask (plik SQL DACPAC), SqlTask (plik skryptu SQL), InlineSqlTask (wbudowany skrypt SQL). Wartość domyślna: DacpacTask.

DeploymentAction - akcja
string. Wymagane, gdy TaskNameSelector = DacpacTask. Dozwolone wartości: Publish, Extract, Export, Import, Script, DriftReport (raport driftu), DeployReport (Wdrażanie raportu). Wartość domyślna: Publish.

Określa jedną z akcji SQL z listy. Dowiedz się więcej na temat listy akcji SQL.

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

Określa lokalizację pliku DACPAC na agencie automatyzacji lub ścieżkę UNC dostępną dla agenta automatyzacji, na przykład \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Można również użyć wstępnie zdefiniowanych zmiennych systemowych, takich jak $(agent.releaseDirectory).

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

Określa lokalizację pliku BACPAC na agencie automatyzacji lub ścieżkę UNC dostępną dla agenta automatyzacji, na przykład \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Można również użyć wstępnie zdefiniowanych zmiennych systemowych, takich jak $(agent.releaseDirectory).

skryptu SQL SqlFile -
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. Można również użyć wstępnie zdefiniowanych zmiennych systemowych, takich jak $(agent.releaseDirectory).

SqlInline - wbudowane skryptu SQL
string. Wymagane, gdy TaskNameSelector = InlineSqlTask.

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

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

Zapewnia szczegółową kontrolę nad tworzeniem lub uaktualnianiem bazy danych Azure SQL Database.
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 bezpiecznych plików biblioteki, 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 - dodatkowych argumentów 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 argumenty SqlPackage.exe, które będą stosowane podczas wdrażania bazy danych Azure SQL Database, 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 - dodatkowych argumentów 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 Database, na przykład -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - dodatkowych argumentów 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. To jest wymagane. Dozwolone wartości: AutoDetect, IPAddressRange. Wartość domyślna: AutoDetect.

Aby zadanie było uruchamiane, należy dodać adres IP agenta automatyzacji do dozwolone adresy IP w zaporze programu Azure SQL Server. 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.

Jeśli to pole zostanie wybrane, po zakończeniu zadania adresy IP określone tutaj zostaną usunięte z listy dozwolone adresy IP w zaporze programu Azure SQL Server.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli 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żeniowego to Extract, Export, Script, DriftReportlub DeployReport.

Uwagi

To zadanie służy do wdrażania bazy danych Azure SQL Database 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ć agenta prywatnego. Zintegrowane uwierzytelnianie usługi Azure AD nie jest obsługiwane w przypadku hostowanych agentów.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do 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ń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.103.0 lub nowsza
Kategoria zadań	Zastosuj