You need to enable JavaScript to run this app. Azure SDK for Python操作CosmosDB报AttributeError问题求解
优惠活动
大模型
产品
解决方案
定价
更多

Azure SDK for Python操作CosmosDB报AttributeError问题求解

错误产生原因

  • 本地安装的azure-cosmos Python SDK版本过低:get_database_client 是v4.0.0及以上版本才提供的API,低于该版本的SDK没有该方法,直接调用就会抛出属性不存在的错误。
  • 密钥传入格式错误:你初始化CosmosClient时传入的密钥是字典结构,而官方要求直接传入密钥字符串,即使SDK版本正确,后续也会触发鉴权错误。
  • 额外注意:如果你的df是pandas DataFrame类型,直接遍历df只能拿到列名,无法拿到每行的完整数据,后续插入也会失败。

解决方案

  1. 升级azure-cosmos SDK到最新稳定版本,执行命令:
pip install --upgrade azure-cosmos
  1. 按照如下规则修改代码:
    • 调整密钥传入格式,直接传入密钥字符串
    • 遍历DataFrame时转为逐行读取字典格式
    • 确保每个插入的item包含必填的id字段(CosmosDB要求每条数据必须有唯一的id属性)

修正后的参考代码如下:

from azure.cosmos import CosmosClient

url = '你的CosmosDB账户URI'
key = '你的CosmosDB主密钥字符串'
client = CosmosClient(url, credential=key)
database_name = 'My-database'
database = client.get_database_client(database_name)
container_name = 'My-table'
container = database.get_container_client(container_name)

# 遍历ADX查询结果转为可插入的item格式
for _, row in df.iterrows():
    item = row.to_dict()
    # 若ADX查询结果无唯一id字段,手动生成即可
    if 'id' not in item:
        item['id'] = str(row.name)
    container.upsert_item(item)

内容的提问来源于stack exchange,提问作者Nayden Van

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 16:45:04