将其他工具中的数据同步到 Notion
将 GitHub、Jira 和 Salesforce 等工具中的数据引入到会自动更新的 Notion 数据库中。
我们的数据库同步功能让你可以将其他工具中的信息与团队的计划、文档和项目一起使用并进一步丰富。连接帐号，选择要同步的内容，Notion 就会创建数据库并保持其更新。
Notion 会管理这些同步，因此你可以连接帐号并使用同步的数据库，而无需自己构建或维护集成。
连接 | 你可以同步的数据 | 已创建的数据库 |
|---|---|---|
Github | 来自所选存储库的拉取请求 | 拉取请求 |
Jira | 来自所选 Jira Cloud 空间的空间和工作项 | Jira 空间和 Jira 工作项 |
Salesforce | 客户、联系人和商机 | 客户、联系人和/或商机（取决于所选内容） |
来自其他工具的每条记录都会成为 Notion 数据库中的一个页面。信息源中的字段将成为数据库属性。
托管同步单向更新数据：从已连接的工具到 Notion。同步的属性在 Notion 中为只读。要更改同步的值，请在 GitHub、Jira 或 Salesforce 中进行更新。你将在 Notion 中看到更改。
同步会在后台自动运行。更新时间因连接、数据量和源工具的请求限制而异。
提示：需要连接其他工具？如果不支持你想要连接的工具，请使用 Notion Workers 构建自定义同步，或按照我们为 Asana 和 GitLab提供的预构建 Worker 指南进行操作。
你需要成为 Notion 工作空间的成员，并拥有一个可访问你想要同步的数据的帐号。你的组织可能需要管理员批准连接或在源工具中授予访问权限。
你用于创建同步的帐号决定了 Notion 可以读取哪些数据。如果其权限发生更改或连接过期，同步可能需要你重新验证。
GitHub 同步和 Jira 同步需要商业版（或移动端商业版插件）。Salesforce 同步需要企业版。
在你的 Notion 工作空间中打开 设置 → 连接.
从 浏览 或 已安装 中打开你想要同步的连接（GitHub、Jira 或 Salesforce），然后从该连接的选项中选择 数据库同步.
连接一个帐号并完成该工具的授权步骤。
选择您想要同步的存储库、空间或对象类型。
选择要包含的历史记录范围。对于提供自定义属性的信息源（例如 Jira 和 Salesforce），你还可以选择要在同步中包含哪些自定义属性。
选择 创建同步。
Notion 会在你的 私人 侧边栏部分创建数据库。首次导入会在后台开始。你可以在记录仍在导入时打开数据库。
首次导入
Notion 会创建数据库结构，然后导入符合你设置的记录。大型导入可能需要更长时间，因为 Notion 会分批读取数据并遵循信息源工具的请求限制。
在首次导入运行时，数据库可能仅显示部分数据。你无需保持 Notion 打开，导入也会继续进行。
持续更新
首次导入后，Notion 会定期检查已连接的工具以获取新增或更改的记录，并更新已同步的属性。即使无人查看数据库，同步也会在后台持续进行。
通常情况下，我们预计更改会在几分钟或更短时间内同步到 Notion。
时间因连接、数据量和信息源工具的可用性而异。检查更改并不意味着每项更改都会立即出现在 Notion 中。Salesforce 默认每分钟检查一次更改；详情请参阅各连接的指南。
当信息源工具暂时限制请求或不可用时，Notion 会进行重试。如果同步需要新的授权或不同的权限，其状态会提示你如何操作。
历史记录窗口
你可以包含所有可用的历史记录，或将同步限制为在过去 30、90 或 365 天内更新的记录。历史记录窗口使用信息源记录的最后更新时间，而不是其创建日期。Salesforce 使用其系统修改时间。
随着时间的推移，窗口会向前移动。如果记录在窗口期内未更新，即使它在信息源工具中仍处于打开或活动状态，也可能会从数据库中移除。
提示：历史记录窗口可以删除页面。当记录超出该窗口时，其同步页面将从 Notion 中删除，包括你在自己的属性中添加到该页面的任何值。如果你需要保留较旧且未更改的记录，请选择所有可用的历史记录。
扩大窗口会导入更多匹配的记录。缩短窗口会移除不再符合条件的记录。这与 Notion 数据库筛选器不同，后者仅更改视图显示的内容。
你可以创建视图、筛选和排序记录，并添加你自己的 Notion 属性。例如，为拉取请求添加团队优先级，或为 Salesforce 客户添加账户规划状态。这些属性中的值将保留在 Notion 中.
为你的属性指定不同的名称，以免与同步管理的属性冲突。
数据库最初是私人页面。准备好后，使用 Notion 的页面权限共享它们。
提示: Notion 共享控制谁可以查看同步数据。拥有 Notion 数据库访问权限的人可能会看到他们在源工具中无法访问的记录。源权限不会复制到 Notion 中的每位查看者。请在共享前检查访问权限。
信息源工具中的权限更改可能会停止未来的更新，但不会删除 Notion 中已有的数据。当信息源访问权限发生更改时，请检查 Notion 数据库的共享设置。
返回连接的 数据库同步 设置，以查看同步状态、最近的运行信息以及任何错误详情。
状态 | 操作方法 |
|---|---|
正在初始化或回填 | 同步正在设置中或正在导入现有记录。请允许导入继续进行。 |
正常 | 同步正在正常运行。最近的信息源更改可能仍在处理中。 |
降级或失败 | 打开同步的错误详情以查看是什么延迟了更新。 |
需要采取行动： | 按照显示的说明操作，例如重新连接帐号或恢复源访问权限. |
已禁用 | 同步已暂停。你可以在同步设置中取消暂停. |
不可用 | 当前无法获取状态信息。请稍后再试。 |
最近的运行时间显示有活动。这并不保证每个信息源更改都已同步到 Notion。
当受支持的连接之一包含你所需的数据和设置时，请使用托管同步。Notion 会处理初始导入、定期检查以及特定于连接的同步逻辑.
当你需要构建自定义同步时，请使用 Notion Worker，例如从其他服务导入数据，或在数据到达 Notion 之前对其进行转换.
你需要的内容 | 托管数据库同步 | Worker |
|---|---|---|
无需代码即可设置受支持的连接 | 在 Notion 中选择帐号、数据和设置。 | 需要代码和部署。 |
选择数据结构 | 使用连接支持的记录和属性。 | 定义自定义架构和转换。 |
自定义数据获取方式 | 使用内置同步行为。 | 实现你工作流程所需的信息源请求和同步行为. |
维护同步 | Notion 维护内置连接逻辑。 | 你的团队维护 Worker 代码；Notion 运行该 Worker. |
例如，使用托管的 GitHub 同步在 Notion 中跟踪拉取请求。如果你需要自定义源、额外的记录类型或在导入前合并数据的计算，请考虑使用 Worker.
记录缺失
检查所选的存储库、空间或对象类型、你的历史记录窗口以及已连接帐号的源权限。还要检查首次导入是否仍在运行，以及 Notion 视图筛选器是否隐藏了记录.
关联缺失
如果一个已同步页面应该与另一个已同步页面关联但没有关联，可能是因为你的历史记录窗口，或者相关页面仍在导入中。我们只有在两个页面都同步到 Notion 数据库时才会创建关系。
更新已停止
打开同步的状态详情。如果授权已过期，请重新连接，或请你的源管理员恢复访问权限。临时源中断和请求限制可能会在 Notion 重试时延迟更新。
同步已达到行数限制
减少所选数据或选择更短的历史记录窗口。保存前请查看影响：删除源或缩短历史记录可能会删除已同步的页面。特定于连接的指南解释了更改选择时会发生什么。
对于现有的 Asana 或 GitLab 同步，请使用 Worker 替换指南：
