What problem does it solve?
Developers and engineers need a concise, practical reference to authenticate, configure, and operate Databricks programmatically from Python while avoiding common pitfalls such as blocking async event loops or misconfiguring credentials.
Core Features & Use Cases
- Environment and installation patterns for databricks-sdk and databricks-connect, plus required CLI versions and config locations.
- Authentication examples for environment variables, named profiles, tokens, and Azure service principals.
- Code patterns for clusters, jobs, SQL statement execution, warehouses, Unity Catalog tables and volumes, model serving, and vector search.
- Guidance for async applications (wrap blocking SDK calls with asyncio.to_thread), direct REST calls via api_client.do for new endpoints, and long-running operation handling with wait patterns.
- Use Cases: building FastAPI backends that call Databricks, running jobs and pipelines programmatically, querying SQL warehouses and converting results to dataframes, and managing serving endpoints for models.
Quick Start
Use the databricks-python-sdk guide to list clusters and run a sample SQL query using a named profile 'MY_PROFILE'.