ข้อกําหนดของกระแสข้อมูล

บทความนี้มีการแบ่งย่อยของโครงสร้างข้อกําหนดสําหรับรายการกระแสข้อมูล

ส่วนคําจํากัดความ

เส้นทางของส่วนข้อกําหนด ชนิด จำเป็น คำอธิบาย
queryMetadata.json เมตาดาต้า ContentDetails (JSON) จริง อธิบายเมตาดาต้าที่เกี่ยวข้องกับตัวเลือกคิวรีในกระแสข้อมูล
mashup.pq Mashup ContentDetails (PQ) จริง อธิบายเนื้อหา Mashup ของส่วนข้อมูล ซึ่งประกอบด้วยลําดับของขั้นตอนทั้งหมดที่ดําเนินการในกระแสข้อมูล
<mdfTransformName>.mdf MDFTransform ContentDetails (JSON) เท็จ อธิบายการแมป Data Flow (MDF) แปลงเนื้อหาของส่วนข้อมูล อาจมีการแปลง MDF หลายรายการภายในกระแสข้อมูล

เนื้อหาเมตาดาต้า

อธิบายเนื้อหาของส่วนข้อมูล

ชื่อ ประเภท จำเป็น คำอธิบาย
formatVersion สตริง จริง เวอร์ชันของรูปแบบรายการกระแสข้อมูล 202502 ค่าที่อนุญาตเท่านั้น
ชื่อ สตริง จริง ชื่อของ mashup
computeEngineSettings ComputeEngineSettings เท็จ การตั้งค่ากลไกการคํานวณ
queryGroups QueryGroup[] เท็จ กลุ่มคิวรี
documentLocale สตริง เท็จ ตําแหน่งที่ตั้งของเอกสาร ต้องเป็นรหัสภาษา BCP-47
gatewayObjectId สตริง เท็จ ID ออปเจ็กต์ของเกตเวย์
queriesMetadata QueriesMetadata เท็จ คิวรีเมตาดาต้า
คน รู้จัก การเชื่อมต่อ[] เท็จ การเชื่อมต่อผู้ใช้
fastCombine แบบบูลีน เท็จ ระบุว่าจะใช้การรวมด่วนหรือไม่ จริง - ใช้การรวมอย่างรวดเร็ว เท็จ (ค่าเริ่มต้น) - อย่าใช้การรวมด่วน
allowNativeQueries แบบบูลีน เท็จ ระบุว่าจะอนุญาตคิวรีในระบบหรือไม่ จริง (ค่าเริ่มต้น) - อนุญาตให้มีคิวรีดั้งเดิม เท็จ - ไม่อนุญาตให้มีคิวรีในระบบ
skipAutomaticTypeAndHeaderDetection แบบบูลีน เท็จ ระบุว่าจะข้ามประเภทอัตโนมัติและการตรวจหาส่วนหัวหรือไม่ จริง - ข้ามการตรวจหา เท็จ (ค่าเริ่มต้น) - อย่าข้ามการตรวจหา
พาราเมตริก แบบบูลีน เท็จ ระบุว่ามีการใช้โหมดพาราเมตริกหรือไม่ True - ใช้โหมดพาราเมตริก เท็จ (ค่าเริ่มต้น) - ไม่ได้ใช้โหมดพาราเมตริก

ComputeEngineSettings Contents

ชื่อ ประเภท จำเป็น คำอธิบาย
allowFastCopy แบบบูลีน เท็จ บ่งชี้ว่ามีการเปิดใช้งานสําเนาด่วนหรือไม่ จริง (ค่าเริ่มต้น) - อนุญาตให้คัดลอกได้อย่างรวดเร็ว False - ไม่อนุญาตให้มีสําเนาด่วน
maxConcurrency จำนวนเต็ม เท็จ จํานวนสูงสุดของการประเมินพร้อมกันที่จะใช้เมื่อดําเนินการกระแสข้อมูล

เนื้อหากลุ่มคิวรี

ชื่อ ประเภท จำเป็น คำอธิบาย
รหัส สตริง เท็จ รหัสของกลุ่มการสอบถาม
ชื่อ สตริง เท็จ ชื่อของกลุ่มการสอบถาม
คำอธิบาย สตริง เท็จ คําอธิบายเกี่ยวกับกลุ่มการสอบถาม
parentId สตริง เท็จ ID หลักของกลุ่มคิวรี
ลำดับ จำนวนเต็ม เท็จ ลําดับของกลุ่มการสอบถาม

คิวรีเนื้อหาเมตาดาต้า

ชื่อ ประเภท จำเป็น คำอธิบาย
queryId สตริง จริง ID คิวรี
queryName สตริง จริง ชื่อของคิวรี
queryGroupId สตริง เท็จ รหัสกลุ่มคิวรี
ซ่อนอยู่ แบบบูลีน เท็จ ระบุว่าคิวรีถูกซ่อนอยู่หรือไม่ True - คิวรีถูกซ่อนไว้ เท็จ (ค่าเริ่มต้น) - แบบสอบถามไม่ได้ถูกซ่อนไว้
โหลดถูกเปิดใช้งาน แบบบูลีน เท็จ ระบุว่าจะเปิดใช้งานการโหลดหรือไม่ จริง (ค่าเริ่มต้น) - การโหลดถูกเปิดใช้งาน เท็จ - ไม่สามารถเปิดใช้งานการโหลดได้

