定義查閱轉換

您可用來將查詢資料併入資料集之轉換的相關資訊。

請注意,並非所有類型都可在資料集建構程式的兩個階段期間使用。

分類

Categorize轉換使用由模式字串/值對組成的兩列查找表。 在此轉換期間,Data Workbench伺服器會依序讀取每個事件資料記錄,並將記錄中指定欄位的內容與查閱表格第一欄所列的每個模式字串進行比較。 如果指定欄位符合其中一個模式字串,Data Workbench伺服器會將與該模式字串相關聯的值(在第二欄中找到)寫入記錄中的指定輸出欄位。

查詢表格第一欄中的字串(可選)可以以^字元開頭和/或以$字元結尾,以強制在開頭和/或結尾匹配。 此轉換不接受在第一欄中定義匹配條件的規則運算式。 如果輸入值是字串的向量,則每個字串通過轉換運行,並將結果附加到輸出字串向量。

Categorize轉換通常比使用Regular Expression轉換來完成相同事情更簡單、更快。

注意

除非使用Case Sensitive參數另有指定,否則Categorize中使用的子字串測試會區分大小寫。

參數 說明 預設
名稱 轉換的描述性名稱。 您可以在此輸入任何名稱。
區分大小寫 True 或 False. 指定子字串測試是否區分大小寫。 true
註解 選填。轉換的相關附註。
條件 套用此轉換的條件。
預設 如果條件測試通過且分類檔案中沒有任何條目與輸入匹配,或者給定日誌條目中未定義輸入欄位時,要使用的預設值。
分隔字元

用來分隔查詢檔案中欄的字串。 長度必須為單一字元。

如果按住Ctrl鍵並在「分隔字元」參數內按一下右鍵,則會出現「插入 」菜單。 此菜單包含通常用作分隔符的特殊字元的清單。

多重值 True 或 False. 若為true,當檔案中的多列符合輸入時,每個符合都會導致值附加至字串的輸出向量。 若為false,則輸出中只會使用檔案中的第一個相符列。 在後一種情況下,如果輸入是向量,則輸出也是等效長度的向量。 如果輸入是簡單字串,則輸出也是簡單字串。 false
檔案 分類檔案的路徑和檔案名。 相對路徑與Data Workbench伺服器的安裝目錄有關。 此檔案通常位於Data Workbench伺服器安裝目錄的「查閱」目錄中。
輸入 分類檔案會比對其子字串與此欄位中的值,以識別檔案中的相符列。
輸出 與結果關聯的欄位名稱。

分類的考量事項

  • 在Transformation.cfg檔案或Transformation Dataset Include檔案中定義的Categorize轉換中,若要變更查閱檔案,需要重新轉換資料集。 Log Processing.cfg檔案或Log Processing Dataset Include檔案中定義的Categorize轉換的查閱檔案不受此限制。 如需重新處理資料的詳細資訊,請參閱重新處理和重新轉換

  • Categorize 在檔案或檔案中定 Log Processing.cfg 義的轉換, Log Processing Dataset Include 會在查詢檔案變更時重新載入其查閱檔案。變更不會回溯套用,但會套用至變更發生後讀取的所有記錄資料。

此範例說明如何使用Categorize轉換,將查閱資料與從網站流量收集的事件資料整合。 假設特定網站有業務區域,且需要能夠根據不同區域產生的流量和值來查看和比較。 您可以建立查詢檔案,列出用來識別這些不同區段的子字串。

查閱檔案Lookups\custommap.txt包含下表:

/products/ 產品
^/sports/ 運動
^/新聞/ 新聞

此分類檔案會將包含字串「/products/」的任何項目對應至「Products」值,將任何以「/sports/」開頭的項目對應至「Sports」值,並將任何以「/news/」開頭的項目對應至「News」值。 以下分類轉換使用cs-uri-stem欄位中的值作為我們在其中查找匹配子字串的字串。 轉換的結果會放入x-custommap欄位中。

假設Multiple Values參數設為false,則該示例將為x-custommap生成以下值,給定cs-uri-stem的所列值。

