> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cli.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# drivers

> Commands for managing CData JDBC drivers.

The `drivers` command group lets you list available drivers, activate licenses, and inspect connection properties.

***

## drivers list

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

```bash theme={null}
cdatacli drivers list
```

**Output**

```json theme={null}
[ {
  "activated" : true,
  "version" : "26.0.9644.0",
  "product" : "CData JDBC Driver for Salesforce 2026",
  "name" : "Salesforce",
  "path" : "./lib/cdata.jdbc.salesforce.jar"
}, {
  "activated" : false,
  "version" : "26.0.9644.0",
  "product" : "CData JDBC Driver for Snowflake 2026",
  "name" : "Snowflake",
  "path" : "./lib/cdata.jdbc.snowflake.jar"
} ]
```

***

## drivers activate

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

```bash theme={null}
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:

```bash theme={null}
cdatacli drivers activate Salesforce --name "John Doe" --email you@example.com --key XXXX-XXXX-XXXX-XXXX
```

Start a free trial:

```bash theme={null}
cdatacli drivers activate Salesforce --name "John Doe" --email you@example.com --trial
```

***

## drivers connectionprops

Lists the connection properties available for a driver, including their descriptions and default values. By default, this lists only the most important properties. Add the `--full` flag to list all properties.

```bash theme={null}
cdatacli drivers connectionprops <driver-name> [--full]
```

**Arguments and options**

| Argument/Option | Description                                                            | Required |
| --------------- | ---------------------------------------------------------------------- | -------- |
| `<driver-name>` | Name of the driver                                                     | Yes      |
| `--full`        | List all connection properties instead of only the most important ones | No       |

**Examples**

List the most important connection properties:

```bash theme={null}
cdatacli drivers connectionprops Salesforce
```

List all connection properties:

```bash theme={null}
cdatacli drivers connectionprops Salesforce --full
```

**Output**

```json theme={null}
[
  {
    "name": "User",
    "description": "The Salesforce user account used to authenticate.",
    "required": true,
    "default": ""
  },
  {
    "name": "Password",
    "description": "The password for the Salesforce user account.",
    "required": true,
    "default": ""
  }
]
```
