- 來源連接器概觀
- 可用源連接器
- API教學課程
- UI教學課程
- 流運行通知
- IP位址允許清單
- 常見問答
- API 參考資料
- 平台發行說明
在UI中為雲儲存批次連接配置資料流
資料流是從源中檢索資料並將資料內嵌到Platform資料集的計畫任務。 本教學課程提供使用雲儲存帳戶配置新資料流的步驟。
快速入門
本教學課程需要妥善了解下列Adobe Experience Platform元件：
- Experience Data Model (XDM) 系統:組織客戶體驗資 Experience Platform 料的標準化架構。
- Real-time Customer Profile:根據來自多個來源的匯總資料，提供統一的即時消費者設定檔。
此外，本教學課程需要您已建立雲端儲存空間帳戶。 若需在UI中建立不同雲端儲存空間帳戶的教學課程清單，請參閱來源連接器概述。
支援的檔案格式
Experience Platform 支援從外部儲存器擷取的下列檔案格式：
- 分隔字元分隔值(DSV):任何單字元值都可用作DSV格式化資料檔案的分隔符。
- JavaScript Object Notation (JSON):JSON格式的資料檔案必須符合XDM。
- Apache Parquet:鑲木格式的資料檔案必須符合XDM。
- 壓縮檔案：JSON和分隔檔案可壓縮為：
bzip2、gzip、deflate、zipDeflate、tarGzip和tar。
選擇資料
建立雲儲存帳戶後，將顯示選擇資料步驟，為您提供一個介面來探索雲儲存檔案層次結構。
- 介面的左側是目錄瀏覽器，顯示您的雲儲存檔案和目錄。
- 介面的右側可讓您從相容的檔案中預覽最多100列資料。
選取列出的資料夾可讓您將資料夾階層周遊至更深層的資料夾。 您可以選取單一資料夾，遞回內嵌資料夾中的所有檔案。 擷取整個資料夾時，您必須確保資料夾中的所有檔案都共用相同的結構。
選擇了相容的檔案或資料夾後，從選擇資料格式下拉菜單中選擇相應的資料格式。
下表顯示支援的檔案類型的適當資料格式：
| 檔案類型 | 資料格式 |
|---|---|
| CSV | 分隔 |
| JSON | JSON |
| 鑲木 | XDM Parquet |
選取JSON並等待幾秒鐘以填入預覽介面。
與分隔檔案和JSON檔案類型不同，預覽無法使用Parquet格式化檔案。
預覽介面可讓您檢查檔案的內容和結構。 預設情況下，預覽介面將顯示所選資料夾中的第一個檔案。
要預覽不同的檔案，請在要檢查的檔案名稱旁選擇預覽表徵圖。
檢查資料夾中檔案的內容和結構後，選擇Next以遞歸方式內嵌資料夾中的所有檔案。
如果您偏好選擇特定檔案，請選擇要獲取的檔案，然後選擇Next。
為分隔檔案設定自訂分隔字元
擷取分隔檔案時，您可以設定自訂分隔字元。 選取分隔字元選項，然後從下拉式選單中選取分隔字元。 功能表會顯示最常用於分隔字元的選項，包括逗號(,)、標籤(\t)和垂直號(|)。 如果您偏好使用自訂分隔字元，請選取Custom，然後在快顯輸入列中輸入您所選擇的單字元分隔字元。
選取資料格式並設定分隔字元後，請選取Next。
內嵌壓縮檔案
您可以指定壓縮類型，以內嵌壓縮的JSON或分隔檔案。
在選取資料步驟中，選取要擷取的壓縮檔案，然後選取其適當的檔案類型，以及是否符合XDM。 接下來，選擇壓縮類型，然後為源資料選擇適當的壓縮檔案類型。
識別壓縮檔案類型後，選擇Next繼續。
將資料欄位對應至XDM結構
此時會顯示映射步驟，提供互動式介面將源資料映射到Platform資料集。 以Parquet格式化的來源檔案必須符合XDM標準，且不要求您手動設定對應，而CSV檔案則要求您明確設定對應，但可讓您選取要對應的來源資料欄位。 JSON檔案若標示為XDM投訴，則不需要手動設定。 不過，如果未標示為符合XDM，則需要您明確設定對應。
選擇要內嵌入的傳入資料的資料集。 您可以使用現有資料集或建立新資料集。
使用現有資料集
若要將資料內嵌至現有資料集，請選取「現有資料集」，然後選取資料集圖示。
此時會出現「選取資料集」對話方塊。 找到您要使用的資料集，選擇該資料集，然後按一下Continue。
使用新資料集
若要將資料內嵌至新資料集，請選取「新資料集」，然後在提供的欄位中輸入資料集的名稱和說明。 要添加架構，可以在選擇架構對話框中輸入現有架構名稱。 或者，您也可以選擇架構高級搜索以搜索相應的架構。
在此步驟中，您可以為Real-time Customer Profile啟用資料集，並建立實體屬性和行為的整體檢視。 Profile中將包含所有已啟用資料集的資料，並在保存資料流時應用更改。
切換設定檔資料集按鈕，為Profile啟用目標資料集。
此時將顯示選擇架構對話框。 選取您要套用至新資料集的結構，然後選取Done。
您可以視需要選擇直接映射欄位，或使用資料準備函式來轉換源資料，以導出計算值或計算值。 有關映射器函式和計算欄位的詳細資訊，請參閱資料準備函式指南或計算欄位指南。
對於JSON檔案，除了直接將欄位對應至其他欄位，您還可以直接將物件對應至其他物件和陣列至其他陣列。您也可以使用雲端儲存來源連接器，預覽和對應JSON檔案中的陣列等複雜資料類型。
請注意，您無法對應不同類型。 例如，您無法將對象映射到陣列，或將欄位映射到對象。
Platform會根據您選取的目標結構或資料集，為自動對應欄位提供智慧型建議。 您可以手動調整對應規則以符合您的使用案例。
選取「預覽資料」 ，即可查看所選資料集中最多100列範例資料的對應結果。
在預覽期間，身分欄會優先順序排列為第一個欄位，因為這是驗證對應結果時所需的關鍵資訊。
映射源資料後，選擇Close。
排程擷取執行
此時會顯示排程步驟，讓您設定擷取排程，以使用設定的對應自動擷取選取的來源資料。 下表概述用於調度的不同可配置欄位：
| 欄位 | 說明 |
|---|---|
| 頻率 | 可選頻率包括Once、Minute、Hour、Day和Week。 |
| 間隔 | 設定所選頻率間隔的整數。 |
| 開始時間 | UTC時間戳記，指出第一次擷取的設定何時發生。 |
| 回填 | 一個布林值，可決定最初擷取的資料。 如果啟用回填，則在首次排程擷取期間，會擷取指定路徑中所有目前的檔案。 如果回填已停用，則只會擷取在首次擷取執行與開始時間之間載入的檔案。 在開始時間之前載入的檔案將不會被擷取。 |
資料流設計為按計畫自動內嵌資料。 首先，選取擷取頻率。 接下來，設定間隔以指定兩個流運行之間的週期。 間隔的值應為非零整數，應設為大於或等於15。
若要設定擷取的開始時間，請調整開始時間方塊中顯示的日期和時間。 或者，您也可以選取日曆圖示來編輯開始時間值。 開始時間必須大於或等於當前時間（以UTC表示）。
提供排程的值，然後選取Next。
設定一次性內嵌資料流
若要設定一次性擷取，請選取頻率下拉箭頭，然後選取Once。 只要開始時間在將來，您就可以繼續編輯資料流集以進行一次性頻率獲取。 一旦開始時間過後，就無法再編輯一次性頻率值。 設定一 次性內嵌資料流時，無法顯示介面和回填。
強烈建議使用FTP連接器時，將資料流排程為一次性內嵌。
在為調度提供適當值後，選擇Next。
提供資料流詳細資訊
此時將顯示資料流詳細資訊步驟，允許您命名新資料流並提供有關新資料流的簡要說明。
在此過程中，您還可以啟用部分獲取和錯誤診斷。 啟用部分擷取可讓您內嵌包含錯誤的資料，最多可擷取您可設定的特定臨界值。 啟用錯誤診斷將提供有關單獨批處理的任何錯誤資料的詳細資訊。 如需詳細資訊，請參閱部分批次內嵌概述。
為資料流提供值，然後選擇Next。
查看資料流
此時將顯示查看步驟，允許您在建立新資料流之前查看該資料流。 詳細資料會分組為下列類別：
- 連線:顯示源類型、所選源檔案的相關路徑以及該源檔案中的列數。
- 指派資料集和對應欄位:顯示要擷取來源資料的資料集，包括資料集所遵守的結構。
- 排程:顯示擷取排程的作用中期間、頻率和間隔。
審核資料流後，按一下完成並允許建立資料流的一些時間。
監視資料流
建立資料流後，您可以監視正在通過資料流進行內嵌的資料，以查看有關內嵌率、成功和錯誤的資訊。 有關如何監視資料流的詳細資訊，請參閱UI🔗中有關監視帳戶和資料流的教程。
刪除資料流
您可以刪除不再需要或使用Dataflows工作區中可用的Delete函式建立錯誤的資料流。 有關如何刪除資料流的詳細資訊，請參閱有關在UI🔗中刪除資料流的教程。
後續步驟
依照本教學課程，您已成功建立資料流以從外部雲端儲存空間傳入資料，並深入了解監控資料集。 要了解有關建立資料流的詳細資訊，您可以觀看下面的視頻來補充學習內容。 此外，下游Platform服務（如Real-time Customer Profile和Data Science Workspace）現在可以使用傳入資料。 如需詳細資訊，請參閱下列檔案：
以下影片中顯示的Platform UI已過期。 請參閱上述檔案，了解最新的UI螢幕擷取畫面和功能。
附錄
以下各節提供使用源連接器的其他資訊。
禁用資料流
建立資料流時，它會立即變為活動狀態，並根據給定的時間表內嵌資料。 您可以隨時按照以下說明禁用活動資料流。
在Sources工作區中，按一下Browse標籤。 接下來，按一下與要禁用的活動資料流關聯的帳戶的名稱。
此時將顯示源活動頁。 從清單中選擇活動資料流，以在螢幕右側開啟其屬性列，該列包含啟用切換按鈕。 按一下切換按鈕以禁用資料流。 禁用資料流後，可以使用相同的切換按鈕重新啟用資料流。
啟用Profile母體的入站資料
來自來源連接器的傳入資料可用於擴充和填入Real-time Customer Profile資料。 如需填入Real-time Customer Profile資料的詳細資訊，請參閱設定檔填入的教學課程。
