PowerShell para configurar Alias de DNS para o Banco de Dados SQL do Azure

Aplica-se a:Banco de Dados SQL do Azure do Azure Synapse Analytics

Este artigo fornece scripts do módulo Az do PowerShell do Azure ou da CLI do Azure para demonstrar como pode gerir um alias DNS para o servidor lógico SQL do Azure que hospeda o seu Banco de Dados SQL do Azure.

Alias do DNS na cadeia de ligação

Para conectar a um servidor SQL lógico, um cliente como o SQL Server Management Studio (SSMS) pode fornecer o alias DNS em vez do nome verdadeiro do servidor. No exemplo seguinte de string de servidor, o alias any-unique-alias-name substitui o primeiro nó delimitado por pontos na string de servidor com quatro nós.

<yourServer>.database.windows.net

Pré-requisitos

Se você quiser executar o script de demonstração do PowerShell fornecido neste artigo, os seguintes pré-requisitos se aplicam:

• Para obter uma assinatura e uma conta do Azure para avaliação gratuita, consulte ensaios do Azure
• Dois servidores lógicos SQL do Azure
• Instale o módulo Azure PowerShell ou o Azure CLI.

Exemplo

O exemplo de código a seguir começa atribuindo valores literais a várias variáveis.

Para executar o código, edite os valores de espaço reservado para corresponder aos valores reais em seu sistema.

PowerShell

Os cmdlets usados são os seguintes:

• New-AzSqlServerDNSAlias: Cria um alias DNS no sistema de serviço do Banco de Dados SQL do Azure. O alias refere-se ao servidor 1.
• Get-AzSqlServerDNSAlias: Obter e listar todos os aliases atribuídos ao servidor 1.
• Set-AzSqlServerDNSAlias: Modifica o nome do servidor ao qual o alias está configurado para se referir, do servidor 1 para o servidor 2.
• Remove-AzSqlServerDNSAlias: Remova o alias do servidor 2, usando o nome do alias.

Para instalar ou atualizar, consulte Instalar o módulo do Azure PowerShell.

Use Get-Module -ListAvailable Az em powershell_ise.exe, para encontrar a versão.

$subscriptionName = '<subscriptionName>';
$sqlServerDnsAliasName = '<aliasName>';
$resourceGroupName = '<resourceGroupName>';  
$sqlServerName = '<sqlServerName>';
$resourceGroupName2 = '<resourceGroupNameTwo>'; # can be same or different than $resourceGroupName
$sqlServerName2 = '<sqlServerNameTwo>'; # must be different from $sqlServerName.

# login to Azure
Connect-AzAccount -SubscriptionName $subscriptionName;
$subscriptionId = Get-AzSubscription -SubscriptionName $subscriptionName;

Write-Host 'Assign an alias to server 1...';
New-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName -ServerName $sqlServerName `
    -Name $sqlServerDnsAliasName;

Write-Host 'Get the aliases assigned to server 1...';
Get-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName -ServerName $sqlServerName;

Write-Host 'Move the alias from server 1 to server 2...';
Set-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName2 -TargetServerName $sqlServerName2 `
    -Name $sqlServerDnsAliasName `
    -SourceServerResourceGroup $resourceGroupName -SourceServerName $sqlServerName `
    -SourceServerSubscriptionId $subscriptionId.Id;

Write-Host 'Get the aliases assigned to server 2...';
Get-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName2 -ServerName $sqlServerName2;

Write-Host 'Remove the alias from server 2...';
Remove-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName2 -ServerName $sqlServerName2 `
    -Name $sqlServerDnsAliasName;

CLI do Azure

Os comandos utilizados são os seguintes:

• az sql server dns-alias create: Cria um alias DNS para um servidor. O alias refere-se ao servidor 1.
• az sql server dns-alias show: Obter e listar todos os aliases atribuídos ao servidor 1.
• az sql server dns-alias set: Modifica o nome do servidor ao qual o alias está configurado para se referir, do servidor 1 para o servidor 2.
• az SQL Server DNS-alias delete: Remova o alias do servidor 2, usando o nome do alias.

Para instalar ou atualizar, consulte Instalar a CLI do Azure.

$subscriptionName = '<subscriptionName>';
$sqlServerDnsAliasName = '<aliasName>';
$resourceGroupName = '<resourceGroupName>';  
$sqlServerName = '<sqlServerName>';
$resourceGroupName2 = '<resourceGroupNameTwo>'; # can be same or different than $resourceGroupName
$sqlServerName2 = '<sqlServerNameTwo>'; # must be different from $sqlServerName.

# login to Azure
az login -SubscriptionName $subscriptionName;
$subscriptionId = az account list[0].i -SubscriptionName $subscriptionName;

Write-Host 'Assign an alias to server 1...';
az sql server dns-alias create –-resource-group $resourceGroupName --server $sqlServerName `
    --name $sqlServerDnsAliasName;

Write-Host 'Get the aliases assigned to server 1...';
az sql server dns-alias show –-resource-group $resourceGroupName --server $sqlServerName;

Write-Host 'Move the alias from server 1 to server 2...';
az sql server dns-alias set –-resource-group $resourceGroupName2 --server $sqlServerName2 `
    --name $sqlServerDnsAliasName `
    --original-resource-group $resourceGroupName --original-server $sqlServerName `
    --original-subscription-id $subscriptionId.Id;

Write-Host 'Get the aliases assigned to server 2...';
az sql server dns-alias show –-resource-group $resourceGroupName2 --server $sqlServerName2;

Write-Host 'Remove the alias from server 2...';
az sql server dns-alias delete –-resource-group $resourceGroupName2 --server $sqlServerName2 `
    --name $sqlServerDnsAliasName;

Conteúdo relacionado

• alias DNS para o Banco de Dados SQL do Azure