az sql elastic-pool

エラスティック プールを管理します。

コマンド

名前	説明	型	状態
az sql elastic-pool create	エラスティック プールを作成する。	コア	GA
az sql elastic-pool delete	エラスティック プールを削除します。	コア	GA
az sql elastic-pool list	サーバー内のすべてのエラスティック プールを取得します。	コア	GA
az sql elastic-pool list-dbs	エラスティック プール内のデータベースの一覧を取得します。	コア	GA
az sql elastic-pool list-editions	アクティブなサブスクリプションで使用できるエラスティック プールエディションを一覧表示します。	コア	GA
az sql elastic-pool op	エラスティック プールに対する操作を管理します。	コア	GA
az sql elastic-pool op cancel	エラスティック プールの非同期操作を取り消します。	コア	GA
az sql elastic-pool op list	エラスティック プールで実行される操作の一覧を取得します。	コア	GA
az sql elastic-pool show	エラスティック プールを取得します。	コア	GA
az sql elastic-pool update	エラスティック プールを更新します。	コア	GA

az sql elastic-pool create

エラスティック プールを作成する。

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--ha-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--tags]
                           [--zone-redundant {false, true}]

例

ゾーン冗長を有効にしてエラスティック プールを作成する

az sql elastic-pool create -g mygroup -s myserver -n mypool -z

ゾーン冗長を明示的に無効にしたエラスティック プールを作成する

az sql elastic-pool create -g mygroup -s myserver -n mypool -z false

Standard 100 DTU エラスティック プールを作成します。

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Standard -c 100

GeneralPurpose エディション、Gen4 ハードウェア、1 仮想コアを使用してエラスティック プールを作成します。

az sql elastic-pool create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

Hyperscale エディション、Gen5 ハードウェア、4 仮想コア、2 つの高可用性レプリカを使用してエラスティック プールを作成します。

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 4 --ha-replicas 2

VBS エンクレーブを使用してエラスティック プールを作成します。

az sql elastic-pool create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

必須のパラメーター

--name -n

エラスティック プールの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--server -s

Azure SQL Server の名前。 を使用して az configure --defaults sql-server=<name>既定値を構成できます。

省略可能のパラメーター

--capacity --dtu -c

DTU または仮想コアの整数での SKU の容量コンポーネント。

--db-dtu-max --db-max-capacity --db-max-dtu

1 つのデータベースで使用できる最大容量 (DTU または仮想コア)。

--db-dtu-min --db-min-capacity --db-min-dtu

各データベースの minumum 容量 (DTU または仮想コア) が保証されます。

--edition --tier -e

SKU のエディション コンポーネント。 使用できる値は、Basic、Standard、プレミアム、GeneralPurpose、BusinessCritical です。

--family -f

SKU のコンピューティング生成コンポーネント (仮想コア SKU の場合のみ)。 使用できる値は、Gen4、Gen5 です。

--ha-replicas --read-replicas

データベース用にプロビジョニングする高可用性レプリカの数。 Hyperscale エディションでのみ設定可能です。

--license-type

このエラスティック プールに適用するライセンスの種類。

指定可能な値: BasePrice, LicenseIncluded

--maint-config-id -m

このリソースメインテナント構成 ID または名前を指定します。

--max-size --storage

最大ストレージ サイズ。 単位が指定されていない場合、既定ではバイト (B) になります。

--no-wait

実行時間の長い操作の終了を待機しません。

規定値: False

--preferred-enclave-type

Azure SQL エラスティック プールに推奨されるエンクレーブの種類。 使用できる値は、既定値、VBS です。

指定可能な値: Default, VBS

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

--zone-redundant -z

ゾーン冗長を有効にするかどうかを指定します。 値が指定されていない場合、既定値は true です。

指定可能な値: false, true

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql elastic-pool delete

エラスティック プールを削除します。

az sql elastic-pool delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--server]
                           [--subscription]

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

エラスティック プールの名前。

--no-wait

実行時間の長い操作の終了を待機しません。

規定値: False

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--server -s

Azure SQL Server の名前。 を使用して az configure --defaults sql-server=<name>既定値を構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql elastic-pool list

サーバー内のすべてのエラスティック プールを取得します。

az sql elastic-pool list [--ids]
                         [--resource-group]
                         [--server]
                         [--skip]
                         [--subscription]

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--server -s

Azure SQL Server の名前。 を使用して az configure --defaults sql-server=<name>既定値を構成できます。

--skip

スキップするコレクション内の要素の数。 既定値は None です。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql elastic-pool list-dbs

エラスティック プール内のデータベースの一覧を取得します。

