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

Databricks CLI をインストールまたは更新する

注記

この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。

Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。

この記事では、Databricks CLI をインストールまたは更新する方法について説明します。 「Databricks CLI とは」を参照してください。Databricks CLI の認証を構成するには、「 Databricks CLI の認証」を参照してください。

インストールします

Databricks CLIバージョン0.205以降をインストールするには:

Databricks CLI は、Databricks ワークスペースのユーザー インターフェイス内からも使用できます。 「Databricks CLI コマンドの実行」を参照してください。

更新します

以前にインストールしたバージョン0.205以降のDatabricks CLIをアップデートするには:

LinuxまたはMacOS用の自作インストール

このインストールオプションでは、Homebrewを使用して、Databricks CLIの最新の実行可能リリースを自動的にダウンロードしてインストールします。

ターミナルから次の2つのHomebrewコマンドを実行して、CLIをインストールします。

Bash
brew tap databricks/tap
brew install databricks

次に 、Databricks CLI の認証に進みます。

Homebrewがインストールされているかどうかわからない場合、または前述のHomebrewコマンドが機能しない場合は、以下の手順に従ってください。

  1. LinuxシェルプロンプトまたはmacOSターミナルから次のコマンドを実行して、Homebrewがすでにインストールされているかどうかを確認します。Homebrewがインストールされている場合は、Homebrewのバージョン番号が表示されます。

    Bash
    brew -v
  2. Homebrewがまだインストールされていない場合は、以下のコマンドを実行してインストールします。

    Bash
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    続いて、次のコマンドを実行するとHomebrewのバージョン番号が表示されるため、Homebrewがインストールされていることを確認できます。

    Bash
    brew -v
  3. 次のコマンドを実行することで、Homebrewを使って、GitHubのdatabricks/homebrew-tapリポジトリを、利用可能なHomebrew Tapリポジトリの一覧に追加します。

    Bash
    brew tap databricks/tap
  4. 次のコマンドを実行することで、Homebrewを使って、Databricks CLI実行可能ファイルをダウンロードしてインストールするようdatabricks/homebrew-tapリポジトリに指示します。

    Bash
    brew install databricks
  5. Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように-vオプションを使用するか、 versionコマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。

    Bash
    databricks -v

    # Or:
    databricks version

    バージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。

注記

databricksを実行しても command not found: databricksなどのエラーが表示される場合、または databricks -v を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。

  1. 「Databricks CLI の認証」に進みます。

Windows用のWinGetインストール

このインストールオプションでは、wingetを使用して、Databricks CLIの最新の実行可能リリースを自動的にダウンロードしてインストールします。

  1. コマンドプロンプトから次の2つのwingetコマンドを実行してCLIをインストールし、次のコマンドプロンプトを再起動させます。

    Bash
    winget search databricks
    winget install Databricks.DatabricksCLI
  2. Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように-vオプションを使用するか、 versionコマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。

    Bash
    databricks -v

    # Or:
    databricks version

    バージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。

注記

databricksを実行しても command not found: databricksなどのエラーが表示される場合、または databricks -v を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。

  1. 「Databricks CLI の認証」に進みます。

Windows用のChocolateyのインストール

注記

Chocolatey を使用した Databricks CLI のインストールは 試験段階です

このインストールオプションでは、Chocolateyを使用して、最新のDatabricks CLI実行リリースを自動的にダウンロードしてインストールします。

  1. コマンドプロンプトから以下のchocoコマンドを実行してCLIをインストールします。

    Bash
    choco install databricks-cli
  2. Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように-vオプションを使用するか、 versionコマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。

    Bash
    databricks -v

    # Or:
    databricks version

    バージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。

注記

databricksを実行しても command not found: databricksなどのエラーが表示される場合、または databricks -v を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。

  1. 「Databricks CLI の認証」に進みます。

Linux、macOS、およびWindows用のcurlインストール

このインストールオプションでは、curlを使用して、最新のDatabricks CLI実行リリースをダウンロードしてインストールします。

Windows の場合、Databricks では Windows Subsystem for Linux (WSL) を使用することをお勧めします。 また、 unzip がインストールされている必要があります。 インストール手順については、オペレーティングシステムのマニュアルを参照してください。 WSL を使用できない場合は、この手順をスキップし、代わりにコマンド プロンプトまたは PowerShell を使用して ソースから Databricks CLI をインストールします

  1. curl をインストールする必要があります。Linuxシェルプロンプト、macOSターミナル、またはWSLのBashから次のコマンドを実行すると、 curlがすでにインストールされているかどうかを確認できます。curlがインストールされている場合は、以下のようにcurlのバージョン番号が表示されます。

    Bash
    curl -V
  2. curlがまだインストールされていない場合は、お使いのOSとアーキテクチャのcurlのリリースおよびダウンロードページの指示に従って、インストールします。マシンのアーキテクチャの取得方法については、お使いのOSのマニュアルを参照してください。

    続いて、次のコマンドを実行するとcurl のバージョン番号が表示されるため、curl がインストールされていることを確認できます。

    Bash
    curl -V
  3. curl を使用して次のコマンドを実行し、Databricks CLIの実行可能ファイルをダウンロードしてインストールします(すべてのOSで、-fsSL には、大文字と小文字を含め正しく記述する必要があります)。

    Bash
    curl -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実行可能ファイルのバージョンを表示させます。

Bash
databricks -v

# Or:
databricks version

バージョン番号が0.205.0以上であれば、Databricks CLIは正しくインストールされいます。

注記

