Hızlı Başlangıç: Python için NoSQL için Azure Cosmos DB kitaplığı
UYGULANANLAR: NoSQL
Kapsayıcılarınızdaki verileri sorgulamak ve tek tek öğeler üzerinde ortak işlemler gerçekleştirmek üzere Python için NoSQL için Azure Cosmos DB istemci kitaplığını kullanmaya başlayın. Azure Geliştirici CLI'sını kullanarak ortamınıza en düşük çözümü dağıtmak için bu adımları izleyin.
API başvuru belgeleri | Kitaplık kaynak kodu | Paketi (PyPI) | Azure Geliştirici CLI
Önkoşullar
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
- GitHub hesabı
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
- Azure Geliştirici CLI'sı
- Docker Desktop
Ayarlama
Bu projenin geliştirme kapsayıcısını ortamınıza dağıtın. Ardından Azure Geliştirici CLI'sını (azd
) kullanarak NoSQL için Azure Cosmos DB hesabı oluşturun ve kapsayıcılı örnek bir uygulama dağıtın. Örnek uygulama örnek verileri yönetmek, oluşturmak, okumak ve sorgulamak için istemci kitaplığını kullanır.
Önemli
GitHub hesapları, hiçbir ücret ödemeden depolama ve çekirdek saat yetkilendirmesi içerir. Daha fazla bilgi için bkz . GitHub hesapları için dahil edilen depolama ve çekirdek saatler.
Projenin kök dizininde bir terminal açın.
kullanarak
azd auth login
Azure Geliştirici CLI'sinde kimlik doğrulaması Tercih ettiğiniz Azure kimlik bilgilerini kullanarak CLI'da kimlik doğrulaması yapmak için araç tarafından belirtilen adımları izleyin.azd auth login
Projeyi başlatmak için kullanın
azd init
.azd init
Başlatma sırasında benzersiz bir ortam adı yapılandırın.
İpucu
Ortam adı, hedef kaynak grubu adı olarak da kullanılır. Bu hızlı başlangıç için kullanmayı
msdocs-cosmos-db-
göz önünde bulundurun.Kullanarak
azd up
Azure Cosmos DB hesabını dağıtın. Bicep şablonları ayrıca örnek bir web uygulaması dağıtır.azd up
Sağlama işlemi sırasında aboneliğinizi ve istediğiniz konumu seçin. Sağlama işleminin tamamlanmasını bekleyin. İşlem yaklaşık beş dakika sürebilir.
Azure kaynaklarınızın sağlanması tamamlandıktan sonra, çalışan web uygulamasının URL'si çıktıya eklenir.
Deploying services (azd deploy) (✓) Done: Deploying service web - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io> SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
Tarayıcıda web uygulamanıza gitmek için konsoldaki URL'yi kullanın. Çalışan uygulamanın çıkışını gözlemleyin.
İstemci kitaplığını yükleme
İstemci kitaplığı, Python Paket Dizini aracılığıyla kitaplık olarak azure-cosmos
kullanılabilir.
Bir terminal açın ve klasöre
/src
gidin.cd ./src
Henüz yüklü değilse, kullanarak paketini
pip install
yükleyinazure-cosmos
.pip install azure-cosmos
Ayrıca, henüz yüklü değilse paketi yükleyin
azure-identity
.pip install azure-identity
src/requirements.txt dosyasını açıp gözden geçirerek ve
azure-identity
girdilerinin her ikisinin de var olduğunuazure-cosmos
doğrulayın.
Nesne modeli
Veri Akışı Adı | Açıklama |
---|---|
CosmosClient |
Bu sınıf birincil istemci sınıfıdır ve hesap genelindeki meta verileri veya veritabanlarını yönetmek için kullanılır. |
DatabaseProxy |
Bu sınıf, hesaptaki bir veritabanını temsil eder. |
ContainerProxy |
Bu sınıf öncelikli olarak kapsayıcıda veya kapsayıcıda depolanan öğelerde okuma, güncelleştirme ve silme işlemleri gerçekleştirmek için kullanılır. |
PartitionKey |
Bu sınıf mantıksal bölüm anahtarını temsil eder. Bu sınıf birçok yaygın işlem ve sorgu için gereklidir. |
Kod örnekleri
Şablondaki örnek kod adlı bir veritabanı ve adlı cosmicworks
products
kapsayıcıyı kullanır. Kapsayıcı ad products
, kategori, miktar, benzersiz tanımlayıcı ve her ürün için satış bayrağı gibi ayrıntıları içerir. Kapsayıcı, mantıksal bölüm anahtarı olarak özelliğini kullanır /category
.
İstemcinin kimliğini doğrulama
Çoğu Azure hizmeti için uygulama istekleri yetkilendirilmelidir. DefaultAzureCredential
Uygulamalarınız ile NoSQL için Azure Cosmos DB arasında parolasız bağlantı uygulamak için tercih edilen yol olarak türünü kullanın. DefaultAzureCredential
birden çok kimlik doğrulama yöntemini destekler ve çalışma zamanında hangi yöntemin kullanılacağını belirler.
Önemli
Ayrıca parolaları, bağlantı dizesi veya diğer kimlik bilgilerini kullanarak Azure hizmetlerine yönelik istekleri doğrudan yetkilendirilebilirsiniz. Ancak bu yaklaşım dikkatli kullanılmalıdır. Geliştiriciler bu gizli dizileri güvenli olmayan bir konumda asla açığa çıkarmamak için dikkatli olmalıdır. Parolaya veya gizli anahtara erişim kazanan herkes veritabanı hizmetinde kimlik doğrulaması yapabilir. DefaultAzureCredential
, anahtarları depolama riski olmadan parolasız kimlik doğrulamasına izin vermek için hesap anahtarına göre gelişmiş yönetim ve güvenlik avantajları sunar.
Bu örnek türün CosmosClient
yeni bir örneğini oluşturur ve bir DefaultAzureCredential
örneği kullanarak kimlik doğrulaması yapar.
credential = DefaultAzureCredential()
client = CosmosClient(url=endpoint, credential=credential)
Veritabanı alma
adlı cosmicworks
mevcut veritabanını almak için kullanınclient.get_database_client
.
database = client.get_database_client("cosmicworks")
Kapsayıcı alma
kullanarak database.get_container_client
mevcut products
kapsayıcıyı alın.
container = database.get_container_client("products")
Öğe oluşturma
JSON'da seri hale getirmek istediğiniz tüm üyeleriyle yeni bir nesne oluşturun. Bu örnekte, türün benzersiz bir tanımlayıcısı ve kategori, ad, miktar, fiyat ve satış alanları vardır. kullanarak container.upsert_item
kapsayıcıda bir öğe oluşturun. Bu yöntem, zaten varsa öğeyi etkili bir şekilde değiştirerek öğeyi "upsert" eder.
new_item = {
"id": "70b63682-b93a-4c77-aad2-65501347265f",
"category": "gear-surf-surfboards",
"name": "Yamba Surfboard",
"quantity": 12,
"sale": False,
}
created_item = container.upsert_item(new_item)
Öğe okuma
Hem benzersiz tanımlayıcıyı (id
) hem de bölüm anahtarı alanlarını kullanarak nokta okuma işlemi gerçekleştirin. Belirli bir öğeyi verimli bir şekilde almak için kullanın container.read_item
.
existing_item = container.read_item(
item="70b63682-b93a-4c77-aad2-65501347265f",
partition_key="gear-surf-surfboards",
)
Sorgu öğeleri
kullanarak container.GetItemQueryIterator
bir kapsayıcıdaki birden çok öğe üzerinde sorgu gerçekleştirin. Bu parametreli sorguyu kullanarak belirtilen kategorideki tüm öğeleri bulun:
SELECT * FROM products p WHERE p.category = @category
queryText = "SELECT * FROM products p WHERE p.category = @category"
results = container.query_items(
query=queryText,
parameters=[
dict(
name="@category",
value="gear-surf-surfboards",
)
],
enable_cross_partition_query=False,
)
Sorgunun sonuçları arasında döngü yapın.
items = [item for item in results]
output = json.dumps(items, indent=True)
İlgili içerik
- .NET Hızlı Başlangıcı
- JavaScript/Node.js Hızlı Başlangıç
- Java Hızlı Başlangıcı
- Hızlı Başlangıç'a gidin