Databricks CLI をインストールまたは更新する
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。
この記事では、Databricks CLI をインストールまたは更新する方法について説明します。 「Databricks CLI とは」を参照してください。Databricks CLI の認証を構成するには、「 Databricks CLI の認証」を参照してください。
インストールします
Databricks CLIバージョン0.205以降をインストールするには:
- Linux または macOS: Homebrew、 curl、 またはソース ビルドを使用します。
- Windows : WinGet、 Chocolatey、 Windows Subsystem for Linux (WSL)、または ソース ビルドを使用します。
Databricks CLI は、Databricks ワークスペースのユーザー インターフェイス内からも使用できます。 「Databricks CLI コマンドの実行」を参照してください。
更新します
以前にインストールしたバージョン0.205以降のDatabricks CLIをアップデートするには:
- Linux または macOS: Homebrew、 curl、 またはソース ビルドを使用します。
- Windows : WinGet、 Chocolatey、 Windows Subsystem for Linux (WSL)、または ソース ビルドを使用します。
LinuxまたはMacOS用の自作インストール
このインストールオプションでは、Homebrewを使用して、Databricks CLIの最新の実行可能リリースを自動的にダウンロードしてインストールします。
ターミナルから次の2つのHomebrewコマンドを実行して、CLIをインストールします。
brew tap databricks/tap
brew install databricks
次に 、Databricks CLI の認証に進みます。
Homebrewがインストールされているかどうかわからない場合、または前述のHomebrewコマンドが機能しない場合は、以下の手順に従ってください。
-
LinuxシェルプロンプトまたはmacOSターミナルから次のコマンドを実行して、Homebrewがすでにインストールされているかどうかを確認します。Homebrewがインストールされている場合は、Homebrewのバージョン番号が表示されます。
Bashbrew -v
-
Homebrewがまだインストールされていない場合は、以下のコマンドを実行してインストールします。
Bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
続いて、次のコマンドを実行するとHomebrewのバージョン番号が表示されるため、Homebrewがインストールされていることを確認できます。
Bashbrew -v
-
次のコマンドを実行することで、Homebrewを使って、GitHubのdatabricks/homebrew-tapリポジトリを、利用可能なHomebrew Tapリポジトリの一覧に追加します。
Bashbrew tap databricks/tap
-
次のコマンドを実行することで、Homebrewを使って、Databricks CLI実行可能ファイルをダウンロードしてインストールするよう
databricks/homebrew-tap
リポジトリに指示します。Bashbrew install databricks
-
Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように
-v
オプションを使用するか、version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。Bashdatabricks -v
# Or:
databricks versionバージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
- 「Databricks CLI の認証」に進みます。
Windows用のWinGetインストール
このインストールオプションでは、wingetを使用して、Databricks CLIの最新の実行可能リリースを自動的にダウンロードしてインストールします。
-
コマンドプロンプトから次の2つの
winget
コマンドを実行してCLIをインストールし、次のコマンドプロンプトを再起動させます。Bashwinget search databricks
winget install Databricks.DatabricksCLI -
Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように
-v
オプションを使用するか、version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。Bashdatabricks -v
# Or:
databricks versionバージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
- 「Databricks CLI の認証」に進みます。
Windows用のChocolateyのインストール
Chocolatey を使用した Databricks CLI のインストールは 試験段階です。
このインストールオプションでは、Chocolateyを使用して、最新のDatabricks CLI実行リリースを自動的にダウンロードしてインストールします。
-
コマンドプロンプトから以下の
choco
コマンドを実行してCLIをインストールします。Bashchoco install databricks-cli
-
Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように
-v
オプションを使用するか、version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。Bashdatabricks -v
# Or:
databricks versionバージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
- 「Databricks CLI の認証」に進みます。
Linux、macOS、およびWindows用のcurlインストール
このインストールオプションでは、curlを使用して、最新のDatabricks CLI実行リリースをダウンロードしてインストールします。
Windows の場合、Databricks では Windows Subsystem for Linux (WSL) を使用することをお勧めします。 また、 unzip
がインストールされている必要があります。 インストール手順については、オペレーティングシステムのマニュアルを参照してください。 WSL を使用できない場合は、この手順をスキップし、代わりにコマンド プロンプトまたは PowerShell を使用して ソースから Databricks CLI をインストールします 。
-
curl
をインストールする必要があります。Linuxシェルプロンプト、macOSターミナル、またはWSLのBashから次のコマンドを実行すると、curl
がすでにインストールされているかどうかを確認できます。curl
がインストールされている場合は、以下のようにcurl
のバージョン番号が表示されます。Bashcurl -V
-
curl
がまだインストールされていない場合は、お使いのOSとアーキテクチャのcurl
のリリースおよびダウンロードページの指示に従って、インストールします。マシンのアーキテクチャの取得方法については、お使いのOSのマニュアルを参照してください。続いて、次のコマンドを実行すると
curl
のバージョン番号が表示されるため、curl
がインストールされていることを確認できます。Bashcurl -V
-
curl
を使用して次のコマンドを実行し、Databricks CLIの実行可能ファイルをダウンロードしてインストールします(すべてのOSで、-fsSL
には、大文字と小文字を含め正しく記述する必要があります)。Bashcurl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
実行前にスクリプトの内容を確認するには、GitHubのDatabricks CLIセットアップロポジトリにあるinstall.shファイルを参照してください。
Windowsの場合、このコマンドは管理者として実行する必要があります。
LinuxおよびmacOSで、/usr/local/bin
が書き込み可能ではないというエラーメッセージが表示される場合は、 sudo
を使用してコマンドを再実行します。
このコマンドを使用すると、macOSおよびLinuxではパス/usr/local/bin/databricks
に、WindowsではC:\Windows\databricks.exe
にDatabricks CLI実行可能ファイルをダウンロードしてインストールできます。
Databricks CLIがすでにインストールされている場合は、"Target path <path>
already exists."というエラーメッセージが表示されます。この場合は、前のパスからDatabricks CLI実行可能ファイルを手動で削除してから、あらためてcurl
コマンドを再実行する必要があります。
4. Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように-v
オプションを使用するか、 version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。
databricks -v
# Or:
databricks version
バージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
- 「Databricks CLI の認証」に進みます。
Linux、macOS、および Windows のソースインストール
このインストールオプションでは、.zip
ファイルを手動でダウンロードし、ダウンロードした.zip
ファイルからDatabricks CLI実行可能ファイルを手動で取り出します。
-
GitHub の Databricks CLI リポジトリの [リリース] セクションに記載されている最新の Databricks CLI
.zip
ファイルをローカル開発マシンにダウンロードします。最新リリースには、リリースのリストの横にLatest
ラベルが付いています。 最新のプレリリースにはPre-release
ラベルがあり、実験やアーリーアダプターに適しています。 リリースのAssets
セクションからダウンロードする.zip
ファイルは、開発マシンのオペレーティング システムとアーキテクチャと一致している必要があります。ファイル名
アーキテクチャ
databricks_cli_X.Y.Z_darwin_amd64.zip
macOS、Intel 64ビット/
x86_64
databricks_cli_X.Y.Z_darwin_arm64.zip
macOS、Apple Silicon /
M
シリーズ /arm64
databricks_cli_X.Y.Z_linux_amd64.zip
Linux、Intel 64ビット /
x86_64
databricks_cli_X.Y.Z_linux_arm64.zip
Linux、ARM 64ビット/
arm64
databricks_cli_X.Y.Z_windows_386.zip
Windows、インテル 32-ビット /
x86
databricks_cli_X.Y.Z_windows_amd64.zip
Windows、インテル 64-ビット /
AMD64
databricks_cli_X.Y.Z_windows_arm64.zip
Windows、ARM 64 ビット /
ARM64
マシンのアーキテクチャの取得方法については、お使いのOSのマニュアルを参照してください。例えば:
- Linux:ターミナルコマンド
uname -m
、lscpu
、またはsudo lshw -c cpu
。 - macOS: Apple のアイコンメニュー > このMacについて 、または「ターミナル」コマンド
uname -m
。 - Windows:コマンドプロンプトまたはPowerShellコマンド
echo %PROCESSOR_ARCHITECTURE%
。
これらの
.zip
ファイルのいずれかで整合性を検証する必要がある場合、Databricksでは、.zip
ファイルと同じリストにdatabricks_cli_X.Y.Z_SHA256SUMS
という名前のチェックサムファイルを提供します。チェックサム検証の実行方法については、お使いのOSのマニュアルを参照してください。 - Linux:ターミナルコマンド
-
ダウンロードした
.zip
ファイルからコンテンツを取り出します。.zip
ファイルからの抽出方法については、お使いのOSのマニュアルを参照してください。 -
取り出したコンテンツには、
.zip
ファイルと同じ名前のフォルダーがあります。このフォルダーに、Databricks CLI実行可能ファイルが入っています。このDatabricks CLI実行可能ファイルをそのままにしておいても、別の場所にコピーまたは移動しても構いません。 -
Databricks CLIが正しくインストールされていることを確認します。具体的には、Linuxのシェルプロンプト、macOSのターミナル、またはWindowsのコマンドプロンプトから、以下のように
-v
オプションを使用するか、version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。Bashdatabricks -v
# Or:
databricks versionバージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
macOSの場合は、Databricks CLIを実行できるようにシステムを承認する必要がある場合があります。詳しくは、「開発元が未確認のMacアプリを開く」を参照してください。
- 「Databricks CLI の認証」に進みます。
LinuxまたはmacOS用の自作アップデート
このアップデートオプションでは、Homebrewを使用して、以前にインストールしたバージョン0.205以降のDatabricks CLIを最新バージョンに自動的にアップデートします。
-
LinuxのシェルプロンプトまたはmacOSのターミナルから、次のコマンドを実行することで、Homebrewを使って、Databricks CLI 実行可能ファイルの最新バージョンをダウンロードしてアップデートします。
Bashbrew upgrade databricks
-
Databricks CLIが正しくアップデートされていることを確認します。具体的には、以下のように
-v
オプションを使用するか、version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。Bashdatabricks -v
# Or:
databricks versionアップデート後のバージョン番号が表示されれば、Databricks CLIは正しくインストールされています。
Databricks CLIのバージョン一覧については、GitHubのDatabricks CLIリポジトリのリリースセクションを参照してください。リリースリストでは、最新リリースの横に
Latest
ラベルが付いています。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
Databricks CLIのバージョンをダウングレードするには、GitHubのdatabricks/homebrew-tapリポジトリにある指示を参照してください。
Windows の WinGet 更新プログラム
このアップデートオプションでは、wingetを使用して、Databricks CLIのバージョン0.205以降の旧バージョンを自動的にダウンロードして最新バージョンにアップデートします。
-
コマンドプロンプトから
winget
を使用して以下のコマンドを実行し、最新バージョンのDatabricks CLI実行ファイルをダウンロードしてアップデートします。Bashwinget upgrade Databricks.DatabricksCLI
-
Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように
-v
オプションを使用するか、version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。Bashdatabricks -v
# Or:
databricks versionアップデート後のバージョン番号が表示されれば、Databricks CLIは正しくインストールされています。
Databricks CLIのバージョン一覧については、GitHubのDatabricks CLIリポジトリのリリースセクションを参照してください。リリースリストでは、最新リリースの横に
Latest
ラベルが付いています。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
Windows用のChocolateyアップデート
Chocolatey を使用した Databricks CLI の更新は 試験段階です。
このアップデートオプションでは、Chocolateyを使用して、Databricks CLIのバージョン0.205以降の旧バージョンを自動的にダウンロードして最新バージョンにアップデートします。
-
コマンドプロンプトから
choco
を使用して以下のコマンドを実行し、最新バージョンのDatabricks CLI実行ファイルをダウンロードしてアップデートします。Bashchoco upgrade databricks-cli
-
Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように
-v
オプションを使用するか、version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。Bashdatabricks -v
# Or:
databricks versionアップデート後のバージョン番号が表示されれば、Databricks CLIは正しくインストールされています。
Databricks CLIのバージョン一覧については、GitHubのDatabricks CLIリポジトリのリリースセクションを参照してください。リリースリストでは、最新リリースの横に
Latest
ラベルが付いています。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
Linux、macOS、および Windows の curl 更新
このアップデートオプションでは、curlを使用して、以前にインストールしたバージョン0.205以降のDatabricks CLIを最新バージョンに自動的にアップデートします。
Windows の場合、Databricks では Windows Subsystem for Linux (WSL) を使用することをお勧めします。 unzip
がインストールされている必要があります。インストール手順については、オペレーティングシステムのマニュアルを参照してください。 WSL を使用できない場合は、この手順をスキップし、代わりにコマンド プロンプトまたは PowerShell を使用して Databricks CLI をソースから更新 する必要があります。
-
macOSおよびLinuxの場合はパス
/usr/local/bin/databricks
、Windowsの場合はC:\Windows\databricks.exe
から、Databricks CLI実行可能ファイルの既存インストール分を削除します。 -
Linuxのシェルプロンプト、macOSのターミナル、またはWindowsのコマンドプロンプトから、次のコマンドを実行することで、
curl
を使ってDatabricks CLI実行可能ファイルの最新バージョンをダウンロードしてインストールします(-fsSL
では大文字と小文字を正しく指定する必要があります)。Bashcurl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
実行前にスクリプトの内容を確認するには、GitHubのDatabricks CLIセットアップロポジトリにあるinstall.shファイルを参照してください。
Windowsの場合、このコマンドは管理者として実行する必要があります。
LinuxおよびmacOSで、/usr/local/bin
が書き込み可能ではないというエラーメッセージが表示される場合は、 sudo
を使用してコマンドを再実行します。
このコマンドを使用すると、macOSおよびLinuxではパス/usr/local/bin/databricks
に、WindowsではC:\Windows\databricks.exe
にDatabricks CLI実行可能ファイルをダウンロードしてインストールできます。
以下のエラーが表示された場合は、先行するパスからDatabricks CLI 実行可能ファイルを手動で削除し、curl
コマンドを再実行する必要があります:“Target path <path>
already exists.”
3. Databricks CLIが正しくアップデートされていることを確認します。具体的には、ターミナルから、以下のように-v
オプションを使用するか、 version
コマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。
databricks -v
# Or:
databricks version
アップデート後のバージョン番号が表示されれば、Databricks CLIは正しくインストールされています。
Databricks CLIのバージョン一覧については、GitHubのDatabricks CLIリポジトリのリリースセクションを参照してください。リリースリストでは、最新リリースの横にLatest
ラベルが付いています。
databricks
を実行しても command not found: databricks
などのエラーが表示される場合、または databricks -v
を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。
Linux、macOS、および Windows のソース更新
このアップデートオプションでは、.zip
ファイルを手動でダウンロードし、ダウンロードした.zip
ファイルからDatabricks CLI実行可能ファイルを手動で取り出します。
- 必要に応じて、以前に手動でソースをインストールしたときのDatabricks CLI実行可能ファイル、
.zip
ファイル、および.zip
ファイルの抽出フォルダーを削除します。 - Linux、macOS、および Windows のソースインストールの手順に従って続行します。