Partage via

Créer une table dans Azure Cosmos DB for Table avec .NET

  • Article

S’APPLIQUE À : Table

Les tables dans Azure Cosmos DB for Table sont des unités de gestion pour plusieurs éléments. Avant de pouvoir créer, interroger ou gérer des éléments, vous devez d’abord créer une table.

Nommer une table

Dans Azure Cosmos DB, une table est analogue à une table de base de données relationnelle.

Notes

Avec les comptes d’API pour Table, lorsque vous créez votre première table, une base de données par défaut est automatiquement créée dans votre compte Azure Cosmos DB.

Voici quelques règles rapides lorsque vous nommez une table :

  • Le nom de la table doit comporter entre 3 et 63 caractères
  • Les noms de table ne peuvent contenir que des lettres minuscules, des chiffres ou le caractère de tiret (-).
  • Le nom des tables doit commencer par une lettre minuscule ou un chiffre.

Créer un tableau

Pour créer une table, appelez l’une des méthodes suivantes :

Créer une table de façon asynchrone

L’exemple suivant illustre la création d’une table de manière asynchrone :

// New instance of TableClient class referencing the server-side table
TableClient tableClient1 = client.GetTableClient(
    tableName: "adventureworks-1"
);

await tableClient1.CreateAsync();

La méthode TableCient.CreateAsync lève une exception si une base de données portant le même nom existe déjà.

Créer une table de manière asynchrone s’il n’en existe pas déjà

L’exemple suivant crée une table de façon asynchrone uniquement si elle n’existe pas déjà dans le compte :

// New instance of TableClient class referencing the server-side table
TableClient tableClient2 = client.GetTableClient(
    tableName: "adventureworks-2"
);

await tableClient2.CreateIfNotExistsAsync();

La méthode TableClient.CreateIfNotExistsAsync crée uniquement une table si elle n’existe pas déjà. Cette méthode est utile pour éviter les erreurs si vous exécutez le même code plusieurs fois.

Étapes suivantes

Maintenant que vous avez créé une table, utilisez le guide suivant pour créer des éléments.

Créer un élément