drivers

The drivers command group lets you search and download drivers, list installed drivers, activate licenses, and inspect connection properties.

drivers search

Searches the CData driver catalog and returns a list of available drivers. Use this command to find the artifact ID needed to download a driver.

cdatacli drivers search [--driver <driver-name>]

Arguments and options

Argument/Option	Description	Required
`--driver`	Driver name or artifact ID to search for (partial matches accepted). Omit to list all.	No

Examples Search for all available drivers:

cdatacli drivers search

Filter by name:

cdatacli drivers search --driver salesforce

Output

{
  "drivers" : [ {
    "groupId" : "cdata",
    "artifactId" : "salesforce-jdbc",
    "name" : "CData Salesforce Data Provider 2026",
    "version" : "26.0.9666",
    "url" : "https://maven.cdata.com/p/jdbc/cdata/salesforce-jdbc/26.0.9666/salesforce-jdbc-26.0.9666.jar"
  }, {
    "groupId" : "cdata",
    "artifactId" : "sfmarketingcloud-jdbc",
    "name" : "CData Salesforce Marketing Cloud Data Provider 2026",
    "version" : "26.0.9655",
    "url" : "https://maven.cdata.com/p/jdbc/cdata/sfmarketingcloud-jdbc/26.0.9655/sfmarketingcloud-jdbc-26.0.9655.jar"
  } ]
}

drivers download

Downloads a CData JDBC driver JAR from the driver catalog or a direct URL. The JAR is saved to ./lib/ by default, which is one of the locations the CLI auto-discovers.

cdatacli drivers download [--artifact-id <artifact-id> | --url <jar-url>] [--output <dir>]

Arguments and options

Argument/Option	Description	Required
`--artifact-id`	Artifact ID of the driver (e.g. `salesforce-jdbc`). Looks up the download URL from the driver catalog.	One of `--artifact-id` or `--url`
`--url`	Direct URL of the driver JAR to download.	One of `--artifact-id` or `--url`
`-o, --output`	Directory to save the JAR file (default: `./lib`)	No

Examples Download a driver by artifact ID:

cdatacli drivers download --artifact-id salesforce-jdbc

Download to a specific directory:

cdatacli drivers download --artifact-id salesforce-jdbc --output /opt/cdata/lib

Download from a direct URL:

cdatacli drivers download --url https://example.com/cdata.jdbc.salesforce.jar

drivers list

Lists all CData JDBC drivers discovered in ./ and ./lib/ relative to the CLI executable.

cdatacli drivers list

Output

{
  "drivers" : [ {
    "path" : "./lib/cdata.jdbc.salesforce.jar",
    "activated" : true,
    "version" : "26.0.9666.0",
    "product" : "CData JDBC Driver For Salesforce 2026",
    "name" : "Salesforce"
  }, {
    "path" : "./lib/cdata.jdbc.snowflake.jar",
    "activated" : false,
    "version" : "26.0.9666.0",
    "product" : "CData JDBC Driver For Snowflake 2026",
    "name" : "Snowflake"
  } ]
}

drivers activate

Activates a CData JDBC driver using a license key or trial. This command is non-interactive and suitable for scripting.

cdatacli drivers activate <driver-name> --name <your-name> --email <email> [--key <license-key> | --trial]

Arguments and options

Argument/Option	Description	Required
`<driver-name>`	Name of the driver to activate	Yes
`--name`	Name of the user registering the license	Yes
`--email`	Email address for the license	Yes
`--key`	License key	One of `--key` or `--trial`
`--trial`	Start a free trial instead of using a license key	One of `--key` or `--trial`

Examples Activate with a license key:

cdatacli drivers activate Salesforce --name "John Doe" --email you@example.com --key XXXX-XXXX-XXXX-XXXX

Start a free trial:

cdatacli drivers activate Salesforce --name "John Doe" --email you@example.com --trial

drivers connectionprops

Shows connection properties for a driver, including type, description, default values, allowed values, and per-auth-scheme property hierarchies. By default, returns basic properties. Use --full to return advanced properties instead.

cdatacli drivers connectionprops <driver-name> [--full] [--output <format>]

Arguments and options

Argument/Option	Description	Required
`<driver-name>`	Name of the driver	Yes
`--full`	Return advanced connection properties instead of basic properties	No
`--output`	Output format: `json` (default) or `yaml`	No

Examples Show basic connection properties:

cdatacli drivers connectionprops Salesforce

Show advanced connection properties:

cdatacli drivers connectionprops Salesforce --full

Output Properties are returned under jdbcJson.basic (or jdbcJson.advanced with --full). Basic properties that vary by auth scheme include a hierarchyRules object keyed by scheme name. Output is trimmed for clarity.

{
  "driver" : "Salesforce",
  "version" : "26.0.9666.0",
  "jdbcJson" : {
    "basic" : [ {
      "name" : "Auth Scheme",
      "display" : "RequiredBasic",
      "type" : "String",
      "description" : "Specifies the authentication method to use when connecting to Salesforce.",
      "default" : "OAuthPKCE",
      "enum" : [ "Basic", "OAuth", "OAuthClient", "OAuthPassword", "OAuthJWT", "OAuthPKCE" ],
      "hierarchyRules" : {
        "Basic" : [ {
          "name" : "User",
          "display" : "RequiredBasic",
          "type" : "String",
          "description" : "Specifies the authenticating user's user ID."
        }, {
          "name" : "Password",
          "display" : "RequiredBasic",
          "type" : "String",
          "description" : "Specifies the authenticating user's password."
        } ]
      }
    }, {
      "name" : "API Version",
      "display" : "UnrequiredBasic",
      "type" : "String",
      "description" : "Specifies the Salesforce API version to use for the connection.",
      "default" : "66.0"
    } ]
  }
}

Getting Started

Guides

Command Reference

drivers search

drivers download

drivers list

drivers activate

drivers connectionprops

​drivers search

​drivers download

​drivers list

​drivers activate

​drivers connectionprops

drivers search

drivers download

drivers list

drivers activate

drivers connectionprops