快速入门：在 Azure SQL 数据库中创建超大规模数据库

项目
2025/02/10

在本快速入门中，你将使用 Azure 门户、PowerShell 脚本或 Azure CLI 脚本在 Azure SQL 数据库中创建 Azure 逻辑服务器和超大规模数据库，并使用相应的选项创建一个或多个高可用性 (HA) 副本。如果要使用 Azure 中的现有逻辑服务器，则还可以使用 Transact-SQL 创建超大规模数据库。

提示

SQL 数据库（超大规模）简化定价已于 2023 年 12 月推出。有关详情，请查看超大规模定价博客。

先决条件

一个有效的 Azure 订阅。如果没有订阅，请创建一个试用帐户。
如果你要以编程方式完成本快速入门，则需要安装最新版本的 Azure PowerShell 或 Azure CLI。或者，可以在 Azure 门户中完成本快速入门。
如果你要使用 Transact-SQL 创建超大规模数据库，则 Azure 中需有一个现有的逻辑服务器。对于此方法，你需要通过 Azure 门户查询编辑器、SQL Server Management Studio (SSMS)、Azure Data Studio、sqlcmd 或你选择的客户端来运行 Transact-SQL。

权限

若要通过 Transact-SQL 创建数据库：需要 CREATE DATABASE 权限。若要创建数据库，登录名必须是服务器管理员登录名（预配 Azure SQL 数据库逻辑服务器时创建）、服务器的 Microsoft Entra 管理员、master 中 dbmanager 数据库角色的成员。有关详细信息，请参阅 CREATE DATABASE。

若要通过 Azure 门户、PowerShell、Azure CLI 或 REST API 创建数据库：需要 Azure RBAC 权限，特别是参与者、SQL DB 参与者或 SQL Server 参与者 Azure RBAC 角色。有关详细信息，请参阅 Azure RBAC 内置角色。

创建“超大规模”数据库

本快速入门在超大规模服务层级中创建单一数据库。

此部分中的 Azure CLI 代码块将创建用于访问服务器的资源组、服务器、单一数据库和服务器级 IP 防火墙规则。请确保记录生成的资源组和服务器名称，以便可以在以后管理这些资源。

如果没有 Azure 试用版订阅，请在开始前创建一个试用版订阅。

为 Azure CLI 准备环境

如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
运行 az version 以查找安装的版本和依赖库。若要升级到最新版本，请运行 az upgrade。

使用以下脚本通过其他订阅登录，将 <Subscription ID> 替换为 Azure 订阅 ID。如果没有 Azure 试用版订阅，请在开始前创建一个试用版订阅。

subscription="<subscriptionId>" # add subscription here

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

有关详细信息，请参阅设置有效的订阅或以交互方式登录。

设置参数值

后续命令使用以下值来创建数据库和所需资源。服务器名称需要在整个 Azure 中全局唯一，因此使用 $RANDOM 函数创建服务器名称。

在运行示例代码之前，请根据环境相应地更改 location。替换 IP 地址范围中的 0.0.0.0，以匹配你的特定环境。使用正在使用的计算机的公共 IP 地址将服务器限制为只允许你的 IP 地址访问。

# <FullScript>
# Create a single database and configure a firewall rule
# <SetParameterValues>
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="China East 2"
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

let "randomIdentifier=$RANDOM*$RANDOM"
location="China East 2"
resourceGroupName="myResourceGroup"
tag="create-and-configure-database"
serverName="mysqlserver-$randomIdentifier"
databaseName="mySampleDatabase"
login="azureuser"
password="<password>-$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 $resourceGroupName with login: $login, password: $password..."

创建资源组

使用“az group create”命令创建资源组。 Azure 资源组是在其中部署和管理 Azure 资源的逻辑容器。以下示例在前一步骤中为 location 参数指定的位置创建资源组：

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

创建服务器

使用 az sql server create 命令创建逻辑服务器。


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

配置基于服务器防火墙规则

使用 az sql server firewall-rule create 命令创建防火墙规则。

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

创建单一数据库

使用 az sql db create 命令在超大规模服务层级中创建数据库。

创建超大规模数据库时，请认真考虑 backup-storage-redundancy 的设置。对于超大规模数据库，存储冗余只能在数据库创建过程中指定。可以选择本地冗余、区域冗余或异地冗余存储。所选存储冗余选项将在数据库的整个生存期内使用，以同时实现数据存储冗余和备份存储冗余。现有数据库可以通过数据库复制或时间点还原迁移到不同的存储冗余。 backup-storage-redundancy 参数允许的值为：Local、Zone 或 Geo。除非明确指定，否则数据库将配置为使用异地冗余备份存储。

