Tous les produits
Search
Centre de documentation

Tablestore:Create a mapping table

Dernière mise à jour :Sep 21, 2026

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

Remarque

Pour plus d'informations sur la syntaxe, les types de champs et les paramètres de l'instruction CREATE TABLE, consultez la rubrique Opérations DDL.

Remarques d'utilisation

Les requêtes SQL sont prises en charge à partir de la version 5.0.0 du SDK Tablestore pour .NET. Assurez-vous d'avoir installé une version compatible du SDK.

Pour plus d'informations, consultez l'historique des versions du SDK Tablestore pour .NET .

Prérequis

Paramètres

Paramètre

Description

query

L'instruction SQL. Configurez ce paramètre en fonction de la fonctionnalité requise.

Exemples

Remarque

Cette rubrique explique comment créer une table de mappage pour une table. Si vous souhaitez créer une table de mappage pour un index de recherche, remplacez l'instruction SQL dans l'exemple de code par celle utilisée pour créer une table de mappage pour un index de recherche.

L'exemple suivant montre comment utiliser l'instruction CREATE TABLE pour créer une table de mappage pour la table test_table.

/// <summary>
/// Create a mapping table for a data table.
/// </summary>
/// <param name="otsClient"></param>
public static void CreateMappingTable(OTSClient otsClient)
{
    string sqlCommand = @"CREATE TABLE `test_table` (
        `pk0` VARCHAR(1024),
        `pk1` BIGINT(20),
        `col0` MEDIUMTEXT,
        `col1` BIGINT(20),
        `col2` DOUBLE,
        `col3` BOOL,
        `col4` MEDIUMBLOB,
        `date_col` MEDIUMTEXT,
        `geo_col` MEDIUMTEXT,
        `col0_v1` MEDIUMTEXT,
        `col0_v2` MEDIUMTEXT,
        PRIMARY KEY(`pk0`,`pk1`)
    );";

    SQLQueryRequest sqlQueryRequest = new SQLQueryRequest(sqlCommand);

    SQLQueryResponse sqlQueryResponse = otsClient.SQLQuery(sqlQueryRequest);
}

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. Vérifiez 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 d'une table de mappage. Si la table de mappage a été créée automatiquement par Tablestore, vous ne pouvez pas 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 aux requêtes SQL et leurs solutions, consultez la rubrique Résolution des erreurs courantes de requête SQL.

Références