Merge pull request #6009 from soyeric128/main

Doc: ALTER & DROP CLUSTER KEY

docs/doc/30-reference/30-sql/00-ddl/70-clusterkey/_category_.json

@@ -0,0 +1,7 @@
+{
+  "label": "Cluster Key",
+  "link": {
+    "type": "generated-index",
+    "slug": "/reference/sql/ddl/clusterkey"
+  }
+}

docs/doc/30-reference/30-sql/00-ddl/70-clusterkey/dml-alter-cluster-key.md

@@ -0,0 +1,39 @@
+---
+title: ALTER CLUSTER KEY
+description:
+  Changes the cluster key for a table.
+---
+
+Changes the cluster key for a table.
+
+See also:
+[DROP CLUSTER KEY](./dml-drop-cluster-key.md)
+
+## Syntax
+
+```sql
+ALTER TABLE <name> CLUSTER BY ( <expr1> [ , <expr2> ... ] )
+```
+
+## Examples
+
+```sql
+-- Create table
+CREATE TABLE IF NOT EXISTS playground(a int, b int);
+
+-- Add cluster key by columns
+ALTER TABLE playground CLUSTER BY(b,a);
+
+INSERT INTO playground VALUES(0,3),(1,1);
+INSERT INTO playground VALUES(1,3),(2,1);
+INSERT INTO playground VALUES(4,4);
+
+SELECT * FROM playground ORDER BY b,a;
+SELECT * FROM clustering_information('db1','playground');
+
+-- Delete cluster key
+ALTER TABLE playground DROP CLUSTER KEY;
+
+-- Add cluster key by expressions
+ALTER TABLE playground CLUSTER BY(rand()+a); 
+```

docs/doc/30-reference/30-sql/00-ddl/70-clusterkey/dml-drop-cluster-key.md

@@ -0,0 +1,24 @@
+---
+title: DROP CLUSTER KEY
+description:
+  Deletes the cluster key for a table.
+---
+
+Deletes the cluster key for a table.
+
+See also:
+[ALTER CLUSTER KEY](./dml-alter-cluster-key.md) 
+
+## Syntax
+
+```sql
+ALTER TABLE <name> DROP CLUSTER KEY
+```
+
+## Examples
+
+This command drops the cluster key for table *test*:
+
+```sql
+ALTER TABLE test DROP CLUSTER KEY
+```