Azure SQL veritabanı dağıtımı

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Veritabanı güncelleştirmelerinizi her başarılı derlemeden sonra Azure SQL veritabanına otomatik olarak dağıtabilirsiniz.

DACPAC

Veritabanını dağıtmanın en basit yolu, veri katmanı paketi veya DACPAC oluşturmaktır. DACPAC'ler şema değişikliklerini ve verilerini paketlemek ve dağıtmak için kullanılabilir. Visual Studio'daki SQL veritabanı projesini kullanarak bir DACPAC oluşturabilirsiniz.

YAML

DaCPAC'yi bir Azure SQL veritabanına dağıtmak için aşağıdaki kod parçacığını azure-pipelines.yml dosyanıza ekleyin.

- task: SqlAzureDacpacDeployment@1
  displayName: Execute Azure SQL : DacpacTask
  inputs:
    azureSubscription: '<Azure service connection>'
    ServerName: '<Database server name>'
    DatabaseName: '<Database name>'
    SqlUsername: '<SQL user name>'
    SqlPassword: '<SQL user password>'
    DacpacFile: '<Location of Dacpac file in $(Build.SourcesDirectory) after compilation>'

Klasik

Visual Studio veritabanı projeniz için bir derleme işlem hattı ayarlarken .NET masaüstü şablonunu kullanın. Bu şablon, projeyi derlemek ve DACPAC dahil olmak üzere yapıtları yayımlamak için görevleri otomatik olarak ekler.

Yayın işlem hattını ayarlarken Boş bir işlem hattıyla başlat'ı seçin, derlemedeki yapıtları bağlayın ve Azure SQL Veritabanı Dağıtım görevi ekleyin.

Ayrıca bkz. Azure SQL Veritabanı Dağıtım görevi kullanılırken kimlik doğrulama bilgileri.

SQL betikleri

VERITABANınızı dağıtmak için DACPAC kullanmak yerine SQL betiklerini de kullanabilirsiniz. Boş veritabanı oluşturan basit bir SQL betiği örneği aşağıda verilmiştır.

  USE [main]
  GO
  IF NOT EXISTS (SELECT name FROM main.sys.databases WHERE name = N'DatabaseExample')
  CREATE DATABASE [DatabaseExample]
  GO

SQL betiklerini bir işlem hattının parçası olarak çalıştırmak için Azure'da güvenlik duvarı kuralları oluşturmak ve kaldırmak için Azure PowerShell betiklerine ihtiyacınız vardır. Güvenlik duvarı kuralları olmadan Azure Pipelines aracısı Azure SQL Veritabanı ile iletişim kuramaz.

Aşağıdaki PowerShell betiği güvenlik duvarı kuralları oluşturur. Bu betiği deponuza iade SetAzureFirewallRule.ps1 edebilirsiniz.

ARM

[CmdletBinding(DefaultParameterSetName = 'None')]
param
(
  [String] [Parameter(Mandatory = $true)] $ServerName,
  [String] [Parameter(Mandatory = $true)] $ResourceGroupName,
  [String] $FirewallRuleName = "AzureWebAppFirewall"
)
$agentIP = (New-Object net.webclient).downloadstring("https://api.ipify.org")
New-AzSqlServerFirewallRule -ResourceGroupName $ResourceGroupName -ServerName $ServerName -FirewallRuleName $FirewallRuleName -StartIPAddress $agentIp -EndIPAddress $agentIP

Klasik

[CmdletBinding(DefaultParameterSetName = 'None')]
param
(
  [String] [Parameter(Mandatory = $true)] $ServerName,
  [String] [Parameter(Mandatory = $true)] $ResourceGroupName,
  [String] $FirewallRuleName = "AzureWebAppFirewall"
)

$ErrorActionPreference = 'Stop'

function New-AzureSQLServerFirewallRule {
  $agentIP = (New-Object net.webclient).downloadstring("https://api.ipify.org")
  New-AzureSqlDatabaseServerFirewallRule -StartIPAddress $agentIp -EndIPAddress $agentIp -RuleName $FirewallRuleName -ServerName $ServerName
}