运行以下命令，以创建填充了 AdventureWorksLT 示例数据的超大规模数据库。该数据库使用具有 2 个 vCore 的标准系列 (Gen5) 硬件。该数据库使用异地冗余备份存储。该命令还会创建一个高可用性 (HA) 副本。

az sql db create \
    --resource-group $resourceGroupName \
    --server $serverName \
    --name $databaseName \3
    --sample-name AdventureWorksLT \
    --edition Hyperscale \
    --compute-model Provisioned \
    --family Gen5 \
    --capacity 2 \
    --backup-storage-redundancy Geo \
    --ha-replicas 1

可以使用 Azure PowerShell 创建资源组、服务器和单一数据库。

设置参数值

后续命令使用以下值来创建数据库和所需资源。服务器名称需要在整个 Azure 中全局唯一，因此使用 Get-Random cmdlet 创建服务器名称。

   # Set variables for your server and database
   $resourceGroupName = "myResourceGroup"
   $location = "chinaeast2"
   $adminLogin = "azureuser"
   $password = "<password>-$(Get-Random)"
   $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
   Write-host "Password is" $password

创建资源组

使用 New-AzResourceGroup 创建 Azure 资源组。资源组是在其中部署和管理 Azure 资源的逻辑容器。

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

创建服务器

使用 New-AzSqlServer cmdlet 创建服务器。

  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

创建防火墙规则

使用 New-AzSqlServerFirewallRule cmdlet 创建服务器防火墙规则。

   Write-host "Configuring server firewall rule..."
   $serverFirewallRule = New-AzSqlServerFirewallRule -ResourceGroupName $resourceGroupName `
      -ServerName $serverName `
      -FirewallRuleName "AllowedIPs" -StartIpAddress $startIp -EndIpAddress $endIp
   $serverFirewallRule

创建单一数据库

使用 New-AzSqlDatabase cmdlet 创建单一数据库。

创建超大规模数据库时，请认真考虑 BackupStorageRedundancy 的设置。对于超大规模数据库，存储冗余只能在数据库创建过程中指定。可以选择本地冗余、区域冗余或异地冗余存储。所选存储冗余选项将在数据库的整个生存期内使用，以同时实现数据存储冗余和备份存储冗余。现有数据库可以通过数据库复制或时间点还原迁移到不同的存储冗余。 BackupStorageRedundancy 参数允许的值为：Local、Zone 或 Geo。除非明确指定，否则数据库将配置为使用异地冗余备份存储。

   Write-host "Creating a standard-series (Gen5) 2 vCore Hyperscale database..."
   $database = New-AzSqlDatabase  -ResourceGroupName $resourceGroupName `
      -ServerName $serverName `
      -DatabaseName $databaseName `
      -Edition Hyperscale `
      -ComputeModel Provisioned `
      -ComputeGeneration Gen5 `
      -VCore 2 `
      -MinimumCapacity 2 `
      -SampleName "AdventureWorksLT" `
      -BackupStorageRedundancy Geo `
      -HighAvailabilityReplicaCount 1
   $database

若要使用 Transact-SQL 创建超大规模数据库，必须先为 Azure 中的现有逻辑服务器创建或确定连接信息。

使用 SQL Server Management Studio (SSMS)、Azure Data Studio 或你选择的客户端连接到 master 数据库，以运行 Transact-SQL 命令（sqlcmd 等）。

创建超大规模数据库时，请认真考虑 BACKUP_STORAGE_REDUNDANCY 的设置。对于超大规模数据库，存储冗余只能在数据库创建过程中指定。可以选择本地冗余、区域冗余或异地冗余存储。所选存储冗余选项将在数据库的整个生存期内使用，以同时实现数据存储冗余和备份存储冗余。现有数据库可以通过数据库复制或时间点还原迁移到不同的存储冗余。 BackupStorageRedundancy 参数允许的值为：LOCAL、ZONE 或 GEO。除非明确指定，否则数据库将配置为使用异地冗余备份存储。

运行以下 Transact-SQL 命令，以使用第 5 代硬件、2 个 vCore 和异地冗余备份存储创建新的超大规模数据库。必须在 CREATE DATABASE 语句中指定版本和服务目标。有关有效服务目标（例如 HS_Gen5_2）的列表，请参阅资源限制。

