air コマンド グループ

備考

プレビュー

この機能は パブリック プレビュー段階です。

Databricks CLI内のairコマンドグループは、AI ランタイムのトレーニングワークロードを送信および管理します。要件と使用方法のガイダンスについては、AI ランタイムでのDatabricks CLIの使用を参照してください。最初のワークロードを送信するには、AI Runtime向けDatabricks CLIクイックスタートを参照してください。

完全なコマンドおよび構成のリファレンスについては、CLI のヘルプを使用してください。

Bash

databricks air --help                  # All commands
databricks air <command> --help        # Flags for a specific command
databricks air run -h config           # YAML config reference
databricks air run -h config.compute   # Per-field help for a YAML section

CLIのヘルプには、インストールされている正確なバージョンが反映されます。設定のヘルプは検証スキーマから生成されるため、フィールドの種類、要件、制約を確認するために使用してください。

コマンド

コマンド	目的
databricks air run	YAML 設定からトレーニングワークロードを送信します。-f（--file）、--watch、--dry-run、繰り返し可能な --override フラグ、および --idempotency-key をサポートします。
databricks air get <run-id>	指定されたランのステータス、構成、およびタイミングの詳細を表示します。
databricks air list	現在のユーザーのアクティブなランの一覧表示。--all-status を使用して完了したランを含め、--all-users を使用して他のユーザーを含め、--limit を使用して結果カウントを設定します（default は 20）。--filter KEY=VALUE を繰り返して、accelerator_type、experiment、num_accelerators、または user でフィルタリングします。
databricks air logs <run-id>	アクティブなランから Logs をストリームするか、完了したランから Logs をフェッチします。--node を使用してノードを選択し、--retry を使用して試行を選択し、--download-to を使用して完全な Logs を download します。
databricks air cancel <run-id> [<run-id> ...]	1 つ以上のランをキャンセルします。--all を使用してアクティブなランをキャンセルします。--yesを渡さない限り、--allは確認を求めます。
databricks air convert-to-dabs <yaml-path>	ワークスペースに接続せずに、ワークロード YAML をローカルで宣言型オートメーションバンドルに変換します。--output-dir を使用してバンドル ディレクトリを選択し、--force を使用して生成されたファイルを上書きします。

コマンド	目的
databricks air run	YAML 設定からトレーニングワークロードを送信します。-f（--file）、--watch、--dry-run、繰り返し可能な --override フラグ、および --idempotency-key をサポートします。
databricks air get <run-id>	指定されたランのステータス、構成、およびタイミングの詳細を表示します。
databricks air list	現在のユーザーのアクティブなランの一覧表示。--all-status を使用して完了したランを含め、--all-users を使用して他のユーザーを含め、--limit を使用して結果カウントを設定します（default は 20）。--filter KEY=VALUE を繰り返して、accelerator_type、experiment、num_accelerators、または user でフィルタリングします。
databricks air logs <run-id>	アクティブなランから Logs をストリームするか、完了したランから Logs をフェッチします。--node を使用してノードを選択し、--retry を使用して試行を選択し、--download-to を使用して完全な Logs を download します。
databricks air cancel <run-id> [<run-id> ...]	1 つ以上のランをキャンセルします。--all を使用してアクティブなランをキャンセルします。--yesを渡さない限り、--allは確認を求めます。
databricks air convert-to-dabs <yaml-path>	ワークスペースに接続せずに、ワークロード YAML をローカルで宣言型オートメーションバンドルに変換します。--output-dir を使用してバンドル ディレクトリを選択し、--force を使用して生成されたファイルを上書きします。

databricks air run -f train.yaml --dry-run ワークロードを送信したり認証を必要としたりすることなく、YAML スキーマを検証し、ローカルでオーバーライドします。ローカルコードパスや Git リビジョンの存在確認、ワークスペースの権限や GPU 可用性の検証は行われません。

Logs の場合は、--tail を使用して行数を選択するか、--minutes を使用して時間枠を選択します。これらのフラグは相互に排他的であり、--download-to と同時に指定することはできません。

グローバル フラグ

フラグ	目的
-p, --profile	default の代わりに名前付き Databricks CLI 認証プロファイルを使用します。
--debug	デバッグロギングを有効にします。
-o, --output	出力形式 (text または json) を選択します。The default is textです。
-t, --target	該当する場合は、バンドルターゲットを選択します。

フラグ	目的
-p, --profile	default の代わりに名前付き Databricks CLI 認証プロファイルを使用します。
--debug	デバッグロギングを有効にします。
-o, --output	出力形式 (text または json) を選択します。The default is textです。
-t, --target	該当する場合は、バンドルターゲットを選択します。

コマンドで -h または --help を使用して、そのヘルプを表示します。YAML フィールドのヘルプを表示するには、databricks air run -h config.<section> を使用します。

レガシー Python CLI との違い

Databricks CLIとレガシーのPythonベースのair CLIでは、異なるコマンド名とフラグが使用されます。次のマッピングを使用してスクリプトをアップデートします。

Python CLI	Databricks CLI
air run -f train.yaml	databricks air run -f train.yaml
air run -f train.yaml --override A=X B=Y	databricks air run -f train.yaml --override A=X --override B=Y
air get run <run-id>	databricks air get <run-id>
air list runs	databricks air list --all-status
air list runs --active	databricks air list
air -h config	databricks air run -h config
air logs <run-id>	databricks air logs <run-id>
air cancel <run-id>	databricks air cancel <run-id>

Python CLI	Databricks CLI
air run -f train.yaml	databricks air run -f train.yaml
air run -f train.yaml --override A=X B=Y	databricks air run -f train.yaml --override A=X --override B=Y
air get run <run-id>	databricks air get <run-id>
air list runs	databricks air list --all-status
air list runs --active	databricks air list
air -h config	databricks air run -h config
air logs <run-id>	databricks air logs <run-id>
air cancel <run-id>	databricks air cancel <run-id>

その他のリソース

• AI ランタイム 用 Databricks CLI クイックスタート
• Workload YAML リファレンス
• MLflow とジョブのランページでランを追跡する