Tablestore:Opérations sur les tables de données

Notes d'utilisation

• Vous pouvez créer au maximum 64 tables de données dans une seule instance.

• Une table de données n'est pas immédiatement disponible en lecture et en écriture après sa création. Dans la plupart des cas, l'accès à la nouvelle table est possible environ une minute plus tard.

• La fonctionnalité de colonne de clé primaire auto-incrémentée et celle des transactions locales ne peuvent pas être utilisées simultanément. Si vous configurez une colonne de clé primaire auto-incrémentée lors de la création d'une table de données, la fonctionnalité de transaction locale reste inactive, même si elle est activée.

Fonctionnalités

• Créer une table de données

  Lors de la création d'une table de données, spécifiez ses informations de schéma et de configuration.

  • Les informations de schéma d'une table de données comprennent le nom de la table, la définition de la clé primaire et les configurations des colonnes prédéfinies.

  • Configurez la table de données en fonction de vos besoins métier. Le tableau suivant décrit les paramètres de configuration.

    Paramètre	Description
    Colonne de clé primaire auto-incrémentée	Lors de la création d'une table de données, définissez une colonne de clé primaire qui n'est pas une clé de partition comme colonne de clé primaire auto-incrémentée. Lors de l'écriture des données dans la table, il n'est pas nécessaire de spécifier une valeur pour cette colonne ; Tablestore en génère une automatiquement.
    Versions des données et TTL	Utilisez les versions de données et la fonctionnalité Time to Live (TTL) pour gérer efficacement les données, ce qui permet de réduire l'utilisation du stockage et de diminuer les coûts associés.
    Autoriser les mises à jour	Par défaut, écrivez des données dans une table de données en appelant l'opération API UpdateRow. Modifiez ce paramètre après la création de la table. Important Si vous prévoyez d'utiliser la fonctionnalité Time to Live (TTL) pour un index de recherche, interdisez les écritures utilisant l'opération API UpdateRow.
    Débit de lecture/écriture réservé	Pour les instances haute performance utilisant le , configurez le débit de lecture/écriture réservé d'une table de données selon vos besoins.
    Index secondaire	Tablestore propose des index secondaires locaux et globaux afin de répondre aux exigences de requête avec différentes garanties de cohérence en lecture. Créez un ou plusieurs index secondaires lors de la création d'une table de données. Remarque Pour utiliser un index secondaire, prédéfinissez une ou plusieurs colonnes non clés primaires ainsi que leurs types de données dans la table de données. Ces colonnes peuvent servir de colonnes d'index ou de colonnes incluses dans l'index. Ajoutez ou supprimez des colonnes prédéfinies après la création de la table.
    Chiffrement des données	Tablestore offre un chiffrement des données au repos pour garantir leur sécurité. Configurez le chiffrement des données lors de la création d'une table de données.
    Transaction locale	Après avoir activé les transactions locales pour une table de données, créez une transaction locale au sein d'une seule valeur de clé de partition et effectuez des opérations de lecture et d'écriture sur les données dans le cadre de cette transaction. Important Activez les transactions locales pour une table de données via la console Tablestore ou le SDK Tablestore pour Java version 5.11.0 ou ultérieure. Si vous n'avez pas activé les transactions locales lors de la création de la table mais que vous en avez besoin par la suite, soumettez un ticket pour demander son activation.

• Mettre à jour la configuration de la table

  Modifie la configuration d'une table de données spécifiée, telle que le Time to Live (TTL), le nombre maximal de versions, le décalage maximal de version et les paramètres Stream. Ajustez également le débit de lecture/écriture réservé pour les tables de données dans les instances haute performance utilisant le .

• Lister les noms de table

  Récupère les noms de toutes les tables de données de l'instance actuelle.

• Interroger la description de la table

  Interroge les informations relatives à une table de données spécifiée, telles que son schéma et les détails du débit de lecture/écriture réservé.

• Supprimer une table de données

  Supprime une table de données spécifiée.

Créer une table de données

Suivez les étapes ci-dessous pour créer une table de données dans la console Tablestore.

1. Accédez à la page Instance Management.

   1. Connectez-vous à la console Tablestore.

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

   3. Sur la page Overview, cliquez sur l'alias d'une instance ou sur Instance Management dans la colonne Actions de l'instance.

2. Sous l'onglet Instance Details, cliquez sur Create Table.

