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

  • Artikel

GÄLLER FÖR: NoSQL

Databaser i Azure Cosmos DB är hanteringsenheter för en eller flera containrar. Innan du kan skapa eller hantera containrar måste du först skapa en databas.

Namnge en databas

I Azure Cosmos DB motsvarar en databas ett namnområde. När du skapar en databas utgör databasnamnet ett segment av den URI som används för att komma åt databasresursen och eventuella underordnade resurser.

Här följer några snabba regler när du namnger en databas:

  • Databasnamn får inte vara tomma.
  • Databasnamn får inte vara längre än 256 tecken.

När URI:n för en databas har skapats har den följande format:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>

Tips

Mer information om databasnamnsgränser finns i tjänstkvoter och gränser

Skapa en databas

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

Skapa en databas asynkront

I följande exempel skapas en databas asynkront:

// New instance of Database class referencing the server-side database
Database database1 = await client.CreateDatabaseAsync(
    id: "adventureworks-1"
);

Metoden CosmosClient.CreateDatabaseAsync genererar ett undantag om det redan finns en databas med samma namn.

Skapa en databas asynkront om den inte redan finns

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

// New instance of Database class referencing the server-side database
Database database2 = await client.CreateDatabaseIfNotExistsAsync(
    id: "adventureworks-2"
);

Metoden CosmosClient.CreateDatabaseIfNotExistsAsync skapar bara en ny databas 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.

Parsa svaret

I alla exempel hittills har svaret från den asynkrona begäran omvandlats omedelbart till Database typen . Du kanske vill parsa metadata om svaret, inklusive rubriker och HTTP-statuskoden. Den sanna returtypen för metoderna CosmosClient.CreateDatabaseAsync och CosmosClient.CreateDatabaseIfNotExistsAsync är DatabaseResponse.

I följande exempel visas metoden CosmosClient.CreateDatabaseIfNotExistsAsync som returnerar en DatabaseResponse. När det har returnerats kan du parsa svarsegenskaper och sedan så småningom hämta det underliggande databasobjektet :

// New instance of Database response class referencing the server-side database
DatabaseResponse response = await client.CreateDatabaseIfNotExistsAsync(
    id: "adventureworks-3"
);
// Parse additional response properties
Database database3 = response.Database;

Nästa steg

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

Skapa en container