Aqua Data Studio で Kintone のデータ に接続
CData JDBC Driver for Kintone は、Aqua Data Studio などの IDE のウィザードや分析機能と Kintone のデータ を連携できます。本記事では、接続マネージャーを使って Kintone のデータ に接続し、クエリを実行する方法を説明します。
JDBC データソースの作成
接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した Kintone データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。
- Aqua Data Studio で、Servers メニューから Register Server を選択します。
- Register Server フォームで、「Generic - JDBC」接続を選択します。
- 以下の JDBC 接続プロパティを入力します:
- Name: データソースの名前を入力します(例:Kintone)。
- Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.kintone.jar ファイルを選択します。
- Driver: ドライバーのクラス名 cdata.jdbc.kintone.KintoneDriver を入力します。
URL: JDBC URL を入力します。URL は jdbc:kintone: から始まり、その後にセミコロン区切りで接続プロパティを指定します。
Kintone 接続プロパティの設定方法
それでは、Kintone に接続していきましょう。接続するには、以下の接続プロパティを設定します。
- URL:Kintone のアクセスURL(例:https://yoursitename.cybozu.com または https://yoursitename.kintone.com)
- User:アカウントのユーザー名
- Password:アカウントのパスワード
- AuthScheme:「Password」を指定
パスワード認証の代わりにAPI トークン認証をご利用になる場合は、ヘルプドキュメントの「接続の設定」セクションをご確認ください。
Basic 認証の設定
続いて、ご利用のKintone ドメインでBasic 認証を有効にしている場合は、接続プロパティの「詳細」設定で以下の項目を追加設定してください。
- BasicAuthUser:Basic 認証のユーザー名
- BasicAuthPassword:Basic 認証のパスワード
クライアント証明書認証の設定
Basic 認証の代わりにクライアント証明書による認証をご利用になる場合は、以下の項目を設定してください。
- SSLClientCert:クライアント証明書のパス
- SSLClientCertType:証明書の種類
- SSLClientCertSubject:証明書のサブジェクト
- SSLClientCertPassword:証明書のパスワード
組み込みの接続文字列デザイナー
JDBC URL の作成には、Kintone JDBC Driver に組み込まれている接続文字列デザイナーをご利用いただけます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
java -jar cdata.jdbc.kintone.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は以下のとおりです:jdbc:kintone:User=myuseraccount;Password=mypassword;URL=http://subdomain.domain.com;
Kintone のデータ へのクエリ
これで、公開されているテーブルにクエリを実行できます。