avibrazil / sqlalchemy-databricks

SQLAlchemy dialect for Databricks

sqlalchemy-databricks

A SQLAlchemy Dialect for Databricks workspace and sql analytics clusters using the officially supported databricks-sql-connector dbapi.

Installation

Install using pip.

pip install sqlalchemy-databricks

Usage

Installing registers the databricks+connector dialect/driver with SQLAlchemy. Fill in the required information when passing the engine URL. The http path can be for either a workspace or sql analytics cluster.

from sqlalchemy import *
from sqlalchemy.engine import create_engine


engine = create_engine(
    "databricks+connector://token:<databricks_token>@<databricks_host>:443/<database_or_schema_name>",
    connect_args={
        "http_path": "<cluster_http_path>",
    },
)

logs = Table("my_table", MetaData(bind=engine), autoload=True)
print(select([func.count("*")], from_obj=logs).scalar())

In the above example:

• databricks_host is the Databricks instance host name.
• cluster_http_path is the HTTP Path from your Connection Details screen:
  • For a Databricks SQL Warehouse the format is /sql/1.0/endpoints/***************
  • For a Databricks Runtime interactive cluster the format is /sql/protocolv1/o/**************/****-*******-*******
• databricks_token is the Databricks Personal Access Token for the account that will execute commands and queries