หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
คําสั่ง PQTest run-compare เป็นเครื่องมือที่มีประสิทธิภาพสําหรับการทดสอบการถดถอย ช่วยให้คุณสามารถประเมินฟังก์ชันของตัวเชื่อมต่อและการสร้างข้อความคําสั่งได้อย่างละเอียด เพื่อแสดงให้เห็นถึงความเก่งกาจส่วนต่อ ๆ ไปจะให้ตัวอย่างต่างๆที่ปรับให้เหมาะกับสถานการณ์ที่แตกต่างกัน
Note
คําสั่ง run-compare แทนที่คําสั่ง compare ก่อนหน้านี้
ทดสอบรูปแบบอินพุต
คําสั่ง run-compare สนับสนุนรูปแบบอินพุตการทดสอบสองรูปแบบ:
-
รูปแบบนิพจน์: นิพจน์ M เดียว (ตัวอย่างเช่น
letนิพจน์หรือการเรียกใช้ฟังก์ชัน) รูปแบบนี้เป็นรูปแบบที่ง่ายที่สุดและเหมาะสําหรับสถานการณ์การทดสอบส่วนใหญ่ - รูปแบบเอกสารส่วน: เอกสารส่วน M ที่มีสมาชิกส่วนอย่างน้อยหนึ่งส่วน รูปแบบนี้มีประโยชน์สําหรับการทดสอบที่ต้องใช้ฟังก์ชันตัวช่วย ค่าที่ใช้ร่วมกัน หรือการตั้งค่าที่ซับซ้อนมากขึ้น
เมื่อไฟล์ทดสอบใช้รูปแบบนิพจน์ PQTest จะแปลงเป็นเอกสารส่วนภายในโดยอัตโนมัติก่อนการประเมิน คุณยังสามารถเขียนอินพุตการทดสอบของคุณโดยตรงเป็นเอกสารส่วน
ตัวอย่างรูปแบบนิพจน์
let
Source = Contoso.Contents("TestEndpoint"),
Result = Table.RowCount(Source)
in
Result
ตัวอย่างรูปแบบเอกสารส่วน
section Test;
shared Helper = (x) => x + 1;
shared Query = let
Source = Contoso.Contents("TestEndpoint"),
Result = Helper(Table.RowCount(Source))
in
Result;
เมื่อมีการระบุแบบสอบถามพารามิเตอร์ แบบสอบถามพารามิเตอร์จะถูกเพิ่มเป็นสมาชิกส่วนในเอกสารส่วน คิวรีพารามิเตอร์จะได้รับการประเมินเป็นส่วนหนึ่งของส่วนเดียวกัน ซึ่งทําให้คิวรีทดสอบสามารถอ้างอิงได้โดยตรง
คิวรีพื้นฐาน
รูปแบบการทดสอบที่ง่ายที่สุดคือการเพิ่มนิพจน์การสืบค้นเดียวลงใน.query.pqไฟล์ ซึ่งคุณสามารถดําเนินการได้โดยใช้คําสั่ง run-compare PQTest ประเมินนิพจน์และสร้าง .pqout ไฟล์ (เอาต์พุต) ที่มีชื่อเดียวกัน สําหรับการรันครั้งต่อๆ ไป จะเปรียบเทียบผลลัพธ์ที่สร้างขึ้นจากการประเมิน .query.pq ไฟล์กับ .pqout ไฟล์ (เอาต์พุต) ที่มีชื่อเดียวกัน และส่งคืนผลลัพธ์ของการประเมิน
ตัวอย่างที่ 1 - การเรียกใช้คําสั่ง run-compare สําหรับไฟล์แบบสอบถามเมื่อไม่มีไฟล์เอาต์พุต
ตัวอย่างต่อไปนี้ดําเนินการไฟล์ทดสอบคิวรีเดียวโดยใช้ส่วนขยาย Power Query ที่ระบุและสร้างไฟล์เอาต์พุตเพื่อเปรียบเทียบ
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q contoso.query.pq
[
{
"Details": "Contoso.Contents(\"TestEndpoint\")",
"EndTime": "2025-12-11T18:04:14.8991822+00:00",
"Method": "Compare.TestFiles",
"Name": "contoso.query.pq",
"StartTime": "2025-12-11T18:04:11.1532388+00:00",
"Output": [
{
"SourceFilePath": "contoso.query.pq",
"OutputFilePath": "contoso.query.pqout",
"Status": "Output File Generated",
"SerializedSource": null,
"SourceError": null,
"OutputError": null
}
],
"Status": "Passed",
"Type": "PQTest.Expression"
}
]
ตัวอย่างที่ 2 - การเรียกใช้คําสั่ง run-compare สําหรับไฟล์แบบสอบถามเมื่อไม่มีไฟล์เอาต์พุตและตั้งค่าสถานะ FailOnMissingOutputFile
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q contoso.query.pq -fomof
[
{
"Details": "Contoso.Contents(\"TestEndpoint\")",
"EndTime": "2025-12-11T18:04:14.8991822+00:00",
"Method": "Compare.TestFiles",
"Name": "contoso.query.pq",
"StartTime": "2025-12-11T18:04:11.1532388+00:00",
"Output": [
{
"SourceFilePath": "contoso.query.pq",
"OutputFilePath": "contoso.query.pqout",
"Status": "Missing Output File",
"SerializedSource": "Output of contoso.query.pq",
"SourceError": null,
"OutputError": null
}
],
"Status": "Failed",
"Type": "PQTest.Expression"
}
]
ตัวอย่างที่ 3 - การเรียกใช้คําสั่ง run-compare สําหรับไฟล์แบบสอบถามที่มีไฟล์เอาต์พุตอยู่
ตัวอย่างต่อไปนี้ดําเนินการไฟล์ทดสอบคิวรีเดียวโดยใช้ส่วนขยาย Power Query ที่ระบุ เปรียบเทียบกับไฟล์เอาต์พุตและแสดงผลลัพธ์
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q contoso.query.pq
[
{
"Details": "Contoso.Contents(\"TestEndpoint\")",
"EndTime": "2025-12-11T18:04:14.8991822+00:00",
"Method": "Compare.TestFiles",
"Name": "contoso.query.pq",
"StartTime": "2025-12-11T18:04:11.1532388+00:00",
"Output": [
{
"SourceFilePath": "contoso.query.pq",
"OutputFilePath": "contoso.query.pqout",
"Status": "Passed",
"SerializedSource": null,
"SourceError": null,
"OutputError": null
}
],
"Status": "Passed",
"Type": "PQTest.Expression"
}
]
การทดสอบด้วยคิวรีพารามิเตอร์
คิวรีพารามิเตอร์คือคิวรีที่รวมกับคิวรีทดสอบที่รันไทม์ กับคิวรีพารามิเตอร์ที่เรียกใช้ก่อน ฟังก์ชันนี้ช่วยให้คุณสามารถแบ่งไฟล์ ".query.pq" ออกเป็นสองส่วน: ไฟล์คิวรีพารามิเตอร์ และไฟล์คิวรีทดสอบ
การทดสอบแหล่งข้อมูล Agnostic ที่มีพารามิเตอร์และรูปแบบการทดสอบคิวรี
ตัวอย่างของกรณีการใช้งานที่ฟังก์ชันนี้มีประโยชน์คือการสร้างชุดการทดสอบการวินิจฉัยแหล่งข้อมูล คุณสามารถใช้คิวรีพารามิเตอร์ของคุณเพื่อดึงข้อมูลจากแหล่งข้อมูล และให้คิวรีทดสอบเป็น M ทั่วไป หากคุณต้องการเรียกใช้การทดสอบสําหรับตัวเชื่อมต่ออื่น คุณจะต้องเพิ่ม/อัปเดตคิวรีพารามิเตอร์เพื่อชี้ไปยังแหล่งข้อมูลเฉพาะนั้นเท่านั้น
ความแตกต่างที่สําคัญเมื่อใช้คิวรีพารามิเตอร์คือคิวรีทดสอบมีรูปแบบที่แตกต่างกัน แทนที่จะเป็นนิพจน์สูตร จะต้องเป็นฟังก์ชัน M ที่ใช้พารามิเตอร์ข้อมูลป้อนเข้าหนึ่งรายการ ซึ่งแสดงถึงตารางที่ส่งกลับจากคิวรีพารามิเตอร์
เมื่อมีการระบุคิวรีพารามิเตอร์ คิวรีพารามิเตอร์จะถูกเพิ่มเป็นสมาชิกส่วนที่ส่วนท้ายของเอกสารส่วนของการทดสอบ อินพุตการทดสอบและพารามิเตอร์จะถูกประเมินร่วมกันเป็นเอกสารส่วน Mashup เดียว
Note
หากไฟล์คิวรีพารามิเตอร์มีข้อผิดพลาด (ตัวอย่างเช่น ข้อผิดพลาดทางไวยากรณ์หรือข้อผิดพลาดในการประเมิน) PQTest จะรายงานข้อผิดพลาดเชิงพรรณนาที่บ่งชี้ถึงปัญหากับไฟล์พารามิเตอร์แทนที่จะสร้างความล้มเหลวที่ไม่ชัดเจน
สมมติว่าคุณมีแบบสอบถามทดสอบต่อไปนี้:
let
Source = Snowflake.Databases("...", "..."),
Database = Source{[Name="...",Kind="Database"]}[Data],
SelectColumns = Table.RemoveColumns(Database, { "Data" })
in
SelectColumns
หากต้องการแปลงเป็นคิวรีการทดสอบและพารามิเตอร์ คุณต้องแยกออกดังต่อไปนี้:
แบบสอบถามพารามิเตอร์:
let
Source = Snowflake.Databases("...", "..."),
Database = Source{[Name="...",Kind="Database"]}[Data],
Schema = Database{[Name="...",Kind="Schema"]}[Data],
Taxi_Table = Schema{[Name="...",Kind="Table"]}[Data]
in
Taxi_Table
ทดสอบคิวรี:
(Source) => let
SelectColumns = Table.RemoveColumns(Source, { "VendorID" })
in
SelectColumns
ตัวอย่างที่ 4 - การใช้ทั้งแบบสอบถามพารามิเตอร์และแบบสอบถามทดสอบด้วยคําสั่ง run-compare
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q contoso.query.pq -pa contoso.parameter.pq
[
{
"Details": "(Source) => let\r\n Schemas = Table.RemoveColumns(Source, { \"Data\" })\r\nin\r\n Schemas",
"EndTime": "2025-12-11T18:04:14.8991822+00:00",
"Method": "Compare.TestFiles",
"Name": "contoso.query.pq",
"StartTime": "2025-12-11T18:04:11.1532388+00:00",
"Output": [
{
"SourceFilePath": "contoso.query.pq",
"OutputFilePath": "contoso.query.pqout",
"Status": "Passed",
"SerializedSource": null,
"SourceError": null,
"OutputError": null
}
],
"Status": "Passed",
"Type": "PQTest.Expression"
}
]
การเปรียบเทียบการวินิจฉัย
ข้อมูลการวินิจฉัยเพิ่มเติมสามารถประเมินได้เมื่อใช้คําสั่ง run-compare โดยสมัครสมาชิกช่องทางการวินิจฉัย เมื่อรันคําสั่ง run-compare PQTest จะ .diagnostics ส่งออกไฟล์สําหรับแต่ละช่องที่สมัครรับข้อมูลซึ่งมีเหตุการณ์ สําหรับการเรียกใช้ครั้งต่อๆ ไป จะเปรียบเทียบเหตุการณ์การวินิจฉัยกับ.diagnosticsไฟล์ คล้ายกับ.pqout
ตัวอย่างที่ 5 - การสมัครใช้งานไปยังช่องทางการวินิจฉัย ODBC (Open Database Connectivity) เพื่อตรวจสอบการพับคิวรี
ตัวอย่างต่อไปนี้แสดงวิธีการสมัครสมาชิกช่อง ODBC ซึ่งจับ SQL ใด ๆ ที่สร้างขึ้นโดยโปรแกรมควบคุม ODBC เมื่อมีการใช้การพับคิวรี
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q contoso.query.pq -dc "Odbc"
ช่องการวินิจฉัย ODBC สามารถใช้เพื่อตรวจสอบว่าคิวรีถูกพับและสร้าง SQL ที่ถูกต้อง
let
Source = AzureSpark.Tables("..."),
T1 = Source{[Schema="default",Item="DATABASE"]}[Data],
SelectColumns = Table.Group(T1, {}, {{"Maximum", each List.Max([number_column]), type number}}),
FirstN = Table.FirstN(SelectColumns, 1)
in
FirstN
ขณะนี้แบบสอบถามพับ และสร้างข้อความคําสั่ง ODBC ต่อไปนี้ใน .diagnostics แฟ้ม:
[
{
"Command": "DESCRIBE default.DATABASE;"
},
{
"Command": "select top 1 max(`number_column`) as `C1` from `SPARK`.`default`.`DATABASE`"
}
]
การใช้ไฟล์การตั้งค่า
พารามิเตอร์อินพุตบรรทัดคําสั่งใดๆ สําหรับคําสั่ง run-compare สามารถส่งผ่านไฟล์การตั้งค่า JSON ได้เช่นกัน JSON สามารถมีตัวเลือกต่อไปนี้:
| ตัวเลือก | ประเภท | คำอธิบาย |
|---|---|---|
| ExtensionPaths | อาร์เรย์ | อาร์เรย์ของเส้นทางที่ชี้ไปยังไฟล์ตัวเชื่อมต่อ (mez/pqx) |
| FailOnMissingOutputFile | bool | Run-compare ไม่สร้างไฟล์ PQOut และล้มเหลวหากไม่มีอยู่ |
| FailOnFoldingFailure | bool | การเรียกใช้เปรียบเทียบล้มเหลวถ้าคิวรีไม่พับอย่างสมบูรณ์ เมื่อเปิดใช้งาน คิวรีที่ไม่สามารถพับไปยังแหล่งข้อมูลได้อย่างสมบูรณ์จะทําให้เกิดข้อผิดพลาดแทนที่จะย้อนกลับไปยังการประเมินภายในเครื่อง |
| ParameterQueryFilePath | สตริง | ไฟล์คิวรีที่มีนิพจน์ M ซึ่งรวมกันในขณะทํางานกับไฟล์คิวรีทดสอบ กรณีการใช้งานทั่วไปคือการมีไฟล์คิวรีพารามิเตอร์เดียวเพื่อระบุนิพจน์ M เพื่อดึงข้อมูลสําหรับคิวรีทดสอบหลายรายการ |
| QueryFilePath | สตริง | แฟ้มคิวรีที่มีนิพจน์ M (.pq) ที่จะทดสอบ |
| TrxReportPath | สตริง | สร้าง TRX ไฟล์ผลลัพธ์ (ไฟล์ผลการทดสอบ Visual Studio) และแยกไฟล์ JSON สําหรับการทดสอบแต่ละรายการในเส้นทางที่กําหนด |
| แชนเนลการวินิจฉัย | อาร์เรย์ | ชื่อของช่องทางการวินิจฉัยที่จะแนบกับการทดสอบ (ตัวอย่างเช่น Odbc สําหรับการจับคําสั่งการพับคิวรี) |
| โฟลเดอร์ IntermediateTestResultsResults | สตริง | เส้นทางโฟลเดอร์ที่กําหนดเองสําหรับจัดเก็บผลการทดสอบระดับกลาง |
| คงอยู่ผลการทดสอบระดับกลาง | bool | เก็บผลการทดสอบระดับกลางหลังจากดําเนินการทดสอบเสร็จสิ้น |
ในกรณีที่มีทั้งตัวเลือกการป้อนข้อมูลบรรทัดคําสั่งและการตั้งค่าการป้อนข้อมูลบรรทัดคําสั่งจะถูกจัดลําดับความสําคัญ
ตัวอย่างที่ 6 - การใช้ไฟล์การตั้งค่าแทนอาร์กิวเมนต์บรรทัดคําสั่ง
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q contoso.query.pq -fomof
คําสั่งนี้เทียบเท่ากับคําสั่งต่อไปนี้:
<Path to PQTest.exe>.\PQTest.exe run-compare -sf settings.json
ตําแหน่งที่ settings.json เป็นไฟล์ JSON ต่อไปนี้:
{
"ExtensionPaths": ["contoso.mez"],
"QueryFilePath": "contoso.query.pq",
"FailOnMissingOutputFile": true
}
ทดสอบแบตเตอรี่ด้วยคําสั่ง run-compare
แบตเตอรี่ทดสอบคือคอลเลกชันของการทดสอบที่ประเมินหลายแง่มุมของโค้ดของคุณ วางไฟล์คิวรีในโฟลเดอร์เดียวกันเพื่อให้ PQTest สามารถค้นหาได้อย่างง่ายดาย แทนที่จะส่งผ่านชื่อไฟล์ทดสอบเฉพาะ ให้ระบุเส้นทางโฟลเดอร์และ PQTest จะดําเนินการไฟล์คิวรีทดสอบ .query.pq ทั้งหมดในการส่งผ่านเดียว
ตัวอย่างที่ 7 - การใช้แบตเตอรี่ของการทดสอบ
สมมติว่าโฟลเดอร์ที่มีชื่อทดสอบที่ประกอบด้วยไฟล์ต่อไปนี้:
- contoso.testa.query.pq
- contoso.testb.query.pq
- contoso.testc.query.pq
สามารถเรียกใช้แบตเตอรี่ทดสอบทั้งหมดได้โดยใช้บรรทัดคําสั่งต่อไปนี้:
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test
การละเว้นการทดสอบเมื่อเรียกใช้แบตเตอรี่ของการทดสอบ
สามารถละเว้นการทดสอบได้เมื่อเรียกใช้แบตเตอรี่ของการทดสอบโดยการเปลี่ยนส่วนขยายของไฟล์ .query.pq เป็น .query.pq.ignore
ตัวอย่างที่ 8 - ละเว้นการทดสอบเมื่อเรียกใช้แบตเตอรี่ของการทดสอบ
สมมติว่าโฟลเดอร์ที่มีชื่อทดสอบที่ประกอบด้วยไฟล์ต่อไปนี้:
- contoso.testa.query.pq
- contoso.testb.query.pq.ignore
- contoso.testc.query.pq
มีการเรียกใช้ไฟล์ contoso.testa.query.pq และ contoso.testc.query.pq แต่ contoso.testb.query.pq.ignore จะถูกละเว้นเมื่อคําสั่งต่อไปนี้ถูกเรียกใช้เพื่อเรียกใช้แบตเตอรี่ทดสอบ:
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test
การทดสอบการกรอง
ตัวเลือกนี้ --testFilter ช่วยให้คุณสามารถเลือกรวมหรือยกเว้นไฟล์ทดสอบเมื่อใช้แบตเตอรี่ทดสอบ ตัวเลือกนี้ใช้รูปแบบ glob เพื่อจับคู่เส้นทางไฟล์ และสามารถระบุได้หลายครั้งเพื่อสร้างกฎการกรองที่ซับซ้อน
ตัวกรองการรวม
ระบุไฟล์ที่จะรวมไว้ในการทดสอบโดยใช้รูปแบบ glob มาตรฐาน
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test --testFilter "Suite1/**/*.pq"
ตัวกรองการยกเว้น
ระบุไฟล์ที่จะแยกออกจากการทดสอบโดยใช้ ! คํานําหน้าเพื่อแสดงรูปแบบการยกเว้น
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test --testFilter "!BrokenTests/*"
ตัวกรองหลายตัว
--testFilterสามารถรวมหลายตัวเลือกเพื่อสร้างตรรกะการกรองที่ซับซ้อน:
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test --testFilter "**/*.pq" --testFilter "!BrokenTests/*" --testFilter "!**/*donotrun*.pq"
ลักษณะการทํางานของตัวกรอง
- การรวมโดยนัย: เมื่อไม่มีการระบุ
**/*.query.pqตัวกรองการรวม ระบบจะนําไปใช้โดยอัตโนมัติ - ไม่คํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่: รูปแบบทั้งหมดตรงกับตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
- อิสระจากคําสั่งซื้อ: ลําดับของตัวกรองจะไม่ส่งผลต่อผลลัพธ์
-
รูปแบบเส้นทาง: ใช้เครื่องหมายทับ (
/) ในรูปแบบเพื่อความเข้ากันได้ข้ามแพลตฟอร์ม
ตัวอย่างรูปแบบ Glob
| Pattern | คำอธิบาย |
|---|---|
**/*.pq |
ไฟล์ทั้งหมดใน .pq ไดเร็กทอรีใดก็ได้ |
**/*.query.pq |
ไฟล์ทั้งหมดใน .query.pq ไดเร็กทอรีใดก็ได้ |
Suite1/**/*.pq |
ไฟล์ทั้งหมด .pq ภายใต้ไดเรกทอรี Suite1 |
**/test*.pq |
ไฟล์ทั้งหมดที่ .pq ขึ้นต้นด้วย "test" |
!BrokenTests/* |
ยกเว้นไฟล์ทั้งหมดในไดเรกทอรี BrokenTests |
!**/*temp*.pq |
ยกเว้นไฟล์ทั้งหมด .pq ที่มี "temp" |
SpecificTest.pq |
รวมเฉพาะไฟล์ที่ระบุ |
Note
ตัวกรองใช้กับเส้นทางสัมพัทธ์จากไดเรกทอรีคิวรีที่ระบุ ข้อผิดพลาดจะถูกส่งกลับหากมีตัวกรองและเส้นทางไฟล์คิวรีชี้ไปยังไฟล์เฉพาะแทนที่จะเป็นไดเรกทอรี ใช้เครื่องหมายคําพูดรอบรูปแบบเพื่อป้องกันการขยายตัวของเปลือก
แสดงรายการไฟล์ทดสอบโดยไม่ต้องดําเนินการ
ตัวเลือกนี้ --listOnly ช่วยให้คุณสามารถดูตัวอย่างไฟล์ทดสอบที่จะดําเนินการโดยคําสั่ง run-compare โดยไม่ต้องเรียกใช้การทดสอบจริง ตัวเลือกนี้มีประโยชน์สําหรับการตรวจสอบการค้นพบการทดสอบและพฤติกรรมตัวกรอง
ตัวอย่างที่ 9 - การแสดงรายการไฟล์ทดสอบ
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test --listOnly
{
"SourcePath": "C:\\MyProject\\test",
"TestFilters": [],
"Tests": [
{
"Test": "MyTest.query.pq",
"RelativePath": "Suite1\\MyTest.query.pq",
"AbsolutePath": "C:\\MyProject\\test\\Suite1\\MyTest.query.pq"
},
{
"Test": "AnotherTest.query.pq",
"RelativePath": "Suite2\\AnotherTest.query.pq",
"AbsolutePath": "C:\\MyProject\\test\\Suite2\\AnotherTest.query.pq"
}
]
}
ผลลัพธ์ประกอบด้วยฟิลด์ต่อไปนี้:
-
SourcePath: ค่า QueryFilePath ที่ให้ไว้กับคําสั่ง (ตัวเลือกจาก
-q) -
TestFilters: รายการของค่า TestFilter ทั้งหมดที่นําไปใช้ (จาก
--testFilterตัวเลือก) -
การทดสอบ: อาร์เรย์ของออบเจ็กต์ไฟล์ทดสอบ โดยที่แต่ละออบเจ็กต์ประกอบด้วย:
- ทดสอบ: ชื่อไฟล์ของไฟล์ทดสอบ
-
RelativePath: เส้นทางที่สัมพันธ์กับไดเร็กทอรีการทดสอบพื้นฐานที่ระบุโดย
-q. - AbsolutePath: เส้นทางสัมบูรณ์แบบเต็มไปยังไฟล์ทดสอบ
การรวมกับตัวกรองทดสอบ
ตัวเลือกนี้ --listOnly เคารพตัวเลือกทั้งหมด --testFilter ช่วยให้คุณดูตัวอย่างเอฟเฟกต์ของฟิลเตอร์ของคุณ:
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test --testFilter "Suite1/**/*.pq" --listOnly
Note
ตัวกรองทดสอบทั้งหมดจะถูกนําไปใช้ก่อนลงรายการ ไม่มีการดําเนินการทดสอบจริงเกิดขึ้นเมื่อใช้--listOnly
การจัดการผลการทดสอบระดับกลาง
คําสั่ง run-compare สร้างไฟล์ระดับกลางระหว่างการดําเนินการทดสอบ รวมถึงไฟล์เอาต์พุตการทดสอบจริง (.pqout) และไฟล์การวินิจฉัย (.diagnostics) ตามค่าเริ่มต้น ไฟล์เหล่านี้จะถูกสร้างขึ้นในตําแหน่งที่ตั้งชั่วคราวที่มีโครงสร้างโฟลเดอร์ย่อยตามวันที่ และจะถูกล้างข้อมูลโดยอัตโนมัติหลังจากการทดสอบเสร็จสิ้น
คุณสามารถควบคุมลักษณะการทํางานนี้ได้โดยใช้สองตัวเลือก:
-
--intermediateTestResultsFolder | -itrf: ระบุเส้นทางโฟลเดอร์แบบกําหนดเองสําหรับการจัดเก็บผลการทดสอบระดับกลาง -
--persistIntermediateTestResults | -pitr: เก็บผลลัพธ์ระดับกลางหลังจากการดําเนินการทดสอบเสร็จสิ้น
ตัวอย่างที่ 10 - การใช้โฟลเดอร์ระดับกลางแบบกําหนดเองและผลลัพธ์ที่คงอยู่
<Path to PQTest.exe>.\PQTest.exe run-compare -e contoso.mez -q .\test -itrf "C:\TestResults" -pitr
โครงสร้างโฟลเดอร์ระดับกลาง
เมื่อคุณระบุโฟลเดอร์ผลการทดสอบระดับกลาง PQTest จะสร้างโครงสร้างโฟลเดอร์ย่อยตามวันที่เพื่อจัดระเบียบผลการทดสอบ:
<IntermediateTestResultsFolder>\
└── YYYYMMDD_HHmmss_ffffff\
├── Test1.query.pqout
├── Test2.query.pqout
├── Test3.query.odbc.diagnostics
└── ...
พฤติกรรมการล้างข้อมูล
ลักษณะการทํางานการล้างข้อมูลขึ้นอยู่กับว่าคุณระบุโฟลเดอร์ระดับกลางหรือไม่ และว่าคุณใช้ค่าสถานะคงอยู่หรือไม่:
| สถานการณ์สมมติ | ระบุโฟลเดอร์ระดับกลาง | ธงคงอยู่ | พฤติกรรม |
|---|---|---|---|
| 1 | ไม่ใช่ | ไม่ใช่ | ไฟล์ที่สร้างขึ้นในสถานที่ชั่วคราวโฟลเดอร์ย่อยตามวันที่ถูกลบหลังจากการทดสอบ |
| 2 | ใช่ | ไม่ใช่ | ไฟล์ที่สร้างขึ้นในโฟลเดอร์ที่ระบุโฟลเดอร์ย่อยตามวันที่จะถูกลบหลังจากการทดสอบ |
| 3 | ไม่ใช่ | ใช่ | ไฟล์ที่สร้างขึ้นในสถานที่ชั่วคราวโฟลเดอร์ย่อยตามวันที่ถูกลบหลังจากการทดสอบ |
| 4 | ใช่ | ใช่ | ไฟล์ที่สร้างขึ้นในโฟลเดอร์ที่ระบุโฟลเดอร์ย่อยตามวันที่จะถูกเก็บรักษาไว้ |
Note
หากต้องการคงผลลัพธ์ระดับกลางไว้ คุณต้องระบุทั้ง --intermediateTestResultsFolder และ--persistIntermediateTestResults
--persistIntermediateTestResultsค่าสถานะเพียงอย่างเดียวโดยไม่ระบุโฟลเดอร์จะไม่คงผลลัพธ์ หากไม่มีโฟลเดอร์ระดับกลางที่ระบุ PQTest จะพยายามสร้างโฟลเดอร์นั้น เส้นทางสัมพัทธ์ได้รับการสนับสนุนและได้รับการแก้ไขโดยสัมพันธ์กับไดเรกทอรีการทํางานปัจจุบัน