Databricks CLI チュートリアル
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。
Databricks コマンドラインインターフェイス (Databricks CLI とも呼ばれます) ユーティリティは、ターミナル、コマンドプロンプト、または自動化スクリプトから Databricks プラットフォームを自動化するための使いやすいインターフェイスを提供します。「Databricks CLI とは」を参照してください。
この記事では、Databricks CLI をすばやくインストールして構成する方法について説明します。
ローカルマシンの要件を確認する
このチュートリアルでは、次のことを前提としています。
- LinuxまたはmacOSの場合、Homebrewがインストールされています。
Homebrew を使用できない場合、CLI をインストールする他の方法については、「 Databricks CLI のインストールまたは更新」を参照してください。
- Windowsの場合は、winget、Chocolatey、またはWindows Subsystem for Linux (WSL)がインストールされています。インストール方法については、ご使用のOSのマニュアルを参照してください。
Chocolatey を使用した Databricks CLI のインストールは 試験段階です。
winget
、Chocolatey、または WSL を使用できない場合、CLI を他の方法でインストールするには、「Databricks CLI のインストールまたは更新」を参照してください。
Databricks CLI をインストールする
まず、Databricks CLI をインストールします。
- まだインストールされていない場合は、次のように Databricks CLI をインストールします。
- Linux, macOS
- Windows
Use Homebrew to install the Databricks CLI by running the following two commands:
brew tap databricks/tap
brew install databricks
You can use winget, Chocolatey or Windows Subsystem for Linux (WSL) to install the Databricks CLI. If you cannot use winget
, Chocolatey, or WSL, you should skip this procedure and use the Command Prompt or PowerShell to install the Databricks CLI from source instead.
Installing the Databricks CLI with Chocolatey is Experimental.
To use winget
to install the Databricks CLI, run the following two commands, and then restart your Command Prompt:
winget search databricks
winget install Databricks.DatabricksCLI
To use Chocolatey to install the Databricks CLI, run the following command:
choco install databricks-cli
To use WSL to install the Databricks CLI:
-
Install
curl
andzip
through WSL. For more information, see your operating system’s documentation. -
Use WSL to install the Databricks CLI by running the following command:
Bashcurl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
-
次のコマンドを実行して、Databricks CLIがインストールされていることを確認します。これにより、Databricks CLIの現在のバージョンが表示されるので、そのバージョンが0.205.0以降であることを確認します。
Bashdatabricks -v
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
ワークスペースへのアクセスを構成する
次に、Databricks ワークスペースへのアクセスを構成します。
このチュートリアルでは、OAuth ユーザー間 (U2M) 認証を使用して、Databricks ユーザー アカウントを使用して CLI を認証します。他の Databricks 認証の種類を使用するように CLI を構成するには、「 Databricks CLI の認証」を参照してください。
-
Databricks CLI を使用して、ターゲット アカウントまたはワークスペースごとに次のコマンドを実行して、OAuth トークン管理をローカルで開始します。
アカウントレベルの操作については、以下のコマンドでプレースホルダーを置き換えてください:
<account-console-url>
をDatabricks https://accounts.gcp.databricks.comに置き換えます。<account-id>
を Databricks アカウント ID に置き換えます。「アカウント ID を確認する」を参照してください。
Bashdatabricks auth login --host <account-console-url> --account-id <account-id>
ワークスペース レベルの操作の場合は、次のコマンドで、
<workspace-url>
を Databricks ワークスペース インスタンスの URL に置き換えます (例:https://1234567890123456.7.gcp.databricks.com
)。Bashdatabricks auth login --host <workspace-url>
-
Databricks CLI では、入力した情報を Databricks 構成プロファイルとして保存するように求められます。
Enter
キーを押して提案されたプロファイル名を受け入れるか、新規または既存のプロファイルの名前を入力します。同じ名前の既存のプロファイルは、入力した情報で上書きされます。 プロファイルを使用すると、複数のアカウントまたはワークスペース間で認証コンテキストをすばやく切り替えることができます。既存のプロファイルのリストを取得するには、別のターミナルまたはコマンドプロンプトでDatabricks CLIを使用してコマンド
databricks auth profiles
を実行します。特定のプロファイルの既存の設定を表示するには、コマンドdatabricks auth env --profile <profile-name>
を実行します。 -
ウェブブラウザで、画面の指示に従ってDatabricksアカウントまたはワークスペースにログインします。
-
以下のいずれかのコマンドを実行して、プロファイルの現在のOAuthトークンの値とトークンの今後の有効期限のタイムスタンプを表示します。
アカウントレベルの操作では、以下のコマンドを実行してください:
databricks auth token -p <profile-name>
databricks auth token --host <workspace-url> --account-id <account-id>
databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>
--host
と--account-id
の値が同じプロファイルが複数ある場合は、Databricks CLIが一致するOAuthトークン情報を正しく見つけられるように、--host
、--account-id
、-p
オプションをまとめて指定する必要がある場合があります。ワークスペースレベルの操作では、以下のコマンドを実行してください:
databricks auth token -p <profile-name>
databricks auth token --host <workspace-url>
databricks auth token --host <workspace-url> -p <profile-name>
同じ
--host
値を持つプロファイルが複数ある場合、Databricks CLIが正しいOAuthトークン情報を見つけられるように--host
と-p
オプションを一緒に指定する必要がある場合があります。
次のステップ
- CLI の使用方法については、「 Databricks CLI の基本的な使用方法」を参照してください。
- 使用可能な CLI コマンドの概要については、「 Databricks CLI コマンド」を参照してください。
- CLI が実行されない場合、または予期しない結果が生じる場合は、 CLI のインストールの確認を参照してください。