RazorSQL で Lakebase のデータに接続

Jerod Johnson
Senior Technology Evangelist

RazorSQL データベース管理ツールのウィザードを使用して Lakebase に接続し、GUI で Lakebase のデータをクエリします。

CData JDBC Driver for Lakebase は、IDE のウィザードからデータ管理・分析ツールまで、サードパーティツールからの標準ベースのアクセスを可能にします。この記事では、RazorSQL のウィザードを使用して Lakebase に接続する方法を説明します。

Lakebase のデータ用の JDBC データソースを作成

RazorSQL アプリケーションを開き、「Connections」メニューから「Add Connection Profile」->「Other」->「JDBC」を選択します。
表示される「Connection Wizard」で、以下のプロパティを設定します。
- Driver Location：インストールディレクトリ内の lib サブフォルダへのパスを設定します。
- Driver Class：ドライバークラスを cdata.jdbc.lakebase.LakebaseDriver に設定します。
- Username：ユーザー名を入力します（このプロパティは JDBC URL 内でも設定できます）。
- Password：パスワードを入力します（このプロパティは JDBC URL 内でも設定できます）。
- JDBC URL：接続パラメータを入力します。JDBC 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 クライアントを構成します。手順の概要は以下のとおりです。
  1. 新しいサービスプリンシパルを作成・構成する
  2. サービスプリンシパルに権限を割り当てる
  3. サービスプリンシパル用の 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;
```