CloverDX（旧CloverETL）で Kintone のデータ に接続

CData JDBC Driver for Kintone を使用すると、CloverDX（旧CloverETL）のデータ変換コンポーネントで Kintone をソースおよびデスティネーションとして扱えます。この記事では、JDBC Driver for Kintone を使用して、フラットファイルへのシンプルな転送を設定する方法を説明します。

JDBC データソースとして Kintone に接続

1. Kintone のデータ への接続を作成します。新規のCloverDX グラフで、Outline ペインの「Connections」ノードを右クリックし、「Connections」->「Create Connection」をクリックします。Database Connection ウィザードが表示されます。
2. プラスアイコンをクリックし、JAR からドライバーをロードします。インストールディレクトリのlib サブフォルダを参照し、cdata.jdbc.kintone.jar ファイルを選択します。
3. JDBC URL を入力します。

   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 ファイルをダブルクリックするか、コマンドラインから実行します。

   java -jar cdata.jdbc.kintone.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   一般的なJDBC URL は次のようになります：

   jdbc:kintone:User=myuseraccount;Password=mypassword;URL=http://subdomain.domain.com;

DBInputTable コンポーネントで Kintone のデータ をクエリ

1. Palette の「Readers」から「DBInputTable」をジョブフローにドラッグし、ダブルクリックして設定エディターを開きます。
2. 「DB connection」プロパティで、ドロップダウンメニューから Kintone JDBC データソースを選択します。
3. SQL クエリを入力します。例：

   SELECT Name, Description FROM Apps

クエリの出力をUniversalDataWriter に書き込む

1. 「Writers」から「UniversalDataWriter」をジョブフローにドラッグします。
2. UniversalDataWriter をダブルクリックして設定エディターを開き、ファイルURL を追加します。
3. DBInputTable を右クリックし、「Extract Metadata」をクリックします。
4. DBInputTable の出力ポートをUniversalDataWriter に接続します。
5. UniversalDataWriter の「Select Metadata」メニューで、Apps テーブルを選択します。（このメニューはUniversalDataWriter の入力ポートを右クリックしても開けます。）
6. 「Run」をクリックして、ファイルに書き込みます。