VOOZH about

URL: https://www.cdata.com/kb/tech/templated-jdbc-dbartisan.rst

⇱ Manage Templated Data in DBArtisan as a JDBC Source


Manage Templated Data in DBArtisan as a JDBC Source

👁 Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Use wizards in DBArtisan to create a JDBC data source for Templated.

The CData JDBC Driver for Templated seamlessly integrates Templated data into database management tools like DBArtisan by enabling you to access Templated data as a database. This article shows how to create a JDBC source for Templated in DBArtisan. You can then edit data visually and execute standard SQL.

Integrate Templated Data into DBArtisan Projects

Follow the steps below to register Templated data as a database instance in your project:

  1. In DBArtisan, click Data Source -> Register Datasource.
  2. Select Generic JDBC.
  3. Click Manage.
  4. In the resulting dialog, click New. Enter a name for the driver and click Add. In the resulting dialog, navigate to the driver JAR. The driver JAR is located in the lib subfolder of the installation directory. 👁 The JDBC driver definition in the Register Datasource wizard. (Salesforce is shown.)
  5. In the Connection URL box, enter credentials and other required connection properties in the JDBC URL.

    To authenticate to Templated, you will need an API key. You can obtain your API key from the Templated Dashboard under the API Key tab (app.templated.io > Dashboard > API Key).

    Using API Key Authentication

    After setting the following connection properties, you are ready to connect:

    • AuthScheme: Set this to APIKey.
    • APIKey: Set this to your Templated API key.

    Example connection string:

    Profile=C:\profiles\Templated.apip;AuthScheme=APIKey;ProfileSettings='APIKey=my_api_key';
    

    Built-in Connection String Designer

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

    java -jar cdata.jdbc.api.jar
    

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

    👁 Required JDBC connection properties in the Register Datasource wizard. (Salesforce is shown.)

    Below is a typical connection string:

    jdbc:api:Profile=C:\profiles\Templated.apip;AuthScheme=APIKey;ProfileSettings='APIKey=my_api_key';
  6. Finish the wizard to connect to Templated data. Templated entities are displayed in the Datasource Explorer.

You can now work with Templated data as you work with any other database. See the driver help documentation for more information on the queries supported by the Templated API.

👁 The results of a query. (Salesforce is shown.)