บทความนี้มีการแบ่งย่อยของโครงสร้างข้อกําหนดสําหรับรายการกระแสข้อมูล
ส่วนคําจํากัดความ
| เส้นทางของส่วนข้อกําหนด |
ชนิด |
จำเป็น |
คำอธิบาย |
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"
]
}
}
}