基本認証 (サポート終了)

注記

Databricks のユーザー名とパスワードを使用した基本認証は、2024 年 7 月 10 日にサポートが終了しました。「Databricks で管理されるパスワードのサポート終了」を参照してください。

基本認証では、Databricksのユーザー名とパスワードを使用して、ターゲットのDatabricksユーザーアカウントを認証します。Basic 認証はレガシーであり、本番運用では推奨されません。

Basic 認証を構成するには、次の関連する環境変数、 .databrickscfg フィールド、Terraformフィールド、または Config フィールドを設定する必要があります。

Databricksホスト
- アカウント操作の場合は、https://accounts.cloud.databricks.com を指定します。
- ワークスペース操作の場合は、ワークスペースの URL を指定します (例: https://dbc-a1b2345c-d6e7.cloud.databricks.com)。
Databricksユーザーアカウントのユーザー名。
Databricksユーザーアカウントのパスワード。
Databricks アカウント操作の場合、Databricks アカウント ID。

Databricks ユーザーアカウントのパスワードは、次の複雑さの要件を満たしている必要があります。

8 文字より大きく 50 文字未満である必要があります
次の各カテゴリの文字が少なくとも 1 つ含まれている必要があります。
- 10 桁を基数とする数字 (0 から 9)。
- 小文字
- 大文字
- 英数字以外の文字(特殊文字):
```
'-!"#$%&()*,./:;?@[]^_`{|}~+<=>
```

複雑さの要件は、パスワードが変更または作成されるときに適用されます。

Basic 認証を実行するには、参加しているツールまたはSDKに基づいてコード内に以下を統合します。

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

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

DATABRICKS_HOST：DatabricksアカウントのコンソールURL（https://accounts.cloud.databricks.com）に設定されます。
DATABRICKS_ACCOUNT_ID
DATABRICKS_USERNAME
DATABRICKS_PASSWORD

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

DATABRICKS_HOSTで、Databricks ワークスペース URL ( https://dbc-a1b2345c-d6e7.cloud.databricks.comなど) に設定します。
DATABRICKS_USERNAME
DATABRICKS_PASSWORD

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

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

[<some-unique-configuration-profile-name>]
host       = <account-console-url>
account_id = <account-id>
username   = <username>
password   = <password>

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

[<some-unique-configuration-profile-name>]
host     = <workspace-url>
username = <username>
password = <password>

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

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

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

注記

Basic 認証は、次の Databricks Connect バージョンでサポートされています。

Pythonの場合、Databricks Connect for Databricks Runtime 13.1以降。
Scalaの場合、Databricks Connect for Databricks Runtime 13.3 LTS以降。

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

この記事の「プロファイル」セクションで指定されているように、Databricks ワークスペースレベルの操作の .databrickscfg ファイルの値を設定します。また、プロファイルの cluster_id 環境変数をワークスペースインスタンスの URL に設定します (例: https://dbc-a1b2345c-d6e7.cloud.databricks.com)。
Databricks ワークスペースレベルの操作の環境変数は、この記事の「環境」セクションで指定されているとおりに設定します。また、 DATABRICKS_CLUSTER_ID 環境変数をワークスペースインスタンスの URL ( https://dbc-a1b2345c-d6e7.cloud.databricks.comなど) に設定します。

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

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

DatabricksのVisual Studio Code拡張機能の場合は、次のようにします。

この記事の「プロファイル」セクションで指定されているように、Databricks ワークスペースレベルの操作の .databrickscfg ファイルの値を設定します。
DatabricksのVisual Studio Code拡張機能の [ 構成 ] ウィンドウで、[ Databricksを構成する ] をクリックします。
コマンドパレット の Databricks Host で、ワークスペースの URL (https://dbc-a1b2345c-d6e7.cloud.databricks.comなど) を入力し、Enterキーを押します。
コマンドパレット で、URLのリストでターゲットプロファイルの名前を選択します。

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

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

provider "databricks" {
  alias = "accounts"
}

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

provider "databricks" {
  alias      = "accounts"
  host       = <retrieve-account-console-url>
  account_id = <retrieve-account-id>
  username   = <retrieve-username>
  password   = <retrieve-password>
}

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

provider "databricks" {
  alias = "workspace"
}

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

provider "databricks" {
  alias    = "workspace"
  host     = <retrieve-workspace-url>
  username = <retrieve-username>
  password = <retrieve-password>
}

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

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

注記

の Databricksを使用してアカウントレベルのRESTAPIDatabricksSDK PythonDatabricks on Google Cloudを呼び出すことは、ではサポートされていません。

Python
from databricks.sdk import AccountClient

a = AccountClient()
# ...

直接設定の場合 ( retrieve プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。この場合、Databricks アカウントコンソールの URL は https://accounts.cloud.databricks.comです。

Python
from databricks.sdk import AccountClient

a = AccountClient(
  host       = retrieve_account_console_url(),
  account_id = retrieve_account_id(),
  username   = retrieve_username(),
  password   = retrieve_password()
)
# ...

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

Python
from databricks.sdk import WorkspaceClient

w = WorkspaceClient()
# ...

直接設定の場合 ( retrieve プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。この場合、ホストは Databricks ワークスペースの URL です (例: https://dbc-a1b2345c-d6e7.cloud.databricks.com

Python
from databricks.sdk import WorkspaceClient

w = WorkspaceClient(
  host     = retrieve_workspace_url(),
  username = retrieve_username(),
  password = retrieve_password()
)
# ...

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

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

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

Java
import com.databricks.sdk.AccountClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
  .setHost(retrieveAccountConsoleUrl())
  .setAccountId(retrieveAccountId())
  .setUsername(retrieveUsername())
  .setPassword(retrievePassword());
AccountClient a = new AccountClient(cfg);
// ...

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

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

Java
import com.databricks.sdk.WorkspaceClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
  .setHost(retrieveWorkspaceUrl())
  .setUsername(retrieveUsername())
  .setPassword(retrievePassword());
WorkspaceClient w = new WorkspaceClient(cfg);
// ...

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

Scala 用の Databricks Connect クライアントを設定します (Scala 用の Databricks Connect クライアントは、認証に付属の Databricks SDK for Java を使用します)
Databricksアカウントまたはワークスペースを使用してDatabricks SDK for Javaを認証する

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

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

Go
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient(&databricks.Config{
  Host:      retrieveAccountConsoleUrl(),
  AccountId: retrieveAccountId(),
  UserName:  retrieveUsername(),
  Password:  retrievePassword(),
}))
// ...

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

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

Go
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
w := databricks.Must(databricks.NewWorkspaceClient(&databricks.Config{
  Host:     retrieveWorkspaceUrl(),
  UserName: retrieveUsername(),
  Password: retrievePassword(),
}))
// ...

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