Tous les produits
Search
Centre de documentation

Tablestore:CreateTable

Dernière mise à jour :Aug 18, 2026

Créez une table de données selon le schéma spécifié.

Notes d'utilisation

  • Après la création d'une table de données, vous ne pouvez pas immédiatement lire ou écrire des données. Dans la plupart des cas, ces opérations sont possibles une minute après la création de la table.

  • Vous pouvez créer jusqu'à 64 tables dans une seule instance. Pour créer davantage de tables au sein d'une même instance, soumettez un ticket.

Syntaxe de la requête

message CreateTableRequest {
    required TableMeta table_meta = 1;
    required ReservedThroughput reserved_throughput = 2; 
    optional TableOptions table_options = 3;
    repeated PartitionRange partitions = 4;
    optional StreamSpecification stream_spec = 5;
    optional SSESpecification sse_spec = 6;
    repeated IndexMeta index_metas = 7;
    optional bool enable_local_txn = 8;
}

Paramètre

Type

Obligatoire

Description

table_meta

TableMeta

Oui

Le schéma de la table de données. Configurez les paramètres suivants :

Important

Une fois la table de données créée, vous ne pouvez plus modifier son schéma.

  • table_name : le nom de la table de données. Ce nom doit être unique au sein de l'instance.

  • primary_key : les informations relatives à la clé primaire. Une clé primaire peut contenir entre une et quatre colonnes de clé primaire. Le nom de chaque colonne de clé primaire doit respecter les conventions de dénomination et les types de données doivent être STRING, INTEGER ou BINARY. Pour plus d'informations sur les conventions de dénomination et les types de données, consultez la rubrique Conventions de dénomination et types de données.

  • defined_Columns : les informations relatives aux colonnes prédéfinies. Si vous souhaitez utiliser un index secondaire pour une table de données, vous devez ajouter des colonnes prédéfinies lors de la création de cette table. Les colonnes prédéfinies sont des colonnes non clés primaires associées à des types de données spécifiques. Après avoir ajouté une colonne prédéfinie à une table de données, vous pouvez l'utiliser comme colonne d'attribut ou comme colonne de clé d'index dans une table d'index. Vous pouvez également ajouter des colonnes prédéfinies après la création de la table. Pour plus d'informations, consultez la rubrique Utiliser des colonnes prédéfinies

reserved_throughput

ReservedThroughput

Oui

Le débit de lecture ou d'écriture réservé de la table de données. Ce débit réservé ne peut pas dépasser 100 000. Unité : unité de capacité (CU).

Appelez l'opération UpdateTable pour modifier le débit de lecture ou d'écriture réservé d'une table de données.

table_options

TableOptions

Non

Les paramètres de la table, notamment time_to_live et max_versions.

partitions

PartitionRange

Non

La plage de partition de la table de données.

stream_spec

StreamSpecification

Non

Indique si les attributs liés à Stream sont activés.

sse_spec

SSESpecification

Non

Les configurations de chiffrement de la table de données.

index_metas

IndexMeta

Non

Le schéma de la table d'index.

enable_local_txn

bool

Non

Indique si la fonctionnalité de transaction locale est activée pour la table de données. Valeur par défaut : false.

Pour effectuer des opérations atomiques de lecture ou d'écriture sur une ou plusieurs lignes de données, activez la fonctionnalité de transaction locale pour la table de données.

Syntaxe de la réponse

message CreateTableResponse {
}

Utiliser les SDK Tablestore

Utilisez les SDK Tablestore suivants pour créer une table de données selon le schéma spécifié :