Sdílet prostřednictvím

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

  • Článek

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.

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

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

Vytvořit databázi

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

Vytvořit databázi

Následující příklad vytvoří databázi s metodou CosmosClient.create_database . Tato metoda vyvolá výjimku, pokud existuje databáze se stejným názvem.

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

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

Vytvoření databáze, pokud ještě neexistuje

Následující příklad vytvoří databázi s metodou CosmosClient.create_database_if_not_exists . Pokud databáze existuje, vrátí tato metoda nastavení databáze. V porovnání s předchozí metodou vytvoření tato metoda nevyvolá výjimku, pokud databáze již existuje. Tato metoda je užitečná, pokud několikrát spustíte stejný kód, abyste se vyhnuli chybám.

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.")

Asynchronní vytvoření databáze

Databázi můžete také asynchronně vytvořit pomocí podobných objektů a metod v oboru názvů azure.cosmos.aio . Použijte například metodu CosmosClient.create_database nebo metodu CosmoClient.create_database_if_not_exists .

Asynchronní práce je užitečná, když chcete paralelně provádět více operací. Další informace naleznete v tématu Použití asynchronního klienta.

Analýza odpovědi

V příkladech výše je odpověď z požadavků , DatabaseProxycož je rozhraní pro interakci s konkrétní databází. Z proxy serveru můžete přistupovat k metodám pro provádění operací v databázi.

Následující příklad ukazuje create_database_if_not_exists metoda vracející databázový objekt.

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

Další kroky

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

Vytvoření kontejneru