此示例代码创建一个空数据库。若要使用示例数据创建数据库，请使用本快速入门中的 Azure 门户、Azure CLI 或 PowerShell 示例。

CREATE DATABASE [myHyperscaleDatabase] 
    (EDITION = 'Hyperscale', SERVICE_OBJECTIVE = 'HS_Gen5_2') WITH BACKUP_STORAGE_REDUNDANCY= 'LOCAL';
GO

有关其他参数和选项，请参阅 CREATE DATABASE (Transact-SQL)。

若要将一个或多个高可用性 (HA) 副本添加到数据库，请使用 Azure 门户中数据库的“计算和存储”窗格、Set-AzSqlDatabase PowerShell 命令或 az sql db update Azure CLI 命令。

查询数据库

创建数据库后，可以使用 Azure 门户中的“查询编辑器(预览)”连接到该数据库并查询数据。如果需要，可以改为通过连接到 Azure Data Studio、SQL Server Management Studio (SSMS) 或你选择的客户端来查询数据库，以运行 Transact-SQL 命令（sqlcmd 等）。

在门户中搜索并选择“SQL 数据库”，然后从列表中选择你的数据库。
在数据库页面的左侧菜单中，选择“查询编辑器(预览)”。
输入服务器管理员登录信息，然后选择“确定”。

如果从 AdventureWorksLT 示例数据库创建了超大规模数据库，请在“查询编辑器”窗格中输入以下查询。

SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
FROM SalesLT.ProductCategory pc
JOIN SalesLT.Product p
      ON pc.productcategoryid = p.productcategoryid;

如果使用 Transact-SQL 示例代码创建了空数据库，请在“查询编辑器”窗格中输入另一个示例查询，如下所示：

CREATE TABLE dbo.TestTable(
    TestTableID int IDENTITY(1,1) NOT NULL,
    TestTime datetime NOT NULL,
    TestMessage nvarchar(4000) NOT NULL,
 CONSTRAINT PK_TestTable_TestTableID PRIMARY KEY CLUSTERED (TestTableID ASC)
) 
GO

ALTER TABLE dbo.TestTable ADD CONSTRAINT DF_TestTable_TestTime  DEFAULT (getdate()) FOR TestTime
GO

INSERT dbo.TestTable (TestMessage)
VALUES (N'This is a test');
GO

SELECT TestTableID, TestTime, TestMessage
FROM dbo.TestTable;
GO

选择“运行”，然后在“结果”窗格中查看查询结果。
关闭“查询编辑器”页，并在系统提示时选择“确定”，以放弃未保存的修改。

清理资源

保留资源组、服务器和单一数据库可以继续执行后续步骤，并了解如何以不同的方法连接和查询数据库。

用完这些资源后，可以删除创建的资源组，这也会删除该资源组中的服务器和单一数据库。

使用 az group delete 命令删除资源组以及与其关联的所有资源 - 除非你持续需要这些资源。其中一些资源在创建和删除时可能需要等待一段时间。

az group delete --name $resourceGroup

若要删除资源组及其包含所有资源，请使用该资源组的名称运行以下 PowerShell cmdlet：

Remove-AzResourceGroup -Name $resourceGroupName

此选项仅删除超大规模数据库。除此之外，它不会删除你创建的任何逻辑服务器或资源组。

要使用 Transact-SQL 删除超大规模数据库，请使用 SQL Server Management Studio (SSMS)、Azure Data Studio 或你选择的客户端连接到 master 数据库，以运行 Transact- SQL 命令（sqlcmd 等）。

运行以下 Transact-SQL 命令以删除数据库：

DROP DATABASE [myHyperscaleDatabase];
GO

使用不同的工具与语言连接和查询数据库：

在以下文章中详细了解超大规模数据库：

AI 技能盛会

通过

快速入门：在 Azure SQL 数据库中创建超大规模数据库

先决条件

权限

创建“超大规模”数据库

为 Azure CLI 准备环境

设置参数值

创建资源组

创建服务器

配置基于服务器防火墙规则

创建单一数据库

设置参数值

创建资源组

创建服务器

创建防火墙规则

创建单一数据库

查询数据库

清理资源

其他资源

AI 技能盛会

通过

快速入门：在 Azure SQL 数据库中创建超大规模数据库

先决条件

权限

创建“超大规模”数据库

查询数据库

清理资源

相关内容

其他资源