function Update-AzureSQLServerFirewallRule{
  $agentIP= (New-Object net.webclient).downloadstring("https://api.ipify.org")
  Set-AzureSqlDatabaseServerFirewallRule -StartIPAddress $agentIp -EndIPAddress $agentIp -RuleName $FirewallRuleName -ServerName $ServerName
}

if ((Get-AzureSqlDatabaseServerFirewallRule -ServerName $ServerName -RuleName $FirewallRuleName -ErrorAction SilentlyContinue) -eq $null)
{
  New-AzureSQLServerFirewallRule
}
else
{
  Update-AzureSQLServerFirewallRule
}

Aşağıdaki PowerShell betiği güvenlik duvarı kurallarını kaldırır. Bu betiği deponuza iade RemoveAzureFirewallRule.ps1 edebilirsiniz.

ARM

[CmdletBinding(DefaultParameterSetName = 'None')]
param
(
  [String] [Parameter(Mandatory = $true)] $ServerName,
  [String] [Parameter(Mandatory = $true)] $ResourceGroupName,
  [String] $FirewallRuleName = "AzureWebAppFirewall"
)
Remove-AzSqlServerFirewallRule -ServerName $ServerName -FirewallRuleName $FirewallRuleName -ResourceGroupName $ResourceGroupName

Klasik

[CmdletBinding(DefaultParameterSetName = 'None')]
param
(
  [String] [Parameter(Mandatory = $true)] $ServerName,
  [String] [Parameter(Mandatory = $true)] $ResourceGroupName,
  [String] $FirewallRuleName = "AzureWebAppFirewall"
)

$ErrorActionPreference = 'Stop'

if ((Get-AzureSqlDatabaseServerFirewallRule -ServerName $ServerName -RuleName $FirewallRuleName -ErrorAction SilentlyContinue))
{
  Remove-AzureSqlDatabaseServerFirewallRule -RuleName $FirewallRuleName -ServerName $ServerName
}

YAML

SQL betiğini çalıştırmak için azure-pipelines.yml dosyanıza aşağıdakileri ekleyin.

variables:
  AzureSubscription: '<SERVICE_CONNECTION_NAME>'
  ResourceGroupName: '<RESOURCE_GROUP_NAME>'
  ServerName: '<DATABASE_SERVER_NAME>'
  ServerFqdn: '<DATABASE_FQDN>'
  DatabaseName: '<DATABASE_NAME>'
  AdminUser: '<DATABASE_USERNAME>'
  AdminPassword: '<DATABASE_PASSWORD>'
  SQLFile: '<LOCATION_OF_SQL_FILE_IN_$(Build.SourcesDirectory)>'

steps:
- task: AzurePowerShell@5
  displayName: 'Azure PowerShell script'
  inputs:
    azureSubscription: '$(AzureSubscription)'
    ScriptType: filePath
    ScriptPath: '$(Build.SourcesDirectory)\scripts\SetAzureFirewallRule.ps1'
    ScriptArguments: '-ServerName $(ServerName) -ResourceGroupName $(ResourceGroupName)'
    azurePowerShellVersion: LatestVersion

- task: CmdLine@2
  displayName: Run Sqlcmd
  inputs:
    filename: sqlcmd
    arguments: '-S $(ServerFqdn) -U $(AdminUser) -P $(AdminPassword) -d $(DatabaseName) -i $(SQLFile)'

- task: AzurePowerShell@5
  displayName: 'Azure PowerShell script'
  inputs:
    azureSubscription: '$(AzureSubscription)'
    ScriptType: filePath
    ScriptPath: '$(Build.SourcesDirectory)\scripts\RemoveAzureFirewallRule.ps1'
    ScriptArguments: '-ServerName $(ServerName) -ResourceGroupName $(ResourceGroupName)'
    azurePowerShellVersion: LatestVersion

Klasik

