Tablestore:Modifier dynamiquement le schéma d'un index de recherche

Fonctionnement

Flux de travail

La figure suivante illustre le flux de travail permettant de modifier dynamiquement un schéma. L'ensemble du processus est transparent pour votre application, ce qui vous permet de modifier le schéma sans changer le code de votre application.

Le tableau suivant décrit les principales étapes de la modification du schéma d'un index de recherche.

Procédure

1. Accédez à l'onglet Indexes.

   1. Connectez-vous à la console Tablestore.

   2. Dans la barre de navigation supérieure, sélectionnez une région et un groupe de ressources.

   3. Sur la page Overview, cliquez sur le nom de l'instance, ou cliquez sur Manage Instance dans la colonne Actions.

   4. Sous l'onglet Instance Details, dans la zone Tables, cliquez sur le nom de la table de données ou sur Indexes dans la colonne Actions.

2. Créez un index canari basé sur l'index source.

   1. Sous l'onglet Indexes, localisez l'index de recherche et cliquez sur Change Schema dans la colonne Actions.

   2. Dans la boîte de dialogue Reindex, ajoutez, modifiez ou supprimez des champs d'index selon les besoins.

      La boîte de dialogue Reindex contient les éléments de configuration suivants :

      • Informations de base de l'index : Index Type (par exemple, index de recherche), Instance Name, Table Name (par exemple, exampletable), Index Name (par exemple, exampletable_index), et Canary Index Name (par exemple, exampletable_index_reindex).

      • Table de configuration des champs : Chaque ligne vous permet de définir les propriétés Field Name, Field Type, Index Parameters, Array, Highlight et Virtual Column. Vous pouvez cliquer sur le bouton + pour ajouter un champ, ou sur l'icône de suppression pour retirer un champ.

      • En bas de page, un commutateur Advanced Settings est disponible. Une fois la configuration terminée, cliquez sur OK.

   3. Pour modifier la clé de routage ou la méthode de prétri, activez Advanced Settings et configurez les paramètres décrits dans le tableau suivant.

      Paramètre	Description
      Routing Key :	Spécifie des champs de routage personnalisés. Vous pouvez sélectionner une ou plusieurs colonnes de clé primaire comme champs de routage. Lors de l'écriture des données dans l'index, le système utilise la valeur de la clé de routage pour déterminer la distribution des données. Les enregistrements ayant la même valeur de clé de routage sont indexés dans la même partition. Pour plus d'informations, consultez Utiliser des champs de routage dans un index de recherche.
      Pre-sorting	Méthode de tri par défaut des données dans l'index de recherche. Le prétri détermine l'ordre par défaut dans lequel les résultats de requête sont renvoyés. Pour plus d'informations, consultez Prétri de l'index. Pour trier par clé primaire, sélectionnez Default. Pour trier par valeurs de champ ou par une combinaison de colonnes de clé primaire, sélectionnez Custom et configurez les paramètres. Sélectionnez un type de tri, tel que Primary Key Pre-sorting ou Field Pre-sorting, puis cliquez sur Add. Sélectionnez le nom du champ et l'ordre de tri. Les ordres de tri pris en charge sont croissant et décroissant. Important Vous devez sélectionner un nom de champ uniquement si vous choisissez Field Pre-sorting. Lors de l'utilisation d'un tri personnalisé, vous pouvez configurer à la fois le prétri par clé primaire et le prétri par champ selon les besoins.

   4. Cliquez sur OK.

   5. Dans la boîte de dialogue Index Comparison, examinez la comparaison de la clé de routage, du prétri et du schéma entre les index source et canari. Après avoir confirmé l'exactitude des informations, cliquez sur Yes.

3. Vérifiez les informations de synchronisation de l'index.

   1. Cliquez sur l'icône située à côté de l'index source, ou cliquez sur le nom de l'index source.

      L'index canari de l'index source s'affiche.

   2. Cliquez sur Use Gray Index dans la colonne Actions de l'index canari.

      Important

      L'index canari passe par une phase de synchronisation complète des données et une phase de synchronisation incrémentielle des données.

      • Avant la fin de la synchronisation des données, si vous placez le pointeur sur le bouton Use Gray Index dans la colonne Actions, une info-bulle indiquant Yes, but the operation may cause security risks. apparaît et le basculement est désactivé.

      • Lorsque l'index canari a rattrapé l'index source, si vous placez le pointeur sur le bouton Use Gray Index dans la colonne Actions, une info-bulle indiquant Yes. The operation is secure. apparaît. Vous pouvez alors passer aux étapes suivantes.

   3. Dans la boîte de dialogue Use Gray Index, consultez les informations de synchronisation de l'index.

      Le haut de la boîte de dialogue affiche le Data Status (Synchronizing) et le Switchover Status (Safe to switch). Les informations relatives à l'index sont présentées en deux colonnes pour l'index source et l'index canari. Chaque colonne contient les champs suivants :

      • Sync Status

      • Rows

      • Created At

      • Last Sync Time

      • Sync Latency

      • Data Lifecycle

      En bas, dans la zone Actions, vous pouvez utiliser des curseurs pour ajuster les poids de trafic de l'source index et de l'canary index, puis cliquer sur Set Weight pour enregistrer la configuration, ou sur Switch Index pour finaliser le basculement de l'index.

