az sql db

データベースを管理します。

コマンド

名前	説明	型	状態
az sql db advanced-threat-protection-setting	データベースの高度な脅威保護設定を管理します。	コア	GA
az sql db advanced-threat-protection-setting show	高度な脅威保護設定を取得します。	コア	GA
az sql db advanced-threat-protection-setting update	データベースの高度な脅威保護設定を更新します。	コア	GA
az sql db audit-policy	データベースの監査ポリシーを管理します。	コア	GA
az sql db audit-policy show	データベース監査ポリシーを表示します。	コア	GA
az sql db audit-policy update	データベースの監査ポリシーを更新します。	コア	GA
az sql db audit-policy wait	データベースの監査ポリシーの条件が満たされるまで、CLI を待機状態にします。	コア	GA
az sql db classification	秘密度分類を管理します。	コア	GA
az sql db classification delete	特定の列の秘密度分類を削除します。	コア	GA
az sql db classification list	特定のデータベースの秘密度分類を取得します。	コア	GA
az sql db classification recommendation	秘密度分類の推奨事項を管理します。	コア	GA
az sql db classification recommendation disable	特定の列の秘密度の推奨事項を無効にします (推奨事項はすべての列で既定で有効になっています)。	コア	GA
az sql db classification recommendation enable	特定の列に対して秘密度の推奨事項を有効にします (推奨事項はすべての列で既定で有効になっています)。	コア	GA
az sql db classification recommendation list	特定のデータベースの推奨される秘密度分類を一覧表示します。	コア	GA
az sql db classification show	特定の列の秘密度分類を取得します。	コア	GA
az sql db classification update	列の秘密度分類を更新します。	コア	GA
az sql db copy	データベースのコピーを作成します。	コア	GA
az sql db create	データベースを作成します。	コア	GA
az sql db delete	データベースを削除します。	コア	GA
az sql db export	データベースを bacpac にエクスポートします。	コア	GA
az sql db geo-backup	SQL データベース geo 冗長バックアップを管理します。	コア	プレビュー
az sql db geo-backup list	回復可能なデータベースの一覧を取得します。	コア	プレビュー
az sql db geo-backup restore	geo 冗長バックアップを新しいデータベースに復元します。	コア	プレビュー
az sql db geo-backup show	復旧可能なデータベースを取得します。これは、データベースの geo バックアップを表すリソースです。	コア	プレビュー
az sql db import	bacpac を新しいデータベースまたは既存の空のデータベースにインポートします。	コア	GA
az sql db ledger-digest-uploads	台帳ダイジェストのアップロード設定を管理します。	コア	GA
az sql db ledger-digest-uploads disable	台帳ダイジェストのアップロードを無効にします。	コア	GA
az sql db ledger-digest-uploads enable	Azure Storage アカウントまたは Azure Confidential Ledger への台帳ダイジェストのアップロードを有効にします。 台帳ダイジェストのアップロードが既に有効になっている場合、コマンドレットはダイジェスト ストレージ エンドポイントを新しい値にリセットします。	コア	GA
az sql db ledger-digest-uploads show	現在の台帳ダイジェスト設定を表示します。	コア	GA
az sql db list	サーバーまたはエラスティック プール上のデータベースを一覧表示します。	コア	GA
az sql db list-deleted	復元可能な削除されたデータベースの一覧を取得します。	コア	GA
az sql db list-editions	現在アクティブなサブスクリプションで使用できるデータベース エディションを表示します。	コア	GA
az sql db list-usages	データベースの使用状況を取得します。	コア	GA
az sql db ltr-backup	SQL データベースの長期保有バックアップを管理します。	コア	プレビュー
az sql db ltr-backup delete	長期保有バックアップを削除します。	コア	プレビュー
az sql db ltr-backup list	場所、サーバー、またはデータベースの長期保有バックアップを一覧表示します。	コア	プレビュー
az sql db ltr-backup restore	長期保有バックアップを新しいデータベースに復元します。	コア	プレビュー
az sql db ltr-backup show	データベースの長期保有バックアップを取得します。	コア	プレビュー
az sql db ltr-backup wait	データベースの条件が満たされるまで、CLI を待機状態にします。	コア	プレビュー
az sql db ltr-policy	SQL データベースの長期保有ポリシーを管理します。	コア	プレビュー
az sql db ltr-policy set	データベースの長期保有期間の設定を更新します。	コア	プレビュー
az sql db ltr-policy show	データベースの長期保有ポリシーを表示します。	コア	プレビュー
az sql db op	データベースに対する操作を管理します。	コア	GA
az sql db op cancel	データベースに対する非同期操作を取り消します。	コア	GA
az sql db op list	データベースに対して実行された操作の一覧を取得します。	コア	GA
az sql db rename	データベースの名前を変更します。	コア	GA
az sql db replica	データベース間のレプリケーションを管理します。	コア	GA
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 restore	バックアップから復元して新しいデータベースを作成します。	コア	GA
az sql db show	データベースの詳細を取得します。	コア	GA
az sql db show-connection-string	データベースへの接続文字列を生成します。	コア	GA
az sql db show-deleted	削除されたデータベースの詳細を取得します。	コア	GA
az sql db str-policy	SQL Database の短期リテンション 期間ポリシーを管理します。	コア	プレビュー
az sql db str-policy set	ライブ データベースの短期保有期間の設定を更新します。	コア	プレビュー
az sql db str-policy show	ライブ データベースの短期保持ポリシーを表示します。	コア	プレビュー
az sql db str-policy wait	ポリシーが設定されるまで、CLI を待機状態にします。	コア	プレビュー
az sql db tde	データベースの透過的なデータ暗号化を管理します。	コア	GA
az sql db tde key	データベースの暗号化保護機能を管理します。	コア	GA
az sql db tde key revalidate	データベースの暗号化保護機能キーを再検証します。	コア	GA
az sql db tde key revert	データベースの暗号化保護機能キーをサーバー レベルに戻します。	コア	GA
az sql db tde set	データベースの透過的なデータ暗号化構成を設定します。	コア	GA
az sql db tde show	Transparent Data Encryption を表示します。	コア	GA
az sql db threat-policy	データベースの脅威検出ポリシーを管理します。	コア	"非推奨"
az sql db threat-policy show	脅威検出ポリシーを取得します。	コア	"非推奨"
az sql db threat-policy update	データベースの脅威検出ポリシーを更新します。	コア	"非推奨"
az sql db update	データベースを更新します。	コア	GA