Derleme işlem hattı ayarladığınızda, veritabanını dağıtacak SQL betiğinin ve güvenlik duvarı kurallarını yapılandırmak için Azure PowerShell betiklerinin derleme yapıtının bir parçası olduğundan emin olun.

Yayın işlem hattını ayarlarken Boş işlemle başla'yı seçin, derlemedeki yapıtları bağlayın ve aşağıdaki görevleri kullanın:

• İlk olarak, Azure Pipelines aracısının Azure SQL Veritabanı bağlanmasına izin vermek üzere Azure'da bir güvenlik duvarı kuralı eklemek için bir Azure PowerShell görevi kullanın. Betik, oluşturduğunuz SQL sunucusunun adı olan bir bağımsız değişken gerektirir.
• İkincisi, SQLCMD aracını kullanarak SQL betiğini çalıştırmak için bir Komut satırı görevi kullanın. Bu aracın bağımsız değişkenleri şunlardır -S {database-server-name}.database.windows.net -U {username}@{database-server-name} -P {password} -d {database-name} -i {SQL file} : Örneğin, SQL betiği bir yapıt kaynağından geldiğinde, {SQL dosyası} biçiminde olacaktır: $(System.DefaultWorkingDirectory)/contoso-repo/DatabaseExample.sql.
• Üçüncüsü, Azure'da güvenlik duvarı kuralını kaldırmak için başka bir Azure PowerShell görevi kullanın.

Azure hizmet bağlantısı

Azure SQL Veritabanı Dağıtımı görevi, veritabanını Azure'a dağıtmaya ilişkin birincil mekanizmadır. Bu görev, diğer yerleşik Azure görevlerinde olduğu gibi giriş olarak bir Azure hizmet bağlantısı gerektirir. Azure hizmet bağlantısı, Azure Pipelines'tan Azure'a bağlanmak için kimlik bilgilerini depolar.

Bu görevi kullanmaya başlamanın en kolay yolu, hem Azure DevOps kuruluşuna hem de Azure aboneliğine sahip bir kullanıcı olarak oturum açmaktır. Bu durumda hizmet bağlantısını el ile oluşturmanız gerekmez. Aksi takdirde, Azure hizmet bağlantısı oluşturmayı öğrenmek için bkz . Azure hizmet bağlantısı oluşturma.

Koşullu olarak dağıtma

Azure veritabanınıza yalnızca belirli derlemeleri dağıtmayı seçebilirsiniz.

YAML

Bunu YAML'de yapmak için şu tekniklerden birini kullanabilirsiniz:

• Dağıtım adımlarını ayrı bir işte yalıtın ve bu işe bir koşul ekleyin.
• Adıma bir koşul ekleyin.

Aşağıdaki örnekte, yalnızca ana daldan kaynaklanan derlemeleri dağıtmak için adım koşullarının nasıl kullanılacağı gösterilmektedir.

- task: SqlAzureDacpacDeployment@1
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
  inputs:
    azureSubscription: '<Azure service connection>'
    ServerName: '<Database server name>'
    DatabaseName: '<Database name>'
    SqlUsername: '<SQL user name>'
    SqlPassword: '<SQL user password>'
    DacpacFile: '<Location of Dacpac file in $(Build.SourcesDirectory) after compilation>'

Koşullar hakkında daha fazla bilgi edinmek için bkz . Koşulları belirtme.

Klasik

Yayın işlem hattınızda dağıtımı denetlemek için çeşitli denetimler ve koşullar uygulayabilirsiniz.

Not

Bazı kurulumlarda, haftalık JSON dosyasında güncelleştirilen belirli bir bölge için IP adresi aralığını izin verilenler listesine eklemeniz gerekebilir. Microsoft tarafından barındırılan aracıların ağ iletişimi hakkında bilgi edinin.

• Yayın işlem hattının yapıtı üzerinde sürekli dağıtım tetikleyicisini yapılandırmak için dal filtrelerini ayarlayın.
• Dağıtım öncesi onayları, bir aşamaya dağıtım için ön koşul olarak ayarlayın.
• Geçitleri bir aşamaya dağıtım için ön koşul olarak yapılandırın.
• Görevin çalıştırılması için koşulları belirtin.

