การทดสอบการถดถอยด้วยคําสั่ง run-compare

คําสั่ง 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 จะพยายามสร้างโฟลเดอร์นั้น เส้นทางสัมพัทธ์ได้รับการสนับสนุนและได้รับการแก้ไขโดยสัมพันธ์กับไดเรกทอรีการทํางานปัจจุบัน