メインコンテンツまでスキップ

AI Runtime CLI のインストール

備考

ベータ版

AI Runtime CLI は ベータ版です。

このページでは、air CLI をインストールし、Databricks ワークスペースに対する認証を設定する方法について説明します。

要件

  • Python 3.10 以降。
  • AI Runtime が有効になっている Databricks ワークスペース要件を参照してください。
  • Databricks CLI は、~/.databrickscfgで認証プロファイルを管理します。

CLI のインストール

Databricksは、uv を使用してCLIをインストールすることをお勧めします。

Bash
uv tool install --force databricks-air --python 3.12

uv tool install air を独自の分離された環境に配置し、PATH で利用できるようにすることで、トレーニングコードで使用する Python インタプリタと競合しないようにします。

--python 3.12 推奨ですが任意です。Pythonのバージョンを指定しない場合、uv はパッケージのPython制約を満たす利用可能な最新バージョンを使用します。

uvがまだインストールされていない場合は、最初にインストールしてください:

Bash
curl -LsSf https://astral.sh/uv/install.sh | sh

インストールを確認します:

Bash
air --version
air --help

認証

AI Runtime CLI は Databricks CLI 認証プロファイルを再利用します。ワークスペースにログインし、プロンプトが表示されたらプロファイルに名前を付けます:

Bash
databricks auth login --host https://<your-workspace>.cloud.databricks.com

プロファイル名をいずれかの air コマンドに -p を指定して渡します。例えば:

Bash
air list runs -p my-workspace

または、シェルでDATABRICKS_CONFIG_PROFILEを設定してプロファイルをデフォルトにするには:

Bash
export DATABRICKS_CONFIG_PROFILE=my-workspace

すべての認証オプションについては、「Databricks CLI の認証」を参照してください。

次のステップ