Daha fazla bilgi edinmek için bkz. Yayın, dal ve aşama tetikleyicileri, Onayları kullanarak dağıtım denetimini serbest bırakma, Geçitleri kullanarak dağıtım denetimini serbest bırakma ve Görevi çalıştırma koşullarını belirtme.

Diğer SQL eylemleri

SQL Azure Dacpac Dağıtımı , gerçekleştirmek istediğiniz tüm SQL server eylemlerini desteklemeyebilir. Böyle durumlarda, ihtiyacınız olan komutları çalıştırmak için PowerShell veya komut satırı betiklerini kullanabilirsiniz. Bu bölümde, SqlPackage.exe aracını çağırmaya yönelik bazı yaygın kullanım örnekleri gösterilmektedir. Bu aracı çalıştırmanın önkoşulu olarak, şirket içinde barındırılan bir aracı kullanmanız ve aracını aracınızda yüklü olması gerekir.

Not

SQLPackage'ı yüklendiği klasörden yürütürseniz, yolu ön ekleyip & çift tırnak içine sarmalamanız gerekir.

Temel Söz Dizimi

<Path of SQLPackage.exe> <Arguments to SQLPackage.exe>

Gerçekleştirmek istediğiniz eyleme bağlı olarak aşağıdaki SQL betiklerinden herhangi birini kullanabilirsiniz

Ayıkla

Canlı sql sunucusundan veya Microsoft Azure SQL Veritabanı veritabanı anlık görüntüsü (.dacpac) dosyası oluşturur.

Komut Sözdizimi:

SqlPackage.exe /TargetFile:"<Target location of dacpac file>" /Action:Extract
/SourceServerName:"<ServerName>.database.windows.net"
/SourceDatabaseName:"<DatabaseName>" /SourceUser:"<Username>" /SourcePassword:"<Password>"

veya

SqlPackage.exe /action:Extract /tf:"<Target location of dacpac file>"
/SourceConnectionString:"Data Source=ServerName;Initial Catalog=DatabaseName;Integrated Security=SSPI;Persist Security Info=False;"

Örnek:

SqlPackage.exe /TargetFile:"C:\temp\test.dacpac" /Action:Extract /SourceServerName:"DemoSqlServer.database.windows.net"
 /SourceDatabaseName:"Testdb" /SourceUser:"ajay" /SourcePassword:"SQLPassword"

Yardım:

sqlpackage.exe /Action:Extract /?

Yayımlama

Bir veritabanı şemasını, kaynak .dacpac dosyasının şemasıyla eşleşecek şekilde artımlı olarak güncelleştirir. Veritabanı sunucuda yoksa yayımlama işlemi bunu oluşturur. Aksi takdirde, mevcut bir veritabanı güncelleştirilir.

Komut Sözdizimi:

SqlPackage.exe /SourceFile:"<Dacpac file location>" /Action:Publish /TargetServerName:"<ServerName>.database.windows.net"
/TargetDatabaseName:"<DatabaseName>" /TargetUser:"<Username>" /TargetPassword:"<Password> "

Örnek:

SqlPackage.exe /SourceFile:"E:\dacpac\ajyadb.dacpac" /Action:Publish /TargetServerName:"DemoSqlServer.database.windows.net"
/TargetDatabaseName:"Testdb4" /TargetUser:"ajay" /TargetPassword:"SQLPassword"

Yardım:

sqlpackage.exe /Action:Publish /?

Export

Veritabanı şeması ve kullanıcı verileri de dahil olmak üzere canlı veritabanını SQL Server'dan veya Microsoft Azure SQL Veritabanı bir BACPAC paketine (.bacpac dosyası) aktarır.

Komut Sözdizimi:

SqlPackage.exe /TargetFile:"<Target location for bacpac file>" /Action:Export /SourceServerName:"<ServerName>.database.windows.net"
/SourceDatabaseName:"<DatabaseName>" /SourceUser:"<Username>" /SourcePassword:"<Password>"

