You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@superset.apache.org by ru...@apache.org on 2026/04/17 17:14:51 UTC
(superset) 01/01: fix(docs): read capability flags from engine specs in database docs generator
This is an automated email from the ASF dual-hosted git repository.
rusackas pushed a commit to branch docs/db-capability-flags-from-engine-specs
in repository https://gitbox.apache.org/repos/asf/superset.git
commit ff8724e564ced393bc90fde2f8b77de5e3b58e32
Author: Superset Dev <de...@superset.apache.org>
AuthorDate: Fri Apr 17 10:10:56 2026 -0700
fix(docs): read capability flags from engine specs in database docs generator
Update the database docs generator to extract capability flag values
directly from Python engine spec class attributes (supports_catalog,
supports_dynamic_schema, etc.) and method overrides (cancel_query,
estimate_statement_cost, impersonate_user, has_implicit_cancel, etc.)
using AST parsing in the fallback path.
Previously the generator hardcoded False for all capability flags and
relied on mergeWithExistingDiagnostics to preserve manual edits from
the existing databases.json. This made it impossible to keep flags
in sync with the Python source.
Changes:
- Fallback AST path now extracts cap flags via AST with proper
inheritance resolution (mirrors lib.py has_custom_method logic)
- mergeWithExistingDiagnostics now only preserves score/max_score/
time_grains (Flask-context-only fields), not capability flags
- lib.py generate_yaml_docs now includes supports_dynamic_catalog
in its output, and skips base specs that would overwrite a real
product spec's flags for the same engine_name
- Regenerated databases.json with corrected flag values
Co-Authored-By: Claude Sonnet 4.6 <no...@anthropic.com>
---
docs/scripts/generate-database-docs.mjs | 165 +-
docs/src/data/databases.json | 9952 +++++++++++++++++++++----------
superset/db_engine_specs/lib.py | 10 +
3 files changed, 6924 insertions(+), 3203 deletions(-)
diff --git a/docs/scripts/generate-database-docs.mjs b/docs/scripts/generate-database-docs.mjs
index 0491683b951..16d9ab70871 100644
--- a/docs/scripts/generate-database-docs.mjs
+++ b/docs/scripts/generate-database-docs.mjs
@@ -186,8 +186,36 @@ if not os.path.isdir(specs_dir):
print(json.dumps({"error": f"Directory not found: {specs_dir}", "cwd": os.getcwd()}))
sys.exit(1)
-# First pass: collect all class info (name, bases, metadata)
-class_info = {} # class_name -> {bases: [], metadata: {}, engine_name: str, filename: str}
+# Capability flag attributes with their defaults from BaseEngineSpec
+CAP_ATTR_DEFAULTS = {
+ 'supports_dynamic_schema': False,
+ 'supports_catalog': False,
+ 'supports_dynamic_catalog': False,
+ 'disable_ssh_tunneling': False,
+ 'supports_file_upload': True,
+ 'allows_joins': True,
+ 'allows_subqueries': True,
+}
+
+# Methods that indicate a capability when overridden by a non-BaseEngineSpec class.
+# Mirrors the has_custom_method checks in superset/db_engine_specs/lib.py.
+# cancel_query / get_cancel_query_id / has_implicit_cancel -> query_cancelation
+# estimate_statement_cost / estimate_query_cost -> query_cost_estimation
+# impersonate_user / update_impersonation_config / get_url_for_impersonation -> user_impersonation
+# validate_sql -> sql_validation (not used yet; validation is engine-based)
+CAP_METHODS = {
+ 'cancel_query', 'get_cancel_query_id', 'has_implicit_cancel',
+ 'estimate_statement_cost', 'estimate_query_cost',
+ 'impersonate_user', 'update_impersonation_config', 'get_url_for_impersonation',
+ 'validate_sql',
+}
+
+# Only the literal BaseEngineSpec is excluded from method-override tracking.
+# Intermediate base classes (e.g. PrestoBaseEngineSpec) do count as overrides.
+TRUE_BASE_CLASS = 'BaseEngineSpec'
+
+# First pass: collect all class info (name, bases, metadata, cap_attrs, direct_methods)
+class_info = {} # class_name -> {bases: [], metadata: {}, engine_name: str, filename: str, ...}
for filename in sorted(os.listdir(specs_dir)):
if not filename.endswith('.py') or filename in ('__init__.py', 'lib.py', 'lint_metadata.py'):
@@ -218,30 +246,38 @@ for filename in sorted(os.listdir(specs_dir)):
# Extract class attributes
engine_name = None
+ engine_attr = None
metadata = None
+ cap_attrs = {} # capability flag attributes defined directly in this class
+ direct_methods = set() # capability methods defined directly in this class
for item in node.body:
if isinstance(item, ast.Assign):
for target in item.targets:
- if isinstance(target, ast.Name):
- if target.id == 'engine_name':
- val = eval_node(item.value)
- if isinstance(val, str):
- engine_name = val
- elif target.id == 'metadata':
- metadata = eval_node(item.value)
+ if not isinstance(target, ast.Name):
+ continue
+ if target.id == 'engine_name':
+ val = eval_node(item.value)
+ if isinstance(val, str):
+ engine_name = val
+ elif target.id == 'engine':
+ val = eval_node(item.value)
+ if isinstance(val, str):
+ engine_attr = val
+ elif target.id == 'metadata':
+ metadata = eval_node(item.value)
+ elif target.id in CAP_ATTR_DEFAULTS:
+ val = eval_node(item.value)
+ # Only store if we got a concrete bool value (not None/unevaluable)
+ if isinstance(val, bool):
+ cap_attrs[target.id] = val
+ elif isinstance(item, (ast.FunctionDef, ast.AsyncFunctionDef)):
+ if item.name in CAP_METHODS:
+ direct_methods.add(item.name)
# Check for engine attribute with non-empty value to distinguish
# true base classes from product classes like OceanBaseEngineSpec
- has_non_empty_engine = False
- for item in node.body:
- if isinstance(item, ast.Assign):
- for target in item.targets:
- if isinstance(target, ast.Name) and target.id == 'engine':
- # Check if engine value is non-empty string
- if isinstance(item.value, ast.Constant):
- has_non_empty_engine = bool(item.value.value)
- break
+ has_non_empty_engine = engine_attr is not None and bool(engine_attr)
# True base classes: end with BaseEngineSpec AND don't define engine
# or have empty engine (like PostgresBaseEngineSpec with engine = "")
@@ -254,13 +290,17 @@ for filename in sorted(os.listdir(specs_dir)):
'bases': base_names,
'metadata': metadata,
'engine_name': engine_name,
+ 'engine': engine_attr,
'filename': filename,
'is_base_or_mixin': is_true_base,
+ 'cap_attrs': cap_attrs,
+ 'direct_methods': direct_methods,
}
except Exception as e:
errors.append(f"{filename}: {str(e)}")
-# Second pass: resolve inheritance and build final metadata
+# Second pass: resolve inheritance and build final metadata + capability flags
+
def get_inherited_metadata(class_name, visited=None):
"""Recursively get metadata from parent classes."""
if visited is None:
@@ -286,6 +326,44 @@ def get_inherited_metadata(class_name, visited=None):
return inherited
+def get_resolved_caps(class_name, visited=None):
+ """
+ Resolve capability flags and method overrides with inheritance.
+
+ Cap attrs: child values override parent values (same as Python MRO).
+ Methods: track which non-BaseEngineSpec classes define them directly,
+ matching the has_custom_method() logic in superset/db_engine_specs/lib.py.
+ """
+ if visited is None:
+ visited = set()
+ if class_name in visited:
+ return dict(CAP_ATTR_DEFAULTS), set()
+ visited.add(class_name)
+
+ info = class_info.get(class_name)
+ if not info:
+ return dict(CAP_ATTR_DEFAULTS), set()
+
+ # Start from base defaults
+ resolved_attrs = dict(CAP_ATTR_DEFAULTS)
+ resolved_methods = set()
+
+ # Collect from parents first
+ for base_name in info['bases']:
+ parent_attrs, parent_methods = get_resolved_caps(base_name, visited.copy())
+ resolved_attrs.update(parent_attrs)
+ resolved_methods.update(parent_methods)
+
+ # Apply this class's own cap_attrs (override parent values)
+ resolved_attrs.update(info['cap_attrs'])
+
+ # Accumulate method overrides, but skip the literal BaseEngineSpec
+ # (its implementations are stubs; only non-base overrides count)
+ if class_name != TRUE_BASE_CLASS:
+ resolved_methods.update(info['direct_methods'])
+
+ return resolved_attrs, resolved_methods
+
for class_name, info in class_info.items():
# Skip base classes and mixins
if info['is_base_or_mixin']:
@@ -310,6 +388,11 @@ for class_name, info in class_info.items():
if final_metadata and isinstance(final_metadata, dict) and display_name:
debug_info["classes_with_metadata"] += 1
+
+ # Resolve capability flags from Python source
+ cap_attrs, cap_methods = get_resolved_caps(class_name)
+ engine_attr = info.get('engine') or ''
+
databases[display_name] = {
'engine': display_name.lower().replace(' ', '_'),
'engine_name': display_name,
@@ -318,17 +401,22 @@ for class_name, info in class_info.items():
'time_grains': {},
'score': 0,
'max_score': 0,
- 'joins': True,
- 'subqueries': True,
- 'supports_dynamic_schema': False,
- 'supports_catalog': False,
- 'supports_dynamic_catalog': False,
- 'ssh_tunneling': False,
- 'query_cancelation': False,
- 'supports_file_upload': False,
- 'user_impersonation': False,
- 'query_cost_estimation': False,
- 'sql_validation': False,
+ # Capability flags read from engine spec class attributes/methods
+ 'joins': cap_attrs['allows_joins'],
+ 'subqueries': cap_attrs['allows_subqueries'],
+ 'supports_dynamic_schema': cap_attrs['supports_dynamic_schema'],
+ 'supports_catalog': cap_attrs['supports_catalog'],
+ 'supports_dynamic_catalog': cap_attrs['supports_dynamic_catalog'],
+ 'ssh_tunneling': not cap_attrs['disable_ssh_tunneling'],
+ 'supports_file_upload': cap_attrs['supports_file_upload'],
+ # Method-based flags: True only when a non-base class overrides them
+ 'query_cancelation': bool({'cancel_query', 'get_cancel_query_id', 'has_implicit_cancel'} & cap_methods),
+ 'query_cost_estimation': bool({'estimate_statement_cost', 'estimate_query_cost'} & cap_methods),
+ # SQL validation is implemented in external validator classes keyed by engine name
+ 'sql_validation': engine_attr in {'presto', 'postgresql'},
+ 'user_impersonation': bool(
+ {'impersonate_user', 'update_impersonation_config', 'get_url_for_impersonation'} & cap_methods
+ ),
}
if errors and not databases:
@@ -853,22 +941,21 @@ function loadExistingData() {
/**
* Merge new documentation with existing diagnostics
- * Preserves score, time_grains, and feature flags from existing data
+ * Preserves score, max_score, and time_grains from existing data (these require
+ * Flask context to generate and cannot be derived from static source analysis).
+ * Capability flags (joins, supports_catalog, etc.) are NOT preserved here — they
+ * are now read fresh from the Python engine spec source by extractEngineSpecMetadata().
*/
function mergeWithExistingDiagnostics(newDatabases, existingData) {
if (!existingData?.databases) return newDatabases;
- const diagnosticFields = [
- 'score', 'max_score', 'time_grains', 'joins', 'subqueries',
- 'supports_dynamic_schema', 'supports_catalog', 'supports_dynamic_catalog',
- 'ssh_tunneling', 'query_cancelation', 'supports_file_upload',
- 'user_impersonation', 'query_cost_estimation', 'sql_validation'
- ];
+ // Only preserve fields that require Flask/runtime context to generate
+ const diagnosticFields = ['score', 'max_score', 'time_grains'];
for (const [name, db] of Object.entries(newDatabases)) {
const existingDb = existingData.databases[name];
if (existingDb && existingDb.score > 0) {
- // Preserve diagnostics from existing data
+ // Preserve score/time_grain diagnostics from existing data
for (const field of diagnosticFields) {
if (existingDb[field] !== undefined) {
db[field] = existingDb[field];
@@ -879,7 +966,7 @@ function mergeWithExistingDiagnostics(newDatabases, existingData) {
const preserved = Object.values(newDatabases).filter(d => d.score > 0).length;
if (preserved > 0) {
- console.log(`Preserved diagnostics for ${preserved} databases from existing data`);
+ console.log(`Preserved score/time_grains for ${preserved} databases from existing data`);
}
return newDatabases;
diff --git a/docs/src/data/databases.json b/docs/src/data/databases.json
index f1561182372..8a766c481c8 100644
--- a/docs/src/data/databases.json
+++ b/docs/src/data/databases.json
@@ -1,81 +1,91 @@
{
- "generated": "2026-02-24T20:28:17.222Z",
+ "generated": "2026-04-17T17:08:35.132Z",
"statistics": {
- "totalDatabases": 72,
- "withDocumentation": 72,
- "withConnectionString": 72,
- "withDrivers": 36,
- "withAuthMethods": 4,
- "supportsJoins": 68,
- "supportsSubqueries": 69,
- "supportsDynamicSchema": 15,
- "supportsCatalog": 9,
- "averageScore": 31,
+ "totalDatabases": 80,
+ "withDocumentation": 80,
+ "withConnectionString": 80,
+ "withDrivers": 28,
+ "withAuthMethods": 5,
+ "supportsJoins": 74,
+ "supportsSubqueries": 77,
+ "supportsDynamicSchema": 29,
+ "supportsCatalog": 20,
+ "averageScore": 54,
"maxScore": 201,
"byCategory": {
- "Other Databases": [
- "Arc",
- "Shillelagh",
- "Superset meta database"
+ "Cloud - AWS": [
+ "Amazon Athena",
+ "Amazon DynamoDB",
+ "Amazon Redshift"
+ ],
+ "Query Engines": [
+ "Amazon Athena",
+ "Apache Drill",
+ "Apache Hive",
+ "Apache Impala",
+ "Apache Spark SQL",
+ "Databricks Interactive Cluster",
+ "Denodo",
+ "Dremio",
+ "Presto",
+ "Trino"
],
"Proprietary": [
- "Arc",
"Amazon Athena",
- "Google BigQuery",
+ "Amazon DynamoDB",
+ "Amazon Redshift",
+ "Arc",
+ "Azure Data Explorer",
+ "Azure Synapse",
"Databend",
- "IBM Db2",
"Denodo",
"Dremio",
- "Amazon DynamoDB",
"Exasol",
"Firebolt",
- "SAP HANA",
+ "Google BigQuery",
+ "Google Datastore",
"Hologres",
+ "IBM Db2",
"IBM Db2 for i",
- "Azure Data Explorer",
- "MongoDB",
- "Microsoft SQL Server",
- "Azure Synapse",
"IBM Netezza Performance Server",
+ "Microsoft SQL Server",
+ "MongoDB",
"Ocient",
"Oracle",
- "Amazon Redshift",
+ "SAP HANA",
+ "SAP Sybase",
"SingleStore",
"Snowflake",
- "SAP Sybase",
"Teradata",
"Vertica"
],
- "Cloud Data Warehouses": [
- "Ascend",
- "Cloudflare D1",
- "Databend",
- "Databricks",
- "MotherDuck",
- "Firebolt",
- "Hologres",
- "Azure Synapse",
- "Snowflake",
- "YugabyteDB"
+ "Search & NoSQL": [
+ "Amazon DynamoDB",
+ "Apache Solr",
+ "Couchbase",
+ "Elasticsearch",
+ "Google Datastore",
+ "MongoDB",
+ "Parseable"
],
"Analytical Databases": [
+ "Amazon Redshift",
+ "Apache Doris",
+ "Apache Kylin",
+ "Apache Phoenix",
"Ascend",
- "Google BigQuery",
+ "Azure Data Explorer",
+ "Azure Synapse",
"ClickHouse",
"Databend",
"Databricks",
- "Apache Doris",
"DuckDB",
- "MotherDuck",
"Exasol",
"Firebolt",
+ "Google BigQuery",
"Hologres",
- "Azure Data Explorer",
- "Apache Kylin",
- "Azure Synapse",
+ "MotherDuck",
"Ocient",
- "Apache Phoenix",
- "Amazon Redshift",
"RisingWave",
"SingleStore",
"Snowflake",
@@ -83,91 +93,55 @@
"TimescaleDB",
"Vertica"
],
- "Hosted Open Source": [
- "Ascend",
- "Cloudflare D1",
- "Databricks",
- "MotherDuck",
- "Google Sheets"
- ],
- "Cloud - AWS": [
- "Amazon Athena",
- "Amazon DynamoDB",
- "Amazon Redshift"
- ],
- "Query Engines": [
- "Amazon Athena",
- "Databricks Interactive Cluster",
- "Denodo",
- "Dremio",
+ "Apache Projects": [
+ "Apache Doris",
"Apache Drill",
+ "Apache Druid",
"Apache Hive",
"Apache Impala",
- "Presto",
+ "Apache IoTDB",
+ "Apache Kylin",
+ "Apache Phoenix",
+ "Apache Pinot",
+ "Apache Solr",
"Apache Spark SQL",
- "Trino"
- ],
- "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"
+ "Databricks Interactive Cluster"
],
"Open Source": [
- "Aurora MySQL (Data API)",
- "Aurora PostgreSQL (Data API)",
+ "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",
+ "Aurora MySQL (Data API)",
"Aurora PostgreSQL",
+ "Aurora PostgreSQL (Data API)",
"ClickHouse",
"CockroachDB",
"Couchbase",
"CrateDB",
"Databricks Interactive Cluster",
- "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",
- "Shillelagh",
- "Apache Solr",
- "Apache Spark SQL",
"SQLite",
+ "Shillelagh",
"StarRocks",
"TDengine",
"TimescaleDB",
@@ -175,144 +149,148 @@
"YDB",
"YugabyteDB"
],
- "Cloud - Google": [
- "Google BigQuery",
- "Google Sheets"
- ],
- "Search & NoSQL": [
- "Couchbase",
- "Amazon DynamoDB",
- "Elasticsearch",
- "MongoDB",
- "Parseable",
- "Apache Solr"
- ],
"Time Series Databases": [
- "CrateDB",
"Apache Druid",
"Apache IoTDB",
"Apache Pinot",
+ "CrateDB",
"TDengine"
],
- "Apache Projects": [
- "Databricks Interactive Cluster",
- "Apache Doris",
- "Apache Drill",
- "Apache Druid",
- "Apache Hive",
- "Apache Impala",
- "Apache IoTDB",
- "Apache Kylin",
- "Apache Phoenix",
- "Apache Pinot",
- "Apache Solr",
- "Apache Spark SQL"
+ "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": [
+ "Ascend",
+ "Azure Synapse",
+ "Cloudflare D1",
+ "Databend",
+ "Databricks",
+ "Firebolt",
+ "Hologres",
+ "MotherDuck",
+ "Snowflake",
+ "YugabyteDB"
+ ],
+ "Hosted Open Source": [
+ "Ascend",
+ "Cloudflare D1",
+ "Databricks",
+ "Google Sheets",
+ "MotherDuck"
+ ],
+ "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"
],
"Cloud - Azure": [
"Azure Data Explorer"
+ ],
+ "Cloud - Google": [
+ "Google BigQuery",
+ "Google Datastore",
+ "Google Sheets"
]
}
},
"databases": {
- "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."
+ "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
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.athena",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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": false,
+ "masked_encrypted_extra": false,
+ "column_type_mapping": false,
+ "function_names": false,
"user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "Ascend": {
- "engine": "ascend",
- "engine_name": "Ascend",
- "module": "ascend",
- "documentation": {
- "description": "Ascend.io is a data automation platform for building data pipelines.",
- "logo": "ascend.webp",
- "homepage_url": "https://www.ascend.io/",
- "pypi_packages": [
- "impyla",
- "impyla"
- ],
- "connection_string": "ascend://{username}:{password}@{hostname}:{port}/{database}?auth_mechanism=PLAIN;use_ssl=true",
- "default_port": 21050,
- "categories": [
- "CLOUD_DATA_WAREHOUSES",
- "ANALYTICAL_DATABASES",
- "HOSTED_OPEN_SOURCE"
- ]
- },
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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,
- "supports_file_upload": false,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Amazon Athena": {
- "engine": "amazon_athena",
- "engine_name": "Amazon Athena",
- "module": "athena",
+ "sql_validation": false,
+ "score": 30,
+ "max_score": 201,
"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"
+ "Cloud - AWS",
+ "Query Engines",
+ "Proprietary"
],
"pypi_packages": [
"pyathena[pandas]"
@@ -346,6 +324,7 @@
}
],
"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",
@@ -359,406 +338,2838 @@
}
]
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "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,
+ "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": true,
+ "WEEK_ENDING_SATURDAY": true,
+ "WEEK_ENDING_SUNDAY": true,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
+ },
+ "module": "superset.db_engine_specs.dynamodb",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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
- },
- "Aurora MySQL (Data API)": {
- "engine": "aurora_mysql_(data_api)",
- "engine_name": "Aurora MySQL (Data API)",
- "module": "aurora",
+ "sql_validation": false,
+ "score": 32,
+ "max_score": 201,
"documentation": {
- "description": "MySQL is a popular open-source relational database.",
- "logo": "mysql.png",
- "homepage_url": "https://www.mysql.com/",
+ "description": "Amazon DynamoDB is a serverless NoSQL database with SQL via PartiQL.",
+ "logo": "aws.png",
+ "homepage_url": "https://aws.amazon.com/dynamodb/",
"categories": [
- "TRADITIONAL_RDBMS",
- "OPEN_SOURCE"
+ "Cloud - AWS",
+ "Search & NoSQL",
+ "Proprietary"
],
"pypi_packages": [
- "mysqlclient"
+ "pydynamodb"
],
- "connection_string": "mysql://{username}:{password}@{host}/{database}",
- "default_port": 3306,
+ "connection_string": "dynamodb://{aws_access_key_id}:{aws_secret_access_key}@dynamodb.{region}.amazonaws.com:443?connector=superset",
"parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "localhost, 127.0.0.1, IP address, or hostname",
- "database": "Database name"
+ "aws_access_key_id": "AWS access key ID",
+ "aws_secret_access_key": "AWS secret access key",
+ "region": "AWS region (e.g., us-east-1)"
},
- "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."
- }
- ]
+ "notes": "Uses PartiQL for SQL queries. Requires connector=superset parameter.",
+ "docs_url": "https://github.com/passren/PyDynamoDB",
+ "category": "Cloud - AWS"
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
+ "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,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
+ "supports_dynamic_catalog": false
},
- "Aurora PostgreSQL (Data API)": {
- "engine": "aurora_postgresql_(data_api)",
- "engine_name": "Aurora PostgreSQL (Data API)",
- "module": "aurora",
- "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"
+ "Amazon Redshift": {
+ "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
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.redshift",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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": 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,
+ "ssh_tunneling": true,
+ "query_cancelation": true,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Aurora MySQL": {
- "engine": "aurora_mysql",
- "engine_name": "Aurora MySQL",
- "module": "aurora",
+ "sql_validation": false,
+ "score": 44,
+ "max_score": 201,
"documentation": {
- "description": "MySQL is a popular open-source relational database.",
- "logo": "mysql.png",
- "homepage_url": "https://www.mysql.com/",
+ "description": "Amazon Redshift is a fully managed data warehouse service.",
+ "logo": "redshift.png",
+ "homepage_url": "https://aws.amazon.com/redshift/",
"categories": [
- "TRADITIONAL_RDBMS",
- "OPEN_SOURCE"
+ "Cloud - AWS",
+ "Analytical Databases",
+ "Proprietary"
],
"pypi_packages": [
- "mysqlclient"
+ "sqlalchemy-redshift"
],
- "connection_string": "mysql://{username}:{password}@{host}/{database}",
- "default_port": 3306,
+ "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
+ "default_port": 5439,
"parameters": {
"username": "Database username",
"password": "Database password",
- "host": "localhost, 127.0.0.1, IP address, or hostname",
+ "host": "AWS Endpoint",
+ "port": "Default 5439",
"database": "Database name"
},
- "host_examples": [
+ "drivers": [
{
- "platform": "Localhost",
- "host": "localhost or 127.0.0.1"
+ "name": "psycopg2",
+ "pypi_package": "psycopg2",
+ "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
+ "is_recommended": true
},
{
- "platform": "Docker on Linux",
- "host": "172.18.0.1"
+ "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": "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
+ },
+ "Ascend": {
+ "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.ascend",
+ "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": 38,
+ "max_score": 201,
+ "documentation": {
+ "description": "Ascend.io is a data automation platform for building data pipelines.",
+ "logo": "ascend.webp",
+ "homepage_url": "https://www.ascend.io/",
+ "categories": [
+ "Cloud Data Warehouses",
+ "Analytical Databases",
+ "Hosted Open Source"
+ ],
+ "pypi_packages": [
+ "impyla"
+ ],
+ "connection_string": "ascend://{username}:{password}@{hostname}:{port}/{database}?auth_mechanism=PLAIN;use_ssl=true",
+ "category": "Other Databases"
+ },
+ "engine": "ascend",
+ "engine_name": "Ascend",
+ "engine_aliases": [],
+ "default_driver": null,
+ "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"
+ ]
},
{
- "platform": "Docker on macOS",
- "host": "docker.for.mac.host.internal"
+ "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"
+ ]
},
{
- "platform": "On-premise",
- "host": "IP address or hostname"
+ "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"
+ ]
}
],
- "drivers": [
+ "category": "Traditional RDBMS"
+ },
+ "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,
+ "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": [
{
- "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."
+ "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": "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."
+ "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_ENDING_SATURDAY": false,
+ "WEEK_ENDING_SUNDAY": false,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.kusto",
+ "limit_method": 2,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
+ "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,
+ "ssh_tunneling": true,
+ "query_cancelation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Aurora PostgreSQL": {
- "engine": "aurora_postgresql",
- "engine_name": "Aurora PostgreSQL",
- "module": "aurora",
+ "sql_validation": false,
+ "score": 54,
+ "max_score": 201,
"documentation": {
- "description": "PostgreSQL is an advanced open-source relational database.",
- "logo": "postgresql.svg",
- "homepage_url": "https://www.postgresql.org/",
+ "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": [
- "TRADITIONAL_RDBMS",
- "OPEN_SOURCE"
+ "Cloud - Azure",
+ "Analytical Databases",
+ "Proprietary"
],
"pypi_packages": [
- "psycopg2"
+ "sqlalchemy-kusto"
],
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
- "default_port": 5432,
+ "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": {
- "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"
+ "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"
},
- "notes": "The psycopg2 library comes bundled with Superset Docker images.",
- "connection_examples": [
+ "drivers": [
{
- "description": "Basic connection",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
+ "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."
},
{
- "description": "With SSL required",
- "connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
+ "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 native Kusto Query Language for advanced analytics."
}
],
- "docs_url": "https://www.postgresql.org/docs/",
- "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html"
+ "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,
+ "MINUTE": true,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": false,
+ "FIFTEEN_MINUTES": false,
+ "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": false,
+ "QUARTER_YEAR": false,
+ "YEAR": true
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.kusto",
+ "limit_method": 1,
+ "limit_clause": true,
"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,
+ "ssh_tunneling": true,
+ "query_cancelation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "score": 40,
+ "max_score": 201,
+ "documentation": {
+ "pypi_packages": [],
+ "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
+ "category": "Cloud - Azure"
+ },
+ "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,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
+ "supports_dynamic_catalog": false
+ },
+ "Azure Synapse": {
+ "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": true,
+ "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.mssql",
+ "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": 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,
+ "ssh_tunneling": true,
+ "query_cancelation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Google BigQuery": {
- "engine": "google_bigquery",
- "engine_name": "Google BigQuery",
- "module": "bigquery",
+ "sql_validation": false,
+ "score": 44,
+ "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/",
+ "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/",
"categories": [
- "CLOUD_GCP",
- "ANALYTICAL_DATABASES",
- "PROPRIETARY"
+ "Cloud Data Warehouses",
+ "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."
+ "pymssql"
],
- "docs_url": "https://github.com/googleapis/python-bigquery-sqlalchemy",
+ "connection_string": "mssql+pymssql://{username}@{server}:{password}@{server}.database.windows.net:1433/{database}",
+ "category": "Cloud - Azure",
"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",
+ "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": [
- 1003,
- 1005
+ 1014,
+ 1015
]
},
{
- "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",
+ "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": [
- 1003,
- 1004
+ 1007
]
},
{
- "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",
+ "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": [
- 1003,
- 1016
+ 1008
]
},
{
- "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",
+ "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": [
- 1030
+ 1009
]
}
]
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
+ "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,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
+ "supports_dynamic_catalog": false
},
"ClickHouse": {
- "engine": "clickhouse",
- "engine_name": "ClickHouse",
- "module": "clickhouse",
+ "time_grains": {
+ "SECOND": false,
+ "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.clickhouse",
+ "limit_method": 1,
+ "limit_clause": true,
+ "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,
+ "query_cancelation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "score": 61,
+ "max_score": 201,
"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"
+ "Analytical Databases",
+ "Open Source"
],
"pypi_packages": [
- "clickhouse-connect>=0.6.8"
+ "clickhouse-connect>=0.13.0"
],
"connection_string": "clickhousedb://{username}:{password}@{host}:{port}/{database}",
"default_port": 8123,
"drivers": [
{
"name": "clickhouse-connect (Recommended)",
- "pypi_package": "clickhouse-connect>=0.6.8",
+ "pypi_package": "clickhouse-connect>=0.13.0",
"connection_string": "clickhousedb://{username}:{password}@{host}:{port}/{database}",
"is_recommended": true,
"notes": "Official ClickHouse Python driver with native protocol support."
@@ -781,7 +3192,7 @@
"connection_string": "clickhousedb://localhost/default"
}
],
- "install_instructions": "echo \"clickhouse-connect>=0.6.8\" >> ./docker/requirements-local.txt",
+ "install_instructions": "echo \"clickhouse-connect>=0.13.0\" >> ./docker/requirements-local.txt",
"compatible_databases": [
{
"name": "ClickHouse Cloud",
@@ -789,12 +3200,12 @@
"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.6.8"
+ "clickhouse-connect>=0.13.0"
],
"connection_string": "clickhousedb://{username}:{password}@{host}:8443/{database}?secure=true",
"parameters": {
@@ -811,18 +3222,29 @@
"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.6.8"
+ "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,
@@ -846,59 +3268,145 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 51,
- "max_score": 201,
+ "module": "superset.db_engine_specs.clickhouse",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
+ "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,
"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
- },
- "CockroachDB": {
- "engine": "cockroachdb",
- "engine_name": "CockroachDB",
- "module": "cockroachdb",
+ "sql_validation": false,
+ "score": 41,
+ "max_score": 201,
"documentation": {
- "description": "CockroachDB is a distributed SQL database built for cloud applications.",
- "logo": "cockroachdb.png",
- "homepage_url": "https://www.cockroachlabs.com/",
+ "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"
+ ],
"pypi_packages": [
- "psycopg2",
- "cockroachdb"
+ "superset-engine-d1"
],
- "connection_string": "cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable",
- "default_port": 26257,
+ "connection_string": "d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id}",
"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"
+ "cloudflare_account_id": "Cloudflare account ID",
+ "cloudflare_api_token": "Cloudflare API token",
+ "cloudflare_d1_database_id": "D1 database ID"
},
- "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"
- ]
+ "install_instructions": "pip install superset-engine-d1",
+ "category": "Other Databases"
},
+ "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,
@@ -922,31 +3430,134 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 94,
- "max_score": 201,
+ "module": "superset.db_engine_specs.cockroachdb",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": 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": 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,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": true,
- "sql_validation": false
+ "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
},
"Couchbase": {
- "engine": "couchbase",
- "engine_name": "Couchbase",
- "module": "couchbase",
+ "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": false,
+ "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.couchbase",
+ "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": 27,
+ "max_score": 201,
"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"
+ "Search & NoSQL",
+ "Open Source"
],
"pypi_packages": [
"couchbase-sqlalchemy"
@@ -967,8 +3578,21 @@
"connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true",
"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,
@@ -982,7 +3606,7 @@
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
- "WEEK": false,
+ "WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
@@ -992,31 +3616,48 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 27,
- "max_score": 201,
- "joins": false,
- "subqueries": false,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
+ "module": "superset.db_engine_specs.crate",
+ "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,
- "supports_file_upload": true,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "CrateDB": {
- "engine": "cratedb",
- "engine_name": "CrateDB",
- "module": "crate",
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
+ "query_cost_estimation": false,
+ "sql_validation": false,
+ "score": 28,
+ "max_score": 201,
"documentation": {
"description": "CrateDB is a distributed SQL database for machine data and IoT workloads.",
"logo": "cratedb.svg",
- "homepage_url": "https://crate.io/",
+ "homepage_url": "https://cratedb.com",
"categories": [
- "TIME_SERIES",
- "OPEN_SOURCE"
+ "Time Series Databases",
+ "Open Source"
],
"pypi_packages": [
"crate",
@@ -1035,16 +3676,27 @@
"connection_string": "crate://{host}:{port}",
"is_recommended": true
}
- ]
+ ],
+ "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,
"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,
"HOUR": true,
@@ -1060,72 +3712,49 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 28,
- "max_score": 201,
+ "module": "superset.db_engine_specs.databend",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "supports_file_upload": 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,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "Cloudflare D1": {
- "engine": "cloudflare_d1",
- "engine_name": "Cloudflare D1",
- "module": "d1",
- "documentation": {
- "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": {
- "cloudflare_account_id": "Cloudflare account ID",
- "cloudflare_api_token": "Cloudflare API token",
- "cloudflare_d1_database_id": "D1 database ID"
- },
- "install_instructions": "pip install superset-engine-d1"
- },
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": 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,
"query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Databend": {
- "engine": "databend",
- "engine_name": "Databend",
- "module": "databend",
+ "sql_validation": false,
+ "score": 51,
+ "max_score": 201,
"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"
@@ -1138,8 +3767,19 @@
"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,
@@ -1163,81 +3803,122 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 51,
- "max_score": 201,
+ "module": "superset.db_engine_specs.databend",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
+ "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,
"query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Databricks Interactive Cluster": {
- "engine": "databricks_interactive_cluster",
- "engine_name": "Databricks Interactive Cluster",
- "module": "databricks",
+ "sql_validation": false,
+ "score": 51,
+ "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/",
- "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"
- ]
+ "pypi_packages": [],
+ "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
+ "category": "Other Databases"
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
+ "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,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
+ "supports_dynamic_catalog": false
},
"Databricks": {
- "engine": "databricks",
- "engine_name": "Databricks",
- "module": "databricks",
+ "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.databricks",
+ "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": true,
+ "dynamic_schema": true,
+ "catalog": true,
+ "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": 70,
+ "max_score": 201,
"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]"
@@ -1279,79 +3960,251 @@
"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,
+ "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.databricks",
+ "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": true,
+ "dynamic_schema": true,
+ "catalog": true,
+ "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": 70,
+ "max_score": 201,
+ "documentation": {
+ "pypi_packages": [],
+ "connection_string": "databricks+connector://token:{access_token}@{host}:{port}/{database_name}",
+ "category": "Cloud Data Warehouses"
+ },
+ "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,
+ "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.databricks",
+ "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": "Cloud Data Warehouses"
+ },
+ "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,
+ "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
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.databricks",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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
- },
- "IBM Db2": {
- "engine": "ibm_db2",
- "engine_name": "IBM Db2",
- "module": "db2",
+ "sql_validation": false,
+ "score": 30,
+ "max_score": 201,
"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,
- "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"
+ "pypi_packages": [],
+ "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
+ "category": "Cloud Data Warehouses"
},
+ "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": true,
+ "SECOND": false,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
@@ -1373,31 +4226,48 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 38,
- "max_score": 201,
+ "module": "superset.db_engine_specs.denodo",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Denodo": {
- "engine": "denodo",
- "engine_name": "Denodo",
- "module": "denodo",
+ "sql_validation": false,
+ "score": 27,
+ "max_score": 201,
"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"
+ "Query Engines",
+ "Proprietary"
],
"pypi_packages": [
"psycopg2"
@@ -1420,6 +4290,7 @@
"notes": "Uses PostgreSQL wire protocol."
}
],
+ "category": "Other Databases",
"custom_errors": [
{
"message_template": "Incorrect username or password.",
@@ -1504,9 +4375,254 @@
"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
+ ]
+ },
+ {
+ "message_template": "Invalid aggregation expression.",
+ "error_type": "SYNTAX_ERROR",
+ "category": "Query",
+ "description": "SQL syntax error",
+ "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
+ ]
+ }
+ ]
+ },
+ "engine": "denodo",
+ "engine_name": "Denodo",
+ "engine_aliases": [],
+ "default_driver": "psycopg2",
+ "supports_file_upload": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false
+ },
+ "Dremio": {
+ "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.dremio",
+ "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": "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."
+ }
+ ],
+ "category": "Other Databases"
+ },
+ "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,
+ "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.duckdb",
+ "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": 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,
+ "ssh_tunneling": 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,
+ "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"
+ ],
+ "connection_string": "duckdb:////path/to/duck.db",
+ "drivers": [
+ {
+ "name": "duckdb-engine",
+ "pypi_package": "duckdb-engine",
+ "connection_string": "duckdb:////path/to/duck.db",
+ "is_recommended": true
+ }
+ ],
+ "notes": "DuckDB supports both local file and in-memory databases. Use `:memory:` for in-memory database.",
+ "compatible_databases": [
+ {
+ "name": "MotherDuck",
+ "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"
+ ],
+ "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"
+ ]
+ }
+ ],
+ "category": "Other Databases",
+ "custom_errors": [
{
- "message_template": "Column \"%(column)s\" not found in \"%(view)s\".",
+ "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",
@@ -1514,29 +4630,21 @@
1003,
1004
]
- },
- {
- "message_template": "Invalid aggregation expression.",
- "error_type": "SYNTAX_ERROR",
- "category": "Query",
- "description": "SQL syntax error",
- "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
- ]
}
]
},
+ "engine": "duckdb",
+ "engine_name": "DuckDB",
+ "engine_aliases": [],
+ "default_driver": "duckdb_engine",
+ "supports_file_upload": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false
+ },
+ "Elasticsearch": {
"time_grains": {
- "SECOND": false,
+ "SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
@@ -1554,153 +4662,124 @@
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": true,
+ "QUARTER": false,
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 27,
- "max_score": 201,
- "joins": true,
+ "module": "superset.db_engine_specs.elasticsearch",
+ "limit_method": 1,
+ "limit_clause": true,
+ "joins": false,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
+ "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,
"ssh_tunneling": true,
"query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Apache Doris": {
- "engine": "apache_doris",
- "engine_name": "Apache Doris",
- "module": "doris",
+ "sql_validation": false,
+ "score": 37,
+ "max_score": 201,
"documentation": {
- "description": "Apache Doris is a high-performance real-time analytical database.",
- "logo": "doris.png",
- "homepage_url": "https://doris.apache.org/",
+ "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": [
- "mysqlclient",
- "pydoris"
+ "elasticsearch-dbapi"
],
- "connection_string": "doris://{username}:{password}@{host}:{port}/{catalog}.{database}",
- "default_port": 9030,
+ "connection_string": "elasticsearch+https://{user}:{password}@{host}:9243/",
+ "default_port": 9243,
"parameters": {
- "username": "User name",
- "password": "Password",
- "host": "Doris FE Host",
- "database": "Database name",
- "port": "Doris FE port",
- "catalog": "Catalog name"
+ "user": "Elasticsearch username",
+ "password": "Elasticsearch password",
+ "host": "Elasticsearch host"
},
- "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}",
+ "name": "Elasticsearch SQL API (Recommended)",
+ "pypi_package": "elasticsearch-dbapi",
+ "connection_string": "elasticsearch+https://{user}:{password}@{host}:9243/",
"is_recommended": true,
- "notes": "Recommended driver. May fail with caching_sha2_password auth."
+ "notes": "For Elastic Cloud and self-hosted Elasticsearch with SQL enabled."
},
{
- "name": "mysql-connector-python",
- "pypi_package": "mysql-connector-python",
- "connection_string": "mysql+mysqlconnector://{username}:{password}@{host}/{database}",
+ "name": "OpenDistro / OpenSearch SQL",
+ "pypi_package": "elasticsearch-dbapi",
+ "connection_string": "odelasticsearch+https://{user}:{password}@{host}:9200/",
"is_recommended": false,
- "notes": "Required for newer MySQL databases using caching_sha2_password authentication."
+ "notes": "For OpenDistro Elasticsearch or Amazon OpenSearch Service."
}
],
- "categories": [
- "APACHE_PROJECTS",
- "ANALYTICAL_DATABASES",
- "OPEN_SOURCE"
- ],
- "custom_errors": [
+ "compatible_databases": [
{
- "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
+ "name": "Elastic Cloud",
+ "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"
],
- "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
+ "pypi_packages": [
+ "elasticsearch-dbapi"
],
- "invalid_fields": [
- "host"
- ]
+ "connection_string": "elasticsearch+https://{user}:{password}@{deployment}.{region}.cloud.es.io:9243/",
+ "docs_url": "https://www.elastic.co/guide/en/cloud/current/"
},
{
- "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
+ "name": "Amazon OpenSearch Service",
+ "description": "Amazon OpenSearch Service (successor to Amazon Elasticsearch Service) is a managed search and analytics service on AWS.",
+ "logo": "elasticsearch.png",
+ "homepage_url": "https://aws.amazon.com/opensearch-service/",
+ "categories": [
+ "Search & NoSQL",
+ "Cloud - AWS",
+ "Hosted Open Source"
],
- "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
+ "pypi_packages": [
+ "elasticsearch-dbapi"
],
- "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
- ]
+ "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,
@@ -1716,7 +4795,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,
@@ -1724,55 +4803,94 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 79,
- "max_score": 201,
+ "module": "superset.db_engine_specs.exasol",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "supports_file_upload": 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,
+ "ssh_tunneling": true,
+ "query_cancelation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Dremio": {
- "engine": "dremio",
- "engine_name": "Dremio",
- "module": "dremio",
+ "sql_validation": false,
+ "score": 28,
+ "max_score": 201,
"documentation": {
- "description": "Dremio is a data lakehouse platform for fast, self-service analytics.",
- "logo": "dremio.png",
- "homepage_url": "https://www.dremio.com/",
+ "description": "Exasol is a high-performance, in-memory, MPP analytical database.",
+ "logo": "exasol.png",
+ "homepage_url": "https://www.exasol.com/",
"categories": [
- "QUERY_ENGINES",
- "PROPRIETARY"
+ "Analytical Databases",
+ "Proprietary"
],
"pypi_packages": [
- "sqlalchemy_dremio"
+ "sqlalchemy-exasol"
],
- "connection_string": "dremio+flight://data.dremio.cloud:443/?Token={token}&UseEncryption=true",
+ "connection_string": "exa+pyodbc://{username}:{password}@{dsn}",
+ "default_port": 8563,
"parameters": {
- "token": "Personal Access Token (PAT) or API token"
+ "username": "Database username",
+ "password": "Database password",
+ "dsn": "DSN name configured in odbc.ini"
},
"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": "pyodbc",
+ "pypi_package": "sqlalchemy-exasol",
+ "connection_string": "exa+pyodbc://{username}:{password}@{dsn}",
+ "is_recommended": true,
+ "notes": "Requires ODBC driver and DSN configuration."
},
{
- "name": "ODBC",
- "pypi_package": "sqlalchemy_dremio",
- "connection_string": "dremio+pyodbc://{token}@{host}:31010/dremio",
+ "name": "turbodbc",
+ "pypi_package": "sqlalchemy-exasol[turbodbc]",
+ "connection_string": "exa+turbodbc://{username}:{password}@{dsn}",
"is_recommended": false,
- "notes": "Requires Dremio ODBC drivers installed."
+ "notes": "Faster but requires additional dependencies."
+ },
+ {
+ "name": "websocket",
+ "pypi_package": "sqlalchemy-exasol[websocket]",
+ "connection_string": "exa+websocket://{username}:{password}@{host}:{port}/{schema}",
+ "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,
@@ -1786,78 +4904,83 @@
"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
},
- "score": 28,
- "max_score": 201,
+ "module": "superset.db_engine_specs.firebird",
+ "limit_method": 3,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Apache Drill": {
- "engine": "apache_drill",
- "engine_name": "Apache Drill",
- "module": "drill",
+ "sql_validation": false,
+ "score": 26,
+ "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/",
+ "description": "Firebird is an open-source relational database.",
+ "logo": "firebird.png",
+ "homepage_url": "https://firebirdsql.org/",
"categories": [
- "APACHE_PROJECTS",
- "QUERY_ENGINES",
- "OPEN_SOURCE"
+ "Traditional RDBMS",
+ "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/"
- }
+ "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,
"connection_examples": [
{
- "description": "Local embedded mode",
- "connection_string": "drill+sadrill://localhost:8047/dfs?use_ssl=False"
+ "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,
@@ -1865,8 +4988,8 @@
"MINUTE": true,
"FIVE_MINUTES": false,
"TEN_MINUTES": false,
- "FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
+ "FIFTEEN_MINUTES": false,
+ "THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
@@ -1881,83 +5004,85 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 50,
- "max_score": 201,
+ "module": "superset.db_engine_specs.firebolt",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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,
- "supports_file_upload": true,
- "user_impersonation": true,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Apache Druid": {
- "engine": "apache_druid",
- "engine_name": "Apache Druid",
- "module": "druid",
+ "sql_validation": false,
+ "score": 28,
+ "max_score": 201,
"documentation": {
- "description": "Apache Druid is a high performance real-time analytics database.",
- "logo": "druid.png",
- "homepage_url": "https://druid.apache.org/",
+ "description": "Firebolt is a cloud data warehouse designed for high-performance analytics.",
+ "logo": "firebolt.png",
+ "homepage_url": "https://www.firebolt.io/",
"categories": [
- "APACHE_PROJECTS",
- "TIME_SERIES",
- "OPEN_SOURCE"
+ "Cloud Data Warehouses",
+ "Analytical Databases",
+ "Proprietary"
],
"pypi_packages": [
- "pydruid"
+ "firebolt-sqlalchemy"
],
- "connection_string": "druid://{username}:{password}@{host}:{port}/druid/v2/sql",
- "default_port": 9088,
+ "connection_string": "firebolt://{client_id}:{client_secret}@{database}/{engine_name}?account_name={account_name}",
"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."
+ "client_id": "Service account client ID",
+ "client_secret": "Service account client secret",
+ "database": "Database name",
+ "engine_name": "Engine name",
+ "account_name": "Account name"
},
- "notes": "A native Druid connector ships with Superset (behind DRUID_IS_ACTIVE flag) but SQLAlchemy connector via pydruid is preferred.",
- "compatible_databases": [
+ "drivers": [
{
- "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/"
+ "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": true,
- "THIRTY_SECONDS": true,
+ "FIVE_SECONDS": false,
+ "THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
@@ -1965,82 +5090,116 @@
"THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
- "SIX_HOURS": 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
},
- "score": 47,
- "max_score": 201,
- "joins": false,
+ "module": "superset.db_engine_specs.bigquery",
+ "limit_method": 1,
+ "limit_clause": true,
+ "joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "supports_file_upload": 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,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "DuckDB": {
- "engine": "duckdb",
- "engine_name": "DuckDB",
- "module": "duckdb",
+ "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": "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/",
+ "description": "Google BigQuery is a serverless, highly scalable data warehouse.",
+ "logo": "google-big-query.svg",
+ "homepage_url": "https://cloud.google.com/bigquery/",
"categories": [
- "ANALYTICAL_DATABASES",
- "OPEN_SOURCE"
+ "Cloud - Google",
+ "Analytical Databases",
+ "Proprietary"
],
"pypi_packages": [
- "duckdb-engine"
+ "sqlalchemy-bigquery"
],
- "connection_string": "duckdb:////path/to/duck.db",
- "drivers": [
+ "connection_string": "bigquery://{project_id}",
+ "install_instructions": "echo \"sqlalchemy-bigquery\" >> ./docker/requirements-local.txt",
+ "authentication_methods": [
{
- "name": "duckdb-engine",
- "pypi_package": "duckdb-engine",
- "connection_string": "duckdb:////path/to/duck.db",
- "is_recommended": true
+ "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": "DuckDB supports both local file and in-memory databases. Use `:memory:` for in-memory database.",
- "compatible_databases": [
- {
- "name": "MotherDuck",
- "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"
- ],
- "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"
- ]
- }
+ "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 the column \"%(column_name)s\"",
+ "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",
@@ -2048,25 +5207,56 @@
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": "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": 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_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -2074,402 +5264,246 @@
"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,
- "query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": 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
- }
- ],
- "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",
- "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": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.datastore",
+ "limit_method": 3,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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": 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,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "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": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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,
"query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Elasticsearch": {
- "engine": "elasticsearch",
- "engine_name": "Elasticsearch",
- "module": "elasticsearch",
+ "sql_validation": false,
+ "score": 73,
+ "max_score": 201,
"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/",
+ "description": "Google Cloud Datastore is a highly scalable NoSQL database for your applications.",
+ "logo": "datastore.png",
+ "homepage_url": "https://cloud.google.com/datastore/",
"categories": [
- "SEARCH_NOSQL",
- "OPEN_SOURCE"
+ "Cloud - Google",
+ "Search & NoSQL",
+ "Proprietary"
],
"pypi_packages": [
- "elasticsearch-dbapi"
+ "python-datastore-sqlalchemy"
],
- "connection_string": "elasticsearch+https://{user}:{password}@{host}:9243/",
- "default_port": 9243,
- "parameters": {
- "user": "Elasticsearch username",
- "password": "Elasticsearch password",
- "host": "Elasticsearch host"
- },
- "drivers": [
- {
- "name": "Elasticsearch SQL API (Recommended)",
- "pypi_package": "elasticsearch-dbapi",
- "connection_string": "elasticsearch+https://{user}:{password}@{host}:9243/",
- "is_recommended": true,
- "notes": "For Elastic Cloud and self-hosted Elasticsearch with SQL enabled."
- },
+ "connection_string": "datastore://{project_id}/?database={database_id}",
+ "authentication_methods": [
{
- "name": "OpenDistro / OpenSearch SQL",
- "pypi_package": "elasticsearch-dbapi",
- "connection_string": "odelasticsearch+https://{user}:{password}@{host}:9200/",
- "is_recommended": false,
- "notes": "For OpenDistro Elasticsearch or Amazon OpenSearch Service."
+ "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": "..."
+ }
+ }
}
],
- "compatible_databases": [
+ "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": [
{
- "name": "Elastic Cloud",
- "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"
- ],
- "connection_string": "elasticsearch+https://{user}:{password}@{deployment}.{region}.cloud.es.io:9243/",
- "docs_url": "https://www.elastic.co/guide/en/cloud/current/"
+ "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
+ ]
},
{
- "name": "Amazon OpenSearch Service",
- "description": "Amazon OpenSearch Service (successor to Amazon Elasticsearch Service) is a managed search and analytics service on AWS.",
- "logo": "elasticsearch.png",
- "homepage_url": "https://aws.amazon.com/opensearch-service/",
- "categories": [
- "SEARCH_NOSQL",
- "CLOUD_AWS",
- "HOSTED_OPEN_SOURCE"
- ],
- "pypi_packages": [
- "elasticsearch-dbapi"
- ],
- "connection_string": "odelasticsearch+https://{user}:{password}@{host}:443/",
- "docs_url": "https://docs.aws.amazon.com/opensearch-service/latest/developerguide/"
- }
- ]
- },
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": 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"
- ],
- "connection_string": "exa+pyodbc://{username}:{password}@{dsn}",
- "default_port": 8563,
- "parameters": {
- "username": "Database username",
- "password": "Database password",
- "dsn": "DSN name configured in odbc.ini"
- },
- "drivers": [
+ "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
+ ]
+ },
{
- "name": "pyodbc",
- "pypi_package": "sqlalchemy-exasol",
- "connection_string": "exa+pyodbc://{username}:{password}@{dsn}",
- "is_recommended": true,
- "notes": "Requires ODBC driver and DSN configuration."
+ "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
+ ]
},
{
- "name": "turbodbc",
- "pypi_package": "sqlalchemy-exasol[turbodbc]",
- "connection_string": "exa+turbodbc://{username}:{password}@{dsn}",
- "is_recommended": false,
- "notes": "Faster but requires additional dependencies."
+ "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
+ ]
},
{
- "name": "websocket",
- "pypi_package": "sqlalchemy-exasol[websocket]",
- "connection_string": "exa+websocket://{username}:{password}@{host}:{port}/{schema}",
- "is_recommended": false,
- "notes": "Pure Python, no ODBC required."
+ "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": "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": false,
- "THIRTY_SECONDS": false,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
"MINUTE": true,
- "FIVE_MINUTES": false,
- "TEN_MINUTES": false,
- "FIFTEEN_MINUTES": false,
- "THIRTY_MINUTES": false,
- "HALF_HOUR": false,
+ "FIVE_MINUTES": true,
+ "TEN_MINUTES": true,
+ "FIFTEEN_MINUTES": true,
+ "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
},
- "score": 28,
- "max_score": 201,
+ "module": "superset.db_engine_specs.gsheets",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": 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,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Firebird": {
- "engine": "firebird",
- "engine_name": "Firebird",
- "module": "firebird",
+ "sql_validation": false,
+ "score": 61,
+ "max_score": 201,
"documentation": {
- "description": "Firebird is an open-source relational database.",
- "logo": "firebird.png",
- "homepage_url": "https://firebirdsql.org/",
+ "description": "Google Sheets allows querying spreadsheets as SQL tables via shillelagh.",
+ "logo": "google-sheets.svg",
+ "homepage_url": "https://www.google.com/sheets/about/",
"categories": [
- "TRADITIONAL_RDBMS",
- "OPEN_SOURCE"
+ "Cloud - Google",
+ "Hosted Open Source"
],
"pypi_packages": [
- "sqlalchemy-firebird"
+ "shillelagh[gsheetsapi]"
],
- "version_requirements": "sqlalchemy-firebird>=0.7.0,<0.8",
- "connection_string": "firebird+fdb://{username}:{password}@{host}:{port}//{path_to_db_file}",
- "default_port": 3050,
- "connection_examples": [
+ "install_instructions": "pip install \"apache-superset[gsheets]\"",
+ "connection_string": "gsheets://",
+ "notes": "Requires Google service account credentials or OAuth2 authentication. See docs for setup instructions.",
+ "category": "Cloud - Google",
+ "custom_errors": [
{
- "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"
+ "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": false,
- "WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": false,
- "WEEK_ENDING_SATURDAY": false,
- "WEEK_ENDING_SUNDAY": false,
- "MONTH": true,
- "QUARTER": false,
- "QUARTER_YEAR": false,
- "YEAR": true
- },
- "score": 26,
- "max_score": 201,
- "joins": true,
- "subqueries": true,
+ "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,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
+ "supports_dynamic_catalog": 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"
- ],
- "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
- }
- ]
- },
+ "Greenplum": {
"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,
@@ -2484,30 +5518,50 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 28,
- "max_score": 201,
+ "module": "superset.db_engine_specs.greenplum",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "supports_file_upload": 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,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "Greenplum": {
- "engine": "greenplum",
- "engine_name": "Greenplum",
- "module": "greenplum",
+ "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": false,
+ "score": 94,
+ "max_score": 201,
"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": [
- "psycopg2",
"sqlalchemy-greenplum",
"psycopg2"
],
@@ -2520,71 +5574,21 @@
"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://docs.vmware.com/en/VMware-Greenplum/",
- "sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
- "categories": [
- "TRADITIONAL_RDBMS",
- "OPEN_SOURCE"
- ]
+ "category": "Other Databases"
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
+ "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
},
- "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/",
- "pypi_packages": [
- "shillelagh[gsheetsapi]",
- "shillelagh[gsheetsapi]"
- ],
- "connection_string": "gsheets://",
- "notes": "Requires Google service account credentials or OAuth2 authentication. See docs for setup instructions.",
- "categories": [
- "CLOUD_GCP",
- "HOSTED_OPEN_SOURCE"
- ],
- "install_instructions": "pip install \"apache-superset[gsheets]\"",
- "custom_errors": [
- {
- "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
- ]
- }
- ]
- },
+ "Hologres": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -2594,55 +5598,89 @@
"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
},
- "score": 61,
- "max_score": 201,
+ "module": "superset.db_engine_specs.hologres",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": 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,
- "supports_file_upload": true,
- "user_impersonation": true,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "SAP HANA": {
- "engine": "sap_hana",
- "engine_name": "SAP HANA",
- "module": "hana",
+ "sql_validation": false,
+ "score": 34,
+ "max_score": 201,
"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",
+ "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": [
- "TRADITIONAL_RDBMS",
- "PROPRIETARY"
+ "Cloud Data Warehouses",
+ "Analytical Databases",
+ "Proprietary"
],
"pypi_packages": [
- "hdbcli",
- "sqlalchemy-hana"
+ "psycopg2"
],
- "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"
+ "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"
+ },
+ "default_port": 80,
+ "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.",
+ "category": "Other Databases"
},
+ "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,
@@ -2656,7 +5694,7 @@
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
- "WEEK": false,
+ "WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
@@ -2666,54 +5704,104 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 27,
- "max_score": 201,
+ "module": "superset.db_engine_specs.db2",
+ "limit_method": 2,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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": 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,
"ssh_tunneling": true,
"query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Apache Hive": {
- "engine": "apache_hive",
- "engine_name": "Apache Hive",
- "module": "hive",
+ "sql_validation": false,
+ "score": 38,
+ "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/",
+ "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": [
- "pyhive",
- "pyhive"
+ "ibm_db_sa"
],
- "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"
- },
+ "connection_string": "db2+ibm_db://{username}:{password}@{hostname}:{port}/{database}",
+ "default_port": 50000,
"drivers": [
{
- "name": "PyHive",
- "pypi_package": "pyhive",
- "connection_string": "presto://{hostname}:{port}/{database}",
+ "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."
}
],
- "categories": [
- "APACHE_PROJECTS",
- "QUERY_ENGINES",
- "OPEN_SOURCE"
- ]
+ "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"
},
+ "engine": "db2",
+ "engine_name": "IBM Db2",
+ "engine_aliases": [
+ "ibm_db_sa"
+ ],
+ "default_driver": null,
+ "supports_file_upload": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false
+ },
+ "IBM Db2 for i": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -2728,82 +5816,57 @@
"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
},
- "score": 140,
- "max_score": 201,
+ "module": "superset.db_engine_specs.ibmi",
+ "limit_method": 2,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": 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": 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,
"ssh_tunneling": true,
- "query_cancelation": true,
- "supports_file_upload": true,
- "user_impersonation": true,
- "query_cost_estimation": true,
- "sql_validation": false
- },
- "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"
- ],
- "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"
- },
- "default_port": 80,
- "notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset."
- },
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
"query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "IBM Db2 for i": {
- "engine": "ibm_db2_for_i",
- "engine_name": "IBM Db2 for i",
- "module": "ibmi",
+ "sql_validation": false,
+ "score": 38,
+ "max_score": 201,
"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"
+ "Traditional RDBMS",
+ "Proprietary"
],
"pypi_packages": [
"ibm_db_sa"
@@ -2823,44 +5886,128 @@
"notes": "Use for older DB2 versions without LIMIT [n] syntax. Recommended for SQL Lab."
}
],
- "docs_url": "https://github.com/ibmdb/python-ibmdbsa"
+ "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"
+ },
+ "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": {
+ "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
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.netezza",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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
- },
- "Apache Impala": {
- "engine": "apache_impala",
- "engine_name": "Apache Impala",
- "module": "impala",
+ "sql_validation": false,
+ "score": 28,
+ "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/",
+ "description": "IBM Netezza Performance Server is a data warehouse appliance.",
+ "logo": "netezza.png",
+ "homepage_url": "https://www.ibm.com/products/netezza",
"categories": [
- "APACHE_PROJECTS",
- "QUERY_ENGINES",
- "OPEN_SOURCE"
+ "Traditional RDBMS",
+ "Proprietary"
],
"pypi_packages": [
- "impyla"
+ "nzalchemy"
],
- "connection_string": "impala://{hostname}:{port}/{database}",
- "default_port": 21050
+ "connection_string": "netezza+nzpy://{username}:{password}@{hostname}:{port}/{database}",
+ "default_port": 5480,
+ "category": "Other Databases"
},
+ "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": false,
+ "SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
@@ -2874,7 +6021,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,
@@ -2882,152 +6029,83 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 37,
- "max_score": 201,
+ "module": "superset.db_engine_specs.mariadb",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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": 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,
- "supports_file_upload": true,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": 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": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Azure Data Explorer": {
- "engine": "azure_data_explorer",
- "engine_name": "Azure Data Explorer",
- "module": "kusto",
+ "sql_validation": false,
+ "score": 59,
+ "max_score": 201,
"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/",
+ "description": "MariaDB is a community-developed fork of MySQL.",
+ "logo": "mariadb.png",
+ "homepage_url": "https://mariadb.org/",
"categories": [
- "CLOUD_AZURE",
- "ANALYTICAL_DATABASES",
- "PROPRIETARY"
+ "Traditional RDBMS",
+ "Open Source"
],
"pypi_packages": [
- "sqlalchemy-kusto"
+ "mysqlclient"
],
- "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": "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": "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 native Kusto Query Language for advanced analytics."
- }
- ]
+ "connection_string": "mysql://{username}:{password}@{host}/{database}",
+ "default_port": 3306,
+ "notes": "Uses the MySQL driver. Fully compatible with MySQL connector.",
+ "category": "Traditional RDBMS"
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
+ "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,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
+ "supports_dynamic_catalog": false
},
- "Apache Kylin": {
- "engine": "apache_kylin",
- "engine_name": "Apache Kylin",
- "module": "kylin",
- "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
- },
+ "Microsoft SQL Server": {
"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,
@@ -3035,80 +6113,125 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 28,
- "max_score": 201,
+ "module": "superset.db_engine_specs.mssql",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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": 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,
"ssh_tunneling": true,
"query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "MariaDB": {
- "engine": "mariadb",
- "engine_name": "MariaDB",
- "module": "mariadb",
+ "sql_validation": false,
+ "score": 44,
+ "max_score": 201,
"documentation": {
- "description": "MariaDB is a community-developed fork of MySQL.",
- "logo": "mariadb.png",
- "homepage_url": "https://mariadb.org/",
+ "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": [
- "mysqlclient",
- "mysqlclient"
+ "pymssql"
],
- "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": [
+ "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
+ "default_port": 1433,
+ "drivers": [
{
- "platform": "Localhost",
- "host": "localhost or 127.0.0.1"
+ "name": "pymssql",
+ "pypi_package": "pymssql",
+ "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
+ "is_recommended": true
},
{
- "platform": "Docker on Linux",
- "host": "172.18.0.1"
- },
+ "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."
+ }
+ ],
+ "docs_url": "https://docs.sqlalchemy.org/en/20/core/engines.html#escaping-special-characters-such-as-signs-in-passwords",
+ "category": "Cloud - Azure",
+ "custom_errors": [
{
- "platform": "Docker on macOS",
- "host": "docker.for.mac.host.internal"
+ "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
+ ]
},
{
- "platform": "On-premise",
- "host": "IP address or hostname"
- }
- ],
- "drivers": [
+ "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
+ ]
+ },
{
- "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."
+ "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
+ ]
},
{
- "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."
+ "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
+ ]
}
- ],
- "categories": [
- "TRADITIONAL_RDBMS",
- "OPEN_SOURCE"
- ],
- "notes": "Uses the MySQL driver. Fully compatible with MySQL connector."
+ ]
},
+ "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,
@@ -3122,41 +6245,58 @@
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
- "WEEK": true,
+ "WEEK": false,
"WEEK_STARTING_SUNDAY": false,
- "WEEK_STARTING_MONDAY": true,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
- "QUARTER": true,
+ "QUARTER": false,
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 59,
- "max_score": 201,
+ "module": "superset.db_engine_specs.monetdb",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "supports_file_upload": 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
- },
- "MonetDB": {
- "engine": "monetdb",
- "engine_name": "MonetDB",
- "module": "monetdb",
+ "sql_validation": false,
+ "score": 26,
+ "max_score": 201,
"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"
+ "Traditional RDBMS",
+ "Open Source"
],
"pypi_packages": [
"sqlalchemy-monetdb",
@@ -3171,34 +6311,84 @@
"port": "Default 50000",
"database": "Database name"
},
- "docs_url": "https://www.monetdb.org/documentation/"
+ "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": {
+ "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": true,
+ "WEEK_ENDING_SATURDAY": true,
+ "WEEK_ENDING_SUNDAY": true,
+ "MONTH": true,
+ "QUARTER": true,
+ "QUARTER_YEAR": false,
+ "YEAR": true
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.mongodb",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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
- },
- "MongoDB": {
- "engine": "mongodb",
- "engine_name": "MongoDB",
- "module": "mongodb",
+ "sql_validation": false,
+ "score": 32,
+ "max_score": 201,
"documentation": {
"description": "MongoDB is a document-oriented, operational NoSQL database.",
"logo": "mongodb.png",
"homepage_url": "https://www.mongodb.com/",
"categories": [
- "SEARCH_NOSQL",
- "PROPRIETARY"
+ "Search & NoSQL",
+ "Proprietary"
],
"pypi_packages": [
"pymongosql"
@@ -3228,116 +6418,35 @@
}
],
"notes": "Uses PartiQL for SQL queries. Requires mode=superset parameter.",
- "docs_url": "https://github.com/passren/PyMongoSQL"
+ "docs_url": "https://github.com/passren/PyMongoSQL",
+ "category": "Other Databases"
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
+ "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,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
+ "supports_dynamic_catalog": false
},
- "Microsoft SQL Server": {
- "engine": "microsoft_sql_server",
- "engine_name": "Microsoft SQL Server",
- "module": "mssql",
- "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."
- }
- ],
- "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
- ]
- }
- ]
- },
+ "MotherDuck": {
"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_MONDAY": true,
+ "WEEK_STARTING_SUNDAY": false,
+ "WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
@@ -3345,125 +6454,160 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 44,
- "max_score": 201,
+ "module": "superset.db_engine_specs.duckdb",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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": 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,
"ssh_tunneling": true,
"query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Azure Synapse": {
- "engine": "azure_synapse",
- "engine_name": "Azure Synapse",
- "module": "mssql",
+ "sql_validation": false,
+ "score": 58,
+ "max_score": 201,
"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": "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"
+ ],
"pypi_packages": [
- "pymssql",
- "pymssql"
+ "duckdb",
+ "duckdb-engine"
],
- "connection_string": "mssql+pymssql://{username}@{server}:{password}@{server}.database.windows.net:1433/{database}",
- "default_port": 1433,
+ "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/",
"drivers": [
{
- "name": "pymssql",
- "pypi_package": "pymssql",
- "connection_string": "mssql+pymssql://{username}:{password}@{host}:{port}/{database}",
+ "name": "duckdb-engine",
+ "pypi_package": "duckdb-engine",
+ "connection_string": "duckdb:///md:{database}?motherduck_token={token}",
"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."
}
],
- "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"
- ],
+ "category": "Other Databases",
"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",
+ "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": [
- 1009
+ 1003,
+ 1004
]
}
]
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "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,
+ "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.mysql",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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": 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
- },
- "MySQL": {
- "engine": "mysql",
- "engine_name": "MySQL",
- "module": "mysql",
+ "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"
+ "Traditional RDBMS",
+ "Open Source"
],
"pypi_packages": [
"mysqlclient"
@@ -3521,7 +6665,7 @@
],
"connection_string": "mysql://{username}:{password}@{host}:{port}/{database}",
"categories": [
- "OPEN_SOURCE"
+ "Open Source"
]
},
{
@@ -3543,11 +6687,12 @@
},
"notes": "Uses the Data API for serverless access. Standard MySQL connections also work with mysqlclient.",
"categories": [
- "CLOUD_AWS",
- "HOSTED_OPEN_SOURCE"
+ "Cloud - AWS",
+ "Hosted Open Source"
]
}
],
+ "category": "Traditional RDBMS",
"custom_errors": [
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
@@ -3616,6 +6761,16 @@
}
]
},
+ "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,
@@ -3639,111 +6794,54 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 59,
- "max_score": 201,
+ "module": "superset.db_engine_specs.oceanbase",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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": 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,
"ssh_tunneling": true,
"query_cancelation": true,
- "supports_file_upload": true,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": 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": {},
- "score": 0,
- "max_score": 0,
- "joins": true,
- "subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": false,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "OceanBase": {
- "engine": "oceanbase",
- "engine_name": "OceanBase",
- "module": "oceanbase",
+ "sql_validation": false,
+ "score": 59,
+ "max_score": 201,
"documentation": {
"description": "OceanBase is a distributed relational database.",
"logo": "oceanbase.svg",
"homepage_url": "https://www.oceanbase.com/",
+ "categories": [
+ "Traditional RDBMS",
+ "Open Source"
+ ],
"pypi_packages": [
- "mysqlclient",
"oceanbase_py"
],
"connection_string": "oceanbase://{username}:{password}@{host}:{port}/{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."
- }
- ],
- "categories": [
- "TRADITIONAL_RDBMS",
- "OPEN_SOURCE"
- ],
+ "category": "Other Databases",
"custom_errors": [
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
@@ -3812,36 +6910,89 @@
}
]
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "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,
+ "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
+ },
+ "module": "superset.db_engine_specs.ocient",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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": 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,
+ "ssh_tunneling": true,
+ "query_cancelation": true,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Ocient": {
- "engine": "ocient",
- "engine_name": "Ocient",
- "module": "ocient",
+ "sql_validation": false,
+ "score": 38,
+ "max_score": 201,
"documentation": {
"description": "Ocient is a hyperscale data analytics database.",
"categories": [
- "ANALYTICAL_DATABASES",
- "PROPRIETARY"
+ "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",
@@ -3932,6 +7083,16 @@
}
]
},
+ "engine": "ocient",
+ "engine_name": "Ocient",
+ "engine_aliases": [],
+ "default_driver": null,
+ "supports_file_upload": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false
+ },
+ "OpenSearch (OpenDistro)": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
@@ -3945,50 +7106,66 @@
"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": false,
- "QUARTER_YEAR": true,
+ "QUARTER_YEAR": false,
"YEAR": true
},
- "score": 38,
- "max_score": 201,
- "joins": true,
+ "module": "superset.db_engine_specs.elasticsearch",
+ "limit_method": 1,
+ "limit_clause": true,
+ "joins": false,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "supports_file_upload": 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,
+ "ssh_tunneling": true,
+ "query_cancelation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Oracle": {
- "engine": "oracle",
- "engine_name": "Oracle",
- "module": "oracle",
+ "sql_validation": false,
+ "score": 26,
+ "max_score": 201,
"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://{username}:{password}@{hostname}:{port}",
- "default_port": 1521,
- "notes": "Previously used cx_Oracle, now uses oracledb.",
- "docs_url": "https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html"
+ "pypi_packages": [],
+ "connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
+ "category": "Other Databases"
},
+ "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,
@@ -4012,43 +7189,68 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 28,
- "max_score": 201,
+ "module": "superset.db_engine_specs.oracle",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": 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": 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,
"ssh_tunneling": true,
"query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": false,
+ "expand_data": false,
"query_cost_estimation": false,
- "sql_validation": false
- },
- "Parseable": {
- "engine": "parseable",
- "engine_name": "Parseable",
- "module": "parseable",
+ "sql_validation": false,
+ "score": 28,
+ "max_score": 201,
"documentation": {
- "description": "Parseable is a distributed log analytics database with SQL-like query interface.",
+ "description": "Oracle Database is a multi-model database management system.",
+ "logo": "oraclelogo.png",
+ "homepage_url": "https://www.oracle.com/database/",
"categories": [
- "SEARCH_NOSQL",
- "OPEN_SOURCE"
+ "Traditional RDBMS",
+ "Proprietary"
],
"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"
- }
+ "oracledb"
],
- "notes": "Stream name in URI represents the Parseable logstream to query. Supports HTTP (80) and HTTPS (443).",
- "docs_url": "https://www.parseable.io"
+ "connection_string": "oracle://{username}:{password}@{hostname}:{port}",
+ "default_port": 1521,
+ "notes": "Previously used cx_Oracle, now uses oracledb.",
+ "docs_url": "https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html",
+ "category": "Other Databases"
},
+ "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,
@@ -4069,99 +7271,78 @@
"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,
- "query_cancelation": false,
- "supports_file_upload": true,
- "user_impersonation": false,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "Apache Phoenix": {
- "engine": "apache_phoenix",
- "engine_name": "Apache Phoenix",
- "module": "phoenix",
- "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."
+ "QUARTER_YEAR": false,
+ "YEAR": true
},
- "time_grains": {},
- "score": 0,
- "max_score": 0,
+ "module": "superset.db_engine_specs.parseable",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": false,
- "query_cancelation": false,
- "supports_file_upload": 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
- },
- "Apache Pinot": {
- "engine": "apache_pinot",
- "engine_name": "Apache Pinot",
- "module": "pinot",
+ "sql_validation": false,
+ "score": 28,
+ "max_score": 201,
"documentation": {
- "description": "Apache Pinot is a real-time distributed OLAP datastore.",
- "logo": "apache-pinot.svg",
- "homepage_url": "https://pinot.apache.org/",
+ "description": "Parseable is a distributed log analytics database with SQL-like query interface.",
"categories": [
- "APACHE_PROJECTS",
- "TIME_SERIES",
- "OPEN_SOURCE"
+ "Search & NoSQL",
+ "Open Source"
],
"pypi_packages": [
- "pinotdb"
+ "sqlalchemy-parseable"
],
- "connection_string": "pinot+http://{broker_host}:{broker_port}/query?controller=http://{controller_host}:{controller_port}/",
- "default_port": 8099,
+ "connection_string": "parseable://{username}:{password}@{hostname}:{port}/{stream_name}",
"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"
+ "description": "Example connection",
+ "connection_string": "parseable://admin:admin@demo.parseable.com:443/ingress-nginx"
}
],
- "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"
- }
- ]
+ "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": {
"time_grains": {
"SECOND": true,
- "FIVE_SECONDS": false,
- "THIRTY_SECONDS": false,
+ "FIVE_SECONDS": true,
+ "THIRTY_SECONDS": true,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
@@ -4181,31 +7362,48 @@
"QUARTER_YEAR": false,
"YEAR": true
},
- "score": 32,
- "max_score": 201,
- "joins": false,
- "subqueries": false,
- "supports_dynamic_schema": false,
- "supports_catalog": false,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": false,
- "supports_file_upload": 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,
- "query_cost_estimation": false,
- "sql_validation": false
- },
- "PostgreSQL": {
- "engine": "postgresql",
- "engine_name": "PostgreSQL",
- "module": "postgres",
+ "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"
+ "Traditional RDBMS",
+ "Open Source"
],
"pypi_packages": [
"psycopg2"
@@ -4250,7 +7448,7 @@
"database": "Name of the Hologres database"
},
"categories": [
- "PROPRIETARY"
+ "Proprietary"
]
},
{
@@ -4271,7 +7469,7 @@
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://docs.timescale.com/",
"categories": [
- "OPEN_SOURCE"
+ "Open Source"
]
},
{
@@ -4286,7 +7484,7 @@
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://www.yugabyte.com/",
"categories": [
- "OPEN_SOURCE"
+ "Open Source"
]
},
{
@@ -4316,7 +7514,7 @@
"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"
+ "Hosted Open Source"
]
},
{
@@ -4338,8 +7536,8 @@
"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_GCP",
- "HOSTED_OPEN_SOURCE"
+ "Cloud - Google",
+ "Hosted Open Source"
]
},
{
@@ -4360,7 +7558,7 @@
"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"
+ "Hosted Open Source"
]
},
{
@@ -4382,11 +7580,12 @@
},
"notes": "Uses the Data API for serverless access. Standard PostgreSQL connections also work with psycopg2.",
"categories": [
- "CLOUD_AWS",
- "HOSTED_OPEN_SOURCE"
+ "Cloud - AWS",
+ "Hosted Open Source"
]
}
],
+ "category": "Traditional RDBMS",
"custom_errors": [
{
"regex_name": "CONNECTION_INVALID_USERNAME_REGEX",
@@ -4506,6 +7705,18 @@
}
]
},
+ "engine": "postgresql",
+ "engine_name": "PostgreSQL",
+ "engine_aliases": [
+ "postgres"
+ ],
+ "default_driver": "psycopg2",
+ "supports_file_upload": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true
+ },
+ "Presto": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -4514,46 +7725,63 @@
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": true,
- "HALF_HOUR": false,
+ "THIRTY_MINUTES": false,
+ "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,
"YEAR": true
},
- "score": 104,
- "max_score": 201,
+ "module": "superset.db_engine_specs.presto",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": false,
+ "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,
"ssh_tunneling": true,
"query_cancelation": true,
- "supports_file_upload": true,
- "user_impersonation": false,
+ "get_metrics": false,
+ "where_latest_partition": true,
+ "expand_data": true,
"query_cost_estimation": true,
- "sql_validation": true
- },
- "Presto": {
- "engine": "presto",
- "engine_name": "Presto",
- "module": "presto",
+ "sql_validation": true,
+ "score": 159,
+ "max_score": 201,
"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"
+ "Query Engines",
+ "Open Source"
],
"pypi_packages": [
"pyhive"
@@ -4574,6 +7802,7 @@
"is_recommended": true
}
],
+ "category": "Query Engines",
"custom_errors": [
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
@@ -4661,6 +7890,280 @@
}
]
},
+ "engine": "presto",
+ "engine_name": "Presto",
+ "engine_aliases": [],
+ "default_driver": null,
+ "supports_file_upload": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true
+ },
+ "RisingWave": {
+ "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.risingwave",
+ "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": false,
+ "score": 94,
+ "max_score": 201,
+ "documentation": {
+ "description": "RisingWave is a distributed streaming database.",
+ "logo": "risingwave.svg",
+ "homepage_url": "https://risingwave.com/",
+ "categories": [
+ "Analytical Databases",
+ "Open Source"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-risingwave"
+ ],
+ "connection_string": "risingwave://root@{hostname}:{port}/{database}?sslmode=disable",
+ "default_port": 4566,
+ "docs_url": "https://github.com/risingwavelabs/sqlalchemy-risingwave",
+ "category": "Other Databases"
+ },
+ "engine": "risingwave",
+ "engine_name": "RisingWave",
+ "engine_aliases": [
+ "postgres"
+ ],
+ "default_driver": "",
+ "supports_file_upload": true,
+ "supports_dynamic_schema": true,
+ "supports_catalog": true,
+ "supports_dynamic_catalog": true
+ },
+ "SAP 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": false,
+ "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.hana",
+ "limit_method": 2,
+ "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": 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,
+ "ssh_tunneling": 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,
+ "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",
+ "category": "Other Databases"
+ },
+ "engine": "hana",
+ "engine_name": "SAP HANA",
+ "engine_aliases": [],
+ "default_driver": null,
+ "supports_file_upload": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false
+ },
+ "SAP Sybase": {
+ "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": true,
+ "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.sybase",
+ "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": 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,
+ "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,
+ "documentation": {
+ "description": "SAP ASE (formerly Sybase) is an enterprise relational database.",
+ "logo": "sybase.png",
+ "homepage_url": "https://www.sap.com/products/technology-platform/sybase-ase.html",
+ "categories": [
+ "Traditional RDBMS",
+ "Proprietary"
+ ],
+ "pypi_packages": [
+ "sqlalchemy-sybase",
+ "pyodbc"
+ ],
+ "connection_string": "sybase+pyodbc://{username}:{password}@{dsn}",
+ "parameters": {
+ "username": "Database username",
+ "password": "Database password",
+ "dsn": "ODBC Data Source Name configured for SAP ASE"
+ },
+ "notes": "Requires SAP ASE ODBC driver installed and configured as a DSN.",
+ "docs_url": "https://help.sap.com/docs/SAP_ASE",
+ "category": "Other Databases"
+ },
+ "engine": "sybase",
+ "engine_name": "SAP Sybase",
+ "engine_aliases": [
+ "sybase_sqlany"
+ ],
+ "default_driver": "pyodbc",
+ "supports_file_upload": true,
+ "supports_dynamic_schema": false,
+ "supports_catalog": false,
+ "supports_dynamic_catalog": false
+ },
+ "SQLite": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
@@ -4669,7 +8172,7 @@
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
- "THIRTY_MINUTES": false,
+ "THIRTY_MINUTES": true,
"HALF_HOUR": true,
"HOUR": true,
"SIX_HOURS": true,
@@ -4681,230 +8184,172 @@
"WEEK_ENDING_SUNDAY": true,
"MONTH": true,
"QUARTER": true,
- "QUARTER_YEAR": false,
+ "QUARTER_YEAR": true,
"YEAR": true
},
- "score": 159,
- "max_score": 201,
+ "module": "superset.db_engine_specs.sqlite",
+ "limit_method": 1,
+ "limit_clause": true,
"joins": true,
"subqueries": true,
- "supports_dynamic_schema": true,
- "supports_catalog": true,
- "supports_dynamic_catalog": false,
- "ssh_tunneling": true,
- "query_cancelation": true,
- "supports_file_upload": true,
- "user_impersonation": true,
- "query_cost_estimation": true,
- "sql_validation": true
- },
- "Amazon Redshift": {
- "engine": "amazon_redshift",
- "engine_name": "Amazon Redshift",
- "module": "redshift",
+ "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,
"documentation": {
- "description": "Amazon Redshift is a fully managed data warehouse service.",
- "logo": "redshift.png",
- "homepage_url": "https://aws.amazon.com/redshift/",
+ "description": "SQLite is a self-contained, serverless SQL database engine.",
+ "logo": "sqlite.png",
+ "homepage_url": "https://www.sqlite.org/",
"categories": [
- "CLOUD_AWS",
- "ANALYTICAL_DATABASES",
- "PROPRIETARY"
- ],
- "pypi_packages": [
- "sqlalchemy-redshift"
- ],
- "connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
- "default_port": 5439,
- "parameters": {
- "username": "Database username",
- "password": "Database password",
- "host": "AWS Endpoint",
- "port": "Default 5439",
- "database": "Database name"
- },
- "drivers": [
- {
- "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 Credentials (Serverless)",
- "description": "Use IAM-based credentials for Redshift Serverless",
- "requirements": "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>"
- }
- }
- }
+ "Traditional RDBMS",
+ "Open Source"
],
+ "pypi_packages": [],
+ "connection_string": "sqlite:///path/to/file.db?check_same_thread=false",
+ "notes": "No additional library needed. SQLite is bundled with Python.",
+ "category": "Traditional RDBMS",
"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"
- ]
... 1847 lines suppressed ...