如何使用Python向RavenDB插入JSON格式数据

你现有代码存在3个核心问题，会导致插入失败甚至覆盖原有数据：

• 传入的文档ID格式错误：直接写"TiktokPosts"会把该ID对应的文档（如果ID和集合重名会直接覆盖集合根文档）替换为当前单条数据，不符合插入新文档的预期。RavenDB 标准文档ID格式为集合名/唯一标识，比如TiktokPosts/1。
• 代码存在多余缩进，document_store = DocumentStore(...)开头的前置缩进会触发Python缩进语法错误。
• 证书配置如果是连接云服务实例，pfx字段必须传入客户端证书文件的本地绝对路径，不能用占位符；本地无认证部署的测试实例不需要传certificate参数。

另外注意两个使用规范：

• DocumentStore 是连接池对象，全局只需要初始化一次，不要每次操作数据都新建实例重复调用initialize()，会造成连接资源浪费。
• 新手如果不需要自定义文档ID，调用store()方法时可以不传ID参数，RavenDB 会自动生成符合规则的自增ID，不会出现ID冲突覆盖问题。

可直接运行的正确实现代码如下：

# 先安装官方SDK：pip install ravendb
from ravendb import DocumentStore

# 基础连接配置
DB_URLS = ["https://你的RavenDB服务地址"]  # 本地默认部署填["http://127.0.0.1:8080"]
DB_NAME = "你的目标数据库名"
# 云服务证书配置，本地无认证实例可删除certificate参数
cert_config = {
    "pfx": "客户端证书pfx文件的本地绝对路径",
    "password": "证书对应的导出密码"
}

# 全局初始化一次文档存储实例
document_store = DocumentStore(urls=DB_URLS, database=DB_NAME, certificate=cert_config)
document_store.initialize()

# 待插入的JSON格式数据
insert_data = {
    "id": 123,
    "name": "BLA BLA BLA"
}

# 打开会话执行插入
with document_store.open_session() as session:
    # 自定义ID写法，必须保证ID唯一，格式为 集合名/唯一标识
    session.store(insert_data, key="TiktokPosts/001")
    # 自动生成ID写法（推荐新手使用，无覆盖风险）
    # session.store(insert_data)
    session.save_changes()

# 插入结果验证（可选）
with document_store.open_session() as session:
    result = session.load("TiktokPosts/001")
    print("插入成功，查询结果：", result)

内容的提问来源于stack exchange，提问作者o akka