Adatbázis létrehozása az Azure Cosmos DB for NoSQL-ben a .NET használatával
A KÖVETKEZŐKRE 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 vagy 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 hasonló a névtérhez. 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.
Íme néhány gyors szabály az adatbázisok elnevezésére:
- 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>
Tipp
Az adatbázisnév korlátaival kapcsolatos további információkért lásd: szolgáltatási kvóták és korlátok
Adatbázis létrehozása
Adatbázis létrehozásához hívja meg az alábbi módszerek egyikét:
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 jelez, ha már létezik ilyen 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 akkor hasznos, ha többször is futtatja ugyanazt a kódot, így elkerülheti a hibákat.
A válasz elemzése
Az eddigi példákban az aszinkron kérés válasza azonnal a Database
típusra került. É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ódusok valódi visszatérési típusa a .DatabaseResponse
Az alábbi példa a CosmosClient.CreateDatabaseIfNotExistsAsync metódust mutatja be, amely 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, használja a következő útmutatót tárolók létrehozásához.