Aqua Data Studio で CouchDB のデータ に接続
CData JDBC Driver for CouchDB は、Aqua Data Studio などの IDE のウィザードや分析機能と CouchDB のデータ を連携できます。本記事では、接続マネージャーを使って CouchDB のデータ に接続し、クエリを実行する方法を説明します。
JDBC データソースの作成
接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した CouchDB データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。
- Aqua Data Studio で、Servers メニューから Register Server を選択します。
- Register Server フォームで、「Generic - JDBC」接続を選択します。
- 以下の JDBC 接続プロパティを入力します:
- Name: データソースの名前を入力します(例:CouchDB)。
- Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.apachecouchdb.jar ファイルを選択します。
- Driver: ドライバーのクラス名 cdata.jdbc.apachecouchdb.ApacheCouchDBDriver を入力します。
URL: JDBC URL を入力します。URL は jdbc:apachecouchdb: から始まり、その後にセミコロン区切りで接続プロパティを指定します。
Apache CouchDB 接続プロパティの取得・設定方法
それでは、Apache CouchDB に接続していきましょう。Url 接続プロパティをApache CouchDB インスタンスのURL に設定します。例:http://localhost:5984
ユーザー(またはJWT)が特定のデータベースだけにアクセスできるようにしたい場合は、Apache CouchDB インスタンスで"admin_only_all_dbs" オプションを設定し、テーブルをリストするためにCData 製品が必要とする"/_all_dbs" エンドポイントへのアクセス権をすべてのユーザーに付与する必要があります。
Apache CouchDB への認証
続いて、認証方法を設定しましょう。CData 製品では、3種類の認証をサポートしています。
- Basic:基本的なユーザー名 / パスワード認証
- JWT:JWT 認証
- None:パブリックなデータベースへの匿名アクセス
Basic 認証
データに接続するには、以下のプロパティを設定してください。
- AuthScheme:Basic
- User:認証に使用されるApache CouchDB ユーザーアカウント
- Password:認証するユーザーに関連付けられたApache CouchDB パスワード
その他の認証方法については、ヘルプドキュメントの「接続の確立」セクションをご確認ください。
組み込みの接続文字列デザイナー
JDBC URL の作成には、CouchDB JDBC Driver に組み込まれている接続文字列デザイナーをご利用いただけます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
java -jar cdata.jdbc.apachecouchdb.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は以下のとおりです:jdbc:apachecouchdb:Url=http://localhost:5984;User=abc123;Password=abcdef;
CouchDB のデータ へのクエリ
これで、公開されているテーブルにクエリを実行できます。