用于独立专用 SQL 池的 DNS 别名的 PowerShell 和 Azure CLI(以前称为 SQL DW)

本文提供了 Azure PowerShell Az 模块或Azure CLI脚本,演示如何管理托管独立专用 SQL 池的 Azure SQL 逻辑服务器的 DNS 别名

只有独立的专用 SQL 池(以前称为 DW)支持 Azure SQL 逻辑服务器 DNS 别名。 对于Azure Synapse工作区中的专用 SQL 池,目前不支持 DNS 别名。

连接字符串中的 DNS 别名

若要连接逻辑 SQL Server,SQL Server Management Studio (SSMS) 等客户端可以提供 DNS 别名名称,而不是真正的服务器名称。 在下面的示例服务器字符串中,别名 任意唯一别名名称 替换包含四个节点的服务器字符串中的第一个以点分隔的节点。

<yourServer>.database.chinacloudapi.cn

Prerequisites

若要运行本文中提供的演示 PowerShell 脚本,请确保满足以下先决条件:

Example

以下代码示例一开始就将文字值分配给多个变量。

若要运行此代码,请编辑占位符值,使之与系统中的实际值匹配。

使用以下 cmdlet:

若要进行安装或升级,请参阅安装 Azure PowerShell 模块

Get-Module -ListAvailable Az中使用powershell_ise.exe查找版本。

$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 -Environment AzureChinaCloud -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;