如何用 opik export / opik import 在不同 Opik 安装环境之间迁移项目数据【免费下载链接】comet-llmDebug, evaluate, and monitor your LLM applications, RAG systems, and agentic workflows with comprehensive tracing, automated evaluations, and production-ready dashboards.项目地址: https://gitcode.com/GitHub_Trending/co/comet-llm当你把 Opik 从一个安装环境搬到另一个例如自建环境迁到 Opik Cloud或 staging 迁到 production需要把某个项目下的 traces、spans、datasets、prompts 和 experiments 一起带过去。Opik Python SDK 自带的opik export和opik import两个 CLI 命令就是为此设计的export 把项目数据落地为本地 JSON 文件import 再从文件写回目标安装。注意它与opik migrate的分工——opik migrate只在同一 workspace 内跨项目搬数据跨安装环境的迁移必须走 export/import文档中对此有明确说明见 migrate_data.mdx。前提条件已安装 Opik Python SDKCLI 随 SDK 提供文档各处的标准安装方式是pip install opik持有源和目标两个环境的 API key。CLI 通过OPIK_API_KEY和OPIK_URL_OVERRIDE两个环境变量决定连哪个 Opik 服务OPIK_URL_OVERRIDE即 Opik server URL迁移过程中每条命令用不同的 key/URL 前缀即可区分源与目标无需改配置文件。命令形态按项目组织自 2026-06-23 版本releases2.0.77–2.1.5起opik export/opik import都需要项目参数ITEM取值之一必须紧跟在WORKSPACE PROJECT之后。如果你的 SDK 版本较旧opik export --help会显示旧命令形态需要先升级 SDK。以下示例沿用文档中的示例值workspace 名my-workspace、项目名my-project执行时替换为你自己的 workspace 和项目名source_key、dest_key与两个 URL 替换为实际值。第一步从源环境导出数据在能访问源环境机器上执行OPIK_API_KEYsource_key OPIK_URL_OVERRIDEhttps://source.opik.example.com \ opik export my-workspace my-project all --path ./migration_dataall表示导出项目内全部内容traces、spans、datasets、prompts、experiments。ITEM也支持dataset、traces、experiment、prompt四个单实体类型需要时可只导某一部分# 只导出项目 traces opik export my-workspace my-project traces # 只导出一个指定数据集 opik export my-workspace my-project dataset my-test-dataset # 按时间过滤导出 tracesOQL 语法 opik export my-workspace my-project traces \ --filter created_at 2024-01-01T00:00:00Z # 以 CSV 形式导出用于分析 opik export my-workspace my-project traces --format csv --path ./csv_data导出产物按 ID 组织在磁盘上path/workspace/projects/project_id/目录下有一个project.json内容为{id, name}以及按 ID 命名的条目文件dataset_id.json、prompt_id.json、experiment_id.json、trace_id.json。人类可读的名称存在文件数据里路径只含 ID因此不会出现/、:或空格问题。命令行上传的是项目名CLI 负责名称与 ID 的相互解析。判断导出的数据是否落盘成功直接查看./migration_data/my-workspace/projects/下是否出现对应项目的目录及上述文件即可这是文档定义的磁盘布局。第二步导入到目标环境import 的第一参数仍然是源 workspace——它只用来在--path下定位导出的文件path/WORKSPACE/projects/与目标端写入哪个 workspace 无关。import 与 export 使用同一个--path文件路径不需要调整。先预览再实际执行是文档推荐的做法OPIK_API_KEYdest_key OPIK_URL_OVERRIDEhttps://dest.opik.example.com \ opik import my-workspace my-project all --path ./migration_data --dry-run--dry-run只预览将要导入的内容不做任何变更。确认无误后去掉该参数执行正式导入# 目标端同 workspace、同项目 OPIK_API_KEYdest_key OPIK_URL_OVERRIDEhttps://dest.opik.example.com \ opik import my-workspace my-project all --path ./migration_data # 目标端不同 workspaceWORKSPACE 参数仍用于定位本地文件 OPIK_API_KEYdest_key OPIK_URL_OVERRIDEhttps://dest.opik.example.com \ opik import my-workspace my-project all --path ./migration_data --to-workspace dest-workspace # 目标端同时更换 workspace 和 project OPIK_API_KEYdest_key OPIK_URL_OVERRIDEhttps://dest.opik.example.com \ opik import src-workspace my-project all --path ./migration_data \ --to-workspace dest-workspace --to-project new-project项目名会与每个导出的project.json中记录的name匹配。--to-workspace选项自 2026-07-06 版本引入用于跨 workspace 导入而无需重新整理导出目录如果你的 SDK 版本早于该 release此参数不存在。单实体导入与 export 对称例如opik import my-workspace my-project dataset my-dataset opik import my-workspace my-project traces中断后的续传import 自动支持续传如果导入中途被中断断网、进程被杀等在同一台机器上重新执行同一条命令即可CLI 会依据本地migration_manifest.db从断点继续而不是从头开始。2026-07-13 版本还修复了opik export ... all在大项目上的内存问题——导出改为分块写盘且中断的导出同样可以从项目中间断点恢复。因此大项目迁移建议直接用all中断后重跑同一条命令。结果核对与已知限制核对导入结果在目标环境 UI 或 API 中检查项目下的 datasets、prompts、experiments、traces 是否齐全磁盘侧可通过--dry-run的输出确认 CLI 解析到了正确的源项目与条目。prompts、experiments、datasets 的 tags 自 2026-07-13 版本起在 export/import 中端到端保留更早版本会静默丢失核对时注意 SDK 版本。每条命令只作用于单个项目WORKSPACE PROJECT定位没有整 workspace 级别的导出命令要迁移多个项目就对每个项目各跑一轮 export/import。完整参数以opik export --help/opik import --help为准。更多上下文见 export_data.mdx 的 Command-line tools 一节以及 2026-06-23 变更日志 中对命令形态变化的说明。【免费下载链接】comet-llmDebug, evaluate, and monitor your LLM applications, RAG systems, and agentic workflows with comprehensive tracing, automated evaluations, and production-ready dashboards.项目地址: https://gitcode.com/GitHub_Trending/co/comet-llm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考