Databricks CLI のインストールまたは更新

  • [アーティクル]

Note

この情報は、パブリック プレビュー段階である Databricks CLI バージョン 0.205 以降に当てはまる内容です。 お使いの Databricks CLI のバージョンを確認するには、databricks -v を実行してください。

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

インストール

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

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

更新する

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

Linux または macOS での Homebrew によるインストール

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

ターミナルから次の 2 つの Homebrew コマンドを実行するだけで CLI がインストールされます。

brew tap databricks/tap
brew install databricks

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

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

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

    brew -v

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

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

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

    brew -v

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

    brew tap databricks/tap

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

    brew install databricks

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

  6. Databricks CLI の認証に進みます。

Windows 用 WinGet のインストール

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

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

    winget search databricks
winget install Databricks.DatabricksCLI

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

  3. Databricks CLI の認証に進みます。

Windows 用 Chocolatey のインストール

Note

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

このインストール方法では、Chocolatey を使用して、Databricks CLI 実行可能ファイルの最新リリースを自動的にダウンロードしてインストールします。

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

    choco install databricks-cli

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

  3. Databricks CLI の認証に進みます。

Linux、macOS、および Windows での curl によるインストール

このインストール方法では、curl を使用して、Databricks CLI 実行可能ファイルの最新リリースをダウンロードしてインストールします。

Windows の場合、Databricks では Linux 用 Windows サブシステム (WSL) を使うことが推奨されています。 unzip もインストールする必要があります。 インストール手順については、お使いのオペレーティング システムのドキュメントをご覧ください。 WSL を使えない場合は、この手順をスキップし、コマンド プロンプトまたは PowerShell を使って、代わりにソースから Databricks CLI をインストールします。

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

    curl -V

  2. curl がインストールされていない場合は、curl の「Releases and Downloads」ページのお使いのオペレーティング システムとアーキテクチャ向け手順に従ってインストールします。 コンピューターのアーキテクチャを取得するには、オペレーティング システムのドキュメントを参照してください。

    その後、次のコマンドを実行して curl のインストールを検証します。これにより、curl のバージョン番号が表示されます。

    curl -V

  3. 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 コマンドをもう一度実行する必要があります。

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

  5. Databricks CLI の認証に進みます。

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

このインストール方法では、.zip ファイルを手動でダウンロードし、ダウンロードした .zip ファイルから Databricks CLI 実行可能ファイルを手動で展開します。

  1. 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 という名前のチェックサム ファイルを提供します。 チェックサム検証を実行するには、オペレーティング システムのドキュメントを参照してください。

  2. ダウンロードした .zip ファイルのコンテンツを展開します。 .zip ファイルを展開するには、オペレーティング システムのドキュメントを参照してください。

  3. 展開したコンテンツには、.zip ファイルと同じ名前のフォルダーが表示されます。 このフォルダー内に Databricks CLI 実行可能ファイルがあります。 Databricks CLI 実行可能ファイルはそのままにすることも、別の場所にコピーまたは移動することもできます。

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

  5. Databricks CLI の認証に進みます。

Linux または macOS での Homebrew による更新

この更新方法では、Homebrew を使用し、以前の Databricks CLI バージョン 0.205 以降のインストールを自動的に最新バージョンに更新します。

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

    brew upgrade databricks

  2. 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 用の WinGet 更新プログラム

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

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

    winget upgrade Databricks.DatabricksCLI

  2. 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 以降を最新バージョンに自動的にダウンロードして更新します。

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

    choco upgrade databricks-cli

  2. 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 を更新する必要があります。

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

  2. 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> は既に存在します"

  3. 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 実行可能ファイルを手動で展開します。

  1. 必要に応じて、前述のソースによる手動インストール手順の、Databricks CLI 実行可能ファイル、.zip ファイル、および .zip ファイルの展開フォルダーを削除します。
  2. 続けて、「Linux、macOS、および Windows でのソースによるインストール」の手順にしたがいます。

Azure Databricks ワークスペース内から Databricks CLI を実行する

Databricks CLI には、実行中のクラスターに接続されているノートブック内の Web ターミナルから、または実行中のクラスターの Web ターミナルから直接アクセスできます。 使用可能な CLI は常に最新バージョンであり、認証は現在のユーザーに基づいています。 そのクラスターは次の要件を満たしている必要があります。

  • クラスターに Databricks Runtime 15.0 LTS 以降がインストールされている必要があります。
  • クラスターは、シングル ユーザーまたは分離共有のクラスター アクセス モードを使用する必要があります。 共有クラスター アクセス モードはサポートされていません。
  • サーバーレス コンピューティングはサポートされていません。
  • ワークスペースを Private Link に対して有効にすることはできません。

ノートブックの Web ターミナルから CLI にアクセスするには、次の操作を行います。

  1. 上記の要件を満たすクラスターにノートブックを接続します。

  2. ノートブックの右サイドバーの一番下にある [下部パネルを開く] アイコンをクリックしますノートブックで下部パネルを開く。

  3. 表示される [ターミナル] ウィンドウで CLI を使用します。 たとえば、次のコマンドは、現在のユーザーに関する情報を出力します。

    databricks current-user me

クラスターの Web ターミナルから CLI にアクセスするには、次の操作を行います。

  1. ワークスペースのサイドバーで [コンピューティング] をクリックします。

  2. [汎用コンピューティング] タブで、上記の要件を満たすクラスターの名前をクリックします。

  3. [開始] をクリックします。

  4. クラスターが起動したら、[アプリ] タブで [Web ターミナル] をクリックします。

  5. 表示される Databricks Web ターミナルで CLI を使用します。 たとえば、次のコマンドは、現在のユーザーに関する情報を出力します。

    databricks current-user me