如何将CosmosDB数据导出为CSV或JSON文件？

针对Azure门户无直接导出途径、Storage Explorer导出功能禁用的情况，以下是几种可靠的导出方案：

1. 使用Azure CLI/PowerShell执行查询并导出 #

通过官方命令行工具直接查询Cosmos DB数据，将结果输出为CSV或JSON格式：

Azure CLI示例 #

# 导出为CSV
az cosmosdb sql query execute --account-name <你的Cosmos账户名> --database-name <数据库名> --container-name <容器名> --query "SELECT * FROM c" --output csv > cosmos_export.csv

# 导出为JSON
az cosmosdb sql query execute --account-name <你的Cosmos账户名> --database-name <数据库名> --container-name <容器名> --query "SELECT * FROM c" --output json > cosmos_export.json

提示：可通过自定义--query参数过滤需要导出的数据，避免全量导出占用资源。

2. 通过Azure Data Factory实现批量/定时导出 #

适合大规模数据或需要定期导出的场景：

• 创建Data Factory管道，添加**Azure Cosmos DB (SQL API)**作为数据源
• 配置接收器为Azure Blob Storage（选择CSV或JSON格式）
• 配置字段映射、分区策略后，运行管道完成导出
• 支持设置触发器实现定时自动导出

3. 自定义代码实现灵活导出 #

使用Cosmos DB SDK编写脚本，完全自定义导出逻辑：

Python示例（依赖azure-cosmos库） #

from azure.cosmos import CosmosClient
import csv
import json

# 初始化客户端
endpoint = "你的Cosmos DB端点"
key = "你的访问密钥"
client = CosmosClient(endpoint, key)

# 获取目标容器
database = client.get_database_client("数据库名")
container = database.get_container_client("容器名")

# 查询数据（支持跨分区查询）
query = "SELECT c.id, c.name, c.createdAt FROM c WHERE c.createdAt >= '2024-01-01'"
items = list(container.query_items(query=query, enable_cross_partition_query=True))

# 导出为CSV
with open("cosmos_data.csv", "w", newline="", encoding="utf-8") as csv_file:
    writer = csv.DictWriter(csv_file, fieldnames=items[0].keys())
    writer.writeheader()
    writer.writerows(items)

# 导出为JSON
with open("cosmos_data.json", "w", encoding="utf-8") as json_file:
    json.dump(items, json_file, indent=2, ensure_ascii=False)

提示：执行前先安装依赖pip install azure-cosmos

4. 使用Azure Cosmos DB Studio（开源工具） #

这是一款开源的可视化工具，支持查询后直接导出为CSV/JSON：

• 连接你的Cosmos DB账户后，执行查询语句
• 在查询结果面板选择导出选项，指定格式保存到本地

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