创建实例池 - Azure SQL 托管实例

若要在 Azure 门户中创建 SQL 托管实例池，请执行以下步骤：

1. 转到 Azure SQL 中心。 在 Azure SQL 托管实例的窗格中，选择“ 显示”选项。

2. 在 Azure SQL 托管实例选项 窗口中，选择“ 创建实例池”。

   

3. 在 “创建 Azure SQL 托管实例池 ”页上：

   1. 在“基本信息”选项卡上，填写项目和实例详细信息。
   2. 使用“计算 + 存储”下的“配置实例池”打开“计算 + 存储”页，并选择池所使用的服务层级、计算硬件和 SQL Server 许可证。 使用“应用”保存计算设置，然后返回到“创建 Azure SQL 托管实例池”页。
   3. 选择现有虚拟网络，或在“网络”选项卡上配置新的虚拟网络。
   4. （可选）在“其他设置”选项卡上为池配置非默认维护时段。
   5. 在“查看 + 创建”选项卡上查看配置，然后选择“创建”以创建实例池。

   

4. 可以从“通知”监视池部署。

创建 SQL 托管实例池后，可以使用 Azure 门户在池中 创建新实例 ，也可以使用 PowerShell 或 Azure CLI 将现有实例移到池 中。

若要创建 SQL 托管实例池，请使用 New-AzSqlInstancePool。

请考虑以下事项：

• 对于 LicenseType，如果没有可用于 Azure 混合权益折扣的 SQL Server 许可证，请使用 Azure 混合权益的 BasePrice 或 LicenseIncluded。
• 使用 Get-AzLocation | select displayname, location 获取可用实例池的区域列表。

运行以下示例脚本，在标准系列 (Gen5) 硬件上创建具有 8 个 vCore 的新实例池：

$virtualNetwork = Get-AzVirtualNetwork -Name "<vNetName>" -ResourceGroupName "<resourceGroupName>"
$miSubnet = Get-AzVirtualNetworkSubnetConfig -Name "<miSubnetName>" -VirtualNetwork
$virtualNetwork$miSubnetConfigId = $miSubnet.Id

$parameters = @{
    ResourceGroupName = "<resource group name>"
    Name = "<instance pool name>"
    LicenseType = "LicenseIncluded"
    VCore = 8
    Edition = "GeneralPurpose"
    ComputeGeneration = "Gen5"
    Location = "<region>"
    $virtualNetwork = Get-AzVirtualNetwork -Name "<vNetName>" -ResourceGroupName "<resourceGroupName>"
    $miSubnet = Get-AzVirtualNetworkSubnetConfig -Name "<miSubnetName>" -VirtualNetwork $virtualNetwork
    $miSubnetConfigId = $miSubnet.Id
    SubnetId = $miSubnetConfigId
}

$instancePool = New-AzSqlInstancePool @parameters

若要创建 SQL 托管实例池，请使用 az sql instance-pool create。

请考虑以下事项：

• 对于 --license-type，如果没有可用于 Azure 混合权益折扣的 SQL Server 许可证，请使用 Azure 混合权益的 BasePrice 或 LicenseIncluded。

运行以下示例脚本，在标准系列 (Gen5) 硬件上创建具有 8 个 vCore 的新实例池：

# Create the instance pool
az sql instance-pool create \
    --license-type LicenseIncluded \
    --location <region> \
    --name <pool name> \
    --capacity 8 \
    --tier GeneralPurpose \
    --family Gen5 \
    --resource-group <resource group name> \
    --subnet <subnet name> \
    --vnet-name <vnet name>

若要使用 Azure 门户在池中创建新的 SQL 托管实例，请执行以下步骤：

1. 转到 Azure SQL 中心。

2. 在 Azure SQL 托管实例的窗格中，选择“ 显示”选项。

3. 在 Azure SQL 托管实例选项 窗口中，选择“ 创建 SQL 托管实例”。

   

