Partager via


Configurer la distribution mondiale Azure Cosmos DB à l’aide de l’API de Table

S’APPLIQUE À : Table

Cet article décrit les tâches suivantes :

  • Configurer la diffusion mondiale à l’aide du portail Azure
  • Configurer la distribution mondiale à l’aide de l’API de Table

Ajouter des régions de bases de donnée mondiales à l’aide du portail Azure

Azure Cosmos DB est disponible dans toutes les régions Azure à travers le monde. Après avoir sélectionné le niveau de cohérence par défaut pour votre compte de base de données, vous pouvez associer une ou plusieurs régions (en fonction de votre choix de niveau de cohérence par défaut et de vos besoins de distribution mondiale).

  1. Dans la barre à gauche du portail Azure, cliquez sur Azure Cosmos DB.

  2. Dans la page Azure Cosmos DB, sélectionnez le compte de base de données à modifier.

  3. Dans la page du compte, cliquez sur Répliquer les données globalement à partir du menu.

  4. Dans la page Répliquer les données globalement, sélectionnez les régions à ajouter ou à supprimer en cliquant sur des régions sur la carte, puis cliquez sur Enregistrer. L’ajout de régions est payant. Pour plus d’informations, consultez la page de tarification ou l’article Distribution mondiale des données avec Azure Cosmos DB.

    Cliquez sur les régions dans la carte pour les ajouter ou les supprimer.

Une fois que vous ajoutez une deuxième région, l’option Basculement manuel est activée sur la page Répliquer les données globalement dans le portail. Vous pouvez utiliser cette option pour tester le processus de basculement ou modifier la région principale d’écriture. Une fois que vous ajoutez une troisième région, l’option Priorités de basculement est activée sur la même page afin que vous puissiez modifier l’ordre de basculement pour les lectures.

Sélection de régions de base de données mondiale

Il existe deux scénarios courants pour la configuration de deux ou plusieurs régions :

  1. La fourniture aux utilisateurs finaux d’un accès à faible latence aux données, où qu’ils se trouvent dans le monde
  2. L’ajout d’une résilience régionale pour la continuité d’activité et la reprise d’activité (BCDR)

Pour fournir une faible latence aux utilisateurs finaux, il est recommandé de déployer l’application et Azure Cosmos DB dans les régions correspondant à la localisation géographique des utilisateurs de l’application.

Pour BCDR, il est recommandé d’ajouter les régions en fonction des paires de régions décrites dans l’article Réplication interrégionale dans Azure : continuité de l’activité et reprise d’activité.

Se connecter à une région préférée avec l’API de Table

Pour tirer parti de la distribution globale, les applications clientes doivent spécifier l’emplacement actuel où leur application s’exécute. Pour cela, définissez la propriété CosmosExecutorConfiguration.CurrentRegion. La propriété CurrentRegion doit contenir un seul emplacement. Chaque instance de client peut spécifier sa propre région pour les lectures à faible latence. La région doit être nommée en utilisant son nom d’affichage, comme « USA Ouest ».

Le SDK Azure Cosmos DB de Table sélectionne automatiquement le point de terminaison qui convient le mieux pour communiquer en fonction de la configuration du compte et de la disponibilité régionale actuelle. Il donne la priorité à la région la plus proche pour offrir une meilleure latence aux clients. Une fois que vous avez défini la propriété CurrentRegion actuelle, les demandes de lecture et d’écriture sont dirigées comme suit :

  • Demandes de lecture : Toutes les demandes de lecture sont envoyées à la CurrentRegion configurée. En fonction de la proximité, le SDK sélectionne automatiquement une région géorépliquée de secours pour la haute disponibilité.

  • Demandes d’écriture : Le SDK envoie automatiquement toutes les demandes d’écriture vers la région d’écriture active. Dans un compte avec écritures multirégions, la région actuelle traite également les demandes d’écriture. En fonction de la proximité, le SDK sélectionne automatiquement une région géorépliquée de secours pour la haute disponibilité.

Si vous ne spécifiez pas la propriété CurrentRegion, le SDK utilise la région d’écriture actuelle pour toutes les opérations.

Par exemple, si un compte Azure Cosmos se trouve dans les régions « USA Ouest » et « USA Est ». Si « USA Ouest » est la région d’écriture et que l’application se trouve dans « USA Ouest ». Si la propriété CurrentRegion n’est pas configurée, toutes les demandes de lecture et d’écriture sont toujours dirigées vers la région « USA Ouest ». Si la propriété CurrentRegion est configurée, toutes les demandes de lecture sont traitées depuis la région « USA Est ».

Étapes suivantes

Dans ce tutoriel, vous avez :

  • Configurer la diffusion mondiale à l’aide du portail Azure
  • Configurer la distribution mondiale à l’aide des API Table d’Azure Cosmos DB