Tutorial: Menambahkan Azure SQL Database ke grup failover otomatis

BERLAKU UNTUK: Azure SQL Database

• Azure SQL Database (database tunggal)
• Azure SQL Database (kumpulan elastis)
• Instans Terkelola Azure SQL

Grup failover adalah lapisan abstraksi deklaratif yang memungkinkan Anda mengelompokkan beberapa database yang direplikasi secara geografis. Pelajari cara mengonfigurasi grup failover untuk Azure SQL Database dan menguji failover menggunakan portal Microsoft Azure, PowerShell, atau Azure CLI. Dalam tutorial ini, Anda akan mempelajari cara:

• Membuat database di Azure SQL Database
• Buat grup failover untuk database di antara dua server.
• Uji failover.

Prasyarat

Portal

Untuk menyelesaikan tutorial ini, pastikan Anda telah:

• Langganan Azure. Buat akun gratis jika Anda belum memilikinya.

PowerShell

Untuk menyelesaikan tutorial, pastikan Anda memiliki item berikut:

• Langganan Azure. Buat akun gratis jika Anda belum memilikinya.
• Azure PowerShell

Azure CLI

Jika Anda tidak memiliki langganan Azure, buat akun gratis Azure sebelum memulai.

1 - Buat database

Dalam langkah ini, Anda membuat grup sumber daya, server, database tunggal, dan aturan firewall IP tingkat server untuk akses ke server.

Dalam langkah ini, Anda membuat server SQL logis dan database tunggal yang menggunakan data sampel AdventureWorksLT. Anda dapat membuat database dengan menggunakan menu dan layar portal Microsoft Azure atau dengan menggunakan skrip Azure CLI atau PowerShell di Azure Cloud Shell.

Semua metode termasuk menyiapkan aturan firewall tingkat server untuk mengizinkan alamat IP publik dari komputer yang Anda gunakan untuk mengakses server. Untuk informasi selengkapnya tentang membuat aturan firewall tingkat server, lihat Membuat firewall tingkat server. Anda juga dapat mengatur aturan firewall tingkat database. Lihat Membuat aturan firewall tingkat database.

Portal

Untuk membuat grup sumber daya, server, dan database tunggal di portal Microsoft Azure:

1. Masuk ke portal.

2. Dari bilah Pencarian, cari dan pilih Azure SQL.

3. Pada halaman Azure SQL, pilih Tambahkan.

   

4. Pada halaman Pilih opsi penyebaran SQL, pilih petak Database SQL, dengan Database tunggal di bawah Jenis sumber daya. Anda dapat melihat informasi selengkapnya tentang database yang berbeda dengan memilih Perlihatkan detail.

5. Pilih Buat.

   

6. Pada tab Dasar formulir Buat database SQL, di bawah Detail proyek, pilih Langganan Azure yang benar jika belum dipilih.

7. Untuk Grup sumber daya, pilih Buat baru, masukkan myResourceGroup, dan pilih OK.

8. Di bawah Detail database, untuk Nama database masukkan mySampleDatabase.

9. Untuk Server, pilih Buat baru, dan isi formulir Server baru sebagai berikut:

   • Nama server: Masukkan mysqlserver dan beberapa karakter untuk keunikan.
   • Login admin server: Masukkan AzureAdmin.
   • Kata sandi: Masukkan kata sandi yang memenuhi persyaratan dan masukkan lagi di bidang Konfirmasi kata sandi.
   • Lokasi: Turun ke bawah dan pilih lokasi, seperti (AS) AS Timur.

   PilihOK.

   

   Catat login dan kata sandi admin server sehingga Anda dapat masuk ke server dan databasenya. Jika Anda lupa login atau kata sandi, Anda bisa mendapatkan nama login atau mengatur ulang kata sandi di halaman Server SQL setelah pembuatan database. Untuk membuka halaman Server SQL, pilih nama server di halaman Ringkasan database.

10. Di bawah Komputasi + penyimpanan, jika Anda ingin mengonfigurasi ulang default, pilih Konfigurasi database.

    Pada halaman Konfigurasi, Anda dapat secara opsional:

    • Mengubah tingkat Komputasi dari Disediakan ke Tanpa server.
    • Meninjau dan mengubah pengaturan untuk vCores dan Ukuran maks data.
    • Pilih Ubah konfigurasi untuk mengubah konfigurasi perangkat keras.

    Setelah membuat perubahan apa pun, pilih Terapkan.

11. Pilih Berikutnya: Jaringan di bagian bawah halaman.

    

12. Pada tab Jaringan, di bawah Metode konektivitas, pilih Titik akhir publik.

13. Di bawah aturan Firewall, atur Tambahkan alamat IP klien saat ini ke Ya.

14. Pilih Berikutnya: Pengaturan tambahan di bagian bawah halaman.

    

    Untuk informasi selengkapnya tentang pengaturan firewall, lihat Mengizinkan layanan dan sumber daya Azure untuk mengakses server ini dan Menambahkan titik akhir privat.

