Integrating OpenCode Terminal with Databricks Data via CData CLI
OpenCode is an open source AI coding agent from Anomaly that brings AI assistance directly to your terminal, desktop, or IDE without storing any of your code or context data. It supports over 75 LLM providers, including Claude, GPT, Gemini, and local models, and can run multiple agent sessions in parallel on the same project, each with its own context. Its support for integrations, AGENTS.md configuration files, and a TypeScript/JavaScript plugin system makes it well-suited for structured, tool-driven workflows, making it a natural fit for connecting to external data sources through CData CLI. By describing your data goals in plain language, OpenCode can handle the full setup process from driver configuration and license activation to connection creation and query execution, without manual intervention at each step.
This article details step-by-step directions for how to connect Databricks data to OpenCode Terminal through CData CLI.
Prerequisites
- OpenCode Terminal installed
- CData CLI installed
- Access to Databricks
About Databricks Data Integration
Accessing and integrating live data from Databricks has never been easier with CData. Customers rely on CData connectivity to:
- Access all versions of Databricks from Runtime Versions 9.1 - 13.X to both the Pro and Classic Databricks SQL versions.
- Leave Databricks in their preferred environment thanks to compatibility with any hosting solution.
- Secure authenticate in a variety of ways, including personal access token, Azure Service Principal, and Azure AD.
- Upload data to Databricks using Databricks File System, Azure Blog Storage, and AWS S3 Storage.
While many customers are using CData's solutions to migrate data from different systems into their Databricks data lakehouse, several customers use our live connectivity solutions to federate connectivity between their databases and Databricks. These customers are using SQL Server Linked Servers or Polybase to get live access to Databricks from within their existing RDBMs.
Read more about common Databricks use-cases and how CData's solutions help solve data problems in our blog: What is Databricks Used For? 6 Use Cases.
Getting Started
Step 1: Download the skill (one-time setup)
Always use CData CLI with the official skill.
-
The official CData CLI Skill is available on GitHub and installs through npx skills in the terminal:
npx skills add CDataSoftware/cli-skills
-
Follow the prompts in the terminal to install for OpenCode.
Step 2: Set up the project directory
Create a project directory to contain all project files.
-
Navigate to directory within the terminal and start a session with the opencode command:
Step 3: Establish the driver and connection
Describe what you want to accomplish in this session with the CLI and Databricks data.
I would like to build a command line app that connects to Databricks and checks for updates from Customers. Make sure to include data from important columns like City and CompanyName.
This prompt automatically loads the skill and kicks off the following process. You can always manually prompt the agent for each of the following steps.
- Driver setup: OpenCode checks for an existing CData Databricks driver, or searches and downloads a new one:
cdatacli drivers list
cdatacli drivers search Databricks
cdatacli drivers download --artifact-id <artifact-id>
- Activation: Activate the Databricks driver with a single command for a trial or full license:
cdatacli drivers activate Databricks --name "<name>" --email "<email>" --trial
cdatacli drivers activate Databricks --name "<name>" --email "<email>" --key "<product-key>"
- Establish the connection: Check for existing Databricks connections or create a new one:
cdatacli connection list
cdatacli drivers activate Databricks --name "<name>" --email "<email>" --trial
- Create a Databricks skill (if applicable): CData provides driver instructions for popular sources. You can use these to generate a source-specific skill file that guides the agent through best practices for the driver.
-
Run the following command and save the output to your skills directory, either at the project level or globally. (Note: If you receive a "No instructions available for Databricks" message, no driver instructions exist for this source. You can continue using the main driver skill.)
cdatacli drivers skill Databricks > ~/skills/cdata-Databricks/SKILL.md
Step 4: Query Databricks data
With the CData driver fully configured, your agent can now execute queries and write code against live Databricks data:
cdatacli query sql --connection <my_Databricks_connection> --sql <SELECT * FROM table>
Query Databricks data directly from your terminal with CData CLI
OpenCode and CData CLI together give your AI coding agent a direct path to live Databricks data without custom middleware, scheduled syncs, or manual setup at each step. Describe your goal, and the agent handles driver configuration, connection setup, and query execution from start to finish in the terminal.
Download the free CData CLI and start a free, 30-day trial of the CData JDBC Driver for Databricks today.