다음을 통해 공유


데이터 흐름 정의

이 문서에서는 데이터 흐름 항목에 대한 정의 구조의 분석을 제공합니다.

정의 부분

정의 파트 경로 유형 필수 설명
queryMetadata.json 메타데이터 ContentDetails(JSON) 맞다 데이터 흐름의 쿼리 옵션과 관련된 메타데이터에 대해 설명합니다.
mashup.pq 매시업 ContentDetails(PQ) 맞다 페이로드의 매시업 콘텐츠를 설명합니다. 데이터 흐름에서 수행되는 모든 단계의 시퀀스를 포함합니다.

메타데이터 ContentDetails

페이로드의 콘텐츠를 설명합니다.

이름 유형 필수 설명
formatVersion 문자열 맞다 데이터 흐름 항목 형식의 버전입니다. 허용되는 유일한 값은 202502
이름 문자열 맞다 매시업의 이름
computeEngineSettings computeEngineSettings 거짓 컴퓨팅 엔진 설정
queryGroups queryGroup [] 거짓 쿼리 그룹
documentLocale 문자열 거짓 문서의 로캘입니다. 는 BCP-47 언어 코드여야 합니다.
gatewayObjectId 문자열 거짓 게이트웨이 개체 ID
queriesMetadata QueriesMetadata 거짓 쿼리 메타데이터
연결 연결[] 거짓 사용자 연결
fastCombine 불리언 (Boolean) 거짓 빠른 결합을 사용할지 여부를 나타냅니다. True - 빠른 결합을 사용합니다. False(기본값) - 빠른 결합을 사용하지 마세요.
allowNativeQueries 불리언 (Boolean) 거짓 네이티브 쿼리가 허용되는지 여부를 나타냅니다. True(기본값) - 네이티브 쿼리를 허용합니다. False - 네이티브 쿼리 허용 안 함
skipAutomaticTypeAndHeaderDetection 불리언 (Boolean) 거짓 자동 형식 및 헤더 검색을 건너뛸지 여부를 나타냅니다. True - 검색을 건너뜁니다. False(기본값) - 검색을 건너뛰지 마세요.
파라메트릭 불리언 (Boolean) 거짓 매개 변수 모드가 사용되는지 여부를 나타냅니다. True - 매개 변수 모드가 사용됩니다. False(기본값) - 매개 변수 모드가 사용되지 않음

ComputeEngineSettings 콘텐츠

이름 유형 필수 설명
allowFastCopy 불리언 (Boolean) 거짓 빠른 복사를 사용할 수 있는지 여부를 나타냅니다. True(기본값) - 빠른 복사를 허용합니다. False - 빠른 복사 허용 안 함
maxConcurrency 정수 거짓 데이터 흐름을 실행할 때 사용할 최대 동시 평가 수

QueryGroups 콘텐츠

이름 유형 필수 설명
아이디 문자열 거짓 쿼리 그룹의 ID
이름 문자열 거짓 쿼리 그룹의 이름
설명 문자열 거짓 쿼리 그룹에 대한 설명
parentId 문자열 거짓 쿼리 그룹의 부모 ID
주문 정수 거짓 쿼리 그룹의 순서

QueriesMetadata 콘텐츠

이름 유형 필수 설명
queryId 문자열 맞다 쿼리 ID
queryName 문자열 맞다 쿼리의 이름
queryGroupId 문자열 거짓 쿼리 그룹 ID
isHidden 불리언 (Boolean) 거짓 쿼리가 숨겨져 있는지 여부를 나타냅니다. True - 쿼리가 숨겨집니다. False(기본값) - 쿼리가 숨겨지지 않음
loadEnabled 불리언 (Boolean) 거짓 로드를 사용할지 여부를 나타냅니다. True(기본값) - 로드가 사용됩니다. False - 로드를 사용할 수 없습니다.

연결 내용

이름 유형 필수 설명
경로 문자열 거짓 연결 경로
종류 문자열 거짓 연결 형식
connectionId 문자열 거짓 연결 ID

메타데이터 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";