az sql db copy

データベースのコピーを作成します。

パフォーマンス レベル オプションの完全な一覧は、 az sql db list-editions -a -o table -l LOCATIONを実行することで確認できます。 コピー先データベースにはソース データベースと同じエディションが必要ですが、コピーが完了した後でエディションを変更できます。

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

例

既存の Standard データベースのコピーとして、パフォーマンス レベル S0 のデータベースを作成します。

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --service-objective S0

GeneralPurpose エディション、Gen4 ハードウェア、および 1 仮想コアを使用して、既存の GeneralPurpose データベースのコピーとしてデータベースを作成します。

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb -f Gen4 -c 1

既存のデータベースのコピーとしてローカル バックアップ ストレージの冗長性を持つデータベースを作成する

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --backup-storage-redundancy Local

必須のパラメーター

--dest-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

--dest-resource-group

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

--dest-server

コピーを作成するサーバーの名前。 指定しない場合は、既定で配信元サーバーが使用されます。

--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 エディションでのみ設定可能です。

--ids

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

--keys

SQL Database の AKV キーの一覧。

--license-type

このデータベースに適用するライセンスの種類。LicenseIncluded ライセンスが必要な場合、または BasePriceライセンスを持っていて、Azure HybridBenefit の資格がある場合は。

指定可能な値: BasePrice, LicenseIncluded

--min-capacity

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

--name -n

Azure SQL Database の名前。

--no-wait

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

規定値: False

--preferred-enclave-type

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

指定可能な値: Default, VBS

