Adatbázis létrehozása az Azure Cosmos DB for NoSQL-ben a .NET használatával

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Az Azure Cosmos DB adatbázisai egy vagy több tároló felügyeleti egységei. A tárolók létrehozása és kezelése előtt először létre kell hoznia egy adatbázist.

Adatbázis elnevezése

Az Azure Cosmos DB-ben az adatbázis egy névtérhez hasonló. Adatbázis létrehozásakor az adatbázis neve az adatbázis-erőforrás és a gyermekerőforrások eléréséhez használt URI egy szegmensét képezi.

Az alábbiakban néhány gyors szabályt talál az adatbázisok elnevezésekor:

• Az adatbázisnevek nem lehetnek üresek.
• Az adatbázisnevek legfeljebb 256 karakter hosszúságúak lehetnek.

A létrehozás után az adatbázis URI-ja a következő formátumban van:

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

-adatbázis létrehozása

Adatbázis létrehozásához hívja meg az alábbi módszerek egyikét:

• CreateDatabaseAsync
• CreateDatabaseIfNotExistsAsync

Adatbázis aszinkron létrehozása

Az alábbi példa aszinkron módon hoz létre egy adatbázist:

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

A CosmosClient.CreateDatabaseAsync metódus kivételt eredményez, ha már létezik azonos nevű adatbázis.

Adatbázis aszinkron létrehozása, ha még nem létezik

Az alábbi példa csak akkor hoz létre aszinkron módon egy adatbázist, ha még nem létezik a fiókban:

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

A CosmosClient.CreateDatabaseIfNotExistsAsync metódus csak akkor hoz létre új adatbázist, ha még nem létezik. Ez a módszer hasznos a hibák elkerüléséhez, ha ugyanazt a kódot többször futtatja.

A válasz elemzése

Az eddigi példákban az aszinkron kérés válasza azonnal a Database típusra lett vetve. Érdemes lehet elemezni a válasz metaadatait, beleértve a fejléceket és a HTTP-állapotkódot. A CosmosClient.CreateDatabaseAsync és a CosmosClient.CreateDatabaseIfNotExistsAsync metódus valódi visszatérési típusa.DatabaseResponse

Az alábbi példa a CosmosClient.CreateDatabaseIfNotExistsAsync metódust mutatja be, amely egy DatabaseResponse értéket ad vissza. Miután visszaadta, elemezheti a választulajdonságokat, majd végül lekérheti a mögöttes adatbázis-objektumot :

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

Következő lépések

Most, hogy létrehozott egy adatbázist, a következő útmutató segítségével hozhat létre tárolókat.