對應資料流中的 Metafunction
適用於：
Azure Data Factory Azure Synapse Analytics
提示
試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費開始新的試用！
Azure Data Factory 和 Azure Synapse Pipelines 中均可使用資料流。 本文適用於對應資料流。 若您不熟悉轉換作業，請參閱簡介文章使用對應資料流轉換資料。
下列文章提供對應資料流中 Azure Data Factory 和 Azure Synapse Analytics 所支援 Metafunction 的詳細資料。
Metafunction 清單
Metafunction 主要是在資料流程中的中繼資料上運作
| Metafunction | Task |
|---|---|
| byItem | 在結構或結構陣列內尋找子項目。 如有多個相符項目，則傳回第一個相符項目。 如果沒有相符項目，則會傳回 Null 值。 傳回的值必須是由其中一個類型轉換動作 (? date、? string...) 所轉換的類型。在設計階段已知的資料行名稱，應該只依據其名稱來處理。 不支援計算的輸入，但您可使用參數替換 |
| byOrigin | 依名稱選取原始資料流中的資料行值。 第二個引數是原始資料流名稱。 如有多個相符項目，則傳回第一個相符項目。 如果沒有相符項目，則會傳回 Null 值。 傳回的值必須是由其中一個類型轉換函數 (TO_DATE、TO_STRING ...) 所轉換的類型。在設計階段已知的資料行名稱，應該只依據其名稱來處理。 不支援計算的輸入，但您可使用參數替換。 |
| byOrigins | 在資料流中依名稱選取資料行陣列。 第二個引數是其源自的資料流。 如有多個相符項目，則傳回第一個相符項目。 如果沒有相符項目，則會傳回 Null 值。 傳回的值必須是由其中一個類型轉換函式 (TO_DATE、TO_STRING...) 所轉換的類型在設計階段已知的資料行名稱，應該只依據其名稱來處理。 不支援計算的輸入，但您可使用參數替換。 |
| byName | 依名稱選取資料流中的資料行值。 您可以傳遞選擇性資料流名稱作為第二個引數。 如有多個相符項目，則傳回第一個相符項目。 如果沒有相符項目，則會傳回 Null 值。 傳回的值必須是由其中一個類型轉換函數 (TO_DATE、TO_STRING ...) 所轉換的類型。在設計階段已知的資料行名稱，應該只依據其名稱來處理。 不支援計算的輸入，但您可使用參數替換。 |
| byNames | 在資料流中依名稱選取資料行陣列。 您可以傳遞選擇性資料流名稱作為第二個引數。 如有多個相符項目，則傳回第一個相符項目。 如果資料行沒有相符項目，則整個輸出會是 NULL 值。 所傳回的值需要類型轉換函式 (toDate、toString...)。在設計階段已知的資料行名稱，應該只依據其名稱來處理。 不支援計算的輸入，但您可使用參數替換。 |
| byPath | 依名稱在資料流中尋找階層式路徑。 您可以傳遞選擇性資料流名稱作為第二個引數。 如果找不到這類路徑，則會傳回 Null。 在設計階段已知的資料行名稱/路徑，應該只依據其名稱或點標記法路徑來處理。 不支援計算的輸入，但您可使用參數替換。 |
| byPosition | 依其在資料流中的相對位置 (從 1 開始) 來選取資料行值。 如果位置超出範圍，則會傳回 NULL 值。 傳回的值必須是由其中一個類型轉換函式 (TO_DATE、TO_STRING...) 所轉換的類型不支援計算的輸入，但您可使用參數替換。 |
| hasPath | 檢查資料流中是否有特定階層式路徑存在。 您可以傳遞選擇性資料流名稱作為第二個引數。 在設計階段已知的資料行名稱/路徑，應該只依據其名稱或點標記法路徑來處理。 不支援計算的輸入，但您可使用參數替換。 |
| originColumns | 取得建立資料行之來源資料流的所有輸出資料行。 必須以另一個函式括住。 |
| hex | 傳回二進位值的十六進位字串表示法 |
| unhex | 取消其字串表示法的二進位值。 這可以與 sha2、md5 搭配使用，以從字串轉換成二進位表示法 |
相關內容
- 所有彙總函數的清單。
- 所有陣列函數的清單。
- 所有快取查詢函數的清單。
- 所有轉換函數的清單。
- 所有日期和時間函式的清單。
- 所有運算式函式的清單。
- 所有對應函數的清單。
- 所有視窗函數的清單。
- 所有資料轉換運算式的使用方式詳細資料。
- 了解如何使用運算式產生器。