Aqua Data Studio で Lakebase のデータ に接続
CData JDBC Driver for Lakebase は、Aqua Data Studio などの IDE のウィザードや分析機能と Lakebase のデータ を連携できます。本記事では、接続マネージャーを使って Lakebase のデータ に接続し、クエリを実行する方法を説明します。
JDBC データソースの作成
接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した Lakebase データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。
- Aqua Data Studio で、Servers メニューから Register Server を選択します。
- Register Server フォームで、「Generic - JDBC」接続を選択します。
- 以下の JDBC 接続プロパティを入力します：
- Name: データソースの名前を入力します（例：Lakebase）。
- Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.lakebase.jar ファイルを選択します。
- Driver: ドライバーのクラス名 cdata.jdbc.lakebase.LakebaseDriver を入力します。
URL: JDBC URL を入力します。URL は jdbc:lakebase: から始まり、その後にセミコロン区切りで接続プロパティを指定します。
Databricks Lakebase に接続するには、以下のプロパティを設定します。
- DatabricksInstance: Databricks インスタンスまたはサーバーホスト名を指定します。形式は instance-abcdef12-3456-7890-abcd-abcdef123456.database.cloud.databricks.com です。
- Server: Lakebase データベースをホストするサーバーのホスト名または IP アドレスを指定します。
- Port（オプション）: Lakebase データベースをホストするサーバーのポート番号を指定します。デフォルトは 5432 です。
- Database（オプション）: Lakebase サーバーへの認証後に接続するデータベースを指定します。デフォルトでは認証ユーザーのデフォルトデータベースに接続します。
OAuth クライアント認証
OAuth クライアント資格情報を使用して認証するには、サービスプリンシパルで OAuth クライアントを構成します。手順の概要は以下のとおりです。
- 新しいサービスプリンシパルを作成・構成する
- サービスプリンシパルに権限を割り当てる
- サービスプリンシパル用の OAuth シークレットを作成する
詳細については、ヘルプドキュメントの「Setting Up OAuthClient Authentication」セクションをご参照ください。
OAuth PKCE 認証
PKCE（Proof Key for Code Exchange）を使用した OAuth code タイプで認証するには、以下のプロパティを設定します。
- AuthScheme: OAuthPKCE を指定します。
- User: 認証ユーザーのユーザー ID を指定します。
詳細については、ヘルプドキュメントをご参照ください。
組み込みの接続文字列デザイナー
JDBC URL の作成には、Lakebase JDBC Driver に組み込まれている接続文字列デザイナーをご利用いただけます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
java -jar cdata.jdbc.lakebase.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は以下のとおりです：jdbc:lakebase:DatabricksInstance=lakebase;Server=127.0.0.1;Port=5432;Database=my_database;
Lakebase のデータ へのクエリ
これで、公開されているテーブルにクエリを実行できます。
はじめる準備はできましたか？
Lakebase Driver の無料トライアルをダウンロードしてお試しください：
ダウンロード