TOPN

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

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

ไวยากรณ์

TOPN(<N_Value>, <Table>, <OrderBy_Expression>, [<Order>[, <OrderBy_Expression>, [<Order>]]…])

พารามิเตอร์

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

ค่าผลลัพธ์

ตารางที่มี N แถวบนของ Table หรือตารางว่าง ถ้า N_Value เป็น 0 (ศูนย์) หรือน้อยกว่า แถวจะไม่ถูกเรียงลําดับตามลําดับเฉพาะใด ๆ

หมายเหตุ

• ถ้ามีการผูกรวมในค่า Order_By ที่แถว N-th ของตาราง ระบบจะแสดงแถวที่ผูกทั้งหมด จากนั้น เมื่อมีรายการที่ผูกรวมที่แถว N-th ฟังก์ชันนี้อาจแสดงมากกว่า n แถว

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

• TOPN ไม่รับประกันลําดับการจัดเรียงใด ๆ สําหรับผลลัพธ์

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

ตัวอย่าง

สูตรหน่วยวัดต่อไปนี้จะให้ผลลัพธ์เป็นผลิตภัณฑ์ที่ขายได้สูงสุด 10 อันดับแรกตามปริมาณยอดขาย

= SUMX(
        TOPN(
            10, 
            SUMMARIZE(
                    InternetSales, 
                    InternetSales[ProductKey], 
                    "TotalSales", SUM(InternetSales[SalesAmount])
            ),
            [TotalSales], DESC
        ),
        [TotalSales]
)