Docs rr removal part5 (#34366)

Author: kay-kim

doc/user/content/security/cloud/access-control/manage-roles.md

@@ -638,7 +638,7 @@ object and is automatically  granted all [applicable
 privileges](/security/appendix/appendix-privileges/) for the object. To
 transfer ownership (and privileges) to another role (another user role/service
 account role/functional role), you can use the [ALTER ... OWNER
-TO](/sql/alter-owner/) command:
+TO](/sql/#rbac) commands:
 
 {{< annotation type="Privilege(s) required to run the command" >}}
 

doc/user/content/security/self-managed/access-control/manage-roles.md

@@ -642,7 +642,7 @@ object and is automatically  granted all [applicable
 privileges](/security/appendix/appendix-privileges/) for the object. To
 transfer ownership (and privileges) to another role (another user role/service
 account role/functional role), you can use the [ALTER ... OWNER
-TO](/sql/alter-owner/) command:
+TO](/sql/#rbac) command:
 
 {{< annotation type="Privilege(s) required to run the command" >}}
 

doc/user/content/sql/_index.md

@@ -7,7 +7,8 @@ menu:
     identifier: "commands"
     parent: "reference"
     weight: 100
-
+aliases:
+  - /sql/alter-owner/
 ---
 
 ## Create/Alter/Drop Objects
@@ -23,11 +24,10 @@ sources, and tables:
 
 ## RBAC
 
-Commands to manage roles and privileges:
+Commands to manage roles and privileges and owners:
 
 {{< yaml-table data="sql_commands_rbac" noHeader=true >}}
 
-
 ## Query Introspection (`Explain`)
 
 {{< yaml-list data="sql_commands_all" label="explain" numColumns="1" >}}

doc/user/content/sql/alter-cluster-replica.md

@@ -0,0 +1,58 @@
+---
+title: "ALTER CLUSTER REPLICA"
+description: "`ALTER CLUSTER REPLICA` changes properties of a cluster replica."
+menu:
+  main:
+    parent: 'commands'
+---
+
+Use `ALTER CLUSTER REPLICA` to:
+- Rename a cluster replica.
+- Change owner of a cluster replica.
+
+## Syntax
+
+{{< tabs >}}
+{{< tab "Rename" >}}
+
+### Rename
+
+To rename a cluster replica:
+
+{{% include-syntax file="examples/alter_cluster_replica" example="syntax-rename" %}}
+
+{{< note >}}
+You cannot rename replicas in system clusters.
+{{< /note >}}
+
+{{< /tab >}}
+{{< tab "Change owner" >}}
+
+### Change owner
+
+To change the owner of a cluster replica:
+
+{{% include-syntax file="examples/alter_cluster_replica" example="syntax-change-owner" %}}
+
+{{< /tab >}}
+
+{{< /tabs >}}
+
+## Privileges
+
+The privileges required to execute this statement are:
+
+{{< include-md
+file="shared-content/sql-command-privileges/alter-cluster-replica.md" >}}
+
+## Example
+
+The following changes the owner of the cluster replica `production.r1` to
+`admin`.  The user running the command must:
+- Be the current owner;
+- Be a member of `admin`; and
+- Have `CREATE` privilege on the `production` cluster.
+
+```mzsql
+ALTER CLUSTER REPLICA production.r1 OWNER TO admin;
+```

doc/user/content/sql/alter-cluster.md

@@ -6,8 +6,15 @@ menu:
     parent: 'commands'
 ---
 
-`ALTER CLUSTER` changes the configuration of a cluster, such as the `SIZE` or
+Use `ALTER CLUSTER` to:
+
+- Change configuration of a cluster, such as the `SIZE` or
 `REPLICATON FACTOR`.
+- Rename a cluster.
+- Change owner of a cluster.
+
+For completeness, the syntax for `SWAP WITH` operation is provided. However, in
+general, you will not need to manually perform this operation.
 
 ## Syntax
 
@@ -16,58 +23,47 @@ menu:
 {{< tabs >}}
 {{< tab "Set a configuration" >}}
 
+### Set a configuration
+
 To set a cluster configuration:
 
-  ```mzsql
-  ALTER CLUSTER <cluster_name>
-  SET (
-      SIZE = <text>,
-      REPLICATION FACTOR = <int>,
-      MANAGED = <bool>,
-      SCHEDULE = { MANUAL | ON REFRESH (...) }
-  )
-  [WITH ({ WAIT UNTIL READY({TIMEOUT | ON TIMEOUT {COMMIT|ROLLBACK}}) | WAIT FOR <duration> })]
-  ;
-  ```
+{{% include-syntax file="examples/alter_cluster" example="syntax-set-configuration" %}}
 
 {{< /tab >}}
 {{< tab "Reset to default" >}}
 
+### Reset to default
+
 To reset a cluster configuration back to its default value:
 
-  ```mzsql
-  ALTER CLUSTER <cluster_name>
-  RESET (
-      REPLICATION FACTOR,
-      MANAGED,
-      SCHEDULE
-  )
-  ;
-  ```
+{{% include-syntax file="examples/alter_cluster" example="syntax-reset-to-default" %}}
 
 {{< /tab >}}
-{{< tab "Rename cluster" >}}
+{{< tab "Rename" >}}
+
+### Rename
 
 To rename a cluster:
 
-  ```mzsql
-  ALTER CLUSTER <cluster_name> RENAME TO <new_cluster_name>;
-  ```
+{{% include-syntax file="examples/alter_cluster" example="syntax-rename" %}}
+
+{{< note >}}
+You cannot rename system clusters, such as `mz_system` and `mz_catalog_server`.
+{{< /note >}}
 
 {{< /tab >}}
-{{< tab "Change owner to" >}}
+{{< tab "Change owner" >}}
 
-To change the owner of a cluster:
+### Change owner
 
-  ```mzsql
-  ALTER CLUSTER <cluster_name> OWNER TO <new_owner_role>;
-  ```
+To change the owner of a cluster:
 
-To rename a cluster, you must have ownership of the cluster and membership in
-the `<new_owner_role>`. See also [Required privileges](#required-privileges).
+{{% include-syntax file="examples/alter_cluster" example="syntax-change-owner" %}}
 
 {{< /tab >}}
-{{< tab "Swap names with" >}}
+{{< tab "Swap with" >}}
+
+### Swap with
 
 {{< important >}}
 
@@ -79,9 +75,7 @@ not need to manually perform this operation.
 
 To swap the name of this cluster with another cluster:
 
-  ```mzsql
-  ALTER CLUSTER <cluster1> SWAP WITH <cluster2>;
-  ```
+{{% include-syntax file="examples/alter_cluster" example="syntax-swap-with" %}}
 
 {{< /tab >}}
 {{< /tabs >}}
@@ -266,6 +260,11 @@ See also:
 - [Access control (Materialize
   Self-Managed)](/security/self-managed/access-control/)
 
+### Rename restrictions
+
+You cannot rename system clusters, such as `mz_system` and `mz_catalog_server`.
+
+
 ## Examples
 
 ### Replication factor
@@ -350,7 +349,6 @@ compute-specific settings. If needed, these can be set explicitly.
 
 ## See also
 
-- [`ALTER ... RENAME`](/sql/alter-rename/)
 - [`CREATE CLUSTER`](/sql/create-cluster/)
 - [`CREATE SINK`](/sql/create-sink/)
 - [`SHOW SINKS`](/sql/show-sinks)

doc/user/content/sql/alter-connection.md

@@ -1,37 +1,63 @@
 ---
 title: "ALTER CONNECTION"
-description: "`ALTER CONNECTION` allows modifying the value of connection options and rotating secrets associated with connections"
+description: "`ALTER CONNECTION` allows you to modify the value of connection options; rotate secrets associated with connections; rename a connection; and change owner of a connection."
 menu:
   main:
     parent: 'commands'
 ---
 
-`ALTER CONNECTION` allows modifying the value of connection options and rotating
-secrets associated with connections. In particular, you can use this command
-to:
+Use `ALTER CONNECTION` to:
 
--   Modify the parameters of a connection, such as the hostname to which it
-    points.
--   Rotate the key pairs associated with an [SSH tunnel connection].
+- Modify the parameters of a connection, such as the hostname to which it
+  points.
+- Rotate the key pairs associated with an [SSH tunnel connection].
+- Rename a connection.
+- Change owner of a connection.
 
 ## Syntax
 
-{{< diagram "alter-connection.svg" >}}
+{{< tabs >}}
+{{< tab "SET/DROP/RESET options" >}}
 
-| Field                     | Use                                                 |
-| ------------------------- | --------------------------------------------------- |
-| _name_                    | The identifier of the connection you want to alter. |
-| **SET**...                | Sets the option to the specified value.             |
-| **DROP**..., **RESET**... | Resets the specified option to its default value.   |
-| **ROTATE KEYS**           | Rotates the key pairs.                              |
+### SET/DROP/RESET options
 
-#### `WITH` options
+To modify connection parameters:
 
-| Field      | Value     | Description                                                                                                                                                       |
-| ---------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `VALIDATE` | `boolean` | Whether [connection validation](/sql/create-connection#connection-validation) should be performed. Not available with **ROTATE KEYS**.<br><br>Defaults to `true`. |
+{{% include-syntax file="examples/alter_connection" example="syntax-set-drop-reset" %}}
 
-## Description
+{{< /tab >}}
+{{< tab "ROTATE KEYS" >}}
+
+### ROTATE KEYS
+
+To rotate SSH tunnel connection key pairs:
+
+{{% include-syntax file="examples/alter_connection" example="syntax-rotate-keys" %}}
+
+
+{{< /tab >}}
+
+{{< tab "Rename" >}}
+
+### Rename
+
+To rename a connection
+
+{{% include-syntax file="examples/alter_connection" example="syntax-rename" %}}
+
+{{< /tab >}}
+{{< tab "Change owner" >}}
+
+### Change owner
+
+To change the owner of a connection:
+
+{{% include-syntax file="examples/alter_connection" example="syntax-change-owner" %}}
+
+{{< /tab >}}
+{{< /tabs >}}
+
+## Details
 
 ### `SET`, `RESET`, `DROP`
 

doc/user/content/sql/alter-database.md

@@ -0,0 +1,42 @@
+---
+title: "ALTER DATABASE"
+description: "`ALTER DATABASE` changes properties of a database."
+menu:
+  main:
+    parent: 'commands'
+---
+
+Use `ALTER DATABASE` to:
+- Rename a database.
+- Change owner of a database.
+
+## Syntax
+
+{{< tabs >}}
+{{< tab "Rename" >}}
+
+### Rename
+
+To rename a database:
+
+{{% include-syntax file="examples/alter_database" example="syntax-rename" %}}
+
+{{< /tab >}}
+{{< tab "Change owner" >}}
+
+### Change owner
+
+To change the owner of a database:
+
+{{% include-syntax file="examples/alter_database" example="syntax-change-owner" %}}
+
+{{< /tab >}}
+
+{{< /tabs >}}
+
+## Privileges
+
+The privileges required to execute this statement are:
+
+{{< include-md
+file="shared-content/sql-command-privileges/alter-database.md" >}}