Mode に接続する

この記事では、Databricks クラスターまたは Databricks SQLウェアハウス (以前の Databricks SQLエンドポイント) で Mode を使用する方法について説明します。

要件

Mode に手動で接続する前に、次のものが必要です。

  • Databricks ワークスペース内のクラスターまたは SQLウェアハウス。

  • クラスターまたは SQLウェアハウスの接続の詳細 (具体的には、 サーバーのホスト名、 ポート、 および HTTP パス の値)。

  • Databricksの個人アクセストークン。 個人アクセストークンを作成するには、次の手順を実行します。

    1. Databricks ワークスペースで、上部のバーにある Databricks ユーザー名をクリックし、ドロップダウンから[設定]を選択します。

    2. [ 開発者] をクリックします。

    3. [アクセストークン] の横にある [管理] をクリックします。

    4. [ 新しいトークンの生成] をクリックします。

    5. （任意）今後このトークンを識別するのに役立つコメントを入力し、トークンのデフォルトの有効期間である90日を変更します。有効期間のないトークンを作成するには（非推奨）、[有効期間 (日) ] ボックスを空白のままにしてください。

    6. [生成] をクリックします。

    7. 表示されたトークンを安全な場所にコピーし、[完了] をクリックします。

    注

    コピーしたトークンは、必ず安全な場所に保存してください。 コピーしたトークンを他のユーザーと共有しないでください。 コピーしたトークンを紛失した場合、まったく同じトークンを再生成することはできません。 代わりに、この手順を繰り返して新しいトークンを作成する必要があります。 コピーしたトークンを紛失した場合、またはトークンが侵害されたと思われる場合は、アクセストークン ページでトークンの横にあるごみ箱 (取り消し) アイコンをクリックして、ワークスペースからそのトークンをすぐに削除することを強くお勧めします。

    ワークスペースでトークンを作成または使用できない場合は、ワークスペース管理者がトークンを無効にしているか、トークンを作成または使用する権限を付与していない可能性があります。 ワークスペース管理者または次のトピックを参照してください。

    注

    自動化されたツール、システム、スクリプト、アプリを使用して認証する場合のセキュリティのベスト プラクティスとして、Databricks ではOAuth トークンを使用することをお勧めします。

    個人のアクセス トークン認証を使用する場合、 Databricksでは、ワークスペース ユーザーではなく、サービスプリンシパルに属する個人のアクセス トークンを使用することをお勧めします。 サービスプリンシパルのトークンを作成するには、 「サービスプリンシパルのトークンの管理」を参照してください。

Mode に手動で接続する

Mode に手動で接続するには、次の手順を実行します。

  1. Mode にサインインします。

  2. [データの定義] > [接続 の管理] > > [データベースの接続] をクリックします。

  3. [ または、サポートされているデータベースの一覧から選択する] というラベルの付いた一覧で、[ Databricks] を選択します。

  4. [ Databricks 資格情報の入力 ] ページで、次の情報を入力します。

    1. [ホスト] に、要件から [サーバーのホスト名] の値を入力します。

    2. [ ポート] に、要件の [ポート ] の値を入力します。

    3. [ データベース名] に、使用するデータベースの名前を入力します。

    4. [トークン] に、要件から個人用アクセストークンを入力します。

    5. [HTTP パス ] に、要件から HTTP パス の値を入力します。

  5. [ 接続] をクリックします。