3. Dans la boîte de dialogue Create Table, configurez les paramètres comme indiqué dans le tableau suivant.

   Paramètre	Description
   Nom de la table	Nom de la table de données, qui doit être unique au sein d'une instance. Le nom doit comporter entre 1 et 255 octets et peut contenir des lettres majuscules, des lettres minuscules, des chiffres et des traits de soulignement (_). Il doit commencer par une lettre ou un trait de soulignement (_).
   Clé primaire	Une ou plusieurs colonnes identifiant de manière unique une ligne dans la table. Saisissez un nom de clé primaire, sélectionnez un type de données, puis cliquez sur Add Primary Key Column pour ajouter une autre colonne de clé primaire. Définissez jusqu'à quatre colonnes de clé primaire pour une table. La première colonne de clé primaire constitue la clé de partition. Vous ne pouvez pas modifier la configuration ni l'ordre des colonnes de clé primaire après la création de la table. Important Tablestore vous permet de définir une colonne de clé primaire comme colonne de clé primaire auto-incrémentée. Une table ne peut comporter qu'une seule colonne de clé primaire auto-incrémentée, et la clé de partition ne peut pas être une colonne auto-incrémentée. Si une colonne de clé primaire est définie comme auto-incrémentée, il n'est pas nécessaire de spécifier sa valeur lors de l'écriture d'une ligne ; Tablestore génère automatiquement une valeur unique et strictement croissante au sein de la clé de partition. Un nom de clé primaire doit comporter entre 1 et 255 octets et peut contenir des lettres majuscules, des lettres minuscules, des chiffres et des traits de soulignement (_). Il doit commencer par une lettre ou un trait de soulignement (_). Le type de données d'une clé primaire peut être STRING, INTEGER ou BINARY.
   Autoriser les mises à jour	Indique s'il est permis d'écrire des données en appelant l'opération API UpdateRow. Si ce paramètre n'est pas défini ou s'il est réglé sur Yes, l'écriture des données via UpdateRow est autorisée. Pour utiliser la fonctionnalité Time to Live (TTL) d'un index de recherche, définissez ce paramètre sur No. Cela interdit les écritures utilisant l'opération API UpdateRow.
   Chiffrement	Indique s'il faut activer le chiffrement des données au repos. Par défaut, cette fonctionnalité est désactivée. Pour l'activer, activez l'interrupteur Encryption. Important Le chiffrement des données au repos ne peut pas être désactivé une fois activé. Agissez avec prudence.
   Type de chiffrement	Type de chiffrement des données. Ce paramètre est requis uniquement si vous activez l'interrupteur Encryption. Valeurs valides : CMK of KMS : Tablestore BYOK-based Key : Tablestore Important Avant d'utiliser l'option BYOK, créez une clé logicielle dans la console KMS, puis créez un rôle personnalisé et configurez ses autorisations. Pour plus d'informations, consultez la rubrique Chiffrement des données.
   ID de clé	ID de la clé. Ce paramètre est requis uniquement si le Encryption Type est défini sur BYOK-based Key.
   ARN du rôle	Alibaba Cloud Resource Name (ARN) du rôle. Ce paramètre est requis uniquement si le Encryption Type est défini sur BYOK-based Key.

