Databricks Lakebase


Databricks Lakebase


Prerequisites

To use the OAuthClient authentication method, you must create a service principle in Databricks Lakebase and assign permissions. Refer to the Databricks documentation.

Next, the account or workspace administrator creates an OAuth secret:

  1. At the new service principal’s details page, in the Developer Service Principal section, click the Secrets tab.

  2. Under OAuth secrets, click the Generate secret button.

  3. Enter the desired lifetime for the secret in days, up to a maximum of 730 days (two years). The admin console displays updated details about the new service principal, including the OAuth secret and the Client ID (which is the same as the service principal’s application ID).

  4. Enter the Client Id and Secret in the fields below.

セットアップガイド

以下の手順で、Databricks Lakebase をConnect AI アカウントに接続します。

  1. Connect AI のダッシュボードからConnections ページを開きます。

  2. 右上の+ Add Connection をクリックします。

  3. 検索フィールドに Databricks Lakebase と入力し、データソース名をクリックします。

  4. 新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。

  5. Enter the host name or IP address of the Server name hosting the Databricks Lakebase database.

  6. Enter the name of the target Databricks Lakebase Database.

  7. For Databricks Instance, enter the URL for the user interface during normal access of the Databricks console. This should be in the format of dbc-(id).cloud.databricks.com.

  8. Enter the Port number of the server hosting the Databricks Lakebase database. The default value is 5432.

  9. Select the Authentication method, then proceed to the relevant section and follow those instructions.

Authentication Methods

OAuthClient

  1. Enter the OAuthClientId assigned when you configured the service principal (in the prerequisites).

  2. Enter the OAuthClientSecret assigned when you configured the service principal (in the prerequisites). This value authenticates the application to the OAuth authorization server.

  3. Connect AI Add Databricks Lakebase Connection ページ上部の、Save & Test をクリックします。

    • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatusAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。

    • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。

    • 失敗したコネクションは下書きとして保存され、StatusNot Authenticated になります。後でコネクションに戻って認証することができます。

OAuthPKCE

  1. Enter the User Id of the authenticating user. The user obtains a temporary code from the authorization server.

  2. Connect AI Add Databricks Lakebase Connection ページ上部の、Save & Test をクリックします。

    • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatusAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。

    • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。

    • 失敗したコネクションは下書きとして保存され、StatusNot Authenticated になります。後でコネクションに戻って認証することができます。