共用方式為


數據流定義

本文提供數據流專案定義結構的細目。

定義元件

定義元件路徑 類型 為必填項目 說明
queryMetadata.json 元數據 ContentDetails (JSON) 描述與數據流中查詢選項相關的元數據
mashup.pq Mashup ContentDetails (PQ) 描述承載的混搭內容。 它包含數據流中執行之所有步驟的順序

元數據 ContentDetails

描述承載的內容

名稱 類型 為必填項目 說明
formatVersion 字符串 數據流專案格式的版本。 唯一允許的值是 202502
名稱 字符串 混搭的名稱
computeEngineSettings ComputeEngineSettings 假的 計算引擎設定
queryGroups QueryGroup[] 假的 查詢群組
documentLocale 字符串 假的 檔的地區設定;必須是 BCP-47 語言代碼
gatewayObjectId 字符串 假的 閘道物件標識碼
queriesMetadata QueriesMetadata 假的 查詢元數據
連接 連線[] 假的 使用者連線
fastCombine 布爾邏輯 假的 指出是否要使用快速結合。 True - 使用快速結合。 False (預設值) - 不使用快速結合
allowNativeQueries 布爾邏輯 假的 指出是否允許原生查詢。 True (預設值) - 允許原生查詢。 False - 不允許原生查詢
skipAutomaticTypeAndHeaderDetection 布爾邏輯 假的 指出是否要略過自動類型和標頭偵測。 True - 略過偵測。 False (預設值) - 不要略過偵測
參數 布爾邏輯 假的 指出是否使用參數模式。 True - 使用參數模式。 False (預設值) - 不使用參數模式

ComputeEngineSettings 內容

名稱 類型 為必填項目 說明
allowFastCopy 布爾邏輯 假的 指出是否啟用快速複製。 True (預設值) - 允許快速複製。 False - 不允許快速複製
maxConcurrency 整數 假的 執行數據流時要使用的並行評估數目上限

QueryGroups 內容

名稱 類型 為必填項目 說明
識別碼 字符串 假的 查詢群組的標識碼
名稱 字符串 假的 查詢群組的名稱
說明 字符串 假的 查詢群組的描述
parentId 字符串 假的 查詢群組的父標識碼
訂單 整數 假的 查詢群組的順序

QueriesMetadata 內容

名稱 類型 為必填項目 說明
queryId 字符串 查詢標識碼
queryName 字符串 查詢的名稱
queryGroupId 字符串 假的 查詢群組標識碼
isHidden 布爾邏輯 假的 指出查詢是否隱藏。 True - 查詢已隱藏。 False (預設值) - 查詢未隱藏
loadEnabled 布爾邏輯 假的 指出是否啟用負載。 True (預設值) - 已啟用負載。 False - 未啟用載入

線上內容

名稱 類型 為必填項目 說明
路徑 字符串 假的 線上路徑
字符串 假的 線上類型
connectionId 字符串 假的 線上標識碼

元數據 ContentDetails 範例

{
  "formatVersion": "202502",
  "computeEngineSettings": {
    "allowFastCopy": true,
    "maxConcurrency": 1
  },
  "name": "SampleDataflowGen",
  "queryGroups": [
    
  ],
  "documentLocale": "en-US",
  "gatewayObjectId": null,
  "queriesMetadata": {
    "publicholidays": {
      "queryId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
      "queryName": "publicholidays",
      "queryGroupId": null,
      "isHidden": false,
      "loadEnabled": true
    }
  },
  "connections": [
    {
      "path": "Lakehouse",
      "kind": "Lakehouse",
      "connectionId": "{\"ClusterId\":\"b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2\",\"DatasourceId\":\"c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3\"}"
    }
  ],
  "fastCombine": false,
  "allowNativeQueries": true,
  "skipAutomaticTypeAndHeaderDetection": false
}

Mashup ContentDetails 範例

[StagingDefinition = [Kind = "FastCopy"]]
section Section1;
shared publicholidays = 
let  Source = Lakehouse.Contents([]),  
#"Navigation 1" = Source{[workspaceId = "d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4"]}[Data],  
#"Navigation 2" = #"Navigation 1"{[lakehouseId = "e4e4e4e4-ffff-aaaa-bbbb-c5c5c5c5c5c5"]}[Data],  
#"Navigation 3" = #"Navigation 2"{[Id = "publicholidays", ItemKind = "Table"]}[Data],  
#"Changed column type" = Table.TransformColumnTypes(#"Navigation 3", {{"normalizeHolidayName", type text}}),  
#"Lowercased text" = Table.TransformColumns(#"Changed column type", {{"countryRegionCode", each Text.Lower(_), type nullable text}}),  
#"Uppercased text" = Table.TransformColumns(#"Lowercased text", {{"normalizeHolidayName", each Text.Upper(_), type nullable text}}),  
#"Calculated text length" = Table.TransformColumns(#"Uppercased text", {{"countryOrRegion", each Text.Length(_), type nullable Int64.Type}})in  #"Calculated text length";