Örnek:

SqlPackage.exe /TargetFile:"C:\temp\test.bacpac" /Action:Export /SourceServerName:"DemoSqlServer.database.windows.net"
/SourceDatabaseName:"Testdb" /SourceUser:"ajay" /SourcePassword:"SQLPassword"

Yardım:

sqlpackage.exe /Action:Export /?

İçeri Aktar

Şema ve tablo verilerini bir BACPAC paketinden SQL Server veya Microsoft Azure SQL Veritabanı örneğindeki yeni bir kullanıcı veritabanına aktarır.

Komut Sözdizimi:

SqlPackage.exe /SourceFile:"<Bacpac file location>" /Action:Import /TargetServerName:"<ServerName>.database.windows.net"
/TargetDatabaseName:"<DatabaseName>" /TargetUser:"<Username>" /TargetPassword:"<Password>"

Örnek:

SqlPackage.exe /SourceFile:"C:\temp\test.bacpac" /Action:Import /TargetServerName:"DemoSqlServer.database.windows.net"
/TargetDatabaseName:"Testdb" /TargetUser:"ajay" /TargetPassword:"SQLPassword"

Yardım:

sqlpackage.exe /Action:Import /?

DeployReport

Yayımlama eylemi tarafından yapılacak değişikliklerin XML raporunu oluşturur.

Komut Sözdizimi:

SqlPackage.exe /SourceFile:"<Dacpac file location>" /Action:DeployReport /TargetServerName:"<ServerName>.database.windows.net"
/TargetDatabaseName:"<DatabaseName>" /TargetUser:"<Username>" /TargetPassword:"<Password>" /OutputPath:"<Output XML file path for deploy report>"

Örnek:

SqlPackage.exe /SourceFile:"E: \dacpac\ajyadb.dacpac" /Action:DeployReport /TargetServerName:"DemoSqlServer.database.windows.net"
/TargetDatabaseName:"Testdb" /TargetUser:"ajay" /TargetPassword:"SQLPassword" /OutputPath:"C:\temp\deployReport.xml" 

Yardım:

sqlpackage.exe /Action:DeployReport /?

DriftReport

En son kaydedildiğinden bu yana kayıtlı bir veritabanında yapılan değişikliklerin XML raporunu oluşturur.

Komut Sözdizimi:

SqlPackage.exe /Action:DriftReport /TargetServerName:"<ServerName>.database.windows.net" /TargetDatabaseName:"<DatabaseName>"
/TargetUser:"<Username>" /TargetPassword:"<Password>" /OutputPath:"<Output XML file path for drift report>"

Örnek:

SqlPackage.exe /Action:DriftReport /TargetServerName:"DemoSqlServer.database.windows.net" /TargetDatabaseName:"Testdb"
/TargetUser:"ajay" /TargetPassword:"SQLPassword" /OutputPath:"C:\temp\driftReport.xml"

Yardım:

sqlpackage.exe /Action:DriftReport /?

Komut Dosyası

Hedefin şemasını bir kaynağın şemasıyla eşleşecek şekilde güncelleştiren bir Transact-SQL artımlı güncelleştirme betiği oluşturur.

Komut Sözdizimi:

SqlPackage.exe /SourceFile:"<Dacpac file location>" /Action:Script /TargetServerName:"<ServerName>.database.windows.net"
/TargetDatabaseName:"<DatabaseName>" /TargetUser:"<Username>" /TargetPassword:"<Password>" /OutputPath:"<Output SQL script file path>"

Örnek:

SqlPackage.exe /Action:Script /SourceFile:"E:\dacpac\ajyadb.dacpac" /TargetServerName:"DemoSqlServer.database.windows.net"
/TargetDatabaseName:"Testdb" /TargetUser:"ajay" /TargetPassword:"SQLPassword" /OutputPath:"C:\temp\test.sql"
/Variables:StagingDatabase="Staging DB Variable value"

Yardım:

sqlpackage.exe /Action:Script /?