Azure Databricks 構成プロファイル (構成プロファイル、構成プロファイル、または単に profile
とも呼ばれます) には、Azure Databricks が認証するために必要な設定とその他の情報が含まれています。 Azure Databricks 構成プロファイルは、Azure Databricks 構成プロファイルファイル (.databrickscfg
) に格納されており、使用するツール、SDK、スクリプト、アプリが利用できます。 Azure Databricks 構成プロファイルがツール、SDK、スクリプト、アプリでサポートされているかどうかを確認するには、プロバイダーのドキュメントを参照してください。
Databricks クライアント統合認証 を実装するすべての参加ツールと SDK は、Azure Databricks 構成プロファイルをサポートします。
Azure Databricks 構成プロファイル ファイルを作成する
Azure Databricks 構成プロファイル ファイルを作成するには、Databricks CLIdatabricks configure
コマンドを実行するか、次の手順に従います。
お気に入りのテキスト エディターを使用して、Unix、Linux、または macOS の
.databrickscfg
(ユーザー ホーム) フォルダー、または Windows 上の~
(ユーザー ホーム) フォルダーに%USERPROFILE%
という名前のファイルを作成します (まだない場合)。 ファイル名の先頭にあるドット (.
) を忘れないでください。 このファイルに次の内容を追加します。[<some-unique-name-for-this-configuration-profile>] <field-name> = <field-value>
上記の内容で、次の値を置き換えてから、ファイルを保存します。
-
<some-unique-name-for-this-configuration-profile>
、DEFAULT
、DEVELOPMENT
など、構成プロファイルの一意の名前を持つPRODUCTION
。 同じ.databrickscfg
ファイルに複数の構成プロファイルを含めることができますが、各構成プロファイルには、このファイル内で一意の名前が必要です。 - ターゲット Databricks 認証タイプに必要なフィールドの名前と値を
<field-name>
と<field-value>
に設定します。 指定する具体的な情報については、この記事の前半の認証の種類に関するセクションを参照してください。 - ターゲット Databricks 認証の種類の追加の必須フィールドごとに、
<field-name>
と<field-value>
のペアを追加します。
-
たとえば、Azure Databricks の個人用アクセス トークン認証の場合、.databrickscfg
ファイルは次のようになります。
[DEFAULT]
host = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...
追加の構成プロファイルを作成するには、同じ .databrickscfg
ファイル内で異なるプロファイル名を指定します。 たとえば、個別の Azure Databricks ワークスペースを指定するには、それぞれ独自の Azure Databricks 個人用アクセス トークンを使用します。
[DEFAULT]
host = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...
[DEVELOPMENT]
host = https://adb-2345678901234567.8.azuredatabricks.net
token = dapi234...
また、Azure Databricks アカウントの .databrickscfg
ファイル内で異なるプロファイル名と、さまざまな Databricks 認証の種類を指定することもできます。次に例を示します。
[DEFAULT]
host = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...
[DEVELOPMENT]
azure_workspace_resource_id = /subscriptions/bc0cd1.../resourceGroups/my-resource-group/providers/Microsoft.Databricks/workspaces/my-workspace
azure_tenant_id = bc0cd1...
azure_client_id = fa0cd1...
azure_client_secret = aBC1D~...
ヒント
Databricks CLI を使用して、構成プロファイルをテストできます。 「構成プロファイルテストする」を参照してください。