--read-scale

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

指定可能な値: Disabled, Enabled

--resource-group -g

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

--server -s

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

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

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

--subscription

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

--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 を使います。

az sql db create

データベースを作成します。

パフォーマンス レベル オプションの完全な一覧は、 az sql db list-editions -a -o table -l LOCATIONを実行することで確認できます。

az sql db create --name
                 --resource-group
                 --server
                 [--assign-identity {false, true}]
                 [--auto-pause-delay]
                 [--availability-zone]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--catalog-collation {DATABASE_DEFAULT, SQL_Latin1_General_CP1_CI_AS}]
                 [--collation]
                 [--compute-model {Provisioned, Serverless}]
                 [--edition]
                 [--elastic-pool]
                 [--encryption-protector]
                 [--encryption-protector-auto-rotation {false, true}]
                 [--exhaustion-behavior {AutoPause, BillOverUsage}]
                 [--family]
                 [--federated-client-id]
                 [--free-limit {false, true}]
                 [--ha-replicas]
                 [--keys]
                 [--ledger-on {Disabled, Enabled}]
                 [--license-type {BasePrice, LicenseIncluded}]
                 [--maint-config-id]
                 [--max-size]
                 [--min-capacity]
                 [--no-wait]
                 [--preferred-enclave-type {Default, VBS}]
                 [--read-scale {Disabled, Enabled}]
                 [--sample-name {AdventureWorksLT}]
                 [--service-level-objective]
                 [--tags]
                 [--umi]
                 [--yes]
                 [--zone-redundant {false, true}]

例

Standard S0 データベースを作成します。

az sql db create -g mygroup -s myserver -n mydb --service-objective S0

GeneralPurpose エディション、Gen4 ハードウェア、1 仮想コアを使用してデータベースを作成する

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

ゾーン冗長が有効になっているデータベースを作成する

az sql db create -g mygroup -s myserver -n mydb -z

ゾーン冗長を明示的に無効にしたデータベースを作成する

az sql db create -g mygroup -s myserver -n mydb -z false

自動一時停止遅延が 120 分の GeneralPurpose Gen5 2 仮想コア サーバーレス データベースを作成する

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --auto-pause-delay 120

2 つの読み取りレプリカを持つ Hyperscale Gen5 2 仮想コア データベースを作成する

az sql db create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 2 --read-replicas 2

ローカル冗長バックアップ ストレージを使用して GeneralPurpose データベースを作成する

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose --backup-storage-redundancy Local

VBS エンクレーブが有効になっているデータベースを作成します。

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

空き制限が適用されたデータベースを作成する

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --use-free-limit --free-limit-exhaustion-behavior AutoPause

必須のパラメーター

--name -n

Azure SQL Database の名前。

--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 の容量コンポーネント。

--catalog-collation

メタデータ カタログの照合順序。

指定可能な値: DATABASE_DEFAULT, SQL_Latin1_General_CP1_CI_AS

--collation

データベースの照合順序。

--compute-model

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

指定可能な値: Provisioned, Serverless

--edition --tier -e

SKU のエディション コンポーネント。 使用できる値は、Basic、Standard、Premium、GeneralPurpose、BusinessCritical、Hyperscale です。

--elastic-pool

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

--encryption-protector

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

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

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

指定可能な値: false, true

--exhaustion-behavior --fleb --free-limit-exhaustion-behavior

空きデータベースに対して毎月の空き制限が使い果たされたときの動作を指定します。自動一時停止: 残りの月の空き制限が使い果たされると、データベースは自動的に一時停止されます。BillForUsage: データベースは、空き制限が使い果たされた時点で引き続きオンラインになり、超過分はすべて課金されます。

指定可能な値: AutoPause, BillOverUsage

--family -f

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

--federated-client-id

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

--free-limit --use-free-limit

データベースが無料の月次制限を使用しているかどうか。 サブスクリプション内の 1 つのデータベースで許可されます。

指定可能な値: false, true

--ha-replicas --read-replicas

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

--keys

SQL Database の AKV キーの一覧。

