thomasgauvin: add docs for postgres planetscale

Author: thomasgauvin

src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-database-providers/planetscale-postgres.mdx

@@ -0,0 +1,15 @@
+---
+type: example
+summary: Connect Hyperdrive to a PlanetScale PostgreSQL database.
+pcx_content_type: example
+title: PlanetScale
+sidebar:
+  order: 8
+description: Connect Hyperdrive to a PlanetScale PostgreSQL database.
+---
+
+import { Render } from "~/components";
+
+This example shows you how to connect Hyperdrive to a [PlanetScale](https://planetscale.com/) PostgreSQL database.
+
+<Render file="planetscale-postgres-partial" />

src/content/partials/hyperdrive/planetscale-postgres-partial.mdx

@@ -0,0 +1,29 @@
+---
+{}
+---
+
+import { Render } from "~/components";
+
+## 1. Allow Hyperdrive access
+
+You can connect Hyperdrive to any existing PlanetScale PostgreSQL database by creating a new user (optional) and retrieving a connection string to your database.
+
+### PlanetScale Dashboard
+
+1. Go to the [**PlanetScale dashboard**](https://app.planetscale.com/) and select the Postgres database you wish to connect to.
+2. Click **Connect**. Enter `hyperdrive-user` as the password name (or your preferred name) and configure the permissions as desired. Select **Create password**. Note the username and password as they will not be displayed again.
+3. Select **Other** as your language or framework. Note down the database host, database name, database username, and password. You will need these to create a database configuration in Hyperdrive.
+
+With the host, database name, username and password, you can now create a Hyperdrive database configuration.
+
+## 2. Create a database configuration
+
+<Render file="create-hyperdrive-config" product="hyperdrive" />
+
+:::note
+
+When connecting to a PlanetScale PostgreSQL database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/) to connect directly to the underlying database instead of the [PlanetScale serverless driver](https://planetscale.com/docs/tutorials/planetscale-serverless-driver). Hyperdrive is optimized for database access for Workers and will perform global connection pooling and fast query routing by connecting directly to your database.
+
+:::
+
+<Render file="create-hyperdrive-config-next-steps" product="hyperdrive" />