az sql db replica

  • リファレンス

データベース間のレプリケーションを管理します。

コマンド

名前 説明 型 Status
az sql db replica create

既存のデータベースの読み取り可能なセカンダリ レプリカとしてデータベースを作成します。

 コア GA
az sql db replica delete-link

2 つのデータベース レプリカ間のデータ レプリケーションを完全に停止します。

 コア GA
az sql db replica list-links

データベースのレプリカとそのレプリケーションの状態を一覧表示します。

 コア GA
az sql db replica set-primary

現在のプライマリ レプリカ データベースからフェールオーバーして、プライマリ レプリカ データベースを設定します。

 コア GA

az sql db replica create

編集

既存のデータベースの読み取り可能なセカンダリ レプリカとしてデータベースを作成します。

パフォーマンス レベル オプションの完全な一覧は、次のコマンドを az sql db list-editions -a -o table -l LOCATION実行して確認できます。 セカンダリ データベースには、プライマリ データベースと同じエディションが必要です。

az sql db replica create --name
                         --partner-server
                         --resource-group
                         --server
                         [--assign-identity {false, true}]
                         [--auto-pause-delay]
                         [--availability-zone]
                         [--backup-storage-redundancy]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective]
                         [--tags]
                         [--umi]
                         [--zone-redundant {false, true}]

例

既存の Standard データベースのセカンダリ レプリカとして、パフォーマンス レベル S0 のデータベースを作成します。

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

既存の GeneralPurpose データベースのセカンダリ レプリカとして、GeneralPurpose エディション、Gen4 ハードウェア、1 仮想コアを使用してデータベースを作成する

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

ゾーン冗長バックアップ ストレージを使用して、既存のデータベースのセカンダリ レプリカとしてデータベースを作成します。

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

必須のパラメーター

--name -n

Azure SQL Database の名前。

--partner-server

新しいレプリカを作成するサーバーの名前。

--resource-group -g

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

--server -s

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

省略可能のパラメーター

--assign-identity -i

データベースの ID を割り当てます。

承認された値: false, true
--auto-pause-delay

データベースが自動的に一時停止されるまでの時間 (分)。 値 -1 は、自動一時停止が無効になっていることを意味します。

--availability-zone

可用性ゾーン。

--backup-storage-redundancy --bsr

バックアップの格納に使用されるバックアップ ストレージの冗長性。 使用できる値は、Local、Zone、Geo、GeoZone です。

--capacity -c

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

--compute-model

データベースのコンピューティング モデル。

承認された値: Provisioned, Serverless
--elastic-pool

データベースを作成するエラスティック プールの名前またはリソース ID。

--encryption-protector

データベース暗号化保護機能キーとして使用する Azure Key Vault キーを指定します。

--encryption-protector-auto-rotation --epauto

データベース暗号化保護機能キーの自動ローテーション フラグを指定します。 true、false、null のいずれかを指定できます。

承認された値: false, true
--family -f

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

--federated-client-id

SQL Database のフェデレーション クライアント ID。 これは、テナント間の CMK シナリオに使用されます。

--ha-replicas --read-replicas

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

--keys

SQL Database の AKV キーの一覧。

--license-type

このデータベースに適用するライセンスの種類。LicenseIncluded ライセンスが必要な場合、または BasePriceライセンスをお持ちで、Azure HybridBenefit の対象である場合。

承認された値: BasePrice, LicenseIncluded
--min-capacity

一時停止されていない場合、データベースに常に割り当てられる最小限の容量。

--no-wait

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

既定値: False
--partner-database

新しいレプリカの名前。 指定しない場合は、既定でソース データベース名が使用されます。

--partner-resource-group

新しいレプリカを作成するリソース グループの名前。 指定しない場合は、既定で配信元リソース グループが使用されます。

--preferred-enclave-type

このリソースのエンクレーブの種類を指定します。

承認された値: Default, VBS
--read-scale

有効にすると、アプリケーションインテントが接続文字列で読み取り専用に設定されている接続は、読み取り専用セカンダリ レプリカにルーティングされる可能性があります。 このプロパティは、プレミアム および Business Critical データベースでのみ設定できます。

承認された値: Disabled, Enabled
--secondary-type

作成するセカンダリの種類。 使用できる値は、Geo、Named です。

--service-level-objective --service-objective

新しいデータベースのサービス目標。 例: Basic、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。

--tags

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

--umi --user-assigned-identity-id

SQL Database のユーザー割り当て 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 を使います。

編集

2 つのデータベース レプリカ間のデータ レプリケーションを完全に停止します。

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]
--partner-server

他のレプリカが存在するサーバーの名前。

--ids

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

--name -n

Azure SQL Database の名前。

--partner-resource-group

他のレプリカが存在するリソース グループの名前。 指定しない場合、既定では最初のデータベースのリソース グループが使用されます。

--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 を使用して、既定のサブスクリプションを構成できます。

--yes -y

確認のダイアログを表示しません。

既定値: False
グローバル パラメーター
--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 db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

データベースのレプリカとそのレプリケーションの状態を一覧表示します。 (自動生成)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver
--ids

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

--name -n

Azure SQL Database の名前。

--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 db replica set-primary

編集

現在のプライマリ レプリカ データベースからフェールオーバーして、プライマリ レプリカ データベースを設定します。

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

例

現在のプライマリ レプリカ データベースからフェールオーバーして、プライマリ レプリカ データベースを設定します。 (自動生成)

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

省略可能のパラメーター

--allow-data-loss

指定した場合、フェールオーバー操作によってデータの損失が許容されます。

既定値: False
--ids

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

--name -n

フェールオーバーするデータベースの名前。

--resource-group -g

新しいプライマリになるセカンダリ レプリカを含むリソース グループの名前。

--server -s

新しいプライマリになるセカンダリ レプリカを含むサーバーの名前。 を使用して 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 を使います。