Tablestore:Mettre à jour les colonnes d'attribut d'une table de mappage

Prérequis

• Initialisez une instance OTSClient. Pour plus d'informations, consultez la rubrique Initialiser une instance OTSClient.

• Créez une table de mappage. Pour plus d'informations, consultez la rubrique Créer des tables de mappage.

Remarques d'utilisation

• L'instruction ALTER TABLE permet de mettre à jour une colonne d'attribut uniquement dans une table de mappage créée via l'instruction CREATE TABLE. Vous ne pouvez pas utiliser l'instruction ALTER TABLE pour modifier une colonne d'attribut dans une table de mappage générée automatiquement pour une table suite à 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, exécutez l'instruction ALTER TABLE plusieurs fois.

• L'instruction ALTER TABLE met à jour uniquement le schéma de la table de mappage. Le schéma de la table Tablestore sous-jacente 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, 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 à une table de mappage

  L'exemple de code suivant montre comment ajouter la colonne colvalue de type BIGINT à une table de mappage nommée exampletable :

  $request = array(
      'query' => 'alter table exampletable add column colvalue bigint',
  );
  $response = $otsClient->sqlQuery($request);
  print json_encode($response, JSON_PRETTY_PRINT);

• Supprimer une colonne d'attribut d'une table de mappage

  L'exemple de code suivant montre comment supprimer la colonne colvalue de type BIGINT d'une table de mappage nommée exampletable :

  $request = array(
      'query' => 'alter table exampletable drop column colvalue',
  );
  $response = $otsClient->sqlQuery($request);
  print json_encode($response, JSON_PRETTY_PRINT);

FAQ

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

Références

• Pour accélérer les requêtes et les calculs de données SQL, créez un index secondaire ou un index de recherche. Pour plus d'informations, consultez les rubriques Politique de sélection des index et Poussée des calculs.

• Après avoir mis à jour les colonnes d'attribut d'une table de mappage, vous pouvez exécuter l'instruction SELECT pour interroger et analyser les données via cette table. Pour plus d'informations, consultez la rubrique Interroger des données.

• Pour consulter la description d'une table, exécutez l'instruction DESCRIBE. Pour plus d'informations, consultez la rubrique Consulter les informations sur les tables.

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

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

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