Tous les produits
Search
Centre de documentation

Tablestore:Create a mapping table

Dernière mise à jour :Aug 18, 2026

Le SDK Tablestore pour Java crée une table de mappage pour une table ou un index de recherche existant afin d'activer l'accès aux données via SQL.

Prérequis

Avant de commencer, assurez-vous que :

Paramètres

Paramètre

Description

query

L'instruction SQL utilisée pour créer la table de mappage. Les types de colonnes spécifiés dans l'instruction doivent correspondre aux types de données des colonnes correspondantes dans la table de données.

Exemples

Remarque

Cette rubrique explique comment créer une table de mappage pour une table de données. Pour créer une table de mappage pour un index de recherche, remplacez l'instruction SQL dans l'exemple de code par celle destinée à une table de mappage d'index de recherche.

Contrairement à l'instruction CREATE TABLE d'une base de données relationnelle, cette instruction ne crée pas une nouvelle table. Elle établit un mappage SQL sur une table de données Tablestore existante, ce qui permet d'interroger des données NoSQL via SQL.

L'exemple suivant crée une table de mappage pour test_table en utilisant l'instruction create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk)).

const params = {
  // The SQL statement to create a mapping table.
  // Column types must match the data types of the corresponding columns in the data table.
  // For SQL syntax details, see the SQL reference documentation.
  query: "create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk))",
}

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 « Table 'instancename.tablename' doesn't exist ? » s'affiche lors de la création d'une table de mappage ?

  • Cause possible

    La table pour laquelle vous souhaitez créer une table de mappage n'existe pas.

  • Solution

    Vous pouvez exécuter l'instruction SQL CREATE TABLE pour créer une table de mappage uniquement pour une table ou un index de recherche existant. Assurez-vous que la table ou l'index de recherche cible existe bien.

Que faire si le message d'erreur « Table 'instancename.tablename' already exist? » s'affiche lors de la création d'une table de mappage ?

  • Cause possible

    Une table de mappage a déjà été créée pour la table.

    • L'utilisateur a créé manuellement une table de mappage pour la table.

    • Tablestore a automatiquement créé une table de mappage pour la table. Si vous utilisez directement des instructions SQL (telles que DESCRIBE, SELECT, etc.) pour interroger les données d'une table de données sans avoir préalablement créé de table de mappage, Tablestore génère automatiquement une table de mappage. Cette table de mappage automatique contient uniquement les colonnes de clé primaire et les colonnes prédéfinies de la table de données. Vous ne pouvez pas mettre à jour les colonnes d'attribut de cette table de mappage.

  • Solution

    Exécutez l'instruction DESCRIBE pour consulter le schéma de la table de mappage. Si le schéma ne répond pas à vos besoins métier, vous pouvez mettre à jour les colonnes d'attribut de la table de mappage. Si la table de mappage a été créée automatiquement par Tablestore, il est impossible de mettre à jour ses colonnes d'attribut. Dans ce cas, vous pouvez supprimer la table de mappage et en créer une nouvelle, à condition que cette suppression n'affecte pas votre activité.

Remarque

Pour connaître les erreurs courantes liées à la fonctionnalité d'interrogation SQL et leurs solutions, consultez la rubrique Résoudre les erreurs courantes des requêtes SQL.

Références