Megosztás a következőn keresztül:

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

  • Cikk

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 3 és 63 karakter közötti hosszúak maradnak
  • Az adatbázisnevek csak kisbetűket, számokat vagy kötőjelet (-) tartalmazhatnak.
  • Az adatbázisneveknek kisbetűvel vagy számmal kell kezdődniük.

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:

-adatbázis létrehozása

Az alábbi példa egy adatbázist hoz létre a CosmosClient.create_database metódussal. Ez a metódus kivételt eredményez, ha egy azonos nevű adatbázis létezik.

try:
    database = client.create_database(id=DATABASE_ID)
    print(f"Database created: {database.id}")

except CosmosResourceExistsError:
    print("Database already exists.")

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

Az alábbi példa egy adatbázist hoz létre a CosmosClient.create_database_if_not_exists metódussal. Ha az adatbázis létezik, ez a metódus az adatbázis beállításait adja vissza. Az előző létrehozási metódushoz képest ez a metódus nem okoz kivételt, ha az adatbázis már létezik. Ez a módszer hasznos a hibák elkerüléséhez, ha ugyanazt a kódot többször futtatja.

try:
    database = client.create_database_if_not_exists(id=DATABASE_ID)
    print(f"Database created or returned: {database.id}")

except CosmosHttpResponseError:
    print("Request to the Azure Cosmos database service failed.")

Adatbázis aszinkron létrehozása

Az azure.cosmos.aio névtérben hasonló objektumokkal és metódusokkal aszinkron módon is létrehozhat adatbázist. Használja például a CosmosClient.create_database metódust vagy a CosmoClient.create_database_if_not_exists metódust.

Az aszinkron munka akkor hasznos, ha több műveletet szeretne párhuzamosan végrehajtani. További információ: Az aszinkron ügyfél használata.

A válasz elemzése

A fenti példákban a kérések válasza egy DatabaseProxy, amely egy adott adatbázissal való interakció felülete. A proxyn keresztül hozzáférhet az adatbázis műveleteinek végrehajtásához szükséges módszerekhez.

Az alábbi példa egy adatbázis-objektumot visszaadó create_database_if_not_exists metódust mutatja be.

database = client.create_database_if_not_exists(id=DATABASE_ID)
for container in database.list_containers():
    print(f'Container name: {container["id"]}')

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.

Tároló létrehozása