Tablestore:Update attribute columns of a mapping table

Prérequis

• Une instance OTSClient est initialisée. Pour plus d'informations, consultez la rubrique Initialiser une instance OTSClient.

• Une table de mappage est créée. Pour plus d'informations, consultez la rubrique Créer des tables de mappage.

Notes d'utilisation

• Vous ne pouvez exécuter l'instruction ALTER TABLE pour mettre à jour une colonne d'attribut que dans une table de mappage créée via l'instruction CREATE TABLE. Il n'est pas possible d'utiliser l'instruction ALTER TABLE pour modifier une colonne d'attribut dans une table de mappage générée automatiquement pour une table lors de l'exécution de l'instruction DESCRIBE.

• L'instruction ALTER TABLE permet d'ajouter ou de supprimer une seule colonne d'attribut à la fois dans une table de mappage. Pour modifier plusieurs colonnes, vous devez exécuter l'instruction ALTER TABLE plusieurs fois.

• L'exécution de l'instruction ALTER TABLE met à jour uniquement le schéma de la table de mappage. Le schéma de la table Tablestore sous-jacente, pour laquelle la table de mappage a été créée, reste inchangé.

• Il est impossible d'utiliser l'instruction ALTER TABLE pour ajouter ou supprimer les colonnes de clé primaire d'une table de mappage.

• Après l'exécution de l'instruction ALTER TABLE, le moteur SQL actualise la table de mappage de manière asynchrone. Cette opération peut prendre jusqu'à 30 secondes. Pendant cette période d'actualisation, la colonne ajoutée risque de ne pas apparaître lors des opérations censées renvoyer toutes les colonnes.

Paramètres

Exemples

• Ajouter une colonne d'attribut

  L'exemple suivant ajoute une colonne colvalue de type BIGINT à une table de mappage nommée exampletable :

  const params = {
    query: "alter table exampletable add column colvalue bigint",
  }
  
  client.sqlQuery(params, function (err, data) {
    if (err) {
      console.log('sqlQuery error:', err.toString());
    } else {
      console.log('sqlQuery success:', data);
    }
  });

• Supprimer une colonne d'attribut

  L'exemple suivant supprime la colonne colvalue d'une table de mappage nommée exampletable :

  const params = {
    query: "alter table exampletable drop column colvalue",
  }
  
  client.sqlQuery(params, function (err, data) {
    if (err) {
      console.log('sqlQuery error:', err.toString());
    } else {
      console.log('sqlQuery success:', data);
    }
  });

FAQ

• Que faire si le message d'erreur « Unsupported operation: Unsupported alter non-mapping table » s'affiche lors de la mise à jour des colonnes d'attribut d'une table de mappage ?

• Résoudre les erreurs courantes des requêtes SQL

Étapes suivantes

• L'optimisation de la sélection des index et le pushdown des calculs sont pris en charge (Optimisation des requêtes).

• Exécutez l'instruction SELECT pour interroger et analyser les données à l'aide de la table de mappage. Pour plus d'informations, consultez la rubrique Interroger des données.

• Exécutez l'instruction DESCRIBE pour afficher les détails de la table. Pour plus d'informations, consultez la rubrique Afficher les informations sur les tables.

• Exécutez l'instruction DROP MAPPING TABLE pour supprimer une table de mappage créée pour une table ou un index de recherche. Pour plus d'informations, consultez la rubrique Supprimer des tables de mappage.

• Exécutez l'instruction SHOW INDEX pour afficher les informations d'index d'une table. Pour plus d'informations, consultez la rubrique Afficher les informations d'index des tables.

• Exécutez l'instruction SHOW TABLES pour lister les tables de mappage de la base de données actuelle. Pour plus d'informations, consultez la rubrique Lister les noms des tables.