Your data stays put.
Read existing S3-backed Delta tables directly. No export pipeline or second copy to maintain for your evaluation.
YOUR DATA PLATFORM. ANOTHER COMPUTE OPTION.
An open-source SQL engine for your existing Delta tables. Keep your Databricks identity. Run supported queries on infrastructure you control.
Self-hosted. MIT licensed. No data migration.
01 / KEEP WHAT WORKS
Your tables and catalog already exist. HarborSQL gives you another place to execute supported SQL, alongside your Databricks SQL Warehouse.
Read existing S3-backed Delta tables directly. No export pipeline or second copy to maintain for your evaluation.
HarborSQL uses the caller’s Databricks token to request table access and temporary credentials from Unity Catalog.
Run a self-hosted DataFusion engine. Choose the infrastructure and move only the workloads that pass your checks.
02 / FIND YOUR FIRST WORKLOAD
Evaluate one query before moving a workload. Keep your existing warehouse available for everything else.
Try supported SELECT queries from your Python or JDBC application against the same Delta tables.
Connect a client →Compare query results and column metadata with SQL Warehouse before switching an internal workload.
Run the comparison →Write-query support is underway, targeting dbt-databricks without model or adapter changes. Compatibility is not yet verified.
Follow development ↗03 / EVIDENCE BEFORE PROMISES
Open code, reproducible checks, and explicit boundaries. HarborSQL is pre-1.0 software, not a complete Databricks replacement.
See where HarborSQL fits →Run the same query through both engines on an existing Delta table. Compare the results before moving a workload.
COMPATIBILITYCheck driver versions, authentication, and required settings before evaluating your application.
REPRODUCIBLE BENCHMARKSReview hardware, methodology, datasets, and limitations. Measure your workload on your infrastructure.
FROM READING TO RUNNING
Start a local engine, connect your client, and compare a read against your existing SQL Warehouse.
You’ll need a Databricks workspace, an S3-backed Delta table, external data access enabled, and the required Unity Catalog grants. Replace the image tag and workspace host below.
Full setup and prerequisites →export TAG="<version>"
docker run --rm \
-p 127.0.0.1:1992:1992 \
-e HARBORSQL_BIND_ADDR="0.0.0.0:1992" \
-e HARBORSQL_DATABRICKS_HOST="https://<workspace-host>" \
ghcr.io/harborsql/harborsql:$TAG
A FEW IMPORTANT DETAILS
No. It provides alternative compute for supported SQL workloads. Your Databricks workspace and Unity Catalog remain in place. It does not replace the full platform or managed warehouse operations.
No data copy is needed for supported reads. HarborSQL reads your existing Delta tables on S3 using temporary table credentials requested through Unity Catalog.
HarborSQL supports a focused Databricks SQL connector and JDBC protocol surface. It is not blanket compatibility with all SQL, ODBC, or BI tools. Read the SQL compatibility notes and test your client.
Not as a verified supported workflow. Write support is in development, targeting existing dbt-databricks projects without model or adapter changes. That target is not a compatibility guarantee.
Table access uses your Databricks identity and Unity Catalog credentials. That does not establish full support for row filters, column masks, views, or every governance feature. Review your policy requirements before moving a workload.
You operate the HarborSQL service and its compute, networking, TLS, monitoring, and upgrades. The software is MIT licensed; infrastructure and operational costs still apply.
YOUR NEXT QUERY, YOUR COMPUTE.