鏈結模板：載入資料至 Wdata

Load Data to Wdata 模板透過取代現有資料集或新增新資料集，將資料帶入Wdata 表。此模板最常用作現有鏈的一部分，但也可添加到任何需要將資料集上傳到表的工作流程中。

要求

執行此鏈之前，必須先建立目標 Wdata 表。
此模板由三個鏈組成。每個鏈必須單獨發佈到您的工作區。
檔案名稱必須包含 .csv 或 .tsv 副檔名。例如："File_Name_Example.csv"："File_Name_Example.csv"。
資料集的最大建議檔案大小為 300 MB。進一步瞭解檔案大小建議。

尋找範本

載入資料至 WData 模版位於Templates 畫面的 Workiva Chains 區段。

以下是如何找到它：

在 Chain Builder 中，移至Templates dynamic_feed索引標籤。
從上方功能表選擇Workiva Chains 。
在右上方搜尋Load Data to Wdata | Primary Chain 並開啟範本。
找到範本後，按一下New Chain 將其部署到您的工作區。

注意： 一旦配置完成，此模板中的每個鏈都必須發佈到工作區。

設定範本

此模板由三個鏈組成：Primary Chain、Replace Dataset Chain 和 Add New Dataset Chain。當主鏈部署到您的工作區時，兩個子鏈 (新增/取代) 會自動與它一起部署。

以下是每個 Chain 的詳細說明：

主鏈：此鏈決定在您的資料表中是否有資料集與鏈正在載入的資料集具有相同的名稱。如果找到匹配的資料集，鏈會擷取匹配資料集的資訊，並根據您為父鏈設定的運行時輸入「載入方法」，將資料重定向到兩個子鏈之一。
取代資料集鏈 ：此鏈會從您的資料表中移除匹配的資料集，並以新的資料集取代。如果在執行過程中發生錯誤，且選擇了回滾選項，則鏈會自動刪除新資料集，並恢復到要替換的資料集。
新增資料集鏈接 ：此鏈建立新資料集，並將其匯入您的資料表。新資料集必須具有唯一的檔案名稱，且該名稱目前未被表中任何其他資料集使用。

將這組鏈新增至現有鏈時，必須在「Run Chain」節點中設定主鏈的運行時輸入。子鏈不需要任何變更或設定。

您的設定應該如下所示：

變數

類型

名稱

目的

工作區變數

wsv-WdataLoadWarningThreshold

此變數作為資料集檔案大小的軟限制。任何超過所選臨界值的資料集都會觸發警告。由於處理時間會隨檔案大小而增加，因此較小的資料集處理速度會快很多。

建議的檔案大小提供足夠的警告，說明您的資料集可能已接近Wdata 檔案大小限制。觸發警告時，您可以考慮重構您的檔案或探索其他選項，以計算較大的檔案。

建議檔案大小: 150MB-200MB

動態鏈變量

dcv-Chain 結果

捕捉鏈在不同階段的狀態。必須填寫，且不應變更。

運行時間輸入

運行時間輸入	目的	欄位類型	必要的
表格 ID	輸入資料集將上傳至的 Wdata 資料表 ID。此 ID 也將用於判斷資料表內是否有任何重複的資料集。我們建議使用工作區變數來儲存資料表 ID；這可讓範本在多個程序中使用。	文字	是
檔案名稱	將匯入 Wdata 資料表的資料集名稱。檔案名稱告知連鎖哪些資料應該被取代。檔案名稱要求依所選鏈而異： Add New Dataset Chain - 檔案名稱不可用於該表的其他任何地方。 Replace Dataset Chain - 檔案名稱必須與要取代的資料集相符。注意: 檔案名稱必須包含 .csv 或 .tsv 副檔名。例如："File_Name_Example.csv"："File_Name_Example.csv"。	文字	是
資料檔案	將匯入表格的資料檔案。副檔名必須是 .csv 或 .tsv。注意: 數據檔案可以使用任何支援的 Wdata 表定界符。	檔案	是
載入方法	決定檔案應該取代現有資料集，還是新增為新資料集。選項: 取代資料集新增資料集	下拉式功能表	是
復原	如果發生錯誤，這會回退任何變更，並重新匯入原始資料集。預設設定為True 。僅適用於 Replace Dataset 載入方法。	布林（真/假）	否

疑難排解

查看您的鏈運行歷史，包括錯誤：

移至 Chain Builder 中的Monitor 標籤。
將滑鼠移至問號上，檢視鏈執行的狀態。

如果您的鏈觸發錯誤或無法更新正確資料，請執行下列檢查：

驗證所有三個鏈都已發佈到工作區。每個連鎖必須單獨發佈。
確保您的資料集使用支援的分隔符，且檔案名稱包含 .csv 或 .tsv 副檔名 ("File_Name_Example.csv")。
使用 Replace Dataset 載入方法時，請檢查檔案名稱是否與 Wdata 表中的現有檔案名稱相符。如果不匹配，鏈會簡單地向您的表中添加一個新文件，而不會替換舊文件。
相反，使用新增資料集載入方法時，請檢查 Wdata 表中的其他任何地方都沒有使用檔案名稱。如果使用了重疊的檔案名稱，連鎖將失敗。
確保與 Workiva 連線相關聯的OAuth2 授權具有適當的存取權。
輸入資料表 ID 時，請確認已輸入整個 ID，且沒有前導或尾隨空白。
檢查運行時間時間戳變數。這些不該用於檔案名稱中，因為它會為每個資料集建立唯一的檔案名稱 - 這表示鏈無法識別表中任何匹配的資料集。

列對應和其他鏈修改

如果您在匯入資料時遇到欄標題的問題，data prep 或其他指令都可以使用。

可選：標記匯入的資料集

匯入資料集時支援標籤，但我們建議在對原始資料進行任何變更之前，先從範本部署一組額外的資料鏈。一旦修改，除非其他資料表中的資料集使用相同的標記，否則該資料鏈很可能難以在其他資料表中重複使用。

若要在鏈中加入標記：

將以下運行時輸入新增至，從本模板部署的三個鏈 ：
- Tag-Key (文字欄位)
- Tag-Value (文字欄位)
編輯Primary Chain ，將運行時輸入傳遞至每個「Run Chain」事件：
在Replace Dataset Chain 和Add New Dataset Chain 中，編輯「Import New Dataset」指令節點以接受標籤執行時間輸入。

完成後，您匯入的資料集將以提供的標籤鍵和標籤值標籤。

其他資源

支援

社群

Workiva 支援中心