az sql elastic-pool list-dbs [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

エラスティック プールの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--server -s

Azure SQL Server の名前。 を使用して az configure --defaults sql-server=<name>既定値を構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql elastic-pool list-editions

アクティブなサブスクリプションで使用できるエラスティック プールエディションを一覧表示します。

使用可能なプール DTU の設定、ストレージ制限、およびデータベースごとの設定も含まれます。 詳細度を減らすために、既定では、追加のストレージ制限とデータベースごとの設定は非表示になります。

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition]
                                  [--show-details {db-max-dtu, db-max-size, db-min-dtu, max-size}]
                                  [--vcores]

例

米国西部リージョンのすべてのエラスティック プール エディションとプール DTU 制限を表示します。

az sql elastic-pool list-editions -l westus -o table

米国西部リージョンの Standard エディションのすべてのプール DTU 制限を表示します。

az sql elastic-pool list-editions -l westus --edition Standard -o table

米国西部リージョンで 100 DTU 以上のエラスティック プールで使用可能な最大サイズを表示します。

az sql elastic-pool list-editions -l westus --dtu 100 --show-details max-size -o table

米国西部リージョンの Standard 100 DTU エラスティック プールのデータベース設定ごとに使用可能な情報を表示します。

az sql elastic-pool list-editions -l westus --edition Standard --dtu 100 -o table --show-details db-min-dtu db-max-dtu db-max-size

必須のパラメーター

--location -l

Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

省略可能のパラメーター

--available -a

指定した場合は、指定したリージョンで使用可能な結果のみを表示します。

規定値: False

--dtu

検索する DTU の数。 指定しない場合は、すべての DTU サイズが表示されます。

--edition --tier -e

検索するエディション。 指定しない場合は、すべてのエディションが表示されます。

--show-details -d

出力に含める追加の詳細の一覧。

指定可能な値: db-max-dtu, db-max-size, db-min-dtu, max-size

--vcores

検索する仮想コアの数。 指定しない場合は、すべての仮想コア サイズが表示されます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql elastic-pool show

エラスティック プールを取得します。

az sql elastic-pool show [--ids]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

エラスティック プールの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--server -s

Azure SQL Server の名前。 を使用して az configure --defaults sql-server=<name>既定値を構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql elastic-pool update

エラスティック プールを更新します。

az sql elastic-pool update [--add]
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--force-string]
                           [--ha-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size]
                           [--name]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--remove]
                           [--resource-group]
                           [--server]
                           [--set]
                           [--subscription]
                           [--zone-redundant {false, true}]

例

ゾーン冗長を有効にしてエラスティック プールを更新する

az sql elastic-pool update -g mygroup -s myserver -n mypool -z

ゾーン冗長を明示的に無効にしてエラスティック プールを更新する

az sql elastic-pool update -g mygroup -s myserver -n mypool -z false

2 つの高可用性レプリカを使用してエラスティック プールを更新する

az sql elastic-pool update -g mygroup -s myserver -n mypool --ha-replicas 2

VBS エンクレーブを使用してエラスティック プールを更新する

az sql elastic-pool update -g mygroup -s myserver -n mypool --preferred-enclave-type VBS

省略可能のパラメーター

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>。

規定値: []

--capacity --dtu -c

DTU または仮想コアの整数での SKU の容量コンポーネント。

--db-dtu-max --db-max-capacity --db-max-dtu

1 つのデータベースで使用できる最大容量 (DTU または仮想コア)。

--db-dtu-min --db-min-capacity --db-min-dtu

各データベースの minumum 容量 (DTU または仮想コア) が保証されます。

--edition --tier -e

SKU のエディション コンポーネント。 使用できる値は、Basic、Standard、プレミアム、GeneralPurpose、BusinessCritical です。

--family -f

SKU のコンピューティング生成コンポーネント (仮想コア SKU の場合のみ)。 使用できる値は、Gen4、Gen5 です。

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

規定値: False

--ha-replicas --read-replicas

データベース用にプロビジョニングする高可用性レプリカの数。 Hyperscale エディションでのみ設定可能です。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--maint-config-id -m

このリソースメインテナント構成 ID または名前を指定します。

--max-size --storage

最大ストレージ サイズ。 単位が指定されていない場合、既定ではバイト (B) になります。

--name -n

エラスティック プールの名前。

--no-wait

実行時間の長い操作の終了を待機しません。

規定値: False

--preferred-enclave-type

エラスティック プール用に構成するエンクレーブの種類。

指定可能な値: Default, VBS

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

規定値: []

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--server -s

Azure SQL Server の名前。 を使用して az configure --defaults sql-server=<name>既定値を構成できます。

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。

規定値: []

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--zone-redundant -z

ゾーン冗長を有効にするかどうかを指定します。 値が指定されていない場合、既定値は true です。

指定可能な値: false, true

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。