azdata bdc

適用対象: Azure Data CLI (azdata)

以下の記事では、azdata ツールの sql コマンドに関するリファレンスを提供します。 他の azdata コマンドの詳細については、azdata リファレンスに関するページを参照してください。

コマンド

command	説明
azdata bdc create	ビッグ データ クラスターを作成します。
azdata bdc delete	ビッグ データ クラスターを削除します。
azdata bdc upgrade	SQL Server ビッグ データ クラスターの各コンテナーにデプロイされているイメージを更新します。
azdata bdc config	構成コマンド。
azdata bdc endpoint	エンドポイント コマンド。
azdata bdc debug	デバッグ コマンド。
azdata bdc status	ビッグ データ クラスターの状態コマンド。
azdata bdc control	制御サービス コマンド。
azdata bdc sql	SQL サービス コマンド。
azdata bdc hdfs	HDFS サービス コマンド。
azdata bdc spark	Spark サービス コマンド。
azdata bdc gateway	ゲートウェイ サービス コマンド。
azdata bdc app	アプリ サービス コマンド。
azdata bdc hdfs	HDFS モジュールには、HDFS ファイル システムにアクセスするコマンドが用意されています。
azdata bdc settings	ビッグ データ クラスターの設定コマンド。
azdata bdc spark	Spark コマンドを使用してセッション、ステートメント、およびバッチを作成および管理することで、ユーザーは Spark システムと対話できます。
azdata bdc rotate	このコマンドによって、ビッグ データ クラスターで自動生成された AD アカウントのパスワードをローテーションします。 詳細については、AD パスワードのローテーションの概要に関する記事を参照してください。

azdata bdc create

SQL Server ビッグ データ クラスターを作成します。Kubernetes の構成と環境変数 ['AZDATA_USERNAME', 'AZDATA_PASSWORD'] がシステムに必要です。

azdata bdc create [--name -n] 
                  [--config-profile -c]  
                  
[--accept-eula -a]  
                  
[--node-label -l]  
                  
[--force -f]

例

ガイド付きの SQL Server ビッグ データ クラスターの展開エクスペリエンス。必要な値の入力を求めるメッセージが表示されます。

azdata bdc create

引数と azdata bdc config init を介して初期化されたカスタム構成プロファイルを使用するビッグ データ クラスター展開。

azdata bdc create --accept-eula yes --config-profile ./path/to/config/profile

カスタム クラスター名が指定され、既定の構成プロファイルが aks-dev-test であるビッグ データ クラスター展開。

azdata bdc create --name <cluster_name> --accept-eula yes --config-profile aks-dev-test

引数を使用したビッグ データ クラスター展開。--force フラグが使用されるため、プロンプトは表示されません。

azdata bdc create --accept-eula yes --config-profile aks-dev-test --force

省略可能なパラメーター

--name -n

ビッグ データ クラスターの名前。kubernetes 名前空間に使用されます。

--config-profile -c

クラスターの展開に使用されるビッグ データ クラスター構成プロファイル: ['kubeadm-dev-test', 'kubeadm-prod', 'openshift-prod', 'aks-dev-test-ha', 'aks-dev-test', 'aro-dev-test', 'openshift-dev-test', 'aro-dev-test-ha']

--accept-eula -a

Do you accept the license terms? (ライセンス条項に同意しますか?) [yes/no]. ([はい/いいえ]。) この引数を使用しない場合は、環境変数 ACCEPT_EULA を 'yes' に設定できます。 azdata のライセンス条項については、 https://aka.ms/eula-azdata-en を参照してください。

--node-label -l

ビッグ データ クラスター ノードのラベル。展開先のノードを指定するために使用されます。

--force -f

強制的に作成すると、ユーザーは値の入力を求められず、すべての問題が stderr の一部として出力されます。

グローバル引数

--debug

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

--help -h

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

--output -o

出力形式。 使用できる値: json、jsonc、table、tsv。 既定値: json。

--query -q

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

--verbose

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

azdata bdc delete

SQL Server ビッグ データ クラスターを削除します。Kubernetes の構成がシステムに必要です。

azdata bdc delete --name -n 
                  [--force -f]

例

ビッグ データ クラスターの削除。

azdata bdc delete --name <cluster_name>

必須のパラメーター

--name -n

ビッグ データ クラスターの名前。kubernetes 名前空間に使用されます。

省略可能なパラメーター

--force -f

ビッグ データ クラスターを強制的に削除します。

グローバル引数

--debug

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

--help -h

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

--output -o

出力形式。 使用できる値: json、jsonc、table、tsv。 既定値: json。

--query -q

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

--verbose

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

azdata bdc upgrade

SQL Server ビッグ データ クラスターの各コンテナーにデプロイされているイメージを更新します。 更新されるイメージは、渡した Docker イメージに基づきます。 更新されるイメージが、現在展開されているイメージとは別の Docker イメージ リポジトリからのものである場合は、"repository" パラメーターも必要です。

azdata bdc upgrade --name -n 
                   --tag -t  
                   
[--repository -r]  
                   
[--controller-timeout -k]  
                   
[--stability-threshold -s]  
                   
[--component-timeout -p]  
                   
[--force -f]

例

同じリポジトリからの新しいイメージ タグ "cu2" へのビッグ データ クラスターのアップグレード。

azdata bdc upgrade -t cu2

新しいリポジトリ "foo/bar/baz" からのタグ "cu2" を持つ新しいイメージへのビッグ データ クラスターのアップグレード。

azdata bdc upgrade -t cu2 -r foo/bar/baz

同じリポジトリからのタグ "cu2" を持つ新しいイメージへのビッグ データ クラスターのアップグレード。アップグレードは、コントローラーがアップグレードされるまで 30 分間、コントローラー db がアップグレードされるまで 30 分間待機します。 その後、残りのクラスターのアップグレードをクラッシュさせることなく、コントローラーとコントローラー db が実行されるのを 3 分間待機します。 アップグレードの後続の各フェーズは、完了するまでに 40 分かかります。

azdata bdc upgrade -t cu2 --controller-timeout=30 --component-timeout=40 --stability-threshold=3

必須のパラメーター

--name -n

ビッグ データ クラスターの名前。kubernetes 名前空間に使用されます。

--tag -t

クラスター内のすべてのコンテナーをアップグレードするターゲットの Docker イメージ タグ。

省略可能なパラメーター

--repository -r

クラスター内のすべてのコンテナーでイメージをプルする Docker リポジトリ。

--controller-timeout -k

アップグレードがロールバックされるまでの、コントローラーまたはコントローラー データベースのアップグレードを待機する分数。

--stability-threshold -s

アップグレード後、安定とマークされるまで待機する分数。

--component-timeout -p

(コントローラーのアップグレード後に) アップグレードを一時停止する前にアップグレードの各フェーズが完了するまで待機する分数。

--force -f

存在する場合、アップグレードを開始する前に、クラスターの正常性チェックを無視します。

グローバル引数

--debug

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

--help -h

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

--output -o

出力形式。 使用できる値: json、jsonc、table、tsv。 既定値: json。

--query -q

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

--verbose

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

次のステップ

他の azdata コマンドの詳細については、azdata リファレンスに関するページを参照してください。

azdata ツールをインストールする方法の詳細については、「azdata のインストール」を参照してください。