Databricks CLI の構成プロファイル
Note
この情報は、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 構成プロファイルが使用されます。
ヒント
--profile 後に Tab を押すか、-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 のバージョンを一覧表示します。
Note
このコマンドは、DEFAULT プロファイルの設定よりも優先される環境変数が設定されていないことを前提としています。 詳細については、「認証の評価順序」を参照してください。
databricks clusters spark-versions
特定の構成プロファイルを確認するには、-p フラグを使用してプロファイル名を指定します。
databricks clusters spark-versions -p PROD