使用UI將資料從您的Snowflake資料庫串流到Experience Platform
閱讀本指南,瞭解如何使用UI中的來源工作區將資料從您的Snowflake資料庫串流到Experience Platform。
快速入門
本教學課程需要您實際瞭解下列Experience Platform元件:
-
Experience Data Model (XDM) 系統: Experience Platform用來組織客戶體驗資料的標準化架構。
- 結構描述組合的基本概念:瞭解XDM結構描述的基本建置區塊,包括結構描述組合中的關鍵原則和最佳實務。
- 結構描述編輯器教學課程:瞭解如何使用結構描述編輯器使用者介面建立自訂結構描述。
-
Real-Time Customer Profile:根據來自多個來源的彙總資料,提供統一的即時消費者設定檔。
Authentication
閱讀串流資料 Snowflake 的必要條件設定指南,瞭解從Snowflake擷取串流資料至Experience Platform前,您需要完成的步驟相關資訊。
使用Snowflake Streaming來源將Snowflake資料串流到Experience Platform
在Experience Platform UI中,從左側導覽選取 來源 以存取來源工作區。 您可以從熒幕左側的目錄中選取適當的類別。 或者,您可以使用搜尋選項來尋找您要使用的特定來源。
在 資料庫 類別下,選取 Snowflake Streaming,然後選取 設定。
連線Snowflake串流帳戶 頁面隨即顯示。 您可以在此頁面使用新的或現有的證明資料。
建立新帳戶
若要建立新帳戶,請選取 新帳戶,並為您的帳戶提供名稱和選擇性說明。
若要使用基本驗證,請選取 Snowflake的基本驗證,並提供您Snowflake帳戶的認證。 完成後,請選取 連線到來源,並等待一段時間以建立連線。
閱讀Snowflake Streaming概觀,以取得有關收集所需認證的詳細資訊。
若要使用KeyPair驗證,請選取Snowflake的 KeyPair驗證,並提供您Snowflake帳戶的認證。 完成後,請選取 連線到來源,並等待一段時間以建立連線。
閱讀Snowflake Streaming概觀,以取得有關收集所需認證的詳細資訊。
若要使用現有帳戶,請選擇 現有帳戶,從清單中選取您的帳戶,然後選取 下一步。
選取資料 select-data
-
時間戳記欄必須存在於您的來源表格中,才能建立串流資料流。 Experience Platform需要時間戳記才能知道何時會擷取資料,以及何時會串流增量資料。 您可以回溯性地為現有連線新增時間戳記欄,並建立新的資料流。
-
確保範例來源資料檔中的資料欄位大小寫符合Snowflake對於識別碼大小寫解決的指引。 如需詳細資訊,請閱讀識別碼大小寫Snowflake 上的檔案。
選取資料步驟隨即顯示。 在此步驟中,您必須選取要匯入Experience Platform的資料、設定時間戳記和時區,並提供用於擷取原始資料的範例來源資料檔案。
使用畫面左側的資料庫目錄,並選取您要匯入至Experience Platform的表格。
接著,選取表格的時間戳記欄型別。 您可以在兩種時間戳記資料行型別之間選取: TIMESTAMP_NTZ
或TIMESTAMP_LTZ
。 如果您選取TIMESTAMP_NTZ
的欄型別,則必須也提供時區。 您的欄應該有非null的限制。 如需詳細資訊,請閱讀有關限制和常見問題的章節。
您也可以在此步驟中設定回填設定。 回填會決定最初要擷取的資料。 如果已啟用回填,則會在第一次排程擷取期間擷取指定路徑中的所有目前檔案。 如果沒有,則只會擷取在第一次內嵌執行與開始時間之間載入的檔案。 將不會擷取在開始時間之前載入的檔案。
選取 回填 切換以啟用回填。
最後,選取 選擇檔案 以上傳範例來源資料以協助建立對應集,該對應集將在後續步驟中用於將原始資料對應至Experience Data Model (XDM)。
完成後,選取 下一步 以繼續。
提供資料集和資料流詳細資料 provide-dataset-and-dataflow-details
接下來,您必須提供有關資料集和資料流的資訊。
資料集詳細資料 dataset-details
資料集是資料集合的儲存和管理結構,通常是包含方案 (欄) 和欄位 (列) 的表格。 成功內嵌至Experience Platform的資料會以資料集的形式保留在資料湖中。 在此步驟中,您可以建立新資料集或使用現有資料集。
如果您有現有的資料集,請選取「現有的資料集」,然後使用「進階搜尋」選項來檢視貴組織中所有資料集的視窗,包括其個別詳細資訊,例如是否啟用這些資料集以擷取至Real-Time Customer Profile。
若要使用新的資料集,請選取 新資料集,然後為您的資料集提供名稱和選擇性描述。 您也必須選取您的資料集所要遵守的Experience Data Model (XDM)結構。
資料流詳細資料 dataflow-details
設定資料集後,您必須提供資料流的詳細資訊,包括名稱、選用的說明和警報設定。
Experience Platform可產生使用者可訂閱的事件型警報。 這些選項需要執行中的資料流才能觸發。 如需詳細資訊,請閱讀警示概述
- 來源資料流執行開始:選取此警示以在您的資料流執行開始時收到通知。
- 來源資料流執行成功:選取此警示以在您的資料流結束且沒有任何錯誤時接收通知。
- 來源資料流執行失敗:選取此警示以在您的資料流執行結束時發生任何錯誤時接收通知。
完成後,選取 下一步 以繼續。
將欄位對應至XDM結構描述 mapping
對應步驟出現。 使用對應介面將您的來源資料對應到適當的結構描述欄位,然後再將該資料擷取到Experience Platform,然後選取 下一步。 如需如何使用對應介面的詳細指南,請閱讀資料準備UI指南以取得詳細資訊。
檢閱您的資料流 review
資料流建立流程的最後一步是在執行資料流之前進行檢閱。 使用 檢閱 步驟,在執行新資料流之前先檢閱其詳細資料。 詳細資料會分組到以下類別中:
- 連線:顯示來源型別、所選來源檔案的相關路徑,以及該來源檔案中的欄數。
- 指派資料集與對應欄位:顯示要將來源資料擷取到哪個資料集,包括資料集所堅持的結構描述。
檢閱您的資料流後,請選取 完成,並等待一些時間來建立資料流。
後續步驟
依照此教學課程,您已成功建立Snowflake資料的串流資料流。 如需其他資源,請閱讀以下檔案。
監視資料流
建立資料流後,您可以監視透過它擷取的資料,以檢視擷取率、成功和錯誤的資訊。 如需有關如何監視串流資料流的詳細資訊,請瀏覽有關在UI中監視串流資料流的教學課程。
更新您的資料流
若要更新資料流排程、對應和一般資訊的設定,請瀏覽有關在UI中更新來源資料流的教學課程。
刪除您的資料流
您可以刪除不再需要的資料流,或使用 資料流 工作區中可用的 刪除 功能建立錯誤的資料流。 如需有關如何刪除資料流的詳細資訊,請瀏覽教學課程,瞭解如何在UI中刪除資料流。