diff --git a/docs/docs/connecting-to-databases/installing-database-drivers.mdx b/docs/docs/connecting-to-databases/installing-database-drivers.mdx deleted file mode 100644 index 0159f50a0c9d8..0000000000000 --- a/docs/docs/connecting-to-databases/installing-database-drivers.mdx +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Installing Database Drivers -hide_title: true -sidebar_position: 1 -version: 1 ---- - -## Install Database Drivers - -Superset requires a Python DB-API database driver and a SQLAlchemy -dialect to be installed for each datastore you want to connect to. - -You can read more [here](/docs/connecting-to-databases/docker-add-drivers) about how to -install new database drivers into your Superset configuration. - -### Supported Databases and Dependencies - -Superset does not ship bundled with connectivity to databases, except for SQLite, -which is part of the Python standard library. You’ll need to install the required packages for the database you want to use as your metadata database as well as the packages needed to connect to the databases you want to access through Superset. - -A list of some of the recommended packages. - -| Database | PyPI package | Connection String | -| ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | -| [Amazon Athena](/docs/connecting-to-databases/athena) | `pip install "PyAthenaJDBC>1.0.9` , `pip install "PyAthena>1.2.0` | `awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{ ` | -| [Amazon Redshift](/docs/connecting-to-databases/redshift) | `pip install sqlalchemy-redshift` | ` redshift+psycopg2://:@:5439/` | -| [Apache Drill](/docs/connecting-to-databases/drill) | `pip install sqlalchemy-drill` | `drill+sadrill:// For JDBC drill+jdbc://` | -| [Apache Druid](/docs/connecting-to-databases/druid) | `pip install pydruid` | `druid://:@:/druid/v2/sql` | -| [Apache Hive](/docs/connecting-to-databases/hive) | `pip install pyhive` | `hive://hive@{hostname}:{port}/{database}` | -| [Apache Impala](/docs/connecting-to-databases/impala) | `pip install impyla` | `impala://{hostname}:{port}/{database}` | -| [Apache Kylin](/docs/connecting-to-databases/kylin) | `pip install kylinpy` | `kylin://:@:/?=&=` | -| [Apache Pinot](/docs/connecting-to-databases/pinot) | `pip install pinotdb` | `pinot://BROKER:5436/query?server=http://CONTROLLER:5983/` | -| [Apache Solr](/docs/connecting-to-databases/solr) | `pip install sqlalchemy-solr` | `solr://{username}:{password}@{hostname}:{port}/{server_path}/{collection}` | -| [Apache Spark SQL](/docs/connecting-to-databases/spark-sql) | `pip install pyhive` | `hive://hive@{hostname}:{port}/{database}` | -| [Ascend.io](/docs/connecting-to-databases/ascend) | `pip install impyla` | `ascend://{username}:{password}@{hostname}:{port}/{database}?auth_mechanism=PLAIN;use_ssl=true` | -| [Azure MS SQL](/docs/connecting-to-databases/sql-server) | `pip install pymssql` | `mssql+pymssql://UserName@presetSQL:TestPassword@presetSQL.database.windows.net:1433/TestSchema` | -| [Big Query](/docs/connecting-to-databases/bigquery) | `pip install pybigquery` | `bigquery://{project_id}` | -| [ClickHouse](/docs/connecting-to-databases/clickhouse) | `pip install clickhouse-driver==0.2.0 && pip install clickhouse-sqlalchemy==0.1.6` | `clickhouse+native://{username}:{password}@{hostname}:{port}/{database}` | -| [CockroachDB](/docs/connecting-to-databases/cockroachdb) | `pip install cockroachdb` | `cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable` | -| [Dremio](/docs/connecting-to-databases/dremio) | `pip install sqlalchemy_dremio` | `dremio://user:pwd@host:31010/` | -| [Elasticsearch](/docs/connecting-to-databases/elasticsearch) | `pip install elasticsearch-dbapi` | `elasticsearch+http://{user}:{password}@{host}:9200/` | -| [Exasol](/docs/connecting-to-databases/exasol) | `pip install sqlalchemy-exasol` | `exa+pyodbc://{username}:{password}@{hostname}:{port}/my_schema?CONNECTIONLCALL=en_US.UTF-8&driver=EXAODBC` | -| [Google Sheets](/docs/connecting-to-databases/google-sheets) | `pip install shillelagh[gsheetsapi]` | `gsheets://` | -| [Firebolt](/docs/connecting-to-databases/firebolt) | `pip install firebolt-sqlalchemy` | `firebolt://{username}:{password}@{database} or firebolt://{username}:{password}@{database}/{engine_name}` | -| [Hologres](/docs/connecting-to-databases/hologres) | `pip install psycopg2` | `postgresql+psycopg2://:@/` | -| [IBM Db2](/docs/connecting-to-databases/ibm-db2) | `pip install ibm_db_sa` | `db2+ibm_db://` | -| [IBM Netezza Performance Server](/docs/connecting-to-databases/netezza) | `pip install nzalchemy` | `netezza+nzpy://:@/` | -| [MySQL](/docs/connecting-to-databases/mysql) | `pip install mysqlclient` | `mysql://:@/` | -| [Oracle](/docs/connecting-to-databases/oracle) | `pip install cx_Oracle` | `oracle://` | -| [PostgreSQL](/docs/connecting-to-databases/postgres) | `pip install psycopg2` | `postgresql://:@/` | -| [Trino](/docs/connecting-to-databases/trino) | `pip install sqlalchemy-trino` | `trino://{username}:{password}@{hostname}:{port}/{catalog}` | -| [Presto](/docs/connecting-to-databases/presto) | `pip install pyhive` | `presto://` | -| [SAP Hana](/docs/connecting-to-databases/hana) | `pip install hdbcli sqlalchemy-hana or pip install apache-superset[hana]` | `hana://{username}:{password}@{host}:{port}` | -| [Snowflake](/docs/connecting-to-databases/snowflake) | `pip install snowflake-sqlalchemy` | `snowflake://{user}:{password}@{account}.{region}/{database}?role={role}&warehouse={warehouse}` | -| SQLite | | `sqlite://` | -| [SQL Server](/docs/connecting-to-databases/sql-server) | `pip install pymssql` | `mssql://` | -| [Teradata](/docs/connecting-to-databases/teradata) | `pip install sqlalchemy-teradata` | `teradata://{user}:{password}@{host}` | -| [Vertica](/docs/connecting-to-databases/vertica) | `pip install sqlalchemy-vertica-python` | `vertica+vertica_python://:@/` | - ---- - -Note that many other databases are supported, the main criteria being the existence of a functional -SQLAlchemy dialect and Python driver. Searching for the keyword "sqlalchemy + (database name)" -should help get you to the right place. - -If your database or data engine isn't on the list but a SQL interface -exists, please file an issue on the -[Superset GitHub repo](https://github.com/apache/superset/issues), so we can work on documenting and -supporting it. - -[StackOverflow](https://stackoverflow.com/questions/tagged/apache-superset+superset) and the -[Superset community Slack](https://join.slack.com/t/apache-superset/shared_invite/zt-uxbh5g36-AISUtHbzOXcu0BIj7kgUaw) -are great places to get help with connecting to databases in Superset. diff --git a/docs/docs/Contributing/_category_.json b/docs/docs/contributing/_category_.json similarity index 100% rename from docs/docs/Contributing/_category_.json rename to docs/docs/contributing/_category_.json diff --git a/docs/docs/Contributing/contributing-page.mdx b/docs/docs/contributing/contributing-page.mdx similarity index 100% rename from docs/docs/Contributing/contributing-page.mdx rename to docs/docs/contributing/contributing-page.mdx diff --git a/docs/docs/Contributing/conventions-and-typing.mdx b/docs/docs/contributing/conventions-and-typing.mdx similarity index 100% rename from docs/docs/Contributing/conventions-and-typing.mdx rename to docs/docs/contributing/conventions-and-typing.mdx diff --git a/docs/docs/Contributing/hooks-and-linting.mdx b/docs/docs/contributing/hooks-and-linting.mdx similarity index 100% rename from docs/docs/Contributing/hooks-and-linting.mdx rename to docs/docs/contributing/hooks-and-linting.mdx diff --git a/docs/docs/Contributing/local-backend.mdx b/docs/docs/contributing/local-backend.mdx similarity index 100% rename from docs/docs/Contributing/local-backend.mdx rename to docs/docs/contributing/local-backend.mdx diff --git a/docs/docs/Contributing/pull-request-guidelines.mdx b/docs/docs/contributing/pull-request-guidelines.mdx similarity index 100% rename from docs/docs/Contributing/pull-request-guidelines.mdx rename to docs/docs/contributing/pull-request-guidelines.mdx diff --git a/docs/docs/Contributing/style-guide.mdx b/docs/docs/contributing/style-guide.mdx similarity index 100% rename from docs/docs/Contributing/style-guide.mdx rename to docs/docs/contributing/style-guide.mdx diff --git a/docs/docs/Contributing/testing-locally.mdx b/docs/docs/contributing/testing-locally.mdx similarity index 100% rename from docs/docs/Contributing/testing-locally.mdx rename to docs/docs/contributing/testing-locally.mdx diff --git a/docs/docs/Contributing/translations.mdx b/docs/docs/contributing/translations.mdx similarity index 100% rename from docs/docs/Contributing/translations.mdx rename to docs/docs/contributing/translations.mdx diff --git a/docs/docs/Contributing/types-of-contributions.mdx b/docs/docs/contributing/types-of-contributions.mdx similarity index 100% rename from docs/docs/Contributing/types-of-contributions.mdx rename to docs/docs/contributing/types-of-contributions.mdx diff --git a/docs/docs/Creating Charts and Dashboards/_category_.json b/docs/docs/creating-charts-dashboards/_category_.json similarity index 100% rename from docs/docs/Creating Charts and Dashboards/_category_.json rename to docs/docs/creating-charts-dashboards/_category_.json diff --git a/docs/docs/Creating Charts and Dashboards/creating-your-first-dashboard.mdx b/docs/docs/creating-charts-dashboards/creating-your-first-dashboard.mdx similarity index 100% rename from docs/docs/Creating Charts and Dashboards/creating-your-first-dashboard.mdx rename to docs/docs/creating-charts-dashboards/creating-your-first-dashboard.mdx diff --git a/docs/docs/Creating Charts and Dashboards/exploring-data.mdx b/docs/docs/creating-charts-dashboards/exploring-data.mdx similarity index 100% rename from docs/docs/Creating Charts and Dashboards/exploring-data.mdx rename to docs/docs/creating-charts-dashboards/exploring-data.mdx diff --git a/docs/docs/connecting-to-databases/_category_.json b/docs/docs/databases/_category_.json similarity index 100% rename from docs/docs/connecting-to-databases/_category_.json rename to docs/docs/databases/_category_.json diff --git a/docs/docs/connecting-to-databases/ascend.mdx b/docs/docs/databases/ascend.mdx similarity index 100% rename from docs/docs/connecting-to-databases/ascend.mdx rename to docs/docs/databases/ascend.mdx diff --git a/docs/docs/connecting-to-databases/athena.mdx b/docs/docs/databases/athena.mdx similarity index 100% rename from docs/docs/connecting-to-databases/athena.mdx rename to docs/docs/databases/athena.mdx diff --git a/docs/docs/connecting-to-databases/bigquery.mdx b/docs/docs/databases/bigquery.mdx similarity index 96% rename from docs/docs/connecting-to-databases/bigquery.mdx rename to docs/docs/databases/bigquery.mdx index c0c3b2f472090..6d3ba0750e659 100644 --- a/docs/docs/connecting-to-databases/bigquery.mdx +++ b/docs/docs/databases/bigquery.mdx @@ -12,7 +12,7 @@ The recommended connector library for BigQuery is ### Install BigQuery Driver -Follow the steps [here](/docs/connecting-to-databases/docker-add-drivers) about how to +Follow the steps [here](/docs/databases/docker-add-drivers) about how to install new database drivers when setting up Superset locally via docker-compose. ``` diff --git a/docs/docs/connecting-to-databases/clickhouse.mdx b/docs/docs/databases/clickhouse.mdx similarity index 100% rename from docs/docs/connecting-to-databases/clickhouse.mdx rename to docs/docs/databases/clickhouse.mdx diff --git a/docs/docs/connecting-to-databases/cockroachdb.mdx b/docs/docs/databases/cockroachdb.mdx similarity index 100% rename from docs/docs/connecting-to-databases/cockroachdb.mdx rename to docs/docs/databases/cockroachdb.mdx diff --git a/docs/docs/connecting-to-databases/cratedb.mdx b/docs/docs/databases/cratedb.mdx similarity index 100% rename from docs/docs/connecting-to-databases/cratedb.mdx rename to docs/docs/databases/cratedb.mdx diff --git a/docs/docs/connecting-to-databases/databricks.mdx b/docs/docs/databases/databricks.mdx similarity index 100% rename from docs/docs/connecting-to-databases/databricks.mdx rename to docs/docs/databases/databricks.mdx diff --git a/docs/docs/connecting-to-databases/db-connection-ui.mdx b/docs/docs/databases/db-connection-ui.mdx similarity index 100% rename from docs/docs/connecting-to-databases/db-connection-ui.mdx rename to docs/docs/databases/db-connection-ui.mdx diff --git a/docs/docs/connecting-to-databases/docker-add-drivers.mdx b/docs/docs/databases/docker-add-drivers.mdx similarity index 96% rename from docs/docs/connecting-to-databases/docker-add-drivers.mdx rename to docs/docs/databases/docker-add-drivers.mdx index a24e8b8b296a0..725a6e671c5b8 100644 --- a/docs/docs/connecting-to-databases/docker-add-drivers.mdx +++ b/docs/docs/databases/docker-add-drivers.mdx @@ -20,7 +20,7 @@ with the recommended connector library for each database. ### 1. Determine the driver you need -To figure out how to install the [database driver](/docs/connecting-to-databases/installing-database-drivers) of your choice. +To figure out how to install the [database driver](/docs/databases/installing-database-drivers) of your choice. In the example, we'll walk through the process of installing a MySQL driver in Superset. diff --git a/docs/docs/connecting-to-databases/dremio.mdx b/docs/docs/databases/dremio.mdx similarity index 100% rename from docs/docs/connecting-to-databases/dremio.mdx rename to docs/docs/databases/dremio.mdx diff --git a/docs/docs/connecting-to-databases/drill.mdx b/docs/docs/databases/drill.mdx similarity index 100% rename from docs/docs/connecting-to-databases/drill.mdx rename to docs/docs/databases/drill.mdx diff --git a/docs/docs/connecting-to-databases/druid.mdx b/docs/docs/databases/druid.mdx similarity index 100% rename from docs/docs/connecting-to-databases/druid.mdx rename to docs/docs/databases/druid.mdx diff --git a/docs/docs/connecting-to-databases/elasticsearch.mdx b/docs/docs/databases/elasticsearch.mdx similarity index 100% rename from docs/docs/connecting-to-databases/elasticsearch.mdx rename to docs/docs/databases/elasticsearch.mdx diff --git a/docs/docs/connecting-to-databases/exasol.mdx b/docs/docs/databases/exasol.mdx similarity index 100% rename from docs/docs/connecting-to-databases/exasol.mdx rename to docs/docs/databases/exasol.mdx diff --git a/docs/docs/connecting-to-databases/extra-settings.mdx b/docs/docs/databases/extra-settings.mdx similarity index 100% rename from docs/docs/connecting-to-databases/extra-settings.mdx rename to docs/docs/databases/extra-settings.mdx diff --git a/docs/docs/connecting-to-databases/firebird.mdx b/docs/docs/databases/firebird.mdx similarity index 100% rename from docs/docs/connecting-to-databases/firebird.mdx rename to docs/docs/databases/firebird.mdx diff --git a/docs/docs/connecting-to-databases/firebolt.mdx b/docs/docs/databases/firebolt.mdx similarity index 100% rename from docs/docs/connecting-to-databases/firebolt.mdx rename to docs/docs/databases/firebolt.mdx diff --git a/docs/docs/connecting-to-databases/google-sheets.mdx b/docs/docs/databases/google-sheets.mdx similarity index 100% rename from docs/docs/connecting-to-databases/google-sheets.mdx rename to docs/docs/databases/google-sheets.mdx diff --git a/docs/docs/connecting-to-databases/hana.mdx b/docs/docs/databases/hana.mdx similarity index 100% rename from docs/docs/connecting-to-databases/hana.mdx rename to docs/docs/databases/hana.mdx diff --git a/docs/docs/connecting-to-databases/hive.mdx b/docs/docs/databases/hive.mdx similarity index 100% rename from docs/docs/connecting-to-databases/hive.mdx rename to docs/docs/databases/hive.mdx diff --git a/docs/docs/connecting-to-databases/hologres.mdx b/docs/docs/databases/hologres.mdx similarity index 100% rename from docs/docs/connecting-to-databases/hologres.mdx rename to docs/docs/databases/hologres.mdx diff --git a/docs/docs/connecting-to-databases/ibm-db2.mdx b/docs/docs/databases/ibm-db2.mdx similarity index 100% rename from docs/docs/connecting-to-databases/ibm-db2.mdx rename to docs/docs/databases/ibm-db2.mdx diff --git a/docs/docs/connecting-to-databases/impala.mdx b/docs/docs/databases/impala.mdx similarity index 100% rename from docs/docs/connecting-to-databases/impala.mdx rename to docs/docs/databases/impala.mdx diff --git a/docs/docs/databases/installing-database-drivers.mdx b/docs/docs/databases/installing-database-drivers.mdx new file mode 100644 index 0000000000000..850b76ff1641f --- /dev/null +++ b/docs/docs/databases/installing-database-drivers.mdx @@ -0,0 +1,73 @@ +--- +title: Installing Database Drivers +hide_title: true +sidebar_position: 1 +version: 1 +--- + +## Install Database Drivers + +Superset requires a Python DB-API database driver and a SQLAlchemy +dialect to be installed for each datastore you want to connect to. + +You can read more [here](/docs/databases/docker-add-drivers) about how to +install new database drivers into your Superset configuration. + +### Supported Databases and Dependencies + +Superset does not ship bundled with connectivity to databases, except for SQLite, +which is part of the Python standard library. You’ll need to install the required packages for the database you want to use as your metadata database as well as the packages needed to connect to the databases you want to access through Superset. + +A list of some of the recommended packages. + +| Database | PyPI package | Connection String | +| --------------------------------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | +| [Amazon Athena](/docs/databases/athena) | `pip install "PyAthenaJDBC>1.0.9` , `pip install "PyAthena>1.2.0` | `awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{ ` | +| [Amazon Redshift](/docs/databases/redshift) | `pip install sqlalchemy-redshift` | ` redshift+psycopg2://:@:5439/` | +| [Apache Drill](/docs/databases/drill) | `pip install sqlalchemy-drill` | `drill+sadrill:// For JDBC drill+jdbc://` | +| [Apache Druid](/docs/databases/druid) | `pip install pydruid` | `druid://:@:/druid/v2/sql` | +| [Apache Hive](/docs/databases/hive) | `pip install pyhive` | `hive://hive@{hostname}:{port}/{database}` | +| [Apache Impala](/docs/databases/impala) | `pip install impyla` | `impala://{hostname}:{port}/{database}` | +| [Apache Kylin](/docs/databases/kylin) | `pip install kylinpy` | `kylin://:@:/?=&=` | +| [Apache Pinot](/docs/databases/pinot) | `pip install pinotdb` | `pinot://BROKER:5436/query?server=http://CONTROLLER:5983/` | +| [Apache Solr](/docs/databases/solr) | `pip install sqlalchemy-solr` | `solr://{username}:{password}@{hostname}:{port}/{server_path}/{collection}` | +| [Apache Spark SQL](/docs/databases/spark-sql) | `pip install pyhive` | `hive://hive@{hostname}:{port}/{database}` | +| [Ascend.io](/docs/databases/ascend) | `pip install impyla` | `ascend://{username}:{password}@{hostname}:{port}/{database}?auth_mechanism=PLAIN;use_ssl=true` | +| [Azure MS SQL](/docs/databases/sql-server) | `pip install pymssql` | `mssql+pymssql://UserName@presetSQL:TestPassword@presetSQL.database.windows.net:1433/TestSchema` | +| [Big Query](/docs/databases/bigquery) | `pip install pybigquery` | `bigquery://{project_id}` | +| [ClickHouse](/docs/databases/clickhouse) | `pip install clickhouse-driver==0.2.0 && pip install clickhouse-sqlalchemy==0.1.6` | `clickhouse+native://{username}:{password}@{hostname}:{port}/{database}` | +| [CockroachDB](/docs/databases/cockroachdb) | `pip install cockroachdb` | `cockroachdb://root@{hostname}:{port}/{database}?sslmode=disable` | +| [Dremio](/docs/databases/dremio) | `pip install sqlalchemy_dremio` | `dremio://user:pwd@host:31010/` | +| [Elasticsearch](/docs/databases/elasticsearch) | `pip install elasticsearch-dbapi` | `elasticsearch+http://{user}:{password}@{host}:9200/` | +| [Exasol](/docs/databases/exasol) | `pip install sqlalchemy-exasol` | `exa+pyodbc://{username}:{password}@{hostname}:{port}/my_schema?CONNECTIONLCALL=en_US.UTF-8&driver=EXAODBC` | +| [Google Sheets](/docs/databases/google-sheets) | `pip install shillelagh[gsheetsapi]` | `gsheets://` | +| [Firebolt](/docs/databases/firebolt) | `pip install firebolt-sqlalchemy` | `firebolt://{username}:{password}@{database} or firebolt://{username}:{password}@{database}/{engine_name}` | +| [Hologres](/docs/databases/hologres) | `pip install psycopg2` | `postgresql+psycopg2://:@/` | +| [IBM Db2](/docs/databases/ibm-db2) | `pip install ibm_db_sa` | `db2+ibm_db://` | +| [IBM Netezza Performance Server](/docs/databases/netezza) | `pip install nzalchemy` | `netezza+nzpy://:@/` | +| [MySQL](/docs/databases/mysql) | `pip install mysqlclient` | `mysql://:@/` | +| [Oracle](/docs/databases/oracle) | `pip install cx_Oracle` | `oracle://` | +| [PostgreSQL](/docs/databases/postgres) | `pip install psycopg2` | `postgresql://:@/` | +| [Trino](/docs/databases/trino) | `pip install sqlalchemy-trino` | `trino://{username}:{password}@{hostname}:{port}/{catalog}` | +| [Presto](/docs/databases/presto) | `pip install pyhive` | `presto://` | +| [SAP Hana](/docs/databases/hana) | `pip install hdbcli sqlalchemy-hana or pip install apache-superset[hana]` | `hana://{username}:{password}@{host}:{port}` | +| [Snowflake](/docs/databases/snowflake) | `pip install snowflake-sqlalchemy` | `snowflake://{user}:{password}@{account}.{region}/{database}?role={role}&warehouse={warehouse}` | +| SQLite | | `sqlite://` | +| [SQL Server](/docs/databases/sql-server) | `pip install pymssql` | `mssql://` | +| [Teradata](/docs/databases/teradata) | `pip install sqlalchemy-teradata` | `teradata://{user}:{password}@{host}` | +| [Vertica](/docs/databases/vertica) | `pip install sqlalchemy-vertica-python` | `vertica+vertica_python://:@/` | + +--- + +Note that many other databases are supported, the main criteria being the existence of a functional +SQLAlchemy dialect and Python driver. Searching for the keyword "sqlalchemy + (database name)" +should help get you to the right place. + +If your database or data engine isn't on the list but a SQL interface +exists, please file an issue on the +[Superset GitHub repo](https://github.com/apache/superset/issues), so we can work on documenting and +supporting it. + +[StackOverflow](https://stackoverflow.com/questions/tagged/apache-superset+superset) and the +[Superset community Slack](https://join.slack.com/t/apache-superset/shared_invite/zt-uxbh5g36-AISUtHbzOXcu0BIj7kgUaw) +are great places to get help with connecting to databases in Superset. diff --git a/docs/docs/connecting-to-databases/kylin.mdx b/docs/docs/databases/kylin.mdx similarity index 100% rename from docs/docs/connecting-to-databases/kylin.mdx rename to docs/docs/databases/kylin.mdx diff --git a/docs/docs/connecting-to-databases/mysql.mdx b/docs/docs/databases/mysql.mdx similarity index 100% rename from docs/docs/connecting-to-databases/mysql.mdx rename to docs/docs/databases/mysql.mdx diff --git a/docs/docs/connecting-to-databases/netezza.mdx b/docs/docs/databases/netezza.mdx similarity index 100% rename from docs/docs/connecting-to-databases/netezza.mdx rename to docs/docs/databases/netezza.mdx diff --git a/docs/docs/connecting-to-databases/oracle.mdx b/docs/docs/databases/oracle.mdx similarity index 100% rename from docs/docs/connecting-to-databases/oracle.mdx rename to docs/docs/databases/oracle.mdx diff --git a/docs/docs/connecting-to-databases/pinot.mdx b/docs/docs/databases/pinot.mdx similarity index 100% rename from docs/docs/connecting-to-databases/pinot.mdx rename to docs/docs/databases/pinot.mdx diff --git a/docs/docs/connecting-to-databases/postgres.mdx b/docs/docs/databases/postgres.mdx similarity index 100% rename from docs/docs/connecting-to-databases/postgres.mdx rename to docs/docs/databases/postgres.mdx diff --git a/docs/docs/connecting-to-databases/presto.mdx b/docs/docs/databases/presto.mdx similarity index 100% rename from docs/docs/connecting-to-databases/presto.mdx rename to docs/docs/databases/presto.mdx diff --git a/docs/docs/connecting-to-databases/redshift.mdx b/docs/docs/databases/redshift.mdx similarity index 100% rename from docs/docs/connecting-to-databases/redshift.mdx rename to docs/docs/databases/redshift.mdx diff --git a/docs/docs/connecting-to-databases/rockset.mdx b/docs/docs/databases/rockset.mdx similarity index 100% rename from docs/docs/connecting-to-databases/rockset.mdx rename to docs/docs/databases/rockset.mdx diff --git a/docs/docs/connecting-to-databases/snowflake.mdx b/docs/docs/databases/snowflake.mdx similarity index 100% rename from docs/docs/connecting-to-databases/snowflake.mdx rename to docs/docs/databases/snowflake.mdx diff --git a/docs/docs/connecting-to-databases/solr.mdx b/docs/docs/databases/solr.mdx similarity index 100% rename from docs/docs/connecting-to-databases/solr.mdx rename to docs/docs/databases/solr.mdx diff --git a/docs/docs/connecting-to-databases/spark-sql.mdx b/docs/docs/databases/spark-sql.mdx similarity index 100% rename from docs/docs/connecting-to-databases/spark-sql.mdx rename to docs/docs/databases/spark-sql.mdx diff --git a/docs/docs/connecting-to-databases/sql-server.mdx b/docs/docs/databases/sql-server.mdx similarity index 100% rename from docs/docs/connecting-to-databases/sql-server.mdx rename to docs/docs/databases/sql-server.mdx diff --git a/docs/docs/connecting-to-databases/teradata.mdx b/docs/docs/databases/teradata.mdx similarity index 100% rename from docs/docs/connecting-to-databases/teradata.mdx rename to docs/docs/databases/teradata.mdx diff --git a/docs/docs/connecting-to-databases/trino.mdx b/docs/docs/databases/trino.mdx similarity index 100% rename from docs/docs/connecting-to-databases/trino.mdx rename to docs/docs/databases/trino.mdx diff --git a/docs/docs/connecting-to-databases/vertica.mdx b/docs/docs/databases/vertica.mdx similarity index 100% rename from docs/docs/connecting-to-databases/vertica.mdx rename to docs/docs/databases/vertica.mdx diff --git a/docs/docs/frequently-asked-questions.mdx b/docs/docs/frequently-asked-questions.mdx index 85a89997f739b..367c32682a010 100644 --- a/docs/docs/frequently-asked-questions.mdx +++ b/docs/docs/frequently-asked-questions.mdx @@ -42,7 +42,7 @@ We recommend reading the instructions in ### Can I upload and visualize CSV data? -Absolutely! Read the instructions [here](/docs/Creating Charts and Dashboards/exploring-data) to learn +Absolutely! Read the instructions [here](/docs/creating-charts-dashboards/exploring-data) to learn how to enable and use CSV upload. ### Why are my queries timing out? @@ -231,7 +231,7 @@ Metadata attribute using the `label_colors` key. ### Does Superset work with [insert database engine here]? -The [Connecting to Databases section](/docs/connecting-to-databases/installing-database-drivers) provides the best +The [Connecting to Databases section](/docs/databases/installing-database-drivers) provides the best overview for supported databases. Database engines not listed on that page may work too. We rely on the community to contribute to this knowledge base. diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index 1a147523bc082..f577145c736bf 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -54,11 +54,11 @@ const config = { from: '/tutorials.html', }, { - to: '/docs/Creating Charts and Dashboards/creating-your-first-dashboard', + to: '/docs/creating-charts-dashboards/creating-your-first-dashboard', from: '/admintutorial.html', }, { - to: '/docs/Creating Charts and Dashboards/creating-your-first-dashboard', + to: '/docs/creating-charts-dashboards/creating-your-first-dashboard', from: '/usertutorial.html', }, { @@ -74,7 +74,7 @@ const config = { from: '/gallery.html', }, { - to: '/docs/connecting-to-databases/druid', + to: '/docs/databases/druid', from: '/druid.html', }, { @@ -94,9 +94,17 @@ const config = { from: '/faq.html', }, { - to: '/docs/Creating Charts and Dashboards/creating-your-first-dashboard', + to: '/docs/creating-charts-dashboards/creating-your-first-dashboard', from: '/tutorial.html', }, + { + to: '/docs/creating-charts-dashboards/creating-your-first-dashboard', + from: '/docs/creating-charts-dashboards/first-dashboard', + }, + { + to: '/docs/api', + from: '/docs/rest-api', + }, { to: '/docs/installation/alerts-reports', from: '/docs/installation/email-reports', @@ -105,6 +113,10 @@ const config = { to: '/docs/intro', from: '/docs/roadmap', }, + { + to: '/docs/contributing/contributing-page', + from: '/docs/contributing/contribution-guidelines', + }, ], }, ], diff --git a/docs/src/pages/index.tsx b/docs/src/pages/index.tsx index 1c598365898bd..c4912012641f0 100644 --- a/docs/src/pages/index.tsx +++ b/docs/src/pages/index.tsx @@ -448,7 +448,7 @@ export default function Home(): JSX.Element { ... and many other - + {' '} compatible databases {' '}