Utiliser un index secondaire dans la console pour accélérer les requêtes de données - Tablestore

La fonctionnalité d'index secondaire vous permet d'interroger des données en vous basant sur la clé primaire d'une table de données et sur les colonnes d'index de l'index secondaire créé pour cette table. Cette approche accélère les requêtes de données. Lors de la création d'un index secondaire, vous pouvez définir les colonnes d'index ou les colonnes d'attribut de l'index secondaire comme étant les colonnes prédéfinies que vous avez spécifiées pour la table concernée. Une fois l'index secondaire créé, utilisez-le pour interroger vos données.

Prérequis

Créez une table de données dont le paramètre Max Versions est défini sur 1. Le paramètre TTL (Time To Live) de la table de données doit satisfaire à l'une des conditions suivantes :

Le paramètre TTL de la table de données est défini sur -1, ce qui signifie que les données de la table n'expirent jamais.
Si le TTL de la table de données n'est pas égal à -1, la table ne doit pas autoriser les mises à jour. Cela signifie que l'option Allow Updates est définie sur No.

Remarque

Le TTL de l'index secondaire est identique à celui de la table de données.

Étape 1 : (Facultatif) Ajouter des colonnes prédéfinies

Si vous créez un index secondaire pour une table qui ne contient aucune colonne prédéfinie, ou si les colonnes prédéfinies existantes ne répondent pas à vos besoins métier, ajoutez ou supprimez des colonnes prédéfinies dans la table.

Remarque

Vous pouvez également ajouter des colonnes prédéfinies lors de la création d'une table de données. Pour plus d'informations, consultez la section Étape 3 : Créer une table de données.

Accédez à la page Manage Table.
1. Connectez-vous à la console Tablestore.
2. Sur la page Overview, cliquez sur le nom de l'instance.
3. Sous l'onglet Instance Details, dans la section Tables, cliquez sur le nom de la table de données.
Sous l'onglet Basic Information, dans la section Pre-defined Column du module Advanced Features, cliquez sur Add Pre-Defined Column.
Dans la boîte de dialogue Add Pre-Defined Column, cliquez sur Add Pre-Defined Column, puis saisissez un nom et sélectionnez un type de données pour la colonne prédéfinie.
- Conventions de dénomination des colonnes prédéfinies : le nom doit comporter entre 1 et 255 octets et peut contenir des lettres, des chiffres et des traits de soulignement (_). Il doit commencer par une lettre ou un trait de soulignement (_).
- Sélectionnez STRING, INTEGER, BINARY, FLOAT ou BOOLEAN comme type de données. Si la colonne prédéfinie est utilisée comme colonne d'index, sélectionnez STRING, INTEGER ou BINARY.
Remarque
Cliquez sur Add Pre-Defined Column pour ajouter plusieurs colonnes. Pour supprimer une colonne indésirable, cliquez sur l'icône située à côté de celle-ci.

Dans la boîte de dialogue Add predefined column, le champ Table Name affiche exampletable et le champ Existing predefined columns affiche cost. Dans la zone predefined column, saisissez name comme nom de colonne et sélectionnez STRING comme type de données.
Cliquez sur OK.

Les colonnes prédéfinies ajoutées s'affichent dans la liste des colonnes prédéfinies.

Pour supprimer une colonne prédéfinie de la liste, cliquez sur l'icône dans la colonne Remove Pre-Defined Column.

Étape 2 : Créer un index secondaire

Créez un index secondaire et utilisez-le pour accélérer les requêtes de données. Les index secondaires se divisent en index secondaires globaux et locaux. Créez l'index secondaire adapté à vos besoins métier.

Remarque

Vous pouvez créer un index secondaire lors de la création d'une table de données. Pour plus d'informations, consultez la section Étape 3 : Créer une table de données.

Accédez à la page Manage Table.
1. Connectez-vous à la console Tablestore.
2. Sur la page Overview, cliquez sur le nom de l'instance.
3. Sous l'onglet Instance Details, dans la section Tables, cliquez sur le nom de la table de données.
Sous l'onglet Indexes, cliquez sur Create a secondary index.

Dans la boîte de dialogue Create Index, configurez l'index secondaire.

Le tableau suivant décrit les paramètres.

Parameter	Description
Index Type	Le type d'index. Cette valeur est toujours Secondary Index.
Instance Name	Le nom de l'instance. Vous ne pouvez pas modifier la valeur de ce paramètre.
Table Name	Le nom de la table de données pour laquelle vous souhaitez créer l'index secondaire. Vous ne pouvez pas modifier la valeur de ce paramètre.
Index Name	Le nom de l'index secondaire que vous souhaitez créer. Important Le nom ne doit pas être identique à celui des tables de données et des tables de séries chronologiques existantes.
Index Type	Le type d'index secondaire. Valeurs possibles : Global Secondary Index : Tablestore synchronise automatiquement les données des colonnes indexées et des colonnes de clé primaire de la table de données vers les colonnes de la table d'index que vous souhaitez créer, en mode asynchrone. La première colonne de clé primaire de la table d'index peut être une colonne de clé primaire ou une colonne prédéfinie de la table de données. Local Secondary Index : Tablestore synchronise automatiquement les données des colonnes indexées et des colonnes de clé primaire de la table de données vers les colonnes de la table d'index que vous souhaitez créer, en mode synchrone. Une fois les données écrites dans la table de données, vous pouvez immédiatement les interroger dans la table d'index. La première colonne de clé primaire de la table d'index doit être la première colonne de clé primaire de la table de données.
Existing Data	Indique s'il faut inclure les données existantes de la table de données dans l'index secondaire. Valeurs possibles : Include Existing Data Exclude Existing Data

