Konfigurace aktivní geografické replikace pro izolovanou databázi v Azure SQL Database pomocí PowerShelluUse PowerShell to configure active geo-replication for a single database in Azure SQL Database

Tento ukázkový skript PowerShellu nakonfiguruje aktivní geografickou replikaci pro izolovanou databázi a převezme její služby při selhání do sekundární repliky databáze.This PowerShell script example configures active geo-replication for a single database and fails it over to a secondary replica of the database.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.If you don't have an Azure subscription, create a free account before you begin.

Poznámka

Tento článek je aktualizovaný a využívá nový modul Az Azure PowerShellu.This article has been updated to use the new Azure PowerShell Az module. Můžete dál využívat modul AzureRM, který bude dostávat opravy chyb nejméně do prosince 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Další informace o kompatibilitě nového modulu Az a modulu AzureRM najdete v tématu Seznámení s novým modulem Az Azure PowerShellu.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pokyny k instalaci modulu Az najdete v tématu věnovaném instalaci Azure PowerShellu.For Az module installation instructions, see Install Azure PowerShell.

Použití Azure Cloud ShelluUse Azure Cloud Shell

Hostitelé Azure Azure Cloud Shell interaktivní prostředí prostředí, které můžete používat v prohlížeči.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Pro práci se službami Azure můžete použít buď bash, nebo PowerShell s Cloud Shell.You can use either bash or PowerShell with Cloud Shell to work with Azure services. Můžete použít Cloud Shell předinstalované příkazy ke spuštění kódu v tomto článku, aniž byste museli instalovat cokoli do svého místního prostředí.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Spuštění Azure Cloud Shell:To start Azure Cloud Shell:

MožnostOption Příklad nebo propojeníExample/Link
Zvolte Vyzkoušet v pravém horním rohu bloku kódu.Select Try It in the upper-right corner of a code block. Při výběru možnosti vyzkoušet se kód automaticky nezkopíruje do Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Příklad pokusu o Azure Cloud Shell
Přejít na https://shell.azure.com nebo vyberte tlačítko Spustit Cloud Shell a otevřete Cloud Shell v prohlížeči.Go to https://shell.azure.com or select the Launch Cloud Shell button to open Cloud Shell in your browser. spustit Cloud Shell v novém okněLaunch Cloud Shell in a new window
Vyberte tlačítko Cloud Shell v pravém horním panelu nabídek v Azure Portal.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Tlačítko Cloud Shell na webu Azure Portal

Chcete-li spustit kód v tomto článku v Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Spusťte Cloud Shell.Start Cloud Shell.

  2. Vyberte tlačítko Kopírovat na bloku kódu ke zkopírování kódu.Select the Copy button on a code block to copy the code.

  3. Vložte kód do relace Cloud Shell tak, že vyberete Ctrl+SHIFT+v v systému Windows a Linux nebo vyberete možnost cmd+SHIFT+v v MacOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Vyberte ENTER a spusťte kód.Select Enter to run the code.

Pokud se rozhodnete nainstalovat a používat PowerShell místně, musíte použít AZ PowerShell 1.4.0 nebo novější.If you choose to install and use the PowerShell locally, this tutorial requires AZ PowerShell 1.4.0 or later. Pokud potřebujete upgrade, přečtěte si téma Instalace modulu Azure PowerShell.If you need to upgrade, see Install Azure PowerShell module. Pokud používáte PowerShell místně, je také potřeba spustit příkaz Connect-AzAccount pro vytvoření připojení k Azure.If you are running PowerShell locally, you also need to run Connect-AzAccount to create a connection with Azure.

Ukázkové skriptySample scripts

# Connect-AzAccount
$SubscriptionId = ''
# Set the resource group name and location for your primary server
$primaryResourceGroupName = "myPrimaryResourceGroup-$(Get-Random)"
$primaryLocation = "westus2"
# Set the resource group name and location for your secondary server
$secondaryResourceGroupName = "mySecondaryResourceGroup-$(Get-Random)"
$secondaryLocation = "eastus"
# Set an admin login and password for your servers
$adminSqlLogin = "SqlAdmin"
$password = "ChangeYourAdminPassword1"
# Set server names - the logical server names have to be unique in the system
$primaryServerName = "primary-server-$(Get-Random)"
$secondaryServerName = "secondary-server-$(Get-Random)"
# The sample database name
$databasename = "mySampleDatabase"
# The ip address range that you want to allow to access your servers
$primaryStartIp = "0.0.0.0"
$primaryEndIp = "0.0.0.0"
$secondaryStartIp = "0.0.0.0"
$secondaryEndIp = "0.0.0.0"

# Set subscription 
Set-AzContext -SubscriptionId $subscriptionId 

# Create two new resource groups
$primaryResourceGroup = New-AzResourceGroup -Name $primaryResourceGroupName -Location $primaryLocation
$secondaryResourceGroup = New-AzResourceGroup -Name $secondaryResourceGroupName -Location $secondaryLocation

# Create two new logical servers with a system wide unique server name
$primaryServer = New-AzSqlServer -ResourceGroupName $primaryResourceGroupName `
    -ServerName $primaryServerName `
    -Location $primaryLocation `
    -SqlAdministratorCredentials $(New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $adminSqlLogin, $(ConvertTo-SecureString -String $password -AsPlainText -Force))
$secondaryServer = New-AzSqlServer -ResourceGroupName $secondaryResourceGroupName `
    -ServerName $secondaryServerName `
    -Location $secondaryLocation `
    -SqlAdministratorCredentials $(New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $adminSqlLogin, $(ConvertTo-SecureString -String $password -AsPlainText -Force))

