> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CDK Global Connector

## Intro

CDK Global is the largest global provider of integrated information technology and digital marketing solutions to the automotive retail industry.

CDK Global provides integrated technology solutions to over 26,500 Auto, Truck, Motorcycle, Marine, Recreational Vehicle, and Heavy Equipment dealers throughout the world.

CDK Global Connector is a widely used open-source relational database management system. You can use Domo's CDK Global Connector to pull data from your CDK Global database and compile custom reports. You indicate the data you want by inputting an SQL query.

The CDK Global connector is a "Database" connector, meaning it retrieves data from a database using a query. In the Data Center, you can access the connector page for this and other Database connectors by clicking **Database** in the toolbar at the top of the window.

<Note>
  **Notes:**

  * This connector supports TLS IF your CDK Global server supports TLS.
  * Non SSL connections are not supported. If no certificate is provided, the connection is still SSL but without any certificate authentication. The connection will trust all server certificates. Refer to the following link for details:

    [https://msdn.microsoft.com/en-us/library/bb879949%28v=sql.110%29.aspx](https://msdn.microsoft.com/en-us/library/bb879949%28v=sql.110%29.aspx)
</Note>

## Best Practices

* Limit the results set size is much as possible.
* Keep the number of columns to a minimum.

## Prerequisites

To connect to a CDK Global database and create a DataSet, you must have the following:

* The username and password you use to log into your CDK Global

  database.
* The hostname for the database.
* The port number for the database.
* The database name or schema name.
* The SQL query you will use to pull data.
* SSL.

You can also include the URL where your SSL CA Certificate is located, though this is optional.

## Connecting to Your CDK Global Database

This section enumerates the options in the **Credentials** and **Details** panes on the CDK Global

Connector page. The components of the other panes on this page, **Scheduling,** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

<Tip>
  **Note:** When using the copy/paste function for your credentials, ensure there is no whitespace at the beginning or end of the string. By accidentally pasting whitespace, it will cause the connector to error when trying to connect.
</Tip>

### Credentials Pane

This pane contains fields for entering credentials to connect to your database. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Field </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Host </p></td><td colspan="1" rowspan="1"><p> Enter the SFTP host name for the CDK Global <span /> database. For example: <span /><span class="mt-font-courier-new"><a href="http://db.company.com" rel="noopener" target="_blank"> db.company.com </a></span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Database Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the CDK Global database or schema. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter your CDK Global username. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Enter your CDK Global <span /> password. </p></td></tr><tr><td colspan="1" rowspan="1"><p> CA Certificate </p></td><td colspan="1" rowspan="1"><p> Enter the URL where the SSL Ca Certificate is located (optional). </p></td></tr><tr><td colspan="1" rowspan="1"><p> Port </p></td><td colspan="1" rowspan="1"><p> Enter the port number for the database. </p></td></tr></tbody></table>

Once you have entered valid CDK Global

credentials, you can use the same account any time you go to create a new CDK Global

DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

In this pane you create an SQL query to pull data from your database, with or without a parameter.

<table cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Query Type </p></td><td colspan="1" rowspan="1"><p> Select the desired CDK Global <span /> query type—either with or without a parameter. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Query </p></td><td colspan="1" rowspan="1"><p> Enter the Structured Query Language (SQL) query to use in selecting the data you want. For example: </p><p><span class="mt-font-courier-new"> select \* from Employee </span></p><p> You can use the <b> Query Helper </b> parameter to help you write a usable SQL query. To use the <b> Query Helper </b>, do the following: </p><ol><li><p> Select your database table and table columns in the appropriate menus. </p></li><li><p> Copy the SQL statement that appears in the <b> Query Helper </b> field. </p></li><li><p> Paste the copied SQL statement into the <b> Query </b> field. </p></li></ol><p /></td></tr><tr><td colspan="1" rowspan="1"><p> Query Parameter </p></td><td colspan="1" rowspan="1"><p> Enter the query parameter value. This is the initial value for the query parameter. You can use this option to retrieve new data since the last run. </p><p> For example, if you entered the following query in the <b> Query </b> field... </p><p>`select * from test.lastValue where id <=!{lastvalue:id}! order by id desc`</p><p>...and then entered the following for the <b> Query Parameter </b>... </p><p><code> `!{lastvalue:id}!=3` </code></p><p>...then the first run would return 3 rows, and all subsequent runs would return 1 row, and the results would be ordered from largest to smallest. </p><p> Similarly, if you entered the following in the <span /><b> Query </b> field... </p><p>`select * from test.lastValue where time >!{lastrundate:time}!`</p><p>...and then entered the following for the <b> Query Parameter </b>... </p><p><code> `!{lastrundate:time}!=01/01/1990` </code></p><p>...then the first run would return 5 rows and all subsequent runs would return 0 rows. </p></td></tr><tr><td colspan="1" rowspan="1"><p> TinyInt Values Treated as Boolean Values? </p></td><td colspan="1" rowspan="1"><p> Select <b> Yes </b> if you want TinyInt values to be treated as Boolean. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Cast Boolean Values To... </p></td><td colspan="1" rowspan="1"><p> Select whether Boolean values will be cast to integers or strings. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database Tables (Optional) </p></td><td colspan="1" rowspan="1"><p> Select the database table you want to import into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Table Columns (Optional) </p></td><td colspan="1" rowspan="1"><p> Select the table columns you want to import into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Query Helper (Optional) </p></td><td colspan="1" rowspan="1"><p> Copy and paste the SQL statement in this field into the <b> Query </b> field. For more information, see <b> Query </b>, above. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## FAQ

<AccordionGroup>
  <Accordion title="What kind of credentials do I need to power up this connector?">
    You need the username and password associated with your CDK Global account. You also need your CDK Global SFTP hostname and port number.
  </Accordion>

  <Accordion title="Can I use the same account multiple times to create datasets?">
    Yes
  </Accordion>

  <Accordion title="How often can the data be updated?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits that I need to be aware of?">
    No
  </Accordion>
</AccordionGroup>

## Troubleshooting

* Verify the credentials using MySQL Workbench.
* Confirm the server supports encrypted connections.
* Confirm the Domo IPs are whitelisted.
* To speed up your runtime, make sure the tables you are joining don't have duplicate column names and that you call each column only once.
