メインコンテンツまでスキップ

SQL クライアントからのデータベース・インスタンスへのアクセス

備考

プレビュー

この機能は、us-east-1us-west-2eu-west-1ap-southeast-1ap-southeast-2eu-central-1us-east-2ap-south-1の各地域でパブリック プレビュー段階です。

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

データベースインスタンスには、 psql、DBeaver、pgAdmin4などの外部ツールからアクセスできます。また、これらのツールを使用すると、ダッシュボードを構築して、パフォーマンス、ストレージ使用量、クエリ効率に関するデータベース メトリクスを視覚化することもできます。

psqlコマンドラインツールは、データベースインスタンスへの直接的でインタラクティブなアクセスを提供するPostgreSQLの組み込みクライアントです。psqlを使用すると、Postgresの全機能が提供され、既存のPostgresワークフローおよびツールと統合できます。

DBeaverとpgAdminは、Postgresデータベースを管理できるオープンソースツールです。インストール方法と接続方法については 、DBeaver のドキュメントpgAdmin のドキュメントを参照してください。

始める前に

  • psqlをインストールする必要があります。詳細については、 PostgreSQL のツールとインストール ガイドを参照してください。psql バージョン14以降が必要です。
  • libpq ライブラリをインストールする必要があります。
  • データベースインスタンスにログインするための対応するPostgresロールがあります。Databricks ID の Postgres ロールを作成および管理するを参照してください。
  • Postgres ロールには、データベース、スキーマ、またはテーブルにアクセスするために必要なアクセス許可が付与されます。
  • データベース・インスタンスに対して認証できます。データベース・インスタンスの OAuth トークンを取得する必要がある場合は、 データベース・インスタンスに対する認証を参照してください。

ID とデータベース ロールに関する考慮事項

  • インスタンスのデフォルト所有者は、データベースインスタンスをプロビジョニングした Databricks ユーザーまたはサービスプリンシパルです。
  • プロビジョニング中に、対応する Postgres ロール名が ID に対して自動的に作成されます。
    • Databricksユーザー : Postgres ロール名は、ユーザーの Eメール アドレスです。
    • Databricks サービスプリンシパル : Postgres ロール名は、サービスプリンシパルのアプリケーション ID です。

接続先 psql

データベースインスタンスのステータスが [使用可能] になったら、 psql コマンドラインツールを使用して接続します。データベース・インスタンス構成ページから接続コマンドをコピーします。

  1. ワークスペースのサイドバーで「 コンピュート 」をクリックします。
  2. データベース・インスタンス をクリックします。
  3. アクセスするデータベースインスタンスを psqlから選択します。
  4. 接続の詳細 をクリックします。
  5. Connect with PSQL 文字列をコピーします。
  6. コマンドをターミナルに貼り付けて実行し、 psqlを使用してデータベースインスタンスに接続します。