SAMPLE

นําไปใช้กับ: คอลัมน์จากการคํานวณตารางจากการคํานวณหน่วยวัดการคํานวณวิชวล

ส่งกลับตัวอย่างของแถว N จากตารางที่ระบุ

ไวยากรณ์

SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])

พารามิเตอร์

เงื่อนไข	คำนิยาม
n_value	จํานวนแถวที่จะแสดง ซึ่งเป็นนิพจน์ DAX ใด ๆ ที่แสดงค่าสเกลาเดียว ซึ่งจะมีการประเมินนิพจน์หลายครั้ง (สําหรับแต่ละแถว/บริบท) ถ้ามีการป้อนค่าที่ไม่ใช่จํานวนเต็ม (หรือนิพจน์) ผลลัพธ์จะถูกแปลงเป็นจํานวนเต็ม
table	นิพจน์ DAX ใด ๆ ที่แสดงตารางของข้อมูลจากตําแหน่งที่จะแยกแถวตัวอย่าง 'n' ออก
orderBy_expression	นิพจน์ DAX สเกลาใด ๆ ที่ค่าผลลัพธ์ถูกประเมินสําหรับแต่ละแถวของ table
order	(ไม่บังคับ) ค่า ที่ระบุวิธีเรียงลําดับค่า orderBy_expression จากน้อยไปหามากหรือจากมากไปหาน้อย: 0 (ศูนย์) เรียงลําดับจากมากไปหาน้อยสําหรับค่า order_by 1, จัดอันดับจากน้อยไปหามากสําหรับ order_by

ค่าผลลัพธ์

ตารางที่ประกอบด้วยตัวอย่างแถว N ของ table หรือตารางว่างถ้า n_value เป็น 0 (ศูนย์) หรือน้อยกว่า ถ้ามีการระบุอาร์กิวเมนต์ OrderBy ตัวอย่างจะมีความเสถียรและชี้เฉพาะ โดยแสดงแถวแรก แถวสุดท้าย และแถวแบบกระจายอย่างสม่ําเสมอระหว่างกัน ถ้าไม่ได้ระบุการจัดลําดับ ตัวอย่างจะเป็นแบบสุ่ม ไม่เสถียร และไม่ชี้เฉพาะ

หมายเหตุ

• ถ้า n_value เป็น 0 (ศูนย์) หรือน้อยกว่า SAMPLE จะส่งกลับตารางว่าง

• เพื่อหลีกเลี่ยงค่าที่ซ้ํากันในตัวอย่าง ตารางที่ระบุเป็นอาร์กิวเมนต์ที่สองควรถูกจัดกลุ่มตามคอลัมน์ที่ใช้สําหรับการเรียงลําดับ

• ฟังก์ชันนี้ไม่ได้รับการสนับสนุนสําหรับการใช้งานในโหมด DirectQuery เมื่อใช้ในคอลัมน์จากการคํานวณหรือกฎการรักษาความปลอดภัยระดับแถว (RLS)