Metadata-Version: 2.4
Name: rivetsql-databricks
Version: 0.1.1
Summary: Databricks and Unity Catalog plugin for Rivet SQL
Project-URL: Homepage, https://github.com/rivetsql/rivetsql
Project-URL: Repository, https://github.com/rivetsql/rivetsql
Author: Rivet Contributors
License-Expression: MIT
Keywords: data-pipeline,databricks,rivet,sql
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Requires-Python: >=3.11
Requires-Dist: pyarrow>=14.0
Requires-Dist: requests>=2.28
Requires-Dist: rivetsql>=0.1.0
Description-Content-Type: text/markdown

<div align="center">
  <h1>rivetsql-databricks</h1>
  <p><b>Databricks engine and Unity Catalog plugin for Rivet.</b></p>

  [![PyPI version](https://img.shields.io/pypi/v/rivetsql-databricks)](https://pypi.org/project/rivetsql-databricks/)
  [![Python versions](https://img.shields.io/pypi/pyversions/rivetsql-databricks)](https://pypi.org/project/rivetsql-databricks/)
  [![License](https://img.shields.io/github/license/rivetsql/rivetsql)](https://github.com/rivetsql/rivetsql/blob/main/LICENSE)
</div>

---

Compute engine via the Databricks Statement Execution API and two catalog plugins: `unity` for Unity Catalog REST API and `databricks` for Databricks-managed catalogs.

---

## ⚡ Install

```sh
pip install rivetsql[databricks]
```

---

## 🔧 Configuration

```yaml
# profiles.yaml
default:
  engines:
    - name: dbx
      type: databricks
      options:
        warehouse_id: abc123def456
        workspace_url: https://my-workspace.cloud.databricks.com
        token: ${DATABRICKS_TOKEN}
      catalogs: [unity_catalog]
  catalogs:
    - name: unity_catalog
      type: unity
      options:
        workspace_url: https://my-workspace.cloud.databricks.com
        token: ${DATABRICKS_TOKEN}
        catalog: main
        schema: default
```

---

## ✨ Capabilities

| Feature | Supported |
|---|---|
| Compute engine | ✅ |
| Unity Catalog | ✅ |
| Databricks catalog | ✅ |
| Read | ✅ |
| Write | ✅ |
| List tables | ✅ |
| Schema introspection | ✅ |
| Test connection | ✅ |
| Cross-joint adapter | ✅ |

---

## 📚 Documentation

Full docs at **[rivetsql.github.io/rivet/plugins/unity](https://rivetsql.github.io/rivet/plugins/unity/)**

---

<div align="center">
  <i>Part of the <a href="https://github.com/rivetsql/rivetsql">Rivet</a> framework.</i>
</div>