4. 在“创建 Azure SQL 托管实例”页的“基本信息”选项卡上：

   1. 选择包含现有实例池的资源组。
   2. 在“托管实例详细信息”下，对于“是否属于实例池？”选择“是”，以在实例池内创建新实例。
   3. 从“实例池”下拉列表中选择池。

   

   从下拉列表中选择实例池后，您会看到实例的计算成本变为 0，因为计算成本包含在池的成本中。

5. 在“创建 Azure SQL 托管实例”页上填写剩余的详细信息，以在池中创建实例。 有关详细信息，请查看 快速入门：创建 Azure SQL 托管实例。

6. 选择“查看 + 创建”以查看新实例的设置，然后使用“创建”在所选池中部署实例。

若要使用 PowerShell 识别池参数，请使用 Get-AzSqlInstancePool ，然后使用 New-AzSqlInstance 在特定池中创建 SQL 托管实例。

通过运行以下示例脚本在池中创建新的 SQL 托管实例：

$adminCredential = Get-Credential
$instancePool = Get-AzSqlInstancePool -ResourceGroupName <resource group name> -Name <instance pool name>

$instance01Params = @{
    Name = $instance01
    VCore = 2
    StorageSizeInGB = 32
    AdministratorCredential = $adminCredential
}

$instance01 = $instancePool | New-AzSqlInstance @instance01Params

若要使用 Azure CLI 在池中创建新的 SQL 托管实例，请在使用 --instance-pool-name 创建实例时在参数中提供池名称：

#obtain the subnetId of an instance pool
sqlmipoolSubnetId=$(az sql instance-pool show -g <resource group name> -n <instance pool name> --query subnetId --output tsv)

az sql mi create \
  --license-type LicenseIncluded \
  --name <Instance name> \
  --admin-user <username> \
  --admin-password <password> \
  --capacity 2 \
  --instance-pool-name <instance pool name> \
  --storage 32 \
  --resource-group <resource group name> \
  --subnet $sqlmipoolSubnetId

若要使用 PowerShell 将 SQL 托管实例移到池中，请使用 Set-AzSqlInstance 时提供池名称：

$instance01 | Set-AzSqlInstance -InstancePoolName $instancePoolName

要将实例移出池，请提供空白的池名称：

$instance01 | Set-AzSqlInstance -InstancePoolName ''

若要使用 Azure CLI 将 SQL 托管实例移到池中，请在使用 --instance-pool-name 更新实例时在参数中提供池名称：

az sql mi update \
  --name <instance name> \
  --instance-pool-name <instance pool name> \
  --resource-group <resource group name>

要将实例移出池，请在使用 az sql mi update 更新实例时在 --instance-pool-name 参数中提供空白名称：

az sql mi update \
  --name <instance name> \
  --instance-pool-name '' \
  --resource-group <resource group name>

若要使用 Azure 门户为现有 SQL 托管实例创建新数据库，请执行以下步骤：

1. 转到 Azure 门户中的 SQL 托管实例。
2. 在“概述”窗格上，从命令栏选择“+ 新建数据库”，打开“创建 Azure SQL 托管数据库”页。
3. 提供新数据库的详细信息。
4. 选择“查看 + 创建”以查看新的数据库配置，然后使用“创建”部署数据库。

若要为 SQL 托管实例创建新数据库，请使用 New-AzSqlInstanceDatabase：

$databaseParams = @{
    Name = "<database name>"
    InstanceName = "<instance name>"
    ResourceGroupName = "<resource group>"
}

New-AzSqlInstanceDatabase @databaseParams

要为实例创建新的数据库，请使用 az sql midb create：

az sql midb create
   --managed-instance <Instance name> \
   --name <Database name> \
   --resource-group <Resource group name>

若要获取池中的实例列表，请使用 Azure 门户查看实例池页。 选择池名称，在概述页上查看池中的实例：

可以使用 PowerShell 来确定池内资源的使用情况。

要获取池中的实例列表，请使用 Get-AzSqlInstance：

$instancePool | Get-AzSqlInstance

要获取池资源使用状况，请使用 Get-AzSqlInstancePoolUsage：

