Dela via

Skapa en tabell i Azure Cosmos DB för tabell med hjälp av .NET

  • Artikel

GÄLLER FÖR: Bord

Tabeller i Azure Cosmos DB for Table är hanteringsenheter för flera objekt. Innan du kan skapa eller hantera objekt måste du först skapa en tabell.

Namnge en tabell

I Azure Cosmos DB motsvarar en tabell en tabell i en relationsdatabas.

Kommentar

När du skapar din första tabell med API för tabellkonton skapas automatiskt en standarddatabas i ditt Azure Cosmos DB-konto.

Här följer några snabbregler när du namnger en tabell:

  • Behåll tabellnamn mellan 3 och 63 tecken långa
  • Tabellnamn får bara innehålla gemener, siffror eller bindestreck (-).
  • Tabellnamn måste börja med en gemen bokstav eller siffra.

Skapa en tabell

Om du vill skapa en tabell anropar du någon av följande metoder:

Skapa en tabell asynkront

I följande exempel skapas en tabell asynkront:

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

await tableClient1.CreateAsync();

Metoden TableCient.CreateAsync utlöser ett undantag om det redan finns en databas med samma namn.

Skapa en tabell asynkront om den inte redan finns

I följande exempel skapas endast en tabell asynkront om den inte redan finns på kontot:

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

await tableClient2.CreateIfNotExistsAsync();

Metoden TableClient.CreateIfNotExistsAsync skapar bara en ny tabell om den inte redan finns. Den här metoden är användbar för att undvika fel om du kör samma kod flera gånger.

Nästa steg

Nu när du har skapat en tabell använder du nästa guide för att skapa objekt.

Skapa ett objekt