You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 12, 2024. It is now read-only.
Copy file name to clipboardexpand all lines: docs/concepts/cluster-configuration.md
+7-11
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: 'Cluster configuration'
3
3
subtitle: 'Create and manage sharded and unsharded keyspaces for your database.'
4
-
date: '2024-09-20'
4
+
date: '2024-11-07'
5
5
---
6
6
7
7
{% callout type="warning" %}
@@ -23,15 +23,11 @@ These are advanced configuration settings that expose some of the underlying Vit
23
23
24
24
This documentation will cover how to use everything in this cluster configuration page. For a full walkthrough with an example of setting up a sharded keyspace, refer to the [Sharding quickstart](/docs/sharding/sharding-quickstart).
25
25
26
-
## Limitations
27
-
28
-
Before you adjust any cluster configuration settings, it is important that you read through the following limitations:
29
-
30
-
- This feature can currently only be used to shard **new** tables.
31
-
- If you are an existing PlanetScale customer with already sharded tables, you can use the Cluster configuration settings to adjust the instance size, number of replicas, and VSchema for **already sharded tables**.
32
-
- Sharded keyspaces are not currently supported on databases that have foreign key constraints enabled.
26
+
{% callout type="note" %}
27
+
harded keyspaces are not currently supported on databases that have foreign key constraints enabled.
28
+
{% /callout %}
33
29
34
-
If you have existing tables that need sharding, or if you would like additional support from our expert team, our [Enterprise plan](/docs/concepts/planetscale-plans#planetscale-enterprise-plan) may be a good fit. [Get in touch](/contact) for a quick assessment.
30
+
If you would like additional support from our expert team, our [Enterprise plan](/docs/concepts/planetscale-plans#planetscale-enterprise-plan) may be a good fit. [Get in touch](/contact) for a quick assessment.
35
31
36
32
## Create a keyspace
37
33
@@ -41,8 +37,8 @@ To create a new [keyspace](/docs/sharding/keyspaces):
41
37
2. Click "Cluster configuration" in the left nav.
42
38
3. You should see the existing unsharded keyspace for your database here.
43
39
4. Click "New keyspace".
44
-
5. Enter the keyspace name. For example, if your existing unsharded keyspace is named `books`, you may create a sharded keyspace named `books-sharded`.
45
-
6. Select whether you want to keep it unsharded, or, if not, select the number of shards you want to exist in this keyspace. In most cases, you will be adding a new sharded keyspace. Adding a new unsharded keyspace is not a common use case.
40
+
5. Enter the keyspace name. For example, if your existing unsharded keyspace is named `metal`, you may create a sharded keyspace named `metal-sharded`.
41
+
6. Select whether you want to keep it unsharded, or, if not, select the number of shards you want to exist in this keyspace. In most cases, you will be adding a new sharded keyspace. Adding a new unsharded keyspace is not a common use case, but is an option if you're looking to do [vertical sharding](/learn/courses/database-scaling/sharding/vertical-sharding).
46
42
47
43
{% callout type="note" %}
48
44
The cost of adding this additional keyspace largely depends on the number of shards you choose, the cluster size, and if you'd like to add additional replicas.
Copy file name to clipboardexpand all lines: docs/concepts/cluster-sizing.md
+3-2
Original file line number
Diff line number
Diff line change
@@ -42,5 +42,6 @@ When you choose to change cluster size, we upgrade each of your replicas one by
42
42
43
43
## Sharding
44
44
45
-
If you are an Enterprise customer, another way you can scale your database is with **sharding**.
46
-
Check out our [sharding documentation](/docs/sharding/overview) for more information.
45
+
You can create sharded keyspaces on any plan by adding a new sharded keyspace using the [cluster configuration page](/docs/concepts/cluster-configuration) and running an [unsharded to sharded workflow](/docs/sharding/sharding-quickstart) in your dashboard.
46
+
47
+
If you would like additional support from our expert team, our [Enterprise plan](/docs/concepts/planetscale-plans#planetscale-enterprise-plan) may be a good fit. [Get in touch](/contact) for a quick assessment.
Copy file name to clipboardexpand all lines: docs/concepts/what-is-planetscale.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -62,7 +62,7 @@ PlanetScale allows you to break up a monolithic database and partition the data
62
62
63
63
Another scenario that companies with massive databases often run into is connection limits due to MySQL. With PlanetScale, we can support [nearly infinite connections](/blog/one-million-connections). Vitess offers built-in [connection pooling](https://vitess.io/docs/reference/features/connection-pools/), and we've built our own [edge infrastructure](/blog/introducing-the-planetscale-serverless-driver-for-javascript) into PlanetScale to ensure connection limits are never an issue.
64
64
65
-
We generally recommend exploring horizontal sharding when your database exceeds 250 GB of data and you are beginning to feel some of the [pains associated with large scale](/blog/how-to-scale-your-database-and-when-to-shard-mysql). [Sharding](/docs/concepts/cluster-configuration) is offered on our Scaler Pro plan (currently only supported for new tables). If you need assistance with with setting up horizontal sharding, migrating to PlanetScale, or want enterprise-level SLAs, we offer this through our [Enterprise plan](/enterprise) option. [Please reach out](/contact) for more information.
65
+
We generally recommend exploring horizontal sharding when your database exceeds 250 GB of data and you are beginning to feel some of the [pains associated with large scale](/blog/how-to-scale-your-database-and-when-to-shard-mysql). [Sharding](/docs/concepts/cluster-configuration) is offered on our Scaler Pro plan. If you need assistance with with setting up horizontal sharding, migrating to PlanetScale, or want enterprise-level SLAs, we offer this through our [Enterprise plan](/enterprise) option. [Please reach out](/contact) for more information.
subtitle: 'Learn how to use PlanetScale workflows to run different sequences to move data between keyspaces.'
4
+
label: 'Beta feature'
5
+
date: '2024-11-07'
6
+
---
7
+
8
+
PlanetScale workflows (currently in beta) provide pre-defined recipes that make it simple to run operations on your databases. There is currently only one workflow available —[moving tables from an unsharded to a sharded keyspace](/docs/sharding/sharding-quickstart), but we will continue to add more workflow options in the near future.
9
+
10
+
If you are familiar with [Vitess Workflows](https://vitess.io/docsreference/vreplication/workflow/), you will see some similarities. For example, the PlanetScale workflow that allows you to move tables from an unsharded to a sharded keyspace is similar to the [Vitess `MoveTables` workflow](https://vitess.io/docs/user-guides/migration/move-tables/).
11
+
12
+
## Create a workflow
13
+
14
+
To create a new workflow, select your database, and click "Workflows" in the left nav. Next, click "New workflow". Because we currently only have one available workflow, this will drop you straight into the page to create a new workflow to move tables from an unsharded to sharded keyspace. In the future, you will have the option to choose other workflows.
15
+
16
+
## View workflow history
17
+
18
+
To view the history of all completed or pending workflows, click on "Workflows" in the left nav. From here, you can see all previous workflows along with information such as status, duration, and the time it took to complete.
0 commit comments