创建实例池（预览版）– Azure SQL 托管实例

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

1. 在 Azure 门户中搜索实例池，然后选择实例池服务以打开“实例池”页：

   

2. 在“实例池”页上，选择“+ 创建”以打开“创建 Azure SQL 托管实例池”页：

   

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

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

   

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

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

要创建实例池，请使用 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

要创建实例池，请使用 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 门户在池中创建新实例，请执行以下步骤：

1. 在 Azure 门户中，转到 Azure SQL 页面。

2. 在 Azure SQL 页上，选择“+ 创建”以打开“选择 SQL 部署选项”。

3. 在“SQL 托管实例”磁贴上，选择“单实例”作为资源类型，然后选择“创建”来打开“创建 Azure SQL 托管实例”页。

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

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

   

5. 在“创建 Azure SQL 托管实例”页上填写剩余的详细信息，以在池中创建实例。 有关详细信息，请参阅创建 Azure SQL 托管实例。

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

要通过 PowerShell 标识池参数，请使用 Get-AzSqlInstancePool，然后使用 New-AzSqlInstance 在特定池中创建实例。

运行以下示例脚本在池中创建新实例：

$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 在池中创建新实例，请在使用 az sql mi create 创建实例时在 --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 将实例移入池中，请在使用 Set-AzSqlInstance 时提供池名称：

$instance01 | Set-AzSqlInstance -InstancePoolName $instancePoolName

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

$instance01 | Set-AzSqlInstance -InstancePoolName ''

若要使用 Azure CLI 将实例移入池中，请在使用 az sql mi update 更新实例时在 --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. 选择“查看 + 创建”以查看新的数据库配置，然后使用“创建”部署数据库。

要为实例创建新的数据库，请使用 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>

可以使用 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

可以使用 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==<eastus2>&&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 准备环境。

• 在 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 CLI 命令：