使用UI從您的Snowflake資料庫串流資料以Experience Platform

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

按照本指南瞭解如何使用使用者介面將資料從您的Snowflake資料庫串流到Adobe Experience Platform。

快速入門

本教學課程需要您實際瞭解下列Experience Platform元件：

Experience Data Model (XDM) 系統： Experience Platform用來組織客戶體驗資料的標準化架構。
- 結構描述組合的基本概念：瞭解XDM結構描述的基本建置區塊，包括結構描述組合中的關鍵原則和最佳實務。
- 結構描述編輯器教學課程：瞭解如何使用結構描述編輯器使用者介面建立自訂結構描述。
Real-Time Customer Profile：根據來自多個來源的彙總資料，提供統一的即時消費者設定檔。

驗證

閱讀 Snowflake 串流資料🔗的必要條件設定指南，瞭解從Snowflake擷取串流資料至Experience Platform前，您需要完成的步驟。

使用Snowflake Streaming來源串流Snowflake資料以進行Experience Platform

在Platform UI中，從左側導覽選取來源以存取來源工作區。您可以從熒幕左側的目錄中選取適當的類別。或者，您可以使用搜尋選項來尋找您要使用的特定來源。

在 資料庫 類別下，選取 Snowflake Streaming，然後選取 新增資料。

TIP

來源目錄中沒有已驗證帳戶的來源會顯示設定選項。一旦驗證帳戶存在，此選項就會變更為 新增資料。

Experience PlatformUI中的來源目錄，已選取Snowflake串流來源卡。

連線Snowflake串流帳戶 頁面隨即顯示。您可以在此頁面使用新的或現有的證明資料。

建立新帳戶

若要建立新帳戶，請選取 新帳戶，並提供名稱、選擇性說明和您的認證。

完成時，請選取 連線到來源，然後等待一段時間以建立新連線。

來源工作流程的新帳戶建立介面。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
認證	說明
帳戶	您的Snowflake帳戶名稱。如需帳戶名稱的慣例，請閱讀Snowflake Streaming 驗證指南。
倉儲	Snowflake倉儲的名稱。倉儲管理Snowflake中查詢的執行。每個Snowflake倉儲彼此獨立，必須個別存取以便Experience Platform資料。
資料庫	Snowflake資料庫的名稱。資料庫包含您要帶入Experience Platform的資料。
綱要	（選擇性）與您的Snowflake帳戶關聯的資料庫結構描述。
使用者名稱	您Snowflake帳戶的使用者名稱。
密碼	您的Snowflake帳戶密碼。
角色	（選用）可以為使用者提供的自訂角色，用於特定連線。如果未提供，此值會預設為`public`。

如需建立帳戶的詳細資訊，請參閱Snowflake Streaming概觀中設定角色設定一節。

使用現有的帳戶

若要使用現有帳戶，請選取 現有帳戶，然後從現有帳戶目錄中選取所要的帳戶。

選取 下一步 以繼續。

來源目錄的現有帳戶選擇頁面。

選取資料 select-data

IMPORTANT

時間戳記欄必須存在於您的來源表格中，才能建立串流資料流。 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的資料會以資料集的形式保留在資料湖中。在此步驟中，您可以建立新資料集或使用現有資料集。

使用新的資料集

若要使用新的資料集，請選取 新資料集，然後為您的資料集提供名稱和選擇性描述。您也必須選取您的資料集所要遵守的Experience Data Model (XDM)結構。

新的資料集選取範圍介面。

table 0-row-2 1-row-2 2-row-2 3-row-2
新資料集詳細資料	說明
輸出資料集名稱	新資料集的名稱。
說明	（選用）新資料集的簡短總覽。
綱要	貴組織中現有的結構描述下拉式清單。您也可以在來源設定程式之前建立自己的結構描述。如需詳細資訊，請閱讀在UI中建立XDM結構描述的指南。

使用現有的資料集

如果您已有現有的資料集，請選取「現有的資料集」，然後使用「進階搜尋」選項來檢視貴組織中所有資料集的視窗，包括其個別詳細資訊，例如是否啟用這些資料集以擷取至Real-Time Customer Profile。

現有的資料集選取介面。

選取步驟以啟用設定檔擷取、錯誤診斷及部分擷取。

如果您的資料集已啟用即時客戶個人檔案，那麼在此步驟中，您可以切換 個人檔案資料集 以啟用您的資料以進行個人檔案擷取。您也可以使用此步驟來啟用 錯誤診斷 和 部分擷取。

錯誤診斷：選取 錯誤診斷 以指示來源產生錯誤診斷，以便您稍後在監視資料集活動和資料流狀態時參考。
部分擷取：部分批次擷取可擷取含有錯誤的資料，最多可達到特定可設定的臨界值。此功能可讓您將所有精確資料成功擷取到Experience Platform，同時所有不正確的資料會個別批次處理，並提供無效原因的資訊。