Tous les produits
Search
Centre de documentation

Tablestore:CreateTable

Dernière mise à jour :Sep 22, 2026

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

Remarques d'utilisation

  • Après la création d'une table de données, vous ne pouvez pas immédiatement effectuer des opérations de lecture et d'écriture sur celle-ci. 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. Si vous souhaitez 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. Le nom de la table 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 nommage et les types de données des colonnes de clé primaire doivent être STRING, INTEGER ou BINARY. Pour plus d'informations sur les conventions de nommage et les types de données, consultez Conventions de nommage 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 auxquelles des types de données spécifiques sont attribués par avance. Après avoir ajouté une colonne prédéfinie à une table de données, vous pouvez l'utiliser comme colonne d'attribut ou colonne de clé d'index d'une table d'index. Vous pouvez également ajouter des colonnes prédéfinies à une table de données après sa création. Pour plus d'informations, consultez 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. Le débit de lecture ou d'écriture réservé d'une table de données ne peut pas dépasser 100 000. Unité : unité de capacité (CU).

Vous pouvez appeler 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 s'il faut activer les attributs liés à Stream.

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 s'il faut activer la fonctionnalité de transaction locale 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

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