You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@superset.apache.org by ha...@apache.org on 2026/08/31 08:30:09 UTC
(superset) 02/02: chore(docs): regenerate docs and DB metadata
This is an automated email from the ASF dual-hosted git repository.
hainenber pushed a commit to branch remove-deprecated-ascend-db-integration
in repository https://gitbox.apache.org/repos/asf/superset.git
commit 75e4014ac1455a684066291906bc68bb24093361
Author: hainenber <do...@gmail.com>
AuthorDate: Mon Aug 31 15:29:48 2026 +0700
chore(docs): regenerate docs and DB metadata
Signed-off-by: hainenber <do...@gmail.com>
---
docs/developer_docs/components/TODO.md | 13 +-
.../components/design-system/metadatabar.mdx | 2 +-
docs/developer_docs/components/ui/button.mdx | 6 +
docs/developer_docs/components/ui/select.mdx | 14 +-
docs/src/data/databases.json | 10004 ++++++++-----------
5 files changed, 4063 insertions(+), 5976 deletions(-)
diff --git a/docs/developer_docs/components/TODO.md b/docs/developer_docs/components/TODO.md
index c3564104795..7d6233dfe70 100644
--- a/docs/developer_docs/components/TODO.md
+++ b/docs/developer_docs/components/TODO.md
@@ -10,20 +10,19 @@ Future phases will add support for these sources.
## Summary
-- **Total skipped:** 19 story files
+- **Total skipped:** 22 story files
- **Reason:** Import path resolution not yet implemented
## Skipped by Source
### App Components
-9 components
+8 components
- [ ] `superset-frontend/src/components/AlteredSliceTag/AlteredSliceTag.stories.tsx`
- [ ] `superset-frontend/src/components/Chart/DrillDetail/DrillDetailTableControls.stories.tsx`
- [ ] `superset-frontend/src/components/CopyToClipboard/CopyToClipboard.stories.tsx`
- [ ] `superset-frontend/src/components/ErrorMessage/ErrorAlert.stories.tsx`
-- [ ] `superset-frontend/src/components/FacePile/FacePile.stories.tsx`
- [ ] `superset-frontend/src/components/FilterableTable/FilterableTable.stories.tsx`
- [ ] `superset-frontend/src/components/RowCountLabel/RowCountLabel.stories.tsx`
- [ ] `superset-frontend/src/components/Tag/Tag.stories.tsx`
@@ -31,9 +30,10 @@ Future phases will add support for these sources.
### Dashboard Components
-2 components
+3 components
- [ ] `superset-frontend/src/dashboard/components/AnchorLink/AnchorLink.stories.tsx`
+- [ ] `superset-frontend/src/dashboard/components/PropertiesModal/sections/AccessSection.stories.tsx`
- [ ] `superset-frontend/src/dashboard/components/nativeFilters/FilterBar/FilterControls/FilterDivider.stories.tsx`
### Explore Components
@@ -47,10 +47,13 @@ Future phases will add support for these sources.
### Feature Components
-2 components
+5 components
- [ ] `superset-frontend/src/features/datasets/AddDataset/DatasetPanel/DatasetPanel.stories.tsx`
- [ ] `superset-frontend/src/features/home/LanguagePicker.stories.tsx`
+- [ ] `superset-frontend/src/features/subjects/SubjectPicker/SubjectPicker.stories.tsx`
+- [ ] `superset-frontend/src/features/subjects/SubjectPile/SubjectPile.stories.tsx`
+- [ ] `superset-frontend/src/features/subjects/SubjectSelectLabel/SubjectSelectLabel.stories.tsx`
### Filter Components
diff --git a/docs/developer_docs/components/design-system/metadatabar.mdx b/docs/developer_docs/components/design-system/metadatabar.mdx
index b18314f177c..2dcfa939f3c 100644
--- a/docs/developer_docs/components/design-system/metadatabar.mdx
+++ b/docs/developer_docs/components/design-system/metadatabar.mdx
@@ -158,7 +158,7 @@ function FullMetadata() {
| `createdBy` | `string` | `"Jane Smith"` | - |
| `modifiedBy` | `string` | `"Jane Smith"` | - |
| `description` | `string` | `"To preview the list of dashboards go to More settings."` | - |
-| `items` | `any` | `[{"type":"sql","title":"Click to view query"},{"type":"editor","createdBy":"Jane Smith","editors":["John Doe","Mary Wilson"],"createdOn":"a week ago"},{"type":"lastModified","value":"a week ago","modifiedBy":"Jane Smith"},{"type":"tags","values":["management","research","poc"]},{"type":"dashboards","title":"Added to 3 dashboards","description":"To preview the list of dashboards go to More settings."}]` | Items displayed in the metadata bar. The `editor` type shows ed [...]
+| `items` | `any` | `[{"type":"sql","title":"Click to view query"},{"type":"editor","createdBy":"Jane Smith","editors":["John Doe","Mary Wilson"],"createdOn":"a week ago"},{"type":"lastModified","value":"a week ago","modifiedBy":"Jane Smith"},{"type":"tags","values":["management","research","poc"]},{"type":"dashboards","title":"Added to 3 dashboards","description":"To preview the list of dashboards go to More settings."}]` | - |
## Import
diff --git a/docs/developer_docs/components/ui/button.mdx b/docs/developer_docs/components/ui/button.mdx
index 0b704f4b666..cbd9cad25c2 100644
--- a/docs/developer_docs/components/ui/button.mdx
+++ b/docs/developer_docs/components/ui/button.mdx
@@ -78,6 +78,12 @@ The Button component from Superset's UI library.
type: "text",
description: "The button text or content."
},
+ {
+ name: "styleConfig",
+ label: "Style Config",
+ type: "object",
+ description: "Optional visual overrides (controlHeight, paddingInline, fontSize, fontWeight, borderRadius, ctaMinWidth, ctaMinHeight, iconGap)."
+ },
{
name: "target",
label: "Target",
diff --git a/docs/developer_docs/components/ui/select.mdx b/docs/developer_docs/components/ui/select.mdx
index 262196d4ccc..8c9c985a603 100644
--- a/docs/developer_docs/components/ui/select.mdx
+++ b/docs/developer_docs/components/ui/select.mdx
@@ -34,7 +34,6 @@ A versatile select component supporting single and multi-select modes, search fi
component="Select"
props={{
mode: "single",
- placeholder: "Select ...",
showSearch: true,
allowNewOptions: false,
allowClear: false,
@@ -101,12 +100,6 @@ A versatile select component supporting single and multi-select modes, search fi
],
description: "Whether to allow selection of a single option or multiple."
},
- {
- name: "placeholder",
- label: "Placeholder",
- type: "text",
- description: "Placeholder text when no option is selected."
- },
{
name: "showSearch",
label: "Show Search",
@@ -154,6 +147,12 @@ A versatile select component supporting single and multi-select modes, search fi
label: "Max Tag Count",
type: "number",
description: "Maximum number of tags to display in multiple mode before showing an overflow count."
+ },
+ {
+ name: "placeholder",
+ label: "Placeholder",
+ type: "text",
+ description: "Placeholder text when no option is selected."
}
]}
/>
@@ -283,7 +282,6 @@ function OneLineDemo() {
| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `mode` | `string` | `"single"` | Whether to allow selection of a single option or multiple. |
-| `placeholder` | `string` | `"Select ..."` | Placeholder text when no option is selected. |
| `showSearch` | `boolean` | `true` | Whether to show a search input for filtering. |
| `allowNewOptions` | `boolean` | `false` | Whether users can create new options by typing a value not in the list. |
| `allowClear` | `boolean` | `false` | Whether to show a clear button to reset the selection. |
diff --git a/docs/src/data/databases.json b/docs/src/data/databases.json
index e200d1d68f9..c1f62da6d5f 100644
--- a/docs/src/data/databases.json
+++ b/docs/src/data/databases.json
@@ -1,145 +1,132 @@
{
- "generated": "2026-04-17T17:08:35.132Z",
+ "generated": "2026-08-31T08:25:27.528Z",
"statistics": {
- "totalDatabases": 81,
- "withDocumentation": 81,
- "withConnectionString": 81,
- "withDrivers": 29,
+ "totalDatabases": 73,
+ "withDocumentation": 73,
+ "withConnectionString": 73,
+ "withDrivers": 37,
"withAuthMethods": 5,
- "supportsJoins": 75,
- "supportsSubqueries": 78,
- "supportsDynamicSchema": 29,
- "supportsCatalog": 20,
+ "supportsJoins": 68,
+ "supportsSubqueries": 70,
+ "supportsDynamicSchema": 28,
+ "supportsCatalog": 18,
"averageScore": 53,
"maxScore": 201,
"byCategory": {
- "Cloud - AWS": ["Amazon Athena", "Amazon DynamoDB", "Amazon Redshift"],
- "Query Engines": [
- "Amazon Athena",
- "Apache DataFusion",
- "Apache Drill",
- "Apache Hive",
- "Apache Impala",
- "Apache Spark SQL",
- "Databricks Interactive Cluster",
- "Denodo",
- "Dremio",
- "Presto",
- "Trino"
+ "Other Databases": [
+ "Arc",
+ "Shillelagh",
+ "Superset meta database"
],
"Proprietary": [
- "Amazon Athena",
- "Amazon DynamoDB",
- "Amazon Redshift",
"Arc",
- "Azure Data Explorer",
- "Azure Synapse",
+ "Amazon Athena",
+ "Google BigQuery",
"Databend",
+ "Google Datastore",
+ "IBM Db2",
"Denodo",
"Dremio",
+ "Amazon DynamoDB",
"Exasol",
"Firebolt",
- "Google BigQuery",
- "Google Datastore",
+ "SAP HANA",
"Hologres",
- "IBM Db2",
"IBM Db2 for i",
- "IBM Netezza Performance Server",
- "Microsoft SQL Server",
+ "Azure Data Explorer",
"MongoDB",
+ "Microsoft SQL Server",
+ "Azure Synapse",
+ "IBM Netezza Performance Server",
"Ocient",
"Oracle",
- "SAP HANA",
- "SAP Sybase",
+ "Amazon Redshift",
"SingleStore",
"Snowflake",
+ "SAP Sybase",
"Teradata",
"Vertica"
],
- "Search & NoSQL": [
+ "Cloud - AWS": [
+ "Amazon Athena",
"Amazon DynamoDB",
- "Apache Solr",
- "Couchbase",
- "Elasticsearch",
- "Google Datastore",
- "MongoDB",
- "Parseable"
- ],
- "Analytical Databases": [
- "Amazon Redshift",
- "Apache Doris",
- "Apache Kylin",
- "Apache Phoenix",
- "Azure Data Explorer",
- "Azure Synapse",
- "ClickHouse",
- "Databend",
- "Databricks",
- "DuckDB",
- "Exasol",
- "Firebolt",
- "Google BigQuery",
- "Hologres",
- "MotherDuck",
- "Ocient",
- "RisingWave",
- "SingleStore",
- "Snowflake",
- "StarRocks",
- "TimescaleDB",
- "Vertica"
+ "Amazon Redshift"
],
- "Apache Projects": [
+ "Query Engines": [
+ "Amazon Athena",
+ "Databricks Interactive Cluster",
"Apache DataFusion",
- "Apache Doris",
+ "Denodo",
+ "Dremio",
"Apache Drill",
- "Apache Druid",
"Apache Hive",
"Apache Impala",
- "Apache IoTDB",
- "Apache Kylin",
- "Apache Phoenix",
- "Apache Pinot",
- "Apache Solr",
+ "Presto",
"Apache Spark SQL",
- "Databricks Interactive Cluster"
+ "Trino"
],
- "Open Source": [
- "Apache DataFusion",
- "Apache Doris",
- "Apache Drill",
- "Apache Druid",
- "Apache Hive",
- "Apache Impala",
- "Apache IoTDB",
- "Apache Kylin",
- "Apache Phoenix",
- "Apache Pinot",
- "Apache Solr",
- "Apache Spark SQL",
- "Aurora MySQL",
+ "Traditional RDBMS": [
"Aurora MySQL (Data API)",
+ "Aurora PostgreSQL (Data API)",
+ "Aurora MySQL",
"Aurora PostgreSQL",
+ "CockroachDB",
+ "Cloudflare D1",
+ "IBM Db2",
+ "Firebird",
+ "Greenplum",
+ "SAP HANA",
+ "IBM Db2 for i",
+ "MariaDB",
+ "MonetDB",
+ "Microsoft SQL Server",
+ "MySQL",
+ "IBM Netezza Performance Server",
+ "OceanBase",
+ "Oracle",
+ "PostgreSQL",
+ "SQLite",
+ "SAP Sybase",
+ "Teradata",
+ "YDB",
+ "YugabyteDB"
+ ],
+ "Open Source": [
+ "Aurora MySQL (Data API)",
"Aurora PostgreSQL (Data API)",
+ "Aurora MySQL",
+ "Aurora PostgreSQL",
"ClickHouse",
"CockroachDB",
"Couchbase",
"CrateDB",
"Databricks Interactive Cluster",
+ "Apache DataFusion",
+ "Apache Doris",
+ "Apache Drill",
+ "Apache Druid",
"DuckDB",
"Elasticsearch",
"Firebird",
"Greenplum",
+ "Apache Hive",
+ "Apache Impala",
+ "Apache IoTDB",
+ "Apache Kylin",
"MariaDB",
"MonetDB",
"MySQL",
"OceanBase",
"Parseable",
+ "Apache Phoenix",
+ "Apache Pinot",
"PostgreSQL",
"Presto",
"RisingWave",
- "SQLite",
"Shillelagh",
+ "Apache Solr",
+ "Apache Spark SQL",
+ "SQLite",
"StarRocks",
"TDengine",
"TimescaleDB",
@@ -147,138 +134,179 @@
"YDB",
"YugabyteDB"
],
+ "Cloud - Google": [
+ "Google BigQuery",
+ "Google Datastore",
+ "Google Sheets"
+ ],
+ "Analytical Databases": [
+ "Google BigQuery",
+ "ClickHouse",
+ "Databend",
+ "Databricks",
+ "Apache Doris",
+ "DuckDB",
+ "MotherDuck",
+ "Exasol",
+ "Firebolt",
+ "Hologres",
+ "Azure Data Explorer",
+ "Apache Kylin",
+ "Azure Synapse",
+ "Ocient",
+ "Apache Phoenix",
+ "Amazon Redshift",
+ "RisingWave",
+ "SingleStore",
+ "Snowflake",
+ "StarRocks",
+ "TimescaleDB",
+ "Vertica"
+ ],
+ "Search & NoSQL": [
+ "Couchbase",
+ "Google Datastore",
+ "Amazon DynamoDB",
+ "Elasticsearch",
+ "MongoDB",
+ "Parseable",
+ "Apache Solr"
+ ],
"Time Series Databases": [
+ "CrateDB",
"Apache Druid",
"Apache IoTDB",
"Apache Pinot",
- "CrateDB",
"TDengine"
],
- "Other Databases": [
- "Arc",
- "Azure Data Explorer (KQL)",
- "ClickHouse (sqlalchemy)",
- "Databend (legacy)",
- "Databricks (legacy)",
- "Databricks SQL Endpoint",
- "OpenSearch (OpenDistro)",
- "Shillelagh",
- "Superset meta database",
- "base"
- ],
"Cloud Data Warehouses": [
- "Azure Synapse",
"Cloudflare D1",
"Databend",
"Databricks",
+ "MotherDuck",
"Firebolt",
"Hologres",
- "MotherDuck",
+ "Azure Synapse",
"Snowflake",
"YugabyteDB"
],
"Hosted Open Source": [
"Cloudflare D1",
"Databricks",
- "Google Sheets",
- "MotherDuck"
+ "MotherDuck",
+ "Google Sheets"
],
- "Traditional RDBMS": [
- "Aurora MySQL",
- "Aurora MySQL (Data API)",
- "Aurora PostgreSQL",
- "Aurora PostgreSQL (Data API)",
- "Cloudflare D1",
- "CockroachDB",
- "Firebird",
- "Greenplum",
- "IBM Db2",
- "IBM Db2 for i",
- "IBM Netezza Performance Server",
- "MariaDB",
- "Microsoft SQL Server",
- "MonetDB",
- "MySQL",
- "OceanBase",
- "Oracle",
- "PostgreSQL",
- "SAP HANA",
- "SAP Sybase",
- "SQLite",
- "Teradata",
- "YDB",
- "YugabyteDB"
+ "Apache Projects": [
+ "Databricks Interactive Cluster",
+ "Apache DataFusion",
+ "Apache Doris",
+ "Apache Drill",
+ "Apache Druid",
+ "Apache Hive",
+ "Apache Impala",
+ "Apache IoTDB",
+ "Apache Kylin",
+ "Apache Phoenix",
+ "Apache Pinot",
+ "Apache Solr",
+ "Apache Spark SQL"
],
- "Cloud - Azure": ["Azure Data Explorer"],
- "Cloud - Google": ["Google BigQuery", "Google Datastore", "Google Sheets"]
+ "Cloud - Azure": [
+ "Azure Data Explorer"
+ ]
}
},
"databases": {
- "Amazon Athena": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": true,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.athena",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": false,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 30,
+ "Arc": {
+ "engine": "arc",
+ "engine_name": "Arc",
+ "module": "arc",
+ "documentation": {
+ "description": "Arc is a data platform with multiple connection options.",
+ "categories": [
+ "OTHER",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "arc-superset-arrow"
+ ],
+ "connection_string": "arc+arrow://{api_key}@{hostname}:{port}/{database}",
+ "parameters": {
+ "api_key": "Arc API key",
+ "hostname": "Arc hostname",
+ "port": "Arc port",
+ "database": "Database name"
+ },
+ "drivers": [
+ {
+ "name": "Apache Arrow (Recommended)",
+ "pypi_package": "arc-superset-arrow",
+ "connection_string": "arc+arrow://{api_key}@{hostname}:{port}/{database}",
+ "is_recommended": true,
+ "notes": "Recommended for production. Provides 3-5x better performance using Apache Arrow IPC."
+ },
+ {
+ "name": "JSON",
+ "pypi_package": "arc-superset-dialect",
+ "connection_string": "arc+json://{api_key}@{hostname}:{port}/{database}",
+ "is_recommended": false
+ }
+ ],
+ "notes": "Arc supports multiple databases (schemas) within a single instance. Each Arc database appears as a schema in SQL Lab."
+ },
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 28,
"max_score": 201,
+ "joins": true,
+ "subqueries": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
+ },
+ "Amazon Athena": {
+ "engine": "amazon_athena",
+ "engine_name": "Amazon Athena",
+ "module": "athena",
"documentation": {
"description": "Amazon Athena is an interactive query service for analyzing data in S3 using SQL.",
"logo": "amazon-athena.jpg",
"homepage_url": "https://aws.amazon.com/athena/",
- "categories": ["Cloud - AWS", "Query Engines", "Proprietary"],
- "pypi_packages": ["pyathena[pandas]"],
+ "categories": [
+ "CLOUD_AWS",
+ "QUERY_ENGINES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "pyathena[pandas]"
+ ],
"connection_string": "awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}",
"drivers": [
{
@@ -308,7 +336,6 @@
}
],
"notes": "URL-encode special characters in s3_staging_dir (e.g., s3:// becomes s3%3A//).",
- "category": "Cloud - AWS",
"custom_errors": [
{
"regex_name": "SYNTAX_ERROR_REGEX",
@@ -316,20 +343,12 @@
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
}
]
},
- "engine": "awsathena",
- "engine_name": "Amazon Athena",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Amazon DynamoDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -345,91 +364,102 @@
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": true,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": true,
- "WEEK_ENDING_SUNDAY": true,
+ "WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.dynamodb",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 30,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": false,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 32,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Aurora MySQL (Data API)": {
+ "engine": "aurora_mysql_(data_api)",
+ "engine_name": "Aurora MySQL (Data API)",
+ "module": "aurora",
"documentation": {
- "description": "Amazon DynamoDB is a serverless NoSQL database with SQL via PartiQL.",
- "logo": "aws.png",
- "homepage_url": "https://aws.amazon.com/dynamodb/",
- "categories": ["Cloud - AWS", "Search & NoSQL", "Proprietary"],
- "pypi_packages": ["pydynamodb"],
- "connection_string": "dynamodb://{aws_access_key_id}:{aws_secret_access_key}@dynamodb.{region}.amazonaws.com:443?connector=superset",
+ "description": "MySQL is a popular open-source relational database.",
+ "logo": "mysql.png",
+ "homepage_url": "https://www.mysql.com/",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "mysqlclient"
+ ],
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
+ "default_port": 3306,
"parameters": {
- "aws_access_key_id": "AWS access key ID",
- "aws_secret_access_key": "AWS secret access key",
- "region": "AWS region (e.g., us-east-1)"
+ "username": "Database username",
+ "password": "Database password",
+ "host": "localhost, 127.0.0.1, IP address, or hostname",
+ "database": "Database name"
},
- "notes": "Uses PartiQL for SQL queries. Requires connector=superset parameter.",
- "docs_url": "https://github.com/passren/PyDynamoDB",
- "category": "Cloud - AWS"
+ "host_examples": [
+ {
+ "platform": "Localhost",
+ "host": "localhost or 127.0.0.1"
+ },
+ {
+ "platform": "Docker on Linux",
+ "host": "172.18.0.1"
+ },
+ {
+ "platform": "Docker on macOS",
+ "host": "docker.for.mac.host.internal"
+ },
+ {
+ "platform": "On-premise",
+ "host": "IP address or hostname"
+ }
+ ],
+ "drivers": [
+ {
+ "name": "mysqlclient",
+ "pypi_package": "mysqlclient",
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
+ "is_recommended": true,
+ "notes": "Recommended driver. May fail with caching_sha2_password auth."
+ },
+ {
+ "name": "mysql-connector-python",
+ "pypi_package": "mysql-connector-python",
+ "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
+ "is_recommended": false,
+ "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
+ }
+ ]
},
- "engine": "dynamodb",
- "engine_name": "Amazon DynamoDB",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Amazon Redshift": {
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": true,
- "THIRTY_SECONDS": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
+ "WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -437,1825 +467,58 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.redshift",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 59,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 127,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 44,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Aurora PostgreSQL (Data API)": {
+ "engine": "aurora_postgresql_(data_api)",
+ "engine_name": "Aurora PostgreSQL (Data API)",
+ "module": "aurora",
"documentation": {
- "description": "Amazon Redshift is a fully managed data warehouse service.",
- "logo": "redshift.png",
- "homepage_url": "https://aws.amazon.com/redshift/",
- "categories": ["Cloud - AWS", "Analytical Databases", "Proprietary"],
- "pypi_packages": ["sqlalchemy-redshift"],
- "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
- "default_port": 5439,
+ "description": "PostgreSQL is an advanced open-source relational database.",
+ "logo": "postgresql.svg",
+ "homepage_url": "https://www.postgresql.org/",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "psycopg2"
+ ],
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
+ "default_port": 5432,
"parameters": {
"username": "Database username",
"password": "Database password",
- "host": "AWS Endpoint",
- "port": "Default 5439",
+ "host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL",
+ "port": "Default 5432",
"database": "Database name"
},
- "drivers": [
+ "notes": "The psycopg2 library comes bundled with Superset Docker images.",
+ "connection_examples": [
{
- "name": "psycopg2",
- "pypi_package": "psycopg2",
- "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
- "is_recommended": true
+ "description": "Basic connection",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
},
{
- "name": "redshift_connector",
- "pypi_package": "redshift_connector",
- "connection_string": "redshift+redshift_connector://{username}:{password}@{host}:5439/{database}",
- "is_recommended": false,
- "notes": "Supports IAM-based credentials for clusters and serverless."
+ "description": "With SSL required",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
- "authentication_methods": [
- {
- "name": "IAM Credentials (Cluster)",
- "description": "Use IAM-based temporary database credentials for Redshift clusters",
- "requirements": "IAM role must have redshift:GetClusterCredentials permission",
- "connection_string": "redshift+redshift_connector://",
- "engine_parameters": {
- "connect_args": {
- "iam": true,
- "database": "<database>",
- "cluster_identifier": "<cluster_identifier>",
- "db_user": "<db_user>"
- }
- }
- },
- {
- "name": "IAM Role (Serverless)",
- "description": "Authenticate using the IAM role attached to the environment (EC2 instance profile, ECS task role, etc.). No credentials needed.",
- "requirements": "The attached IAM role must have redshift-serverless:GetCredentials and redshift-serverless:GetWorkgroup permissions.",
- "connection_string": "redshift+redshift_connector://",
- "engine_parameters": {
- "connect_args": {
- "iam": true,
- "is_serverless": true,
- "serverless_acct_id": "<aws account number>",
- "serverless_work_group": "<redshift work group>",
- "database": "<database>",
- "user": "IAMR:<superset iam role name>"
- }
- }
- },
- {
- "name": "IAM Access Key (Serverless)",
- "description": "Authenticate using explicit AWS access key and secret. Suitable for local development or CI environments without an attached IAM role.",
- "requirements": "The IAM user must have redshift-serverless:GetCredentials and redshift-serverless:GetWorkgroup permissions.",
- "connection_string": "redshift+redshift_connector://",
- "engine_parameters": {
- "connect_args": {
- "iam": true,
- "is_serverless": true,
- "serverless_acct_id": "<aws account number>",
- "serverless_work_group": "<redshift work group>",
- "database": "<database>",
- "host": "<endpoint>",
- "port": 5439,
- "region": "<aws region>",
- "access_key_id": "<aws access key id>",
- "secret_access_key": "<aws secret access key>"
- }
- }
- }
- ],
- "category": "Cloud - AWS",
- "custom_errors": [
- {
- "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
- "message_template": "Either the username \"%(username)s\" or the password is incorrect.",
- "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
- "category": "Authentication",
- "description": "Access denied",
- "issue_codes": [1014, 1015],
- "invalid_fields": ["username", "password"]
- },
- {
- "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
- "message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
- "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
- "category": "Connection",
- "description": "Invalid hostname",
- "issue_codes": [1007],
- "invalid_fields": ["host"]
- },
- {
- "regex_name": "CONNECTION_PORT_CLOSED_REGEX",
- "message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
- "error_type": "CONNECTION_PORT_CLOSED_ERROR",
- "category": "Connection",
- "description": "Port closed or refused",
- "issue_codes": [1008],
- "invalid_fields": ["host", "port"]
- },
- {
- "regex_name": "CONNECTION_HOST_DOWN_REGEX",
- "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
- "error_type": "CONNECTION_HOST_DOWN_ERROR",
- "category": "Connection",
- "description": "Host unreachable",
- "issue_codes": [1009],
- "invalid_fields": ["host", "port"]
- },
- {
- "regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
- "message_template": "We were unable to connect to your database named \"%(database)s\". Please verify your database name and try again.",
- "error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
- "category": "Connection",
- "description": "Unknown database",
- "issue_codes": [1015],
- "invalid_fields": ["database"]
- }
- ]
- },
- "engine": "redshift",
- "engine_name": "Amazon Redshift",
- "engine_aliases": [],
- "default_driver": "psycopg2",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Doris": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.doris",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 64,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 79,
- "max_score": 201,
- "documentation": {
- "description": "Apache Doris is a high-performance real-time analytical database.",
- "logo": "doris.png",
- "homepage_url": "https://doris.apache.org/",
- "categories": [
- "Apache Projects",
- "Analytical Databases",
- "Open Source"
- ],
- "pypi_packages": ["pydoris"],
- "connection_string": "doris://{username}:{password}@{host}:{port}/{catalog}.{database}",
- "default_port": 9030,
- "parameters": {
- "username": "User name",
- "password": "Password",
- "host": "Doris FE Host",
- "port": "Doris FE port",
- "catalog": "Catalog name",
- "database": "Database name"
- },
- "category": "Apache Projects",
- "custom_errors": [
- {
- "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
- "message_template": "Either the username \"%(username)s\" or the password is incorrect.",
- "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
- "category": "Authentication",
- "description": "Access denied",
- "issue_codes": [1014, 1015],
- "invalid_fields": ["username", "password"]
- },
- {
- "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
- "message_template": "Unknown Doris server host \"%(hostname)s\".",
- "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
- "category": "Connection",
- "description": "Invalid hostname",
- "issue_codes": [1007],
- "invalid_fields": ["host"]
- },
- {
- "regex_name": "CONNECTION_HOST_DOWN_REGEX",
- "message_template": "The host \"%(hostname)s\" might be down and can't be reached.",
- "error_type": "CONNECTION_HOST_DOWN_ERROR",
- "category": "Connection",
- "description": "Host unreachable",
- "issue_codes": [1009],
- "invalid_fields": ["host", "port"]
- },
- {
- "regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
- "message_template": "Unable to connect to database \"%(database)s\".",
- "error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
- "category": "Connection",
- "description": "Unknown database",
- "issue_codes": [1015],
- "invalid_fields": ["database"]
- },
- {
- "regex_name": "SYNTAX_ERROR_REGEX",
- "message_template": "Please check your query for syntax errors near \"%(server_error)s\". Then, try running your query again.",
- "error_type": "SYNTAX_ERROR",
- "category": "Query",
- "description": "SQL syntax error",
- "issue_codes": [1030]
- }
- ]
- },
- "engine": "pydoris",
- "engine_name": "Apache Doris",
- "engine_aliases": ["doris"],
- "default_driver": "pydoris",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Apache Drill": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.drill",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": true,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 50,
- "max_score": 201,
- "documentation": {
- "description": "Apache Drill is a schema-free SQL query engine for Hadoop and NoSQL.",
- "logo": "apache-drill.png",
- "homepage_url": "https://drill.apache.org/",
- "categories": ["Apache Projects", "Query Engines", "Open Source"],
- "pypi_packages": ["sqlalchemy-drill"],
- "connection_string": "drill+sadrill://{username}:{password}@{host}:{port}/{storage_plugin}?use_ssl=True",
- "default_port": 8047,
- "drivers": [
- {
- "name": "SQLAlchemy (REST)",
- "pypi_package": "sqlalchemy-drill",
- "connection_string": "drill+sadrill://{username}:{password}@{host}:{port}/{storage_plugin}?use_ssl=True",
- "is_recommended": true
- },
- {
- "name": "JDBC",
- "pypi_package": "sqlalchemy-drill",
- "connection_string": "drill+jdbc://{username}:{password}@{host}:{port}",
- "is_recommended": false,
- "notes": "Requires Drill JDBC Driver installation.",
- "docs_url": "https://drill.apache.org/docs/using-the-jdbc-driver/"
- },
- {
- "name": "ODBC",
- "pypi_package": "sqlalchemy-drill",
- "is_recommended": false,
- "notes": "See Apache Drill documentation for ODBC setup.",
- "docs_url": "https://drill.apache.org/docs/installing-the-driver-on-linux/"
- }
- ],
- "connection_examples": [
- {
- "description": "Local embedded mode",
- "connection_string": "drill+sadrill://localhost:8047/dfs?use_ssl=False"
- }
- ],
- "category": "Apache Projects"
- },
- "engine": "drill",
- "engine_name": "Apache Drill",
- "engine_aliases": [],
- "default_driver": "sadrill",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Druid": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": true,
- "THIRTY_SECONDS": true,
- "MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": true,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": true,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.druid",
- "limit_method": 1,
- "limit_clause": true,
- "joins": false,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 47,
- "max_score": 201,
- "documentation": {
- "description": "Apache Druid is a high performance real-time analytics database.",
- "logo": "druid.png",
- "homepage_url": "https://druid.apache.org/",
- "categories": [
- "Apache Projects",
- "Time Series Databases",
- "Open Source"
- ],
- "pypi_packages": ["pydruid"],
- "connection_string": "druid://{username}:{password}@{host}:{port}/druid/v2/sql",
- "default_port": 9088,
- "parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "IP address or URL of the host",
- "port": "Default 9088"
- },
- "ssl_configuration": {
- "custom_certificate": "Add certificate in Root Certificate field. pydruid will automatically use https.",
- "disable_ssl_verification": {
- "engine_params": {
- "connect_args": {
- "scheme": "https",
- "ssl_verify_cert": false
- }
- }
- }
- },
- "advanced_features": {
- "aggregations": "Define common aggregations in datasource edit view under List Druid Column tab.",
- "post_aggregations": "Create metrics with postagg as Metric Type and provide valid JSON post-aggregation definition."
- },
- "notes": "A native Druid connector ships with Superset (behind DRUID_IS_ACTIVE flag) but SQLAlchemy connector via pydruid is preferred.",
- "compatible_databases": [
- {
- "name": "Imply",
- "description": "Imply is a fully-managed cloud platform and enterprise distribution built on Apache Druid. It provides real-time analytics with enterprise security and support.",
- "logo": "imply.png",
- "homepage_url": "https://imply.io/",
- "categories": [
- "Time Series Databases",
- "Cloud Data Warehouses",
- "Hosted Open Source"
- ],
- "pypi_packages": ["pydruid"],
- "connection_string": "druid://{username}:{password}@{host}/druid/v2/sql",
- "docs_url": "https://docs.imply.io/"
- }
- ],
- "category": "Apache Projects"
- },
- "engine": "druid",
- "engine_name": "Apache Druid",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Hive": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": true,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.hive",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": false,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 767,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": true,
- "file_upload": true,
- "get_extra_table_metadata": true,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": true,
- "expand_data": true,
- "query_cost_estimation": true,
- "sql_validation": false,
- "score": 140,
- "max_score": 201,
- "documentation": {
- "description": "Apache Hive is a data warehouse infrastructure built on Hadoop.",
- "logo": "apache-hive.svg",
- "homepage_url": "https://hive.apache.org/",
- "categories": ["Apache Projects", "Query Engines", "Open Source"],
- "pypi_packages": ["pyhive"],
- "connection_string": "hive://hive@{hostname}:{port}/{database}",
- "default_port": 10000,
- "category": "Apache Projects"
- },
- "engine": "hive",
- "engine_name": "Apache Hive",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Apache Impala": {
- "time_grains": {
- "SECOND": false,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.impala",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 37,
- "max_score": 201,
- "documentation": {
- "description": "Apache Impala is an open-source massively parallel processing SQL query engine.",
- "logo": "apache-impala.png",
- "homepage_url": "https://impala.apache.org/",
- "categories": ["Apache Projects", "Query Engines", "Open Source"],
- "pypi_packages": ["impyla"],
- "connection_string": "impala://{hostname}:{port}/{database}",
- "default_port": 21050,
- "category": "Apache Projects"
- },
- "engine": "impala",
- "engine_name": "Apache Impala",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache IoTDB": {
- "time_grains": {
- "SECOND": false,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": false,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": false,
- "SIX_HOURS": false,
- "DAY": false,
- "WEEK": false,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": false,
- "QUARTER": false,
- "QUARTER_YEAR": false,
- "YEAR": false
- },
- "module": "superset.db_engine_specs.iotdb",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 20,
- "max_score": 201,
- "documentation": {
- "description": "Apache IoTDB is a time series database designed for IoT data, with efficient storage and query capabilities for massive time series data.",
- "logo": "apache-iotdb.svg",
- "homepage_url": "https://iotdb.apache.org/",
- "categories": [
- "Apache Projects",
- "Time Series Databases",
- "Open Source"
- ],
- "pypi_packages": ["apache-iotdb"],
- "connection_string": "iotdb://{username}:{password}@{hostname}:{port}",
- "default_port": 6667,
- "parameters": {
- "username": "Database username (default: root)",
- "password": "Database password (default: root)",
- "hostname": "IP address or hostname",
- "port": "Default 6667"
- },
- "notes": "The IoTDB SQLAlchemy dialect was written to integrate with Apache Superset. IoTDB uses a hierarchical data model, which is reorganized into a relational model for SQL queries.",
- "category": "Apache Projects"
- },
- "engine": "iotdb",
- "engine_name": "Apache IoTDB",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Kylin": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.kylin",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 28,
- "max_score": 201,
- "documentation": {
- "description": "Apache Kylin is an open-source OLAP engine for big data.",
- "logo": "apache-kylin.png",
- "homepage_url": "https://kylin.apache.org/",
- "categories": [
- "Apache Projects",
- "Analytical Databases",
- "Open Source"
- ],
- "pypi_packages": ["kylinpy"],
- "connection_string": "kylin://{username}:{password}@{hostname}:{port}/{project}?{param1}={value1}&{param2}={value2}",
- "default_port": 7070,
- "category": "Apache Projects"
- },
- "engine": "kylin",
- "engine_name": "Apache Kylin",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Phoenix": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.phoenix",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 28,
- "max_score": 201,
- "documentation": {
- "description": "Apache Phoenix is a relational database layer over Apache HBase, providing low-latency SQL queries over HBase data.",
- "logo": "apache-phoenix.png",
- "homepage_url": "https://phoenix.apache.org/",
- "categories": [
- "Apache Projects",
- "Analytical Databases",
- "Open Source"
- ],
- "pypi_packages": ["phoenixdb"],
- "connection_string": "phoenix://{hostname}:{port}/",
- "default_port": 8765,
- "notes": "Phoenix provides a SQL interface to Apache HBase. The phoenixdb driver connects via the Phoenix Query Server and supports a subset of SQLAlchemy.",
- "category": "Apache Projects"
- },
- "engine": "phoenix",
- "engine_name": "Apache Phoenix",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Pinot": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.pinot",
- "limit_method": 1,
- "limit_clause": true,
- "joins": false,
- "subqueries": false,
- "alias_in_select": false,
- "alias_in_orderby": false,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 32,
- "max_score": 201,
- "documentation": {
- "description": "Apache Pinot is a real-time distributed OLAP datastore.",
- "logo": "apache-pinot.svg",
- "homepage_url": "https://pinot.apache.org/",
- "categories": [
- "Apache Projects",
- "Time Series Databases",
- "Open Source"
- ],
- "pypi_packages": ["pinotdb"],
- "connection_string": "pinot+http://{broker_host}:{broker_port}/query?controller=http://{controller_host}:{controller_port}/",
- "default_port": 8099,
- "connection_examples": [
- {
- "description": "With authentication",
- "connection_string": "pinot://{username}:{password}@{broker_host}:{broker_port}/query/sql?controller=http://{controller_host}:{controller_port}/verify_ssl=true"
- }
- ],
- "engine_parameters": [
- {
- "name": "Multi-stage Query Engine",
- "description": "Enable for Explore view, joins, window functions",
- "json": {
- "connect_args": {
- "use_multistage_engine": "true"
- }
- },
- "docs_url": "https://docs.pinot.apache.org/reference/multi-stage-engine"
- }
- ],
- "category": "Apache Projects"
- },
- "engine": "pinot",
- "engine_name": "Apache Pinot",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Solr": {
- "time_grains": {
- "SECOND": false,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": false,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": false,
- "SIX_HOURS": false,
- "DAY": false,
- "WEEK": false,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": false,
- "QUARTER": false,
- "QUARTER_YEAR": false,
- "YEAR": false
- },
- "module": "superset.db_engine_specs.solr",
- "limit_method": 1,
- "limit_clause": true,
- "joins": false,
- "subqueries": false,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 20,
- "max_score": 201,
- "documentation": {
- "description": "Apache Solr is an open-source enterprise search platform.",
- "logo": "apache-solr.png",
- "homepage_url": "https://solr.apache.org/",
- "categories": ["Apache Projects", "Search & NoSQL", "Open Source"],
- "pypi_packages": ["sqlalchemy-solr"],
- "connection_string": "solr://{username}:{password}@{host}:{port}/{server_path}/{collection}[/?use_ssl=true|false]",
- "default_port": 8983,
- "category": "Apache Projects"
- },
- "engine": "solr",
- "engine_name": "Apache Solr",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Apache Spark SQL": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": true,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.spark",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": false,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 767,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": true,
- "file_upload": true,
- "get_extra_table_metadata": true,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": true,
- "expand_data": true,
- "query_cost_estimation": true,
- "sql_validation": false,
- "score": 140,
- "max_score": 201,
- "documentation": {
- "description": "Apache Spark SQL is a module for structured data processing.",
- "logo": "apache-spark.png",
- "homepage_url": "https://spark.apache.org/sql/",
- "categories": ["Apache Projects", "Query Engines", "Open Source"],
- "pypi_packages": ["pyhive"],
- "connection_string": "hive://hive@{hostname}:{port}/{database}",
- "default_port": 10000,
- "category": "Apache Projects"
- },
- "engine": "hive",
- "engine_name": "Apache Spark SQL",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Arc": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.arc",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 28,
- "max_score": 201,
- "documentation": {
- "description": "Arc is a data platform with multiple connection options.",
- "categories": ["Other Databases", "Proprietary"],
- "pypi_packages": ["arc-superset-arrow"],
- "connection_string": "arc+arrow://{api_key}@{hostname}:{port}/{database}",
- "parameters": {
- "api_key": "Arc API key",
- "hostname": "Arc hostname",
- "port": "Arc port",
- "database": "Database name"
- },
- "drivers": [
- {
- "name": "Apache Arrow (Recommended)",
- "pypi_package": "arc-superset-arrow",
- "connection_string": "arc+arrow://{api_key}@{hostname}:{port}/{database}",
- "is_recommended": true,
- "notes": "Recommended for production. Provides 3-5x better performance using Apache Arrow IPC."
- },
- {
- "name": "JSON",
- "pypi_package": "arc-superset-dialect",
- "connection_string": "arc+json://{api_key}@{hostname}:{port}/{database}",
- "is_recommended": false
- }
- ],
- "notes": "Arc supports multiple databases (schemas) within a single instance. Each Arc database appears as a schema in SQL Lab.",
- "category": "Other Databases"
- },
- "engine": "arc",
- "engine_name": "Arc",
- "engine_aliases": [],
- "default_driver": "arrow",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Aurora MySQL": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.aurora",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 64,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 59,
- "max_score": 201,
- "documentation": {
- "description": "MySQL is a popular open-source relational database.",
- "logo": "mysql.png",
- "homepage_url": "https://www.mysql.com/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["mysqlclient"],
- "connection_string": "mysql://{username}:{password}@{host}/{database}",
- "default_port": 3306,
- "parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "localhost, 127.0.0.1, IP address, or hostname",
- "database": "Database name"
- },
- "host_examples": [
- {
- "platform": "Localhost",
- "host": "localhost or 127.0.0.1"
- },
- {
- "platform": "Docker on Linux",
- "host": "172.18.0.1"
- },
- {
- "platform": "Docker on macOS",
- "host": "docker.for.mac.host.internal"
- },
- {
- "platform": "On-premise",
- "host": "IP address or hostname"
- }
- ],
- "drivers": [
- {
- "name": "mysqlclient",
- "pypi_package": "mysqlclient",
- "connection_string": "mysql://{username}:{password}@{host}/{database}",
- "is_recommended": true,
- "notes": "Recommended driver. May fail with caching_sha2_password auth."
- },
- {
- "name": "mysql-connector-python",
- "pypi_package": "mysql-connector-python",
- "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
- "is_recommended": false,
- "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
- }
- ],
- "compatible_databases": [
- {
- "name": "MariaDB",
- "description": "MariaDB is a community-developed fork of MySQL, fully compatible with MySQL.",
- "logo": "mariadb.png",
- "homepage_url": "https://mariadb.org/",
- "pypi_packages": ["mysqlclient"],
- "connection_string": "mysql://{username}:{password}@{host}:{port}/{database}",
- "categories": ["Open Source"]
- },
- {
- "name": "Amazon Aurora MySQL",
- "description": "Amazon Aurora MySQL is a fully managed, MySQL-compatible relational database with up to 5x the throughput of standard MySQL.",
- "logo": "aws-aurora.jpg",
- "homepage_url": "https://aws.amazon.com/rds/aurora/",
- "pypi_packages": ["sqlalchemy-aurora-data-api"],
- "connection_string": "mysql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}®ion_name={region_name}",
- "parameters": {
- "aws_access_id": "AWS Access Key ID",
- "aws_secret_access_key": "AWS Secret Access Key",
- "database_name": "Database name",
- "aurora_cluster_arn": "Aurora cluster ARN",
- "secret_arn": "Secrets Manager ARN for credentials",
- "region_name": "AWS region (e.g., us-east-1)"
- },
- "notes": "Uses the Data API for serverless access. Standard MySQL connections also work with mysqlclient.",
- "categories": ["Cloud - AWS", "Hosted Open Source"]
- }
- ],
- "category": "Traditional RDBMS"
- },
- "engine": "mysql",
- "engine_name": "Aurora MySQL",
- "engine_aliases": [],
- "default_driver": "mysqldb",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Aurora MySQL (Data API)": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.aurora",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 64,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 59,
- "max_score": 201,
- "documentation": {
- "description": "MySQL is a popular open-source relational database.",
- "logo": "mysql.png",
- "homepage_url": "https://www.mysql.com/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["mysqlclient"],
- "connection_string": "mysql://{username}:{password}@{host}/{database}",
- "default_port": 3306,
- "parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "localhost, 127.0.0.1, IP address, or hostname",
- "database": "Database name"
- },
- "host_examples": [
- {
- "platform": "Localhost",
- "host": "localhost or 127.0.0.1"
- },
- {
- "platform": "Docker on Linux",
- "host": "172.18.0.1"
- },
- {
- "platform": "Docker on macOS",
- "host": "docker.for.mac.host.internal"
- },
- {
- "platform": "On-premise",
- "host": "IP address or hostname"
- }
- ],
- "drivers": [
- {
- "name": "mysqlclient",
- "pypi_package": "mysqlclient",
- "connection_string": "mysql://{username}:{password}@{host}/{database}",
- "is_recommended": true,
- "notes": "Recommended driver. May fail with caching_sha2_password auth."
- },
- {
- "name": "mysql-connector-python",
- "pypi_package": "mysql-connector-python",
- "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
- "is_recommended": false,
- "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
- }
- ],
- "compatible_databases": [
- {
- "name": "MariaDB",
- "description": "MariaDB is a community-developed fork of MySQL, fully compatible with MySQL.",
- "logo": "mariadb.png",
- "homepage_url": "https://mariadb.org/",
- "pypi_packages": ["mysqlclient"],
- "connection_string": "mysql://{username}:{password}@{host}:{port}/{database}",
- "categories": ["Open Source"]
- },
- {
- "name": "Amazon Aurora MySQL",
- "description": "Amazon Aurora MySQL is a fully managed, MySQL-compatible relational database with up to 5x the throughput of standard MySQL.",
- "logo": "aws-aurora.jpg",
- "homepage_url": "https://aws.amazon.com/rds/aurora/",
- "pypi_packages": ["sqlalchemy-aurora-data-api"],
- "connection_string": "mysql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}®ion_name={region_name}",
- "parameters": {
- "aws_access_id": "AWS Access Key ID",
- "aws_secret_access_key": "AWS Secret Access Key",
- "database_name": "Database name",
- "aurora_cluster_arn": "Aurora cluster ARN",
- "secret_arn": "Secrets Manager ARN for credentials",
- "region_name": "AWS region (e.g., us-east-1)"
- },
- "notes": "Uses the Data API for serverless access. Standard MySQL connections also work with mysqlclient.",
- "categories": ["Cloud - AWS", "Hosted Open Source"]
- }
- ],
- "category": "Traditional RDBMS"
- },
- "engine": "mysql",
- "engine_name": "Aurora MySQL (Data API)",
- "engine_aliases": [],
- "default_driver": "auroradataapi",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Aurora PostgreSQL": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": true,
- "THIRTY_SECONDS": true,
- "MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.aurora",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 63,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": true,
- "sql_validation": true,
- "score": 104,
- "max_score": 201,
- "documentation": {
- "description": "PostgreSQL is an advanced open-source relational database.",
- "logo": "postgresql.svg",
- "homepage_url": "https://www.postgresql.org/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "default_port": 5432,
- "parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL",
- "port": "Default 5432",
- "database": "Database name"
- },
- "notes": "The psycopg2 library comes bundled with Superset Docker images.",
- "connection_examples": [
- {
- "description": "Basic connection",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
- },
- {
- "description": "With SSL required",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
- }
- ],
- "docs_url": "https://www.postgresql.org/docs/",
- "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
- "compatible_databases": [
- {
- "name": "Hologres",
- "description": "Alibaba Cloud real-time interactive analytics service, fully compatible with PostgreSQL 11.",
- "logo": "hologres.png",
- "homepage_url": "https://www.alibabacloud.com/product/hologres",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}",
- "parameters": {
- "username": "AccessKey ID of your Alibaba Cloud account",
- "password": "AccessKey secret of your Alibaba Cloud account",
- "host": "Public endpoint of the Hologres instance",
- "port": "Port number of the Hologres instance",
- "database": "Name of the Hologres database"
- },
- "categories": ["Proprietary"]
- },
- {
- "name": "TimescaleDB",
- "description": "Open-source relational database for time-series and analytics, built on PostgreSQL.",
- "logo": "timescale.png",
- "homepage_url": "https://www.timescale.com/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "connection_examples": [
- {
- "description": "Timescale Cloud (SSL required)",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
- }
- ],
- "notes": "psycopg2 comes bundled with Superset Docker images.",
- "docs_url": "https://docs.timescale.com/",
- "categories": ["Open Source"]
- },
- {
- "name": "YugabyteDB",
- "description": "Distributed SQL database built on top of PostgreSQL.",
- "logo": "yugabyte.png",
- "homepage_url": "https://www.yugabyte.com/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "notes": "psycopg2 comes bundled with Superset Docker images.",
- "docs_url": "https://www.yugabyte.com/",
- "categories": ["Open Source"]
- },
- {
- "name": "Supabase",
- "description": "Open-source Firebase alternative built on top of PostgreSQL, providing a full backend-as-a-service with a hosted Postgres database.",
- "logo": "supabase.svg",
- "homepage_url": "https://supabase.com/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "connection_examples": [
- {
- "description": "Supabase project (connection pooler)",
- "connection_string": "postgresql://{username}.{project_ref}:{password}@aws-0-{region}.pooler.supabase.com:6543/{database}"
- }
- ],
- "parameters": {
- "username": "Database user (default: postgres)",
- "password": "Database password",
- "host": "Supabase project host (from project settings)",
- "port": "Default 5432 (direct) or 6543 (pooler)",
- "database": "Database name (default: postgres)",
- "project_ref": "Supabase project reference (from project settings)",
- "region": "Supabase project region (e.g., us-east-1)"
- },
- "notes": "Find connection details in your Supabase project dashboard under Settings > Database. Use the connection pooler (port 6543) for better connection management.",
- "docs_url": "https://supabase.com/docs/guides/database/connecting-to-postgres",
- "categories": ["Hosted Open Source"]
- },
- {
- "name": "Google AlloyDB",
- "description": "Google Cloud's PostgreSQL-compatible database service for demanding transactional and analytical workloads.",
- "logo": "alloydb.png",
- "homepage_url": "https://cloud.google.com/alloydb",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "parameters": {
- "username": "Database user (default: postgres)",
- "password": "Database password",
- "host": "AlloyDB instance IP or Auth Proxy address",
- "port": "Default 5432",
- "database": "Database name"
- },
- "notes": "For public IP connections, use the AlloyDB Auth Proxy for secure access. Private IP connections can connect directly.",
- "docs_url": "https://cloud.google.com/alloydb/docs",
- "categories": ["Cloud - Google", "Hosted Open Source"]
- },
- {
- "name": "Neon",
- "description": "Serverless PostgreSQL with branching, scale-to-zero, and bottomless storage.",
- "logo": "neon.png",
- "homepage_url": "https://neon.tech/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}/{database}?sslmode=require",
- "parameters": {
- "username": "Neon role name",
- "password": "Neon role password",
- "host": "Neon hostname (e.g., ep-cool-name-123456.us-east-2.aws.neon.tech)",
- "database": "Database name (default: neondb)"
- },
- "notes": "SSL is required for all connections. Find connection details in the Neon console under Connection Details.",
- "docs_url": "https://neon.tech/docs/connect/connect-from-any-app",
- "categories": ["Hosted Open Source"]
- },
- {
- "name": "Amazon Aurora PostgreSQL",
- "description": "Amazon Aurora PostgreSQL is a fully managed, PostgreSQL-compatible relational database with up to 5x the throughput of standard PostgreSQL.",
- "logo": "aws-aurora.jpg",
- "homepage_url": "https://aws.amazon.com/rds/aurora/",
- "pypi_packages": ["sqlalchemy-aurora-data-api"],
- "connection_string": "postgresql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}®ion_name={region_name}",
- "parameters": {
- "aws_access_id": "AWS Access Key ID",
- "aws_secret_access_key": "AWS Secret Access Key",
- "database_name": "Database name",
- "aurora_cluster_arn": "Aurora cluster ARN",
- "secret_arn": "Secrets Manager ARN for credentials",
- "region_name": "AWS region (e.g., us-east-1)"
- },
- "notes": "Uses the Data API for serverless access. Standard PostgreSQL connections also work with psycopg2.",
- "categories": ["Cloud - AWS", "Hosted Open Source"]
- }
- ],
- "category": "Traditional RDBMS"
+ "docs_url": "https://www.postgresql.org/docs/",
+ "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html"
},
- "engine": "postgresql",
- "engine_name": "Aurora PostgreSQL",
- "engine_aliases": ["postgres"],
- "default_driver": "psycopg2",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Aurora PostgreSQL (Data API)": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -2270,231 +533,8 @@
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.aurora",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 63,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": true,
- "sql_validation": true,
- "score": 104,
- "max_score": 201,
- "documentation": {
- "description": "PostgreSQL is an advanced open-source relational database.",
- "logo": "postgresql.svg",
- "homepage_url": "https://www.postgresql.org/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "default_port": 5432,
- "parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL",
- "port": "Default 5432",
- "database": "Database name"
- },
- "notes": "The psycopg2 library comes bundled with Superset Docker images.",
- "connection_examples": [
- {
- "description": "Basic connection",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
- },
- {
- "description": "With SSL required",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
- }
- ],
- "docs_url": "https://www.postgresql.org/docs/",
- "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
- "compatible_databases": [
- {
- "name": "Hologres",
- "description": "Alibaba Cloud real-time interactive analytics service, fully compatible with PostgreSQL 11.",
- "logo": "hologres.png",
- "homepage_url": "https://www.alibabacloud.com/product/hologres",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}",
- "parameters": {
- "username": "AccessKey ID of your Alibaba Cloud account",
- "password": "AccessKey secret of your Alibaba Cloud account",
- "host": "Public endpoint of the Hologres instance",
- "port": "Port number of the Hologres instance",
- "database": "Name of the Hologres database"
- },
- "categories": ["Proprietary"]
- },
- {
- "name": "TimescaleDB",
- "description": "Open-source relational database for time-series and analytics, built on PostgreSQL.",
- "logo": "timescale.png",
- "homepage_url": "https://www.timescale.com/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "connection_examples": [
- {
- "description": "Timescale Cloud (SSL required)",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
- }
- ],
- "notes": "psycopg2 comes bundled with Superset Docker images.",
- "docs_url": "https://docs.timescale.com/",
- "categories": ["Open Source"]
- },
- {
- "name": "YugabyteDB",
- "description": "Distributed SQL database built on top of PostgreSQL.",
- "logo": "yugabyte.png",
- "homepage_url": "https://www.yugabyte.com/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "notes": "psycopg2 comes bundled with Superset Docker images.",
- "docs_url": "https://www.yugabyte.com/",
- "categories": ["Open Source"]
- },
- {
- "name": "Supabase",
- "description": "Open-source Firebase alternative built on top of PostgreSQL, providing a full backend-as-a-service with a hosted Postgres database.",
- "logo": "supabase.svg",
- "homepage_url": "https://supabase.com/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "connection_examples": [
- {
- "description": "Supabase project (connection pooler)",
- "connection_string": "postgresql://{username}.{project_ref}:{password}@aws-0-{region}.pooler.supabase.com:6543/{database}"
- }
- ],
- "parameters": {
- "username": "Database user (default: postgres)",
- "password": "Database password",
- "host": "Supabase project host (from project settings)",
- "port": "Default 5432 (direct) or 6543 (pooler)",
- "database": "Database name (default: postgres)",
- "project_ref": "Supabase project reference (from project settings)",
- "region": "Supabase project region (e.g., us-east-1)"
- },
- "notes": "Find connection details in your Supabase project dashboard under Settings > Database. Use the connection pooler (port 6543) for better connection management.",
- "docs_url": "https://supabase.com/docs/guides/database/connecting-to-postgres",
- "categories": ["Hosted Open Source"]
- },
- {
- "name": "Google AlloyDB",
- "description": "Google Cloud's PostgreSQL-compatible database service for demanding transactional and analytical workloads.",
- "logo": "alloydb.png",
- "homepage_url": "https://cloud.google.com/alloydb",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "parameters": {
- "username": "Database user (default: postgres)",
- "password": "Database password",
- "host": "AlloyDB instance IP or Auth Proxy address",
- "port": "Default 5432",
- "database": "Database name"
- },
- "notes": "For public IP connections, use the AlloyDB Auth Proxy for secure access. Private IP connections can connect directly.",
- "docs_url": "https://cloud.google.com/alloydb/docs",
- "categories": ["Cloud - Google", "Hosted Open Source"]
- },
- {
- "name": "Neon",
- "description": "Serverless PostgreSQL with branching, scale-to-zero, and bottomless storage.",
- "logo": "neon.png",
- "homepage_url": "https://neon.tech/",
- "pypi_packages": ["psycopg2"],
- "connection_string": "postgresql://{username}:{password}@{host}/{database}?sslmode=require",
- "parameters": {
- "username": "Neon role name",
- "password": "Neon role password",
- "host": "Neon hostname (e.g., ep-cool-name-123456.us-east-2.aws.neon.tech)",
- "database": "Database name (default: neondb)"
- },
- "notes": "SSL is required for all connections. Find connection details in the Neon console under Connection Details.",
- "docs_url": "https://neon.tech/docs/connect/connect-from-any-app",
- "categories": ["Hosted Open Source"]
- },
- {
- "name": "Amazon Aurora PostgreSQL",
- "description": "Amazon Aurora PostgreSQL is a fully managed, PostgreSQL-compatible relational database with up to 5x the throughput of standard PostgreSQL.",
- "logo": "aws-aurora.jpg",
- "homepage_url": "https://aws.amazon.com/rds/aurora/",
- "pypi_packages": ["sqlalchemy-aurora-data-api"],
- "connection_string": "postgresql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}®ion_name={region_name}",
- "parameters": {
- "aws_access_id": "AWS Access Key ID",
- "aws_secret_access_key": "AWS Secret Access Key",
- "database_name": "Database name",
- "aurora_cluster_arn": "Aurora cluster ARN",
- "secret_arn": "Secrets Manager ARN for credentials",
- "region_name": "AWS region (e.g., us-east-1)"
- },
- "notes": "Uses the Data API for serverless access. Standard PostgreSQL connections also work with psycopg2.",
- "categories": ["Cloud - AWS", "Hosted Open Source"]
- }
- ],
- "category": "Traditional RDBMS"
- },
- "engine": "postgresql",
- "engine_name": "Aurora PostgreSQL (Data API)",
- "engine_aliases": ["postgres"],
- "default_driver": "auroradataapi",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Azure Data Explorer": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": true,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -2502,160 +542,157 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.kusto",
- "limit_method": 2,
- "limit_clause": true,
+ "score": 104,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": false,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 54,
- "max_score": 201,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": true,
+ "sql_validation": true,
+ "user_impersonation": false
+ },
+ "Aurora MySQL": {
+ "engine": "aurora_mysql",
+ "engine_name": "Aurora MySQL",
+ "module": "aurora",
"documentation": {
- "description": "Azure Data Explorer (Kusto) is a fast, fully managed data analytics service from Microsoft Azure. Query data using SQL or native KQL syntax.",
- "logo": "kusto.png",
- "homepage_url": "https://azure.microsoft.com/en-us/products/data-explorer/",
- "categories": ["Cloud - Azure", "Analytical Databases", "Proprietary"],
- "pypi_packages": ["sqlalchemy-kusto"],
- "connection_string": "kustosql+https://{cluster}.kusto.windows.net/{database}?msi=False&azure_ad_client_id={client_id}&azure_ad_client_secret={client_secret}&azure_ad_tenant_id={tenant_id}",
+ "description": "MySQL is a popular open-source relational database.",
+ "logo": "mysql.png",
+ "homepage_url": "https://www.mysql.com/",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "mysqlclient"
+ ],
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
+ "default_port": 3306,
"parameters": {
- "cluster": "Azure Data Explorer cluster name",
- "database": "Database name",
- "client_id": "Azure AD application (client) ID",
- "client_secret": "Azure AD application secret",
- "tenant_id": "Azure AD tenant ID"
+ "username": "Database username",
+ "password": "Database password",
+ "host": "localhost, 127.0.0.1, IP address, or hostname",
+ "database": "Database name"
},
+ "host_examples": [
+ {
+ "platform": "Localhost",
+ "host": "localhost or 127.0.0.1"
+ },
+ {
+ "platform": "Docker on Linux",
+ "host": "172.18.0.1"
+ },
+ {
+ "platform": "Docker on macOS",
+ "host": "docker.for.mac.host.internal"
+ },
+ {
+ "platform": "On-premise",
+ "host": "IP address or hostname"
+ }
+ ],
"drivers": [
{
- "name": "SQL Interface (Recommended)",
- "pypi_package": "sqlalchemy-kusto",
- "connection_string": "kustosql+https://{cluster}.kusto.windows.net/{database}?msi=False&azure_ad_client_id={client_id}&azure_ad_client_secret={client_secret}&azure_ad_tenant_id={tenant_id}",
+ "name": "mysqlclient",
+ "pypi_package": "mysqlclient",
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
"is_recommended": true,
- "notes": "Use familiar SQL syntax to query Azure Data Explorer."
+ "notes": "Recommended driver. May fail with caching_sha2_password auth."
},
{
- "name": "KQL (Kusto Query Language)",
- "pypi_package": "sqlalchemy-kusto",
- "connection_string": "kustokql+https://{cluster}.kusto.windows.net/{database}?msi=False&azure_ad_client_id={client_id}&azure_ad_client_secret={client_secret}&azure_ad_tenant_id={tenant_id}",
+ "name": "mysql-connector-python",
+ "pypi_package": "mysql-connector-python",
+ "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
"is_recommended": false,
- "notes": "Use native Kusto Query Language for advanced analytics."
+ "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
}
- ],
- "category": "Cloud - Azure"
+ ]
},
- "engine": "kustosql",
- "engine_name": "Azure Data Explorer",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Azure Data Explorer (KQL)": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
- "THIRTY_SECONDS": true,
+ "THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": true,
+ "FIVE_MINUTES": false,
"TEN_MINUTES": false,
"FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": true,
+ "THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
+ "WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": false,
+ "QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.kusto",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 59,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": false,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
+ "supports_file_upload": true,
+ "query_cancelation": true,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 40,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Aurora PostgreSQL": {
+ "engine": "aurora_postgresql",
+ "engine_name": "Aurora PostgreSQL",
+ "module": "aurora",
"documentation": {
- "pypi_packages": [],
- "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
- "category": "Cloud - Azure"
+ "description": "PostgreSQL is an advanced open-source relational database.",
+ "logo": "postgresql.svg",
+ "homepage_url": "https://www.postgresql.org/",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "psycopg2"
+ ],
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
+ "default_port": 5432,
+ "parameters": {
+ "username": "Database username",
+ "password": "Database password",
+ "host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL",
+ "port": "Default 5432",
+ "database": "Database name"
+ },
+ "notes": "The psycopg2 library comes bundled with Superset Docker images.",
+ "connection_examples": [
+ {
+ "description": "Basic connection",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
+ },
+ {
+ "description": "With SSL required",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
+ }
+ ],
+ "docs_url": "https://www.postgresql.org/docs/",
+ "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html"
},
- "engine": "kustokql",
- "engine_name": "Azure Data Explorer (KQL)",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Azure Synapse": {
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
@@ -2666,8 +703,8 @@
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -2675,100 +712,119 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.mssql",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 104,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": false,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 44,
- "max_score": 201,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": true,
+ "sql_validation": true,
+ "user_impersonation": false
+ },
+ "Google BigQuery": {
+ "engine": "google_bigquery",
+ "engine_name": "Google BigQuery",
+ "module": "bigquery",
"documentation": {
- "description": "Azure Synapse Analytics is a cloud-based enterprise data warehouse from Microsoft that combines big data and data warehousing.",
- "logo": "azure.svg",
- "homepage_url": "https://azure.microsoft.com/en-us/products/synapse-analytics/",
+ "description": "Google BigQuery is a serverless, highly scalable data warehouse.",
+ "logo": "google-big-query.svg",
+ "homepage_url": "https://cloud.google.com/bigquery/",
"categories": [
- "Cloud Data Warehouses",
- "Analytical Databases",
- "Proprietary"
+ "CLOUD_GCP",
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
],
- "pypi_packages": ["pymssql"],
- "connection_string": "mssql+pymssql://{username}@{server}:{password}@{server}.database.windows.net:1433/{database}",
- "category": "Cloud - Azure",
+ "pypi_packages": [
+ "sqlalchemy-bigquery"
+ ],
+ "connection_string": "bigquery://{project_id}",
+ "install_instructions": "echo \"sqlalchemy-bigquery\" >> ./docker/requirements-local.txt",
+ "authentication_methods": [
+ {
+ "name": "Service Account JSON",
+ "description": "Upload service account credentials JSON or paste in Secure Extra",
+ "secure_extra": {
+ "credentials_info": {
+ "type": "service_account",
+ "project_id": "...",
+ "private_key_id": "...",
+ "private_key": "...",
+ "client_email": "...",
+ "client_id": "...",
+ "auth_uri": "...",
+ "token_uri": "..."
+ }
+ }
+ }
+ ],
+ "notes": "Create a Service Account via GCP console with access to BigQuery datasets. For CSV/Excel uploads, also install pandas_gbq.",
+ "warnings": [
+ "Google BigQuery Python SDK is not compatible with gevent. Use a worker type other than gevent when deploying with gunicorn."
+ ],
+ "docs_url": "https://github.com/googleapis/python-bigquery-sqlalchemy",
"custom_errors": [
{
- "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
- "message_template": "Either the username \"%(username)s\", password, or database name \"%(database)s\" is incorrect.",
- "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
- "category": "Authentication",
- "description": "Access denied",
- "issue_codes": [1014, 1015]
+ "regex_name": "CONNECTION_DATABASE_PERMISSIONS_REGEX",
+ "message_template": "Unable to connect. Verify that the following roles are set on the service account: \"BigQuery Data Viewer\", \"BigQuery Metadata Viewer\", \"BigQuery Job User\" and the following permissions are set \"bigquery.readsessions.create\", \"bigquery.readsessions.getData\"",
+ "error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
+ "category": "Permissions",
+ "description": "Insufficient permissions",
+ "issue_codes": [
+ 1017
+ ]
},
{
- "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
- "message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
- "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
- "category": "Connection",
- "description": "Invalid hostname",
- "issue_codes": [1007]
+ "regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
+ "message_template": "The table \"%(table)s\" does not exist. A valid table must be used to run this query.",
+ "error_type": "TABLE_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Table not found",
+ "issue_codes": [
+ 1003,
+ 1005
+ ]
},
{
- "regex_name": "CONNECTION_PORT_CLOSED_REGEX",
- "message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
- "error_type": "CONNECTION_PORT_CLOSED_ERROR",
- "category": "Connection",
- "description": "Port closed or refused",
- "issue_codes": [1008]
+ "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
+ "message_template": "We can't seem to resolve column \"%(column)s\" at line %(location)s.",
+ "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Column not found",
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
},
{
- "regex_name": "CONNECTION_HOST_DOWN_REGEX",
- "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
- "error_type": "CONNECTION_HOST_DOWN_ERROR",
- "category": "Connection",
- "description": "Host unreachable",
- "issue_codes": [1009]
+ "regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
+ "message_template": "The schema \"%(schema)s\" does not exist. A valid schema must be used to run this query.",
+ "error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Schema not found",
+ "issue_codes": [
+ 1003,
+ 1016
+ ]
+ },
+ {
+ "regex_name": "SYNTAX_ERROR_REGEX",
+ "message_template": "Please check your query for syntax errors at or near \"%(syntax_error)s\". Then, try running your query again.",
+ "error_type": "SYNTAX_ERROR",
+ "category": "Query",
+ "description": "SQL syntax error",
+ "issue_codes": [
+ 1030
+ ]
}
]
},
- "engine": "mssql",
- "engine_name": "Azure Synapse",
- "engine_aliases": [],
- "default_driver": "pyodbc",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "ClickHouse": {
"time_grains": {
- "SECOND": false,
+ "SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
@@ -2782,7 +838,7 @@
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
+ "WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -2790,47 +846,35 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.clickhouse",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 83,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": false,
- "file_upload": false,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
+ "ssh_tunneling": false,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
+ "query_cost_estimation": true,
"sql_validation": false,
- "score": 61,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "ClickHouse": {
+ "engine": "clickhouse",
+ "engine_name": "ClickHouse",
+ "module": "clickhouse",
"documentation": {
"description": "ClickHouse is an open-source column-oriented database for real-time analytics using SQL. It's known for extremely fast query performance on large datasets.",
"logo": "clickhouse.png",
"homepage_url": "https://clickhouse.com/",
- "categories": ["Analytical Databases", "Open Source"],
- "pypi_packages": ["clickhouse-connect>=0.13.0"],
+ "categories": [
+ "ANALYTICAL_DATABASES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "clickhouse-connect>=0.13.0"
+ ],
"connection_string": "clickhousedb://{username}:{password}@{host}:{port}/{database}",
"default_port": 8123,
"drivers": [
@@ -2867,11 +911,13 @@
"logo": "clickhouse.png",
"homepage_url": "https://clickhouse.cloud/",
"categories": [
- "Analytical Databases",
- "Cloud Data Warehouses",
- "Hosted Open Source"
+ "ANALYTICAL_DATABASES",
+ "CLOUD_DATA_WAREHOUSES",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "clickhouse-connect>=0.13.0"
],
- "pypi_packages": ["clickhouse-connect>=0.13.0"],
"connection_string": "clickhousedb://{username}:{password}@{host}:8443/{database}?secure=true",
"parameters": {
"username": "ClickHouse Cloud username",
@@ -2887,27 +933,18 @@
"logo": "altinity.png",
"homepage_url": "https://altinity.cloud/",
"categories": [
- "Analytical Databases",
- "Cloud Data Warehouses",
- "Hosted Open Source"
+ "ANALYTICAL_DATABASES",
+ "CLOUD_DATA_WAREHOUSES",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "clickhouse-connect>=0.13.0"
],
- "pypi_packages": ["clickhouse-connect>=0.13.0"],
"connection_string": "clickhousedb://{username}:{password}@{host}/{database}?secure=true",
"docs_url": "https://docs.altinity.com/"
}
- ],
- "category": "Analytical Databases"
+ ]
},
- "engine": "clickhousedb",
- "engine_name": "ClickHouse",
- "engine_aliases": [],
- "default_driver": "connect",
- "supports_file_upload": false,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "ClickHouse (sqlalchemy)": {
"time_grains": {
"SECOND": false,
"FIVE_SECONDS": false,
@@ -2931,143 +968,60 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.clickhouse",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 61,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": false,
- "file_upload": false,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
- "sql_validation": false,
- "score": 51,
- "max_score": 201,
- "documentation": {
- "pypi_packages": [],
- "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
- "category": "Analytical Databases"
- },
- "engine": "clickhouse",
- "engine_name": "ClickHouse (sqlalchemy)",
- "engine_aliases": [],
- "default_driver": null,
"supports_file_upload": false,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Cloudflare D1": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": true,
- "THIRTY_SECONDS": true,
- "MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
- "HALF_HOUR": true,
- "HOUR": true,
- "SIX_HOURS": true,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": true,
- "WEEK_ENDING_SATURDAY": true,
- "WEEK_ENDING_SUNDAY": true,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": true,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.d1",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": true,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": false,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 41,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "CockroachDB": {
+ "engine": "cockroachdb",
+ "engine_name": "CockroachDB",
+ "module": "cockroachdb",
"documentation": {
- "description": "Cloudflare D1 is a serverless SQLite database.",
- "logo": "cloudflare.png",
- "homepage_url": "https://developers.cloudflare.com/d1/",
- "categories": [
- "Cloud Data Warehouses",
- "Traditional RDBMS",
- "Hosted Open Source"
+ "description": "CockroachDB is a distributed SQL database built for cloud applications.",
+ "logo": "cockroachdb.png",
+ "homepage_url": "https://www.cockroachlabs.com/",
+ "pypi_packages": [
+ "psycopg2",
+ "sqlalchemy-cockroachdb",
+ "psycopg2"
],
- "pypi_packages": ["superset-engine-d1"],
- "connection_string": "d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id}",
+ "connection_string": "cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable",
+ "default_port": 26257,
"parameters": {
- "cloudflare_account_id": "Cloudflare account ID",
- "cloudflare_api_token": "Cloudflare API token",
- "cloudflare_d1_database_id": "D1 database ID"
+ "username": "Database username",
+ "password": "Database password",
+ "host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL",
+ "port": "Default 5432",
+ "database": "Database name"
},
- "install_instructions": "pip install superset-engine-d1",
- "category": "Other Databases"
+ "notes": "The psycopg2 library comes bundled with Superset Docker images.",
+ "connection_examples": [
+ {
+ "description": "Basic connection",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
+ },
+ {
+ "description": "With SSL required",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
+ }
+ ],
+ "docs_url": "https://github.com/cockroachdb/sqlalchemy-cockroachdb",
+ "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ]
},
- "engine": "d1",
- "engine_name": "Cloudflare D1",
- "engine_aliases": [],
- "default_driver": "d1",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "CockroachDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -3091,62 +1045,53 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.cockroachdb",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 94,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 63,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": true,
"sql_validation": false,
- "score": 94,
- "max_score": 201,
- "documentation": {
- "description": "CockroachDB is a distributed SQL database built for cloud applications.",
- "logo": "cockroachdb.png",
- "homepage_url": "https://www.cockroachlabs.com/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["cockroachdb"],
- "connection_string": "cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable",
- "default_port": 26257,
- "docs_url": "https://github.com/cockroachdb/sqlalchemy-cockroachdb",
- "category": "Other Databases"
- },
- "engine": "cockroachdb",
- "engine_name": "CockroachDB",
- "engine_aliases": ["postgres"],
- "default_driver": "psycopg2",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
+ "user_impersonation": false
},
"Couchbase": {
+ "engine": "couchbase",
+ "engine_name": "Couchbase",
+ "module": "couchbase",
+ "documentation": {
+ "description": "Couchbase is a distributed NoSQL document database with SQL++ support.",
+ "logo": "couchbase.svg",
+ "homepage_url": "https://www.couchbase.com/",
+ "categories": [
+ "SEARCH_NOSQL",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "couchbase-sqlalchemy"
+ ],
+ "connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true",
+ "default_port": 8091,
+ "parameters": {
+ "username": "Couchbase username",
+ "password": "Couchbase password",
+ "host": "Couchbase host or connection string for cloud",
+ "port": "Couchbase port (default 8091)",
+ "database": "Couchbase database/bucket name"
+ },
+ "drivers": [
+ {
+ "name": "couchbase-sqlalchemy",
+ "pypi_package": "couchbase-sqlalchemy",
+ "connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true",
+ "is_recommended": true
+ }
+ ]
+ },
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -3170,76 +1115,51 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.couchbase",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 27,
+ "max_score": 201,
"joins": false,
"subqueries": false,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 27,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "CrateDB": {
+ "engine": "cratedb",
+ "engine_name": "CrateDB",
+ "module": "crate",
"documentation": {
- "description": "Couchbase is a distributed NoSQL document database with SQL++ support.",
- "logo": "couchbase.svg",
- "homepage_url": "https://www.couchbase.com/",
- "categories": ["Search & NoSQL", "Open Source"],
- "pypi_packages": ["couchbase-sqlalchemy"],
- "connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true",
- "default_port": 8091,
+ "description": "CrateDB is a distributed SQL database for machine data and IoT workloads.",
+ "logo": "cratedb.svg",
+ "homepage_url": "https://cratedb.com",
+ "categories": [
+ "TIME_SERIES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "crate",
+ "sqlalchemy-cratedb"
+ ],
+ "connection_string": "crate://{host}:{port}",
+ "default_port": 4200,
"parameters": {
- "username": "Couchbase username",
- "password": "Couchbase password",
- "host": "Couchbase host or connection string for cloud",
- "port": "Couchbase port (default 8091)",
- "database": "Couchbase database/bucket name"
+ "host": "CrateDB host",
+ "port": "CrateDB HTTP port (default 4200)"
},
"drivers": [
{
- "name": "couchbase-sqlalchemy",
- "pypi_package": "couchbase-sqlalchemy",
- "connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true",
+ "name": "crate",
+ "pypi_package": "sqlalchemy-cratedb",
+ "connection_string": "crate://{host}:{port}",
"is_recommended": true
}
- ],
- "category": "Search & NoSQL"
+ ]
},
- "engine": "couchbase",
- "engine_name": "Couchbase",
- "engine_aliases": ["couchbasedb"],
- "default_driver": "couchbase",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "CrateDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -3263,142 +1183,107 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.crate",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 28,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Cloudflare D1": {
+ "engine": "cloudflare_d1",
+ "engine_name": "Cloudflare D1",
+ "module": "d1",
"documentation": {
- "description": "CrateDB is a distributed SQL database for machine data and IoT workloads.",
- "logo": "cratedb.svg",
- "homepage_url": "https://cratedb.com",
- "categories": ["Time Series Databases", "Open Source"],
- "pypi_packages": ["crate", "sqlalchemy-cratedb"],
- "connection_string": "crate://{host}:{port}",
- "default_port": 4200,
+ "description": "Cloudflare D1 is a serverless SQLite database.",
+ "logo": "cloudflare.png",
+ "homepage_url": "https://developers.cloudflare.com/d1/",
+ "pypi_packages": [
+ "superset-engine-d1"
+ ],
+ "connection_string": "d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id}",
+ "notes": "No additional library needed. SQLite is bundled with Python.",
+ "categories": [
+ "CLOUD_DATA_WAREHOUSES",
+ "TRADITIONAL_RDBMS",
+ "HOSTED_OPEN_SOURCE"
+ ],
"parameters": {
- "host": "CrateDB host",
- "port": "CrateDB HTTP port (default 4200)"
+ "cloudflare_account_id": "Cloudflare account ID",
+ "cloudflare_api_token": "Cloudflare API token",
+ "cloudflare_d1_database_id": "D1 database ID"
},
- "drivers": [
+ "install_instructions": "pip install superset-engine-d1",
+ "known_incompatibilities": [
{
- "name": "crate",
- "pypi_package": "sqlalchemy-cratedb",
- "connection_string": "crate://{host}:{port}",
- "is_recommended": true
+ "dependency": "SQLAlchemy 2.0",
+ "reason": "sqlalchemy-d1 is very young (single release, Nov 2025) and its only release pins sqlalchemy<2,>=1.4, explicitly excluding SQLAlchemy 2.0.",
+ "tracking_url": "https://github.com/sqlalchemy-cf-d1/sqlalchemy-d1",
+ "since": "2026-07-28"
}
- ],
- "category": "Other Databases"
+ ]
},
- "engine": "crate",
- "engine_name": "CrateDB",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Databend": {
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
+ "THIRTY_MINUTES": true,
+ "HALF_HOUR": true,
"HOUR": true,
- "SIX_HOURS": false,
+ "SIX_HOURS": true,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
+ "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_MONDAY": true,
+ "WEEK_ENDING_SATURDAY": true,
+ "WEEK_ENDING_SUNDAY": true,
"MONTH": true,
"QUARTER": true,
- "QUARTER_YEAR": false,
+ "QUARTER_YEAR": true,
"YEAR": true
},
- "module": "superset.db_engine_specs.databend",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 41,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": false,
- "file_upload": false,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": false,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 51,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Databend": {
+ "engine": "databend",
+ "engine_name": "Databend",
+ "module": "databend",
"documentation": {
"description": "Databend is a modern cloud-native data warehouse with instant elasticity and pay-as-you-go pricing. Built in Rust for high performance.",
"logo": "databend.png",
"homepage_url": "https://www.databend.com/",
"categories": [
- "Cloud Data Warehouses",
- "Analytical Databases",
- "Proprietary"
+ "CLOUD_DATA_WAREHOUSES",
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "databend-sqlalchemy"
],
- "pypi_packages": ["databend-sqlalchemy"],
- "connection_string": "databend://{username}:{password}@{host}:{port}/{database}?secure=true",
+ "connection_string": "databend://{username}:{password}@{host}:{port}/{database}?sslmode=require",
"default_port": 443,
"parameters": {
"username": "Database username",
@@ -3406,19 +1291,8 @@
"host": "Databend host",
"port": "Databend port (default 443 for HTTPS)",
"database": "Database name"
- },
- "category": "Other Databases"
+ }
},
- "engine": "databend",
- "engine_name": "Databend",
- "engine_aliases": [],
- "default_driver": "databend",
- "supports_file_upload": false,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Databend (legacy)": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -3442,56 +1316,54 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.databend",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 51,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": false,
- "file_upload": false,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": false,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 51,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Databricks Interactive Cluster": {
+ "engine": "databricks_interactive_cluster",
+ "engine_name": "Databricks Interactive Cluster",
+ "module": "databricks",
"documentation": {
- "pypi_packages": [],
- "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
- "category": "Other Databases"
+ "description": "Apache Hive is a data warehouse infrastructure built on Hadoop.",
+ "logo": "apache-hive.svg",
+ "homepage_url": "https://hive.apache.org/",
+ "pypi_packages": [
+ "pyhive",
+ "pyhive"
+ ],
+ "install_instructions": "pip install \"apache-superset[presto]\"",
+ "connection_string": "hive://hive@{hostname}:{port}/{database}",
+ "default_port": 10000,
+ "parameters": {
+ "hostname": "Presto coordinator hostname",
+ "port": "Presto coordinator port (default 8080)",
+ "database": "Catalog name"
+ },
+ "drivers": [
+ {
+ "name": "PyHive",
+ "pypi_package": "pyhive",
+ "connection_string": "presto://{hostname}:{port}/{database}",
+ "is_recommended": true
+ }
+ ],
+ "categories": [
+ "APACHE_PROJECTS",
+ "QUERY_ENGINES",
+ "OPEN_SOURCE"
+ ]
},
- "engine": "databend",
- "engine_name": "Databend (legacy)",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": false,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Databricks": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -3515,51 +1387,36 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.databricks",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 140,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": true,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": true,
"sql_validation": false,
- "score": 70,
- "max_score": 201,
+ "user_impersonation": true
+ },
+ "Databricks": {
+ "engine": "databricks",
+ "engine_name": "Databricks",
+ "module": "databricks",
"documentation": {
"description": "Databricks is a unified analytics platform built on Apache Spark, providing data engineering, data science, and machine learning capabilities in the cloud. Use the Python Connector for SQL warehouses and clusters.",
"logo": "databricks.png",
"homepage_url": "https://www.databricks.com/",
"categories": [
- "Cloud Data Warehouses",
- "Analytical Databases",
- "Hosted Open Source"
+ "CLOUD_DATA_WAREHOUSES",
+ "ANALYTICAL_DATABASES",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "apache-superset[databricks]"
],
- "pypi_packages": ["apache-superset[databricks]"],
"install_instructions": "pip install apache-superset[databricks]",
"connection_string": "databricks://token:{access_token}@{host}:{port}?http_path={http_path}&catalog={catalog}&schema={schema}",
"parameters": {
@@ -3597,19 +1454,8 @@
"is_recommended": false,
"notes": "Legacy connector. Use Python Connector for new deployments."
}
- ],
- "category": "Cloud Data Warehouses"
+ ]
},
- "engine": "databricks",
- "engine_name": "Databricks",
- "engine_aliases": [],
- "default_driver": "databricks-sql-python",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Databricks (legacy)": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -3633,209 +1479,269 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.databricks",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 70,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": true,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 70,
- "max_score": 201,
+ "user_impersonation": true
+ },
+ "Apache DataFusion": {
+ "engine": "apache_datafusion",
+ "engine_name": "Apache DataFusion",
+ "module": "datafusion",
"documentation": {
- "pypi_packages": [],
- "connection_string": "databricks+connector://token:{access_token}@{host}:{port}/{database_name}",
- "category": "Cloud Data Warehouses"
+ "description": "DataFusion is a highly performant query engine",
+ "logo": "datafusion.png",
+ "homepage_url": "https://datafusion.apache.org/",
+ "categories": [
+ "QUERY_ENGINES",
+ "OPEN_SOURCE",
+ "APACHE_PROJECTS"
+ ],
+ "pypi_packages": [
+ "flightsql-dbapi"
+ ],
+ "connection_string": "datafusion://host:port",
+ "drivers": [
+ {
+ "name": "Arrow Flight SQL (Recommended)",
+ "pypi_package": "flightsql-dbapi",
+ "connection_string": "datafusion://host:port",
+ "is_recommended": true
+ }
+ ]
},
- "engine": "databricks",
- "engine_name": "Databricks (legacy)",
- "engine_aliases": [],
- "default_driver": "connector",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Databricks Interactive Cluster": {
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
"MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": true,
+ "WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.databricks",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 24,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": false,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 767,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": true,
- "file_upload": true,
- "get_extra_table_metadata": true,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": true,
- "expand_data": true,
- "query_cost_estimation": true,
+ "supports_file_upload": false,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
"sql_validation": false,
- "score": 140,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Google Datastore": {
+ "engine": "google_datastore",
+ "engine_name": "Google Datastore",
+ "module": "datastore",
"documentation": {
- "description": "Apache Hive is a data warehouse infrastructure built on Hadoop.",
- "logo": "apache-hive.svg",
- "homepage_url": "https://hive.apache.org/",
- "categories": ["Apache Projects", "Query Engines", "Open Source"],
- "pypi_packages": ["pyhive"],
- "connection_string": "hive://hive@{hostname}:{port}/{database}",
- "default_port": 10000,
- "category": "Cloud Data Warehouses"
+ "description": "Google Cloud Datastore is a highly scalable NoSQL database for your applications.",
+ "logo": "datastore.png",
+ "homepage_url": "https://cloud.google.com/datastore/",
+ "categories": [
+ "CLOUD_GCP",
+ "SEARCH_NOSQL",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "python-datastore-sqlalchemy"
+ ],
+ "connection_string": "datastore://{project_id}/?database={database_id}",
+ "authentication_methods": [
+ {
+ "name": "Service Account JSON",
+ "description": "Upload service account credentials JSON or paste in Secure Extra",
+ "secure_extra": {
+ "credentials_info": {
+ "type": "service_account",
+ "project_id": "...",
+ "private_key_id": "...",
+ "private_key": "...",
+ "client_email": "...",
+ "client_id": "...",
+ "auth_uri": "...",
+ "token_uri": "..."
+ }
+ }
+ }
+ ],
+ "notes": "Create a Service Account via GCP console with access to datastore datasets.",
+ "docs_url": "https://github.com/splasky/Python-datastore-sqlalchemy",
+ "custom_errors": [
+ {
+ "regex_name": "CONNECTION_DATABASE_PERMISSIONS_REGEX",
+ "message_template": "Unable to connect. Verify that the following roles are set on the service account: \"Cloud Datastore Viewer\", \"Cloud Datastore User\", \"Cloud Datastore Creator\"",
+ "error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
+ "category": "Permissions",
+ "description": "Insufficient permissions",
+ "issue_codes": [
+ 1017
+ ]
+ },
+ {
+ "regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
+ "message_template": "The table \"%(table)s\" does not exist. A valid table must be used to run this query.",
+ "error_type": "TABLE_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Table not found",
+ "issue_codes": [
+ 1003,
+ 1005
+ ]
+ },
+ {
+ "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
+ "message_template": "We can't seem to resolve column \"%(column)s\" at line %(location)s.",
+ "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Column not found",
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
+ },
+ {
+ "regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
+ "message_template": "The schema \"%(schema)s\" does not exist. A valid schema must be used to run this query.",
+ "error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Schema not found",
+ "issue_codes": [
+ 1003,
+ 1016
+ ]
+ },
+ {
+ "regex_name": "SYNTAX_ERROR_REGEX",
+ "message_template": "Please check your query for syntax errors at or near \"%(syntax_error)s\". Then, try running your query again.",
+ "error_type": "SYNTAX_ERROR",
+ "category": "Query",
+ "description": "SQL syntax error",
+ "issue_codes": [
+ 1030
+ ]
+ }
+ ]
},
- "engine": "databricks",
- "engine_name": "Databricks Interactive Cluster",
- "engine_aliases": [],
- "default_driver": "pyhive",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Databricks SQL Endpoint": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": true,
+ "WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.databricks",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 73,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
+ "ssh_tunneling": false,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 30,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "IBM Db2": {
+ "engine": "ibm_db2",
+ "engine_name": "IBM Db2",
+ "module": "db2",
"documentation": {
- "pypi_packages": [],
- "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
- "category": "Cloud Data Warehouses"
+ "description": "IBM Db2 is a family of data management products for enterprise workloads, available on-premises, in containers, and across cloud platforms.",
+ "logo": "ibm-db2.svg",
+ "homepage_url": "https://www.ibm.com/db2",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "ibm_db_sa"
+ ],
+ "connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}",
+ "default_port": 50000,
+ "drivers": [
+ {
+ "name": "ibm_db_sa (with LIMIT)",
+ "connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}",
+ "is_recommended": true
+ },
+ {
+ "name": "ibm_db_sa (without LIMIT syntax)",
+ "connection_string": "ibm_db_sa://{username}:{password}@{hostname}:{port}/{database}",
+ "is_recommended": false,
+ "notes": "Use for older DB2 versions without LIMIT [n] syntax. Recommended for SQL Lab."
+ }
+ ],
+ "compatible_databases": [
+ {
+ "name": "IBM Db2 for i (AS/400)",
+ "description": "Db2 for i is a fully integrated database engine on IBM i (AS/400) systems. Uses a different SQLAlchemy driver optimized for IBM i.",
+ "logo": "ibm-db2.svg",
+ "homepage_url": "https://www.ibm.com/products/db2-for-i",
+ "pypi_packages": [
+ "sqlalchemy-ibmi"
+ ],
+ "connection_string": "ibmi://{username}:{password}@{host}/{database}",
+ "parameters": {
+ "username": "IBM i username",
+ "password": "IBM i password",
+ "host": "IBM i system host",
+ "database": "Library/schema name"
+ },
+ "docs_url": "https://github.com/IBM/sqlalchemy-ibmi",
+ "categories": [
+ "PROPRIETARY"
+ ]
+ }
+ ],
+ "docs_url": "https://github.com/ibmdb/python-ibmdbsa"
},
- "engine": "databricks",
- "engine_name": "Databricks SQL Endpoint",
- "engine_aliases": [],
- "default_driver": "pyodbc",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Denodo": {
"time_grains": {
- "SECOND": false,
+ "SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
@@ -3857,47 +1763,35 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.denodo",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 38,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 27,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Denodo": {
+ "engine": "denodo",
+ "engine_name": "Denodo",
+ "module": "denodo",
"documentation": {
"description": "Denodo is a data virtualization platform for logical data management.",
"logo": "denodo.png",
"homepage_url": "https://www.denodo.com/",
- "categories": ["Query Engines", "Proprietary"],
- "pypi_packages": ["psycopg2"],
+ "categories": [
+ "QUERY_ENGINES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "denodo://{username}:{password}@{host}:{port}/{database}",
"default_port": 9996,
"parameters": {
@@ -3916,96 +1810,359 @@
"notes": "Uses PostgreSQL wire protocol."
}
],
- "category": "Other Databases",
"custom_errors": [
{
"message_template": "Incorrect username or password.",
"error_type": "CONNECTION_INVALID_USERNAME_ERROR",
"category": "Authentication",
"description": "Invalid username",
- "issue_codes": [1012],
- "invalid_fields": ["username", "password"]
+ "issue_codes": [
+ 1012
+ ],
+ "invalid_fields": [
+ "username",
+ "password"
+ ]
},
{
"message_template": "Please enter a password.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
- "issue_codes": [1014, 1015],
- "invalid_fields": ["password"]
+ "issue_codes": [
+ 1014,
+ 1015
+ ],
+ "invalid_fields": [
+ "password"
+ ]
},
{
"message_template": "Hostname \"%(hostname)s\" cannot be resolved.",
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
- "issue_codes": [1007],
- "invalid_fields": ["host"]
+ "issue_codes": [
+ 1007
+ ],
+ "invalid_fields": [
+ "host"
+ ]
},
{
"message_template": "Server refused the connection: check hostname and port.",
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
- "issue_codes": [1008],
- "invalid_fields": ["host", "port"]
+ "issue_codes": [
+ 1008
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
},
{
"message_template": "Unable to connect to database \"%(database)s\"",
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
- "issue_codes": [1015],
- "invalid_fields": ["database"]
+ "issue_codes": [
+ 1015
+ ],
+ "invalid_fields": [
+ "database"
+ ]
},
{
"message_template": "Unable to connect to database \"%(database)s\": database does not exist or insufficient permissions",
"error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
"category": "Permissions",
"description": "Insufficient permissions",
- "issue_codes": [1017],
- "invalid_fields": ["database"]
+ "issue_codes": [
+ 1017
+ ],
+ "invalid_fields": [
+ "database"
+ ]
},
{
"message_template": "Please check your query for syntax errors at or near \"%(err)s\". Then, try running your query again.",
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
},
{
"message_template": "Column \"%(column)s\" not found in \"%(view)s\".",
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
- "issue_codes": [1003, 1004]
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
},
{
"message_template": "Invalid aggregation expression.",
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
},
{
"message_template": "\"%(exp)s\" is neither an aggregation function nor appears in the GROUP BY clause.",
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
}
]
},
- "engine": "denodo",
- "engine_name": "Denodo",
- "engine_aliases": [],
- "default_driver": "psycopg2",
- "supports_file_upload": true,
+ "time_grains": {
+ "SECOND": false,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 27,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
- "supports_dynamic_catalog": false
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
+ },
+ "Apache Doris": {
+ "engine": "apache_doris",
+ "engine_name": "Apache Doris",
+ "module": "doris",
+ "documentation": {
+ "description": "Apache Doris is a high-performance real-time analytical database.",
+ "logo": "doris.png",
+ "homepage_url": "https://doris.apache.org/",
+ "pypi_packages": [
+ "mysqlclient",
+ "pydoris"
+ ],
+ "connection_string": "doris://{username}:{password}@{host}:{port}/{catalog}.{database}",
+ "default_port": 9030,
+ "parameters": {
+ "username": "User name",
+ "password": "Password",
+ "host": "Doris FE Host",
+ "database": "Database name",
+ "port": "Doris FE port",
+ "catalog": "Catalog name"
+ },
+ "host_examples": [
+ {
+ "platform": "Localhost",
+ "host": "localhost or 127.0.0.1"
+ },
+ {
+ "platform": "Docker on Linux",
+ "host": "172.18.0.1"
+ },
+ {
+ "platform": "Docker on macOS",
+ "host": "docker.for.mac.host.internal"
+ },
+ {
+ "platform": "On-premise",
+ "host": "IP address or hostname"
+ }
+ ],
+ "drivers": [
+ {
+ "name": "mysqlclient",
+ "pypi_package": "mysqlclient",
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
+ "is_recommended": true,
+ "notes": "Recommended driver. May fail with caching_sha2_password auth."
+ },
+ {
+ "name": "mysql-connector-python",
+ "pypi_package": "mysql-connector-python",
+ "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
+ "is_recommended": false,
+ "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
+ }
+ ],
+ "categories": [
+ "APACHE_PROJECTS",
+ "ANALYTICAL_DATABASES",
+ "OPEN_SOURCE"
+ ],
+ "custom_errors": [
+ {
+ "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
+ "message_template": "Either the username \"%(username)s\" or the password is incorrect.",
+ "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
+ "category": "Authentication",
+ "description": "Access denied",
+ "issue_codes": [
+ 1014,
+ 1015
+ ],
+ "invalid_fields": [
+ "username",
+ "password"
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
+ "message_template": "Unknown Doris server host \"%(hostname)s\".",
+ "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
+ "category": "Connection",
+ "description": "Invalid hostname",
+ "issue_codes": [
+ 1007
+ ],
+ "invalid_fields": [
+ "host"
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_HOST_DOWN_REGEX",
+ "message_template": "The host \"%(hostname)s\" might be down and can't be reached.",
+ "error_type": "CONNECTION_HOST_DOWN_ERROR",
+ "category": "Connection",
+ "description": "Host unreachable",
+ "issue_codes": [
+ 1009
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
+ "message_template": "Unable to connect to database \"%(database)s\".",
+ "error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
+ "category": "Connection",
+ "description": "Unknown database",
+ "issue_codes": [
+ 1015
+ ],
+ "invalid_fields": [
+ "database"
+ ]
+ },
+ {
+ "regex_name": "SYNTAX_ERROR_REGEX",
+ "message_template": "Please check your query for syntax errors near \"%(server_error)s\". Then, try running your query again.",
+ "error_type": "SYNTAX_ERROR",
+ "category": "Query",
+ "description": "SQL syntax error",
+ "issue_codes": [
+ 1030
+ ]
+ }
+ ]
+ },
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": true,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 79,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
},
"Dremio": {
+ "engine": "dremio",
+ "engine_name": "Dremio",
+ "module": "dremio",
+ "documentation": {
+ "description": "Dremio is a data lakehouse platform for fast, self-service analytics.",
+ "logo": "dremio.png",
+ "homepage_url": "https://www.dremio.com/",
+ "categories": [
+ "QUERY_ENGINES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "sqlalchemy_dremio"
+ ],
+ "connection_string": "dremio+flight://data.dremio.cloud:443/?Token={token}&UseEncryption=true",
+ "parameters": {
+ "token": "Personal Access Token (PAT) or API token"
+ },
+ "drivers": [
+ {
+ "name": "Arrow Flight (Recommended)",
+ "pypi_package": "sqlalchemy_dremio",
+ "connection_string": "dremio+flight://data.dremio.cloud:443/?Token={token}&UseEncryption=true",
+ "is_recommended": true
+ },
+ {
+ "name": "ODBC",
+ "pypi_package": "sqlalchemy_dremio",
+ "connection_string": "dremio+pyodbc://{token}@{host}:31010/dremio",
+ "is_recommended": false,
+ "notes": "Requires Dremio ODBC drivers installed."
+ }
+ ]
+ },
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -4029,78 +2186,68 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.dremio",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 28,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Apache Drill": {
+ "engine": "apache_drill",
+ "engine_name": "Apache Drill",
+ "module": "drill",
"documentation": {
- "description": "Dremio is a data lakehouse platform for fast, self-service analytics.",
- "logo": "dremio.png",
- "homepage_url": "https://www.dremio.com/",
- "categories": ["Query Engines", "Proprietary"],
- "pypi_packages": ["sqlalchemy_dremio"],
- "connection_string": "dremio+flight://data.dremio.cloud:443/?Token={token}&UseEncryption=true",
- "parameters": {
- "token": "Personal Access Token (PAT) or API token"
- },
+ "description": "Apache Drill is a schema-free SQL query engine for Hadoop and NoSQL.",
+ "logo": "apache-drill.png",
+ "homepage_url": "https://drill.apache.org/",
+ "categories": [
+ "APACHE_PROJECTS",
+ "QUERY_ENGINES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-drill"
+ ],
+ "connection_string": "drill+sadrill://{username}:{password}@{host}:{port}/{storage_plugin}?use_ssl=True",
+ "default_port": 8047,
"drivers": [
{
- "name": "Arrow Flight (Recommended)",
- "pypi_package": "sqlalchemy_dremio",
- "connection_string": "dremio+flight://data.dremio.cloud:443/?Token={token}&UseEncryption=true",
+ "name": "SQLAlchemy (REST)",
+ "pypi_package": "sqlalchemy-drill",
+ "connection_string": "drill+sadrill://{username}:{password}@{host}:{port}/{storage_plugin}?use_ssl=True",
"is_recommended": true
},
+ {
+ "name": "JDBC",
+ "pypi_package": "sqlalchemy-drill",
+ "connection_string": "drill+jdbc://{username}:{password}@{host}:{port}",
+ "is_recommended": false,
+ "notes": "Requires Drill JDBC Driver installation.",
+ "docs_url": "https://drill.apache.org/docs/using-the-jdbc-driver/"
+ },
{
"name": "ODBC",
- "pypi_package": "sqlalchemy_dremio",
- "connection_string": "dremio+pyodbc://{token}@{host}:31010/dremio",
+ "pypi_package": "sqlalchemy-drill",
"is_recommended": false,
- "notes": "Requires Dremio ODBC drivers installed."
+ "notes": "See Apache Drill documentation for ODBC setup.",
+ "docs_url": "https://drill.apache.org/docs/installing-the-driver-on-linux/"
}
],
- "category": "Other Databases"
+ "connection_examples": [
+ {
+ "description": "Local embedded mode",
+ "connection_string": "drill+sadrill://localhost:8047/dfs?use_ssl=False"
+ }
+ ]
},
- "engine": "dremio",
- "engine_name": "Dremio",
- "engine_aliases": ["dremio+flight"],
- "default_driver": "flight",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "DuckDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -4108,8 +2255,8 @@
"MINUTE": true,
"FIVE_MINUTES": false,
"TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
@@ -4124,47 +2271,131 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.duckdb",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 50,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 38,
+ "user_impersonation": true
+ },
+ "Apache Druid": {
+ "engine": "apache_druid",
+ "engine_name": "Apache Druid",
+ "module": "druid",
+ "documentation": {
+ "description": "Apache Druid is a high performance real-time analytics database.",
+ "logo": "druid.png",
+ "homepage_url": "https://druid.apache.org/",
+ "categories": [
+ "APACHE_PROJECTS",
+ "TIME_SERIES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "pydruid"
+ ],
+ "connection_string": "druid://{username}:{password}@{host}:{port}/druid/v2/sql",
+ "default_port": 9088,
+ "parameters": {
+ "username": "Database username",
+ "password": "Database password",
+ "host": "IP address or URL of the host",
+ "port": "Default 9088"
+ },
+ "ssl_configuration": {
+ "custom_certificate": "Add certificate in Root Certificate field. pydruid will automatically use https.",
+ "disable_ssl_verification": {
+ "engine_params": {
+ "connect_args": {
+ "scheme": "https",
+ "ssl_verify_cert": false
+ }
+ }
+ }
+ },
+ "advanced_features": {
+ "aggregations": "Define common aggregations in datasource edit view under List Druid Column tab.",
+ "post_aggregations": "Create metrics with postagg as Metric Type and provide valid JSON post-aggregation definition."
+ },
+ "notes": "A native Druid connector ships with Superset (behind DRUID_IS_ACTIVE flag) but SQLAlchemy connector via pydruid is preferred.",
+ "compatible_databases": [
+ {
+ "name": "Imply",
+ "description": "Imply is a fully-managed cloud platform and enterprise distribution built on Apache Druid. It provides real-time analytics with enterprise security and support.",
+ "logo": "imply.png",
+ "homepage_url": "https://imply.io/",
+ "categories": [
+ "TIME_SERIES",
+ "CLOUD_DATA_WAREHOUSES",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "pydruid"
+ ],
+ "connection_string": "druid://{username}:{password}@{host}/druid/v2/sql",
+ "docs_url": "https://docs.imply.io/"
+ }
+ ]
+ },
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
+ "MINUTE": true,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": true,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": true,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 47,
"max_score": 201,
+ "joins": false,
+ "subqueries": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
+ },
+ "DuckDB": {
+ "engine": "duckdb",
+ "engine_name": "DuckDB",
+ "module": "duckdb",
"documentation": {
"description": "DuckDB is an in-process OLAP database designed for fast analytical queries on local data. Supports CSV, Parquet, JSON, and many other file formats.",
"logo": "duckdb.png",
"homepage_url": "https://duckdb.org/",
- "categories": ["Analytical Databases", "Open Source"],
- "pypi_packages": ["duckdb-engine"],
+ "categories": [
+ "ANALYTICAL_DATABASES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "duckdb-engine"
+ ],
"connection_string": "duckdb:////path/to/duck.db",
"drivers": [
{
@@ -4181,17 +2412,111 @@
"description": "MotherDuck is a serverless cloud analytics platform built on DuckDB, offering collaborative data sharing and cloud-native scalability.",
"logo": "motherduck.png",
"homepage_url": "https://motherduck.com/",
- "pypi_packages": ["duckdb", "duckdb-engine"],
+ "pypi_packages": [
+ "duckdb",
+ "duckdb-engine"
+ ],
"connection_string": "duckdb:///md:{database}?motherduck_token={token}",
"parameters": {
"database": "MotherDuck database name",
"motherduck_token": "Service token from MotherDuck dashboard"
},
"notes": "Cloud-hosted DuckDB with collaboration features.",
- "categories": ["Hosted Open Source"]
+ "categories": [
+ "HOSTED_OPEN_SOURCE"
+ ]
+ }
+ ],
+ "custom_errors": [
+ {
+ "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
+ "message_template": "We can't seem to resolve the column \"%(column_name)s\"",
+ "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Column not found",
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
+ }
+ ]
+ },
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 38,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
+ },
+ "MotherDuck": {
+ "engine": "motherduck",
+ "engine_name": "MotherDuck",
+ "module": "duckdb",
+ "documentation": {
+ "description": "MotherDuck is a serverless cloud analytics platform built on DuckDB. It combines the simplicity of DuckDB with cloud-scale data sharing and collaboration.",
+ "logo": "motherduck.png",
+ "homepage_url": "https://motherduck.com/",
+ "pypi_packages": [
+ "duckdb-engine",
+ "duckdb",
+ "duckdb-engine"
+ ],
+ "connection_string": "duckdb:///md:{database}?motherduck_token={token}",
+ "drivers": [
+ {
+ "name": "duckdb-engine",
+ "pypi_package": "duckdb-engine",
+ "connection_string": "duckdb:////path/to/duck.db",
+ "is_recommended": true
+ },
+ {
+ "name": "duckdb-engine",
+ "pypi_package": "duckdb-engine",
+ "connection_string": "duckdb:///md:{database}?motherduck_token={token}",
+ "is_recommended": true
}
],
- "category": "Other Databases",
+ "notes": "DuckDB supports both local file and in-memory databases. Use `:memory:` for in-memory database.",
+ "categories": [
+ "ANALYTICAL_DATABASES",
+ "CLOUD_DATA_WAREHOUSES",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "parameters": {
+ "database": "MotherDuck database name",
+ "token": "Service token from MotherDuck dashboard"
+ },
+ "docs_url": "https://motherduck.com/docs/getting-started/",
"custom_errors": [
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
@@ -4199,20 +2524,75 @@
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
- "issue_codes": [1003, 1004]
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
}
]
},
- "engine": "duckdb",
- "engine_name": "DuckDB",
- "engine_aliases": [],
- "default_driver": "duckdb_engine",
- "supports_file_upload": true,
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 58,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
"supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
},
- "Elasticsearch": {
+ "Amazon DynamoDB": {
+ "engine": "amazon_dynamodb",
+ "engine_name": "Amazon DynamoDB",
+ "module": "dynamodb",
+ "documentation": {
+ "description": "Amazon DynamoDB is a serverless NoSQL database with SQL via PartiQL.",
+ "logo": "aws.png",
+ "homepage_url": "https://aws.amazon.com/dynamodb/",
+ "categories": [
+ "CLOUD_AWS",
+ "SEARCH_NOSQL",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "pydynamodb"
+ ],
+ "connection_string": "dynamodb://{aws_access_key_id}:{aws_secret_access_key}@dynamodb.{region}.amazonaws.com:443?connector=superset",
+ "parameters": {
+ "aws_access_key_id": "AWS access key ID",
+ "aws_secret_access_key": "AWS secret access key",
+ "region": "AWS region (e.g., us-east-1)"
+ },
+ "notes": "Uses PartiQL for SQL queries. Requires connector=superset parameter.",
+ "docs_url": "https://github.com/passren/PyDynamoDB"
+ },
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -4227,56 +2607,44 @@
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
+ "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_MONDAY": true,
+ "WEEK_ENDING_SATURDAY": true,
+ "WEEK_ENDING_SUNDAY": true,
"MONTH": true,
- "QUARTER": false,
+ "QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.elasticsearch",
- "limit_method": 1,
- "limit_clause": true,
- "joins": false,
+ "score": 32,
+ "max_score": 201,
+ "joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": false,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 37,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Elasticsearch": {
+ "engine": "elasticsearch",
+ "engine_name": "Elasticsearch",
+ "module": "elasticsearch",
"documentation": {
"description": "Elasticsearch is a distributed search and analytics engine. Query data using Elasticsearch SQL or OpenSearch SQL syntax.",
"logo": "elasticsearch.png",
"homepage_url": "https://www.elastic.co/elasticsearch/",
- "categories": ["Search & NoSQL", "Open Source"],
- "pypi_packages": ["elasticsearch-dbapi"],
+ "categories": [
+ "SEARCH_NOSQL",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "elasticsearch-dbapi"
+ ],
"connection_string": "elasticsearch+https://{user}:{password}@{host}:9243/",
"default_port": 9243,
"parameters": {
@@ -4306,8 +2674,13 @@
"description": "Elastic Cloud is the official managed Elasticsearch service from Elastic. It includes Elasticsearch, Kibana, and enterprise features with automatic scaling.",
"logo": "elasticsearch.png",
"homepage_url": "https://www.elastic.co/cloud/",
- "categories": ["Search & NoSQL", "Hosted Open Source"],
- "pypi_packages": ["elasticsearch-dbapi"],
+ "categories": [
+ "SEARCH_NOSQL",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "elasticsearch-dbapi"
+ ],
"connection_string": "elasticsearch+https://{user}:{password}@{deployment}.{region}.cloud.es.io:9243/",
"docs_url": "https://www.elastic.co/guide/en/cloud/current/"
},
@@ -4317,27 +2690,18 @@
"logo": "elasticsearch.png",
"homepage_url": "https://aws.amazon.com/opensearch-service/",
"categories": [
- "Search & NoSQL",
- "Cloud - AWS",
- "Hosted Open Source"
+ "SEARCH_NOSQL",
+ "CLOUD_AWS",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "elasticsearch-dbapi"
],
- "pypi_packages": ["elasticsearch-dbapi"],
"connection_string": "odelasticsearch+https://{user}:{password}@{host}:443/",
"docs_url": "https://docs.aws.amazon.com/opensearch-service/latest/developerguide/"
}
- ],
- "category": "Search & NoSQL"
+ ]
},
- "engine": "elasticsearch",
- "engine_name": "Elasticsearch",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Exasol": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -4357,51 +2721,39 @@
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": true,
+ "QUARTER": false,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.exasol",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
+ "score": 37,
+ "max_score": 201,
+ "joins": false,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 28,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Exasol": {
+ "engine": "exasol",
+ "engine_name": "Exasol",
+ "module": "exasol",
"documentation": {
"description": "Exasol is a high-performance, in-memory, MPP analytical database.",
"logo": "exasol.png",
"homepage_url": "https://www.exasol.com/",
- "categories": ["Analytical Databases", "Proprietary"],
- "pypi_packages": ["sqlalchemy-exasol"],
+ "categories": [
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-exasol"
+ ],
"connection_string": "exa+pyodbc://{username}:{password}@{dsn}",
"default_port": 8563,
"parameters": {
@@ -4431,19 +2783,8 @@
"is_recommended": false,
"notes": "Pure Python, no ODBC required."
}
- ],
- "category": "Other Databases"
+ ]
},
- "engine": "exa",
- "engine_name": "Exasol",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Firebird": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -4457,57 +2798,45 @@
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
- "WEEK": false,
+ "WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": false,
+ "QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.firebird",
- "limit_method": 3,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 26,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Firebird": {
+ "engine": "firebird",
+ "engine_name": "Firebird",
+ "module": "firebird",
"documentation": {
"description": "Firebird is an open-source relational database.",
"logo": "firebird.png",
"homepage_url": "https://firebirdsql.org/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["sqlalchemy-firebird"],
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-firebird"
+ ],
"version_requirements": "sqlalchemy-firebird>=0.7.0,<0.8",
"connection_string": "firebird+fdb://{username}:{password}@{host}:{port}//{path_to_db_file}",
"default_port": 3050,
@@ -4516,19 +2845,8 @@
"description": "Local database",
"connection_string": "firebird+fdb://SYSDBA:masterkey@192.168.86.38:3050//Library/Frameworks/Firebird.framework/Versions/A/Resources/examples/empbuild/employee.fdb"
}
- ],
- "category": "Other Databases"
+ ]
},
- "engine": "firebird",
- "engine_name": "Firebird",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Firebolt": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -4542,248 +2860,79 @@
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
- "WEEK": true,
+ "WEEK": false,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": true,
+ "QUARTER": false,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.firebolt",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 26,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 28,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Firebolt": {
+ "engine": "firebolt",
+ "engine_name": "Firebolt",
+ "module": "firebolt",
"documentation": {
"description": "Firebolt is a cloud data warehouse designed for high-performance analytics.",
"logo": "firebolt.png",
"homepage_url": "https://www.firebolt.io/",
"categories": [
- "Cloud Data Warehouses",
- "Analytical Databases",
- "Proprietary"
+ "CLOUD_DATA_WAREHOUSES",
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "firebolt-sqlalchemy"
],
- "pypi_packages": ["firebolt-sqlalchemy"],
"connection_string": "firebolt://{client_id}:{client_secret}@{database}/{engine_name}?account_name={account_name}",
"parameters": {
"client_id": "Service account client ID",
"client_secret": "Service account client secret",
"database": "Database name",
"engine_name": "Engine name",
- "account_name": "Account name"
- },
- "drivers": [
- {
- "name": "firebolt-sqlalchemy",
- "pypi_package": "firebolt-sqlalchemy",
- "connection_string": "firebolt://{client_id}:{client_secret}@{database}/{engine_name}?account_name={account_name}",
- "is_recommended": true
- }
- ],
- "category": "Other Databases"
- },
- "engine": "firebolt",
- "engine_name": "Firebolt",
- "engine_aliases": [],
- "default_driver": "firebolt",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Google BigQuery": {
- "time_grains": {
- "SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
- "MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
- "HALF_HOUR": false,
- "HOUR": true,
- "SIX_HOURS": false,
- "DAY": true,
- "WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": true,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "module": "superset.db_engine_specs.bigquery",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": true,
- "cte_in_subquery": true,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": true,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": true,
- "expand_data": false,
- "query_cost_estimation": true,
- "sql_validation": false,
- "score": 83,
- "max_score": 201,
- "documentation": {
- "description": "Google BigQuery is a serverless, highly scalable data warehouse.",
- "logo": "google-big-query.svg",
- "homepage_url": "https://cloud.google.com/bigquery/",
- "categories": ["Cloud - Google", "Analytical Databases", "Proprietary"],
- "pypi_packages": ["sqlalchemy-bigquery"],
- "connection_string": "bigquery://{project_id}",
- "install_instructions": "echo \"sqlalchemy-bigquery\" >> ./docker/requirements-local.txt",
- "authentication_methods": [
- {
- "name": "Service Account JSON",
- "description": "Upload service account credentials JSON or paste in Secure Extra",
- "secure_extra": {
- "credentials_info": {
- "type": "service_account",
- "project_id": "...",
- "private_key_id": "...",
- "private_key": "...",
- "client_email": "...",
- "client_id": "...",
- "auth_uri": "...",
- "token_uri": "..."
- }
- }
- }
- ],
- "notes": "Create a Service Account via GCP console with access to BigQuery datasets. For CSV/Excel uploads, also install pandas_gbq.",
- "warnings": [
- "Google BigQuery Python SDK is not compatible with gevent. Use a worker type other than gevent when deploying with gunicorn."
- ],
- "docs_url": "https://github.com/googleapis/python-bigquery-sqlalchemy",
- "category": "Cloud - Google",
- "custom_errors": [
- {
- "regex_name": "CONNECTION_DATABASE_PERMISSIONS_REGEX",
- "message_template": "Unable to connect. Verify that the following roles are set on the service account: \"BigQuery Data Viewer\", \"BigQuery Metadata Viewer\", \"BigQuery Job User\" and the following permissions are set \"bigquery.readsessions.create\", \"bigquery.readsessions.getData\"",
- "error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
- "category": "Permissions",
- "description": "Insufficient permissions",
- "issue_codes": [1017]
- },
- {
- "regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
- "message_template": "The table \"%(table)s\" does not exist. A valid table must be used to run this query.",
- "error_type": "TABLE_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Table not found",
- "issue_codes": [1003, 1005]
- },
- {
- "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
- "message_template": "We can't seem to resolve column \"%(column)s\" at line %(location)s.",
- "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Column not found",
- "issue_codes": [1003, 1004]
- },
- {
- "regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
- "message_template": "The schema \"%(schema)s\" does not exist. A valid schema must be used to run this query.",
- "error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Schema not found",
- "issue_codes": [1003, 1016]
- },
- {
- "regex_name": "SYNTAX_ERROR_REGEX",
- "message_template": "Please check your query for syntax errors at or near \"%(syntax_error)s\". Then, try running your query again.",
- "error_type": "SYNTAX_ERROR",
- "category": "Query",
- "description": "SQL syntax error",
- "issue_codes": [1030]
+ "account_name": "Account name"
+ },
+ "drivers": [
+ {
+ "name": "firebolt-sqlalchemy",
+ "pypi_package": "firebolt-sqlalchemy",
+ "connection_string": "firebolt://{client_id}:{client_secret}@{database}/{engine_name}?account_name={account_name}",
+ "is_recommended": true
}
]
},
- "engine": "bigquery",
- "engine_name": "Google BigQuery",
- "engine_aliases": [],
- "default_driver": "bigquery",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Google Datastore": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -4791,122 +2940,60 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.datastore",
- "limit_method": 3,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": true,
- "cte_in_subquery": true,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": true,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": true,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 73,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Greenplum": {
+ "engine": "greenplum",
+ "engine_name": "Greenplum",
+ "module": "greenplum",
"documentation": {
- "description": "Google Cloud Datastore is a highly scalable NoSQL database for your applications.",
- "logo": "datastore.png",
- "homepage_url": "https://cloud.google.com/datastore/",
- "categories": ["Cloud - Google", "Search & NoSQL", "Proprietary"],
- "pypi_packages": ["python-datastore-sqlalchemy"],
- "connection_string": "datastore://{project_id}/?database={database_id}",
- "authentication_methods": [
- {
- "name": "Service Account JSON",
- "description": "Upload service account credentials JSON or paste in Secure Extra",
- "secure_extra": {
- "credentials_info": {
- "type": "service_account",
- "project_id": "...",
- "private_key_id": "...",
- "private_key": "...",
- "client_email": "...",
- "client_id": "...",
- "auth_uri": "...",
- "token_uri": "..."
- }
- }
- }
+ "description": "VMware Greenplum is a massively parallel processing (MPP) database built on PostgreSQL.",
+ "logo": "greenplum.png",
+ "homepage_url": "https://greenplum.org/",
+ "pypi_packages": [
+ "psycopg2",
+ "sqlalchemy-greenplum",
+ "psycopg2"
],
- "notes": "Create a Service Account via GCP console with access to datastore datasets.",
- "docs_url": "https://github.com/splasky/Python-datastore-sqlalchemy",
- "category": "Cloud - Google",
- "custom_errors": [
- {
- "regex_name": "CONNECTION_DATABASE_PERMISSIONS_REGEX",
- "message_template": "Unable to connect. Verify that the following roles are set on the service account: \"Cloud Datastore Viewer\", \"Cloud Datastore User\", \"Cloud Datastore Creator\"",
- "error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
- "category": "Permissions",
- "description": "Insufficient permissions",
- "issue_codes": [1017]
- },
- {
- "regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
- "message_template": "The table \"%(table)s\" does not exist. A valid table must be used to run this query.",
- "error_type": "TABLE_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Table not found",
- "issue_codes": [1003, 1005]
- },
- {
- "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
- "message_template": "We can't seem to resolve column \"%(column)s\" at line %(location)s.",
- "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Column not found",
- "issue_codes": [1003, 1004]
- },
+ "connection_string": "greenplum://{username}:{password}@{host}:{port}/{database}",
+ "default_port": 5432,
+ "parameters": {
+ "username": "Database username",
+ "password": "Database password",
+ "host": "Greenplum coordinator host",
+ "port": "Default 5432",
+ "database": "Database name"
+ },
+ "notes": "The psycopg2 library comes bundled with Superset Docker images.",
+ "connection_examples": [
{
- "regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
- "message_template": "The schema \"%(schema)s\" does not exist. A valid schema must be used to run this query.",
- "error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Schema not found",
- "issue_codes": [1003, 1016]
+ "description": "Basic connection",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
},
{
- "regex_name": "SYNTAX_ERROR_REGEX",
- "message_template": "Please check your query for syntax errors at or near \"%(syntax_error)s\". Then, try running your query again.",
- "error_type": "SYNTAX_ERROR",
- "category": "Query",
- "description": "SQL syntax error",
- "issue_codes": [1030]
+ "description": "With SSL required",
+ "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
+ ],
+ "docs_url": "https://docs.vmware.com/en/VMware-Greenplum/",
+ "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
]
},
- "engine": "datastore",
- "engine_name": "Google Datastore",
- "engine_aliases": [],
- "default_driver": "datastore",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Google Sheets": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -4916,65 +3003,53 @@
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": true,
- "HALF_HOUR": true,
+ "HALF_HOUR": false,
"HOUR": true,
- "SIX_HOURS": true,
+ "SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
- "WEEK_STARTING_MONDAY": true,
- "WEEK_ENDING_SATURDAY": true,
- "WEEK_ENDING_SUNDAY": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
- "QUARTER_YEAR": true,
+ "QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.gsheets",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 94,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": true,
- "user_impersonation": true,
- "file_upload": true,
- "get_extra_table_metadata": true,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": true,
"sql_validation": false,
- "score": 61,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Google Sheets": {
+ "engine": "google_sheets",
+ "engine_name": "Google Sheets",
+ "module": "gsheets",
"documentation": {
"description": "Google Sheets allows querying spreadsheets as SQL tables via shillelagh.",
"logo": "google-sheets.svg",
"homepage_url": "https://www.google.com/sheets/about/",
- "categories": ["Cloud - Google", "Hosted Open Source"],
- "pypi_packages": ["shillelagh[gsheetsapi]"],
- "install_instructions": "pip install \"apache-superset[gsheets]\"",
+ "pypi_packages": [
+ "shillelagh[gsheetsapi]",
+ "shillelagh[gsheetsapi]"
+ ],
"connection_string": "gsheets://",
"notes": "Requires Google service account credentials or OAuth2 authentication. See docs for setup instructions.",
- "category": "Cloud - Google",
+ "categories": [
+ "CLOUD_GCP",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "install_instructions": "pip install \"apache-superset[gsheets]\"",
"custom_errors": [
{
"regex_name": "SYNTAX_ERROR_REGEX",
@@ -4982,20 +3057,12 @@
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
}
]
},
- "engine": "gsheets",
- "engine_name": "Google Sheets",
- "engine_aliases": [],
- "default_driver": "apsw",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Greenplum": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -5005,11 +3072,69 @@
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": true,
+ "HALF_HOUR": true,
+ "HOUR": true,
+ "SIX_HOURS": true,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_MONDAY": true,
+ "WEEK_ENDING_SATURDAY": true,
+ "WEEK_ENDING_SUNDAY": true,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": true,
+ "YEAR": true
+ },
+ "score": 61,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": false,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": true
+ },
+ "SAP HANA": {
+ "engine": "sap_hana",
+ "engine_name": "SAP HANA",
+ "module": "hana",
+ "documentation": {
+ "description": "SAP HANA is an in-memory relational database and application platform.",
+ "logo": "sap-hana.png",
+ "homepage_url": "https://www.sap.com/products/technology-platform/hana.html",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "hdbcli",
+ "sqlalchemy-hana"
+ ],
+ "install_instructions": "pip install apache_superset[hana]",
+ "connection_string": "hana://{username}:{password}@{host}:{port}",
+ "default_port": 30015,
+ "docs_url": "https://github.com/SAP/sqlalchemy-hana"
+ },
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
- "WEEK": true,
+ "WEEK": false,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
@@ -5019,137 +3144,107 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.greenplum",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 27,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 63,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
"sql_validation": false,
- "score": 94,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Apache Hive": {
+ "engine": "apache_hive",
+ "engine_name": "Apache Hive",
+ "module": "hive",
"documentation": {
- "description": "VMware Greenplum is a massively parallel processing (MPP) database built on PostgreSQL.",
- "logo": "greenplum.png",
- "homepage_url": "https://greenplum.org/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["sqlalchemy-greenplum", "psycopg2"],
- "connection_string": "greenplum://{username}:{password}@{host}:{port}/{database}",
- "default_port": 5432,
+ "description": "Apache Hive is a data warehouse infrastructure built on Hadoop.",
+ "logo": "apache-hive.svg",
+ "homepage_url": "https://hive.apache.org/",
+ "pypi_packages": [
+ "pyhive",
+ "pyhive"
+ ],
+ "install_instructions": "pip install \"apache-superset[presto]\"",
+ "connection_string": "hive://hive@{hostname}:{port}/{database}",
+ "default_port": 10000,
"parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "Greenplum coordinator host",
- "port": "Default 5432",
- "database": "Database name"
+ "hostname": "Presto coordinator hostname",
+ "port": "Presto coordinator port (default 8080)",
+ "database": "Catalog name"
},
- "docs_url": "https://docs.vmware.com/en/VMware-Greenplum/",
- "category": "Other Databases"
+ "drivers": [
+ {
+ "name": "PyHive",
+ "pypi_package": "pyhive",
+ "connection_string": "presto://{hostname}:{port}/{database}",
+ "is_recommended": true
+ }
+ ],
+ "categories": [
+ "APACHE_PROJECTS",
+ "QUERY_ENGINES",
+ "OPEN_SOURCE"
+ ]
},
- "engine": "greenplum",
- "engine_name": "Greenplum",
- "engine_aliases": ["postgres"],
- "default_driver": "psycopg2",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "Hologres": {
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": true,
- "THIRTY_SECONDS": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_SUNDAY": true,
"WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SATURDAY": true,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.hologres",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 140,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": false,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": true,
"sql_validation": false,
- "score": 34,
- "max_score": 201,
+ "user_impersonation": true
+ },
+ "Hologres": {
+ "engine": "hologres",
+ "engine_name": "Hologres",
+ "module": "hologres",
"documentation": {
"description": "Alibaba Cloud Hologres is a real-time interactive analytics service, fully compatible with PostgreSQL 11.",
"logo": "hologres.png",
"homepage_url": "https://www.alibabacloud.com/product/hologres",
"categories": [
- "Cloud Data Warehouses",
- "Analytical Databases",
- "Proprietary"
+ "CLOUD_DATA_WAREHOUSES",
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "psycopg2"
],
- "pypi_packages": ["psycopg2"],
"connection_string": "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "AccessKey ID of your Alibaba Cloud account",
@@ -5159,28 +3254,17 @@
"database": "Name of the Hologres database"
},
"default_port": 80,
- "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.",
- "category": "Other Databases"
+ "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset."
},
- "engine": "hologres",
- "engine_name": "Hologres",
- "engine_aliases": [],
- "default_driver": "psycopg2",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "IBM Db2": {
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
"MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
@@ -5195,47 +3279,35 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.db2",
- "limit_method": 2,
- "limit_clause": true,
+ "score": 34,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 30,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 38,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "IBM Db2 for i": {
+ "engine": "ibm_db2_for_i",
+ "engine_name": "IBM Db2 for i",
+ "module": "ibmi",
"documentation": {
"description": "IBM Db2 is a family of data management products for enterprise workloads, available on-premises, in containers, and across cloud platforms.",
"logo": "ibm-db2.svg",
"homepage_url": "https://www.ibm.com/db2",
- "categories": ["Traditional RDBMS", "Proprietary"],
- "pypi_packages": ["ibm_db_sa"],
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "ibm_db_sa"
+ ],
"connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}",
"default_port": 50000,
"drivers": [
@@ -5251,39 +3323,66 @@
"notes": "Use for older DB2 versions without LIMIT [n] syntax. Recommended for SQL Lab."
}
],
- "compatible_databases": [
- {
- "name": "IBM Db2 for i (AS/400)",
- "description": "Db2 for i is a fully integrated database engine on IBM i (AS/400) systems. Uses a different SQLAlchemy driver optimized for IBM i.",
- "logo": "ibm-db2.svg",
- "homepage_url": "https://www.ibm.com/products/db2-for-i",
- "pypi_packages": ["sqlalchemy-ibmi"],
- "connection_string": "ibmi://{username}:{password}@{host}/{database}",
- "parameters": {
- "username": "IBM i username",
- "password": "IBM i password",
- "host": "IBM i system host",
- "database": "Library/schema name"
- },
- "docs_url": "https://github.com/IBM/sqlalchemy-ibmi",
- "categories": ["Proprietary"]
- }
- ],
- "docs_url": "https://github.com/ibmdb/python-ibmdbsa",
- "category": "Other Databases"
+ "docs_url": "https://github.com/ibmdb/python-ibmdbsa"
},
- "engine": "db2",
- "engine_name": "IBM Db2",
- "engine_aliases": ["ibm_db_sa"],
- "default_driver": null,
- "supports_file_upload": true,
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 38,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
"supports_dynamic_schema": true,
"supports_catalog": false,
- "supports_dynamic_catalog": false
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
},
- "IBM Db2 for i": {
+ "Apache Impala": {
+ "engine": "apache_impala",
+ "engine_name": "Apache Impala",
+ "module": "impala",
+ "documentation": {
+ "description": "Apache Impala is an open-source massively parallel processing SQL query engine.",
+ "logo": "apache-impala.png",
+ "homepage_url": "https://impala.apache.org/",
+ "categories": [
+ "APACHE_PROJECTS",
+ "QUERY_ENGINES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "impyla"
+ ],
+ "connection_string": "impala://{hostname}:{port}/{database}",
+ "default_port": 21050
+ },
"time_grains": {
- "SECOND": true,
+ "SECOND": false,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
@@ -5305,109 +3404,148 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.ibmi",
- "limit_method": 2,
- "limit_clause": true,
+ "score": 37,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
+ "supports_file_upload": true,
+ "query_cancelation": true,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 38,
+ "user_impersonation": false
+ },
+ "Apache IoTDB": {
+ "engine": "apache_iotdb",
+ "engine_name": "Apache IoTDB",
+ "module": "iotdb",
+ "documentation": {
+ "description": "Apache IoTDB is a time series database designed for IoT data, with efficient storage and query capabilities for massive time series data.",
+ "logo": "apache-iotdb.svg",
+ "homepage_url": "https://iotdb.apache.org/",
+ "categories": [
+ "APACHE_PROJECTS",
+ "TIME_SERIES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "apache-iotdb"
+ ],
+ "connection_string": "iotdb://{username}:{password}@{hostname}:{port}",
+ "default_port": 6667,
+ "parameters": {
+ "username": "Database username (default: root)",
+ "password": "Database password (default: root)",
+ "hostname": "IP address or hostname",
+ "port": "Default 6667"
+ },
+ "notes": "The IoTDB SQLAlchemy dialect was written to integrate with Apache Superset. IoTDB uses a hierarchical data model, which is reorganized into a relational model for SQL queries."
+ },
+ "time_grains": {
+ "SECOND": false,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": false,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": false,
+ "SIX_HOURS": false,
+ "DAY": false,
+ "WEEK": false,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": false,
+ "QUARTER": false,
+ "QUARTER_YEAR": false,
+ "YEAR": false
+ },
+ "score": 20,
"max_score": 201,
+ "joins": true,
+ "subqueries": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
+ },
+ "Azure Data Explorer": {
+ "engine": "azure_data_explorer",
+ "engine_name": "Azure Data Explorer",
+ "module": "kusto",
"documentation": {
- "description": "IBM Db2 is a family of data management products for enterprise workloads, available on-premises, in containers, and across cloud platforms.",
- "logo": "ibm-db2.svg",
- "homepage_url": "https://www.ibm.com/db2",
- "categories": ["Traditional RDBMS", "Proprietary"],
- "pypi_packages": ["ibm_db_sa"],
- "connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}",
- "default_port": 50000,
+ "description": "Azure Data Explorer (Kusto) is a fast, fully managed data analytics service from Microsoft Azure. Query data using SQL or native KQL syntax.",
+ "logo": "kusto.png",
+ "homepage_url": "https://azure.microsoft.com/en-us/products/data-explorer/",
+ "categories": [
+ "CLOUD_AZURE",
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-kusto"
+ ],
+ "connection_string": "kustosql+https://{cluster}.kusto.windows.net/{database}?msi=False&azure_ad_client_id={client_id}&azure_ad_client_secret={client_secret}&azure_ad_tenant_id={tenant_id}",
+ "parameters": {
+ "cluster": "Azure Data Explorer cluster name",
+ "database": "Database name",
+ "client_id": "Azure AD application (client) ID",
+ "client_secret": "Azure AD application secret",
+ "tenant_id": "Azure AD tenant ID"
+ },
"drivers": [
{
- "name": "ibm_db_sa (with LIMIT)",
- "connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}",
- "is_recommended": true
+ "name": "SQL Interface (Recommended)",
+ "pypi_package": "sqlalchemy-kusto",
+ "connection_string": "kustosql+https://{cluster}.kusto.windows.net/{database}?msi=False&azure_ad_client_id={client_id}&azure_ad_client_secret={client_secret}&azure_ad_tenant_id={tenant_id}",
+ "is_recommended": true,
+ "notes": "Use familiar SQL syntax to query Azure Data Explorer."
},
{
- "name": "ibm_db_sa (without LIMIT syntax)",
- "connection_string": "ibm_db_sa://{username}:{password}@{hostname}:{port}/{database}",
+ "name": "KQL (Kusto Query Language)",
+ "pypi_package": "sqlalchemy-kusto",
+ "connection_string": "kustokql+https://{cluster}.kusto.windows.net/{database}?msi=False&azure_ad_client_id={client_id}&azure_ad_client_secret={client_secret}&azure_ad_tenant_id={tenant_id}",
"is_recommended": false,
- "notes": "Use for older DB2 versions without LIMIT [n] syntax. Recommended for SQL Lab."
- }
- ],
- "compatible_databases": [
- {
- "name": "IBM Db2 for i (AS/400)",
- "description": "Db2 for i is a fully integrated database engine on IBM i (AS/400) systems. Uses a different SQLAlchemy driver optimized for IBM i.",
- "logo": "ibm-db2.svg",
- "homepage_url": "https://www.ibm.com/products/db2-for-i",
- "pypi_packages": ["sqlalchemy-ibmi"],
- "connection_string": "ibmi://{username}:{password}@{host}/{database}",
- "parameters": {
- "username": "IBM i username",
- "password": "IBM i password",
- "host": "IBM i system host",
- "database": "Library/schema name"
- },
- "docs_url": "https://github.com/IBM/sqlalchemy-ibmi",
- "categories": ["Proprietary"]
+ "notes": "Use native Kusto Query Language for advanced analytics."
}
],
- "docs_url": "https://github.com/ibmdb/python-ibmdbsa",
- "category": "Other Databases"
- },
- "engine": "ibmi",
- "engine_name": "IBM Db2 for i",
- "engine_aliases": ["ibm_db_sa"],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "IBM Netezza Performance Server": {
+ "known_incompatibilities": [
+ {
+ "dependency": "SQLAlchemy 2.0",
+ "reason": "setup.py on the sqlalchemy-kusto main branch hard-pins sqlalchemy==1.4.*; no SQLAlchemy 2.0 work has started.",
+ "tracking_url": "https://github.com/dodopizza/sqlalchemy-kusto",
+ "since": "2026-07-28"
+ }
+ ]
+ },
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": false,
- "HALF_HOUR": false,
+ "HALF_HOUR": true,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
+ "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -5415,61 +3553,39 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.netezza",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 54,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 28,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Apache Kylin": {
+ "engine": "apache_kylin",
+ "engine_name": "Apache Kylin",
+ "module": "kylin",
"documentation": {
- "description": "IBM Netezza Performance Server is a data warehouse appliance.",
- "logo": "netezza.png",
- "homepage_url": "https://www.ibm.com/products/netezza",
- "categories": ["Traditional RDBMS", "Proprietary"],
- "pypi_packages": ["nzalchemy"],
- "connection_string": "netezza+nzpy://{username}:{password}@{hostname}:{port}/{database}",
- "default_port": 5480,
- "category": "Other Databases"
+ "description": "Apache Kylin is an open-source OLAP engine for big data.",
+ "logo": "apache-kylin.png",
+ "homepage_url": "https://kylin.apache.org/",
+ "categories": [
+ "APACHE_PROJECTS",
+ "ANALYTICAL_DATABASES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "kylinpy"
+ ],
+ "connection_string": "kylin://{username}:{password}@{hostname}:{port}/{project}?{param1}={value1}&{param2}={value2}",
+ "default_port": 7070
},
- "engine": "netezza",
- "engine_name": "IBM Netezza Performance Server",
- "engine_aliases": [],
- "default_driver": "nzpy",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "MariaDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -5485,7 +3601,7 @@
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -5493,77 +3609,95 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.mariadb",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 64,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
+ "supports_file_upload": true,
+ "query_cancelation": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 59,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "MariaDB": {
+ "engine": "mariadb",
+ "engine_name": "MariaDB",
+ "module": "mariadb",
"documentation": {
"description": "MariaDB is a community-developed fork of MySQL.",
"logo": "mariadb.png",
"homepage_url": "https://mariadb.org/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["mysqlclient"],
+ "pypi_packages": [
+ "mysqlclient",
+ "mysqlclient"
+ ],
"connection_string": "mysql://{username}:{password}@{host}/{database}",
"default_port": 3306,
- "notes": "Uses the MySQL driver. Fully compatible with MySQL connector.",
- "category": "Traditional RDBMS"
+ "parameters": {
+ "username": "Database username",
+ "password": "Database password",
+ "host": "localhost, 127.0.0.1, IP address, or hostname",
+ "database": "Database name"
+ },
+ "host_examples": [
+ {
+ "platform": "Localhost",
+ "host": "localhost or 127.0.0.1"
+ },
+ {
+ "platform": "Docker on Linux",
+ "host": "172.18.0.1"
+ },
+ {
+ "platform": "Docker on macOS",
+ "host": "docker.for.mac.host.internal"
+ },
+ {
+ "platform": "On-premise",
+ "host": "IP address or hostname"
+ }
+ ],
+ "drivers": [
+ {
+ "name": "mysqlclient",
+ "pypi_package": "mysqlclient",
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
+ "is_recommended": true,
+ "notes": "Recommended driver. May fail with caching_sha2_password auth."
+ },
+ {
+ "name": "mysql-connector-python",
+ "pypi_package": "mysql-connector-python",
+ "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
+ "is_recommended": false,
+ "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
+ }
+ ],
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "notes": "Uses the MySQL driver. Fully compatible with MySQL connector."
},
- "engine": "mariadb",
- "engine_name": "MariaDB",
- "engine_aliases": [],
- "default_driver": "mysqldb",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Microsoft SQL Server": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": true,
- "TEN_MINUTES": true,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
@@ -5572,111 +3706,47 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.mssql",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 59,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": false,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
+ "supports_file_upload": true,
+ "query_cancelation": true,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 44,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "MonetDB": {
+ "engine": "monetdb",
+ "engine_name": "MonetDB",
+ "module": "monetdb",
"documentation": {
- "description": "Microsoft SQL Server is a relational database management system.",
- "logo": "msql.png",
- "homepage_url": "https://www.microsoft.com/en-us/sql-server",
- "categories": ["Traditional RDBMS", "Proprietary"],
- "pypi_packages": ["pymssql"],
- "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
- "default_port": 1433,
- "drivers": [
- {
- "name": "pymssql",
- "pypi_package": "pymssql",
- "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
- "is_recommended": true
- },
- {
- "name": "pyodbc",
- "pypi_package": "pyodbc",
- "connection_string": "mssql+pyodbc:///?odbc_connect=Driver%3D%7BODBC+Driver+17+for+SQL+Server%7D%3BServer%3Dtcp%3A%3C{host}%3E%2C1433%3BDatabase%3D{database}%3BUid%3D{username}%3BPwd%3D{password}%3BEncrypt%3Dyes%3BConnection+Timeout%3D30",
- "is_recommended": false,
- "notes": "Connection string must be URL-encoded. Special characters like @ need encoding."
- }
+ "description": "MonetDB is an open-source column-oriented relational database for high-performance analytics.",
+ "logo": "monet-db.png",
+ "homepage_url": "https://www.monetdb.org/",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
],
- "docs_url": "https://docs.sqlalchemy.org/en/20/core/engines.html#escaping-special-characters-such-as-signs-in-passwords",
- "category": "Cloud - Azure",
- "custom_errors": [
- {
- "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
- "message_template": "Either the username \"%(username)s\", password, or database name \"%(database)s\" is incorrect.",
- "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
- "category": "Authentication",
- "description": "Access denied",
- "issue_codes": [1014, 1015]
- },
- {
- "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
- "message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
- "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
- "category": "Connection",
- "description": "Invalid hostname",
- "issue_codes": [1007]
- },
- {
- "regex_name": "CONNECTION_PORT_CLOSED_REGEX",
- "message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
- "error_type": "CONNECTION_PORT_CLOSED_ERROR",
- "category": "Connection",
- "description": "Port closed or refused",
- "issue_codes": [1008]
- },
- {
- "regex_name": "CONNECTION_HOST_DOWN_REGEX",
- "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
- "error_type": "CONNECTION_HOST_DOWN_ERROR",
- "category": "Connection",
- "description": "Host unreachable",
- "issue_codes": [1009]
- }
- ]
+ "pypi_packages": [
+ "sqlalchemy-monetdb",
+ "pymonetdb"
+ ],
+ "connection_string": "monetdb://{username}:{password}@{host}:{port}/{database}",
+ "default_port": 50000,
+ "parameters": {
+ "username": "Database username (default: monetdb)",
+ "password": "Database password (default: monetdb)",
+ "host": "MonetDB server host",
+ "port": "Default 50000",
+ "database": "Database name"
+ },
+ "docs_url": "https://www.monetdb.org/documentation/"
},
- "engine": "mssql",
- "engine_name": "Microsoft SQL Server",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "MonetDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -5700,69 +3770,62 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.monetdb",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 26,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 26,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "MongoDB": {
+ "engine": "mongodb",
+ "engine_name": "MongoDB",
+ "module": "mongodb",
"documentation": {
- "description": "MonetDB is an open-source column-oriented relational database for high-performance analytics.",
- "logo": "monet-db.png",
- "homepage_url": "https://www.monetdb.org/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["sqlalchemy-monetdb", "pymonetdb"],
- "connection_string": "monetdb://{username}:{password}@{host}:{port}/{database}",
- "default_port": 50000,
+ "description": "MongoDB is a document-oriented, operational NoSQL database.",
+ "logo": "mongodb.png",
+ "homepage_url": "https://www.mongodb.com/",
+ "categories": [
+ "SEARCH_NOSQL",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "pymongosql"
+ ],
+ "connection_string": "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset",
"parameters": {
- "username": "Database username (default: monetdb)",
- "password": "Database password (default: monetdb)",
- "host": "MonetDB server host",
- "port": "Default 50000",
+ "username": "Username for MongoDB",
+ "password": "Password for MongoDB",
+ "host": "MongoDB host",
+ "port": "MongoDB port",
"database": "Database name"
},
- "docs_url": "https://www.monetdb.org/documentation/",
- "category": "Other Databases"
- },
- "engine": "monetdb",
- "engine_name": "MonetDB",
- "engine_aliases": [],
- "default_driver": "pymonetdb",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "MongoDB": {
+ "drivers": [
+ {
+ "name": "MongoDB Atlas Cloud",
+ "pypi_package": "pymongosql",
+ "connection_string": "mongodb+srv://{username}:{password}@{host}/{database}?mode=superset",
+ "notes": "For MongoDB Atlas cloud service.",
+ "is_recommended": true
+ },
+ {
+ "name": "MongoDB Cluster",
+ "pypi_package": "pymongosql",
+ "connection_string": "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset",
+ "is_recommended": false,
+ "notes": "For self-hosted MongoDB instances."
+ }
+ ],
+ "notes": "Uses PartiQL for SQL queries. Requires mode=superset parameter.",
+ "docs_url": "https://github.com/passren/PyMongoSQL"
+ },
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -5786,101 +3849,113 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.mongodb",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 32,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 32,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Microsoft SQL Server": {
+ "engine": "microsoft_sql_server",
+ "engine_name": "Microsoft SQL Server",
+ "module": "mssql",
"documentation": {
- "description": "MongoDB is a document-oriented, operational NoSQL database.",
- "logo": "mongodb.png",
- "homepage_url": "https://www.mongodb.com/",
- "categories": ["Search & NoSQL", "Proprietary"],
- "pypi_packages": ["pymongosql"],
- "connection_string": "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset",
- "parameters": {
- "username": "Username for MongoDB",
- "password": "Password for MongoDB",
- "host": "MongoDB host",
- "port": "MongoDB port",
- "database": "Database name"
- },
+ "description": "Microsoft SQL Server is a relational database management system.",
+ "logo": "msql.png",
+ "homepage_url": "https://www.microsoft.com/en-us/sql-server",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "pymssql"
+ ],
+ "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
+ "default_port": 1433,
"drivers": [
{
- "name": "MongoDB Atlas Cloud",
- "pypi_package": "pymongosql",
- "connection_string": "mongodb+srv://{username}:{password}@{host}/{database}?mode=superset",
- "notes": "For MongoDB Atlas cloud service.",
+ "name": "pymssql",
+ "pypi_package": "pymssql",
+ "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
"is_recommended": true
},
{
- "name": "MongoDB Cluster",
- "pypi_package": "pymongosql",
- "connection_string": "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset",
+ "name": "pyodbc",
+ "pypi_package": "pyodbc",
+ "connection_string": "mssql+pyodbc:///?odbc_connect=Driver%3D%7BODBC+Driver+17+for+SQL+Server%7D%3BServer%3Dtcp%3A%3C{host}%3E%2C1433%3BDatabase%3D{database}%3BUid%3D{username}%3BPwd%3D{password}%3BEncrypt%3Dyes%3BConnection+Timeout%3D30",
"is_recommended": false,
- "notes": "For self-hosted MongoDB instances."
+ "notes": "Connection string must be URL-encoded. Special characters like @ need encoding."
}
],
- "notes": "Uses PartiQL for SQL queries. Requires mode=superset parameter.",
- "docs_url": "https://github.com/passren/PyMongoSQL",
- "category": "Other Databases"
+ "docs_url": "https://docs.sqlalchemy.org/en/20/core/engines.html#escaping-special-characters-such-as-signs-in-passwords",
+ "custom_errors": [
+ {
+ "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
+ "message_template": "Either the username \"%(username)s\", password, or database name \"%(database)s\" is incorrect.",
+ "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
+ "category": "Authentication",
+ "description": "Access denied",
+ "issue_codes": [
+ 1014,
+ 1015
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
+ "message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
+ "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
+ "category": "Connection",
+ "description": "Invalid hostname",
+ "issue_codes": [
+ 1007
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_PORT_CLOSED_REGEX",
+ "message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
+ "error_type": "CONNECTION_PORT_CLOSED_ERROR",
+ "category": "Connection",
+ "description": "Port closed or refused",
+ "issue_codes": [
+ 1008
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_HOST_DOWN_REGEX",
+ "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
+ "error_type": "CONNECTION_HOST_DOWN_ERROR",
+ "category": "Connection",
+ "description": "Host unreachable",
+ "issue_codes": [
+ 1009
+ ]
+ }
+ ]
},
- "engine": "mongodb",
- "engine_name": "MongoDB",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "MotherDuck": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
+ "WEEK_STARTING_SUNDAY": true,
+ "WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -5888,102 +3963,114 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.duckdb",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 44,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": true,
- "dynamic_catalog": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 58,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Azure Synapse": {
+ "engine": "azure_synapse",
+ "engine_name": "Azure Synapse",
+ "module": "mssql",
"documentation": {
- "description": "MotherDuck is a serverless cloud analytics platform built on DuckDB. It combines the simplicity of DuckDB with cloud-scale data sharing and collaboration.",
- "logo": "motherduck.png",
- "homepage_url": "https://motherduck.com/",
- "categories": [
- "Analytical Databases",
- "Cloud Data Warehouses",
- "Hosted Open Source"
+ "description": "Azure Synapse Analytics is a cloud-based enterprise data warehouse from Microsoft that combines big data and data warehousing.",
+ "logo": "azure.svg",
+ "homepage_url": "https://azure.microsoft.com/en-us/products/synapse-analytics/",
+ "pypi_packages": [
+ "pymssql",
+ "pymssql"
],
- "pypi_packages": ["duckdb", "duckdb-engine"],
- "connection_string": "duckdb:///md:{database}?motherduck_token={token}",
- "parameters": {
- "database": "MotherDuck database name",
- "token": "Service token from MotherDuck dashboard"
- },
- "docs_url": "https://motherduck.com/docs/getting-started/",
+ "connection_string": "mssql+pymssql://{username}@{server}:{password}@{server}.database.windows.net:1433/{database}",
+ "default_port": 1433,
"drivers": [
{
- "name": "duckdb-engine",
- "pypi_package": "duckdb-engine",
- "connection_string": "duckdb:///md:{database}?motherduck_token={token}",
+ "name": "pymssql",
+ "pypi_package": "pymssql",
+ "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
"is_recommended": true
+ },
+ {
+ "name": "pyodbc",
+ "pypi_package": "pyodbc",
+ "connection_string": "mssql+pyodbc:///?odbc_connect=Driver%3D%7BODBC+Driver+17+for+SQL+Server%7D%3BServer%3Dtcp%3A%3C{host}%3E%2C1433%3BDatabase%3D{database}%3BUid%3D{username}%3BPwd%3D{password}%3BEncrypt%3Dyes%3BConnection+Timeout%3D30",
+ "is_recommended": false,
+ "notes": "Connection string must be URL-encoded. Special characters like @ need encoding."
}
],
- "category": "Other Databases",
+ "docs_url": "https://docs.sqlalchemy.org/en/20/core/engines.html#escaping-special-characters-such-as-signs-in-passwords",
+ "categories": [
+ "CLOUD_DATA_WAREHOUSES",
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
"custom_errors": [
{
- "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
- "message_template": "We can't seem to resolve the column \"%(column_name)s\"",
- "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Column not found",
- "issue_codes": [1003, 1004]
+ "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
+ "message_template": "Either the username \"%(username)s\", password, or database name \"%(database)s\" is incorrect.",
+ "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
+ "category": "Authentication",
+ "description": "Access denied",
+ "issue_codes": [
+ 1014,
+ 1015
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
+ "message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
+ "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
+ "category": "Connection",
+ "description": "Invalid hostname",
+ "issue_codes": [
+ 1007
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_PORT_CLOSED_REGEX",
+ "message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
+ "error_type": "CONNECTION_PORT_CLOSED_ERROR",
+ "category": "Connection",
+ "description": "Port closed or refused",
+ "issue_codes": [
+ 1008
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_HOST_DOWN_REGEX",
+ "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
+ "error_type": "CONNECTION_HOST_DOWN_ERROR",
+ "category": "Connection",
+ "description": "Host unreachable",
+ "issue_codes": [
+ 1009
+ ]
}
]
},
- "engine": "motherduck",
- "engine_name": "MotherDuck",
- "engine_aliases": ["duckdb"],
- "default_driver": "duckdb_engine",
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": true,
- "supports_dynamic_catalog": true
- },
- "MySQL": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
- "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_SUNDAY": true,
"WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
@@ -5992,47 +4079,35 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.mysql",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 44,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 64,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
+ "supports_file_upload": true,
+ "query_cancelation": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 59,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "MySQL": {
+ "engine": "mysql",
+ "engine_name": "MySQL",
+ "module": "mysql",
"documentation": {
"description": "MySQL is a popular open-source relational database.",
"logo": "mysql.png",
"homepage_url": "https://www.mysql.com/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["mysqlclient"],
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "mysqlclient"
+ ],
"connection_string": "mysql://{username}:{password}@{host}/{database}",
"default_port": 3306,
"parameters": {
@@ -6081,16 +4156,22 @@
"description": "MariaDB is a community-developed fork of MySQL, fully compatible with MySQL.",
"logo": "mariadb.png",
"homepage_url": "https://mariadb.org/",
- "pypi_packages": ["mysqlclient"],
+ "pypi_packages": [
+ "mysqlclient"
+ ],
"connection_string": "mysql://{username}:{password}@{host}:{port}/{database}",
- "categories": ["Open Source"]
+ "categories": [
+ "OPEN_SOURCE"
+ ]
},
{
"name": "Amazon Aurora MySQL",
"description": "Amazon Aurora MySQL is a fully managed, MySQL-compatible relational database with up to 5x the throughput of standard MySQL.",
"logo": "aws-aurora.jpg",
"homepage_url": "https://aws.amazon.com/rds/aurora/",
- "pypi_packages": ["sqlalchemy-aurora-data-api"],
+ "pypi_packages": [
+ "sqlalchemy-aurora-data-api"
+ ],
"connection_string": "mysql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}®ion_name={region_name}",
"parameters": {
"aws_access_id": "AWS Access Key ID",
@@ -6101,10 +4182,20 @@
"region_name": "AWS region (e.g., us-east-1)"
},
"notes": "Uses the Data API for serverless access. Standard MySQL connections also work with mysqlclient.",
- "categories": ["Cloud - AWS", "Hosted Open Source"]
+ "categories": [
+ "CLOUD_AWS",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "known_incompatibilities": [
+ {
+ "dependency": "SQLAlchemy 2.0",
+ "reason": "Neither our fork (preset-io/sqlalchemy-aurora-data-api, dormant since 2021) nor the more active community fork (cloud-utils/sqlalchemy-aurora-data-api) has resolved SQLAlchemy 2.0 compatibility.",
+ "tracking_url": "https://github.com/cloud-utils/sqlalchemy-aurora-data-api/issues/43",
+ "since": "2026-07-28"
+ }
+ ]
}
],
- "category": "Traditional RDBMS",
"custom_errors": [
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
@@ -6112,8 +4203,14 @@
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
- "issue_codes": [1014, 1015],
- "invalid_fields": ["username", "password"]
+ "issue_codes": [
+ 1014,
+ 1015
+ ],
+ "invalid_fields": [
+ "username",
+ "password"
+ ]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
@@ -6121,8 +4218,12 @@
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
- "issue_codes": [1007],
- "invalid_fields": ["host"]
+ "issue_codes": [
+ 1007
+ ],
+ "invalid_fields": [
+ "host"
+ ]
},
{
"regex_name": "CONNECTION_HOST_DOWN_REGEX",
@@ -6130,8 +4231,13 @@
"error_type": "CONNECTION_HOST_DOWN_ERROR",
"category": "Connection",
"description": "Host unreachable",
- "issue_codes": [1009],
- "invalid_fields": ["host", "port"]
+ "issue_codes": [
+ 1009
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
},
{
"regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
@@ -6139,8 +4245,12 @@
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
- "issue_codes": [1015],
- "invalid_fields": ["database"]
+ "issue_codes": [
+ 1015
+ ],
+ "invalid_fields": [
+ "database"
+ ]
},
{
"regex_name": "SYNTAX_ERROR_REGEX",
@@ -6148,20 +4258,12 @@
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
}
]
},
- "engine": "mysql",
- "engine_name": "MySQL",
- "engine_aliases": [],
- "default_driver": "mysqldb",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "OceanBase": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -6177,7 +4279,62 @@
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
+ "WEEK_STARTING_MONDAY": true,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 59,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
+ },
+ "IBM Netezza Performance Server": {
+ "engine": "ibm_netezza_performance_server",
+ "engine_name": "IBM Netezza Performance Server",
+ "module": "netezza",
+ "documentation": {
+ "description": "IBM Netezza Performance Server is a data warehouse appliance.",
+ "logo": "netezza.png",
+ "homepage_url": "https://www.ibm.com/products/netezza",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "nzalchemy"
+ ],
+ "connection_string": "netezza+nzpy://{username}:{password}@{hostname}:{port}/{database}",
+ "default_port": 5480
+ },
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -6185,49 +4342,78 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.oceanbase",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
+ "supports_file_upload": true,
+ "query_cancelation": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 59,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "OceanBase": {
+ "engine": "oceanbase",
+ "engine_name": "OceanBase",
+ "module": "oceanbase",
"documentation": {
"description": "OceanBase is a distributed relational database.",
"logo": "oceanbase.svg",
"homepage_url": "https://www.oceanbase.com/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["oceanbase_py"],
+ "pypi_packages": [
+ "mysqlclient",
+ "oceanbase_py"
+ ],
"connection_string": "oceanbase://{username}:{password}@{host}:{port}/{database}",
- "category": "Other Databases",
+ "default_port": 3306,
+ "parameters": {
+ "username": "Database username",
+ "password": "Database password",
+ "host": "localhost, 127.0.0.1, IP address, or hostname",
+ "database": "Database name"
+ },
+ "host_examples": [
+ {
+ "platform": "Localhost",
+ "host": "localhost or 127.0.0.1"
+ },
+ {
+ "platform": "Docker on Linux",
+ "host": "172.18.0.1"
+ },
+ {
+ "platform": "Docker on macOS",
+ "host": "docker.for.mac.host.internal"
+ },
+ {
+ "platform": "On-premise",
+ "host": "IP address or hostname"
+ }
+ ],
+ "drivers": [
+ {
+ "name": "mysqlclient",
+ "pypi_package": "mysqlclient",
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
+ "is_recommended": true,
+ "notes": "Recommended driver. May fail with caching_sha2_password auth."
+ },
+ {
+ "name": "mysql-connector-python",
+ "pypi_package": "mysql-connector-python",
+ "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
+ "is_recommended": false,
+ "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
+ }
+ ],
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
"custom_errors": [
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
@@ -6235,8 +4421,14 @@
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
- "issue_codes": [1014, 1015],
- "invalid_fields": ["username", "password"]
+ "issue_codes": [
+ 1014,
+ 1015
+ ],
+ "invalid_fields": [
+ "username",
+ "password"
+ ]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
@@ -6244,8 +4436,12 @@
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
- "issue_codes": [1007],
- "invalid_fields": ["host"]
+ "issue_codes": [
+ 1007
+ ],
+ "invalid_fields": [
+ "host"
+ ]
},
{
"regex_name": "CONNECTION_HOST_DOWN_REGEX",
@@ -6253,8 +4449,13 @@
"error_type": "CONNECTION_HOST_DOWN_ERROR",
"category": "Connection",
"description": "Host unreachable",
- "issue_codes": [1009],
- "invalid_fields": ["host", "port"]
+ "issue_codes": [
+ 1009
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
},
{
"regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
@@ -6262,8 +4463,12 @@
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
- "issue_codes": [1015],
- "invalid_fields": ["database"]
+ "issue_codes": [
+ 1015
+ ],
+ "invalid_fields": [
+ "database"
+ ]
},
{
"regex_name": "SYNTAX_ERROR_REGEX",
@@ -6271,20 +4476,12 @@
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
}
]
},
- "engine": "oceanbase",
- "engine_name": "OceanBase",
- "engine_aliases": ["oceanbase", "oceanbase_py"],
- "default_driver": "oceanbase",
- "supports_file_upload": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Ocient": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -6300,56 +4497,43 @@
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
+ "WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": false,
- "QUARTER_YEAR": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.ocient",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 59,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": false,
- "max_column_name": 30,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 38,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Ocient": {
+ "engine": "ocient",
+ "engine_name": "Ocient",
+ "module": "ocient",
"documentation": {
"description": "Ocient is a hyperscale data analytics database.",
- "categories": ["Analytical Databases", "Proprietary"],
- "pypi_packages": ["sqlalchemy-ocient"],
+ "categories": [
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-ocient"
+ ],
"connection_string": "ocient://{username}:{password}@{host}:{port}/{database}",
"install_instructions": "pip install sqlalchemy-ocient",
- "category": "Other Databases",
"custom_errors": [
{
"regex_name": "CONNECTION_INVALID_USERNAME_REGEX",
@@ -6357,7 +4541,9 @@
"error_type": "CONNECTION_INVALID_USERNAME_ERROR",
"category": "Authentication",
"description": "Invalid username",
- "issue_codes": [1012]
+ "issue_codes": [
+ 1012
+ ]
},
{
"regex_name": "CONNECTION_INVALID_PASSWORD_REGEX",
@@ -6365,7 +4551,9 @@
"error_type": "CONNECTION_INVALID_PASSWORD_ERROR",
"category": "Authentication",
"description": "Invalid password",
- "issue_codes": [1013]
+ "issue_codes": [
+ 1013
+ ]
},
{
"regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
@@ -6373,7 +4561,9 @@
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
- "issue_codes": [1015]
+ "issue_codes": [
+ 1015
+ ]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
@@ -6381,7 +4571,9 @@
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
- "issue_codes": [1007]
+ "issue_codes": [
+ 1007
+ ]
},
{
"regex_name": "CONNECTION_INVALID_PORT_ERROR",
@@ -6394,7 +4586,9 @@
"error_type": "GENERIC_DB_ENGINE_ERROR",
"category": "General",
"description": "Database engine error",
- "issue_codes": [1002]
+ "issue_codes": [
+ 1002
+ ]
},
{
"regex_name": "SYNTAX_ERROR_REGEX",
@@ -6402,7 +4596,9 @@
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
},
{
"regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
@@ -6410,7 +4606,10 @@
"error_type": "TABLE_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Table not found",
- "issue_codes": [1003, 1005]
+ "issue_codes": [
+ 1003,
+ 1005
+ ]
},
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
@@ -6418,20 +4617,70 @@
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
- "issue_codes": [1003, 1004]
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
}
]
},
- "engine": "ocient",
- "engine_name": "Ocient",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
+ "MINUTE": true,
+ "FIVE_MINUTES": false,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": false,
+ "QUARTER_YEAR": true,
+ "YEAR": true
+ },
+ "score": 38,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
- "supports_dynamic_catalog": false
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
},
- "OpenSearch (OpenDistro)": {
+ "Oracle": {
+ "engine": "oracle",
+ "engine_name": "Oracle",
+ "module": "oracle",
+ "documentation": {
+ "description": "Oracle Database is a multi-model database management system.",
+ "logo": "oraclelogo.png",
+ "homepage_url": "https://www.oracle.com/database/",
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "oracledb"
+ ],
+ "connection_string": "oracle+oracledb://{username}:{password}@{hostname}:{port}",
+ "default_port": 1521,
+ "notes": "Previously used cx_Oracle, now uses oracledb.",
+ "docs_url": "https://python-oracledb.readthedocs.io/en/latest/user_guide/installation.html"
+ },
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -6445,66 +4694,53 @@
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
- "WEEK": false,
+ "WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": false,
+ "QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.elasticsearch",
- "limit_method": 1,
- "limit_clause": true,
- "joins": false,
+ "score": 28,
+ "max_score": 201,
+ "joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": true,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": false,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 26,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Parseable": {
+ "engine": "parseable",
+ "engine_name": "Parseable",
+ "module": "parseable",
"documentation": {
- "pypi_packages": [],
- "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
- "category": "Other Databases"
+ "description": "Parseable is a distributed log analytics database with SQL-like query interface.",
+ "categories": [
+ "SEARCH_NOSQL",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-parseable"
+ ],
+ "connection_string": "parseable://{username}:{password}@{hostname}:{port}/{stream_name}",
+ "connection_examples": [
+ {
+ "description": "Example connection",
+ "connection_string": "parseable://admin:admin@demo.parseable.com:443/ingress-nginx"
+ }
+ ],
+ "notes": "Stream name in URI represents the Parseable logstream to query. Supports HTTP (80) and HTTPS (443).",
+ "docs_url": "https://www.parseable.io"
},
- "engine": "odelasticsearch",
- "engine_name": "OpenSearch (OpenDistro)",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Oracle": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -6528,63 +4764,40 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.oracle",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 128,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 28,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Apache Phoenix": {
+ "engine": "apache_phoenix",
+ "engine_name": "Apache Phoenix",
+ "module": "phoenix",
"documentation": {
- "description": "Oracle Database is a multi-model database management system.",
- "logo": "oraclelogo.png",
- "homepage_url": "https://www.oracle.com/database/",
- "categories": ["Traditional RDBMS", "Proprietary"],
- "pypi_packages": ["oracledb"],
- "connection_string": "oracle+oracledb://{username}:{password}@{hostname}:{port}",
- "default_port": 1521,
- "notes": "Previously used cx_Oracle, now uses oracledb.",
- "docs_url": "https://python-oracledb.readthedocs.io/en/latest/user_guide/installation.html",
- "category": "Other Databases"
+ "description": "Apache Phoenix is a relational database layer over Apache HBase, providing low-latency SQL queries over HBase data.",
+ "logo": "apache-phoenix.png",
+ "homepage_url": "https://phoenix.apache.org/",
+ "categories": [
+ "APACHE_PROJECTS",
+ "ANALYTICAL_DATABASES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "phoenixdb"
+ ],
+ "connection_string": "phoenix://{hostname}:{port}/",
+ "default_port": 8765,
+ "notes": "Phoenix provides a SQL interface to Apache HBase. The phoenixdb driver connects via the Phoenix Query Server and supports a subset of SQLAlchemy."
},
- "engine": "oracle",
- "engine_name": "Oracle",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "Parseable": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -6608,70 +4821,61 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.parseable",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 28,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": false,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": false,
- "catalog": false,
- "dynamic_catalog": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": false,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
- "score": 28,
- "max_score": 201,
+ "user_impersonation": false
+ },
+ "Apache Pinot": {
+ "engine": "apache_pinot",
+ "engine_name": "Apache Pinot",
+ "module": "pinot",
"documentation": {
- "description": "Parseable is a distributed log analytics database with SQL-like query interface.",
- "categories": ["Search & NoSQL", "Open Source"],
- "pypi_packages": ["sqlalchemy-parseable"],
- "connection_string": "parseable://{username}:{password}@{hostname}:{port}/{stream_name}",
+ "description": "Apache Pinot is a real-time distributed OLAP datastore.",
+ "logo": "apache-pinot.svg",
+ "homepage_url": "https://pinot.apache.org/",
+ "categories": [
+ "APACHE_PROJECTS",
+ "TIME_SERIES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "pinotdb"
+ ],
+ "connection_string": "pinot+http://{broker_host}:{broker_port}/query?controller=http://{controller_host}:{controller_port}/",
+ "default_port": 8099,
"connection_examples": [
{
- "description": "Example connection",
- "connection_string": "parseable://admin:admin@demo.parseable.com:443/ingress-nginx"
+ "description": "With authentication",
+ "connection_string": "pinot://{username}:{password}@{broker_host}:{broker_port}/query/sql?controller=http://{controller_host}:{controller_port}/verify_ssl=true"
}
],
- "notes": "Stream name in URI represents the Parseable logstream to query. Supports HTTP (80) and HTTPS (443).",
- "docs_url": "https://www.parseable.io",
- "category": "Other Databases"
- },
- "engine": "parseable",
- "engine_name": "Parseable",
- "engine_aliases": [],
- "default_driver": null,
- "supports_file_upload": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false
- },
- "PostgreSQL": {
+ "engine_parameters": [
+ {
+ "name": "Multi-stage Query Engine",
+ "description": "Enable for Explore view, joins, window functions",
+ "json": {
+ "connect_args": {
+ "use_multistage_engine": "true"
+ }
+ },
+ "docs_url": "https://docs.pinot.apache.org/reference/multi-stage-engine"
+ }
+ ]
+ },
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": true,
- "THIRTY_SECONDS": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
@@ -6691,47 +4895,35 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.postgres",
- "limit_method": 1,
- "limit_clause": true,
- "joins": true,
- "subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": false,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": 63,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": false,
- "user_impersonation": false,
- "file_upload": true,
- "get_extra_table_metadata": false,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": false,
- "expand_data": false,
- "query_cost_estimation": true,
- "sql_validation": true,
- "score": 104,
+ "score": 32,
"max_score": 201,
+ "joins": false,
+ "subqueries": false,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "user_impersonation": false
+ },
+ "PostgreSQL": {
+ "engine": "postgresql",
+ "engine_name": "PostgreSQL",
+ "module": "postgres",
"documentation": {
"description": "PostgreSQL is an advanced open-source relational database.",
"logo": "postgresql.svg",
"homepage_url": "https://www.postgresql.org/",
- "categories": ["Traditional RDBMS", "Open Source"],
- "pypi_packages": ["psycopg2"],
+ "categories": [
+ "TRADITIONAL_RDBMS",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"default_port": 5432,
"parameters": {
@@ -6760,7 +4952,9 @@
"description": "Alibaba Cloud real-time interactive analytics service, fully compatible with PostgreSQL 11.",
"logo": "hologres.png",
"homepage_url": "https://www.alibabacloud.com/product/hologres",
- "pypi_packages": ["psycopg2"],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "AccessKey ID of your Alibaba Cloud account",
@@ -6769,14 +4963,18 @@
"port": "Port number of the Hologres instance",
"database": "Name of the Hologres database"
},
- "categories": ["Proprietary"]
+ "categories": [
+ "PROPRIETARY"
+ ]
},
{
"name": "TimescaleDB",
"description": "Open-source relational database for time-series and analytics, built on PostgreSQL.",
"logo": "timescale.png",
"homepage_url": "https://www.timescale.com/",
- "pypi_packages": ["psycopg2"],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
@@ -6786,25 +4984,33 @@
],
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://docs.timescale.com/",
- "categories": ["Open Source"]
+ "categories": [
+ "OPEN_SOURCE"
+ ]
},
{
"name": "YugabyteDB",
"description": "Distributed SQL database built on top of PostgreSQL.",
"logo": "yugabyte.png",
"homepage_url": "https://www.yugabyte.com/",
- "pypi_packages": ["psycopg2"],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://www.yugabyte.com/",
- "categories": ["Open Source"]
+ "categories": [
+ "OPEN_SOURCE"
+ ]
},
{
"name": "Supabase",
"description": "Open-source Firebase alternative built on top of PostgreSQL, providing a full backend-as-a-service with a hosted Postgres database.",
"logo": "supabase.svg",
"homepage_url": "https://supabase.com/",
- "pypi_packages": ["psycopg2"],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
@@ -6823,14 +5029,18 @@
},
"notes": "Find connection details in your Supabase project dashboard under Settings > Database. Use the connection pooler (port 6543) for better connection management.",
"docs_url": "https://supabase.com/docs/guides/database/connecting-to-postgres",
- "categories": ["Hosted Open Source"]
+ "categories": [
+ "HOSTED_OPEN_SOURCE"
+ ]
},
{
"name": "Google AlloyDB",
"description": "Google Cloud's PostgreSQL-compatible database service for demanding transactional and analytical workloads.",
"logo": "alloydb.png",
"homepage_url": "https://cloud.google.com/alloydb",
- "pypi_packages": ["psycopg2"],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "Database user (default: postgres)",
@@ -6841,14 +5051,19 @@
},
"notes": "For public IP connections, use the AlloyDB Auth Proxy for secure access. Private IP connections can connect directly.",
"docs_url": "https://cloud.google.com/alloydb/docs",
- "categories": ["Cloud - Google", "Hosted Open Source"]
+ "categories": [
+ "CLOUD_GCP",
+ "HOSTED_OPEN_SOURCE"
+ ]
},
{
"name": "Neon",
"description": "Serverless PostgreSQL with branching, scale-to-zero, and bottomless storage.",
"logo": "neon.png",
"homepage_url": "https://neon.tech/",
- "pypi_packages": ["psycopg2"],
+ "pypi_packages": [
+ "psycopg2"
+ ],
"connection_string": "postgresql://{username}:{password}@{host}/{database}?sslmode=require",
"parameters": {
"username": "Neon role name",
@@ -6858,14 +5073,18 @@
},
"notes": "SSL is required for all connections. Find connection details in the Neon console under Connection Details.",
"docs_url": "https://neon.tech/docs/connect/connect-from-any-app",
- "categories": ["Hosted Open Source"]
+ "categories": [
+ "HOSTED_OPEN_SOURCE"
+ ]
},
{
"name": "Amazon Aurora PostgreSQL",
"description": "Amazon Aurora PostgreSQL is a fully managed, PostgreSQL-compatible relational database with up to 5x the throughput of standard PostgreSQL.",
"logo": "aws-aurora.jpg",
"homepage_url": "https://aws.amazon.com/rds/aurora/",
- "pypi_packages": ["sqlalchemy-aurora-data-api"],
+ "pypi_packages": [
+ "sqlalchemy-aurora-data-api"
+ ],
"connection_string": "postgresql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}®ion_name={region_name}",
"parameters": {
"aws_access_id": "AWS Access Key ID",
@@ -6876,10 +5095,20 @@
"region_name": "AWS region (e.g., us-east-1)"
},
"notes": "Uses the Data API for serverless access. Standard PostgreSQL connections also work with psycopg2.",
- "categories": ["Cloud - AWS", "Hosted Open Source"]
+ "categories": [
+ "CLOUD_AWS",
+ "HOSTED_OPEN_SOURCE"
+ ],
+ "known_incompatibilities": [
+ {
+ "dependency": "SQLAlchemy 2.0",
+ "reason": "Neither our fork (preset-io/sqlalchemy-aurora-data-api, dormant since 2021) nor the more active community fork (cloud-utils/sqlalchemy-aurora-data-api) has resolved SQLAlchemy 2.0 compatibility.",
+ "tracking_url": "https://github.com/cloud-utils/sqlalchemy-aurora-data-api/issues/43",
+ "since": "2026-07-28"
+ }
+ ]
}
],
- "category": "Traditional RDBMS",
"custom_errors": [
{
"regex_name": "CONNECTION_INVALID_USERNAME_REGEX",
@@ -6887,8 +5116,12 @@
"error_type": "CONNECTION_INVALID_USERNAME_ERROR",
"category": "Authentication",
"description": "Invalid username",
- "issue_codes": [1012],
- "invalid_fields": ["username"]
+ "issue_codes": [
+ 1012
+ ],
+ "invalid_fields": [
+ "username"
+ ]
},
{
"regex_name": "CONNECTION_INVALID_PASSWORD_REGEX",
@@ -6896,8 +5129,13 @@
"error_type": "CONNECTION_INVALID_PASSWORD_ERROR",
"category": "Authentication",
"description": "Invalid password",
- "issue_codes": [1013],
- "invalid_fields": ["username", "password"]
+ "issue_codes": [
+ 1013
+ ],
+ "invalid_fields": [
+ "username",
+ "password"
+ ]
},
{
"regex_name": "CONNECTION_INVALID_PASSWORD_NEEDED_REGEX",
@@ -6905,8 +5143,13 @@
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
- "issue_codes": [1014, 1015],
- "invalid_fields": ["password"]
+ "issue_codes": [
+ 1014,
+ 1015
+ ],
+ "invalid_fields": [
+ "password"
+ ]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
@@ -6914,8 +5157,12 @@
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
- "issue_codes": [1007],
- "invalid_fields": ["host"]
+ "issue_codes": [
+ 1007
+ ],
+ "invalid_fields": [
+ "host"
+ ]
},
{
"regex_name": "CONNECTION_PORT_CLOSED_REGEX",
@@ -6923,8 +5170,13 @@
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
- "issue_codes": [1008],
- "invalid_fields": ["host", "port"]
+ "issue_codes": [
+ 1008
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
},
{
"regex_name": "CONNECTION_HOST_DOWN_REGEX",
@@ -6932,8 +5184,13 @@
"error_type": "CONNECTION_HOST_DOWN_ERROR",
"category": "Connection",
"description": "Host unreachable",
- "issue_codes": [1009],
- "invalid_fields": ["host", "port"]
+ "issue_codes": [
+ 1009
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
},
{
"regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
@@ -6941,8 +5198,12 @@
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
- "issue_codes": [1015],
- "invalid_fields": ["database"]
+ "issue_codes": [
+ 1015
+ ],
+ "invalid_fields": [
+ "database"
+ ]
},
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
@@ -6950,7 +5211,10 @@
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
- "issue_codes": [1003, 1004]
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
},
{
"regex_name": "SYNTAX_ERROR_REGEX",
@@ -6958,20 +5222,178 @@
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
- "issue_codes": [1030]
+ "issue_codes": [
+ 1030
+ ]
}
]
},
- "engine": "postgresql",
- "engine_name": "PostgreSQL",
- "engine_aliases": ["postgres"],
- "default_driver": "psycopg2",
- "supports_file_upload": true,
+ "time_grains": {
+ "SECOND": true,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
+ "MINUTE": true,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "THIRTY_MINUTES": true,
+ "HALF_HOUR": false,
+ "HOUR": true,
+ "SIX_HOURS": false,
+ "DAY": true,
+ "WEEK": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
+ "WEEK_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "score": 104,
+ "max_score": 201,
+ "joins": true,
+ "subqueries": true,
"supports_dynamic_schema": true,
"supports_catalog": true,
- "supports_dynamic_catalog": true
+ "supports_dynamic_catalog": true,
+ "ssh_tunneling": true,
+ "supports_file_upload": true,
+ "query_cancelation": true,
+ "query_cost_estimation": true,
+ "sql_validation": true,
+ "user_impersonation": false
},
"Presto": {
+ "engine": "presto",
+ "engine_name": "Presto",
+ "module": "presto",
+ "documentation": {
+ "description": "Presto is a distributed SQL query engine for big data.",
+ "logo": "presto-og.png",
+ "homepage_url": "https://prestodb.io/",
+ "categories": [
+ "QUERY_ENGINES",
+ "OPEN_SOURCE"
+ ],
+ "pypi_packages": [
+ "pyhive"
+ ],
+ "install_instructions": "pip install \"apache-superset[presto]\"",
+ "connection_string": "presto://{hostname}:{port}/{database}",
+ "default_port": 8080,
+ "parameters": {
+ "hostname": "Presto coordinator hostname",
+ "port": "Presto coordinator port (default 8080)",
+ "database": "Catalog name"
+ },
+ "drivers": [
+ {
+ "name": "PyHive",
+ "pypi_package": "pyhive",
+ "connection_string": "presto://{hostname}:{port}/{database}",
+ "is_recommended": true
+ }
+ ],
+ "custom_errors": [
+ {
+ "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
+ "message_template": "We can't seem to resolve the column \"%(column_name)s\" at line %(location)s.",
+ "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Column not found",
+ "issue_codes": [
+ 1003,
+ 1004
+ ]
+ },
+ {
+ "regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
+ "message_template": "The table \"%(table_name)s\" does not exist. A valid table must be used to run this query.",
+ "error_type": "TABLE_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Table not found",
+ "issue_codes": [
+ 1003,
+ 1005
+ ]
+ },
+ {
+ "regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
+ "message_template": "The schema \"%(schema_name)s\" does not exist. A valid schema must be used to run this query.",
+ "error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
+ "category": "Query",
+ "description": "Schema not found",
+ "issue_codes": [
+ 1003,
+ 1016
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
+ "message_template": "Either the username \"%(username)s\" or the password is incorrect.",
+ "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
+ "category": "Authentication",
+ "description": "Access denied",
+ "issue_codes": [
+ 1014,
+ 1015
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_ACCESS_DENIED_401_REGEX",
+ "message_template": "Unexpected HTTP 401 response. Check your credentials.",
+ "error_type": "CONNECTION_ACCESS_DENIED_ERROR",
+ "category": "Authentication",
+ "description": "Access denied",
+ "issue_codes": [
+ 1014,
+ 1015
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
+ "message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
+ "error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
+ "category": "Connection",
+ "description": "Invalid hostname",
+ "issue_codes": [
+ 1007
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_HOST_DOWN_REGEX",
+ "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
+ "error_type": "CONNECTION_HOST_DOWN_ERROR",
+ "category": "Connection",
+ "description": "Host unreachable",
+ "issue_codes": [
+ 1009
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_PORT_CLOSED_REGEX",
+ "message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
+ "error_type": "CONNECTION_PORT_CLOSED_ERROR",
+ "category": "Connection",
+ "description": "Port closed or refused",
+ "issue_codes": [
+ 1008
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_UNKNOWN_DATABASE_ERROR",
+ "message_template": "Unable to connect to catalog named \"%(catalog_name)s\".",
+ "error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
+ "category": "Connection",
+ "description": "Unknown database",
+ "issue_codes": [
+ 1015
+ ]
+ }
+ ]
+ },
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -6995,96 +5417,127 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "module": "superset.db_engine_specs.presto",
- "limit_method": 1,
- "limit_clause": true,
+ "score": 159,
+ "max_score": 201,
"joins": true,
"subqueries": true,
- "alias_in_select": true,
- "alias_in_orderby": true,
- "time_groupby_inline": false,
- "alias_to_source_column": true,
- "order_by_not_in_select": true,
- "expressions_in_orderby": false,
- "cte_in_subquery": true,
- "max_column_name": null,
- "sql_comments": true,
- "escaped_colons": true,
- "masked_encrypted_extra": false,
- "column_type_mapping": true,
- "function_names": true,
- "user_impersonation": true,
- "file_upload": true,
- "get_extra_table_metadata": true,
- "dbapi_exception_mapping": false,
- "custom_errors": false,
- "dynamic_schema": true,
- "catalog": true,
- "dynamic_catalog": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true,
"ssh_tunneling": true,
+ "supports_file_upload": true,
"query_cancelation": true,
- "get_metrics": false,
- "where_latest_partition": true,
- "expand_data": true,
"query_cost_estimation": true,
"sql_validation": true,
- "score": 159,
- "max_score": 201,
+ "user_impersonation": true
+ },
+ "Amazon Redshift": {
+ "engine": "amazon_redshift",
+ "engine_name": "Amazon Redshift",
+ "module": "redshift",
"documentation": {
- "description": "Presto is a distributed SQL query engine for big data.",
- "logo": "presto-og.png",
- "homepage_url": "https://prestodb.io/",
- "categories": ["Query Engines", "Open Source"],
- "pypi_packages": ["pyhive"],
- "install_instructions": "pip install \"apache-superset[presto]\"",
- "connection_string": "presto://{hostname}:{port}/{database}",
- "default_port": 8080,
+ "description": "Amazon Redshift is a fully managed data warehouse service.",
+ "logo": "redshift.png",
+ "homepage_url": "https://aws.amazon.com/redshift/",
+ "categories": [
+ "CLOUD_AWS",
+ "ANALYTICAL_DATABASES",
+ "PROPRIETARY"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-redshift"
+ ],
+ "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
+ "default_port": 5439,
"parameters": {
- "hostname": "Presto coordinator hostname",
- "port": "Presto coordinator port (default 8080)",
- "database": "Catalog name"
+ "username": "Database username",
+ "password": "Database password",
+ "host": "AWS Endpoint",
+ "port": "Default 5439",
+ "database": "Database name"
},
"drivers": [
{
- "name": "PyHive",
- "pypi_package": "pyhive",
- "connection_string": "presto://{hostname}:{port}/{database}",
- "is_recommended": true
+ "name": "psycopg2",
+ "pypi_package": "psycopg2",
+ "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
+ "is_recommended": true
+ },
+ {
+ "name": "redshift_connector",
+ "pypi_package": "redshift_connector",
+ "connection_string": "redshift+redshift_connector://{username}:{password}@{host}:5439/{database}",
+ "is_recommended": false,
+ "notes": "Supports IAM-based credentials for clusters and serverless."
+ }
+ ],
+ "authentication_methods": [
+ {
+ "name": "IAM Credentials (Cluster)",
+ "description": "Use IAM-based temporary database credentials for Redshift clusters",
+ "requirements": "IAM role must have redshift:GetClusterCredentials permission",
+ "connection_string": "redshift+redshift_connector://",
+ "engine_parameters": {
+ "connect_args": {
+ "iam": true,
+ "database": "<database>",
+ "cluster_identifier": "<cluster_identifier>",
+ "db_user": "<db_user>"
+ }
+ }
+ },
+ {
+ "name": "IAM Role (Serverless)",
+ "description": "Authenticate using the IAM role attached to the environment (EC2 instance profile, ECS task role, etc.). No credentials needed.",
+ "requirements": "The attached IAM role must have redshift-serverless:GetCredentials and redshift-serverless:GetWorkgroup permissions.",
+ "connection_string": "redshift+redshift_connector://",
+ "engine_parameters": {
+ "connect_args": {
+ "iam": true,
+ "is_serverless": true,
+ "serverless_acct_id": "<aws account number>",
+ "serverless_work_group": "<redshift work group>",
+ "database": "<database>",
+ "user": "IAMR:<superset iam role name>"
+ }
+ }
+ },
+ {
+ "name": "IAM Access Key (Serverless)",
+ "description": "Authenticate using explicit AWS access key and secret. Suitable for local development or CI environments without an attached IAM role.",
+ "requirements": "The IAM user must have redshift-serverless:GetCredentials and redshift-serverless:GetWorkgroup permissions.",
+ "connection_string": "redshift+redshift_connector://",
+ "engine_parameters": {
+ "connect_args": {
+ "iam": true,
+ "is_serverless": true,
+ "serverless_acct_id": "<aws account number>",
+ "serverless_work_group": "<redshift work group>",
+ "database": "<database>",
+ "host": "<endpoint>",
+ "port": 5439,
+ "region": "<aws region>",
+ "access_key_id": "<aws access key id>",
+ "secret_access_key": "<aws secret access key>"
+ }
+ }
}
],
- "category": "Query Engines",
"custom_errors": [
- {
- "regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
- "message_template": "We can't seem to resolve the column \"%(column_name)s\" at line %(location)s.",
- "error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Column not found",
- "issue_codes": [1003, 1004]
- },
- {
- "regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
- "message_template": "The table \"%(table_name)s\" does not exist. A valid table must be used to run this query.",
- "error_type": "TABLE_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Table not found",
- "issue_codes": [1003, 1005]
- },
- {
- "regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
- "message_template": "The schema \"%(schema_name)s\" does not exist. A valid schema must be used to run this query.",
- "error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
- "category": "Query",
- "description": "Schema not found",
- "issue_codes": [1003, 1016]
- },
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
"message_template": "Either the username \"%(username)s\" or the password is incorrect.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
- "issue_codes": [1014, 1015]
+ "issue_codes": [
+ 1014,
+ 1015
+ ],
+ "invalid_fields": [
+ "username",
+ "password"
+ ]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
@@ -7092,15 +5545,12 @@
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
- "issue_codes": [1007]
- },
- {
- "regex_name": "CONNECTION_HOST_DOWN_REGEX",
- "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
- "error_type": "CONNECTION_HOST_DOWN_ERROR",
- "category": "Connection",
- "description": "Host unreachable",
- "issue_codes": [1009]
+ "issue_codes": [
+ 1007
+ ],
+ "invalid_fields": [
+ "host"
+ ]
},
{
"regex_name": "CONNECTION_PORT_CLOSED_REGEX",
@@ -7108,28 +5558,43 @@
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
- "issue_codes": [1008]
+ "issue_codes": [
+ 1008
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
},
{
- "regex_name": "CONNECTION_UNKNOWN_DATABASE_ERROR",
- "message_template": "Unable to connect to catalog named \"%(catalog_name)s\".",
+ "regex_name": "CONNECTION_HOST_DOWN_REGEX",
+ "message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
+ "error_type": "CONNECTION_HOST_DOWN_ERROR",
+ "category": "Connection",
+ "description": "Host unreachable",
+ "issue_codes": [
+ 1009
+ ],
+ "invalid_fields": [
+ "host",
+ "port"
+ ]
+ },
+ {
+ "regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
+ "message_template": "We were unable to connect to your database named \"%(database)s\". Please verify your database name and try again.",
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
- "issue_codes": [1015]
+ "issue_codes": [
+ 1015
... 2228 lines suppressed ...