適用対象:
Azure Data CLI (azdata)
注
以前に Azure Data CLI (azdata) によって処理された一部のシナリオは、 Azure CLI (az) 拡張機能 と Azure Arc ベースのワークフローを通じて管理されるようになりました。 すべての azdata コマンドに 1 対 1 の置換はありません。 次の表では、一般的に関連する Azure CLI の代替手段が存在する場所を示します。
| azdata コマンド領域 | Azure CLI 拡張機能/コマンド グループ | Azure CLI リファレンス |
|---|---|---|
azdata arc dc * |
az arcdata |
Azure Arc データ CLI リファレンス |
azdata arc sql mi * |
az arcdata sql mi |
CLI を使用して Azure SQL Managed Instance を管理する |
azdata arc postgres * |
az arcdata postgres |
CLI を使用して PostgreSQL サーバーを管理する |
azdata migrate * |
az datamigration |
CLI を使用した移行 |
azdata extension * |
az extension * |
Azure CLI 拡張機能の概要 |
azdata login |
az login |
az login |
azdata sql shell / azdata sql query |
Azure CLI に相当するものはありません ( sqlcmd、SSMS、またはその他の SQL ツールを使用) |
sqlcmd ユーティリティ SQL Server Management Studio |
新しい自動化と管理のシナリオでは、 Azure CLI (az)、 Azure CLI 拡張機能、 Azure Arc portal エクスペリエンスを優先します。
以下の記事では、azdata ツールの sql コマンドに関するリファレンスを提供します。 他の azdata コマンドの詳細については、azdata リファレンスに関するページを参照してください。
コマンド
| 命令 | 説明 |
|---|---|
| azdata arc | Azure Arc for Azure データ サービスを使用するためのコマンド。 |
| azdata sql | SQL DB CLI を使用すると、ユーザーは T-SQL 経由で SQL Server と対話できます。 |
| azdata login | クラスターのコントローラー エンドポイントにログインし、その名前空間をアクティブなコンテキストとして設定します。 ログイン時にパスワードを使用するには、AZDATA_PASSWORD環境変数を設定する必要があります。 |
| azdata logout | クラスターからログアウトします。 |
| azdata context | コンテキスト管理コマンド。 |
| azdata bdc | SQL Server ビッグ データ クラスターを選択、管理、操作します。 |
| azdata extension | CLI 拡張機能を管理および更新します。 |
| azdata app | アプリケーションを作成、削除、実行、および管理します。 |
| azdata postgres | Postgres クエリ ランナーと対話型シェル。 |
| azdata notebook | ターミナルからノートブックを表示、実行、および管理するためのコマンド。 |
azdata login
クラスターがデプロイされると、デプロイ中にコントローラー エンドポイントが一覧表示され、ログインに使用する必要があります。 コントローラー エンドポイントがわからない場合は、クラスターの kube 構成をシステムの既定の場所の <user home>/.kube/config に設定するか、KUBECONFIG env var (KUBECONFIG=path/to/.kube/config のエクスポート) を使用してログインできます。ログインすると、このクラスターの名前空間がアクティブなコンテキストに設定されます。
azdata login [--auth]
[--endpoint -e]
[--accept-eula -a]
[--namespace -ns]
[--username -u]
[--principal -p]
例示
基本認証を使用してログインします。
azdata login --auth basic --username johndoe --endpoint https://<ip or domain name>:30080
Active Directory を使用してログインします。
azdata login --auth ad --endpoint https://<ip or domain name>:30080
明示的なプリンシパルを使用して Active Directory を使用してログインします。
azdata login --auth ad --principal johndoe@COSTOSO.COM --endpoint https://<ip or domain name>:30080
対話形式でログインします。 引数として指定されていない場合、クラスター名は常に求められます。 システムにAZDATA_USERNAME、AZDATA_PASSWORD、ACCEPT_EULA env 変数が設定されている場合、これらは求めされません。 システムに kube 構成がある場合、または KUBECONFIG env var を使用して構成のパスを指定している場合、対話型エクスペリエンスは最初に構成の使用を試み、構成が失敗した場合にプロンプトを表示します。
azdata login
(非対話形式で) ログインします。 クラスター名、コントローラー ユーザー名、コントローラー エンドポイント、および EULA 同意が引数として設定された状態でログインします。 環境変数AZDATA_PASSWORDを設定する必要があります。 コントローラー エンドポイントを指定しない場合は、コンピューター上の kube 構成 <user home>/.kube/config の既定の場所に配置するか、KUBECONFIG env var (KUBECONFIG=path/to/.kube/config のエクスポート) を使用してください。
azdata login --namespace ClusterName --username johndoe@contoso.com --endpoint https://<ip or domain name>:30080 --accept-eula yes
マシンで kube 構成を使用してログインし、AZDATA_USERNAME、AZDATA_PASSWORD、ACCEPT_EULAに env var を設定します。
azdata login -n ClusterName
省略可能なパラメーター
--auth
認証戦略。 基本認証または Active Directory 認証。 既定値は "基本" 認証です。
--endpoint -e
クラスター コントローラー エンドポイント "https://host:port"。 この引数を使用しない場合は、マシンで kube 構成を使用できます。 構成が既定の場所 <user home>/.kube/config にあることを確認するか、KUBECONFIG env var を使用してください。
--accept-eula -a
ライセンス条項に同意しますか? [はい/いいえ]。 この引数を使用しない場合は、環境変数ACCEPT_EULAを "yes" に設定できます。 この製品のライセンス条項は、 https://aka.ms/eula-azdata-enで確認できます。
--namespace -ns
クラスター コントロール プレーンの名前空間。
--username -u
アカウント ユーザー。 この引数を使用しない場合は、環境変数をAZDATA_USERNAME設定できます。
--principal -p
Kerberos 領域。 ほとんどの場合、Kerberos 領域はドメイン名 (大文字) です。
グローバル引数
--debug
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
--help -h
このヘルプ メッセージを表示して終了します。
--output -o
出力フォーマット。 使用できる値: json、jsonc、table、tsv。 既定値: json。
--query -q
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
--verbose
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
azdata logout
クラスターからログアウトします。
azdata logout
例示
このユーザーをログアウトします。
azdata logout
グローバル引数
--debug
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
--help -h
このヘルプ メッセージを表示して終了します。
--output -o
出力フォーマット。 使用できる値: json、jsonc、table、tsv。 既定値: json。
--query -q
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
--verbose
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
次のステップ
他の azdata コマンドの詳細については、azdata リファレンスに関するページを参照してください。
azdata ツールをインストールする方法の詳細については、「azdata のインストール」を参照してください。