Sélectionnez les colonnes de clé primaire dans l'ordre souhaité et cliquez sur Add Primary Key Column pour chaque colonne.

Seules les colonnes prédéfinies de type STRING, INTEGER et BINARY peuvent être utilisées comme colonnes de clé primaire.
Sélectionnez les colonnes prédéfinies à utiliser comme colonnes d'attribut, puis cliquez sur Add Pre-defined Column.

Cliquez sur OK.

L'index secondaire créé s'affiche dans la liste des index.

Étape 3 : Interroger des données

Utilisez des requêtes de ligne unique ou des requêtes de plage sur les tables d'index pour interroger les données requises.

Effectuer une requête de plage

Accédez à la page Manage Table.
1. Connectez-vous à la console Tablestore.
2. Sur la page Overview, cliquez sur le nom de l'instance.
3. Sous l'onglet Instance Details, dans la section Tables, cliquez sur le nom de la table de données.
Sous l'onglet Indexes, recherchez la table d'index cible et cliquez sur Query dans la colonne Actions.
Dans la boîte de dialogue Search, définissez les conditions de requête.
1. Définissez le paramètre Mode sur Range Search.
2. Par défaut, toutes les colonnes sont renvoyées. Pour renvoyer des colonnes d'attribut spécifiques, désactivez l'option Get All Columns et saisissez les noms des colonnes, séparés par des virgules (,).
3. Configurez les paramètres Start Primary Key Column et End Primary Key Column.
  Important
  
  Si vous définissez le paramètre Modes sur Range Search, la plage spécifiée par les valeurs de début et de fin dans la colonne de clé primaire de droite prend effet uniquement si les valeurs de début et de fin sont identiques dans chaque colonne de clé primaire la plus à gauche. Si les valeurs de début et de fin diffèrent dans une colonne de clé primaire la plus à gauche, la plage spécifiée par les valeurs de début et de fin dans la colonne de clé primaire de droite ne prend pas effet.
  
  La plage prise en charge pour les requêtes de plage est un intervalle ouvert à gauche et fermé à droite.
4. Conservez la valeur par défaut du paramètre Max Versions.
5. Définissez le sens de tri des résultats de la requête sur Forward Search ou Backward Search.
Cliquez sur OK.

Les données correspondant aux conditions de requête s'affichent dans la liste des données.

Effectuer une requête de ligne unique

Accédez à la page Manage Table.
1. Connectez-vous à la console Tablestore.
2. Sur la page Overview, cliquez sur le nom de l'instance.
3. Sous l'onglet Instance Details, dans la section Tables, cliquez sur le nom de la table de données.
Sous l'onglet Indexes, recherchez la table d'index cible et cliquez sur Query dans la colonne Actions.
Dans la boîte de dialogue Search, définissez les conditions de requête.

Dans la boîte de dialogue, saisissez les exemples de valeurs de clé primaire suivants : lily pour name, a100001 pour useid et a100001000001 pour orderid.
1. Définissez le paramètre Mode sur Get Row.
2. Par défaut, toutes les colonnes sont renvoyées. Pour renvoyer des colonnes d'attribut spécifiques, désactivez l'option Get All Columns et saisissez les noms des colonnes, séparés par des virgules (,).
3. Saisissez la Primary Key Value pour la ligne cible.
  
  L'intégrité et l'exactitude de la valeur de clé primaire ont un impact sur les résultats de la requête.
4. Conservez la valeur par défaut du paramètre Max Versions.
Cliquez sur OK.

Si la ligne que vous souhaitez interroger figure dans la table d'index, Tablestore renvoie les données de cette ligne. Si la ligne ne figure pas dans la table d'index, aucune donnée n'est renvoyée.

FAQ

Références

Utilisez des index secondaires via les SDK Tablestore ou l'interface CLI Tablestore. Pour plus d'informations, consultez les sections Utiliser un index secondaire global avec le SDK Tablestore et Index secondaire.
Pour interroger les données de manière plus efficace et flexible, utilisez la fonctionnalité d'index de recherche. Celle-ci propose plusieurs méthodes de requête, notamment la requête booléenne, la recherche en texte intégral, la requête par préfixe et la requête floue. Pour plus d'informations, consultez la section Présentation.