Google クラウド ID 認証

Google クラウド ID 認証は、Google クラウド CLI を使用して、対象の Google クラウド サービス アカウントを認証します。

Google クラウド認証情報認証を使用する準備をするには、 「Google クラウド ID 認証の設定と使用」をご覧ください。

Databricksを使用して Google クラウド ID 認証を設定するには、Google クラウド ID 認証をローカルにインストールする必要があります。また、次の関連する環境変数 ( .databrickscfg フィールド、Terraform フィールド、または Config フィールド) も設定する必要があります。

• Databricksホスト

  • アカウント操作の場合は、https://accounts.gcp.databricks.com を指定します。

  • ワークスペース操作の場合は、 ワークスペースの URL を指定します (例: https://1234567890123456.7.gcp.databricks.com)。

• アカウント操作の場合、Databricks アカウント ID 。

• サービスアカウントのEメールアドレスとして指定されるGoogleクラウドサービスアカウント。

Databricks で Google クラウド ID 認証を実行するには、参加するツールまたは SDK に基づいて、コード内に以下を統合します。

ツールまたは SDK で特定の Databricks 認証の種類の環境変数を使用するには、「 Databricks リソースへのアクセスを認証 する」またはツールまたは SDK のドキュメントを参照してください。 クライアント統合認証の環境変数とフィールド、およびクライアント統合認証のデフォルト方式も参照してください。

アカウント レベルの操作の場合は、次の環境変数を設定します。

• DATABRICKS_HOST：DatabricksアカウントのコンソールURL https://accounts.gcp.databricks.com の値に設定します。

• DATABRICKS_ACCOUNT_ID

• GOOGLE_SERVICE_ACCOUNT

ワークスペース レベルの操作の場合は、次の環境変数を設定します。

• DATABRICKS_HOSTで、Databricks ワークスペースの URL の値 (例: https://1234567890123456.7.gcp.databricks.com) に設定します。

• GOOGLE_SERVICE_ACCOUNT

Databricks 構成プロファイル を作成または識別し、 .databrickscfg ファイルに次のフィールドを含めます。 プロファイルを作成する場合は、プレースホルダを適切な値に置き換えます。 ツールまたは SDK でプロファイルを使用するには、「 Databricks リソースへのアクセスを認証 する」またはツールまたは SDK のドキュメントを参照してください。 クライアント統合認証の環境変数とフィールド、およびクライアント統合認証のデフォルト方式も参照してください。

アカウント レベルの操作の場合は、 .databrickscfgファイルに次の値を設定します。 この場合、Databricks アカウント コンソールの URL はhttps://accounts.gcp.databricks.comです。

[<some-unique-configuration-profile-name>]
host                   = <account-console-url>
account_id             = <account-id>
google_service_account = <google-cloud-service-account-email-address>

ワークスペース レベルの操作の場合は、 .databrickscfgファイルに次の値を設定します。 この場合、ホストは Databricks ワークスペース URLです (例: https://1234567890123456.7.gcp.databricks.com )。

[<some-unique-configuration-profile-name>]
host                   = <workspace-url>
google_service_account = <google-cloud-service-account-email-address>

Databricks CLI の場合は、次のいずれかの操作を行います。

• この記事の「環境」セクションで指定されているように環境変数を設定します。

• この記事の「プロファイル」セクションで指定されているように、 .databrickscfg ファイルの値を設定します。

環境変数は、常に .databrickscfg ファイルの値よりも優先されます。

「Google クラウド ID 認証」も参照してください。

注：

Google クラウド ID 認証は、次の Databricks Connect バージョンでサポートされています。

• Python の場合、Databricks Runtime 13.3 LTS 以降用の Databricks Connect。 Databricks SDK for Python 0.14.0 以上もインストールする必要があります。

• Scala の場合、Databricks Connect for Databricks Runtime 13.3 LTS 以降。 Databricks SDK for Java 0.14.0 以降もインストールする必要があります。

Databricks Connect では、次のいずれかを実行できます。

• この記事の「プロファイル」セクションで指定されているように、Databricksワークスペース レベルの操作の値を.databrickscfgファイルに設定します。 また、プロファイル内のcluster_id環境変数をワークスペース インスタンス URL (例: https://1234567890123456.7.gcp.databricks.com ) に設定します。

• この記事の「環境」セクションで指定されているように、Databricksワークスペース レベルの操作の環境変数を設定します。 また、 DATABRICKS_CLUSTER_ID環境変数をワークスペース インスタンス URL (例: https://1234567890123456.7.gcp.databricks.com ) に設定します。

.databrickscfg ファイル内の値は、常に環境変数よりも優先されます。

.databrickscfg ファイル内のこれらの環境変数または値を使用して Databricks Connect クライアントを初期化するには、次のいずれかを参照してください。

• Python の場合は、「 Python の接続プロパティの構成」を参照してください。

• Scala については、「 Scala の接続プロパティの構成」を参照してください。

Visual Studio Code の Databricks 拡張機能の場合は、次の操作を行います。

1. この記事の「プロファイル」セクションで指定されているように、Databricksワークスペース レベルの操作の値を.databrickscfgファイルに設定します。

2. Visual Studio Code の Databricks 拡張機能の [ 構成 ] ウィンドウで、 [ Databricks の構成] をクリックします。

3. コマンド パレットの [Databricks Host] に、ワークスペースの URL (例: https://1234567890123456.7.gcp.databricks.com) を入力し、Enterを押します。

4. コマンド パレットで、URL の一覧からターゲット プロファイルの名前を選択します。

詳細については、「 Visual Studio Code の Databricks 拡張機能の認証設定」を参照してください。

アカウントレベルのオペレーションの場合、デフォルトの認証の場合:

provider "databricks" {
  alias = "accounts"
}

直接構成の場合（retrieve プレースホルダーを独自の実装に置き換えて、コンソールやHashiCorp Vaultなどの他の構成ストアから値を取得します。「Vaultのプロバイダー」も参照してください。）この場合、DatabricksアカウントのコンソールURLは https://accounts.gcp.databricks.com です。

provider "databricks" {
  alias                  = "accounts"
  host                   = <retrieve-account-console-url>
  account_id             = <retrieve-account-id>
  google_service_account = <retrieve-google-service-account>
}

ワークスペース レベルの操作の場合、デフォルト認証の場合:

provider "databricks" {
  alias = "workspace"
}

直接構成の場合 ( retrieve プレースホルダーを独自の実装に置き換えて、コンソールまたは他の構成ストア ( HashiCorp Vault など) から値を取得します。 「Vault プロバイダ」も参照してください)。この場合、ホストは Databricks ワークスペースの URL です (例: https://1234567890123456.7.gcp.databricks.com)。

provider "databricks" {
  alias                  = "workspace"
  host                   = <retrieve-workspace-url>
  google_service_account = <retrieve-google-service-account>
}

Databricks Terraform プロバイダーでの認証の詳細については、「 認証」を参照してください。

アカウントレベルのオペレーションでは、デフォルトの認証を使用します。

from databricks.sdk import AccountClient

a = AccountClient()
# ...

直接構成の場合は、 retrieve プレースホルダーを実装に置き換えて、コンソールまたは他の構成ストア ( Google クラウド Secret Manager など) から値を取得します。 この場合、Databricks アカウント コンソールの URL は https://accounts.gcp.databricks.comされます。

from databricks.sdk import AccountClient

a = AccountClient(
  host                   = retrieve_account_console_url(),
  account_id             = retrieve_account_id(),
  google_service_account = retrieve_google_service_account()
)
# ...

ワークスペース レベルの操作の場合、デフォルト認証の場合:

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()
# ...

直接構成の場合は、 retrieve プレースホルダーを実装に置き換えて、コンソールまたは他の構成ストア ( Google クラウド Secret Manager など) から値を取得します。 この場合、ホストは Databricks ワークスペースの URL です (例: https://1234567890123456.7.gcp.databricks.com)。

from databricks.sdk import WorkspaceClient

w = WorkspaceClient(
  host                   = retrieve_workspace_url(),
  google_service_account = retrieve_google_service_account()
)
# ...

Databricks'Python ツールと SDKDatabricks を使用して クライアント統合認証 を実装する方法の詳細については 以下を参照してください。

• Python 用の Databricks Connect クライアントを設定する

• Visual Studio Code 用 Databricks 拡張機能の認証設定

• Databricks アカウントまたはワークスペースで Databricks SDK for Python を認証する

アカウントレベルのオペレーションでは、デフォルトの認証を使用します。

import com.databricks.sdk.AccountClient;
// ...
AccountClient a = new AccountClient();
// ...

直接構成の場合は、 retrieve プレースホルダーを実装に置き換えて、コンソールまたは他の構成ストア ( Google クラウド Secret Manager など) から値を取得します。 この場合、Databricks アカウント コンソールの URL は https://accounts.gcp.databricks.comされます。

import com.databricks.sdk.AccountClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
  .setHost(retrieveAccountConsoleUrl())
  .setAccountId(retrieveAccountId())
  .setGoogleServiceAccount(retrieveGoogleServiceAccount());
AccountClient a = new AccountClient(cfg);
// ...

ワークスペース レベルの操作の場合は、デフォルト認証を使用します。

import com.databricks.sdk.WorkspaceClient;
// ...
WorkspaceClient w = new WorkspaceClient();
// ...

直接構成の場合は、 retrieve プレースホルダーを実装に置き換えて、コンソールまたは他の構成ストア ( Google クラウド Secret Manager など) から値を取得します。 この場合、ホストは Databricks ワークスペースの URL です (例: https://1234567890123456.7.gcp.databricks.com)。

import com.databricks.sdk.WorkspaceClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
  .setHost(retrieveWorkspaceUrl())
  .setGoogleServiceAccount(retrieveGoogleServiceAccount());
WorkspaceClient w = new WorkspaceClient(cfg);
// ...

Databricks'Java ツールと SDKDatabricks を使用して クライアント統合認証 を実装する方法の詳細については 以下を参照してください。

• Databricks Connect クライアントを Scala 用に設定

• Databricks アカウントまたはワークスペースで Databricks SDK for Java を認証する

アカウントレベルのオペレーションの場合、デフォルトの認証の場合:

import (
  "github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient())
// ...

直接構成の場合 ( retrieve プレースホルダーを独自の実装に置き換えて、コンソールまたは他の構成ストア ( Google クラウド Secret Manager など) から値を取得します)。 この場合、Databricks アカウント コンソールの URL は https://accounts.gcp.databricks.comされます。

import (
  "github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient(&databricks.Config{
  Host:                 retrieveAccountConsoleUrl(),
  AccountId:            retrieveAccountId(),
  GoogleServiceAccount: retrieveGoogleServiceAccount(),
}))
// ...

ワークスペース レベルの操作の場合、デフォルト認証の場合:

import (
  "github.com/databricks/databricks-sdk-go"
)
// ...
w := databricks.Must(databricks.NewWorkspaceClient())
// ...

直接構成の場合 ( retrieve プレースホルダーを独自の実装に置き換えて、コンソールまたは他の構成ストア ( Google クラウド Secret Manager など) から値を取得します)。 この場合、ホストは Databricks ワークスペースの URL です (例: https://1234567890123456.7.gcp.databricks.com)。

import (
  "github.com/databricks/databricks-sdk-go"
)
// ...
w := databricks.Must(databricks.NewWorkspaceClient(&databricks.Config{
  Host:                 retrieveWorkspaceUrl(),
  GoogleServiceAccount: retrieveGoogleServiceAccount(),
}))
// ...

Go を使用し、 クライアント統合認証 を実装するDatabricks ツールと SDKDatabricks を使用した認証の詳細については、「 アカウントまたはワークスペースで Go の を認証DatabricksSDKDatabricks する」を参照してください。