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.
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
Initialisez un client. Pour plus d'informations, consultez la rubrique Initialiser un client Tablestore.
-
Si vous souhaitez créer une table de mappage pour un index de recherche, vous devez au préalable créer l'index de recherche.
Paramètres
|
Paramètre |
Description |
|
query |
L'instruction SQL. Configurez ce paramètre en fonction de la fonctionnalité requise. |
Exemples
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 TABLEen 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
DESCRIBEpour 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é.
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
Après avoir créé une table de mappage, vous pouvez mettre à jour ses colonnes d'attribut, consulter ses informations, récupérer la liste des noms des tables de mappage, interroger les informations d'index associées ou encore la supprimer. Pour plus d'informations, consultez les rubriques suivantes : Mettre à jour les colonnes d'attribut d'une table de mappage, Interroger les informations d'une table, Interroger les noms des tables de mappage, Interroger les informations d'index d'une table et Supprimer une table de mappage.
Utilisez l'instruction
SELECTpour interroger et analyser les données d'une table de mappage. Pour plus d'informations, consultez la rubrique Interroger des données.