cs-uri-stem x-custommap
/sports/news/today.php 運動
/sports/products/buy.php 產品
/news/headlines.php 新聞
/news/products/subscribe.php 產品

輸出是根據查閱檔案中子字串的順序。 例如,cs-uri-stem /sports/products/buy.php返回"Products"。 雖然URI主體以「/sports/」開頭,但在查閱檔案中,字串「/products/」會列在「/sports/」之前。 如果Multiple Values參數設為true,x-custommap會有額外的值,因為上一個範例會符合查詢表格中的兩列:產品與新聞。

FlatFileLookup

FlatFileLookup轉換使用由任意列數和行陣列成的查找表(儘管可以回想它駐留在記憶體中)。 在這種轉換類型期間,Data Workbench伺服器會依序讀取每個事件資料記錄,並將記錄中指定欄位的內容與查閱表格之指定欄中的每個值比較。 如果有相符項目,Data Workbench伺服器會將一或多個值從查閱表格中的相符列寫入事件資料記錄中的一或多個指定輸出欄位。

此轉換期間使用的查閱表格會從您定義轉換時指定位置的平面檔案中填入。

參數 說明 預設
名稱 轉換的描述性名稱。 您可以在此輸入任何名稱。
註解 選填。轉換的相關附註。
條件 套用此轉換的條件。
預設 若符合條件,且查閱檔案中沒有任何項目符合輸入,則使用的預設值。
分隔字元

用來分隔查詢檔案中欄的字串。 長度必須為單一字元。

如果按住Ctrl鍵並在「分隔字元」參數內按一下右鍵,則會出現「插入 」菜單。 此菜單包含通常用作分隔符的特殊字元的清單。

檔案 查閱檔案的路徑和檔案名。 相對路徑與Data Workbench伺服器的安裝目錄有關。 此檔案通常位於Data Workbench Server安裝目錄的「查閱」目錄中。
標題列 True 或 False. 指出表格中的第一列是要在處理時忽略的標題列。
輸入 名稱是用於將輸入與檔案中的行匹配的列的名稱。如果標題列為true,則可以是查閱檔案中欄的名稱。 否則,這必須是要比對的零基列號。 位名稱是用於在查詢檔案中尋找列的欄位名稱。
多重值

True 或 False. 決定是否應傳回單一值(相符列)或多個值(每個相符列各一個)。

注意: 如果「多個值」設為false,您必須確定沒有多個相符項目。 發生多個相符項目時,無法保證會傳回哪個相符項目。

輸出

列對象(結果)的向量,每個對象由列和欄位名稱定義。

名稱是從中獲取輸出值的列。如果標題行為true,則這可以是查詢檔案中列的名稱。 否則,這必須是要比對的零基列號。

Field Name是用於捕獲輸出的欄位的名稱。請注意,這可以是結果的向量,若Multiple Values參數為true,則每行識別一個。

的考量事項FlatFileLookup

  • 將輸入欄位與查閱檔案配對一律區分大小寫。

  • 在Transformation.cfg檔案或Transformation Dataset Include檔案中定義的FlatFileLookup轉換中,若要變更查閱檔案,需要重新轉換資料集。 Log Processing.cfg檔案或Log Processing Dataset Include檔案中定義的FlatFileLookup轉換的查閱檔案不受此限制。 如需重新處理資料的詳細資訊,請參閱重新處理和重新轉換

  • FlatFileLookup 檔案或檔案中 Log Processing.cfg 的轉換 Log Processing Dataset Include 會在查詢檔案變更時重新載入其查詢檔案。變更不會回溯套用,但會套用至變更發生後讀取的所有記錄資料。

此範例說明如何使用FlatFileLookup轉換,將查閱資料與從網站流量收集的事件資料整合。 假設您想要隔離將流量路由至網站的網站合作夥伴,並將其合作夥伴ID轉換為更方便使用的名稱。 然後,您可以使用好記的名稱來建立延伸維度和視覺效果,這些維度和視覺效果比用於路由流量的站點對站點關係更能清楚地對應至業務關係。

