Databricks構成プロファイル

Databricks 構成プロファイル ( 構成プロファイル、 構成プロファイル、または単に profileと呼ばれることもあります) には、Databricks が認証するために必要な設定とその他の情報が含まれています。 Databricks 構成プロファイルは、ツール、SDK、スクリプト、およびアプリで使用する Databricks 構成プロファイル ファイル (.databrickscfg) に格納されます。 Databricks 構成プロファイルがツール、SDK、スクリプト、アプリでサポートされているかどうかを確認するには、プロバイダーのドキュメントを参照してください。 Databricks クライアント統合認証を実装するすべての参加ツールと SDK は、Databricks 構成プロファイルをサポートします。

Databricks 構成プロファイル ファイルを作成する

  1. お気に入りのテキストエディタを使用して、Unix、Linux、またはmacOSの場合は~（ユーザーホーム）フォルダに、Windowsの場合は%USERPROFILE%（ユーザーホーム）フォルダに.databrickscfgという名前のファイルを作成します。（未作成の場合）ファイル名の先頭にあるドット（.）を付け忘れないよう気をつけてください。このファイルに、次の内容を追加してください。

    [<some-unique-name-for-this-configuration-profile>]
<field-name> = <field-value>

  2. 上記の内容で以下の値を置き換え、ファイルを保存します。

    • <some-unique-name-for-this-configuration-profile> を、構成プロファイルの一意の名前（DEFAULT、DEVELOPMENT、PRODUCTIONなど）に置き換えます。同じ.databrickscfgファイル内に複数の構成プロファイルを含めることができますが、各構成プロファイルはこのファイル内で一意の名前を持たなければなりません。

    • <field-name> と<field-value>を、ターゲットとなるDatabricks認証タイプの必須フィールドの名前と値に置き換えます。提供する具体的な情報については、この記事の前半でその認証タイプに関するセクションを参照してください。

    • ターゲットとなるDatabricks認証タイプの追加の必須フィールドごとに、<field-name>と<field-value>のペアを追加します。

たとえば、Databricks個人用アクセストークン認証の場合、.databrickscfgファイルは以下のようになります。

[DEFAULT]
host  = https://dbc-a1b2345c-d6e7.cloud.databricks.com
token = dapi123...

追加の構成プロファイルを作成するには、同じ.databrickscfgファイル内で異なるプロファイル名を指定します。たとえば、それぞれに独自のDatabricks個人用アクセストークンを持つ個別のDatabricksワークスペースを指定する場合は、以下のようになります。

[DEFAULT]
host  = https://dbc-a1b2345c-d6e7.cloud.databricks.com
token = dapi123...

[DEVELOPMENT]
host  = https://dbc-b2c3456d-e7f8.cloud.databricks.com
token = dapi234...

Databricksアカウントおよび異なるDatabricks認証タイプに対して、.databrickscfgファイル内で異なるプロファイル名を指定することもできます。以下に例を示します。

[DEFAULT]
host  = https://dbc-a1b2345c-d6e7.cloud.databricks.com
token = dapi123...

[ACCOUNT]
host                       = https://accounts.cloud.databricks.com
databricks_client_id       = fa0cd1...
databricks_client_secret   = aBC1D~...
account_id                 = ab0cd1...