--ledger-on

台帳データベースを作成します。このデータベースでは、すべてのデータの整合性が台帳機能によって保護されます。 台帳データベース内のすべてのテーブルは、台帳テーブルである必要があります。 注: このプロパティの値は、データベースの作成後は変更できません。

指定可能な値: Disabled, Enabled

--license-type

このデータベースに適用するライセンスの種類。LicenseIncluded ライセンスが必要な場合、または BasePriceライセンスを持っていて、Azure HybridBenefit の資格がある場合は。

指定可能な値: BasePrice, LicenseIncluded

--maint-config-id -m

このリソースの指定されたメンテナンス構成 ID または名前。

--max-size

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

--min-capacity

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

--no-wait

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

規定値: False

--preferred-enclave-type

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

指定可能な値: Default, VBS

--read-scale

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

指定可能な値: Disabled, Enabled

--sample-name

このデータベースの作成時に適用するサンプル スキーマの名前。

指定可能な値: AdventureWorksLT

--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 の一覧。

--yes -y

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

--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 db delete

データベースを削除します。

az sql db delete [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]
                 [--yes]

例

データベースを削除します。 (自動生成)

az sql db delete --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

省略可能のパラメーター

--ids

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

--name -n

Azure SQL Database の名前。

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

--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 export

データベースを bacpac にエクスポートします。

az sql db export --admin-password
                 --admin-user
                 --storage-key
                 --storage-key-type {SharedAccessKey, StorageAccessKey}
                 --storage-uri
                 [--auth-type {ADPassword, SQL}]
                 [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]

例

エクスポート操作で使用する SAS キーを取得します。

az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
    --permissions rw --expiry 2018-01-01T00:00:00Z

SAS キーを使用して bacpac をエクスポートします。

az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
    --storage-key-type SharedAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

ストレージ アカウント キーを使用して bacpac をエクスポートします。

az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key MYKEY== --storage-key-type StorageAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

必須のパラメーター

--admin-password -p

必須。 管理者ログイン パスワード。

--admin-user -u

必須。 管理者ログイン名。

--storage-key

必須。 ストレージ キー。

--storage-key-type

必須。 ストレージ キーの種類。

指定可能な値: SharedAccessKey, StorageAccessKey

--storage-uri

必須。 ストレージ URI。

省略可能のパラメーター

--auth-type -a

認証の種類。

指定可能な値: ADPassword, SQL

--ids

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

--name -n

Azure SQL Database の名前。

--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 db import

bacpac を新しいデータベースまたは既存の空のデータベースにインポートします。

az sql db import --admin-password
                 --admin-user
                 --storage-key
                 --storage-key-type {SharedAccessKey, StorageAccessKey}
                 --storage-uri
                 [--auth-type {ADPassword, SQL}]
                 [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]

例

インポート操作で使用する SAS キーを取得します。

az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
    --permissions rw --expiry 2018-01-01T00:00:00Z

SAS キーを使用して既存のデータベースに bacpac をインポートします。

az sql db import -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
    --storage-key-type SharedAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

ストレージ アカウント キーを使用して既存のデータベースに bacpac をインポートします。

az sql db import -s myserver -n mydatabase -g mygroup -p password -u login --storage-key MYKEY== \
    --storage-key-type StorageAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

必須のパラメーター

--admin-password -p

必須。 管理者ログイン パスワード。

--admin-user -u

必須。 管理者ログイン名。

--storage-key

必須。 ストレージ キー。

--storage-key-type

必須。 ストレージ キーの種類。

指定可能な値: SharedAccessKey, StorageAccessKey

--storage-uri

必須。 ストレージ URI。

省略可能のパラメーター

--auth-type -a

認証の種類。

指定可能な値: ADPassword, SQL

--ids

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

--name -n

Azure SQL Database の名前。

--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 db list

サーバーまたはエラスティック プール上のデータベースを一覧表示します。

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

例

サーバーまたはエラスティック プール上のデータベースを一覧表示します。 (自動生成)

az sql db list --resource-group MyResourceGroup --server myserver

