データベース インスタンスに接続してクエリを実行する

Important

Lakebase Provisioned は、手動でスケーリングするプロビジョニング済みコンピューティングを使用する元の Lakebase オファリングです。 サポートされているリージョンについては、「 リージョンの可用性」を参照してください。 自動スケール コンピューティング、ゼロへのスケール、分岐、インスタント リストアを使用した最新バージョンの Lakebase については、 Lakebase の自動スケールに関するドキュメントを参照してください。

2026 年 3 月 12 日以降、新しい Lakebase インスタンスが自動スケール プロジェクトとして作成されます。 既存のプロビジョニング済みインスタンスは、2026 年 6 月から自動スケールに自動的にアップグレードされます。 詳細については、「 Lakebase 自動スケールへのアップグレード」を参照してください。

このページでは、SQL エディターと外部 SQL クライアントから Lakebase Provisioned データベース インスタンスに接続する方法について説明します。

始める前の準備

  • Azure Databricks ID に対応する Postgres ロールがあります。 Postgres ロールを参照してください。
  • Postgres ロールには、データベース、スキーマ、またはテーブルにアクセスするために必要なアクセス許可が付与されます。
  • データベース インスタンスに対して認証できます。 データベース インスタンスに対する認証を参照してください。

SQL エディターから接続する

SQL エディターで新しい SQL クエリを作成します。

  1. [アプリ] アイコンをクリックします。右上隅にあるアプリを選択し、Lakebase Postgres を選択します。
  2. [ プロビジョニング済み ] をクリックして、[ プロビジョニングされたインスタンス ] ページを開きます。
  3. PostgreSQL クエリを実行するデータベース インスタンスを選択します。
  4. 右上の [ 新しいクエリ ] をクリックします。
  5. 読み取り専用セカンダリで読み取り専用のクエリを実行するには:
    1. コンピューティング リソースのドロップダウン メニューをクリックし、 (読み取り専用) ラベルを持つコンピューティングを選択します。
    2. [ 切り替え] をクリックします。
  6. [ すべて実行] の横にあるドロップダウン セレクターで、目的のデータベースとスキーマを選択します。
  7. PostgreSQL クエリを作成し、[ すべて実行] をクリックします。

制限事項

  • クエリ アクセス制御リスト (ACL) のアクセス許可モデルが適用されます。 実行は、[実行] をクリックしたユーザーの Databricks ID で 行われます。 クエリに対する少なくとも CAN VIEW アクセス権を持つすべてのユーザーは、SQL エディターに表示される結果を確認できます。
  • 一時テーブルやトランザクションなどの接続スコープのオブジェクトは、1 つのセルでのみ機能します。 これらは、それぞれ独自のセッションであるため、異なる 実行 クリックでは機能しません。
  • $$ ブロックにセミコロンを含むステートメントが含まれている場合は、最後のステートメントの結果のみが表示されます。

SQL クライアントからの接続

psql、DBeaver、pgAdmin4 などの外部ツールからデータベース インスタンスにアクセスできます。

psql に接続

  1. [アプリ] アイコンをクリックします。右上隅にあるアプリを選択し、Lakebase Postgres を選択します。
  2. [ プロビジョニング済み ] をクリックして、[ プロビジョニングされたインスタンス ] ページを開きます。
  3. アクセスするデータベース インスタンスを選択します。
  4. [ 接続の詳細] をクリックします。
  5. Connect with PSQL 文字列をコピーします。
  6. コマンドをターミナルに貼り付けて実行します。