chore(deps): Migrate from `crate[sqlalchemy]` to `sqlalchemy-cratedb` (#29243)

docs/docs/configuration/databases.mdx

@@ -394,21 +394,33 @@ couchbase://{username}:{password}@{hostname}:{port}?truststorepath={certificate
 
 #### CrateDB
 
-The recommended connector library for CrateDB is
+The connector library for CrateDB is [sqlalchemy-cratedb].
-[crate](https://pypi.org/project/crate/).
+We recommend to add the following item to your `requirements.txt` file:
-You need to install the extras as well for this library.
-We recommend adding something like the following
-text to your requirements file:
-
 ```
-crate[sqlalchemy]==0.26.0
+sqlalchemy-cratedb>=0.40.1,<1
 ```
 
-The expected connection string is formatted as follows:
+An SQLAlchemy connection string for [CrateDB Self-Managed] on localhost,
-
+for evaluation purposes, looks like this:
 ```
 crate://crate@127.0.0.1:4200
 ```
+An SQLAlchemy connection string for connecting to [CrateDB Cloud] looks like
+this:
+```
+crate://<username>:<password>@<clustername>.cratedb.net:4200/?ssl=true
+```
+
+Follow the steps [here](/docs/configuration/databases#installing-database-drivers)
+to install the CrateDB connector package when setting up Superset locally using
+Docker Compose.
+```
+echo "sqlalchemy-cratedb" >> ./docker/requirements-local.txt
+```
+
+[CrateDB Cloud]: https://cratedb.com/product/cloud
+[CrateDB Self-Managed]: https://cratedb.com/product/self-managed
+[sqlalchemy-cratedb]: https://pypi.org/project/sqlalchemy-cratedb/
 
 
 #### Databend

pyproject.toml

@@ -112,7 +112,7 @@ bigquery = [
 clickhouse = ["clickhouse-connect>=0.5.14, <1.0"]
 cockroachdb = ["cockroachdb>=0.3.5, <0.4"]
 cors = ["flask-cors>=2.0.0"]
-crate = ["crate[sqlalchemy]>=0.26.0, <0.27"]
+crate = ["sqlalchemy-cratedb>=0.40.1, <1"]
 databend = ["databend-sqlalchemy>=0.3.2, <1.0"]
 databricks = [
     "databricks-sql-connector>=2.0.2, <3",