เนื้อหาการเชื่อมต่อ

ชื่อ ประเภท จำเป็น คำอธิบาย
เส้นทาง สตริง เท็จ เส้นทางการเชื่อมต่อ
ชนิด สตริง เท็จ ชนิดการเชื่อมต่อ
connectionId สตริง เท็จ ID การเชื่อมต่อ

ตัวอย่างเนื้อหาเมตาดาต้า

{
  "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
    },
    "MDF transform": {
      "queryId": "9c6d7c87-83db-4718-b382-c0c1aa1636d7",
      "queryName": "MDF transform",
      "loadEnabled": false
    }
  },
  "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";
[ItemType = "MDF"]
shared #"MDF transform" = "___ExternalResource-Placeholder___";

MDFTransform ContentDetails

อธิบายเนื้อหาของการแมป Data Flow ส่วนข้อมูล

ชื่อ ประเภท จำเป็น คำอธิบาย
ชื่อ สตริง จริง ชื่อของโฟลว์ข้อมูลการแมป
คุณสมบัติ แห่ง จริง คุณสมบัติของโฟลว์ข้อมูลการแมป

เนื้อหาคุณสมบัติ MDFTransform

ชื่อ ประเภท จำเป็น คำอธิบาย
ชนิด สตริง จริง ชนิดของกระแสข้อมูล ค่าที่อนุญาตคือ MappingDataFlow
typeProperties TypeProperties จริง คุณสมบัติของชนิดของโฟลว์ข้อมูลการแมป

เนื้อหา MDFTransform TypeProperties

ชื่อ ประเภท จำเป็น คำอธิบาย
แหล่ง แหล่งที่มา[] เท็จ รายการของแหล่งข้อมูลในโฟลว์ข้อมูลการแมป
อ่างล้างหน้า อ่างล้างหน้า[] เท็จ รายการของจมในโฟลว์ข้อมูลการแมป
การแปลง การแปลง[] เท็จ รายการของการแปลงในโฟลว์ข้อมูลการแม็ป
scriptLines สตริง[] จริง บรรทัดสคริปต์ที่กําหนดตรรกะการแมปโฟลว์ข้อมูล

เนื้อหาต้นฉบับ MDFTransform

ชื่อ ประเภท จำเป็น คำอธิบาย
ชื่อ สตริง จริง ชื่อของแหล่งที่มา
externalReferences การอนุมานภายนอก เท็จ การอ้างอิงภายนอกสําหรับแหล่งข้อมูล

เนื้อหาจากอ่างล้างหน้า MDFTransform

ชื่อ ประเภท จำเป็น คำอธิบาย
ชื่อ สตริง จริง ชื่อของอ่างล้างหน้า
externalReferences การอนุมานภายนอก เท็จ การอ้างอิงภายนอกสําหรับอ่างล้างหน้า

เนื้อหาการแปลง MDFTransform

ชื่อ ประเภท จำเป็น คำอธิบาย
ชื่อ สตริง จริง ชื่อของการแปลง

เนื้อหาภายนอกของ MDFTransform

ชื่อ ประเภท จำเป็น คำอธิบาย
การเชื่อมต่อ สตริง เท็จ รหัสการเชื่อมต่อสําหรับการอ้างอิงภายนอก

ตัวอย่างเนื้อหา MDFTransform

{
  "name": "MDF",
  "properties": {
    "type": "MappingDataFlow",
    "typeProperties": {
      "sources": [
        {
          "name": "source1",
          "externalReferences": {
            "connection": "<source1ConnectionId>"
          }
        }
      ],
      "sinks": [
        {
          "name": "sink1",
          "externalReferences": {
            "connection": "<sink1ConnectionId>"
          }
        }
      ],
      "transformations": [
        {
          "name": "derivedColumn1"
        }
      ],
      "scriptLines": [
        "source(output(",
        "          Column1 as short,",
        "          Column2 as string,",
        "          Column3 as date,",
        "          Column4 as boolean,",
        "          Column5 as string,",
        "          Column6 as double",
        "     ),",
        "     useSchema: false,",
        "     allowSchemaDrift: true,",
        "     validateSchema: false,",
        "     ignoreNoFilesFound: false,",
        "     format: 'delimited',",
        "     fileSystem: 'folder1',",
        "     fileName: 'file1.csv',",
        "     columnDelimiter: ',',",
        "     escapeChar: '\\\\',",
        "     quoteChar: '\\\"',",
        "     columnNamesAsHeader: true) ~> source1",
        "source1 derive(isColumn6GreaterThan10 = Column6>10) ~> derivedColumn1",
        "derivedColumn1 sink(allowSchemaDrift: true,",
        "     validateSchema: false,",
        "     format: 'json',",
        "     fileSystem: 'output1',",
        "     umask: 0022,",
        "     preCommands: [],",
        "     postCommands: [],",
        "     skipDuplicateMapInputs: true,",
        "     skipDuplicateMapOutputs: true) ~> sink1"
      ]
    }
  }
}