Vytvoření databáze ve službě Azure Cosmos DB for NoSQL pomocí .NET

Článek
08/15/2024

PLATÍ PRO: NoSQL

Databáze ve službě Azure Cosmos DB jsou jednotky správy pro jeden nebo více kontejnerů. Než budete moct vytvářet nebo spravovat kontejnery, musíte nejprve vytvořit databázi.

Pojmenování databáze

Ve službě Azure Cosmos DB je databáze analogická k oboru názvů. Při vytváření databáze tvoří název databáze segment identifikátoru URI, který se používá pro přístup k databázovému prostředku a všem podřízeným prostředkům.

Tady je několik rychlých pravidel při pojmenování databáze:

Názvy databází nesmí být prázdné.
Názvy databází nesmí být delší než 256 znaků.

Po vytvoření je identifikátor URI databáze v tomto formátu:

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

Tip

Další informace o omezeních názvů databází najdete v tématu Kvóty a limity služby.

Vytvořit databázi

Pokud chcete vytvořit databázi, zavolejte jednu z následujících metod:

CreateDatabaseAsync
CreateDatabaseIfNotExistsAsync

Asynchronní vytvoření databáze

Následující příklad vytvoří databázi asynchronně:

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

Metoda CosmosClient.CreateDatabaseAsync vyvolá výjimku, pokud databáze se stejným názvem již existuje.

Pokud ještě neexistuje, vytvořte databázi asynchronně.

Následující příklad vytvoří databázi asynchronně pouze v případě, že ještě v účtu neexistuje:

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

Metoda CosmosClient.CreateDatabaseIfNotExistsAsync vytvoří pouze novou databázi, pokud ještě neexistuje. Tato metoda je užitečná, pokud několikrát spustíte stejný kód, abyste se vyhnuli chybám.

Analýza odpovědi

Ve všech příkladech se odpověď z asynchronního požadavku přetypovala okamžitě na Database typ. Můžete chtít analyzovat metadata o odpovědi, včetně hlaviček a stavového kódu HTTP. True návratový typ pro CosmosClient.CreateDatabaseAsync a CosmosClient.CreateDatabaseIfNotExistsAsync metody je DatabaseResponse.

Následující příklad ukazuje CosmosClient.CreateDatabaseIfNotExistsAsync metoda vracející DatabaseResponse. Po vrácení můžete analyzovat vlastnosti odpovědi a nakonec získat podkladový databázový objekt:

// 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;

Další kroky

Teď, když jste vytvořili databázi, použijte další příručku k vytvoření kontejnerů.

Vytvoření kontejneru

Sdílet prostřednictvím