This is an automated email from the ASF dual-hosted git repository.
rusackas pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/superset.git
The following commit(s) were added to refs/heads/master by this push:
new e5579ed939 feat(database): add cloudflare d1 support (#36348)
e5579ed939 is described below
commit e5579ed93961775ee07b361407aab4a3cdf00bd3
Author: Chad Rossouw <[email protected]>
AuthorDate: Fri Dec 12 15:48:22 2025 -0500
feat(database): add cloudflare d1 support (#36348)
Co-authored-by: danielalyoshin <[email protected]>
Co-authored-by: Shreyas Rao <[email protected]>
Co-authored-by: Murphy Lee <[email protected]>
---
docs/docs/configuration/databases.mdx | 15 +++++++++++++++
pyproject.toml | 5 +++++
2 files changed, 20 insertions(+)
diff --git a/docs/docs/configuration/databases.mdx
b/docs/docs/configuration/databases.mdx
index 9201adfcb3..7ec4997c18 100644
--- a/docs/docs/configuration/databases.mdx
+++ b/docs/docs/configuration/databases.mdx
@@ -54,6 +54,7 @@ are compatible with Superset.
| [Ascend.io](/docs/configuration/databases#ascendio) |
`pip install impyla`
|
`ascend://{username}:{password}@{hostname}:{port}/{database}?auth_mechanism=PLAIN;use_ssl=true`
|
| [Azure MS SQL](/docs/configuration/databases#sql-server) |
`pip install pymssql`
|
`mssql+pymssql://UserName@presetSQL:[email protected]:1433/TestSchema`
|
| [ClickHouse](/docs/configuration/databases#clickhouse) |
`pip install clickhouse-connect`
| `clickhousedb://{username}:{password}@{hostname}:{port}/{database}`
|
+| [Cloudflare D1](/docs/configuration/databases#cloudflare-d1)
| `pip install superset-engine-d1` or `pip install apache_superset[d1]`
|
`d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id}`
|
| [CockroachDB](/docs/configuration/databases#cockroachdb) |
`pip install cockroachdb`
| `cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable`
|
| [Couchbase](/docs/configuration/databases#couchbase) | `pip
install couchbase-sqlalchemy`
|
`couchbase://{username}:{password}@{hostname}:{port}?truststorepath={ssl
certificate path}`
|
| [CrateDB](/docs/configuration/databases#cratedb) |
`pip install sqlalchemy-cratedb`
| `crate://{username}:{password}@{hostname}:{port}`, often useful:
`?ssl=true/false` or `?schema=testdrive`.
|
@@ -359,6 +360,20 @@ uses the default user without a password (and doesn't
encrypt the connection):
clickhousedb://localhost/default
```
+#### Cloudflare D1
+
+To use Cloudflare D1 with superset, install the
[superset-engine-d1](https://github.com/sqlalchemy-cf-d1/superset-engine-d1)
library.
+
+```
+pip install superset-engine-d1
+```
+
+The expected connection string is formatted as follows:
+
+```
+d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id}
+```
+
#### CockroachDB
The recommended connector library for CockroachDB is
diff --git a/pyproject.toml b/pyproject.toml
index e115bd3ea1..fa5875dafa 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -123,6 +123,11 @@ bigquery = [
clickhouse = ["clickhouse-connect>=0.5.14, <1.0"]
cockroachdb = ["cockroachdb>=0.3.5, <0.4"]
crate = ["sqlalchemy-cratedb>=0.40.1, <1"]
+d1 = [
+ "superset-engine-d1>=0.1.0",
+ "sqlalchemy-d1>=0.1.0",
+ "dbapi-d1>=0.1.0",
+]
databend = ["databend-sqlalchemy>=0.3.2, <1.0"]
databricks = [
"databricks-sql-connector==4.1.2",
