將其他工具的資料同步至 Notion

在此說明文件中

將 GitHub、Jira 和 Salesforce 等工具的資料匯入會自動更新的 Notion 同步資料庫中。

我們的資料庫同步功能讓您能與團隊的方案、文件和專案並行處理，並豐富來自其他工具的資訊。連接帳戶、選取要同步的內容，Notion 就會建立資料庫並保持更新。

您可以同步的內容

Notion 會管理這些同步，因此您無需自行建立或維護整合，即可連接帳戶並使用同步資料庫。

連接	您可以同步的資料	已建立的資料庫
GitHub	來自所選儲存庫的提取要求 (Pull requests)	提取請求
Jira	來自所選 Jira Cloud 空間的空間與工作項目	Jira 空間與 Jira 工作項目
Salesforce	帳戶、聯絡人與商機	帳戶、聯絡人與/或商機（視您的選擇而定）

來自其他工具的每筆記錄都會成為 Notion 資料庫中的一個頁面。來源中的欄位會成為資料庫屬性。

託管同步會單向更新資料：從已連接的工具同步至 Notion。同步屬性在 Notion 中為唯讀。若要變更同步的值，請在 GitHub、Jira 或 Salesforce 中進行更新。您將會在 Notion 中看到變更。

同步會在背景自動執行。更新時間取決於連接、資料量以及來源工具的要求限制。

提示：需要連接其他工具嗎？如果想要連接的工具不受支援，請使用 Notion Workers 來建立自訂同步，或依照我們為 Asana 和 GitLab 提供的預先建置 Workers 指南操作。

開始之前

您需要成為 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。

選取託管同步處理或 Worker

當其中一個支援的連接包含您需要的資料與設定時，請使用託管同步處理。Notion 會處理初始匯入、定期檢查以及特定於連接的同步處理邏輯。

當您需要建立自訂同步處理時，請使用 Notion Worker，例如從其他服務匯入，或在資料到達 Notion 之前進行轉換。

您需要準備的項目	託管資料庫同步	Worker
無需程式碼即可設定支援的連接	在 Notion 中選擇帳號、資料與設定。	需要程式碼與部署。
選擇資料結構	使用連接支援的記錄與屬性。	定義自訂結構描述與轉換。
自訂資料擷取方式	使用內建的同步行為。	實作您的工作流程所需的來源請求與同步行為。
維護同步	Notion 維護內建的連接邏輯。	您的團隊維護 Worker 程式碼；Notion 執行該 Worker。

例如，使用託管的 GitHub 同步來追蹤 Notion 中的提取要求。如果您需要自訂來源、額外的記錄類型，或是在匯入前合併資料的計算，請考慮使用 Worker。

疑難排解同步問題

記錄遺失

檢查所選的儲存庫、空間或物件類型、您的歷史記錄視窗，以及已連接帳號的來源權限。同時檢查首次匯入是否仍在執行，以及 Notion 瀏覽模式篩選器是否隱藏了記錄。

關聯遺失

如果已同步的頁面應該與另一個已同步的頁面建立關聯卻未建立，可能是因為您的歷史記錄視窗，或是相關頁面仍在匯入中。我們僅在兩個頁面都同步至 Notion 資料庫時才會建立關聯。

更新已停止

開啟同步的狀態詳細資料。如果授權已過期，請重新連接，或請您的來源管理員恢復存取權限。暫時性的來源中斷和請求限制可能會在 Notion 重試時延遲更新。

同步已達到列數限制

減少選取的資料或選擇較短的歷史記錄視窗。儲存前請先檢視影響：移除來源或縮短歷史記錄可能會移除已同步的頁面。連接專屬指南會說明變更選取項目時會發生什麼情況。