编辑

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

用于 Python 的 Azure Cosmos DB 库Azure Cosmos DB libraries for Python

概述Overview

在 Python 应用程序中使用 Azure Cosmos DB,以便在 NoSQL 数据存储中存储和查询 JSON 文档。Use Azure Cosmos DB in your Python applications to store and query JSON documents in a NoSQL data store.

了解有关 Azure Cosmos DB 的详细信息。Learn more about Azure Cosmos DB.

客户端库Client library

pip install pydocumentdb

管理库Management library

pip install azure-mgmt-cosmosdb

示例Example

使用类似于 SQL 的查询接口在 Azure CosmosDB 中查找匹配的文档:Find matching documents in Azure CosmosDB using a SQL-like query interface:

import pydocumentdb
import pydocumentdb.document_client as document_client

# Initialize the Python Azure Cosmos DB client
client = document_client.DocumentClient(config['ENDPOINT'], {'masterKey': config['MASTERKEY']})
# Create a database
db = client.CreateDatabase({ 'id': config['DOCUMENTDB_DATABASE'] })

# Create collection options
options = {
    'offerEnableRUPerMinuteThroughput': True,
    'offerVersion': "V2",
    'offerThroughput': 400
}

# Create a collection
collection = client.CreateCollection(db['_self'], { 'id': config['DOCUMENTDB_COLLECTION'] }, options)

# Create some documents
document1 = client.CreateDocument(collection['_self'],
    { 
        'id': 'server1',
        'Web Site': 0,
        'Cloud Service': 0,
        'Virtual Machine': 0,
        'name': 'some' 
    })

# Query them in SQL
query = { 'query': 'SELECT * FROM server s' }    

options = {} 
options['enableCrossPartitionQuery'] = True
options['maxItemCount'] = 2

result_iterable = client.QueryDocuments(collection['_self'], query, options)
results = list(result_iterable)

print(results)

示例Samples