15. Pada tab Pengaturan tambahan, di bagian Sumber data, untuk Menggunakan data yang sudah ada, pilih Sampel.

16. Secara opsional, aktifkan Pertahanan Microsoft untuk SQL.

17. Secara opsional, atur jendela pemeliharaan sehingga pemeliharaan terencana dilakukan pada waktu terbaik untuk database Anda.

18. Pilih Tinjau + buat di bagian bawah halaman.

    

19. Setelah meninjau pengaturan, pilih Buat.

PowerShell

Anda dapat membuat grup sumber daya, server, dan database tunggal menggunakan Windows PowerShell. Jika Anda tidak ingin menggunakan Azure Cloud Shell, instal modul Azure PowerShell.

Catatan

Artikel ini menggunakan modul Azure Az PowerShell, yang merupakan modul PowerShell yang direkomendasikan untuk berinteraksi dengan Azure. Untuk mulai menggunakan modul Az PowerShell, lihat Menginstal Azure PowerShell. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.

Untuk menjalankan sampel kode berikut di Azure Cloud Shell, pilih Cobalah di bilah judul kode. Saat Cloud Shell terbuka, pilih Salin di bilah judul sampel kode, dan tempelkan sampel kode ke jendela Cloud Shell. Dalam kode, ganti <Subscription ID> dengan ID Langganan Azure Anda, dan untuk $startIp dan $endIp, ganti 0.0.0.0 dengan alamat IP publik dari komputer yang Anda gunakan.

Ikuti petunjuk di layar untuk masuk ke Azure dan menjalankan kode.

Anda juga dapat menggunakan Azure Cloud Shell dari portal Microsoft Azure dengan memilih ikon Cloud Shell di bilah atas.

Pertama kali Anda menggunakan Cloud Shell dari portal, pilih PowerShell pada dialog Selamat datang. Sesi berikutnya akan menggunakan PowerShell, atau Anda dapat memilihnya dari bilah kontrol Cloud Shell.

Kode PowerShell berikut membuat grup sumber daya Azure, server, database tunggal, dan aturan firewall untuk akses ke server. Pastikan untuk mencatat grup sumber daya dan nama server yang dihasilkan, sehingga Anda bisa mengelola sumber daya ini nanti.

# Set variables for your server and database
$subscriptionId = '<SubscriptionID>'
$resourceGroupName = "myResourceGroup-$(Get-Random)"
$location = "West US"
$adminLogin = "azureuser"
$password = "Azure1234567"
$serverName = "mysqlserver-$(Get-Random)"
$databaseName = "mySampleDatabase"

# The ip address range that you want to allow to access your server
$startIp = "0.0.0.0"
$endIp = "0.0.0.0"

# Show randomized variables
Write-host "Resource group name is" $resourceGroupName
Write-host "Server name is" $serverName

# Connect to Azure
Connect-AzAccount

# Set subscription ID
Set-AzContext -SubscriptionId $subscriptionId

# Create a resource group
Write-host "Creating resource group..."
$resourceGroup = New-AzResourceGroup -Name $resourceGroupName -Location $location -Tag @{Owner="SQLDB-Samples"}
$resourceGroup

# Create a server with a system wide unique server name
Write-host "Creating primary server..."
$server = New-AzSqlServer -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -Location $location `
   -SqlAdministratorCredentials $(New-Object -TypeName System.Management.Automation.PSCredential `
   -ArgumentList $adminLogin, $(ConvertTo-SecureString -String $password -AsPlainText -Force))
$server

# Create a server firewall rule that allows access from the specified IP range
Write-host "Configuring firewall for primary server..."
$serverFirewallRule = New-AzSqlServerFirewallRule -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -FirewallRuleName "AllowedIPs" -StartIpAddress $startIp -EndIpAddress $endIp
$serverFirewallRule

