Tous les produits
Search

Ce produit

    Tablestore:Create a mapping table

    Centre de documentation

    Tablestore:Create a mapping table

    Dernière mise à jour :Oct 09, 2026

    Exécutez l'instruction CREATE TABLE pour créer une table de mappage associée à une table existante ou à un index de recherche. Lors de la création, spécifiez les noms et types des champs, les informations sur la clé primaire ainsi que le moteur d'exécution souhaité pour les requêtes de données, en fonction de vos besoins métier.

    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 indiqué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 dédié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 à l'aide de 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 ne pouvez exécuter l'instruction CREATE TABLE en SQL pour créer une table de mappage que 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 créée automatiquement 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, vous ne pouvez pas modifier ses colonnes d'attribut. Dans ce cas, supprimez la table de mappage et recréez-en une nouvelle, après vous être assuré que cette suppression n'affectera pas votre activité.

    Remarque

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

    Références