clarify that support for mysql-compatible databases in work in progress

Author: thomasgauvin

src/content/docs/hyperdrive/configuration/how-hyperdrive-works.mdx

@@ -58,7 +58,7 @@ Hyperdrive supports [`SET` statements](https://www.postgresql.org/docs/current/s
 
 This implies that a single Worker invocation may obtain multiple connections to perform its database operations and may need to `SET` any configurations for every query or transaction. It is not recommended to wrap multiple database operations with a single transaction to maintain the `SET` state. Doing so will affect the performance and scaling of Hyperdrive as the connection cannot be reused by other Worker isolates for the duration of the transaction.
 
-Hyperdrive supports named prepared statements as implemented in the `postgres.js` and `node-postgres` drivers. Named prepared statements in other drivers may have worse performance.
+Hyperdrive supports named prepared statements as implemented in the `postgres.js` and `node-postgres` drivers. Named prepared statements in other drivers may have worse performance or may not be supported.
 
 ## Related resources
 

src/content/docs/hyperdrive/examples/connect-to-mysql/aws-rds-aurora.mdx

@@ -1,16 +1,16 @@
 ---
 type: example
-summary: Connect Hyperdrive to an AWS RDS or Aurora database instance.
+summary: Connect Hyperdrive to an AWS RDS database instance.
 pcx_content_type: example
-title: AWS RDS and Aurora
+title: AWS
 sidebar:
   order: 14
-description: Connect Hyperdrive to an AWS RDS or Aurora database instance.
+description: Connect Hyperdrive to an AWS RDS database instance.
 ---
 
 import { Render } from "~/components";
 
-This example shows you how to connect Hyperdrive to an Amazon Relational Database Service (Amazon RDS) Postgres or Amazon Aurora database instance.
+This example shows you how to connect Hyperdrive to an Amazon Relational Database Service (Amazon RDS) MySQL database instance.
 
 ## 1. Allow Hyperdrive access
 
@@ -22,29 +22,20 @@ To allow Hyperdrive to connect to your database, you will need to ensure that Hy
 
 When creating or modifying an instance in the AWS console:
 
-1. Configure a **DB cluster identifier** and other settings you wish to customize.
-2. Under **Settings** > **Credential settings**, note down the **Master username** and **Master password** (Aurora only).
-3. Under the **Connectivity** header, ensure **Public access** is set to **Yes**.
-4. Select an **Existing VPC security group** that allows public Internet access from `0.0.0.0/0` to the port your database instance is configured to listen on (default: `5432` for PostgreSQL instances).
-5. Select **Create database**.
+1. Configure a **database cluster** and other settings you wish to customize.
+2. Under the **Connectivity** header, ensure **Public access** is set to **Yes**.
+3. Select an **Existing VPC security group** that allows public Internet access from `0.0.0.0/0` to the port your database instance is configured to listen on (default: `5432` for PostgreSQL instances).
+4. Select **Create database**.
 
 :::caution
 
 You must ensure that the [VPC security group](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) associated with your database allows public IPv4 access to your database port.
 
-Refer to AWS' [database server rules](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-db-server) for details on how to configure rules specific to your RDS or Aurora database.
+Refer to AWS' [database server rules](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-db-server) for details on how to configure rules specific to your RDS database.
 
 :::
 
-### Retrieve the database endpoint (Aurora)
-
-To retrieve the database endpoint (hostname) for Hyperdrive to connect to:
-
-1. Go to **Databases** view under **RDS** in the AWS console.
-2. Select the database you want Hyperdrive to connect to.
-3. Under the **Endpoints** header, note down the **Endpoint name** with the type `Writer` and the **Port**.
-
-### Retrieve the database endpoint (RDS PostgreSQL)
+### Retrieve the database endpoint (RDS MySQL)
 
 For regular RDS instances (non-Aurora), you will need to fetch the endpoint and port of the database:
 
@@ -54,6 +45,12 @@ For regular RDS instances (non-Aurora), you will need to fetch the endpoint and
 
 The endpoint will resemble `YOUR_DATABASE_NAME.cpuo5rlli58m.AWS_REGION.rds.amazonaws.com` and the port will default to `5432`.
 
+:::note[Support for MySQL-compatible providers]
+
+Support for AWS Aurora MySQL databases is coming soon. Join our early preview support by reaching out to us in the [Hyperdrive Discord channel](https://discord.cloudflare.com/).
+
+:::
+
 ## 2. Create your user
 
 Once your database is created, you will need to create a user for Hyperdrive to connect as. Although you can use the **Master username** configured during initial database creation, best practice is to create a less privileged user.

src/content/docs/hyperdrive/get-started.mdx

@@ -21,7 +21,9 @@ This guide will instruct you through:
 
 :::note
 
-Hyperdrive currently works with PostgreSQL, MySQL and compatible databases. This includes CockroachDB and Materialize (which are PostgreSQL-compatible), and MariaDB and Planetscale (which are MySQL compatible).
+Hyperdrive currently works with PostgreSQL, MySQL and many compatible databases. This includes CockroachDB and Materialize (which are PostgreSQL-compatible), and Planetscale.
+
+Learn more about the [databases that Hyperdrive supports](/hyperdrive/reference/supported-databases-and-features).
 
 :::
 
@@ -110,13 +112,14 @@ Hyperdrive accepts the combination of these parameters in the common connection
 
     	```
 
-			Most database providers will provide a connection string you can directly copy-and-paste directly into Hyperdrive.
+    		Most database providers will provide a connection string you can directly copy-and-paste directly into Hyperdrive.
 
 To create a Hyperdrive connection, run the `wrangler` command, replacing the placeholder values passed to the `--connection-string` flag with the values of your existing database:
 
 ```sh
 npx wrangler hyperdrive create <YOUR_CONFIG_NAME> --connection-string="postgres://user:password@HOSTNAME_OR_IP_ADDRESS:PORT/database_name"
 ```
+
     </TabItem>
     <TabItem label="MySQL">
     	```txt
@@ -125,19 +128,18 @@ npx wrangler hyperdrive create <YOUR_CONFIG_NAME> --connection-string="postgres:
 
     	```
 
-			Most database providers will provide a connection string you can directly copy-and-paste directly into Hyperdrive.
+    		Most database providers will provide a connection string you can directly copy-and-paste directly into Hyperdrive.
 
-			To create a Hyperdrive connection, run the `wrangler` command, replacing the placeholder values passed to the `--connection-string` flag with the values of your existing database:
+    		To create a Hyperdrive connection, run the `wrangler` command, replacing the placeholder values passed to the `--connection-string` flag with the values of your existing database:
 
 ```sh
 npx wrangler hyperdrive create <YOUR_CONFIG_NAME> --connection-string="mysql://user:password@HOSTNAME_OR_IP_ADDRESS:PORT/database_name"
 ```
+
     </TabItem>
 
 </Tabs>
 
-
-
 :::note[Manage caching]
 By default, Hyperdrive will cache query results. If you wish to disable caching, pass the flag `--caching-disabled`.
 
@@ -226,7 +228,7 @@ export interface Env {
 
 export default {
 	async fetch(request, env, ctx): Promise<Response> {
-		// Create a connection using the Postgres.js driver (or any support driver, ORM or query builder)
+		// Create a connection using the Postgres.js driver (or any supported driver, ORM or query builder)
 		// with the Hyperdrive credentials. These credentials are only accessible from your Worker.
 		const sql = postgres(env.HYPERDRIVE.connectionString, {
 			// Workers limit the number of concurrent external connections, so be sure to limit

src/content/docs/hyperdrive/index.mdx

@@ -32,7 +32,7 @@ Turn your existing regional database into a globally distributed database.
 
 Hyperdrive is a service that accelerates queries you make to existing databases, making it faster to access your data from across the globe from [Cloudflare Workers](/workers/), irrespective of your users' location.
 
-Hyperdrive supports any Postgres or MySQL database, including those hosted on AWS, Google Cloud, Azure, and Neon. Hyperdrive also supports Postgres-compatible databases like CockroachDB and Timescale and MySQL-compatible databases like MariaDB and Planetscale.
+Hyperdrive supports any Postgres or MySQL database, including those hosted on AWS, Google Cloud, Azure, Neon and Planetscale. Hyperdrive also supports Postgres-compatible databases like CockroachDB and Timescale.
 You do not need to write new code or replace your favorite tools: Hyperdrive works with your existing code and tools you use.
 
 Use Hyperdrive's connection string from your Cloudflare Workers application with your existing Postgres drivers and object-relational mapping (ORM) libraries:
@@ -180,7 +180,7 @@ Hyperdrive allows you to connect to any PostgreSQL or PostgreSQL-compatible data
 
 <Feature header="MySQL support" href="/hyperdrive/examples/connect-to-mysql/" cta="Connect Hyperdrive to your MySQL database">
 
-Hyperdrive allows you to connect to any MySQL or MySQL-compatible database.
+Hyperdrive allows you to connect to any MySQL database.
 
 </Feature>
 

src/content/docs/hyperdrive/reference/supported-databases-and-features.mdx

@@ -29,6 +29,12 @@ The following is a non-exhaustive list of database providers:
 | CockroachDB     | ✅        | All                      | Postgres-compatible. Refer to the [CockroachDB](/hyperdrive/examples/connect-to-postgres/cockroachdb/) guide to connect. |
 | Planetscale     | ✅        | All                      | Planetscale currently runs MySQL 8.x                                                                                     |
 
+:::note[Support for MySQL-compatible providers]
+
+Support for AWS Aurora MySQL and MariaDB databases is coming soon. Join our early preview support by reaching out to us in the [Hyperdrive Discord channel](https://discord.cloudflare.com/).
+
+:::
+
 ## Supported PostgreSQL authentication modes
 
 Hyperdrive supports the following [authentication modes](https://www.postgresql.org/docs/current/auth-methods.html) for connecting to PostgreSQL databases:
@@ -54,7 +60,7 @@ Hyperdrive does not support the following MySQL features:
 - Non-UTF8 characters in queries
 - `USE` statements
 - Multi-statement queries
-- Prepared statement queries via SQL (using `PREPARE` and `EXECUTE` statements)
+- Prepared statement queries via SQL (using `PREPARE` and `EXECUTE` statements) and [protocol-level prepared statements](https://sidorares.github.io/node-mysql2/docs/documentation/prepared-statements).
 - `COM_INIT_DB` messages
 - [Authentication plugins](https://dev.mysql.com/doc/refman/8.4/en/authentication-plugins.html) other than `caching_sha2_password` or `mysql_native_password`