省略可能のパラメーター

--elastic-pool

指定した場合、このエラスティック プール内のデータベースのみが一覧表示されます。

--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>を使用して構成できます。

--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 list-deleted

復元可能な削除されたデータベースの一覧を取得します。

az sql db list-deleted [--ids]
                       [--resource-group]
                       [--server]
                       [--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>を使用して構成できます。

--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 list-editions

現在アクティブなサブスクリプションで使用できるデータベース エディションを表示します。

使用可能なサービス目標とストレージの制限が含まれます。 詳細度を下げるために、ストレージの制限を意図的に減らす設定は既定で非表示になっています。

az sql db list-editions --location
                        [--available]
                        [--dtu]
                        [--edition]
                        [--service-objective]
                        [--show-details {max-size}]
                        [--vcores]

例

すべてのデータベース エディションを 1 つの場所に表示します。

az sql db list-editions -l westus -o table

Standard Edition で使用可能なすべてのデータベース サービス目標を表示します。

az sql db list-editions -l westus --edition Standard -o table

P1 サービス目標の使用可能な最大データベース サイズを表示する

az sql db list-editions -l westus --service-objective P1 --show-details max-size

必須のパラメーター

--location -l

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

省略可能のパラメーター

--available -a

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

規定値: False

--dtu

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

--edition --tier -e

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

--service-objective

検索するサービス目標。 指定しない場合は、すべてのサービス目標が表示されます。

--show-details -d

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

指定可能な値: 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 db list-usages

データベースの使用状況を取得します。

az sql db list-usages [--ids]
                      [--name]
                      [--resource-group]
                      [--server]
                      [--subscription]

省略可能のパラメーター

--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 rename

データベースの名前を変更します。

az sql db rename --new-name
                 [--ids]
                 [--name]
                 [--resource-group]
                 [--server]
                 [--subscription]

例

データベースの名前を変更します。 (自動生成)

az sql db rename --name MyAzureSQLDatabase --new-name MyNew --resource-group MyResourceGroup --server myserver

必須のパラメーター

--new-name

データベースの名前を変更する新しい名前。

省略可能のパラメーター

--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 restore

バックアップから復元して新しいデータベースを作成します。

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

例

バックアップから復元して新しいデータベースを作成します。 (自動生成)

az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22"

バックアップから復元することで、geo 冗長バックアップ ストレージを使用して新しいデータベースを作成します。 (自動生成)

az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22" --backup-storage-redundancy Geo

必須のパラメーター

--dest-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

--deleted-time

指定した場合は、既存のデータベースからではなく、削除されたデータベースから復元します。 同じサーバー内の削除されたデータベースの削除時刻と一致する必要があります。 --time または --deleted-time (または両方) を指定する必要があります。 時刻は、"YYYY-MM-DDTHH:MM:SS" の形式にする必要があります。

--edition --tier -e

SKU のエディション コンポーネント。 使用できる値は、Basic、Standard、Premium、GeneralPurpose、BusinessCritical、Hyperscale です。

--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 エディションでのみ設定可能です。

--ids

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

--keys

SQL Database の AKV キーの一覧。

--license-type

このデータベースに適用するライセンスの種類。LicenseIncluded ライセンスが必要な場合、または BasePriceライセンスを持っていて、Azure HybridBenefit の資格がある場合は。

指定可能な値: BasePrice, LicenseIncluded

--min-capacity

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

--name -n

Azure SQL Database の名前。

--no-wait

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

規定値: False

--preferred-enclave-type

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

指定可能な値: Default, VBS

--read-scale

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

指定可能な値: Disabled, Enabled

--resource-group -g

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

--server -s

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

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

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

--subscription

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

--tags

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

--time -t

新しいデータベースを作成するために復元されるソース データベースの時点。 ソース データベースの earliestRestoreDate 値以上である必要があります。 --time または --deleted-time (または両方) を指定する必要があります。 時刻は、"YYYY-MM-DDTHH:MM:SS" の形式にする必要があります。

--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 を使います。

az sql db show

データベースの詳細を取得します。

az sql db show [--expand-keys {false, true}]
               [--ids]
               [--keys-filter]
               [--name]
               [--resource-group]
               [--server]
               [--subscription]

例

データベースの詳細を取得します。 (自動生成)

az sql db show --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

省略可能のパラメーター

--expand-keys

データベースの AKV キーを展開します。

指定可能な値: false, true

規定値: False

--ids

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

--keys-filter

データベースの AKV キーを展開します。

--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 show-connection-string

データベースへの接続文字列を生成します。

az sql db show-connection-string --client {ado.net, jdbc, odbc, php, php_pdo, sqlcmd}
                                 [--auth-type {ADIntegrated, ADPassword, SqlPassword}]
                                 [--ids]
                                 [--name]
                                 [--server]
                                 [--subscription]

例

ado.net の接続文字列を生成する

az sql db show-connection-string -s myserver -n mydb -c ado.net

必須のパラメーター

--client -c

クライアント接続プロバイダーの種類。

指定可能な値: ado.net, jdbc, odbc, php, php_pdo, sqlcmd

省略可能のパラメーター

--auth-type -a

認証の種類。

指定可能な値: ADIntegrated, ADPassword, SqlPassword

規定値: SqlPassword

--ids

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

--name -n

Azure SQL Database の名前。

規定値: <databasename>

--server -s

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

規定値: <servername>

--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 show-deleted

削除されたデータベースの詳細を取得します。

az sql db show-deleted --restorable-dropped-database-id
                       [--expand-keys {false, true}]
                       [--ids]
                       [--keys-filter]
                       [--resource-group]
                       [--server]
                       [--subscription]

例

削除されたデータベースの詳細を取得します。 (自動生成)

az sql db show-deleted --resource-group MyResourceGroup --server myserver --restorable-dropped-database-id "MyAzureSQLDatabase,133203966918270000"

必須のパラメーター

--restorable-dropped-database-id -r

復元可能な削除されたデータベース ID。

省略可能のパラメーター

--expand-keys

データベースの AKV キーを展開します。

指定可能な値: false, true

規定値: False

--ids

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

--keys-filter

データベースの AKV キーを展開します。

--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 update

データベースを更新します。

az sql db update [--add]
                 [--assign-identity {false, true}]
                 [--auto-pause-delay]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--compute-model {Provisioned, Serverless}]
                 [--edition]
                 [--elastic-pool]
                 [--encryption-protector]
                 [--encryption-protector-auto-rotation {false, true}]
                 [--exhaustion-behavior {AutoPause, BillOverUsage}]
                 [--family]
                 [--federated-client-id]
                 [--filter]
                 [--force-string]
                 [--free-limit {false, true}]
                 [--ha-replicas]
                 [--ids]
                 [--keys]
                 [--keys-to-remove]
                 [--maint-config-id]
                 [--manual-cutover {false, true}]
                 [--max-size]
                 [--min-capacity]
                 [--name]
                 [--no-wait]
                 [--perform-cutover {false, true}]
                 [--preferred-enclave-type {Default, VBS}]
                 [--read-scale {Disabled, Enabled}]
                 [--remove]
                 [--resource-group]
                 [--server]
                 [--service-objective]
                 [--set]
                 [--subscription]
                 [--umi]
                 [--zone-redundant {false, true}]

