Tous les produits
Search
Centre de documentation

Tablestore:Use SQL queries in the Tablestore console

Dernière mise à jour :Aug 20, 2026

Créez des tables de mappage SQL, exécutez des instructions SQL et exportez les résultats de requête dans la console Tablestore pour interroger et valider des volumes de données réduits.

Prérequis

  • Si vous utilisez un utilisateur RAM, accordez l'autorisation "Action": "ots:SQL*".

  • Une table de données

Étape 1 : Créer une table de mappage

  1. Connectez-vous à la . Modifiez la région et le groupe de ressources en haut de la page si nécessaire.

  2. Sur la page Overview, cliquez sur le nom de l'instance ou sur Instances.

  3. Cliquez sur l'onglet Query by Executing SQL Statement, puis sur l'icône d'ajout dans l'arborescence de gauche pour ouvrir la boîte de dialogue Create Mapping Table.

    Remarque

    Si aucune table de mappage n'existe, la boîte de dialogue Create Mapping Table s'affiche automatiquement. Vous pouvez également créer une table de mappage à l'aide d'une instruction CREATE TABLE dans l'éditeur SQL. Pour plus d'informations, consultez Opérations DDL.

  4. Configurez les paramètres suivants dans la boîte de dialogue.

    Paramètre

    Description

    Table Type

    Valeurs valides :

    • Common Table (par défaut) : crée un mappage pour une table de données.

    • Time Series Table : crée un mappage pour une table de séries temporelles.

    Table Name

    Sélectionnez la table de données ou la table de séries temporelles pour laquelle vous souhaitez créer un mappage.

    Mapping Mode

    Ce paramètre est disponible uniquement lorsque Table Type est défini sur Common Table. Valeurs valides :

    • Mapping Table for Table (par défaut) : crée un mappage pour une table de données existante.

    • Mapping Table for Search Index : crée un mappage pour un index de recherche existant.

    Advanced Settings

    Ce paramètre est disponible uniquement lorsque Mapping Mode est défini sur Mapping Table for Table. Activez cette option pour configurer les paramètres suivants :

    • Consistency Mode : Eventual Consistency (par défaut. Les nouvelles données sont interrogables en quelques secondes.) ou Strong Consistency (les nouvelles données sont immédiatement interrogables).

    • Inaccurate Aggregation : Yes (par défaut. Privilégie les performances au détriment de la précision) ou No.

    Search Index Name

    Ce paramètre est disponible uniquement lorsque Mapping Mode est défini sur Mapping Table for Search Index. Sélectionnez l'index de recherche à lier à la table de mappage.

    Mapping Table Name

    Nom de la table de mappage. En mode de mappage de table, le nom correspond à celui de la table de données et ne peut pas être modifié. En mode de mappage d'index de recherche ou en mode de table de séries temporelles, saisissez un nom personnalisé.

    Enable Analytical Store

    Ce paramètre est disponible uniquement lorsque Table Type est défini sur Time Series Table. Activez cette option pour utiliser Analytical store afin de stocker et d'analyser les données de séries temporelles à moindre coût.

    Important

    Si vous avez créé une table de mappage SQL avec l'option Enable Analytical Store activée, vous devez supprimer la table de mappage SQL du magasin analytique avant de supprimer ce dernier. Sinon, la suppression échoue.

  5. Cliquez sur Next: Generate SQL Statement.

    L'instruction SQL permettant de créer la table de mappage est générée automatiquement. Exemple :

    CREATE TABLE `test_table` (
        `pk1` VARCHAR(1024),
        `pk2` BIGINT(20),
        `col_a` BIGINT(20),
        `col_b` BIGINT(20),
        `col_c` MEDIUMTEXT,
        `col_d` MEDIUMTEXT,
        PRIMARY KEY(`pk1`, `pk2`)
    );
    Remarque
    • Le schéma doit inclure toutes les colonnes que vous prévoyez d'interroger.

    • Assurez-vous que les types de données du mappage correspondent à ceux de la table de données. Pour plus d'informations sur les correspondances de types de données, consultez Mappage des types de données.

  6. Modifiez le schéma de la table de mappage selon vos besoins, sélectionnez l'instruction SQL, puis cliquez sur Execute SQL Statement.

    Une fois l'instruction exécutée, le résultat s'affiche dans la section Execution Result.

    Remarque

    Vous ne pouvez sélectionner et exécuter qu'une seule instruction SQL à la fois. Si aucune instruction n'est sélectionnée, la première est exécutée par défaut.

Étape 2 : Interroger les données

Après avoir créé une table de mappage, exécutez des instructions SELECT dans l'onglet Query by Executing SQL Statement. Pour plus d'informations sur la syntaxe SQL, consultez Instructions DQL.

Exemple : interrogez les trois premières lignes de test_table.

SELECT * FROM test_table LIMIT 3;

Exemple de sortie :

+------+-----+-------+-------+--------+--------+
| pk1  | pk2 | col_a | col_b | col_c  | col_d  |
+------+-----+-------+-------+--------+--------+
| row1 |   1 |    10 |   100 | apple  | extra1 |
| row2 |   2 |    20 |   200 | banana | extra2 |
| row3 |   3 |    30 |   300 | apple  | extra3 |
+------+-----+-------+-------+--------+--------+
3 Rows

Pour exporter les résultats, cliquez sur Data Export. Vous pouvez exporter jusqu'à 2 000 lignes sous forme de fichier CSV.

Références