NetBeans で Lakebase のデータ に接続
CData JDBC Driver for Lakebase は、JDBC をサポートする IDE にリアルタイム Lakebase のデータ 接続を統合します。JDBC 標準により、ビルトインのデータアクセスウィザードや迅速な開発をサポートするその他のツールを使用できます。この記事では、NetBeans で Lakebase のデータ に接続する方法を説明します。接続を作成し、テーブルエディターで 編集・保存およびを行います。
NetBeans で Lakebase 用の JDBC データソースを作成
JDBC データソースを作成するには、サービスウィンドウで Database ノードを展開し、Drivers ノードを右クリックして New Driver を選択します。表示される New Driver ウィザードで、以下の情報を入力します:
- Driver File(s):Add をクリックし、表示されるファイルエクスプローラーダイアログで cdata.jdbc.lakebase.jar ファイルを選択します。ドライバー JAR はインストールディレクトリの lib サブフォルダにあります。
- Driver Class:Find をクリックして JAR 内のドライバークラスを検索します。次に、メニューから cdata.jdbc.lakebase.LakebaseDriver を選択します。
- Name:ドライバーの名前を入力します。
接続パラメータの定義
以下の手順で、必要な接続プロパティを定義します:
サービスウィンドウで Database ノードを右クリックし、New Connection をクリックします。
New Connection Wizard で、以下の接続プロパティを入力します:
- Driver Name:メニューから CData JDBC Driver for Lakebase を選択します。
- User Name:ユーザー名を入力します。これは JDBC URL でも定義できます。
- Password:パスワードを入力します。これは JDBC URL でも定義できます。
JDBC URL:JDBC URL を指定します。
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 のデータ に接続するには、Database ノードで接続を右クリックし、Connect をクリックします。接続が確立されたら、展開してスキーマ情報を確認できます。
Data Views ウィンドウにテーブルをロードするには、テーブルを右クリックして View Data をクリックします。Data Views ウィンドウでレコードの挿入、更新、削除も行えます。