Connect to Kintone Data in RapidMiner

This article shows how you can easily integrate the CData JDBC driver for Kintone into your processes in RapidMiner. This article uses the CData JDBC Driver for Kintone to transfer Kintone data to a process in RapidMiner.

Connect to Kintone in RapidMiner as a JDBC Data Source

You can follow the procedure below to establish a JDBC connection to Kintone:

1. Add a new database driver for Kintone: Click Connections -> Manage Database Drivers.
2. In the resulting wizard, click the Add button and enter a name for the connection.
3. Enter the prefix for the JDBC URL: jdbc:kintone:
4. Enter the path to the cdata.jdbc.kintone.jar file, located in the lib subfolder of the installation directory.
5. Enter the driver class: cdata.jdbc.kintone.KintoneDriver
6. Create a new Kintone connection: Click Connections -> Manage Database Connections.
7. Enter a name for your connection.
8. For Database System, select the Kintone driver you configured previously.
9. Enter your connection string in the Host box.

   In addition to the authentication values, set the following parameters to connect to and retrieve data from Kintone:

   • Url: The URL of your account.
   • GuestSpaceId: Optional. Set this when using a guest space.

   Authenticating with Kintone

   Kintone supports the following authentication methods.

   Using Password Authentication

   You must set the following to authenticate:

   • User: The username of your account.
   • Password: The password of your account.

   Using Basic Authentication

   If the basic authentication security feature is set on the domain, supply the additional login credentials with BasicAuthUser and BasicAuthPassword. Basic authentication requires these credentials in addition to User and Password.

   Using Client SSL

   Instead of basic authentication, you can specify a client certificate to authenticate. Set SSLClientCert, SSLClientCertType, SSLClientCertSubject, and SSLClientCertPassword. Additionally, set User and Password to your login credentials.

   Built-in Connection String Designer

   For assistance in constructing the JDBC URL, use the connection string designer built into the Kintone JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.

   java -jar cdata.jdbc.kintone.jar

   Fill in the connection properties and copy the connection string to the clipboard.

   A typical connection string is below:

   User=myuseraccount;Password=mypassword;Url=http://subdomain.domain.com;GuestSpaceId=myspaceid
10. Enter your username and password if necessary.

You can now use your Kintone connection with the various RapidMiner operators in your process. To retrieve Kintone data, drag the Retrieve operator from the Operators view. With the Retrieve operator selected, you can then define which table to retrieve in the Parameters view by clicking the folder icon next to the "repository entry." In the resulting Repository Browser, you can expand your connection node to select the desired example set.

Finally, wire the output to the Retrieve process to a result, and run the process to see the Kintone data.