例

DTU 容量を指定して、データベースを Standard エディションの S0 パフォーマンス レベル (10 DTU) に更新します。 GeneralPurpose では、Standard エディションよりも幅広い最大サイズが可能であることに注意してください。

az sql db update -g mygroup -s myserver -n mydb --edition Standard --capacity 10 --max-size 250GB

パフォーマンス レベル名を指定して、データベースを Standard Edition S1 パフォーマンス レベル (20 DTU) に更新します。 GeneralPurpose では、Standard エディションよりも幅広い最大サイズが可能であることに注意してください。

az sql db update -g mygroup -s myserver -n mydb --edition Standard --service-objective S1 --max-size 250GB

Gen5 ハードウェアを使用して、データベースを GeneralPurpose エディション、4 仮想コアに更新する

az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 4 --family Gen5

最大サイズを増やしてデータベースを更新する

az sql db update -g mygroup -s myserver -n mydb --max-size 500GB

ゾーン冗長を有効にしてデータベースを更新する

az sql db update -g mygroup -s myserver -n mydb -z

ゾーン冗長を明示的に無効にしてデータベースを更新する

az sql db update -g mygroup -s myserver -n mydb -z false

データベースをサーバーレス コンピューティング モデルに更新する

az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 2 --family Gen5 --compute-model Serverless

