Databricks CLI のインストールまたは更新
Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は Public Preview です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
この記事では、Databricks CLI をインストールまたは更新する方法について説明します。 「Databricks CLI とは」を参照してください。 Databricks CLI の認証を構成するには、「Databricks CLI の認証」を参照してください。
インストール
Databricks CLI バージョン 0.205 以降をインストールするには:
- Linux または macOS: Homebrew、curl、またはソースによるビルドを使用します。
- Windows: WinGet、Chocolatey、Linux 用 Windows サブシステム (WSL)、またはソース ビルドを使います。
Databricks CLI は、Azure Databricks ワークスペースのユーザー インターフェイス内からも使用できます。 「Databricks CLI コマンドを実行する」をご覧ください。
更新する
以前の Databricks CLI バージョン 0.205 以降のインストールを更新するには:
- Linux または macOS: Homebrew、curl、またはソースによるビルドを使用します。
- Windows: WinGet、Chocolatey、Linux 用 Windows サブシステム (WSL)、またはソース ビルドを使います。
Linux または macOS での Homebrew によるインストール
このインストール方法では、Homebrew を使用して、Databricks CLI 実行可能ファイルの最新リリースを自動的にダウンロードしてインストールします。
ターミナルから次の 2 つの Homebrew コマンドを実行するだけで CLI がインストールされます。
brew tap databricks/tap
brew install databricks
次に、Databricks CLI の認証に進みます。
Homebrew がインストールされているかどうかわからない場合、または前述の Homebrew コマンドが失敗した場合は、次の長い手順に従ってください。
Linux シェル プロンプトまたは macOS ターミナルから次のコマンドを実行して、Homebrew が既にインストールされているかどうかを確認します。 Homebrew がインストールされている場合は、Homebrew バージョン番号が表示されます。
brew -v
Homebrew がまだインストールされていない場合は、次のコマンドを実行してインストールします。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
そして、Homebrew のインストールを確認するために次のコマンドを実行します。これで、Homebrew バージョン番号が表示されます。
brew -v
次のコマンドを実行して、Homebrew を使用して GitHub の databricks/homebrew-tap リポジトリを使用可能な Homebrew Tap リポジトリの一覧に追加します。
brew tap databricks/tap
次のコマンドを実行して、Homebrew を使用して、Databricks CLI 実行可能ファイルをダウンロードしてインストールするように
databricks/homebrew-tap
リポジトリに指示します。brew install databricks
Databricks CLI が正しくインストールされているかどうかを確認します。 これを行うには、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
バージョン番号が 0.205.0 以上の場合は、Databricks CLI が正しくインストールされていることを意味します。
Note
databricks
を実行してもcommand not found: databricks
などの エラーが発生する場合、またはdatabricks -v
を実行するとバージョン番号 0.18 以下が表示される場合は、お使いのマシンで正しいバージョンの Databricks CLI 実行可能ファイルが見つからないことを意味します。 これを修正するには、「CLI のインストールを確認する」を参照してください。Databricks CLI の認証に進みます。
Windows 用 WinGet のインストール
このインストール オプションでは、winget を使って、Databricks CLI 実行可能ファイルの最新リリースを自動的にダウンロードしてインストールします。
コマンド プロンプトから、次の 2 つの
winget
コマンドを実行して CLI をインストールしてから、コマンド プロンプトを再起動します。winget search databricks winget install Databricks.DatabricksCLI
Databricks CLI が正しくインストールされているかどうかを確認します。 これを行うには、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
バージョン番号が 0.205.0 以上の場合は、Databricks CLI が正しくインストールされていることを意味します。
Note
databricks
を実行してもcommand not found: databricks
などの エラーが発生する場合、またはdatabricks -v
を実行するとバージョン番号 0.18 以下が表示される場合は、お使いのマシンで正しいバージョンの Databricks CLI 実行可能ファイルが見つからないことを意味します。 これを修正するには、「CLI のインストールを確認する」を参照してください。Databricks CLI の認証に進みます。
Windows 用 Chocolatey のインストール
Note
Chocolatey を使用した Databricks CLI のインストールは、試験段階です。
このインストール方法では、Chocolatey を使用して、Databricks CLI 実行可能ファイルの最新リリースを自動的にダウンロードしてインストールします。
コマンド プロンプトから、次の
choco
コマンドを実行して CLI をインストールします。choco install databricks-cli
Databricks CLI が正しくインストールされているかどうかを確認します。 これを行うには、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
バージョン番号が 0.205.0 以上の場合は、Databricks CLI が正しくインストールされていることを意味します。
Note
databricks
を実行してもcommand not found: databricks
などの エラーが発生する場合、またはdatabricks -v
を実行するとバージョン番号 0.18 以下が表示される場合は、お使いのマシンで正しいバージョンの Databricks CLI 実行可能ファイルが見つからないことを意味します。 これを修正するには、「CLI のインストールを確認する」を参照してください。Databricks CLI の認証に進みます。
Linux、macOS、および Windows での curl によるインストール
このインストール方法では、curl を使用して、Databricks CLI 実行可能ファイルの最新リリースをダウンロードしてインストールします。
Windows の場合、Databricks では Linux 用 Windows サブシステム (WSL) を使うことが推奨されています。 unzip
もインストールする必要があります。 インストール手順については、お使いのオペレーティング システムのドキュメントをご覧ください。 WSL を使えない場合は、この手順をスキップし、コマンド プロンプトまたは PowerShell を使って、代わりにソースから Databricks CLI をインストールします。
curl
をインストールする必要があります。curl
が既にインストールされているかどうかは、Linux シェル プロンプト、macOS ターミナル、または WSL 上の Bash から次のコマンドを実行して確認できます。curl
がインストールされている場合は、curl
バージョン番号が表示されます。curl -V
curl
がインストールされていない場合は、curl
の「Releases and Downloads」ページのお使いのオペレーティング システムとアーキテクチャ向け手順に従ってインストールします。 コンピューターのアーキテクチャを取得するには、オペレーティング システムのドキュメントを参照してください。その後、次のコマンドを実行して
curl
のインストールを検証します。これにより、curl
のバージョン番号が表示されます。curl -V
curl
を使って次のコマンドを実行し、Databricks CLI の実行可能ファイルをダウンロードしてインストールします (すべてのオペレーティング システムで、-fsSL
の大文字と小文字を正しく指定する必要があることに注意してください)。curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
Note
実行前にスクリプトの内容を確認するには、GitHub の Databricks CLI Setup リポジトリの install.sh ファイルを参照してください。
Windows では、管理者としてこのコマンドを実行する必要があります。
Linux および macOS の場合、
/usr/local/bin
が書き込み可能でないというエラー メッセージが表示された場合は、sudo
を使用してコマンドをもう一度実行します。このコマンドは、macOS と Linux の
/usr/local/bin/databricks
および Windows のC:\Windows\databricks.exe
のパスにある Databricks CLI 実行可能ファイルをダウンロードしてインストールします。何らかの理由で Databricks CLI が既にインストールされている場合は、"ターゲット パス
<path>
は既に存在します" というエラーが表示されます。 これを修正するには、上記のパスから Databricks CLI 実行可能ファイルを手動で削除してから、curl
コマンドをもう一度実行する必要があります。Databricks CLI が正しくインストールされているかどうかを確認します。 これを行うには、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
バージョン番号が 0.205.0 以上の場合は、Databricks CLI が正しくインストールされていることを意味します。
Note
databricks
を実行してもcommand not found: databricks
などの エラーが発生する場合、またはdatabricks -v
を実行するとバージョン番号 0.18 以下が表示される場合は、お使いのマシンで正しいバージョンの Databricks CLI 実行可能ファイルが見つからないことを意味します。 これを修正するには、「CLI のインストールを確認する」を参照してください。Databricks CLI の認証に進みます。
Linux、macOS、および Windows でのソースによるインストール
このインストール方法では、.zip
ファイルを手動でダウンロードし、ダウンロードした .zip
ファイルから Databricks CLI 実行可能ファイルを手動で展開します。
GitHub の Databricks CLI リポジトリの Releases セクションに記載されているように、最新の Databricks CLI
.zip
ファイルをローカル開発マシンにダウンロードします。 最新のリリースには、リリース一覧で、横にLatest
ラベルがあります。 最新のプレリリースにはPre-release
ラベルがあり、実験や早期導入者に適しています。 リリースのAssets
セクションからダウンロードする.zip
ファイルは、開発用コンピューターのオペレーティング システムとアーキテクチャと一致している必要があります。Filename アーキテクチャ 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、Intel 32 ビット / x86
databricks_cli_X.Y.Z_windows_amd64.zip
Windows、Intel 64 ビット / AMD64
databricks_cli_X.Y.Z_windows_arm64.zip
Windows、ARM 64 ビット / ARM64
コンピューターのアーキテクチャを取得するには、オペレーティング システムのドキュメントを参照してください。 次に例を示します。
- 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
という名前のチェックサム ファイルを提供します。 チェックサム検証を実行するには、オペレーティング システムのドキュメントを参照してください。- Linux: ターミナル コマンド
ダウンロードした
.zip
ファイルのコンテンツを展開します。.zip
ファイルを展開するには、オペレーティング システムのドキュメントを参照してください。展開したコンテンツには、
.zip
ファイルと同じ名前のフォルダーが表示されます。 このフォルダー内に Databricks CLI 実行可能ファイルがあります。 Databricks CLI 実行可能ファイルはそのままにすることも、別の場所にコピーまたは移動することもできます。Databricks CLI が正しくインストールされているかどうかを確認します。 これを行うには、Linux シェル プロンプト、macOS ターミナル、または Windows コマンド プロンプトで、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
バージョン番号が 0.205.0 以上の場合は、Databricks CLI が正しくインストールされていることを意味します。
Note
databricks
を実行してもcommand not found: databricks
などの エラーが発生する場合、またはdatabricks -v
を実行するとバージョン番号 0.18 以下が表示される場合は、お使いのマシンで正しいバージョンの Databricks CLI 実行可能ファイルが見つからないことを意味します。 これを修正するには、「CLI のインストールを確認する」を参照してください。macOS の場合、Databricks CLI を実行できるように最初にシステムを承認することが必要になる場合があります。 「開発元が未確認のMacアプリを開く」を参照してください。
Databricks CLI の認証に進みます。
Linux または macOS での Homebrew による更新
この更新方法では、Homebrew を使用し、以前の Databricks CLI バージョン 0.205 以降のインストールを自動的に最新バージョンに更新します。
Linux シェル プロンプトまたは macOS ターミナルから、次のコマンドを実行し、Homebrew を使用して最新バージョンの Databricks CLI 実行可能ファイルをダウンロードして更新します。
brew upgrade databricks
Databricks CLI が正しく更新されているかどうかを確認します。 これを行うには、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
予想される更新バージョン番号が表示された場合は、Databricks CLI が正しくインストールされます。
Databricks CLI バージョンの一覧については、GitHub の Databricks CLI リポジトリの Releases セクションを参照してください。 最新のリリースには、リリース一覧で、横に
Latest
ラベルがあります。Note
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 実行可能ファイルをダウンロードして更新します。winget upgrade Databricks.DatabricksCLI
Databricks CLI が正しくインストールされているかどうかを確認します。 これを行うには、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
予想される更新バージョン番号が表示された場合は、Databricks CLI が正しくインストールされます。
Databricks CLI バージョンの一覧については、GitHub の Databricks CLI リポジトリの Releases セクションを参照してください。 最新のリリースには、リリース一覧で、横に
Latest
ラベルがあります。Note
databricks
を実行してもcommand not found: databricks
などの エラーが発生する場合、またはdatabricks -v
を実行するとバージョン番号 0.18 以下が表示される場合は、お使いのマシンで正しいバージョンの Databricks CLI 実行可能ファイルが見つからないことを意味します。 これを修正するには、「CLI のインストールを確認する」を参照してください。
Windows 用 Chocolatey の更新プログラム
Note
Chocolatey を使用した Databricks CLI の更新は、試験段階です。
この更新オプションでは、Chocolatey を使用して、以前のバージョンの Databricks CLI バージョン 0.205 以降を最新バージョンに自動的にダウンロードして更新します。
コマンド プロンプトから、
choco
を使用して、次のコマンドを実行して、最新バージョンの Databricks CLI 実行可能ファイルをダウンロードして更新します。choco upgrade databricks-cli
Databricks CLI が正しくインストールされているかどうかを確認します。 これを行うには、
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
予想される更新バージョン番号が表示された場合は、Databricks CLI が正しくインストールされます。
Databricks CLI バージョンの一覧については、GitHub の Databricks CLI リポジトリの Releases セクションを参照してください。 最新のリリースには、リリース一覧で、横に
Latest
ラベルがあります。Note
databricks
を実行してもcommand not found: databricks
などの エラーが発生する場合、またはdatabricks -v
を実行するとバージョン番号 0.18 以下が表示される場合は、お使いのマシンで正しいバージョンの Databricks CLI 実行可能ファイルが見つからないことを意味します。 これを修正するには、「CLI のインストールを確認する」を参照してください。
Linux、macOS、および Windows での curl による更新
この更新方法では、curl を使用し、最新バージョンをダウンロードして、以前の Databricks CLI バージョン 0.205 以降のインストールを自動的に更新します。
Windows の場合、Databricks では Linux 用 Windows サブシステム (WSL) を使うことが推奨されています。 unzip
がインストールされている必要があります。 インストール手順については、お使いのオペレーティング システムのドキュメントをご覧ください。 WSL を使えない場合は、この手順をスキップし、コマンド プロンプトまたは PowerShell を使って、代わりにソースから Databricks CLI を更新する必要があります。
Databricks CLI 実行可能ファイルの既存のインストールを、macOS と Linux の
/usr/local/bin/databricks
または Windows のC:\Windows\databricks.exe
のパスから削除します。Linux シェル プロンプト、macOS ターミナル、または Windows コマンド プロンプトから次のコマンドを実行し、
curl
を使用して Databricks CLI 実行可能ファイルの最新バージョンをダウンロードしてインストールします (-fsSL
は大文字と小文字を正しく指定する必要があることに注意してください)。curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
Note
実行前にスクリプトの内容を確認するには、GitHub の Databricks CLI Setup リポジトリの 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
コマンドを再度実行する必要があります: "ターゲット パス<path>
は既に存在します"Databricks CLI が正しく更新されているかどうかを確認します。 これを行うには、ターミナルから
-v
オプションを使用するかversion
コマンドを実行して、Databricks CLI 実行可能ファイルのバージョンを表示します。databricks -v # Or: databricks version
予想される更新バージョン番号が表示された場合は、Databricks CLI が正しくインストールされます。
Databricks CLI バージョンの一覧については、GitHub の Databricks CLI リポジトリの Releases セクションを参照してください。 最新のリリースには、リリース一覧で、横に
Latest
ラベルがあります。Note
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 でのソースによるインストール」の手順にしたがいます。