你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

在本快速入门中，你将使用 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 内置角色。

创建“超大规模”数据库

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

Portal

为了在 Azure 门户中创建单一数据库，本快速入门将从 Azure SQL 页面开始。

1. 浏览选择 SQL 部署选项页。

2. 在“SQL 数据库”下将“资源类型”设置保留为“单一数据库”，然后选择“创建” 。

   

3. 在“创建 SQL 数据库”窗体的“基本信息”选项卡上的“项目详细信息”下，选择所需的 Azure订阅 。

4. 对于“资源组”，选择“新建”，输入“myResourceGroup”，然后选择“确定” 。

5. 对于“数据库名称”，输入“mySampleDatabase”。

6. 对于“服务器”，选择“新建”，并使用以下值填写“新服务器”窗体 ：

   • 服务器名称：输入“mysqlserver”并添加一些字符以实现唯一性。 我们无法提供要使用的确切服务器名称，因为对于 Azure 中的所有服务器，服务器名称必须全局唯一，而不只是在订阅中唯一。 输入名称（例如 mysqlserver12345），门户会告知该名称是否可用。
   • 服务器管理员登录名：输入“azureuser”。
   • 密码：输入符合要求的密码，然后在“确认密码”字段中再次输入该密码。
   • 位置：从下拉列表中选择一个位置。

   选择“确定”。

7. 在“计算 + 存储”下选择“配置数据库” 。

8. 本快速入门将创建一个超大规模数据库。 对于“服务层级”，请选择“超大规模”。

   

9. 在“计算硬件”下，选择“更改配置”。 查看可用的硬件配置，并选择最合适你数据库的配置。 对于本示例，我们将选择“标准系列 (Gen5)”配置。

10. 选择“确定”以确认硬件代系。

11. （可选）如果要增加数据库的 vCore 数，请调节“vCore”滑块。 对于本示例，我们将选择 2 个 vCore。

12. 调节“高可用性辅助副本”滑块以创建一个高可用性 (HA) 副本。

13. 选择应用。

14. 创建超大规模数据库时，请认真考虑“备份存储冗余”的配置选项。 对于超大规模数据库，存储冗余只能在数据库创建过程中指定。 可以选择本地冗余、区域冗余或异地冗余存储。 所选存储冗余选项将在数据库的整个生存期内使用，以同时实现数据存储冗余和备份存储冗余。 现有数据库可以通过数据库复制或时间点还原迁移到不同的存储冗余。

    

15. 在完成时选择“下一步:网络”。

16. 在“网络”选项卡上，对于“连接方法”，选择“公共终结点” 。

17. 对于“防火墙规则”，将“添加当前客户端 IP 地址”设置为“是” 。 将“允许 Azure 服务和资源访问此服务器”设置保留为“否” 。

18. 在页面底部选择“下一步: 安全”。

    

19. （可选）启用 Microsoft Defender for SQL。

20. 在完成时选择“下一步:其他设置”。

21. 在“其他设置”选项卡上的“数据源”部分中，对于“使用现有数据”，请选择“示例”。 这将创建一个 AdventureWorksLT 示例数据库，此数据库包含可查询和试验的一些表和数据，而不是一个空数据库。

22. 在页面底部选择“查看 + 创建”：

    

23. 在“查看 + 创建”页上，查看后选择“创建”。

Azure CLI

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

如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。

为 Azure CLI 准备环境

• 在 Azure Cloud Shell 中使用 Bash 环境。 有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。

  

• 如需在本地运行 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。

启动 Azure Cloud Shell

Azure Cloud Shell 是免费的交互式 shell，可以使用它运行本文中的步骤。 它预安装有常用 Azure 工具并将其配置与帐户一起使用。

若要打开 Cloud Shell，请从代码块的右上角选择试一试。 也可以通过转到 https://shell.azure.com 在单独的浏览器标签页中启动 Cloud Shell。

当 Cloud Shell 打开时，请验证是否为环境选择了Bash。 后续会话将在 Bash 环境中使用 Azure CLI。 选择复制以复制代码块，将其粘贴到 Cloud Shell 中，然后按 Enter 来运行它。

登录 Azure

Cloud Shell 会在登录时使用的初始帐户下自动进行身份验证。 使用以下脚本通过其他订阅登录，将 <Subscription ID> 替换为 Azure 订阅 ID。 如果没有 Azure 订阅，请在开始之前创建一个 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="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

let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroupName="myResourceGroup"
tag="create-and-configure-database"
serverName="mysqlserver-$randomIdentifier"
databaseName="mySampleDatabase"
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 $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 

PowerShell

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

启动 Azure Cloud Shell

Azure Cloud Shell 是免费的交互式 shell，可以使用它运行本文中的步骤。 它预安装有常用 Azure 工具并将其配置与帐户一起使用。

若要打开 Cloud Shell，请从代码块的右上角选择试一试。 也可以通过转到 https://shell.azure.com 在单独的浏览器标签页中启动 Cloud Shell。

当 Cloud Shell 打开时，请验证是否为环境选择了“PowerShell”。 后续会话将在 PowerShell 环境中使用 Azure CLI。 选择“复制”以复制代码块，将其粘贴到 Cloud Shell 中，然后按 Enter 来运行它。

设置参数值

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

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

   # Set variables for your server and database
   $resourceGroupName = "myResourceGroup"
   $location = "eastus"
   $adminLogin = "azureuser"
   $password = "Pa$$w0rD-$(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。 除非明确指定，否则数据库将配置为使用异地冗余备份存储。

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

   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

若要使用 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 等）。

1. 在门户中搜索并选择“SQL 数据库”，然后从列表中选择你的数据库。

2. 在数据库页面的左侧菜单中，选择“查询编辑器(预览)”。

3. 输入服务器管理员登录信息，然后选择“确定”。

   

4. 如果从 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
   

5. 选择“运行”，然后在“结果”窗格中查看查询结果。

   

6. 关闭“查询编辑器”页，并在系统提示时选择“确定”，以放弃未保存的修改 。

清理资源

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

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

门户

若要使用 Azure 门户删除 myResourceGroup 及其包含的所有资源：

1. 在 Azure 门户中搜索并选择“资源组”，然后从列表中选择“myResourceGroup”。
2. 在资源组页上，选择“删除资源组”。
3. 在“键入资源组名称”下输入 myResourceGroup，然后选择“删除”。

Azure CLI

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

az group delete --name $resourceGroup

PowerShell

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

Remove-AzResourceGroup -Name $resourceGroupName

Transact-SQL

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

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

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

DROP DATABASE [myHyperscaleDatabase];
GO

相关内容

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

• 使用 SQL Server Management Studio 连接和查询
• 使用 Azure Data Studio 连接和查询

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

• “超大规模”服务层级
• Azure SQL 数据库“超大规模”常见问题解答
• “超大规模”次要副本
• Azure SQL 数据库超大规模命名副本常见问题解答