Creare una tabella in Azure Cosmos DB per il servizio Table tramite .NET

Importante

Si sta cercando una soluzione di database per scenari su larga scala con un contratto di servizio di disponibilità 99.999%, scalabilità automatica immediata e failover automatico in più aree? Prendere in considerazione Azure Cosmos DB per NoSQL.

In Azure Cosmos DB per Table, le tabelle sono unità di gestione per più elementi. Prima di poter creare o gestire elementi, è necessario creare una tabella.

Assegnare un nome a una tabella

Le tabelle in Azure Cosmos DB sono analoghe a quelle in un database relazionale.

Nota

Con gli account API for Table, quando si crea la prima tabella, un database predefinito viene creato automaticamente nell'account Azure Cosmos DB.

Crea una tabella

Per creare una tabella, usare uno dei metodi seguenti:

• CreateAsync
• CreateIfNotExistsAsync

Creare una tabella in modo asincrono

Nell'esempio seguente viene creata una tabella in modo asincrono:

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

await tableClient1.CreateAsync();

Il metodo TableCient.CreateAsync genera un'eccezione se esiste già un database con lo stesso nome.

Creare una tabella in modo asincrono se non è già presente

Nell'esempio seguente viene creata una tabella in modo asincrono solo se non ne esiste già una nell'account:

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

await tableClient2.CreateIfNotExistsAsync();

Il metodo TableClient.CreateIfNotExistsAsync creerà una nuova tabella solo se non ne esiste già una. Questo metodo è utile per evitare errori se si esegue lo stesso codice più volte.

Passaggi successivi

Dopo aver creato una tabella, usare la guida successiva per creare elementi.

Creare un elemento