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 ベースのツールは、接続文字列としてではなく、個別のフィールドで接続の詳細を指定すると最適に機能します。
接続文字列の詳細については、 「接続文字列について」を参照してください。
データベースに接続する
- 
Lakebase から接続の詳細を取得します。 - Lakebaseアプリに移動し、データベースプロジェクトを選択します。
- 「接続」を クリックするとデータベース接続モーダルが開きます
- 接続するブランチ、コンピュート、データベースを選択します
- ドロップダウンからPostgresロールを選択します(パスワード認証付きのネイティブPostgresロールの使用をお勧めします)
- 接続の詳細に注意してください
 
- 
DBeaver で新しいデータベース接続を作成します。 - DBeaverを開く
- 「 新しいデータベース接続」 ボタン(プラグアイコン)をクリックするか、メニューから 「データベース」 > 「新しいデータベース接続」 を選択します。
- データベースへの接続 ウィザードで、データベースタイプのリストから PostgreSQLを 選択します。
- 次へを クリック
 
- 
接続の詳細を入力してください: - Host : コンピュートエンドポイントのホスト名を入力します (例: ep-abc-123.databricks.com)
- ポート : 5432
- データベース : データベース名を入力してください (例: databricks_postgres)
- ユーザー名 : Postgres ロール名を入力します (例: role_name)
- パスワード : Postgresロールのパスワードを入力してください
- すべてのデータベースを表示 : このオプションを有効にすると、プロジェクト内のすべてのデータベースが表示されます。
 
- Host : コンピュートエンドポイントのホスト名を入力します (例: 
- 
SSL を設定します。 - ドライバー設定の編集を クリック
- ドライバーのプロパティ タブで、 sslmode見つけて設定します。require
- [OK]を クリックして接続ダイアログに戻ります
 
- 
接続をテストして保存します。 - 接続の詳細を確認するには、 [接続テスト] をクリックします。
- 成功した場合は、 「完了」 をクリックして接続を保存します。
 
Lakebase データベース接続が、左側のサイドバーの「データベース ナビゲーター」の下に表示されます。
DBeaverの使用
接続すると、次のことが可能になります。
SQLクエリを実行する
- 左側のサイドバーでデータベース接続を右クリックします
- SQLエディタ > 新しいSQLスクリプト を選択
- エディタにSQLクエリを入力します
- 実行 ボタン(再生アイコン)をクリックして実行します
- エディターの下の結果ペインに結果を表示します
マネージドテーブル
- 左側のサイドバーでデータベース接続を展開します
- データベース > [データベース] > スキーマ > public > テーブル に移動します。
- テーブルを 右クリックして新しいテーブルを作成します
- 既存のテーブルを右クリックして表示、編集、または管理します
データのインポートとエクスポート
データをインポートするには:
- テーブルを右クリックして 「データのインポート」 を選択します
- ソースファイル形式を選択します(例:CSV、JSON)
- 指示に従って列をマッピングし、インポートします
データをエクスポートするには:
- テーブルを右クリックして 「データのエクスポート」 を選択します
- エクスポート形式を選択します(例:CSV、JSON)
- 指示に従ってファイルを保存します
ビジュアルクエリビルダー
DBeaver には、テーブル、列、条件を選択してクエリをグラフィカルに構築できるビジュアル クエリ ビルダーが含まれています。
トラブルシューティング
接続文字列が受け入れられません
DBeaver および pgJDBC ドライバーを使用するその他の Java ベースのツールでは、データベース接続文字列にロール名とパスワードを含めることがサポートされていない場合があります。接続文字列で問題が発生した場合は、代わりにこのガイドで説明されている個別の接続詳細フィールドを使用してください。
接続セキュリティ
Lakebase では、すべての接続で SSL/TLS 暗号化を使用する必要があります。ドライバーのプロパティでsslmodeがrequireに設定されていることを確認してください。
接続文字列と認証オプションの詳細については、 「データベース プロジェクトに接続する」を参照してください。