4. Une fois la synchronisation terminée, effectuez des tests A/B en définissant les poids de trafic.

   Utilisez les tests A/B pour valider le nouveau schéma en répartissant le trafic des requêtes entre les index source et canari. Vous devez basculer tout le trafic vers l'index canari avant de pouvoir passer à l'étape suivante.

   1. Dans la section Operations de la boîte de dialogue Use Gray Index, faites glisser le curseur pour ajuster les poids des index source et canari, puis cliquez sur Set Weight.

   2. Dans la boîte de dialogue Set Weight, examinez les données de poids et la comparaison des schémas.

   3. Après avoir confirmé l'exactitude des informations, cliquez sur Set Weight.

   4. Dans la boîte de dialogue de confirmation qui s'affiche, cliquez sur Yes.

5. Lorsque tout le trafic des requêtes est basculé vers l'index canari, permutez les schémas des index source et canari.

   Après la permutation, le nom de l'index source pointe vers le nouveau schéma et le nom de l'index canari pointe vers l'ancien. Tout le trafic des requêtes est alors dirigé vers le nom de l'index source, qui utilise désormais le nouveau schéma.

   Dans la boîte de dialogue Use Gray Index, confirmez que l'état des données est In canary release, que l'état du basculement est Yes. The operation is secure., que le poids de l'index source est 0 et que le poids de l'index canari est 100, puis cliquez sur Switch Index.

   1. Dans la section Operations de la boîte de dialogue Use Gray Index, cliquez sur Switch Index.

   2. Dans la boîte de dialogue Switch Index, examinez la comparaison de la clé de routage, du prétri et du schéma entre les index source et canari. Après avoir confirmé l'exactitude des informations, cliquez sur Confirm Switch.

6. Après avoir permuté les schémas et vérifié que l'index fonctionne comme prévu, attendez une période de stabilisation (par exemple, un jour) avant de supprimer l'index canari.

   Confirmez que la boîte de dialogue Use Gray Index affiche l'état des données comme Released, l'état du basculement comme Yes. The operation is secure., et que la zone Actions indique un trafic de 100 pour l'source index et de 0 pour l'canary index.

   1. Dans la boîte de dialogue Use Gray Index, cliquez sur Delete Canary Release.

   2. Dans la boîte de dialogue Are you sure you have completed the canary release and want to delete the old index?, confirmez que les informations relatives à l'index canari à supprimer sont correctes. Ensuite, dans la zone de texte, saisissez I have confirmed that the new index data has been synchronized and has been in canary release for a period of time.

   3. Cliquez sur Yes.

Mesures de sécurité

Facturation

La création d'index canaris et l'écriture de données dans ceux-ci ne sont pas facturées. Vous êtes facturé pour le stockage consommé par les deux index et pour les unités de capacité de lecture (CU) réservées provisionnées pour ceux-ci. Pour plus d'informations, consultez Éléments facturables des index de recherche.

Documents connexes

• Pour interroger de nouveaux champs ou types de données sans modifier la structure de la table, vous pouvez modifier le schéma de l'index de recherche ou utiliser la fonctionnalité de colonnes virtuelles lors de la création d'un nouvel index de recherche. Pour plus d'informations, consultez Colonnes virtuelles.

• Tablestore prend en charge divers types de requêtes pour différents scénarios, notamment Requête MatchAll, Requête Match, Requête Match Phrase, Requête Term, Requête Terms, Requête Wildcard, Requête Prefix, Requête Suffix, Requête wildcard basée sur la tokenisation, Requête Range, Requête Bool, Requête Nested, Requête Geo-distance, Requête Geo-bounding box, Requête Geo-polygon, Requête Exists, Collapse (distinct) et Colonnes virtuelles pour interroger vos données.

• Pour interroger rapidement des données de différents types dans un index de recherche à l'aide d'instructions SQL, vous pouvez utiliser la fonctionnalité de requête SQL. Pour plus d'informations, consultez Requête SQL, Créer des tables de mappage pour les index de recherche, Interroger des données, Recherche en texte intégral, Type Array, Type Nested et Colonnes virtuelles.

• Utilisez la fonctionnalité d'agrégation d'index de recherche pour effectuer des analyses de données telles que la recherche de minimums, de maximums, de sommes et de moyennes, le comptage de lignes, le comptage distinct, le calcul de percentiles, le regroupement par valeur de champ, par plage, par emplacement géographique ou par conditions de filtre, la création d'histogrammes ou l'exécution de requêtes imbriquées. Pour plus d'informations, consultez Agrégation.