Aracılığıyla paylaş

Python kullanarak NoSQL için Azure Cosmos DB'de veritabanı oluşturma

  • Makale

UYGULANANLAR: NoSQL

Azure Cosmos DB'deki veritabanları, bir veya daha fazla kapsayıcı için yönetim birimleridir. Kapsayıcıları oluşturabilmeniz veya yönetebilmeniz için önce bir veritabanı oluşturmanız gerekir.

Veritabanını adlandırma

Azure Cosmos DB'de veritabanı bir ad alanına benzer. Veritabanı oluşturduğunuzda, veritabanı adı veritabanı kaynağına ve alt kaynaklara erişmek için kullanılan URI'nin bir kesimini oluşturur.

Oluşturulduktan sonra, bir veritabanının URI'si şu biçimdedir:

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

veritabanı oluşturun

Veritabanı oluşturmak için aşağıdaki yöntemlerden birini çağırın:

veritabanı oluşturun

Aşağıdaki örnek yöntemiyle CosmosClient.create_database bir veritabanı oluşturur. Bu yöntem, aynı ada sahip bir veritabanı varsa bir özel durum oluşturur.

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

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

Henüz yoksa veritabanı oluşturma

Aşağıdaki örnek yöntemiyle CosmosClient.create_database_if_not_exists bir veritabanı oluşturur. Veritabanı varsa, bu yöntem veritabanı ayarlarını döndürür. Önceki oluşturma yöntemiyle karşılaştırıldığında, veritabanı zaten varsa bu yöntem bir özel durum oluşturmaz. Bu yöntem, aynı kodu birden çok kez çalıştırırsanız hatalardan kaçınmak için kullanışlıdır.

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

Zaman uyumsuz olarak veritabanı oluşturma

Ayrıca azure.cosmos.aio ad alanında benzer nesne ve yöntemleri kullanarak zaman uyumsuz olarak bir veritabanı oluşturabilirsiniz. Örneğin, yöntemini veya 'CosmoClient.create_database_if_not_exists yöntemini kullanınCosmosClient.create_database.

Birden çok işlemi paralel olarak gerçekleştirmek istediğinizde zaman uyumsuz çalışmak yararlı olur. Daha fazla bilgi için bkz . Zaman uyumsuz istemciyi kullanma.

Yanıtı ayrıştırma

Yukarıdaki örneklerde, isteklerden gelen yanıt, belirli bir DatabaseProxyveritabanıyla etkileşime geçmek için kullanılan bir arabirimdir. Ara sunucudan, veritabanında işlem gerçekleştirmek için yöntemlere erişebilirsiniz.

Aşağıdaki örnekte veritabanı nesnesi döndüren create_database_if_not_exists yöntemi gösterilmektedir.

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

Sonraki adımlar

Artık bir veritabanı oluşturduğunuza göre, kapsayıcı oluşturmak için sonraki kılavuzu kullanın.

Kapsayıcı oluşturma