From 5f5b8fca76bc947b43f4be2e0ba3e5d3a5c006ef Mon Sep 17 00:00:00 2001 From: PlanetScale Actions Bot Date: Thu, 12 Oct 2023 20:20:20 +0000 Subject: [PATCH] docs: upstream https://github.com/planetscale/www/commit/25dff6835d0ddd75c49a216fde4b39599f9f2735 --- docs/concepts/planetscale-plans.md | 46 ++++++++++----------- docs/concepts/planetscale-workflow.md | 8 ++-- docs/onboarding/connect-to-your-database.md | 2 +- docs/reference/mysql-compatibility.md | 4 +- 4 files changed, 29 insertions(+), 31 deletions(-) diff --git a/docs/concepts/planetscale-plans.md b/docs/concepts/planetscale-plans.md index a6b146f0..75939a16 100644 --- a/docs/concepts/planetscale-plans.md +++ b/docs/concepts/planetscale-plans.md @@ -16,29 +16,29 @@ Self-serve is comprised of three plans that you can sign up for from the PlanetS ### Usage-based plans -| | **Hobby** | **Scaler** | -| ---------------------------------------------------------------------------- | -------------- | ---------------------- | -| **Storage/month** | 5 GB | 10 GB\* | -| **Row reads/month** | 1 billion | 100 billion\* | -| **Row writes/month** | 10 million | 50 million\* | -| **Available cluster sizes** | 1 | 1 | -| **Availability zones** | 1 | 2 | -| **Production branches** | 1 per database | 2 per database | -| **Development branches** | 1 per database | 5 per database | -| **Concurrent connections** | 1,000 | 10,000 | -| **Query Insights retention** | 24 hours | 7 days | -| **Horizontal sharding** | Not included | Not included | -| [**Deployment options**](/docs/concepts/deployment-options) | Multi-tenant | Multi-tenant | -| **Read only regions** | Not included | Included | -| **Web console** | Included | Included | -| **PlanetScale CLI** | Included | Included | -| **SSO** | Not included | Available as an add-on | -| **Audit log retention** | 5 days | 15 days | -| **Automatic backups** | Daily | Every 12 hours | -| **Support** | Community | Standard | -| [**Data Branching®**](/docs/concepts/data-branching) | Not included | Not included | -| **Monthly cost** | $0 | $29 per database | -| [**PlanetScale Boost**](/docs/concepts/query-caching-with-planetscale-boost) | Not included | Available as an add-on | +| | **Hobby** | **Scaler** | +| ---------------------------------------------------------------------------- | ------------------------ | ---------------------- | +| **Storage/month** | 5 GB | 10 GB\* | +| **Row reads/month** | 1 billion | 100 billion\* | +| **Row writes/month** | 10 million | 50 million\* | +| **Available cluster sizes** | 1 | 1 | +| **Availability zones** | 1 | 2 | +| **Production branches** | 1 per database | 2 per database | +| **Development branches** | 1 per database | 5 per database | +| **Concurrent connections** | 1,000 | 10,000 | +| **Query Insights retention** | 24 hours | 7 days | +| **Horizontal sharding** | Not included | Not included | +| [**Deployment options**](/docs/concepts/deployment-options) | Multi-tenant | Multi-tenant | +| **Read only regions** | Not included | Included | +| **Web console** | Included | Included | +| **PlanetScale CLI** | Included | Included | +| **SSO** | Not included | Available as an add-on | +| **Audit log retention** | 5 days | 15 days | +| **Automatic backups** | Daily | Every 12 hours | +| **Support** | Community | Standard | +| [**Data Branching®**](/docs/concepts/data-branching) | Not included | Not included | +| **Monthly cost** | $0 (limit of 1 database) | $29 per database | +| [**PlanetScale Boost**](/docs/concepts/query-caching-with-planetscale-boost) | Not included | Available as an add-on | ### Resource-based plan diff --git a/docs/concepts/planetscale-workflow.md b/docs/concepts/planetscale-workflow.md index 02daa7bc..047f3e82 100644 --- a/docs/concepts/planetscale-workflow.md +++ b/docs/concepts/planetscale-workflow.md @@ -1,16 +1,14 @@ --- title: 'The PlanetScale workflow' subtitle: 'Use the PlanetScale workflow for branching databases, non-blocking schema changes and more.' -date: '2023-04-05' +date: '2023-10-12' --- ![Diagram showing PlanetScale workflow {priority}](/assets/docs/planetscale-workflow.png) -## Serverless databases +PlanetScale databases are designed for developers and developer workflows. Deploy a fully managed database cluster with the reliability of MySQL (our databases run on MySQL `8.0.23`) and the scale of open source Vitess in just minutes. -PlanetScale databases are designed for developers and developer workflows. Deploy a fully managed database with the reliability of MySQL (our databases run on MySQL 8.0) and the scale of open source Vitess in just ten seconds. - -Deploy, branch, and query your database directly from the UI, or download our [CLI](https://github.com/planetscale/cli#installation) and run commands there. +Deploy, branch, and query your database directly from the UI, download our [CLI](https://github.com/planetscale/cli#installation) and run commands there, or automate your deployments using our [GitHub Actions](/docs/devops/github-actions) and [API](https://api-docs.planetscale.com/reference/getting-started-with-planetscale-api). Built-in connection pooling means you’ll never run into connection limits for your database. diff --git a/docs/onboarding/connect-to-your-database.md b/docs/onboarding/connect-to-your-database.md index fe2d0094..f7e21a08 100644 --- a/docs/onboarding/connect-to-your-database.md +++ b/docs/onboarding/connect-to-your-database.md @@ -32,7 +32,7 @@ Selecting any of these options not only provides the connection string specific Connection strings allow your application to securely connect to PlanetScale, but since branches are effectively separate copies of your database, it’s important to know how to generate a connection string for the branch you want to connect to. In the above section, we generated a connection string from the Overview tab of the database. This will create a connection string to the default `main` branch, which is our production database. -When you're working in development, you'll want to connect your dev (local or staging) application to a PlanetScale development branch. To create a connection string for another branch, simply navigate to the branch, and click the Connect button from the overview tab of that branch. +When you're working in development, you'll want to connect your dev (local or staging) application to a PlanetScale development branch. To create a connection string for another branch, simply navigate to the branch, and click the Connect button from the overview tab of that branch. If you already have existing credentials that you've created in the past, those will be listed below (excluding the password). If you need to generate new credentials, click "New password". ## What's next? diff --git a/docs/reference/mysql-compatibility.md b/docs/reference/mysql-compatibility.md index 2d9cbb50..694c7643 100644 --- a/docs/reference/mysql-compatibility.md +++ b/docs/reference/mysql-compatibility.md @@ -1,14 +1,14 @@ --- title: 'MySQL compatibility' subtitle: 'Learn what MySQL syntax, functions, and more are supported by PlanetScale' -date: '2022-09-23' +date: '2023-10-12' --- ## Overview PlanetScale is built on top of open-source Vitess, a database clustering system for horizontal scaling of MySQL. Consequently, PlanetScale is only compatible with MySQL databases. -If you're [importing an existing database](/docs/imports/database-imports), PlanetScale supports MySQL database versions `5.7` through `8.0`. +PlanetScale databases run on MySQL `8.0.23`. If you're [importing an existing database](/docs/imports/database-imports), PlanetScale supports MySQL database versions `5.7` through `8.0`. New PlanetScale databases are created on MySQL 8 with character set `utf8mb4_0900_ai_ci`. PlanetScale supports `utf8`, `utf8mb4`, and `utf8mb3`, character sets. We also support `latin1` and `ascii` character sets, but do not recommend them.