# Create General Purpose Gen4 database with 1 vCore
Write-host "Creating a gen5 2 vCore database..."
$database = New-AzSqlDatabase  -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -DatabaseName $databaseName `
   -Edition GeneralPurpose `
   -VCore 2 `
   -ComputeGeneration Gen5 `
   -MinimumCapacity 2 `
   -SampleName "AdventureWorksLT"
$database

Kode sebelumnya menggunakan cmdlet PowerShell ini:

Perintah	Catatan
Baru-AzResourceGroup	Membuat grup sumber daya tempat semua sumber daya disimpan.
Baru-AzSqlServer	Membuat server yang menghosting database dan kumpulan elastis.
New-AzSqlServerFirewallRule	Membuat aturan firewall tingkat server untuk server.
Baru-AzSqlDatabase	Membuat database.

Untuk sampel Azure SQL Database PowerShell selengkapnya, lihat Sampel Azure PowerShell.

Azure CLI

Blok kode Azure CLI berikut membuat grup sumber daya, server, database tunggal, dan aturan firewall IP tingkat server untuk akses ke server. Pastikan untuk mencatat grup sumber daya dan nama server yang dihasilkan, sehingga Anda bisa mengelola sumber daya ini nanti.

Jika Anda tidak memiliki langganan Azure, buat akun gratis Azure sebelum memulai.

Persiapkan lingkungan Anda untuk Azure CLI

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi lebih lanjut, lihat Mulai Cepat Azure Cloud Shell - Bash.

  

• Jika Anda lebih memilih untuk menjalankan perintah referensi CLI secara lokal, pasang Azure CLI. Jika Anda menjalankan pada Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk tambahan, lihat Masuk dengan Azure CLI.

  • Saat diminta, instal ekstensi saat pertama kali menggunakan Azure CLI. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Meluncurkan Azure Cloud Shell

Azure Cloud Shell adalah shell interaktif gratis yang dapat Anda gunakan untuk menjalankan langkah-langkah dalam artikel ini. Shell ini memiliki alat Azure umum yang telah dipasang sebelumnya dan dikonfigurasi untuk digunakan dengan akun Anda.

Untuk membuka Cloud Shell, cukup pilih Coba dari sudut kanan atas blok kode. Anda juga dapat meluncurkan Cloud Shell di tab browser terpisah dengan membuka https://shell.azure.com.

Saat Cloud Shell terbuka, verifikasi bahwa Bash dipilih untuk lingkungan Anda. Sesi berikutnya akan menggunakan Azure CLI di lingkungan Bash, Pilih Salin untuk menyalin blok kode, tempel ke Cloud Shell, dan tekan Enter untuk menjalankannya.

Masuk ke Azure

Cloud Shell diautentikasi secara otomatis dengan akun awal yang digunakan untuk masuk. Gunakan skrip berikut untuk masuk menggunakan langganan yang berbeda, menggantikan <Subscription ID> dengan ID Langganan Azure Anda. Jika Anda tidak memiliki langganan Azure, buat akun gratis Azure sebelum memulai.

subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

Untuk informasi selengkapnya, lihat mengatur langganan aktif atau masuk secara interaktif

Mengatur nilai parameter untuk membuat sumber daya

Atur nilai parameter untuk digunakan dalam membuat database dan sumber daya yang diperlukan. Nama server harus unik secara global di seluruh Azure sehingga $RANDOM fungsi ini digunakan untuk membuat nama server.

Ubah lokasi yang sesuai untuk lingkungan Anda. Ganti nilai 0.0.0.0 di rentang alamat ip agar sesuai dengan lingkungan tertentu Anda. Gunakan alamat IP publik komputer yang sedang Anda gunakan untuk membatasi akses ke server agar hanya menuju ke alamat IP Anda.

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-azuresql-rg-$randomIdentifier"
tag="create-and-configure-database"
server="msdocs-azuresql-server-$randomIdentifier"
database="msdocsazuresqldb$randomIdentifier"
login="azureuser"
password="Pa$$w0rD-$randomIdentifier"
# Specify appropriate IP address values for your environment
# to limit access to the SQL Database server
startIp=0.0.0.0
endIp=0.0.0.0

echo "Using resource group $resourceGroup with login: $login, password: $password..."

Buat grup sumber daya

Gunakan skrip ini untuk membuat grup sumber daya dengan menggunakan perintah az group create. Grup sumber daya Azure adalah kontainer logis yang disebarkan dan dikelola sumber daya Azure.

echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag

Membuat server

Gunakan skrip ini untuk membuat server dengan menggunakan perintah az sql server create.

echo "Creating $server in $location..."
az sql server create --name $server --resource-group $resourceGroup --location "$location" --admin-user $login --admin-password $password

Mengonfigurasi aturan firewall berbasis server

Gunakan skrip ini untuk membuat aturan firewall dengan menggunakan perintah az sql server firewall-rule create.

echo "Configuring firewall..."
az sql server firewall-rule create --resource-group $resourceGroup --server $server -n AllowYourIp --start-ip-address $startIp --end-ip-address $endIp

Membuat database tunggal dengan menggunakan Azure CLI

Gunakan skrip ini untuk membuat database dengan menggunakan perintah az sql db create.

echo "Creating $database on $server..."
az sql db create --resource-group $resourceGroup --server $server --name $database --sample-name AdventureWorksLT --edition GeneralPurpose --family Gen5 --capacity 2 --zone-redundant true # zone redundancy is only supported on premium and business critical service tiers

Referensi perintah Azure CLI

Kode sebelumnya menggunakan perintah Azure CLI ini:

Perintah	Deskripsi
az account set	Mengatur langganan menjadi langganan aktif saat ini.
az group create	Membuat grup sumber daya tempat semua sumber daya disimpan.
az sql server create	Membuat server yang menghosting database dan kumpulan elastis.
az sql server firewall-rule create	Membuat aturan firewall tingkat server.
az sql db create	Membuat database.

Untuk skrip Azure SQL Database Azure CLI lebih lanjut, lihat Sampel Azure CLI.

2 - Buat grup failover

Dalam langkah ini, Anda akan membuat grup failover antara server yang sudah ada dan server baru di wilayah lain. Lalu tambahkan sampel database ke grup failover.

Portal Azure

Membuat grup failover Anda dan menambahkan database tunggal Anda ke dalamnya menggunakan portal Microsoft Azure.

1. Pilih Azure SQL di menu sebelah kiri portal Microsoft Azure. Jika Azure SQL tidak ada dalam daftar, pilih Semua layanan, lalu ketik Azure SQL di kotak pencarian. (Opsional) Pilih bintang di samping Azure SQL untuk menyukainya dan menambahkannya sebagai item di navigasi sebelah kiri.

2. Pilih database yang dibuat di bagian 1, seperti mySampleDatabase.

3. Grup failover dapat dikonfigurasi pada tingkat server. Pilih nama server di bawah Nama server untuk membuka pengaturan untuk server.

   

4. Pilih Grup kegagalan di bawah panel Pengaturan, lalu pilih Tambahkan grup untuk membuat grup kegagalan baru.

   

5. Pada halaman Grup Failover, masukkan atau pilih nilai berikut, lalu pilih Buat:

   • Nama grup Failover: Ketikkan nama grup failover unik, seperti failovergrouptutorial.

   • Server sekunder: Pilih opsi untuk mengonfigurasi pengaturan yang diperlukan lalu pilih untuk Membuat server baru. Atau, Anda dapat memilih server yang sudah ada sebagai server sekunder. Setelah memasukkan nilai berikut, klik Pilih.

     • Nama server: Ketikkan nama unik untuk server sekunder, seperti mysqlsecondary.
     • Login admin server: Ketik azureuser
     • Kata sandi: Ketik kata sandi kompleks yang memenuhi persyaratan kata sandi.
     • Lokasi: Pilih lokasi dari menu pilihan, seperti East US. Lokasi ini tidak boleh berada di lokasi yang sama dengan server utama Anda.

     Catatan

     Pengaturan masuk dan firewall server harus cocok dengan yang ada pada server utama Anda.

     

   • Database dalam grup: Setelah server sekunder dipilih, opsi ini menjadi tidak terkunci. Pilih database untuk Pilih database untuk ditambahkan lalu pilih database yang Anda buat di bagian 1. Menambahkan database ke grup kegagalan akan secara otomatis memulai proses replikasi geografis.

   

PowerShell

Membuat grup kegagalan Anda dan menambahkan database Anda ke dalamnya menggunakan PowerShell.

Catatan

Pengaturan masuk dan firewall server harus cocok dengan yang ada pada server utama Anda.

# $subscriptionId = '<SubscriptionID>'
# $resourceGroupName = "myResourceGroup-$(Get-Random)"
# $location = "West US"
# $adminLogin = "azureuser"
# $password = "PWD27!"+(New-Guid).Guid
# $serverName = "mysqlserver-$(Get-Random)"
# $databaseName = "mySampleDatabase"
$drLocation = "East US"
$drServerName = "mysqlsecondary-$(Get-Random)"
$failoverGroupName = "failovergrouptutorial-$(Get-Random)"

# The ip address range that you want to allow to access your server
# (leaving at 0.0.0.0 will prevent outside-of-azure connections to your DB)
$startIp = "0.0.0.0"
$endIp = "0.0.0.0"

# Show randomized variables
Write-host "DR Server name is" $drServerName
Write-host "Failover group name is" $failoverGroupName

# Create a secondary server in the failover region
Write-host "Creating a secondary server in the failover region..."
$drServer = New-AzSqlServer -ResourceGroupName $resourceGroupName `
   -ServerName $drServerName `
   -Location $drLocation `
   -SqlAdministratorCredentials $(New-Object -TypeName System.Management.Automation.PSCredential `
      -ArgumentList $adminlogin, $(ConvertTo-SecureString -String $password -AsPlainText -Force))
$drServer

# Create a server firewall rule that allows access from the specified IP range
Write-host "Configuring firewall for secondary server..."
$serverFirewallRule = New-AzSqlServerFirewallRule -ResourceGroupName $resourceGroupName `
   -ServerName $drServerName `
   -FirewallRuleName "AllowedIPs" -StartIpAddress $startIp -EndIpAddress $endIp
$serverFirewallRule

# Create a failover group between the servers
$failovergroup = Write-host "Creating a failover group between the primary and secondary server..."
New-AzSqlDatabaseFailoverGroup `
   –ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -PartnerServerName $drServerName  `
   –FailoverGroupName $failoverGroupName `
   –FailoverPolicy Automatic `
   -GracePeriodWithDataLossHours 2
$failovergroup

# Add the database to the failover group
Write-host "Adding the database to the failover group..."
Get-AzSqlDatabase `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -DatabaseName $databaseName | `
Add-AzSqlDatabaseToFailoverGroup `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -FailoverGroupName $failoverGroupName
Write-host "Successfully added the database to the failover group..."

Bagian tutorial ini menggunakan cmdlet PowerShell berikut:

Perintah	Catatan
Baru-AzSqlServer	Membuat server di Azure SQL Database yang menghosting database tunggal dan kumpulan elastis.
New-AzSqlServerFirewallRule	Membuat aturan firewall untuk server di Azure SQL Database.
Baru-AzSqlDatabase	Membuat database tunggal baru di Azure SQL Database.
Baru-AzSqlDatabaseFailoverGroup	Membuat grup failover baru di Azure SQL Database.
Get-AzSqlDatabase	Mendapatkan satu atau beberapa database di Azure SQL Database.
Tambahkan-AzSqlDatabaseToFailoverGroup	Menambahkan satu atau beberapa database ke grup failover di Azure SQL Database.

Azure CLI

Dalam langkah ini, Anda membuat grup failover dan menambahkan database ke dalamnya dengan menggunakan Azure CLI.

Mengatur nilai parameter tambahan

Atur nilai parameter tambahan ini untuk digunakan dalam membuat grup failover, selain nilai yang ditetapkan dalam skrip sebelumnya yang digunakan dalam pembuatan grup sumber daya dan server utama.

Ubah lokasi failover yang sesuai untuk lingkungan Anda.

failoverGroup="msdocs-azuresql-failover-group-$randomIdentifier"
failoverLocation="Central US"
secondaryServer="msdocs-azuresql-secondary-server-$randomIdentifier"

Membuat server sekunder

Gunakan perintah az sql server create untuk membuat server sekunder.

Catatan

Pengaturan masuk dan firewall server harus cocok dengan yang ada pada server utama Anda.

echo "Creating $secondaryServer in $failoverLocation..."
az sql server create --name $secondaryServer --resource-group $resourceGroup --location "$failoverLocation" --admin-user $login --admin-password $password

Buat grup kegagalan

Gunakan perintah az sql failover-group create untuk membuat grup failover.

echo "Creating $failoverGroup between $server and $secondaryServer..."
az sql failover-group create --name $failoverGroup --partner-server $secondaryServer --resource-group $resourceGroup --server $server --failover-policy Automatic --grace-period 2 --add-db $database

Referensi pembuatan grup failover Azure CLI

Bagian tutorial ini menggunakan cmdlet Azure CLI berikut:

Perintah	Catatan
az sql server create	Membuat server yang menghosting database dan kumpulan elastis.
az sql failover-group create	Menghapus grup failover.
az sql failover-group update	Memperbarui grup failover.

3 - Uji failover

Dalam langkah ini, Anda akan melakukan failover grup failover Anda ke server sekunder, dan kemudian gagal kembali menggunakan portal Microsoft Azure.

Portal Azure

Uji failover menggunakan portal Azure.

1. Pilih Azure SQL di menu sebelah kiri portal Microsoft Azure. Jika Azure SQL tidak ada dalam daftar, pilih Semua layanan, lalu ketik Azure SQL di kotak pencarian. (Opsional) Pilih bintang di samping Azure SQL untuk menyukainya dan menambahkannya sebagai item di navigasi sebelah kiri.

2. Pilih database yang dibuat di bagian 2, seperti mySampleDatbase.

3. Pilih nama server di bawah Nama server untuk membuka pengaturan untuk server.

   

4. Pilih Grup kegagalan di bawah panel Pengaturan lalu pilih grup kegagalan yang Anda buat di bagian 2.

   

5. Ulas server mana yang utama, dan server mana yang sekunder.

6. Pilih Failover dari panel tugas untuk menggagalkan grup failover Anda yang berisi sampel database.

7. Pilih Ya pada peringatan yang memberi tahu Anda bahwa sesi TDS akan terputus.

   

8. Ulas server mana yang utama, dan server mana yang sekunder. Jika kegagalan berhasil, kedua server seharusnya bertukar peran.

9. Pilih Kegagalan lagi untuk menggagalkan server kembali ke peran aslinya.

PowerShell

Uji failover menggunakan PowerShell.

Memeriksa peran replika sekunder:

# Set variables
# $resourceGroupName = "myResourceGroup-$(Get-Random)"
# $serverName = "mysqlserver-$(Get-Random)"
# $failoverGroupName = "failovergrouptutorial-$(Get-Random)"

# Check role of secondary replica
Write-host "Confirming the secondary replica is secondary...."
(Get-AzSqlDatabaseFailoverGroup `
   -FailoverGroupName $failoverGroupName `
   -ResourceGroupName $resourceGroupName `
   -ServerName $drServerName).ReplicationRole

Menggagalkan server sekunder:

# Set variables
# $resourceGroupName = "myResourceGroup-$(Get-Random)"
# $serverName = "mysqlserver-$(Get-Random)"
# $failoverGroupName = "failovergrouptutorial-$(Get-Random)"

# Failover to secondary server
Write-host "Failing over failover group to the secondary..."
Switch-AzSqlDatabaseFailoverGroup `
   -ResourceGroupName $resourceGroupName `
   -ServerName $drServerName `
   -FailoverGroupName $failoverGroupName
Write-host "Failed failover group successfully to" $drServerName

Mengembalikan grup kegagalan kembali ke server utama:

# Set variables
# $resourceGroupName = "myResourceGroup-$(Get-Random)"
# $serverName = "mysqlserver-$(Get-Random)"
# $failoverGroupName = "failovergrouptutorial-$(Get-Random)"

# Revert failover to primary server
Write-host "Failing over failover group to the primary...."
Switch-AzSqlDatabaseFailoverGroup `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -FailoverGroupName $failoverGroupName
Write-host "Failed failover group successfully back to" $serverName

Bagian tutorial ini menggunakan cmdlet PowerShell berikut:

Perintah	Catatan
Dapatkan-AzSqlDatabaseFailoverGroup	Mendapatkan atau mencantumkan grup failover Azure SQL Database.
Alihkan-AzSqlDatabaseFailoverGroup	Jalankan failover dari grup failover Azure SQL Database.

Azure CLI

Uji failover menggunakan Azure CLI.

Memverifikasi peran setiap server

Gunakan perintah az sql failover-group show untuk mengonfirmasi peran setiap server.

echo "Confirming the role of each server in the failover group..." # note ReplicationRole property
az sql failover-group show --name $failoverGroup --resource-group $resourceGroup --server $server

Failover ke server sekunder

Gunakan az sql failover-group set-primary untuk melakukan fail over ke server sekunder. Gunakan perintah az sql failover-group show untuk memverifikasi failover yang berhasil.

echo "Failing over to $secondaryServer..."
az sql failover-group set-primary --name $failoverGroup --resource-group $resourceGroup --server $secondaryServer 

echo "Confirming role of $secondaryServer is now primary..." # note ReplicationRole property
az sql failover-group show --name $failoverGroup --resource-group $resourceGroup --server $server

Mengembalikan grup failover kembali ke server utama

Gunakan perintah az sql failover-group set-primary untuk melakukan failback ke server utama.

echo "Failing back to $server...."
az sql failover-group set-primary --name $failoverGroup --resource-group $resourceGroup --server $server

Referensi manajemen grup failover Azure CLI

Bagian tutorial ini menggunakan cmdlet Azure CLI berikut:

Perintah	Catatan
az sql failover-group show	Dapatkan grup failover di server.
az sql failover-group set-primary	Atur yang utama dari grup failover dengan menggagalkan semua database dari server utama saat ini.

Membersihkan sumber daya

Bersihkan sumber daya dengan menghapus grup sumber daya.

Portal Azure

Menghapus grup sumber daya menggunakan portal Microsoft Azure.

1. Navigasi ke grup sumber daya Anda di portal Microsoft Azure.
2. Pilih Hapus grup sumber daya untuk menghapus semua sumber daya dalam grup serta grup sumber daya itu sendiri.
3. Ketik nama grup sumber daya, myResourceGroup, di kotak teks, lalu pilih Hapus untuk menghapus grup sumber daya.

PowerShell

Hapus grup sumber daya menggunakan PowerShell.

# Set variables
# $resourceGroupName = "myResourceGroup-$(Get-Random)"

# Remove the resource group
Write-host "Removing resource group..."
Remove-AzResourceGroup -ResourceGroupName $resourceGroupName
Write-host "Resource group removed =" $resourceGroupName

Bagian tutorial ini menggunakan cmdlet PowerShell berikut:

Perintah	Catatan
Remove-AzResourceGroup	Menghapus grup sumber daya

Azure CLI

Gunakan perintah berikut untuk menghapus grup sumber daya dan semua sumber daya yang terkait dengannya menggunakan perintah az group delete - kecuali Anda masih memiliki kebutuhan untuk sumber daya ini. Beberapa sumber daya ini mungkin membutuhkan beberapa waktu untuk dibuat dan dihapus.

echo "Cleaning up resources by removing the resource group..."
az group delete --name $resourceGroup -y

Bagian tutorial ini menggunakan cmdlet Azure CLI berikut:

Perintah	Catatan
az group delete	Menghapus grup sumber daya termasuk semua sumber daya berlapis.

Penting

Jika Anda ingin mempertahankan grup sumber daya tetapi menghapus database sekunder, hapus dari grup failover sebelum menghapusnya. Menghapus database sekunder sebelum dihapus dari grup failover dapat menyebabkan perilaku yang tidak dapat diprediksi.

Skrip lengkap

PowerShell

# Set variables for your server and database
$subscriptionId = '<SubscriptionID>'
$randomIdentifier = $(Get-Random)
$resourceGroupName = "myResourceGroup-$randomIdentifier"
$location = "West US 2"
$adminLogin = "azureuser"
$password = "PWD27!"+(New-Guid).Guid
$serverName = "mysqlserver-$randomIdentifier"
$databaseName = "mySampleDatabase"
$drLocation = "East US 2"
$drServerName = "mysqlsecondary-$randomIdentifier"
$failoverGroupName = "failovergrouptutorial-$randomIdentifier"


# The ip address range that you want to allow to access your server 
# Leaving at 0.0.0.0 will prevent outside-of-azure connections
$startIp = "0.0.0.0"
$endIp = "0.0.0.0"

# Show randomized variables
Write-host "Resource group name is" $resourceGroupName 
Write-host "Password is" $password  
Write-host "Server name is" $serverName 
Write-host "DR Server name is" $drServerName 
Write-host "Failover group name is" $failoverGroupName

# Set subscription ID
Set-AzContext -SubscriptionId $subscriptionId

# Create a resource group
Write-host "Creating resource group..."
$resourceGroup = New-AzResourceGroup -Name $resourceGroupName -Location $location -Tag @{Owner="SQLDB-Samples"}
$resourceGroup


# Create a server with a system wide unique server name
Write-host "Creating primary logical server..."
$server = New-AzSqlServer -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -Location $location `
   -SqlAdministratorCredentials $(New-Object -TypeName System.Management.Automation.PSCredential `
   -ArgumentList $adminLogin, $(ConvertTo-SecureString -String $password -AsPlainText -Force))
$server

# Create a server firewall rule that allows access from the specified IP range
Write-host "Configuring firewall for primary logical server..."
$serverFirewallRule = New-AzSqlServerFirewallRule -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -FirewallRuleName "AllowedIPs" -StartIpAddress $startIp -EndIpAddress $endIp
$serverFirewallRule

# Create General Purpose Gen5 database with 2 vCore
Write-host "Creating a gen5 2 vCore database..."
$database = New-AzSqlDatabase  -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -DatabaseName $databaseName `
   -Edition GeneralPurpose `
   -VCore 2 `
   -ComputeGeneration Gen5 `
   -MinimumCapacity 2 `
   -SampleName "AdventureWorksLT"
$database

# Create a secondary server in the failover region
Write-host "Creating a secondary logical server in the failover region..."
$drServer = New-AzSqlServer -ResourceGroupName $resourceGroupName `
   -ServerName $drServerName `
   -Location $drLocation `
   -SqlAdministratorCredentials $(New-Object -TypeName System.Management.Automation.PSCredential `
      -ArgumentList $adminlogin, $(ConvertTo-SecureString -String $password -AsPlainText -Force))
$drServer


# Create a failover group between the servers
$failovergroup = Write-host "Creating a failover group between the primary and secondary server..."
New-AzSqlDatabaseFailoverGroup `
   –ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -PartnerServerName $drServerName  `
   –FailoverGroupName $failoverGroupName `
   –FailoverPolicy Automatic `
   -GracePeriodWithDataLossHours 2
$failovergroup

# Add the database to the failover group
Write-host "Adding the database to the failover group..." 
Get-AzSqlDatabase `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -DatabaseName $databaseName | `
Add-AzSqlDatabaseToFailoverGroup `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -FailoverGroupName $failoverGroupName
Write-host "Successfully added the database to the failover group..." 

# Check role of secondary replica
Write-host "Confirming the secondary replica is secondary...." 
(Get-AzSqlDatabaseFailoverGroup `
   -FailoverGroupName $failoverGroupName `
   -ResourceGroupName $resourceGroupName `
   -ServerName $drServerName).ReplicationRole

# Failover to secondary server
Write-host "Failing over failover group to the secondary..." 
Switch-AzSqlDatabaseFailoverGroup `
   -ResourceGroupName $resourceGroupName `
   -ServerName $drServerName `
   -FailoverGroupName $failoverGroupName
Write-host "Failed failover group successfully to" $drServerName 



# Revert failover to primary server
Write-host "Failing over failover group to the primary...." 
Switch-AzSqlDatabaseFailoverGroup `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -FailoverGroupName $failoverGroupName
Write-host "Failed failover group successfully back to" $serverName


# Show randomized variables
Write-host "Resource group name is" $resourceGroupName 
Write-host "Password is" $password  
Write-host "Server name is" $serverName 
Write-host "DR Server name is" $drServerName 
Write-host "Failover group name is" $failoverGroupName

# Clean up resources by removing the resource group
# Write-host "Removing resource group..."
# Remove-AzResourceGroup -ResourceGroupName $resourceGroupName
# Write-host "Resource group removed =" $resourceGroupName

Skrip ini menggunakan perintah berikut. Setiap perintah dalam tabel ditautkan ke dokumentasi spesifik perintah.

Perintah	Catatan
Baru-AzResourceGroup	Membuat grup sumber daya tempat semua sumber daya disimpan.
New-AzSqlServer	Membuat server yang menghosting database tunggal dan kumpulan elastis di Azure SQL Database.
New-AzSqlServerFirewallRule	Membuat aturan firewall untuk server di Azure SQL Database.
Baru-AzSqlDatabase	Membuat database baru di Azure SQL Database.
Baru-AzSqlDatabaseFailoverGroup	Membuat grup failover baru di Azure SQL Database.
Get-AzSqlDatabase	Mendapatkan satu atau beberapa database di Azure SQL Database.
Tambahkan-AzSqlDatabaseToFailoverGroup	Menambahkan satu atau beberapa database ke grup failover di Azure SQL Database.
Dapatkan-AzSqlDatabaseFailoverGroup	Mendapatkan atau mencantumkan grup failover di Azure SQL Database.
Alihkan-AzSqlDatabaseFailoverGroup	Jalankan failover dari grup failover di Azure SQL Database.
Remove-AzResourceGroup	Menghapus grup sumber daya di Azure SQL Database.

Azure CLI

# Add an Azure SQL Database to an auto-failover group

# VariableBlock
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-azuresql-rg-$randomIdentifier"
tag="add-single-db-to-failover-group-az-cli"
server="msdocs-azuresql-server-$randomIdentifier"
database="msdocsazuresqldb$randomIdentifier"
login="azureuser"
password="Pa$$w0rD-$randomIdentifier"
failoverGroup="msdocs-azuresql-failover-group-$randomIdentifier"
failoverLocation="Central US"
secondaryServer="msdocs-azuresql-secondary-server-$randomIdentifier"

echo "Using resource group $resourceGroup with login: $login, password: $password..."

echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag

echo "Creating $server in $location..."
az sql server create --name $server --resource-group $resourceGroup --location "$location"  --admin-user $login --admin-password $password

echo "Creating $database on $server..."
az sql db create --name $database --resource-group $resourceGroup --server $server --sample-name AdventureWorksLT
echo "Creating $secondaryServer in $failoverLocation..."
az sql server create --name $secondaryServer --resource-group $resourceGroup --location "$failoverLocation" --admin-user $login --admin-password $password
echo "Creating $failoverGroup between $server and $secondaryServer..."
az sql failover-group create --name $failoverGroup --partner-server $secondaryServer --resource-group $resourceGroup --server $server --failover-policy Automatic --grace-period 2 --add-db $database
echo "Confirming the role of each server in the failover group..." # note ReplicationRole property
az sql failover-group show --name $failoverGroup --resource-group $resourceGroup --server $server
echo "Failing over to $secondaryServer..."
az sql failover-group set-primary --name $failoverGroup --resource-group $resourceGroup --server $secondaryServer 

echo "Confirming role of $secondaryServer is now primary..." # note ReplicationRole property
az sql failover-group show --name $failoverGroup --resource-group $resourceGroup --server $server
echo "Failing back to $server...."
az sql failover-group set-primary --name $failoverGroup --resource-group $resourceGroup --server $server

Skrip ini menggunakan perintah berikut. Setiap perintah dalam tabel ditautkan ke dokumentasi spesifik perintah.

Perintah	Catatan
az account set	Mengatur langganan menjadi langganan aktif saat ini.
az group create	Membuat grup sumber daya tempat semua sumber daya disimpan.
az sql server create	Membuat server yang menghosting database tunggal dan kumpulan elastis di Azure SQL Database.
az sql server firewall-aturan buat	Membuat aturan firewall IP tingkat server di Azure SQL Database.
buat az sql db	Membuat database di Azure SQL Database.
az sql failover-group create	Membuat grup failover baru di Azure SQL Database.
az sql failover-group show	Mencantumkan grup failover di server pada Azure SQL Database.
az sql failover-group set-primary	Atur yang utama dari grup failover dengan menggagalkan semua database dari server utama saat ini.
az group delete	Menghapus grup sumber daya termasuk semua sumber daya berlapis.

Portal Microsoft Azure

Tidak ada skrip yang tersedia untuk portal Microsoft Azure.

Untuk skrip Azure SQL Database lebih lanjut, lihat: Azure PowerShell dan Azure CLI.

Langkah berikutnya

Dalam tutorial ini, Anda menambahkan database di Azure SQL Database ke grup failover, dan failover yang diuji. Anda telah mempelajari cara untuk:

• Membuat database di Azure SQL Database
• Buat grup failover untuk database di antara dua server.
• Uji failover.

Lanjut ke tutorial berikutnya mengenai cara menambahkan kumpulan elastis ke grup failover.

Tutorial: Menambahkan kumpulan elastis Azure SQL Database ke grup failover