範例轉換會搜尋PartnerID名稱值組的cs(referrer-query)欄位,若找到,則使用查閱檔案Lookups\partners.txt來比較PartnerID值與表格Partner欄中的值。 如果找到行,則輸出欄位x-partner-name將從所標識行的PrintName列中指定名稱。

如果查閱表格包含下列資訊:

ID 合作夥伴 已開始 PrintName
1 P154 1999年8月21日 Yahoo
2 P232 2000年7月10日 Microsoft
3 P945 2001年1月12日 Amazon

下列範例將轉換如下:

  • 如果cs(referrer)(PartnerID)傳回P232,則欄位x-partner-name的值將會是「Microsoft」。
  • 如果cs(referrer)(PartnerID)傳回P100,則欄位x-partner-name的值將會是「無合作夥伴」。
  • 如果cs(referrer)(PartnerID)未傳回任何內容,則欄位x-partner-name的值將會指定為「無合作夥伴」,如預設參數所指定。

ODBCLookup

ODBCLookup轉換的運作方式與FlatFileLookup轉換類似。 唯一的區別是,此轉換期間使用的查閱表從ODBC資料庫中填入,而不是平面檔案。

注意

ODBCLookup 轉換只能在資料集建構程式的轉換階段執行。如果可能,Adobe建議您使用FlatFileLookup轉換,而非ODBCLookup轉換。 FlatFileLookup 轉換在本質上更可靠,因為它們不依賴於外部系統的可用性。此外,如果查找表位於您控制本地的平面檔案中,則修改該查詢表的風險也較小。

參數 說明 預設
名稱 轉換的描述性名稱。 您可以在此輸入任何名稱。
註解 選填。轉換的相關附註。
條件 套用此轉換的條件。
資料來源名稱 DSN(由處理資料集的Data Workbench伺服器電腦的管理員提供),指要從中載入資料的資料庫。
資料庫密碼 連接到資料庫時要使用的口令。 如果為資料源管理員中的DSN配置了密碼,則這可能留空。 此處提供的任何密碼將覆蓋資料源管理員中為DSN配置的密碼。
資料庫用戶ID 連接到資料庫時要使用的用戶ID。 如果已為資料源管理員中的DSN配置了用戶ID,則此ID可能留空。 此處提供的任何用戶ID將覆蓋為資料源管理員中的DSN配置的用戶ID。
預設 若符合條件,且查閱檔案中沒有任何項目符合輸入,則使用的預設值。
輸入欄 名稱是與輸入匹配的資料的列名或SQL表達式。 位名稱是包含要查閱之資料的欄位名稱。
多重值

True 或 False. 決定是否應傳回單一值(相符列)或多個值(每個相符列各一個)。

注意: 如果「多個值」設為false,您必須確定沒有多個相符項目。 發生多個相符項目時,無法保證會傳回哪個相符項目。

輸出列

列對象(結果)的向量,其中每個對象由列和欄位名稱定義。

名稱是從中獲取輸出值的列的或SQL表達式的名稱。 Field Name是用於捕獲輸出的欄位的名稱。

表格識別碼 一種SQL表達式,它為要從中載入資料的表或視圖命名。 典型表標識符的格式為SCHEMA.TABLE。
  • 資料源名稱、 Database User ID、 Database Password和表標識符參數與ODBC資料源描述的相同名稱的參數相同。 請參閱ODBC資料源

  • 與ODBC資料源不同,ODBCLookup轉換不需要增加的ID列。 請參閱ODBC資料源。 這是因為當資料集作用中時,查閱表格的內容不得變更。 在重新轉換發生之前,無法偵測查閱表格或檢視中的變更。 如需重新處理資料的詳細資訊,請參閱重新處理和重新轉換

假設您要將過期的DNS記錄轉換為更新的記錄。 這兩組記錄都儲存在SQL資料庫中。 要執行此任務,您將引用從資料庫生成的查找表並替換過期的DNS記錄。

我們的示例轉換將搜索s-dns欄位的日誌條目,如果找到,則使用查找表VISUAL.LOOKUP將s-dns條目與表OLDDNS列中的條目進行比較。 如果表中有行,則輸出欄位s-dns將從所標識行的NEWDNS列獲得更新的DNS記錄項。

本頁內容