從寫入表格擷取變更

當使用者在寫入表格的 可編輯的欄 中新增資料時，其變更不會套用至應用程式的資料模型。它們也是暫時的—變更會儲存在 Qlik 管理的 變更儲存區 中 90 天，之後會被刪除。

您可以透過變更儲存 API擷取這些變更。這些變更可以用於多種方式，包括：

• 將變更載入 QVD 或應用程式，以在 Qlik Cloud 中永久儲存和使用。

• 擷取變更，並將其新增至外部系統，例如 Excel 試算表或 SQL 資料庫。

• 將資料動態整合到自動化程序中，例如傳送電子郵件和採購庫存。

• 建置您自己的應用程式，並將對 變更儲存 API 的呼叫整合到您的營運工作流程中。

必要條件

在您存取變更儲存區中儲存的資料之前，您需要能夠存取 變更儲存 API。若要執行此操作，您需要：

• Qlik Cloud 租用戶的 API 金鑰。請參閱 管理 API 金鑰。

• 由租用戶管理員指派的、用於處理寫入資料表的所需權限。請參閱：

  • 設定註記表格的權限 (基於容量的訂閱)

  • 設定註記表格的權限 (基於使用者的訂閱)

• 變更儲存 ID。這可以在工作表上建立寫入資料表後擷取。請參閱 使用變更儲存。

可用於擷取變更的工具

您可以使用下列工具從 變更儲存 API 擷取並使用變更：

• Qlik Automate

• 適用於 Qlik 指令碼和資料準備的 REST 連接器。

如需範例和使用案例，請參閱：

• 使用 Qlik Automate 提取寫入表格變更

• 使用 REST 連接器擷取寫入表格變更

• 註記表格的使用案例

使用 Qlik Automate 提取寫入表格變更

儲存在變更儲存區中的變更，可以使用 Change Store 中的 Qlik Cloud Services 連接器裡的 Qlik Automate 區塊來提取。此連接器會自動連接到自動化擁有者的 Qlik 帳戶，因此不需要額外的驗證步驟。

更多關於 Qlik Automate 的資訊可在 Qlik Automate 取得。

列出來自變更儲存的目前變更

List Current Changes From Change Store 區塊使用 API 端點 /changes/tabular-views，並且只會傳回每個儲存格的最新值 (換句話說，它會傳回目前的值)。它會將這些值以物件清單的形式傳回，其中每個物件都包含主索引鍵和變更值。每個記錄也會擴充一個 updatedAt 時間戳記，用於記錄上次更新的日期時間，以及一個 updatedBy 使用者 ID，用於識別進行此變更的使用者。

列出變更儲存歷史記錄

List Change Store History區塊使用 API 端點/changes，並傳回每個儲存格的完整歷史記錄。如果儲存格已更新多次，則此區塊將傳回每個值、userId以及updatedAt時間戳記，針對每次更新。

使用範本

如果您要將資料擷取到 MySQL 資料庫，也可以從自動化範本開始。下列範本可在 Insights to Action 下取得：

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

這些範本會將 Change Store 區塊（如上所述）與其他區塊排列在一起，以協助您更快地擷取資料。只需調整區塊參數即可連線到您的資源。如需詳細逐步解說，請參閱這篇社群文章。

使用 REST 連接器擷取寫入表格變更

此範例說明如何將 REST 連線設定至 變更儲存 API。此連線可用來從 API 提取，然後將變更載入回應用程式或儲存至 Qlik Cloud 中的 QVD。

請執行下列動作：

1. 在 Qlik Cloud 分析 中，建立 REST 連接器的新連線。請參閱 新增資料連線。

2. 針對連線設定下列參數：

   • URL： your_tenant_base_URL/api/analytics/change-stores/your change store id/changes/tabular-views

   • Additional request parameters

     • Query parameters

       • Limit (Key): 100 (Value)

     • Query headers

       • Authorization (Key): Bearer your_API_token (Value)

   • Pagination type： Next URL

     • 'Next url' path： links/next/href