基本認証 (サポート終了)
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に基づいてコード内に以下を統合します。
- Environment
- Profile
- CLI
- Connect
- VS Code
- Terraform
- Python
- Java
- Go
ツールまたは 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を使用してアカウント レベルのRESTAPIsDatabricksSDK PythonDatabricks on Google Cloudを呼び出すことは、 ではサポートされていません。
from databricks.sdk import AccountClient
a = AccountClient()
# ...
直接設定の場合 ( retrieve
プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。 この場合、Databricks アカウント コンソールの URL は https://accounts.cloud.databricks.com
です。
from databricks.sdk import AccountClient
a = AccountClient(
host = retrieve_account_console_url(),
account_id = retrieve_account_id(),
username = retrieve_username(),
password = retrieve_password()
)
# ...
ワークスペース レベルの操作の場合、デフォルト認証の場合:
from databricks.sdk import WorkspaceClient
w = WorkspaceClient()
# ...
直接設定の場合 ( retrieve
プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。 この場合、ホストは Databricks ワークスペースの URL です (例: https://dbc-a1b2345c-d6e7.cloud.databricks.com
from databricks.sdk import WorkspaceClient
w = WorkspaceClient(
host = retrieve_workspace_url(),
username = retrieve_username(),
password = retrieve_password()
)
# ...
を使用し、Databricks PythonDatabricksクライアント統合認証 を実装する ツールと SDK を使用した認証の詳細については 以下を参照してください。
アカウントレベルのオペレーションオペレーションの場合、デフォルトの認証の場合:
import com.databricks.sdk.AccountClient;
// ...
AccountClient a = new AccountClient();
// ...
直接設定の場合 ( retrieve
プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。 この場合、Databricks アカウント コンソールの URL は https://accounts.cloud.databricks.com
です。
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);
// ...
ワークスペース レベルの操作の場合: デフォルト認証の場合:
import com.databricks.sdk.WorkspaceClient;
// ...
WorkspaceClient w = new WorkspaceClient();
// ...
直接設定の場合 ( retrieve
プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。 この場合、ホストは Databricks ワークスペースの URL です (例: https://dbc-a1b2345c-d6e7.cloud.databricks.com
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を認証する
アカウントレベルのオペレーションの場合、デフォルトの認証の場合:
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient())
// ...
直接設定の場合 ( retrieve
プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。 この場合、Databricks アカウント コンソールの URL は https://accounts.cloud.databricks.com
です。
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient(&databricks.Config{
Host: retrieveAccountConsoleUrl(),
AccountId: retrieveAccountId(),
UserName: retrieveUsername(),
Password: retrievePassword(),
}))
// ...
ワークスペース レベルの操作の場合、デフォルト認証の場合:
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
w := databricks.Must(databricks.NewWorkspaceClient())
// ...
直接設定の場合 ( retrieve
プレースホルダーを独自の実装に置き換えて、コンソールまたはその他の設定ストア ( AWS Systems Manager パラメーター Store など) から値を取得します)。 この場合、ホストは Databricks ワークスペースの URL です (例: https://dbc-a1b2345c-d6e7.cloud.databricks.com
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 する」を参照してください。