$instancePool| Get-AzSqlInstancePoolUsage

可以添加 -ExpandChildren 参数以获取池及其内部实例的详细概述：

$instancePool | Get-AzSqlInstancePoolUsage –ExpandChildren

要列出实例中的数据库，请使用 Get-AzSqlInstanceDatabase：

$databaseParams = @{
    InstanceName = $instance01Name
    ResourceGroupName = $resourceGroupName
}

$databases = Get-AzSqlInstanceDatabase @databaseParams

要获取有关池中的实例和资源使用状况的信息，请使用 az sql instance-pool show：

sqlmipoolId=$(az sql instance-pool show --name <pool name> \
--resource-group <resource group name> --query id | cut -d '"' -f 2) \
az sql mi list --resource-group <resource group name> \
--query "[?instancePoolId == '$sqlmipoolId'].{sqlmiName:name}" -o tsv

使用 Azure 门户中实例池页的设置下的计算 + 存储窗格，更新池的许可证类型、vCore 大小和硬件类型：

使用 Azure 门户中实例池页设置下的维护窗格，更新池的维护时段：

可以使用 PowerShell 对实例池限制进行更改。

以下示例脚本更改了许可证类型、vCore 大小和硬件类型：

更改许可证类型：

$instancePoolParams = @{
    LicenseType = "BasePrice"
    VCores = 16
    ComputeGeneration = "Gen8"
}
$instancePool | Set-AzSqlInstancePool @instancePoolParams

还可以确定可用的维护时段计划：

$parameters = @{
    Location = $location
    MaintenanceScope = "SQLManagedInstance"
}

$configurations = Get-AzMaintenancePublicConfiguration @parameters
$maintenanceWindowOptions = $configurations | Where-Object { $_.Location -eq $location -and $_.MaintenanceScope -eq "SQLManagedInstance" }

然后可以指定时段选项来更改维护时段，例如：

$instancePoolParams = @{
    MaintenanceConfigurationId = $maintenanceWindowOptions[1].Id
}

$instancePool | Set-AzSqlInstancePool @instancePoolParams

要更新池的配置设置，请使用 az sql instance-pool update：

az sql instance-pool update --name <pool name> \
--resource-group <resource group> --capacity 16 \
--license-type LicenseIncluded --family Gen8IM

要更新维护时段：

maintenanceWindowOptions=$(az maintenance public-configuration list \
--query "[?location==<chinanorth3>&&contains(maintenanceScope,'SQLManagedInstance')]")

az sql instance-pool update --name <pool name> \
--resource-group <resource group> --maint-config-id <maintenance configuration id>

要修改池中实例的资源参数，请使用 Set-AzSqlInstance。

以下样本将 Instance1 的 vCore 更新为 8，并将存储大小更改为 512 GB：

$instancePoolParams = @{
    VCore = 8
    StorageSizeInGB = 512
    InstancePoolName = $instancePoolName
}

$instance1name | Set-AzSqlInstance @instancePoolParams

要修改池中实例的资源参数，请使用 az sql mi update。

以下样本将 Instance1 的 vCore 更新为 8，并将存储大小更改为 512 GB：

az sql mi update \
  --name Instance1 \
  --resource-group <resource group name> \
  --capacity 8 \
  --storage 512

要删除实例池，请使用 Remove-AzSqlInstancePool。

以下示例脚本删除了空实例池：

$params = @{
    ResourceGroupName = "<resource group name>"
    Name = "<instance pool name>"
}

Remove-AzSqlInstancePool @params

要删除实例池，请使用 az sql instance-pool delete。

以下示例脚本删除了空实例池：

az sql instance-pool delete
  --name <pool name>
  --resource group <resource group name>

要使用 PowerShell，请安装最新版 PowerShell Core，并按照说明安装 Azure PowerShell 模块。

可用的 PowerShell 命令：

对于与池中的实例和单个实例相关的操作，请使用标准托管实例命令，但在对池中的实例使用这些命令时，必须填充实例池名称属性。

为 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。

可用的 Azure CLI 命令：