Rééquilibrer les partitions dans un cluster dans Azure Cosmos DB for PostgreSQL

Important

Azure Cosmos DB pour PostgreSQL n’est plus pris en charge pour les nouveaux projets. N’utilisez pas ce service pour les nouveaux projets. Utilisez plutôt l’un des deux services suivants :

• Utilisez Azure Cosmos DB pour NoSQL pour une solution de base de données distribuée conçue pour des scénarios à grande échelle avec un contrat de niveau de service de disponibilité (SLA) de 99,999%, une mise à l’échelle automatique instantanée et un basculement automatique entre plusieurs régions.

• Utilisez la fonctionnalité Elastic Clusters d'Azure Database pour PostgreSQL pour un PostgreSQL partagé utilisant l'extension open source Citus.

Pour tirer parti des nœuds nouvellement ajoutés, rééquilibrez les partitions des tables distribuées. Le rééquilibrage déplace les fragments des nœuds existants vers les nouveaux. Azure Cosmos DB for PostgreSQL offre un rééquilibrage sans temps d’arrêt, ce qui signifie que les requêtes se poursuivent sans interruption pendant le rééquilibrage des partitions.

Déterminer si le cluster est équilibré

Le Portail Azure vous indique si les données sont distribuées de manière égale entre les nœuds Worker dans un cluster ou non. Dans le menu Gestion de cluster, sélectionnez Rééquilibreur de partition.

• Si les données sont décalées entre les travailleurs, le message Rééquilibrage recommandé s’affiche, ainsi qu’une liste de la taille de chaque nœud.

• Si les données sont équilibrées, le message Aucun rééquilibrage recommandé pour l’instant s’affiche.

Exécuter le rééquilibreur de partition

Pour démarrer le rééquilibreur de partition, connectez-vous au nœud coordinateur du cluster, puis exécutez la fonction SQL rebalance_table_shards sur des tables distribuées.

La fonction rééquilibre toutes les tables dans le groupe colocation de la table nommée dans son argument. Vous n’avez pas besoin d’appeler la fonction pour chaque table distribuée. Au lieu de cela, appelez-la sur une table représentative de chaque groupe de colocation.

SELECT rebalance_table_shards('distributed_table_name');

Progression du rééquilibrage du moniteur

Vous pouvez consulter la progression du rééquilibrage depuis le portail Azure. Dans le menu Gestion de cluster, sélectionnez Rééquilibreur de partition. Le message Rebalancing is underway s'affiche avec deux tables :

• Le premier tableau indique le nombre de partitions qui se déplacent à l’intérieur ou à l’extérieur d’un nœud. Par exemple, « 6 sur 24 déplacés ».
• Le deuxième tableau affiche la progression par table de base de données : nom, nombre de partitions affectées, taille des données affectées et état de rééquilibrage.

Sélectionnez Actualiser pour mettre à jour la page. Une fois le rééquilibrage terminé, le message Aucun rééquilibrage recommandé pour l’instant s’affiche.

Étapes suivantes

• En savoir plus sur les options de performances des clusters.
• Mettre à l’échelle un cluster
• Consultez la documentation de référence rebalance_table_shards