Merge pull request #88063 from jonels-msft/hyperscale-add-nodes

Hyperscale scaling howto

Author: tiburd

articles/postgresql/TOC.yml

@@ -154,86 +154,92 @@
         href: concepts-hyperscale-configuration-options.md
 - name: How-to guides
   items:
-  - name: Create users 
-    href: howto-create-users.md
-  - name: Optimize
-    items: 
-      - name: Bulk inserts
-        href: howto-optimize-bulk-inserts.md
-      - name: Autovacuum
-        href: howto-optimize-autovacuum.md
-      - name: Query stats collection
-        href: howto-optimize-query-stats-collection.md
-      - name: Toast table strategy
-        href: howto-optimize-query-time-with-toast-table-storage-strategy.md
-  - name: Manage firewall
-    items:
-    - name: Azure portal
-      href: howto-manage-firewall-using-portal.md
-    - name: Azure CLI
-      href: howto-manage-firewall-using-cli.md
-  - name: Restore a server
-    items:
-    - name: Azure portal
-      href: howto-restore-server-portal.md
-    - name: Azure CLI
-      href: howto-restore-server-cli.md
-  - name: Migrate a database
-    items:
-    - name: Dump & restore
-      href: howto-migrate-using-dump-and-restore.md
-    - name: Import & export
-      href: howto-migrate-using-export-and-import.md
-    - name: Minimal-downtime migration
-      href: howto-migrate-online.md
-  - name: Configure server parameters
-    items:
-    - name: Azure portal
-      href: howto-configure-server-parameters-using-portal.md
-    - name: Azure CLI
-      href: howto-configure-server-parameters-using-cli.md
-  - name: Auto grow storage
-    items:
-    - name: Azure portal
-      href: howto-auto-grow-storage-portal.md
-    - name: Azure CLI
-      href: howto-auto-grow-storage-cli.md
-  - name: Access server logs
-    items:
-    - name: Azure portal
-      href: howto-configure-server-logs-in-portal.md
-    - name: Azure CLI
-      href: howto-configure-server-logs-using-cli.md
-  - name: Monitor
-    items:
-    - name: Create alerts on metrics
-      href: howto-alert-on-metric.md
-  - name: Troubleshoot
-    items:
-    - name: Troubleshoot connection errors
-      href: howto-troubleshoot-common-connection-issues.md
-  - name: Advanced Threat Protection
-    items:
-    - name: Azure portal
-      href: howto-database-threat-protection-portal.md
-  - name: Virtual Network
-    items:
-    - name: Azure portal
-      href: howto-manage-vnet-using-portal.md
-    - name: Azure CLI
-      href: howto-manage-vnet-using-cli.md
-  - name: Restart server
+  - name: Single server
     items:
-    - name: Azure portal
-      href: howto-restart-server-portal.md
-    - name: Azure CLI
-      href: howto-restart-server-cli.md
-  - name: Replication
+    - name: Create users 
+      href: howto-create-users.md
+    - name: Optimize
+      items: 
+        - name: Bulk inserts
+          href: howto-optimize-bulk-inserts.md
+        - name: Autovacuum
+          href: howto-optimize-autovacuum.md
+        - name: Query stats collection
+          href: howto-optimize-query-stats-collection.md
+        - name: Toast table strategy
+          href: howto-optimize-query-time-with-toast-table-storage-strategy.md
+    - name: Manage firewall
+      items:
+      - name: Azure portal
+        href: howto-manage-firewall-using-portal.md
+      - name: Azure CLI
+        href: howto-manage-firewall-using-cli.md
+    - name: Restore a server
+      items:
+      - name: Azure portal
+        href: howto-restore-server-portal.md
+      - name: Azure CLI
+        href: howto-restore-server-cli.md
+    - name: Migrate a database
+      items:
+      - name: Dump & restore
+        href: howto-migrate-using-dump-and-restore.md
+      - name: Import & export
+        href: howto-migrate-using-export-and-import.md
+      - name: Minimal-downtime migration
+        href: howto-migrate-online.md
+    - name: Configure server parameters
+      items:
+      - name: Azure portal
+        href: howto-configure-server-parameters-using-portal.md
+      - name: Azure CLI
+        href: howto-configure-server-parameters-using-cli.md
+    - name: Auto grow storage
+      items:
+      - name: Azure portal
+        href: howto-auto-grow-storage-portal.md
+      - name: Azure CLI
+        href: howto-auto-grow-storage-cli.md
+    - name: Access server logs
+      items:
+      - name: Azure portal
+        href: howto-configure-server-logs-in-portal.md
+      - name: Azure CLI
+        href: howto-configure-server-logs-using-cli.md
+    - name: Monitor
+      items:
+      - name: Create alerts on metrics
+        href: howto-alert-on-metric.md
+    - name: Troubleshoot
+      items:
+      - name: Troubleshoot connection errors
+        href: howto-troubleshoot-common-connection-issues.md
+    - name: Advanced Threat Protection
+      items:
+      - name: Azure portal
+        href: howto-database-threat-protection-portal.md
+    - name: Virtual Network
+      items:
+      - name: Azure portal
+        href: howto-manage-vnet-using-portal.md
+      - name: Azure CLI
+        href: howto-manage-vnet-using-cli.md
+    - name: Restart server
+      items:
+      - name: Azure portal
+        href: howto-restart-server-portal.md
+      - name: Azure CLI
+        href: howto-restart-server-cli.md
+    - name: Replication
+      items:
+      - name: Manage read replicas Azure portal
+        href: howto-read-replicas-portal.md
+      - name: Manage read replicas Azure CLI, REST API
+        href: howto-read-replicas-cli.md
+  - name: Hyperscale (Citus)
     items:
-    - name: Manage read replicas Azure portal
-      href: howto-read-replicas-portal.md
-    - name: Manage read replicas Azure CLI, REST API
-      href: howto-read-replicas-cli.md
+    - name: Scaling
+      href: howto-hyperscale-scaling.md
 - name: Reference
   items:
   - name: Azure CLI

articles/postgresql/howto-hyperscale-scaling.md

@@ -0,0 +1,49 @@
+---
+title: Scale an Azure Database for PostgreSQL - Hyperscale (Citus) server group
+description: Adjust server group memory, disk, and CPU resources to deal with increased load
+author: jonels-msft
+ms.author: jonels
+ms.service: postgresql
+ms.topic: conceptual
+ms.date: 9/17/2019
+---
+
+# Scale a Hyperscale (Citus) server group
+
+Azure Database for PostgreSQL - Hyperscale (Citus) provides self-service
+scaling to deal with increased load. The Azure portal makes it easy to add new
+worker nodes.
+
+To do so, go to the **Configure** tab in your Hyperscale (Citus) server group.
+Drag the slider for **Worker node count** to change the value.
+
+![Resource sliders](./media/howto-hyperscale-scaling/01-sliders-workers.png)
+
+Click the "Save" button to make the changed value take effect.
+
+> [!NOTE]
+> Once increased and saved, the number of worker nodes cannot be decreased
+> using the slider.
+>
+> Also, vCores and Storage cannot yet be adjusted on the coordinator or workers
+> with this user interface. Open a support ticket if scaling compute on the
+> coordinator or worker nodes is needed.
+
+To take advantage of newly added nodes you must rebalance distributed table
+[shards](concepts-hyperscale-distributed-data.md#shards), which means moving
+some shards from existing nodes to the new ones. To start the shard rebalancer,
+connect to the cluster coordinator node with psql and run:
+
+```sql
+SELECT rebalance_table_shards('distributed_table_name');
+```
+
+The `rebalance_table_shards` function rebalances all tables in the
+[colocation](concepts-hyperscale-colocation.md) group of the table named in its
+argument. Thus you do not have to call the function for every distributed
+table, just call it on a representative table from each colocation group.
+
+## Next steps
+
+Learn more about server group [performance
+options](concepts-hyperscale-configuration-options.md).