databricksを実行しても command not found: databricksなどのエラーが表示される場合、または databricks -v を実行してバージョン番号 0.18 以下がリストされている場合は、マシンで Databricks CLI 実行可能ファイルの正しいバージョンが見つからないことを意味します。これを修正するには、 CLI インストールの確認を参照してください。

  1. 「Databricks CLI の認証」に進みます。

Linux、macOS、および Windows のソースインストール

このインストールオプションでは、.zipファイルを手動でダウンロードし、ダウンロードした.zipファイルからDatabricks CLI実行可能ファイルを手動で取り出します。

  1. 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 -mlscpu 、またはsudo lshw -c cpu
    • macOS: Apple のアイコンメニュー > このMacについて 、または「ターミナル」コマンドuname -m
    • Windows:コマンドプロンプトまたはPowerShellコマンドecho %PROCESSOR_ARCHITECTURE%

    これらの.zipファイルのいずれかで整合性を検証する必要がある場合、Databricksでは、.zipファイルと同じリストにdatabricks_cli_X.Y.Z_SHA256SUMSという名前のチェックサムファイルを提供します。チェックサム検証の実行方法については、お使いのOSのマニュアルを参照してください。

  2. ダウンロードした.zipファイルからコンテンツを取り出します。.zipファイルからの抽出方法については、お使いのOSのマニュアルを参照してください。

  3. 取り出したコンテンツには、.zipファイルと同じ名前のフォルダーがあります。このフォルダーに、Databricks CLI実行可能ファイルが入っています。このDatabricks CLI実行可能ファイルをそのままにしておいても、別の場所にコピーまたは移動しても構いません。

  4. Databricks CLIが正しくインストールされていることを確認します。具体的には、Linuxのシェルプロンプト、macOSのターミナル、またはWindowsのコマンドプロンプトから、以下のように-vオプションを使用するか、 versionコマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。

    Bash
    databricks -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アプリを開く」を参照してください。

  1. 「Databricks CLI の認証」に進みます。

LinuxまたはmacOS用の自作アップデート

このアップデートオプションでは、Homebrewを使用して、以前にインストールしたバージョン0.205以降のDatabricks CLIを最新バージョンに自動的にアップデートします。

  1. LinuxのシェルプロンプトまたはmacOSのターミナルから、次のコマンドを実行することで、Homebrewを使って、Databricks CLI 実行可能ファイルの最新バージョンをダウンロードしてアップデートします。

    Bash
    brew upgrade databricks
  2. Databricks CLIが正しくアップデートされていることを確認します。具体的には、以下のように-vオプションを使用するか、 versionコマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。

    Bash
    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 インストールの確認を参照してください。

ヒント

Databricks CLIのバージョンをダウングレードするには、GitHubのdatabricks/homebrew-tapリポジトリにある指示を参照してください。

Windows の WinGet 更新プログラム

このアップデートオプションでは、wingetを使用して、Databricks CLIのバージョン0.205以降の旧バージョンを自動的にダウンロードして最新バージョンにアップデートします。

  1. コマンドプロンプトからwingetを使用して以下のコマンドを実行し、最新バージョンのDatabricks CLI実行ファイルをダウンロードしてアップデートします。

    Bash
    winget upgrade Databricks.DatabricksCLI
  2. Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように-vオプションを使用するか、 versionコマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。

    Bash
    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 インストールの確認を参照してください。

Windows用のChocolateyアップデート

注記

Chocolatey を使用した Databricks CLI の更新は 試験段階です

このアップデートオプションでは、Chocolateyを使用して、Databricks CLIのバージョン0.205以降の旧バージョンを自動的にダウンロードして最新バージョンにアップデートします。

  1. コマンドプロンプトからchocoを使用して以下のコマンドを実行し、最新バージョンのDatabricks CLI実行ファイルをダウンロードしてアップデートします。

    Bash
    choco upgrade databricks-cli
  2. Databricks CLIが正しくインストールされていることを確認します。具体的には、以下のように-vオプションを使用するか、 versionコマンドを実行して、Databricks CLI実行可能ファイルのバージョンを表示させます。

    Bash
    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 の curl 更新

このアップデートオプションでは、curlを使用して、以前にインストールしたバージョン0.205以降のDatabricks CLIを最新バージョンに自動的にアップデートします。

Windows の場合、Databricks では Windows Subsystem for Linux (WSL) を使用することをお勧めします。 unzipがインストールされている必要があります。インストール手順については、オペレーティングシステムのマニュアルを参照してください。 WSL を使用できない場合は、この手順をスキップし、代わりにコマンド プロンプトまたは PowerShell を使用して Databricks CLI をソースから更新 する必要があります。

  1. macOSおよびLinuxの場合はパス/usr/local/bin/databricks 、Windowsの場合はC:\Windows\databricks.exeから、Databricks CLI実行可能ファイルの既存インストール分を削除します。

  2. Linuxのシェルプロンプト、macOSのターミナル、またはWindowsのコマンドプロンプトから、次のコマンドを実行することで、curlを使ってDatabricks CLI実行可能ファイルの最新バージョンをダウンロードしてインストールします( -fsSLでは大文字と小文字を正しく指定する必要があります)。

    Bash
    curl -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実行可能ファイルのバージョンを表示させます。

Bash
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実行可能ファイルを手動で取り出します。

  1. 必要に応じて、以前に手動でソースをインストールしたときのDatabricks CLI実行可能ファイル、.zipファイル、および.zipファイルの抽出フォルダーを削除します。
  2. Linux、macOS、および Windows のソースインストールの手順に従って続行します。