次の方法で共有

Databricks CLI の構成プロファイル

注

この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は Public Preview です。

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

この記事では、構成プロファイルで Databricks CLI を使用する方法について説明します。 Databricks CLI を既にインストールし、Databricks 構成プロファイル ファイルを作成済みであることを前提としています。 Databricks CLI のインストールまたは更新と Azure Databricks 構成プロファイルの に関するページを参照してください。

構成プロファイルに関する情報を取得する

.databrickscfg ファイルに複数の構成プロファイルを追加すると、コマンドの--profileまたは-p フラグでターゲット構成プロファイルの名前を指定することで、さまざまなワークスペース間でコマンドをすばやく実行できます。 指定しない場合は、DEFAULT 構成プロファイルが使用されます。

ヒント

Tab 後に --profile を押すか、-p を押して、選択する既存の使用可能な構成プロファイルの一覧を表示できます。

たとえば、開発ワークロードに使用する Azure Databricks ワークスペースを参照する、DEV という名前の構成プロファイルと、運用ワークロードに使用する別の Azure Databricks ワークスペースを参照する、PROD という名前の別の構成プロファイルを作成できます。

既定では、Databricks CLI は、Unix、Linux、macOS の .databrickscfg (ユーザー ホーム) フォルダー、または Windows の ~ (ユーザー ホーム) フォルダーで %USERPROFILE% ファイルを検索します。 .databrickscfg ファイルの既定のパスを変更するには、環境変数 DATABRICKS_CONFIG_FILE を別のパスに設定します。 .databrickscfg 固有のフィールドを参照してください。

既存の構成プロファイルに関する情報を取得するには、auth env コマンドを実行します。

databricks auth env --profile <configuration-profile-name>

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

例として、Azure Databricks 個人用アクセス トークン認証で構成されたプロファイルの出力は次のとおりです。

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

使用可能なすべてのプロファイルに関する情報を取得するには、auth profiles コマンドを実行します。

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

auth profiles コマンドの出力には、アクセス トークンは表示されません。 アクセス トークンを表示するには、前述の auth env コマンドを実行します。

重要

Databricks CLI は、.netrc ファイルでは動作しません。 .netrc ファイルを他の目的でご利用の環境に含めることができますが、Databricks CLI ではその .netrc ファイルは使用されません。

構成プロファイルをテストする

構成プロファイルをテストし、認証が正しく設定されていることを確認するには、ワークスペースに接続するコマンドを実行します。

プロファイルを指定しない場合は、既定のプロファイルが使用されます。 たとえば、次のコマンドは、DEFAULT プロファイルに関連付けられている Azure Databricks ワークスペースで使用可能な Databricks Runtime のバージョンを一覧表示します。

注

このコマンドは、DEFAULT プロファイルの設定よりも優先される環境変数が設定されていないことを前提としています。 詳細については、「認証の評価順序」を参照してください。

databricks clusters spark-versions

特定の構成プロファイルを確認するには、-p フラグを使用してプロファイル名を指定します。

databricks clusters spark-versions -p PROD
  • Last updated on