导出您的数据

​

概览

将您的工作区数据导出为 CSV，用于备份、报表或迁移。 使用场景：

• 定期备份 — 保留您的数据副本
• 外部报表 — 在 Excel、Google 表格或 BI 工具中分析数据
• 迁移 — 将数据迁移到其他系统
• 批量更新 — 通过导出、编辑并重新导入来更新记录

​

您需要了解的内容

​

导出限制

• 每次导出最多 20,000 条记录
• 仅导出可见列
• 仅导出筛选后的记录（基于您当前视图）

​

权限

导出数据需要拥有 “Export CSV” 权限。 如果您没有此选项，请联系您的工作区管理员。

​

步骤 1：导航到对象

前往您要导出的对象：

• People — 用于联系人
• Companies — 用于组织
• Opportunities — 用于商机
• 自定义对象 — 您创建的任意对象

​

步骤 2：配置您的视图

**重要：**导出仅包含您当前视图中可见的内容。

​

添加/移除列

1. 单击 Options → Fields（或单击列末尾的 +）
2. 勾选您要导出的字段
3. 取消勾选不需要的字段

​

筛选记录（可选）

如果您只需要数据的一个子集：

1. 单击 Filter
2. 添加筛选条件（例如：“Created date > January 1, 2024”）
3. 仅会导出匹配的记录

​

排序记录（可选）

1. 单击列标题进行排序
2. 导出将遵循您的排序顺序

​

步骤 3：导出数据

1. 单击表格右上角的 ⋮ 图标
2. 选择 Export view
3. 选择 CSV 文件的保存位置
4. 等待下载完成

​

导出内容

​

关系字段

关系 ID 仅在关系的**“多”端**导出：

• People 导出 包含一个 companyId 列（People → Company 关系）
• Companies 导出 不包含 peopleIds（Companies 是“一”端）

这意味着您可以使用 People 的导出来重新导入并保持与 Company 的链接，但您需要在导入 Companies 之后再次导入 People 以重新创建这些关系。

​

针对特定目的的导出

​

用于备份

1. 创建一个显示所有字段的视图
2. 移除所有筛选器以包含所有记录
3. 分别导出每种对象类型
4. 将导出文件存储在安全位置
5. 设置重复提醒（每周/每月）

​

用于外部报表

1. 只包含您进行分析所需的字段
2. 应用筛选器以聚焦相关数据
3. 考虑按您将要分析的字段进行排序

​

用于批量更新

1. 导出您要更新的记录
2. 包含唯一标识符（email、domain 或 id）
3. 编辑导出的文件
4. 重新导入以更新记录 参见：如何更新现有记录

​

用于迁移

如果您为迁移到其他系统而进行导出：

1. 分别导出每个对象 — People、Companies、Opportunities 等。
2. 包含 ID 字段 — 有助于维护关系
3. 记录字段映射 — 记录 Twenty 字段如何映射到您的目标系统

​

处理大型数据集（20,000+ 条记录）

导出限制为 20,000 条记录。 对于更大的数据集：

​

选项 1：分批导出

1. 添加一个筛选器（例如 “Created date” 范围）
2. 导出第一批
3. 更改筛选器
4. 导出下一批
5. 在电子表格中合并文件

用于分批的示例筛选器：

• 按日期范围（1 月、2 月、3 月……）
• 按所有者（团队成员 A、团队成员 B……）
• 按状态（活跃、非活跃……）

​

选项 2：使用 API

API 没有记录数量限制：

1. 在 Settings → Developers 中获取您的 API 密钥
2. 使用 GraphQL API 查询记录
3. 在您的应用程序中处理结果

参见：API 文档

​

技巧与最佳实践

​

创建导出视图

保存专为导出配置的视图：

1. 配置列和筛选器
2. 单击 View options → Save as new view
3. 将其命名为 “Export - [Purpose]“

​

保护您的导出文件安全

导出的文件可能包含敏感数据：

• 存放在安全位置
• 不再需要时删除旧的导出文件
• 共享导出文件时请谨慎

​

导出前检查

​

常见问题

​

下一步

• 如何更新现有记录 — 编辑并重新导入您的导出文件
• 如何通过 API 导入数据 — 适用于大型数据集
• API 文档 — 构建自定义导出工作流