QT/superset2
1
0
Fork 0
mirror of https://github.com/apache/superset.git synced 2026-06-10 18:19:28 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
f1d13e11dd425fdc213023506cb65b52b64f03b8
superset2/docs/src/data/databases.json
Evan Rusackas 5bde86785f fix(docs): read capability flags from engine specs in database docs generator (#39449) 
Co-authored-by: Superset Dev <dev@superset.apache.org>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-08 09:13:08 -07:00

9704 lines
323 KiB
JSON
Raw Blame History

{
"generated": "2026-04-17T17:08:35.132Z",
"statistics": {
"totalDatabases": 80,
"withDocumentation": 80,
"withConnectionString": 80,
"withDrivers": 28,
"withAuthMethods": 5,
"supportsJoins": 74,
"supportsSubqueries": 77,
"supportsDynamicSchema": 29,
"supportsCatalog": 20,
"averageScore": 54,
"maxScore": 201,
"byCategory": {
"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": [
"Amazon Athena",
"Amazon DynamoDB",
"Amazon Redshift",
"Arc",
"Azure Data Explorer",
"Azure Synapse",
"Databend",
"Denodo",
"Dremio",
"Exasol",
"Firebolt",
"Google BigQuery",
"Google Datastore",
"Hologres",
"IBM Db2",
"IBM Db2 for i",
"IBM Netezza Performance Server",
"Microsoft SQL Server",
"MongoDB",
"Ocient",
"Oracle",
"SAP HANA",
"SAP Sybase",
"SingleStore",
"Snowflake",
"Teradata",
"Vertica"
],
"Search & NoSQL": [
"Amazon DynamoDB",
"Apache Solr",
"Couchbase",
"Elasticsearch",
"Google Datastore",
"MongoDB",
"Parseable"
],
"Analytical Databases": [
"Amazon Redshift",
"Apache Doris",
"Apache Kylin",
"Apache Phoenix",
"Ascend",
"Azure Data Explorer",
"Azure Synapse",
"ClickHouse",
"Databend",
"Databricks",
"DuckDB",
"Exasol",
"Firebolt",
"Google BigQuery",
"Hologres",
"MotherDuck",
"Ocient",
"RisingWave",
"SingleStore",
"Snowflake",
"StarRocks",
"TimescaleDB",
"Vertica"
],
"Apache Projects": [
"Apache Doris",
"Apache Drill",
"Apache Druid",
"Apache Hive",
"Apache Impala",
"Apache IoTDB",
"Apache Kylin",
"Apache Phoenix",
"Apache Pinot",
"Apache Solr",
"Apache Spark SQL",
"Databricks Interactive Cluster"
],
"Open Source": [
"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",
"DuckDB",
"Elasticsearch",
"Firebird",
"Greenplum",
"MariaDB",
"MonetDB",
"MySQL",
"OceanBase",
"Parseable",
"PostgreSQL",
"Presto",
"RisingWave",
"SQLite",
"Shillelagh",
"StarRocks",
"TDengine",
"TimescaleDB",
"Trino",
"YDB",
"YugabyteDB"
],
"Time Series Databases": [
"Apache Druid",
"Apache IoTDB",
"Apache Pinot",
"CrateDB",
"TDengine"
],
"Other Databases": [
"Arc",
"Azure Data Explorer (KQL)",
"ClickHouse (sqlalchemy)",
"Databend (legacy)",
"Databricks (legacy)",
"Databricks SQL Endpoint",
"OpenSearch (OpenDistro)",
"Shillelagh",
"Superset meta database",
"base"
],
"Cloud Data Warehouses": [
"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": {
"Amazon Athena": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": false,
"TEN_MINUTES": false,
"FIFTEEN_MINUTES": false,
"THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": true,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": true,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
"module": "superset.db_engine_specs.athena",
"limit_method": 1,
"limit_clause": true,
"joins": true,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": false,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": false,
"cte_in_subquery": true,
"max_column_name": null,
"sql_comments": true,
"escaped_colons": false,
"masked_encrypted_extra": false,
"column_type_mapping": false,
"function_names": false,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": false,
"dbapi_exception_mapping": false,
"custom_errors": false,
"dynamic_schema": true,
"catalog": false,
"dynamic_catalog": false,
"ssh_tunneling": false,
"query_cancelation": false,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
"score": 30,
"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"
],
"pypi_packages": [
"pyathena[pandas]"
],
"connection_string": "awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}",
"drivers": [
{
"name": "PyAthena (REST)",
"pypi_package": "pyathena[pandas]",
"connection_string": "awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}",
"is_recommended": true,
"notes": "No Java required. URL-encode special characters (e.g., s3:// -> s3%3A//)."
},
{
"name": "PyAthenaJDBC",
"pypi_package": "PyAthenaJDBC",
"connection_string": "awsathena+jdbc://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}",
"is_recommended": false,
"notes": "Requires Amazon Athena JDBC driver."
}
],
"engine_parameters": [
{
"name": "IAM Role Assumption",
"description": "Assume a specific IAM role for queries",
"json": {
"connect_args": {
"role_arn": "<role arn>"
}
}
}
],
"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",
"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": "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,
"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": 32,
"max_score": 201,
"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",
"category": "Cloud - AWS"
},
"engine": "dynamodb",
"engine_name": "Amazon DynamoDB",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Amazon Redshift": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
"THIRTY_SECONDS": true,
"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.redshift",
"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": 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,
"score": 44,
"max_score": 201,
"documentation": {
"description": "Amazon Redshift is a fully managed data warehouse service.",
"logo": "redshift.png",
"homepage_url": "https://aws.amazon.com/redshift/",
"categories": [
"Cloud - AWS",
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"sqlalchemy-redshift"
],
"connection_string": "redshift+psycopg2://{username}:{password}@{host}:5439/{database}",
"default_port": 5439,
"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 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}&region_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}&region_name={region_name}",
"parameters": {
"aws_access_id": "AWS Access Key ID",
"aws_secret_access_key": "AWS Secret Access Key",
"database_name": "Database name",
"aurora_cluster_arn": "Aurora cluster ARN",
"secret_arn": "Secrets Manager ARN for credentials",
"region_name": "AWS region (e.g., us-east-1)"
},
"notes": "Uses the Data API for serverless access. Standard MySQL connections also work with mysqlclient.",
"categories": [
"Cloud - AWS",
"Hosted Open Source"
]
}
],
"category": "Traditional RDBMS"
},
"engine": "mysql",
"engine_name": "Aurora MySQL (Data API)",
"engine_aliases": [],
"default_driver": "auroradataapi",
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Aurora PostgreSQL": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
"THIRTY_SECONDS": true,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
"module": "superset.db_engine_specs.aurora",
"limit_method": 1,
"limit_clause": true,
"joins": true,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": false,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": false,
"cte_in_subquery": true,
"max_column_name": 63,
"sql_comments": true,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": true,
"function_names": false,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": false,
"dbapi_exception_mapping": false,
"custom_errors": false,
"dynamic_schema": true,
"catalog": true,
"dynamic_catalog": true,
"ssh_tunneling": true,
"query_cancelation": true,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": true,
"sql_validation": true,
"score": 104,
"max_score": 201,
"documentation": {
"description": "PostgreSQL is an advanced open-source relational database.",
"logo": "postgresql.svg",
"homepage_url": "https://www.postgresql.org/",
"categories": [
"Traditional RDBMS",
"Open Source"
],
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"default_port": 5432,
"parameters": {
"username": "Database username",
"password": "Database password",
"host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL",
"port": "Default 5432",
"database": "Database name"
},
"notes": "The psycopg2 library comes bundled with Superset Docker images.",
"connection_examples": [
{
"description": "Basic connection",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
},
{
"description": "With SSL required",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
"docs_url": "https://www.postgresql.org/docs/",
"sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
"compatible_databases": [
{
"name": "Hologres",
"description": "Alibaba Cloud real-time interactive analytics service, fully compatible with PostgreSQL 11.",
"logo": "hologres.png",
"homepage_url": "https://www.alibabacloud.com/product/hologres",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "AccessKey ID of your Alibaba Cloud account",
"password": "AccessKey secret of your Alibaba Cloud account",
"host": "Public endpoint of the Hologres instance",
"port": "Port number of the Hologres instance",
"database": "Name of the Hologres database"
},
"categories": [
"Proprietary"
]
},
{
"name": "TimescaleDB",
"description": "Open-source relational database for time-series and analytics, built on PostgreSQL.",
"logo": "timescale.png",
"homepage_url": "https://www.timescale.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
"description": "Timescale Cloud (SSL required)",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://docs.timescale.com/",
"categories": [
"Open Source"
]
},
{
"name": "YugabyteDB",
"description": "Distributed SQL database built on top of PostgreSQL.",
"logo": "yugabyte.png",
"homepage_url": "https://www.yugabyte.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://www.yugabyte.com/",
"categories": [
"Open Source"
]
},
{
"name": "Supabase",
"description": "Open-source Firebase alternative built on top of PostgreSQL, providing a full backend-as-a-service with a hosted Postgres database.",
"logo": "supabase.svg",
"homepage_url": "https://supabase.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
"description": "Supabase project (connection pooler)",
"connection_string": "postgresql://{username}.{project_ref}:{password}@aws-0-{region}.pooler.supabase.com:6543/{database}"
}
],
"parameters": {
"username": "Database user (default: postgres)",
"password": "Database password",
"host": "Supabase project host (from project settings)",
"port": "Default 5432 (direct) or 6543 (pooler)",
"database": "Database name (default: postgres)",
"project_ref": "Supabase project reference (from project settings)",
"region": "Supabase project region (e.g., us-east-1)"
},
"notes": "Find connection details in your Supabase project dashboard under Settings > Database. Use the connection pooler (port 6543) for better connection management.",
"docs_url": "https://supabase.com/docs/guides/database/connecting-to-postgres",
"categories": [
"Hosted Open Source"
]
},
{
"name": "Google AlloyDB",
"description": "Google Cloud's PostgreSQL-compatible database service for demanding transactional and analytical workloads.",
"logo": "alloydb.png",
"homepage_url": "https://cloud.google.com/alloydb",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "Database user (default: postgres)",
"password": "Database password",
"host": "AlloyDB instance IP or Auth Proxy address",
"port": "Default 5432",
"database": "Database name"
},
"notes": "For public IP connections, use the AlloyDB Auth Proxy for secure access. Private IP connections can connect directly.",
"docs_url": "https://cloud.google.com/alloydb/docs",
"categories": [
"Cloud - Google",
"Hosted Open Source"
]
},
{
"name": "Neon",
"description": "Serverless PostgreSQL with branching, scale-to-zero, and bottomless storage.",
"logo": "neon.png",
"homepage_url": "https://neon.tech/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}/{database}?sslmode=require",
"parameters": {
"username": "Neon role name",
"password": "Neon role password",
"host": "Neon hostname (e.g., ep-cool-name-123456.us-east-2.aws.neon.tech)",
"database": "Database name (default: neondb)"
},
"notes": "SSL is required for all connections. Find connection details in the Neon console under Connection Details.",
"docs_url": "https://neon.tech/docs/connect/connect-from-any-app",
"categories": [
"Hosted Open Source"
]
},
{
"name": "Amazon Aurora PostgreSQL",
"description": "Amazon Aurora PostgreSQL is a fully managed, PostgreSQL-compatible relational database with up to 5x the throughput of standard PostgreSQL.",
"logo": "aws-aurora.jpg",
"homepage_url": "https://aws.amazon.com/rds/aurora/",
"pypi_packages": [
"sqlalchemy-aurora-data-api"
],
"connection_string": "postgresql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}&region_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",
"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": [
{
"description": "Basic connection",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
},
{
"description": "With SSL required",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
"docs_url": "https://www.postgresql.org/docs/",
"sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
"compatible_databases": [
{
"name": "Hologres",
"description": "Alibaba Cloud real-time interactive analytics service, fully compatible with PostgreSQL 11.",
"logo": "hologres.png",
"homepage_url": "https://www.alibabacloud.com/product/hologres",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "AccessKey ID of your Alibaba Cloud account",
"password": "AccessKey secret of your Alibaba Cloud account",
"host": "Public endpoint of the Hologres instance",
"port": "Port number of the Hologres instance",
"database": "Name of the Hologres database"
},
"categories": [
"Proprietary"
]
},
{
"name": "TimescaleDB",
"description": "Open-source relational database for time-series and analytics, built on PostgreSQL.",
"logo": "timescale.png",
"homepage_url": "https://www.timescale.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
"description": "Timescale Cloud (SSL required)",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://docs.timescale.com/",
"categories": [
"Open Source"
]
},
{
"name": "YugabyteDB",
"description": "Distributed SQL database built on top of PostgreSQL.",
"logo": "yugabyte.png",
"homepage_url": "https://www.yugabyte.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://www.yugabyte.com/",
"categories": [
"Open Source"
]
},
{
"name": "Supabase",
"description": "Open-source Firebase alternative built on top of PostgreSQL, providing a full backend-as-a-service with a hosted Postgres database.",
"logo": "supabase.svg",
"homepage_url": "https://supabase.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
"description": "Supabase project (connection pooler)",
"connection_string": "postgresql://{username}.{project_ref}:{password}@aws-0-{region}.pooler.supabase.com:6543/{database}"
}
],
"parameters": {
"username": "Database user (default: postgres)",
"password": "Database password",
"host": "Supabase project host (from project settings)",
"port": "Default 5432 (direct) or 6543 (pooler)",
"database": "Database name (default: postgres)",
"project_ref": "Supabase project reference (from project settings)",
"region": "Supabase project region (e.g., us-east-1)"
},
"notes": "Find connection details in your Supabase project dashboard under Settings > Database. Use the connection pooler (port 6543) for better connection management.",
"docs_url": "https://supabase.com/docs/guides/database/connecting-to-postgres",
"categories": [
"Hosted Open Source"
]
},
{
"name": "Google AlloyDB",
"description": "Google Cloud's PostgreSQL-compatible database service for demanding transactional and analytical workloads.",
"logo": "alloydb.png",
"homepage_url": "https://cloud.google.com/alloydb",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "Database user (default: postgres)",
"password": "Database password",
"host": "AlloyDB instance IP or Auth Proxy address",
"port": "Default 5432",
"database": "Database name"
},
"notes": "For public IP connections, use the AlloyDB Auth Proxy for secure access. Private IP connections can connect directly.",
"docs_url": "https://cloud.google.com/alloydb/docs",
"categories": [
"Cloud - Google",
"Hosted Open Source"
]
},
{
"name": "Neon",
"description": "Serverless PostgreSQL with branching, scale-to-zero, and bottomless storage.",
"logo": "neon.png",
"homepage_url": "https://neon.tech/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}/{database}?sslmode=require",
"parameters": {
"username": "Neon role name",
"password": "Neon role password",
"host": "Neon hostname (e.g., ep-cool-name-123456.us-east-2.aws.neon.tech)",
"database": "Database name (default: neondb)"
},
"notes": "SSL is required for all connections. Find connection details in the Neon console under Connection Details.",
"docs_url": "https://neon.tech/docs/connect/connect-from-any-app",
"categories": [
"Hosted Open Source"
]
},
{
"name": "Amazon Aurora PostgreSQL",
"description": "Amazon Aurora PostgreSQL is a fully managed, PostgreSQL-compatible relational database with up to 5x the throughput of standard PostgreSQL.",
"logo": "aws-aurora.jpg",
"homepage_url": "https://aws.amazon.com/rds/aurora/",
"pypi_packages": [
"sqlalchemy-aurora-data-api"
],
"connection_string": "postgresql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}&region_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
},
"module": "superset.db_engine_specs.kusto",
"limit_method": 2,
"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": 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,
"score": 54,
"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/",
"categories": [
"Cloud - Azure",
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"sqlalchemy-kusto"
],
"connection_string": "kustosql+https://{cluster}.kusto.windows.net/{database}?msi=False&azure_ad_client_id={client_id}&azure_ad_client_secret={client_secret}&azure_ad_tenant_id={tenant_id}",
"parameters": {
"cluster": "Azure Data Explorer cluster name",
"database": "Database name",
"client_id": "Azure AD application (client) ID",
"client_secret": "Azure AD application secret",
"tenant_id": "Azure AD tenant ID"
},
"drivers": [
{
"name": "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."
}
],
"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
},
"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
},
"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,
"score": 44,
"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/",
"categories": [
"Cloud Data Warehouses",
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"pymssql"
],
"connection_string": "mssql+pymssql://{username}@{server}:{password}@{server}.database.windows.net:1433/{database}",
"category": "Cloud - Azure",
"custom_errors": [
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
"message_template": "Either the username \"%(username)s\", password, or database name \"%(database)s\" is incorrect.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
"issue_codes": [
1014,
1015
]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
"message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
"issue_codes": [
1007
]
},
{
"regex_name": "CONNECTION_PORT_CLOSED_REGEX",
"message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
"issue_codes": [
1008
]
},
{
"regex_name": "CONNECTION_HOST_DOWN_REGEX",
"message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
"error_type": "CONNECTION_HOST_DOWN_ERROR",
"category": "Connection",
"description": "Host unreachable",
"issue_codes": [
1009
]
}
]
},
"engine": "mssql",
"engine_name": "Azure Synapse",
"engine_aliases": [],
"default_driver": "pyodbc",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"ClickHouse": {
"time_grains": {
"SECOND": false,
"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"
],
"pypi_packages": [
"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.13.0",
"connection_string": "clickhousedb://{username}:{password}@{host}:{port}/{database}",
"is_recommended": true,
"notes": "Official ClickHouse Python driver with native protocol support."
},
{
"name": "clickhouse-sqlalchemy (Legacy)",
"pypi_package": "clickhouse-sqlalchemy",
"connection_string": "clickhouse://{username}:{password}@{host}:{port}/{database}",
"is_recommended": false,
"notes": "Older driver using HTTP interface. Use clickhouse-connect for new deployments."
}
],
"connection_examples": [
{
"description": "Altinity Cloud",
"connection_string": "clickhousedb://demo:demo@github.demo.trial.altinity.cloud/default?secure=true"
},
{
"description": "Local (no auth, no SSL)",
"connection_string": "clickhousedb://localhost/default"
}
],
"install_instructions": "echo \"clickhouse-connect>=0.13.0\" >> ./docker/requirements-local.txt",
"compatible_databases": [
{
"name": "ClickHouse Cloud",
"description": "ClickHouse Cloud is the official fully-managed cloud service for ClickHouse. It provides automatic scaling, built-in backups, and enterprise security features.",
"logo": "clickhouse.png",
"homepage_url": "https://clickhouse.cloud/",
"categories": [
"Analytical Databases",
"Cloud Data Warehouses",
"Hosted Open Source"
],
"pypi_packages": [
"clickhouse-connect>=0.13.0"
],
"connection_string": "clickhousedb://{username}:{password}@{host}:8443/{database}?secure=true",
"parameters": {
"username": "ClickHouse Cloud username",
"password": "ClickHouse Cloud password",
"host": "Your ClickHouse Cloud hostname",
"database": "Database name (default)"
},
"docs_url": "https://clickhouse.com/docs/en/cloud"
},
{
"name": "Altinity.Cloud",
"description": "Altinity.Cloud is a managed ClickHouse service providing Kubernetes-native deployments with enterprise support.",
"logo": "altinity.png",
"homepage_url": "https://altinity.cloud/",
"categories": [
"Analytical Databases",
"Cloud Data Warehouses",
"Hosted Open Source"
],
"pypi_packages": [
"clickhouse-connect>=0.13.0"
],
"connection_string": "clickhousedb://{username}:{password}@{host}/{database}?secure=true",
"docs_url": "https://docs.altinity.com/"
}
],
"category": "Analytical Databases"
},
"engine": "clickhousedb",
"engine_name": "ClickHouse",
"engine_aliases": [],
"default_driver": "connect",
"supports_file_upload": false,
"supports_dynamic_schema": true,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"ClickHouse (sqlalchemy)": {
"time_grains": {
"SECOND": false,
"FIVE_SECONDS": false,
"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": 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,
"score": 41,
"max_score": 201,
"documentation": {
"description": "Cloudflare D1 is a serverless SQLite database.",
"logo": "cloudflare.png",
"homepage_url": "https://developers.cloudflare.com/d1/",
"categories": [
"Cloud Data Warehouses",
"Traditional RDBMS",
"Hosted Open Source"
],
"pypi_packages": [
"superset-engine-d1"
],
"connection_string": "d1://{cloudflare_account_id}:{cloudflare_api_token}@{cloudflare_d1_database_id}",
"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",
"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,
"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.cockroachdb",
"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": "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": {
"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"
],
"pypi_packages": [
"couchbase-sqlalchemy"
],
"connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true",
"default_port": 8091,
"parameters": {
"username": "Couchbase username",
"password": "Couchbase password",
"host": "Couchbase host or connection string for cloud",
"port": "Couchbase port (default 8091)",
"database": "Couchbase database/bucket name"
},
"drivers": [
{
"name": "couchbase-sqlalchemy",
"pypi_package": "couchbase-sqlalchemy",
"connection_string": "couchbase://{username}:{password}@{host}:{port}?ssl=true",
"is_recommended": true
}
],
"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,
"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.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,
"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://cratedb.com",
"categories": [
"Time Series Databases",
"Open Source"
],
"pypi_packages": [
"crate",
"sqlalchemy-cratedb"
],
"connection_string": "crate://{host}:{port}",
"default_port": 4200,
"parameters": {
"host": "CrateDB host",
"port": "CrateDB HTTP port (default 4200)"
},
"drivers": [
{
"name": "crate",
"pypi_package": "crate[sqlalchemy]",
"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": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
"module": "superset.db_engine_specs.databend",
"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": 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": {
"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"
],
"pypi_packages": [
"databend-sqlalchemy"
],
"connection_string": "databend://{username}:{password}@{host}:{port}/{database}?secure=true",
"default_port": 443,
"parameters": {
"username": "Database username",
"password": "Database password",
"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,
"THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": false,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": false,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
"module": "superset.db_engine_specs.databend",
"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": 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": "Other Databases"
},
"engine": "databend",
"engine_name": "Databend (legacy)",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": false,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Databricks": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"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"
],
"pypi_packages": [
"apache-superset[databricks]"
],
"install_instructions": "pip install apache-superset[databricks]",
"connection_string": "databricks://token:{access_token}@{host}:{port}?http_path={http_path}&catalog={catalog}&schema={schema}",
"parameters": {
"access_token": "Personal access token from Settings > User Settings",
"host": "Server hostname from cluster JDBC/ODBC settings",
"port": "Port (default 443)",
"http_path": "HTTP path from cluster JDBC/ODBC settings"
},
"drivers": [
{
"name": "Databricks Python Connector (Recommended)",
"pypi_package": "databricks-sql-connector",
"connection_string": "databricks://token:{access_token}@{host}:{port}?http_path={http_path}&catalog={catalog}&schema={schema}",
"is_recommended": true,
"notes": "Official Databricks connector. Best for SQL warehouses and clusters."
},
{
"name": "Hive Connector (Interactive Clusters)",
"pypi_package": "databricks-dbapi[sqlalchemy]",
"connection_string": "databricks+pyhive://token:{access_token}@{host}:{port}/{database}",
"is_recommended": false,
"notes": "For Interactive Clusters. Requires http_path in engine parameters."
},
{
"name": "ODBC (SQL Endpoints)",
"pypi_package": "pyodbc",
"connection_string": "databricks+pyodbc://token:{access_token}@{host}:{port}/{database}",
"is_recommended": false,
"notes": "Requires ODBC driver. For serverless SQL warehouses."
},
{
"name": "databricks-dbapi (Legacy)",
"pypi_package": "databricks-dbapi[sqlalchemy]",
"connection_string": "databricks+connector://token:{access_token}@{host}:{port}/{database}",
"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
},
"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": 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": 30,
"max_score": 201,
"documentation": {
"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": 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.denodo",
"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": 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"
],
"pypi_packages": [
"psycopg2"
],
"connection_string": "denodo://{username}:{password}@{host}:{port}/{database}",
"default_port": 9996,
"parameters": {
"username": "Denodo username",
"password": "Denodo password",
"host": "Denodo VDP server hostname",
"port": "ODBC port (default 9996)",
"database": "Virtual database name"
},
"drivers": [
{
"name": "psycopg2",
"pypi_package": "psycopg2",
"connection_string": "denodo://{username}:{password}@{host}:{port}/{database}",
"is_recommended": true,
"notes": "Uses PostgreSQL wire protocol."
}
],
"category": "Other Databases",
"custom_errors": [
{
"message_template": "Incorrect username or password.",
"error_type": "CONNECTION_INVALID_USERNAME_ERROR",
"category": "Authentication",
"description": "Invalid username",
"issue_codes": [
1012
],
"invalid_fields": [
"username",
"password"
]
},
{
"message_template": "Please enter a password.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
"issue_codes": [
1014,
1015
],
"invalid_fields": [
"password"
]
},
{
"message_template": "Hostname \"%(hostname)s\" cannot be resolved.",
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
"issue_codes": [
1007
],
"invalid_fields": [
"host"
]
},
{
"message_template": "Server refused the connection: check hostname and port.",
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
"issue_codes": [
1008
],
"invalid_fields": [
"host",
"port"
]
},
{
"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"
]
},
{
"message_template": "Unable to connect to database \"%(database)s\": database does not exist or insufficient permissions",
"error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
"category": "Permissions",
"description": "Insufficient permissions",
"issue_codes": [
1017
],
"invalid_fields": [
"database"
]
},
{
"message_template": "Please check your query for syntax errors at or near \"%(err)s\". Then, try running your query again.",
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
"issue_codes": [
1030
]
},
{
"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": [
{
"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
]
}
]
},
"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": 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": false,
"YEAR": true
},
"module": "superset.db_engine_specs.elasticsearch",
"limit_method": 1,
"limit_clause": true,
"joins": false,
"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": 37,
"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/",
"categories": [
"Search & NoSQL",
"Open Source"
],
"pypi_packages": [
"elasticsearch-dbapi"
],
"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."
},
{
"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."
}
],
"compatible_databases": [
{
"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/"
},
{
"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/"
}
],
"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,
"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.exasol",
"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": 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,
"score": 28,
"max_score": 201,
"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": [
{
"name": "pyodbc",
"pypi_package": "sqlalchemy-exasol",
"connection_string": "exa+pyodbc://{username}:{password}@{dsn}",
"is_recommended": true,
"notes": "Requires ODBC driver and DSN configuration."
},
{
"name": "turbodbc",
"pypi_package": "sqlalchemy-exasol[turbodbc]",
"connection_string": "exa+turbodbc://{username}:{password}@{dsn}",
"is_recommended": false,
"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,
"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
},
"module": "superset.db_engine_specs.firebird",
"limit_method": 3,
"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": 26,
"max_score": 201,
"documentation": {
"description": "Firebird is an open-source relational database.",
"logo": "firebird.png",
"homepage_url": "https://firebirdsql.org/",
"categories": [
"Traditional RDBMS",
"Open Source"
],
"pypi_packages": [
"sqlalchemy-firebird"
],
"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 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,
"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.firebolt",
"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": "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
}
],
"category": "Other Databases"
},
"engine": "firebolt",
"engine_name": "Firebolt",
"engine_aliases": [],
"default_driver": "firebolt",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Google BigQuery": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": true,
"HALF_HOUR": false,
"HOUR": true,
"SIX_HOURS": false,
"DAY": true,
"WEEK": true,
"WEEK_STARTING_SUNDAY": false,
"WEEK_STARTING_MONDAY": true,
"WEEK_ENDING_SATURDAY": false,
"WEEK_ENDING_SUNDAY": false,
"MONTH": true,
"QUARTER": true,
"QUARTER_YEAR": false,
"YEAR": true
},
"module": "superset.db_engine_specs.bigquery",
"limit_method": 1,
"limit_clause": true,
"joins": true,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": false,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": true,
"cte_in_subquery": true,
"max_column_name": 128,
"sql_comments": true,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": false,
"function_names": false,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": true,
"dbapi_exception_mapping": true,
"custom_errors": false,
"dynamic_schema": false,
"catalog": true,
"dynamic_catalog": true,
"ssh_tunneling": false,
"query_cancelation": false,
"get_metrics": false,
"where_latest_partition": true,
"expand_data": false,
"query_cost_estimation": true,
"sql_validation": false,
"score": 83,
"max_score": 201,
"documentation": {
"description": "Google BigQuery is a serverless, highly scalable data warehouse.",
"logo": "google-big-query.svg",
"homepage_url": "https://cloud.google.com/bigquery/",
"categories": [
"Cloud - Google",
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"sqlalchemy-bigquery"
],
"connection_string": "bigquery://{project_id}",
"install_instructions": "echo \"sqlalchemy-bigquery\" >> ./docker/requirements-local.txt",
"authentication_methods": [
{
"name": "Service Account JSON",
"description": "Upload service account credentials JSON or paste in Secure Extra",
"secure_extra": {
"credentials_info": {
"type": "service_account",
"project_id": "...",
"private_key_id": "...",
"private_key": "...",
"client_email": "...",
"client_id": "...",
"auth_uri": "...",
"token_uri": "..."
}
}
}
],
"notes": "Create a Service Account via GCP console with access to BigQuery datasets. For CSV/Excel uploads, also install pandas_gbq.",
"warnings": [
"Google BigQuery Python SDK is not compatible with gevent. Use a worker type other than gevent when deploying with gunicorn."
],
"docs_url": "https://github.com/googleapis/python-bigquery-sqlalchemy",
"category": "Cloud - Google",
"custom_errors": [
{
"regex_name": "CONNECTION_DATABASE_PERMISSIONS_REGEX",
"message_template": "Unable to connect. Verify that the following roles are set on the service account: \"BigQuery Data Viewer\", \"BigQuery Metadata Viewer\", \"BigQuery Job User\" and the following permissions are set \"bigquery.readsessions.create\", \"bigquery.readsessions.getData\"",
"error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
"category": "Permissions",
"description": "Insufficient permissions",
"issue_codes": [
1017
]
},
{
"regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
"message_template": "The table \"%(table)s\" does not exist. A valid table must be used to run this query.",
"error_type": "TABLE_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Table not found",
"issue_codes": [
1003,
1005
]
},
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
"message_template": "We can't seem to resolve column \"%(column)s\" at line %(location)s.",
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
"issue_codes": [
1003,
1004
]
},
{
"regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
"message_template": "The schema \"%(schema)s\" does not exist. A valid schema must be used to run this query.",
"error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Schema not found",
"issue_codes": [
1003,
1016
]
},
{
"regex_name": "SYNTAX_ERROR_REGEX",
"message_template": "Please check your query for syntax errors at or near \"%(syntax_error)s\". Then, try running your query again.",
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
"issue_codes": [
1030
]
}
]
},
"engine": "bigquery",
"engine_name": "Google BigQuery",
"engine_aliases": [],
"default_driver": "bigquery",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": true,
"supports_dynamic_catalog": true
},
"Google Datastore": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": true,
"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.datastore",
"limit_method": 3,
"limit_clause": true,
"joins": true,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": false,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": true,
"cte_in_subquery": true,
"max_column_name": 128,
"sql_comments": true,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": false,
"function_names": true,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": false,
"dbapi_exception_mapping": true,
"custom_errors": false,
"dynamic_schema": true,
"catalog": true,
"dynamic_catalog": true,
"ssh_tunneling": false,
"query_cancelation": false,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
"score": 73,
"max_score": 201,
"documentation": {
"description": "Google Cloud Datastore is a highly scalable NoSQL database for your applications.",
"logo": "datastore.png",
"homepage_url": "https://cloud.google.com/datastore/",
"categories": [
"Cloud - Google",
"Search & NoSQL",
"Proprietary"
],
"pypi_packages": [
"python-datastore-sqlalchemy"
],
"connection_string": "datastore://{project_id}/?database={database_id}",
"authentication_methods": [
{
"name": "Service Account JSON",
"description": "Upload service account credentials JSON or paste in Secure Extra",
"secure_extra": {
"credentials_info": {
"type": "service_account",
"project_id": "...",
"private_key_id": "...",
"private_key": "...",
"client_email": "...",
"client_id": "...",
"auth_uri": "...",
"token_uri": "..."
}
}
}
],
"notes": "Create a Service Account via GCP console with access to datastore datasets.",
"docs_url": "https://github.com/splasky/Python-datastore-sqlalchemy",
"category": "Cloud - Google",
"custom_errors": [
{
"regex_name": "CONNECTION_DATABASE_PERMISSIONS_REGEX",
"message_template": "Unable to connect. Verify that the following roles are set on the service account: \"Cloud Datastore Viewer\", \"Cloud Datastore User\", \"Cloud Datastore Creator\"",
"error_type": "CONNECTION_DATABASE_PERMISSIONS_ERROR",
"category": "Permissions",
"description": "Insufficient permissions",
"issue_codes": [
1017
]
},
{
"regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
"message_template": "The table \"%(table)s\" does not exist. A valid table must be used to run this query.",
"error_type": "TABLE_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Table not found",
"issue_codes": [
1003,
1005
]
},
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
"message_template": "We can't seem to resolve column \"%(column)s\" at line %(location)s.",
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
"issue_codes": [
1003,
1004
]
},
{
"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": "datastore",
"engine_name": "Google Datastore",
"engine_aliases": [],
"default_driver": "datastore",
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": true,
"supports_dynamic_catalog": true
},
"Google Sheets": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
"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.gsheets",
"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": true,
"file_upload": true,
"get_extra_table_metadata": true,
"dbapi_exception_mapping": false,
"custom_errors": false,
"dynamic_schema": false,
"catalog": false,
"dynamic_catalog": false,
"ssh_tunneling": false,
"query_cancelation": false,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
"score": 61,
"max_score": 201,
"documentation": {
"description": "Google Sheets allows querying spreadsheets as SQL tables via shillelagh.",
"logo": "google-sheets.svg",
"homepage_url": "https://www.google.com/sheets/about/",
"categories": [
"Cloud - Google",
"Hosted Open Source"
],
"pypi_packages": [
"shillelagh[gsheetsapi]"
],
"install_instructions": "pip install \"apache-superset[gsheets]\"",
"connection_string": "gsheets://",
"notes": "Requires Google service account credentials or OAuth2 authentication. See docs for setup instructions.",
"category": "Cloud - Google",
"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
]
}
]
},
"engine": "gsheets",
"engine_name": "Google Sheets",
"engine_aliases": [],
"default_driver": "apsw",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Greenplum": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
"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.greenplum",
"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": "VMware Greenplum is a massively parallel processing (MPP) database built on PostgreSQL.",
"logo": "greenplum.png",
"homepage_url": "https://greenplum.org/",
"categories": [
"Traditional RDBMS",
"Open Source"
],
"pypi_packages": [
"sqlalchemy-greenplum",
"psycopg2"
],
"connection_string": "greenplum://{username}:{password}@{host}:{port}/{database}",
"default_port": 5432,
"parameters": {
"username": "Database username",
"password": "Database password",
"host": "Greenplum coordinator host",
"port": "Default 5432",
"database": "Database name"
},
"docs_url": "https://docs.vmware.com/en/VMware-Greenplum/",
"category": "Other Databases"
},
"engine": "greenplum",
"engine_name": "Greenplum",
"engine_aliases": [
"postgres"
],
"default_driver": "psycopg2",
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": true,
"supports_dynamic_catalog": true
},
"Hologres": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
"THIRTY_SECONDS": true,
"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.hologres",
"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": 34,
"max_score": 201,
"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.",
"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,
"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.db2",
"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": 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": 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"
],
"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",
"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,
"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.ibmi",
"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": 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": 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": "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",
"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
},
"module": "superset.db_engine_specs.netezza",
"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": "IBM Netezza Performance Server is a data warehouse appliance.",
"logo": "netezza.png",
"homepage_url": "https://www.ibm.com/products/netezza",
"categories": [
"Traditional RDBMS",
"Proprietary"
],
"pypi_packages": [
"nzalchemy"
],
"connection_string": "netezza+nzpy://{username}:{password}@{hostname}:{port}/{database}",
"default_port": 5480,
"category": "Other Databases"
},
"engine": "netezza",
"engine_name": "IBM Netezza Performance Server",
"engine_aliases": [],
"default_driver": "nzpy",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"MariaDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"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.mariadb",
"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": "MariaDB is a community-developed fork of MySQL.",
"logo": "mariadb.png",
"homepage_url": "https://mariadb.org/",
"categories": [
"Traditional RDBMS",
"Open Source"
],
"pypi_packages": [
"mysqlclient"
],
"connection_string": "mysql://{username}:{password}@{host}/{database}",
"default_port": 3306,
"notes": "Uses the MySQL driver. Fully compatible with MySQL connector.",
"category": "Traditional RDBMS"
},
"engine": "mariadb",
"engine_name": "MariaDB",
"engine_aliases": [],
"default_driver": "mysqldb",
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Microsoft SQL Server": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": true,
"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,
"score": 44,
"max_score": 201,
"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",
"category": "Cloud - Azure",
"custom_errors": [
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
"message_template": "Either the username \"%(username)s\", password, or database name \"%(database)s\" is incorrect.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
"issue_codes": [
1014,
1015
]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
"message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
"issue_codes": [
1007
]
},
{
"regex_name": "CONNECTION_PORT_CLOSED_REGEX",
"message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
"issue_codes": [
1008
]
},
{
"regex_name": "CONNECTION_HOST_DOWN_REGEX",
"message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
"error_type": "CONNECTION_HOST_DOWN_ERROR",
"category": "Connection",
"description": "Host unreachable",
"issue_codes": [
1009
]
}
]
},
"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,
"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
},
"module": "superset.db_engine_specs.monetdb",
"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": 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"
],
"pypi_packages": [
"sqlalchemy-monetdb",
"pymonetdb"
],
"connection_string": "monetdb://{username}:{password}@{host}:{port}/{database}",
"default_port": 50000,
"parameters": {
"username": "Database username (default: monetdb)",
"password": "Database password (default: monetdb)",
"host": "MonetDB server host",
"port": "Default 50000",
"database": "Database name"
},
"docs_url": "https://www.monetdb.org/documentation/",
"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
},
"module": "superset.db_engine_specs.mongodb",
"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": 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"
],
"pypi_packages": [
"pymongosql"
],
"connection_string": "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset",
"parameters": {
"username": "Username for MongoDB",
"password": "Password for MongoDB",
"host": "MongoDB host",
"port": "MongoDB port",
"database": "Database name"
},
"drivers": [
{
"name": "MongoDB Atlas Cloud",
"pypi_package": "pymongosql",
"connection_string": "mongodb+srv://{username}:{password}@{host}/{database}?mode=superset",
"notes": "For MongoDB Atlas cloud service.",
"is_recommended": true
},
{
"name": "MongoDB Cluster",
"pypi_package": "pymongosql",
"connection_string": "mongodb://{username}:{password}@{host}:{port}/{database}?mode=superset",
"is_recommended": false,
"notes": "For self-hosted MongoDB instances."
}
],
"notes": "Uses PartiQL for SQL queries. Requires mode=superset parameter.",
"docs_url": "https://github.com/passren/PyMongoSQL",
"category": "Other Databases"
},
"engine": "mongodb",
"engine_name": "MongoDB",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"MotherDuck": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"THIRTY_SECONDS": false,
"MINUTE": true,
"FIVE_MINUTES": false,
"TEN_MINUTES": false,
"FIFTEEN_MINUTES": false,
"THIRTY_MINUTES": false,
"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": 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": 58,
"max_score": 201,
"documentation": {
"description": "MotherDuck is a serverless cloud analytics platform built on DuckDB. It combines the simplicity of DuckDB with cloud-scale data sharing and collaboration.",
"logo": "motherduck.png",
"homepage_url": "https://motherduck.com/",
"categories": [
"Analytical Databases",
"Cloud Data Warehouses",
"Hosted Open Source"
],
"pypi_packages": [
"duckdb",
"duckdb-engine"
],
"connection_string": "duckdb:///md:{database}?motherduck_token={token}",
"parameters": {
"database": "MotherDuck database name",
"token": "Service token from MotherDuck dashboard"
},
"docs_url": "https://motherduck.com/docs/getting-started/",
"drivers": [
{
"name": "duckdb-engine",
"pypi_package": "duckdb-engine",
"connection_string": "duckdb:///md:{database}?motherduck_token={token}",
"is_recommended": true
}
],
"category": "Other Databases",
"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
]
}
]
},
"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,
"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}&region_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",
"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 MySQL 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": "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,
"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.oceanbase",
"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": 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,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": false,
"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": [
"oceanbase_py"
],
"connection_string": "oceanbase://{username}:{password}@{host}:{port}/{database}",
"category": "Other Databases",
"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 OceanBase 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": "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,
"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,
"score": 38,
"max_score": 201,
"documentation": {
"description": "Ocient is a hyperscale data analytics database.",
"categories": [
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"sqlalchemy-ocient"
],
"connection_string": "ocient://{username}:{password}@{host}:{port}/{database}",
"install_instructions": "pip install sqlalchemy-ocient",
"category": "Other Databases",
"custom_errors": [
{
"regex_name": "CONNECTION_INVALID_USERNAME_REGEX",
"message_template": "The username \"%(username)s\" does not exist.",
"error_type": "CONNECTION_INVALID_USERNAME_ERROR",
"category": "Authentication",
"description": "Invalid username",
"issue_codes": [
1012
]
},
{
"regex_name": "CONNECTION_INVALID_PASSWORD_REGEX",
"message_template": "The user/password combination is not valid (Incorrect password for user).",
"error_type": "CONNECTION_INVALID_PASSWORD_ERROR",
"category": "Authentication",
"description": "Invalid password",
"issue_codes": [
1013
]
},
{
"regex_name": "CONNECTION_UNKNOWN_DATABASE_REGEX",
"message_template": "Could not connect to database: \"%(database)s\"",
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
"issue_codes": [
1015
]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
"message_template": "Could not resolve hostname: \"%(host)s\".",
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
"issue_codes": [
1007
]
},
{
"regex_name": "CONNECTION_INVALID_PORT_ERROR",
"message_template": "Port out of range 0-65535",
"error_type": "CONNECTION_INVALID_PORT_ERROR"
},
{
"regex_name": "INVALID_CONNECTION_STRING_REGEX",
"message_template": "Invalid Connection String: Expecting String of the form 'ocient://user:pass@host:port/database'.",
"error_type": "GENERIC_DB_ENGINE_ERROR",
"category": "General",
"description": "Database engine error",
"issue_codes": [
1002
]
},
{
"regex_name": "SYNTAX_ERROR_REGEX",
"message_template": "Syntax Error: %(qualifier)s input \"%(input)s\" expecting \"%(expected)s",
"error_type": "SYNTAX_ERROR",
"category": "Query",
"description": "SQL syntax error",
"issue_codes": [
1030
]
},
{
"regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
"message_template": "Table or View \"%(table)s\" does not exist.",
"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": "Invalid reference to column: \"%(column)s\"",
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
"issue_codes": [
1003,
1004
]
}
]
},
"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,
"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
},
"module": "superset.db_engine_specs.elasticsearch",
"limit_method": 1,
"limit_clause": true,
"joins": false,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": true,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": false,
"cte_in_subquery": true,
"max_column_name": null,
"sql_comments": false,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": false,
"function_names": false,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": false,
"dbapi_exception_mapping": false,
"custom_errors": false,
"dynamic_schema": false,
"catalog": false,
"dynamic_catalog": false,
"ssh_tunneling": true,
"query_cancelation": false,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
"score": 26,
"max_score": 201,
"documentation": {
"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,
"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.oracle",
"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": 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,
"score": 28,
"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",
"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,
"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.parseable",
"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": "Parseable is a distributed log analytics database with SQL-like query interface.",
"categories": [
"Search & NoSQL",
"Open Source"
],
"pypi_packages": [
"sqlalchemy-parseable"
],
"connection_string": "parseable://{username}:{password}@{hostname}:{port}/{stream_name}",
"connection_examples": [
{
"description": "Example connection",
"connection_string": "parseable://admin:admin@demo.parseable.com:443/ingress-nginx"
}
],
"notes": "Stream name in URI represents the Parseable logstream to query. Supports HTTP (80) and HTTPS (443).",
"docs_url": "https://www.parseable.io",
"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": 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.postgres",
"limit_method": 1,
"limit_clause": true,
"joins": true,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": false,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": false,
"cte_in_subquery": true,
"max_column_name": 63,
"sql_comments": true,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": true,
"function_names": false,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": false,
"dbapi_exception_mapping": false,
"custom_errors": false,
"dynamic_schema": true,
"catalog": true,
"dynamic_catalog": true,
"ssh_tunneling": true,
"query_cancelation": true,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": true,
"sql_validation": true,
"score": 104,
"max_score": 201,
"documentation": {
"description": "PostgreSQL is an advanced open-source relational database.",
"logo": "postgresql.svg",
"homepage_url": "https://www.postgresql.org/",
"categories": [
"Traditional RDBMS",
"Open Source"
],
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"default_port": 5432,
"parameters": {
"username": "Database username",
"password": "Database password",
"host": "For localhost: localhost or 127.0.0.1. For AWS: endpoint URL",
"port": "Default 5432",
"database": "Database name"
},
"notes": "The psycopg2 library comes bundled with Superset Docker images.",
"connection_examples": [
{
"description": "Basic connection",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}"
},
{
"description": "With SSL required",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
"docs_url": "https://www.postgresql.org/docs/",
"sqlalchemy_docs_url": "https://docs.sqlalchemy.org/en/13/dialects/postgresql.html",
"compatible_databases": [
{
"name": "Hologres",
"description": "Alibaba Cloud real-time interactive analytics service, fully compatible with PostgreSQL 11.",
"logo": "hologres.png",
"homepage_url": "https://www.alibabacloud.com/product/hologres",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql+psycopg2://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "AccessKey ID of your Alibaba Cloud account",
"password": "AccessKey secret of your Alibaba Cloud account",
"host": "Public endpoint of the Hologres instance",
"port": "Port number of the Hologres instance",
"database": "Name of the Hologres database"
},
"categories": [
"Proprietary"
]
},
{
"name": "TimescaleDB",
"description": "Open-source relational database for time-series and analytics, built on PostgreSQL.",
"logo": "timescale.png",
"homepage_url": "https://www.timescale.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
"description": "Timescale Cloud (SSL required)",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://docs.timescale.com/",
"categories": [
"Open Source"
]
},
{
"name": "YugabyteDB",
"description": "Distributed SQL database built on top of PostgreSQL.",
"logo": "yugabyte.png",
"homepage_url": "https://www.yugabyte.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"notes": "psycopg2 comes bundled with Superset Docker images.",
"docs_url": "https://www.yugabyte.com/",
"categories": [
"Open Source"
]
},
{
"name": "Supabase",
"description": "Open-source Firebase alternative built on top of PostgreSQL, providing a full backend-as-a-service with a hosted Postgres database.",
"logo": "supabase.svg",
"homepage_url": "https://supabase.com/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"connection_examples": [
{
"description": "Supabase project (connection pooler)",
"connection_string": "postgresql://{username}.{project_ref}:{password}@aws-0-{region}.pooler.supabase.com:6543/{database}"
}
],
"parameters": {
"username": "Database user (default: postgres)",
"password": "Database password",
"host": "Supabase project host (from project settings)",
"port": "Default 5432 (direct) or 6543 (pooler)",
"database": "Database name (default: postgres)",
"project_ref": "Supabase project reference (from project settings)",
"region": "Supabase project region (e.g., us-east-1)"
},
"notes": "Find connection details in your Supabase project dashboard under Settings > Database. Use the connection pooler (port 6543) for better connection management.",
"docs_url": "https://supabase.com/docs/guides/database/connecting-to-postgres",
"categories": [
"Hosted Open Source"
]
},
{
"name": "Google AlloyDB",
"description": "Google Cloud's PostgreSQL-compatible database service for demanding transactional and analytical workloads.",
"logo": "alloydb.png",
"homepage_url": "https://cloud.google.com/alloydb",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"parameters": {
"username": "Database user (default: postgres)",
"password": "Database password",
"host": "AlloyDB instance IP or Auth Proxy address",
"port": "Default 5432",
"database": "Database name"
},
"notes": "For public IP connections, use the AlloyDB Auth Proxy for secure access. Private IP connections can connect directly.",
"docs_url": "https://cloud.google.com/alloydb/docs",
"categories": [
"Cloud - Google",
"Hosted Open Source"
]
},
{
"name": "Neon",
"description": "Serverless PostgreSQL with branching, scale-to-zero, and bottomless storage.",
"logo": "neon.png",
"homepage_url": "https://neon.tech/",
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}/{database}?sslmode=require",
"parameters": {
"username": "Neon role name",
"password": "Neon role password",
"host": "Neon hostname (e.g., ep-cool-name-123456.us-east-2.aws.neon.tech)",
"database": "Database name (default: neondb)"
},
"notes": "SSL is required for all connections. Find connection details in the Neon console under Connection Details.",
"docs_url": "https://neon.tech/docs/connect/connect-from-any-app",
"categories": [
"Hosted Open Source"
]
},
{
"name": "Amazon Aurora PostgreSQL",
"description": "Amazon Aurora PostgreSQL is a fully managed, PostgreSQL-compatible relational database with up to 5x the throughput of standard PostgreSQL.",
"logo": "aws-aurora.jpg",
"homepage_url": "https://aws.amazon.com/rds/aurora/",
"pypi_packages": [
"sqlalchemy-aurora-data-api"
],
"connection_string": "postgresql+auroradataapi://{aws_access_id}:{aws_secret_access_key}@/{database_name}?aurora_cluster_arn={aurora_cluster_arn}&secret_arn={secret_arn}&region_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",
"custom_errors": [
{
"regex_name": "CONNECTION_INVALID_USERNAME_REGEX",
"message_template": "The username \"%(username)s\" does not exist.",
"error_type": "CONNECTION_INVALID_USERNAME_ERROR",
"category": "Authentication",
"description": "Invalid username",
"issue_codes": [
1012
],
"invalid_fields": [
"username"
]
},
{
"regex_name": "CONNECTION_INVALID_PASSWORD_REGEX",
"message_template": "The password provided for username \"%(username)s\" is incorrect.",
"error_type": "CONNECTION_INVALID_PASSWORD_ERROR",
"category": "Authentication",
"description": "Invalid password",
"issue_codes": [
1013
],
"invalid_fields": [
"username",
"password"
]
},
{
"regex_name": "CONNECTION_INVALID_PASSWORD_NEEDED_REGEX",
"message_template": "Please re-enter the password.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
"issue_codes": [
1014,
1015
],
"invalid_fields": [
"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": "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": "COLUMN_DOES_NOT_EXIST_REGEX",
"message_template": "We can't seem to resolve the column \"%(column_name)s\" at line %(location)s.",
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
"issue_codes": [
1003,
1004
]
},
{
"regex_name": "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": "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,
"THIRTY_SECONDS": true,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": false,
"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": false,
"YEAR": true
},
"module": "superset.db_engine_specs.presto",
"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": 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,
"get_metrics": false,
"where_latest_partition": true,
"expand_data": true,
"query_cost_estimation": true,
"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"
],
"pypi_packages": [
"pyhive"
],
"install_instructions": "pip install \"apache-superset[presto]\"",
"connection_string": "presto://{hostname}:{port}/{database}",
"default_port": 8080,
"parameters": {
"hostname": "Presto coordinator hostname",
"port": "Presto coordinator port (default 8080)",
"database": "Catalog name"
},
"drivers": [
{
"name": "PyHive",
"pypi_package": "pyhive",
"connection_string": "presto://{hostname}:{port}/{database}",
"is_recommended": true
}
],
"category": "Query Engines",
"custom_errors": [
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
"message_template": "We can't seem to resolve the column \"%(column_name)s\" at line %(location)s.",
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
"issue_codes": [
1003,
1004
]
},
{
"regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
"message_template": "The table \"%(table_name)s\" does not exist. A valid table must be used to run this query.",
"error_type": "TABLE_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Table not found",
"issue_codes": [
1003,
1005
]
},
{
"regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
"message_template": "The schema \"%(schema_name)s\" does not exist. A valid schema must be used to run this query.",
"error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Schema not found",
"issue_codes": [
1003,
1016
]
},
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
"message_template": "Either the username \"%(username)s\" or the password is incorrect.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
"issue_codes": [
1014,
1015
]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
"message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
"issue_codes": [
1007
]
},
{
"regex_name": "CONNECTION_HOST_DOWN_REGEX",
"message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
"error_type": "CONNECTION_HOST_DOWN_ERROR",
"category": "Connection",
"description": "Host unreachable",
"issue_codes": [
1009
]
},
{
"regex_name": "CONNECTION_PORT_CLOSED_REGEX",
"message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
"issue_codes": [
1008
]
},
{
"regex_name": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"message_template": "Unable to connect to catalog named \"%(catalog_name)s\".",
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
"issue_codes": [
1015
]
}
]
},
"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,
"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.sqlite",
"limit_method": 1,
"limit_clause": true,
"joins": true,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": false,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": false,
"cte_in_subquery": true,
"max_column_name": null,
"sql_comments": true,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": false,
"function_names": true,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": false,
"dbapi_exception_mapping": false,
"custom_errors": false,
"dynamic_schema": false,
"catalog": false,
"dynamic_catalog": false,
"ssh_tunneling": false,
"query_cancelation": false,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
"score": 41,
"max_score": 201,
"documentation": {
"description": "SQLite is a self-contained, serverless SQL database engine.",
"logo": "sqlite.png",
"homepage_url": "https://www.sqlite.org/",
"categories": [
"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": "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
]
}
]
},
"engine": "sqlite",
"engine_name": "SQLite",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Shillelagh": {
"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.shillelagh",
"limit_method": 1,
"limit_clause": true,
"joins": true,
"subqueries": true,
"alias_in_select": true,
"alias_in_orderby": true,
"time_groupby_inline": false,
"alias_to_source_column": false,
"order_by_not_in_select": true,
"expressions_in_orderby": false,
"cte_in_subquery": true,
"max_column_name": null,
"sql_comments": true,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": false,
"function_names": true,
"user_impersonation": false,
"file_upload": true,
"get_extra_table_metadata": false,
"dbapi_exception_mapping": false,
"custom_errors": false,
"dynamic_schema": false,
"catalog": false,
"dynamic_catalog": false,
"ssh_tunneling": false,
"query_cancelation": false,
"get_metrics": false,
"where_latest_partition": false,
"expand_data": false,
"query_cost_estimation": false,
"sql_validation": false,
"score": 41,
"max_score": 201,
"documentation": {
"description": "Shillelagh is a Python library that allows querying many data sources using SQL, including Google Sheets, CSV files, and APIs.",
"logo": "shillelagh.png",
"homepage_url": "https://shillelagh.readthedocs.io/",
"categories": [
"Other Databases",
"Open Source"
],
"pypi_packages": [
"shillelagh[gsheetsapi]"
],
"connection_string": "shillelagh://",
"notes": "Shillelagh uses virtual tables to query external data sources. Google Sheets requires OAuth credentials configured.",
"category": "Other Databases"
},
"engine": "shillelagh",
"engine_name": "Shillelagh",
"engine_aliases": [],
"default_driver": "apsw",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"SingleStore": {
"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.singlestore",
"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": 256,
"sql_comments": true,
"escaped_colons": true,
"masked_encrypted_extra": false,
"column_type_mapping": true,
"function_names": true,
"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": 68,
"max_score": 201,
"documentation": {
"description": "SingleStore is a distributed SQL database for real-time analytics and transactions.",
"logo": "singlestore.png",
"homepage_url": "https://www.singlestore.com/",
"categories": [
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"singlestoredb"
],
"connection_string": "singlestoredb://{username}:{password}@{host}:{port}/{database}",
"default_port": 3306,
"parameters": {
"username": "Database username",
"password": "Database password",
"host": "SingleStore host",
"port": "SingleStore port (default 3306)",
"database": "Database name"
},
"drivers": [
{
"name": "singlestoredb",
"pypi_package": "singlestoredb",
"connection_string": "singlestoredb://{username}:{password}@{host}:{port}/{database}",
"is_recommended": true
}
],
"category": "Other Databases"
},
"engine": "singlestoredb",
"engine_name": "SingleStore",
"engine_aliases": [],
"default_driver": "singlestoredb",
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Snowflake": {
"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.snowflake",
"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": 256,
"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": 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": 72,
"max_score": 201,
"documentation": {
"description": "Snowflake is a cloud-native data warehouse.",
"logo": "snowflake.svg",
"homepage_url": "https://www.snowflake.com/",
"categories": [
"Cloud Data Warehouses",
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"snowflake-sqlalchemy"
],
"connection_string": "snowflake://{user}:{password}@{account}.{region}/{database}?role={role}&warehouse={warehouse}",
"install_instructions": "echo \"snowflake-sqlalchemy\" >> ./docker/requirements-local.txt",
"connection_examples": [
{
"description": "With role and warehouse",
"connection_string": "snowflake://{user}:{password}@{account}.{region}/{database}?role={role}&warehouse={warehouse}"
},
{
"description": "With defaults (role/warehouse optional)",
"connection_string": "snowflake://{user}:{password}@{account}.{region}/{database}"
}
],
"authentication_methods": [
{
"name": "Key Pair Authentication",
"description": "Use RSA key pair instead of password",
"requirements": "Key pair must be generated and public key registered in Snowflake",
"notes": "Merge multi-line private key to one line with \\n between lines."
}
],
"notes": "Schema is not required in connection string. Ensure user has privileges for all databases/schemas/tables/views/warehouses.",
"docs_url": "https://docs.snowflake.com/en/user-guide/key-pair-auth.html",
"category": "Cloud Data Warehouses",
"custom_errors": [
{
"regex_name": "OBJECT_DOES_NOT_EXIST_REGEX",
"message_template": "%(object)s does not exist in this database.",
"error_type": "OBJECT_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Object not found",
"issue_codes": [
1029
]
},
{
"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": "snowflake",
"engine_name": "Snowflake",
"engine_aliases": [],
"default_driver": "snowflake",
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": true,
"supports_dynamic_catalog": true
},
"StarRocks": {
"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.starrocks",
"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": true,
"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": 89,
"max_score": 201,
"documentation": {
"description": "StarRocks is a high-performance analytical database for real-time analytics.",
"logo": "starrocks.png",
"homepage_url": "https://www.starrocks.io/",
"categories": [
"Analytical Databases",
"Open Source"
],
"pypi_packages": [
"starrocks"
],
"connection_string": "starrocks://{username}:{password}@{host}:{port}/{catalog}.{database}",
"default_port": 9030,
"parameters": {
"username": "Database username",
"password": "Database password",
"host": "StarRocks FE host",
"port": "Query port (default 9030)",
"catalog": "Catalog name",
"database": "Database name"
},
"drivers": [
{
"name": "starrocks",
"pypi_package": "starrocks",
"connection_string": "starrocks://{username}:{password}@{host}:{port}/{catalog}.{database}",
"is_recommended": true
},
{
"name": "mysqlclient",
"pypi_package": "mysqlclient",
"connection_string": "mysql://{username}:{password}@{host}:{port}/{database}",
"is_recommended": false,
"notes": "MySQL-compatible driver for StarRocks."
},
{
"name": "PyMySQL",
"pypi_package": "pymysql",
"connection_string": "mysql+pymysql://{username}:{password}@{host}:{port}/{database}",
"is_recommended": false,
"notes": "Pure Python MySQL driver, no compilation required."
}
],
"compatible_databases": [
{
"name": "CelerData",
"description": "CelerData is a fully-managed cloud analytics service built on StarRocks. It provides instant elasticity, automatic scaling, and enterprise features.",
"logo": "celerdata.png",
"homepage_url": "https://celerdata.com/",
"categories": [
"Analytical Databases",
"Cloud Data Warehouses",
"Hosted Open Source"
],
"pypi_packages": [
"starrocks"
],
"connection_string": "starrocks://{username}:{password}@{host}:{port}/{catalog}.{database}",
"parameters": {
"username": "CelerData username",
"password": "CelerData password",
"host": "CelerData cluster endpoint",
"port": "Query port (default 9030)",
"catalog": "Catalog name",
"database": "Database name"
},
"docs_url": "https://docs.celerdata.com/"
}
],
"category": "Analytical Databases",
"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_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"
]
}
]
},
"engine": "starrocks",
"engine_name": "StarRocks",
"engine_aliases": [],
"default_driver": "starrocks",
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": true,
"supports_dynamic_catalog": true
},
"Superset meta database": {
"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.superset",
"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": false,
"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": 31,
"max_score": 201,
"documentation": {
"description": "Superset meta database is an experimental feature that enables querying across multiple configured databases using a single connection.",
"logo": "superset.svg",
"homepage_url": "https://superset.apache.org/",
"categories": [
"Other Databases"
],
"pypi_packages": [],
"connection_string": "superset://",
"notes": "This is an internal Superset feature. Enable with ENABLE_SUPERSET_META_DB feature flag. Allows cross-database queries using virtual tables.",
"category": "Other Databases"
},
"engine": "superset",
"engine_name": "Superset meta database",
"engine_aliases": [],
"default_driver": "",
"supports_file_upload": false,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"TDengine": {
"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": false,
"QUARTER": false,
"QUARTER_YEAR": false,
"YEAR": false
},
"module": "superset.db_engine_specs.tdengine",
"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": 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": 25,
"max_score": 201,
"documentation": {
"description": "TDengine is a high-performance time-series database for IoT.",
"logo": "tdengine.png",
"homepage_url": "https://tdengine.com/",
"categories": [
"Time Series Databases",
"Open Source"
],
"pypi_packages": [
"taospy",
"taos-ws-py"
],
"connection_string": "taosws://{user}:{password}@{host}:{port}",
"default_port": 6041,
"connection_examples": [
{
"description": "Local connection",
"connection_string": "taosws://root:taosdata@127.0.0.1:6041"
}
],
"docs_url": "https://www.tdengine.com",
"category": "Other Databases"
},
"engine": "taosws",
"engine_name": "TDengine",
"engine_aliases": [],
"default_driver": "taosws",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Teradata": {
"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.teradata",
"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": 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": "Teradata is an enterprise data warehouse platform.",
"logo": "teradata.png",
"homepage_url": "https://www.teradata.com/",
"categories": [
"Traditional RDBMS",
"Proprietary"
],
"pypi_packages": [
"teradatasqlalchemy"
],
"connection_string": "teradatasql://{user}:{password}@{host}",
"default_port": 1025,
"drivers": [
{
"name": "teradatasqlalchemy (Recommended)",
"pypi_package": "teradatasqlalchemy",
"connection_string": "teradatasql://{user}:{password}@{host}",
"is_recommended": true,
"notes": "No ODBC drivers required."
},
{
"name": "sqlalchemy-teradata (ODBC)",
"pypi_package": "sqlalchemy-teradata",
"is_recommended": false,
"notes": "Requires ODBC driver installation.",
"docs_url": "https://downloads.teradata.com/download/connectivity/odbc-driver/linux"
}
],
"category": "Other Databases"
},
"engine": "teradatasql",
"engine_name": "Teradata",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"TimescaleDB": {
"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.timescaledb",
"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": 34,
"max_score": 201,
"documentation": {
"description": "TimescaleDB is an open-source relational database for time-series and analytics, built on PostgreSQL.",
"logo": "timescale.png",
"homepage_url": "https://www.timescale.com/",
"categories": [
"Analytical Databases",
"Open Source"
],
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"default_port": 5432,
"connection_examples": [
{
"description": "Timescale Cloud (SSL required)",
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}?sslmode=require"
}
],
"notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.",
"docs_url": "https://docs.timescale.com/",
"category": "Other Databases"
},
"engine": "timescaledb",
"engine_name": "TimescaleDB",
"engine_aliases": [],
"default_driver": "psycopg2",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"Trino": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
"THIRTY_SECONDS": true,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": false,
"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": false,
"YEAR": true
},
"module": "superset.db_engine_specs.trino",
"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": 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": true,
"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": false,
"query_cost_estimation": true,
"sql_validation": false,
"score": 149,
"max_score": 201,
"documentation": {
"description": "Trino is a distributed SQL query engine for big data analytics.",
"logo": "trino.png",
"homepage_url": "https://trino.io/",
"categories": [
"Query Engines",
"Open Source"
],
"pypi_packages": [
"trino"
],
"install_instructions": "pip install \"apache-superset[trino]\"",
"connection_string": "trino://{username}:{password}@{hostname}:{port}/{catalog}",
"default_port": 8080,
"parameters": {
"username": "Trino username",
"password": "Trino password (if authentication is enabled)",
"hostname": "Trino coordinator hostname",
"port": "Trino coordinator port (default 8080)",
"catalog": "Catalog name"
},
"drivers": [
{
"name": "trino",
"pypi_package": "trino",
"connection_string": "trino://{username}:{password}@{hostname}:{port}/{catalog}",
"is_recommended": true
}
],
"compatible_databases": [
{
"name": "Starburst Galaxy",
"description": "Starburst Galaxy is a fully-managed cloud analytics platform built on Trino. It provides data lake analytics with enterprise security and governance.",
"logo": "starburst.png",
"homepage_url": "https://www.starburst.io/platform/starburst-galaxy/",
"categories": [
"Query Engines",
"Cloud Data Warehouses",
"Hosted Open Source"
],
"pypi_packages": [
"trino"
],
"connection_string": "trino://{username}:{password}@{host}:{port}/{catalog}",
"parameters": {
"username": "Starburst Galaxy username (email/role)",
"password": "Starburst Galaxy password or token",
"host": "Your Galaxy cluster hostname",
"port": "Port (default 443)",
"catalog": "Catalog name"
},
"docs_url": "https://docs.starburst.io/starburst-galaxy/"
},
{
"name": "Starburst Enterprise",
"description": "Starburst Enterprise is a self-managed Trino distribution with enterprise features, security, and support.",
"logo": "starburst.png",
"homepage_url": "https://www.starburst.io/platform/starburst-enterprise/",
"categories": [
"Query Engines",
"Hosted Open Source"
],
"pypi_packages": [
"trino"
],
"connection_string": "trino://{username}:{password}@{hostname}:{port}/{catalog}",
"docs_url": "https://docs.starburst.io/"
}
],
"category": "Query Engines"
},
"engine": "trino",
"engine_name": "Trino",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": true,
"supports_dynamic_catalog": true
},
"Vertica": {
"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.vertica",
"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": 34,
"max_score": 201,
"documentation": {
"description": "Vertica is a column-oriented analytics database.",
"logo": "vertica.png",
"homepage_url": "https://www.vertica.com/",
"categories": [
"Analytical Databases",
"Proprietary"
],
"pypi_packages": [
"sqlalchemy-vertica-python"
],
"connection_string": "vertica+vertica_python://{username}:{password}@{host}/{database}",
"default_port": 5433,
"parameters": {
"username": "Database username",
"password": "Database password",
"host": "localhost, IP address, or hostname (cloud or on-prem)",
"database": "Database name",
"port": "Default 5433"
},
"notes": "Supports load balancer backup host configuration.",
"docs_url": "http://www.vertica.com/",
"category": "Analytical Databases"
},
"engine": "vertica",
"engine_name": "Vertica",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"YDB": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": false,
"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.ydb",
"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": false,
"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": 23,
"max_score": 201,
"documentation": {
"description": "YDB is a distributed SQL database by Yandex.",
"logo": "ydb.svg",
"homepage_url": "https://ydb.tech/",
"categories": [
"Traditional RDBMS",
"Open Source"
],
"pypi_packages": [
"ydb-sqlalchemy"
],
"connection_string": "ydb://{host}:{port}/{database_name}",
"default_port": 2135,
"engine_parameters": [
{
"name": "Protocol",
"description": "Specify connection protocol (default: grpc)",
"secure_extra": {
"protocol": "grpcs"
}
}
],
"authentication_methods": [
{
"name": "Static Credentials",
"description": "Username/password authentication",
"secure_extra": {
"credentials": {
"username": "...",
"password": "..."
}
}
},
{
"name": "Access Token",
"description": "Token-based authentication",
"secure_extra": {
"credentials": {
"token": "..."
}
}
},
{
"name": "Service Account",
"description": "Service account JSON credentials",
"secure_extra": {
"credentials": {
"service_account_json": {
"id": "...",
"service_account_id": "...",
"private_key": "..."
}
}
}
}
],
"category": "Other Databases"
},
"engine": "yql",
"engine_name": "YDB",
"engine_aliases": [
"yql+ydb",
"ydb"
],
"default_driver": "ydb",
"supports_file_upload": false,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"YugabyteDB": {
"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.yugabytedb",
"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": 34,
"max_score": 201,
"documentation": {
"description": "YugabyteDB is a distributed SQL database built on top of PostgreSQL.",
"logo": "yugabyte.png",
"homepage_url": "https://www.yugabyte.com/",
"categories": [
"Cloud Data Warehouses",
"Traditional RDBMS",
"Open Source"
],
"pypi_packages": [
"psycopg2"
],
"connection_string": "postgresql://{username}:{password}@{host}:{port}/{database}",
"default_port": 5433,
"notes": "Uses the PostgreSQL driver. psycopg2 comes bundled with Superset.",
"docs_url": "https://docs.yugabyte.com/",
"category": "Other Databases"
},
"engine": "yugabytedb",
"engine_name": "YugabyteDB",
"engine_aliases": [],
"default_driver": "psycopg2",
"supports_file_upload": true,
"supports_dynamic_schema": false,
"supports_catalog": false,
"supports_dynamic_catalog": false
},
"base": {
"time_grains": {
"SECOND": true,
"FIVE_SECONDS": true,
"THIRTY_SECONDS": true,
"MINUTE": true,
"FIVE_MINUTES": true,
"TEN_MINUTES": true,
"FIFTEEN_MINUTES": true,
"THIRTY_MINUTES": false,
"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": false,
"YEAR": true
},
"module": "superset.db_engine_specs.presto",
"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": true,
"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": false,
"get_metrics": false,
"where_latest_partition": true,
"expand_data": false,
"query_cost_estimation": true,
"sql_validation": false,
"score": 109,
"max_score": 201,
"documentation": {
"pypi_packages": [],
"connection_string": "engine+driver://user:password@host:port/dbname[?key=value&key=value...]",
"category": "Other Databases",
"custom_errors": [
{
"regex_name": "COLUMN_DOES_NOT_EXIST_REGEX",
"message_template": "We can't seem to resolve the column \"%(column_name)s\" at line %(location)s.",
"error_type": "COLUMN_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Column not found",
"issue_codes": [
1003,
1004
]
},
{
"regex_name": "TABLE_DOES_NOT_EXIST_REGEX",
"message_template": "The table \"%(table_name)s\" does not exist. A valid table must be used to run this query.",
"error_type": "TABLE_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Table not found",
"issue_codes": [
1003,
1005
]
},
{
"regex_name": "SCHEMA_DOES_NOT_EXIST_REGEX",
"message_template": "The schema \"%(schema_name)s\" does not exist. A valid schema must be used to run this query.",
"error_type": "SCHEMA_DOES_NOT_EXIST_ERROR",
"category": "Query",
"description": "Schema not found",
"issue_codes": [
1003,
1016
]
},
{
"regex_name": "CONNECTION_ACCESS_DENIED_REGEX",
"message_template": "Either the username \"%(username)s\" or the password is incorrect.",
"error_type": "CONNECTION_ACCESS_DENIED_ERROR",
"category": "Authentication",
"description": "Access denied",
"issue_codes": [
1014,
1015
]
},
{
"regex_name": "CONNECTION_INVALID_HOSTNAME_REGEX",
"message_template": "The hostname \"%(hostname)s\" cannot be resolved.",
"error_type": "CONNECTION_INVALID_HOSTNAME_ERROR",
"category": "Connection",
"description": "Invalid hostname",
"issue_codes": [
1007
]
},
{
"regex_name": "CONNECTION_HOST_DOWN_REGEX",
"message_template": "The host \"%(hostname)s\" might be down, and can't be reached on port %(port)s.",
"error_type": "CONNECTION_HOST_DOWN_ERROR",
"category": "Connection",
"description": "Host unreachable",
"issue_codes": [
1009
]
},
{
"regex_name": "CONNECTION_PORT_CLOSED_REGEX",
"message_template": "Port %(port)s on hostname \"%(hostname)s\" refused the connection.",
"error_type": "CONNECTION_PORT_CLOSED_ERROR",
"category": "Connection",
"description": "Port closed or refused",
"issue_codes": [
1008
]
},
{
"regex_name": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"message_template": "Unable to connect to catalog named \"%(catalog_name)s\".",
"error_type": "CONNECTION_UNKNOWN_DATABASE_ERROR",
"category": "Connection",
"description": "Unknown database",
"issue_codes": [
1015
]
}
]
},
"engine": "base",
"engine_name": "base",
"engine_aliases": [],
"default_driver": null,
"supports_file_upload": true,
"supports_dynamic_schema": true,
"supports_catalog": true,
"supports_dynamic_catalog": true
}
}
}
Reference in New Issue View Git Blame Copy Permalink