ローカル冗長バックアップ ストレージを使用してデータベースを更新する

az sql db update -g mygroup -s myserver -n mydb --backup-storage-redundancy Local

VBS エンクレーブを有効にしてデータベースを更新します。

az sql db update -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

空き制限データベースの枯渇動作を BillOverUsage に更新する

az sql db update -g mygroup -s myserver -n mydb --free-limit-exhaustion-behavior BillOverUsage

手動カットオーバー オプションを使用して、データベースを Hyperscale エディション (Gen5 ハードウェアで 2 仮想コア) に更新する

az sql db update -g mygroup -s myserver -n mydb --edition Hyperscale --service-objective HS_Gen5_2 --manual-cutover

データベースを Hyperscale エディションに更新するときにカットオーバーを実行するオプションを使用してカットオーバーをトリガーする

az sql db update -g mygroup -s myserver -n mydb --perform-cutover

省略可能のパラメーター

--add

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

規定値: []

--assign-identity -i

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

指定可能な値: false, true

規定値: False

--auto-pause-delay

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

--backup-storage-redundancy --bsr

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

--capacity -c

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

--compute-model

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

指定可能な値: Provisioned, Serverless

--edition --tier -e

SKU のエディション コンポーネント。 使用できる値は、Basic、Standard、Premium、GeneralPurpose、BusinessCritical、Hyperscale です。

--elastic-pool

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

--encryption-protector

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

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

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

指定可能な値: false, true

--exhaustion-behavior --fleb --free-limit-exhaustion-behavior

空きデータベースに対して毎月の空き制限が使い果たされたときの動作を指定します。自動一時停止: 残りの月の空き制限が使い果たされると、データベースは自動的に一時停止されます。BillForUsage: データベースは、空き制限が使い果たされた時点で引き続きオンラインになり、超過分はすべて課金されます。

指定可能な値: AutoPause, BillOverUsage

--family -f

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

--federated-client-id

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

--filter

コレクション内の要素をフィルター処理する OData フィルター式。 既定値は None です。

--force-string

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

規定値: False

--free-limit --use-free-limit

データベースが無料の月次制限を使用しているかどうか。 サブスクリプション内の 1 つのデータベースで許可されます。

指定可能な値: false, true

--ha-replicas --read-replicas

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

--ids

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

--keys

SQL Database の AKV キーの一覧。

--keys-to-remove

SQL Database から削除する AKV キーの一覧。

--maint-config-id -m

このリソースの指定されたメンテナンス構成 ID または名前。

--manual-cutover

Update SLO 中に手動カットオーバーを実行するかどうか。 データベースを Hyperscale レベルに更新するときに許可されます。

指定可能な値: false, true

--max-size

データベースの新しい最大サイズ (バイト単位)。

--min-capacity

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

--name -n

Azure SQL Database の名前。

--no-wait

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

規定値: False

--perform-cutover

データベースを Hyperscale レベルに更新するときにカットオーバーを実行するかどうか。

指定可能な値: false, true

--preferred-enclave-type

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

指定可能な値: Default, VBS

--read-scale

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

指定可能な値: Disabled, Enabled

--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>を使用して構成できます。

--service-objective

新しいサービス目標の名前。 これがスタンドアロンの db サービス目標であり、db が現在エラスティック プール内にある場合、db はプールから削除されます。

--set

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

規定値: []

--subscription

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

--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 を使います。