# Create a server firewall rule for each server that allows access from the specified IP range
$primaryserverfirewallrule = New-AzSqlServerFirewallRule -ResourceGroupName $primaryResourceGroupName `
    -ServerName $primaryservername `
    -FirewallRuleName "AllowedIPs" -StartIpAddress $primaryStartIp -EndIpAddress $primaryEndIp
$secondaryserverfirewallrule = New-AzSqlServerFirewallRule -ResourceGroupName $secondaryResourceGroupName `
    -ServerName $secondaryservername `
    -FirewallRuleName "AllowedIPs" -StartIpAddress $secondaryStartIp -EndIpAddress $secondaryEndIp

# Create a blank database with S0 performance level on the primary server
$database = New-AzSqlDatabase  -ResourceGroupName $primaryResourceGroupName `
    -ServerName $primaryServerName `
    -DatabaseName $databasename -RequestedServiceObjectiveName "S0"

# Establish Active Geo-Replication
$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryResourceGroupName -ServerName $primaryServerName
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryResourceGroupName -PartnerServerName $secondaryServerName -AllowConnections "All"

# Initiate a planned failover
$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $secondaryResourceGroupName -ServerName $secondaryServerName
$database | Set-AzSqlDatabaseSecondary -PartnerResourceGroupName $primaryResourceGroupName -Failover

# Monitor Geo-Replication config and health after failover
$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $secondaryResourceGroupName -ServerName $secondaryServerName
$database | Get-AzSqlDatabaseReplicationLink -PartnerResourceGroupName $primaryResourceGroupName -PartnerServerName $primaryServerName

# Remove the replication link after the failover
$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $secondaryResourceGroupName -ServerName $secondaryServerName
$secondaryLink = $database | Get-AzSqlDatabaseReplicationLink -PartnerResourceGroupName $primaryResourceGroupName -PartnerServerName $primaryServerName
$secondaryLink | Remove-AzSqlDatabaseSecondary

# Clean up deployment 
#Remove-AzResourceGroup -ResourceGroupName $primaryResourceGroupName
#Remove-AzResourceGroup -ResourceGroupName $secondaryResourceGroupName

Vyčištění nasazeníClean up deployment

Pomocí následujícího příkazu odeberte skupinu prostředků a všechny k ní přidružené prostředky.Use the following command to remove the resource group and all resources associated with it.

Remove-AzResourceGroup -ResourceGroupName $primaryresourcegroupname
Remove-AzResourceGroup -ResourceGroupName $secondaryresourcegroupname

Vysvětlení skriptuScript explanation

Tento skript používá následující příkazy.This script uses the following commands. Každý příkaz v tabulce odkazuje na příslušnou část dokumentace.Each command in the table links to command specific documentation.

PříkazCommand PoznámkyNotes
New-AzResourceGroupNew-AzResourceGroup Vytvoří skupinu prostředků, ve které se ukládají všechny prostředky.Creates a resource group in which all resources are stored.
New-AzSqlServerNew-AzSqlServer Vytvoří server SQL Database hostující jednotlivé databáze a elastické fondy.Creates a SQL Database server that hosts single databases and elastic pools.
New-AzSqlElasticPoolNew-AzSqlElasticPool Vytvoří elastický fond.Creates an elastic pool.
Set-AzSqlDatabaseSet-AzSqlDatabase Aktualizuje vlastnosti databáze nebo přesune databázi do nebo z elastického fondu nebo mezi elastickými fondy.Updates database properties or moves a database into, out of, or between elastic pools.
New-AzSqlDatabaseSecondaryNew-AzSqlDatabaseSecondary Vytvoří sekundární databázi pro existující databázi a spustí replikaci dat.Creates a secondary database for an existing database and starts data replication.
Get-AzSqlDatabaseGet-AzSqlDatabase Získá jednu nebo více databází.Gets one or more databases.
Set-AzSqlDatabaseSecondarySet-AzSqlDatabaseSecondary Přepne sekundární databázi na primární a zahájí tak převzetí služeb při selhání.Switches a secondary database to be primary to initiate failover.
Get-AzSqlDatabaseReplicationLinkGet-AzSqlDatabaseReplicationLink Získá vazby geografické replikace mezi službou Azure SQL Database a skupinou prostředků nebo SQL Serverem.Gets the geo-replication links between an Azure SQL Database and a resource group or SQL Server.
Remove-AzSqlDatabaseSecondaryRemove-AzSqlDatabaseSecondary Ukončí replikaci dat mezi službou SQL Database a zadanou sekundární databází.Terminates data replication between a SQL Database and the specified secondary database.
Remove-AzResourceGroupRemove-AzResourceGroup Odstraní skupinu prostředků včetně všech vnořených prostředků.Deletes a resource group including all nested resources.

Další krokyNext steps

Další informace o Azure PowerShellu najdete v dokumentaci k Azure PowerShellu.For more information on the Azure PowerShell, see Azure PowerShell documentation.

Další ukázkové skripty PowerShellu pro službu SQL Database najdete v tématu Skripty PowerShellu pro službu Azure SQL Database.Additional SQL Database PowerShell script samples can be found in the Azure SQL Database PowerShell scripts.