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

DBeaverとつながる

備考

ベータ版

Lakebase Postgres (オートスケール Beta) は、 Lakebase の次のバージョンであり、評価のみに利用できます。 本番運用ワークロードの場合は、 Lakebase Public Previewを使用します。 どのバージョンが適しているかを判断するには、バージョンの選択を参照してください。

DBeaver は、PostgreSQL を含む幅広いデータベースをサポートする多用途の汎用データベース管理ツールです。データベース管理、クエリ開発、データの視覚化のための豊富な機能を提供します。

前提条件

  • システムにインストールされているDBeaverまたは Enterprise Edition
  • Postgres ロールが構成された Lakebase データベース プロジェクト
注記

DBeaver に接続するときは、 ネイティブの Postgres パスワード認証 を使用することをお勧めします。ネイティブ Postgres パスワードは、OAuth トークンのように 1 時間ごとに期限切れにならないため、資格情報を頻繁に更新できないアプリケーションに適しています。認証方法の詳細については、 「認証の概要」を参照してください。

DBeaverをインストールする

DBeaver がインストールされていない場合は、 DBeaver Web サイトからダウンロードしてインストールしてください。

接続文字列を理解する

Lakebase は、接続に必要なすべての情報が含まれる接続文字列を提供します。解析方法は次のとおりです。

postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
^ ^ ^ ^
user -| | |- hostname |- database
|
|- password
注記

DBeaver やその他の Java ベースのツールは、接続文字列としてではなく、個別のフィールドで接続の詳細を指定すると最適に機能します。

接続文字列の詳細については、 「接続文字列について」を参照してください。

データベースに接続する

  1. Lakebase から接続の詳細を取得します。

    • Lakebaseアプリに移動し、データベースプロジェクトを選択します。
    • 「接続」を クリックするとデータベース接続モーダルが開きます
    • 接続するブランチ、コンピュート、データベースを選択します
    • ドロップダウンからPostgresロールを選択します(パスワード認証付きのネイティブPostgresロールの使用をお勧めします)
    • 接続の詳細に注意してください
  2. DBeaver で新しいデータベース接続を作成します。

    • DBeaverを開く
    • 新しいデータベース接続」 ボタン(プラグアイコン)をクリックするか、メニューから 「データベース」 > 「新しいデータベース接続」 を選択します。
    • データベースへの接続 ウィザードで、データベースタイプのリストから PostgreSQLを 選択します。
    • 次へを クリック
  3. 接続の詳細を入力してください:

    • Host : コンピュートエンドポイントのホスト名を入力します (例: ep-abc-123.databricks.com )
    • ポート : 5432
    • データベース : データベース名を入力してください (例: databricks_postgres )
    • ユーザー名 : Postgres ロール名を入力します (例: role_name )
    • パスワード : Postgresロールのパスワードを入力してください
    • すべてのデータベースを表示 : このオプションを有効にすると、プロジェクト内のすべてのデータベースが表示されます。
  4. SSL を設定します。

    • ドライバー設定の編集を クリック
    • ドライバーのプロパティ タブで、 sslmode見つけて設定します。 require
    • [OK]を クリックして接続ダイアログに戻ります
  5. 接続をテストして保存します。

    • 接続の詳細を確認するには、 [接続テスト] をクリックします。
    • 成功した場合は、 「完了」 をクリックして接続を保存します。

Lakebase データベース接続が、左側のサイドバーの「データベース ナビゲーター」の下に表示されます。

DBeaverの使用

接続すると、次のことが可能になります。

SQLクエリを実行する

  • 左側のサイドバーでデータベース接続を右クリックします
  • SQLエディタ > 新しいSQLスクリプト を選択
  • エディタにSQLクエリを入力します
  • 実行 ボタン(再生アイコン)をクリックして実行します
  • エディターの下の結果ペインに結果を表示します

マネージドテーブル

  • 左側のサイドバーでデータベース接続を展開します
  • データベース > [データベース] > スキーマ > public > テーブル に移動します。
  • テーブルを 右クリックして新しいテーブルを作成します
  • 既存のテーブルを右クリックして表示、編集、または管理します

データのインポートとエクスポート

データをインポートするには:

  • テーブルを右クリックして 「データのインポート」 を選択します
  • ソースファイル形式を選択します(例:CSV、JSON)
  • 指示に従って列をマッピングし、インポートします

データをエクスポートするには:

  • テーブルを右クリックして 「データのエクスポート」 を選択します
  • エクスポート形式を選択します(例:CSV、JSON)
  • 指示に従ってファイルを保存します

ビジュアルクエリビルダー

DBeaver には、テーブル、列、条件を選択してクエリをグラフィカルに構築できるビジュアル クエリ ビルダーが含まれています。

トラブルシューティング

接続文字列が受け入れられません

DBeaver および pgJDBC ドライバーを使用するその他の Java ベースのツールでは、データベース接続文字列にロール名とパスワードを含めることがサポートされていない場合があります。接続文字列で問題が発生した場合は、代わりにこのガイドで説明されている個別の接続詳細フィールドを使用してください。

接続セキュリティ

Lakebase では、すべての接続で SSL/TLS 暗号化を使用する必要があります。ドライバーのプロパティでsslmoderequireに設定されていることを確認してください。

接続文字列と認証オプションの詳細については、 「データベース プロジェクトに接続する」を参照してください。