4. (Facultatif) Dans la boîte de dialogue Create Table, configurez les paramètres avancés ou créez un index secondaire.

   Effectuez cette étape si vous devez configurer des paramètres avancés pour la table de données, tels que le Time to Live (TTL), ou créer un index secondaire.

   Paramètres avancés

   Pour gérer la durée de conservation des données dans la table, spécifiez un Time to Live (TTL). Pour conserver plusieurs versions de données pour la même clé primaire, indiquez le nombre maximal de versions. Pour plus d'informations, consultez la rubrique Versions des données et TTL.

   Pour les instances haute performance en mode CU, spécifiez un débit de lecture ou d'écriture réservé pour la table de données afin de réduire les coûts. Pour plus d'informations, consultez la rubrique Débit de lecture/écriture réservé.

   1. Activez l'interrupteur Advanced Settings.

   2. Configurez les paramètres avancés comme indiqué dans le tableau suivant.

      Paramètre	Description
      Time to Live	Durée de conservation des données, en secondes. Lorsque les données dépassent cette période, le système supprime automatiquement les données expirées. La valeur doit être un entier supérieur ou égal à 86 400 (un jour), ou -1. Une valeur de -1 indique que les données n'expirent jamais.
      Nombre maximal de versions	Nombre maximal de versions pouvant être conservées pour chaque colonne d'attribut. Si le nombre de versions de données dans une colonne d'attribut dépasse cette valeur, le système supprime automatiquement les anciennes versions. La valeur doit être un entier non nul.
      Décalage maximal de version	Écart maximal autorisé entre une version de données spécifiée et l'heure système actuelle, en secondes. Cette valeur doit être un entier positif. Une opération d'écriture réussit uniquement si la version spécifiée pour chaque colonne se situe dans la plage d'écart autorisée par rapport à l'heure d'écriture. La plage de versions valide pour une colonne d'attribut est [max{WriteTime - MaxVersionOffset, WriteTime - TTL}, WriteTime + MaxVersionOffset).
      Débit de lecture réservé	Ce paramètre est pris en charge uniquement pour les instances haute performance utilisant le . Débit de lecture ou d'écriture réservé pour la table de données. La valeur doit être un entier compris entre 0 et 100 000. L'unité est l'unité de capacité (CU). Si vous définissez le Reserved Read Throughput ou le Reserved Write Throughput sur une valeur supérieure à 0, Tablestore alloue et réserve les ressources correspondantes pour la table de données. Une fois la table créée, la facturation du débit réservé commence immédiatement. Si vous définissez le Reserved Read Throughput ou le Reserved Write Throughput sur 0, Tablestore n'alloue ni ne réserve de ressources pour la table de données.
      Débit d'écriture réservé
      Activer la transaction locale	La fonctionnalité de transaction locale est désactivée par défaut. Pour effectuer des opérations de lecture et d'écriture atomiques sur une ou plusieurs lignes au sein de la même partition, activez l'interrupteur Enable Local Transaction.
      Activer la prise en charge des versions de ligne	La prise en charge des versions de ligne est désactivée par défaut. Pour utiliser une table globale, activez l'interrupteur Enable Row Versioning. Vous ne pouvez pas désactiver ce paramètre une fois activé. Les limitations suivantes s'appliquent lorsque la prise en charge des versions de ligne est activée : Une seule ligne peut comporter au maximum 256 colonnes. Vous ne pouvez pas spécifier manuellement les numéros de version lors de l'écriture des données. Les numéros de version sont générés automatiquement par le système. Lorsque vous effectuez une opération de mise à jour, le système doit d'abord lire la version actuelle de la ligne, ce qui introduit une petite charge de lecture supplémentaire.
      Configuration rapide pour la table globale	Lorsque vous utilisez une table globale, activez l'interrupteur Quick Set Global Table Dependency. Le système modifie automatiquement les configurations associées à la table globale. Les modifications de configuration sont les suivantes : Time To Live : -1 Nombre maximal de versions : 1 Décalage maximal de version : 2147483647 Activer la prise en charge des versions de ligne : Activé

   Configurer un index secondaire

   Lorsqu'une application doit interroger des données en fonction de différents attributs, utilisez ces attributs comme colonnes de clé primaire d'un index secondaire pour permettre des requêtes rapides. Pour plus d'informations, consultez la rubrique index secondaire.

   1. Activez l'interrupteur Create a secondary index.

   2. Cliquez sur Add, puis saisissez un nom et sélectionnez un type de données pour la colonne prédéfinie.

      Le nom d'une colonne prédéfinie doit comporter entre 1 et 255 octets et peut contenir des lettres majuscules, des lettres minuscules, des chiffres et des traits de soulignement (_). Il doit commencer par une lettre ou un trait de soulignement (_).

      Le type de données d'une colonne prédéfinie peut être STRING, INTEGER, BINARY, FLOAT ou BOOLEAN.

   3. Cliquez sur Add Secondary Index, saisissez un nom d'index, sélectionnez la clé primaire de l'index et, éventuellement, choisissez des colonnes prédéfinies ainsi qu'un type d'index.

      Important

      Le nom de l'index ne peut pas être identique au nom de la table de données. Le nom de l'index et celui de la table de données doivent tous deux être uniques au sein de l'instance.

      Un nom d'index doit comporter entre 1 et 255 octets et peut contenir des lettres majuscules, des lettres minuscules, des chiffres et des traits de soulignement (_). Il doit commencer par une lettre ou un trait de soulignement (_).

      • La Primary Key peut être constituée des colonnes de clé primaire de la table de données et des colonnes prédéfinies. Sélectionnez plusieurs colonnes. La Pre-defined Column ne peut être sélectionnée que parmi les colonnes prédéfinies de la table de données. Sélectionnez plusieurs colonnes, mais elles ne doivent pas être identiques aux colonnes de clé primaire de l'index.

      • Le Index Type peut être Global ou Local.

        Important

        La première colonne de clé primaire d'un index secondaire global peut être n'importe quelle colonne de clé primaire ou colonne prédéfinie. La première colonne de clé primaire d'un index secondaire local doit être identique à la première colonne de clé primaire de la table de données.

        Un index secondaire global synchronise de manière asynchrone les données des colonnes indexées et des colonnes de clé primaire de la table de données vers la table d'index. La latence de synchronisation se situe généralement de l'ordre de la milliseconde. Un index secondaire local synchronise de manière synchrone les données des colonnes indexées et des colonnes de clé primaire de la table de données vers la table d'index. Après l'écriture des données dans la table de données, elles sont immédiatement disponibles pour les requêtes depuis la table d'index.

5. Cliquez sur Create.

Gérer les tables de données

Effectuez les opérations suivantes pour gérer vos tables de données selon vos besoins.

Développement et intégration

Utilisez les SDK suivants ou l'interface CLI Tablestore pour effectuer des opérations sur les tables de données.