ใช้พารามิเตอร์ใน Real-Time Dashboard queries

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

บทความนี้อธิบายวิธีการสร้างและใช้พารามิเตอร์ ตัวกรองข้าม และการดูรายละเอียดแบบเจาะลึกในแดชบอร์ด คุณสามารถกรองภาพแดชบอร์ดได้โดยเลือก ค่าพารามิเตอร์ในแถบกรอง หรือโดยใช้ตัวกรองข้าม

ตัวอย่างคิวรีที่ใช้ในบทความนี้ขึ้นอยู่กับ ตาราง StormEvents ใน ข้อมูลตัวอย่างการวิเคราะห์ สภาพอากาศที่พร้อมใช้งานใน แกลเลอรีตัวอย่าง

ข้อกำหนดเบื้องต้น

• เสร็จสิ้นการสร้างและจัดการพารามิเตอร์แดชบอร์ด Real-Time
• แดชบอร์ดที่ใช้ตาราง StormEvents ในข้อมูลตัวอย่างวิเคราะห์สภาพอากาศจากแกลเลอรีตัวอย่าง

ใช้พารามิเตอร์ในคิวรีของคุณ

ต้องใช้พารามิเตอร์ในคิวรีก่อนที่ตัวกรองจะส่งผลต่อวิชวลนั้น หลังจากที่คุณกําหนดพารามิเตอร์แล้ว คุณจะเห็นพารามิเตอร์นั้นในแถบตัวกรองบนหน้า คิวรี และในคิวรี IntelliSense

ชนิดพารามิเตอร์

แดชบอร์ดรองรับชนิดพารามิเตอร์ต่อไปนี้:

• พารามิเตอร์ช่วงเวลาเริ่มต้น
• พารามิเตอร์ค่าคงที่แบบเลือกรายการเดียว
• พารามิเตอร์ค่าคงที่แบบเลือกได้หลายรายการ
• พารามิเตอร์ตามคิวรีแบบเลือกรายการเดียว
• พารามิเตอร์ตามคิวรีแบบเลือกได้หลายรายการ
• พารามิเตอร์ข้อความอิสระ
• พารามิเตอร์แหล่งข้อมูล

ตัวอย่างต่อไปนี้อธิบายวิธีการใช้พารามิเตอร์ในคิวรีสําหรับพารามิเตอร์ชนิดต่าง ๆ

พารามิเตอร์ช่วงเวลาเริ่มต้น

แดชบอร์ดทุกรายการมีพารามิเตอร์ ช่วงเวลา ตามค่าเริ่มต้น ตัวกรองจะปรากฏเป็นตัวกรองเฉพาะเมื่อคุณใช้ในแบบสอบถามเท่านั้น ใช้คีย์เวิร์ด _startTime และ _endTime เพื่อใช้พารามิเตอร์ช่วงเวลาเริ่มต้น ดังที่แสดงในตัวอย่างต่อไปนี้

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

เมื่อคุณบันทึกคิวรี ตัวกรองช่วงเวลาจะปรากฏบนแดชบอร์ด จากนั้นคุณสามารถกรองวิชวลได้โดยเลือกค่าที่ตั้งไว้ล่วงหน้าในช่วงเวลา หรือโดยการเลือก ช่วงเวลาแบบกําหนดเอง

พารามิเตอร์ค่าคงที่แบบเลือกรายการเดียว

พารามิเตอร์ค่าคงที่จะขึ้นอยู่กับค่าที่กําหนดไว้ล่วงหน้าที่คุณระบุ ตัวอย่างต่อไปนี้แสดงวิธีการสร้างพารามิเตอร์ค่าคงที่ที่เลือกเดี่ยว

สร้างพารามิเตอร์ค่าคงที่แบบเลือกรายการเดียว

1. เลือก พารามิเตอร์ เพื่อเปิดบานหน้าต่าง พารามิเตอร์ แล้วเลือก พารามิเตอร์ใหม่

2. ป้อนรายละเอียดต่อไปนี้:

   • ป้ายชื่อ: ชนิดเหตุการณ์

   • ชนิดพารามิเตอร์: การเลือกเพียงครั้งเดียว

   • ชื่อตัวแปร: _eventType

   • ชนิดข้อมูล: สตริง

   • ปักหมุดเป็นตัวกรองแดชบอร์ด: เลือก

   • แหล่งข้อมูล: ค่าคงที่

     ในตัวอย่างนี้ ให้ใช้ค่าต่อไปนี้:

     ค่า	ชื่อที่แสดงของพารามิเตอร์
     ลมฝนฟ้าคะนอง	ลมฝนฟ้าคะนอง
     ลูกเห็บ	ลูกเห็บ
     น้ําท่วมแฟลช	น้ําท่วมแฟลช
     แล้ง	แล้ง
     สภาพอากาศในฤดูหนาว	สภาพอากาศในฤดูหนาว

   • เพิ่มค่า เลือกทั้งหมด: ไม่ได้เลือก

   • ค่าเริ่มต้น: ลมพายุฟ้าคะนอง

3. เลือก เสร็จสิ้น เพื่อสร้างพารามิเตอร์

พารามิเตอร์จะปรากฏในบานหน้าต่าง พารามิเตอร์ แต่คุณยังไม่ได้ใช้ในวิชวลใดๆ

ใช้พารามิเตอร์ค่าคงที่แบบเลือกรายการเดียว

1. เรียกใช้แบบสอบถามตัวอย่างที่ใช้พารามิเตอร์ ชนิดเหตุการณ์ ใหม่ โดยใช้ _eventType ชื่อตัวแปร:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   พารามิเตอร์ใหม่จะปรากฏในรายการพารามิเตอร์ที่ด้านบนของแดชบอร์ด

2. เลือกค่าที่แตกต่างกันเพื่ออัปเดตวิชวล

   

พารามิเตอร์ค่าคงที่แบบเลือกได้หลายรายการ

พารามิเตอร์ค่าคงที่จะขึ้นอยู่กับค่าที่กําหนดไว้ล่วงหน้าที่คุณระบุ ตัวอย่างต่อไปนี้แสดงวิธีการสร้างและใช้พารามิเตอร์ค่าคงที่แบบเลือกได้หลายรายการ

สร้างพารามิเตอร์ค่าคงที่แบบเลือกได้หลายรายการ

1. เลือก พารามิเตอร์ เพื่อเปิดบานหน้าต่าง พารามิเตอร์ แล้วเลือก พารามิเตอร์ใหม่

2. กรอกรายละเอียดตามที่อธิบายไว้ใน สร้างพารามิเตอร์ค่าคงที่ที่เลือกครั้งเดียว โดยมีการเปลี่ยนแปลงต่อไปนี้:

   • ป้ายชื่อ: ชนิดเหตุการณ์
   • ชนิดพารามิเตอร์: การเลือกหลายรายการ
   • ชื่อตัวแปร: _eventType

3. เลือก เสร็จสิ้น เพื่อสร้างพารามิเตอร์

พารามิเตอร์ใหม่จะปรากฏในบานหน้าต่าง พารามิเตอร์ แต่คุณยังไม่ได้ใช้ในวิชวลใดๆ

ใช้พารามิเตอร์ค่าคงที่แบบเลือกได้หลายรายการ

1. เรียกใช้แบบสอบถามตัวอย่างที่ใช้พารามิเตอร์ ชนิดเหตุการณ์ ใหม่และ _eventType ตัวแปร

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   พารามิเตอร์ใหม่จะปรากฏในรายการพารามิเตอร์ที่ด้านบนของแดชบอร์ด

2. เลือกค่าที่แตกต่างกันอย่างน้อยหนึ่งค่าเพื่ออัปเดตวิชวล

   

พารามิเตอร์ตามคิวรีแบบเลือกรายการเดียว

ค่าพารามิเตอร์ตามคิวรีจะถูกดึงในระหว่างการโหลดแดชบอร์ดโดยการดําเนินการคิวรีพารามิเตอร์ ตัวอย่างต่อไปนี้แสดงวิธีการสร้างและใช้พารามิเตอร์ที่ยึดตามคิวรีแบบเลือกได้รายการเดียว

หากต้องการใช้พารามิเตอร์แบบ query เป็นตัวกรองลูกที่ค่าขึ้นอยู่กับพารามิเตอร์อื่น ดูที่ สร้างพารามิเตอร์แบบ cascading

สร้างพารามิเตอร์ตามคิวรีแบบเลือกรายการเดียว

1. เลือก พารามิเตอร์ เพื่อเปิดบานหน้าต่าง พารามิเตอร์ แล้วเลือก พารามิเตอร์ใหม่

2. กรอกรายละเอียดตามที่อธิบายไว้ใน สร้างพารามิเตอร์ค่าคงที่ที่เลือกครั้งเดียว โดยมีการเปลี่ยนแปลงต่อไปนี้:

   • ป้ายชื่อ: รัฐ

   • ชื่อตัวแปร: _state

   • แหล่งข้อมูล: คิวรี

   • แหล่งข้อมูล: StormEventsSample

   • เลือก แก้ไขคิวรี และป้อนคิวรีต่อไปนี้ เลือก เสร็จสิ้น

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • ค่า: รัฐ

   • ชื่อที่แสดง: รัฐ

   • ค่าเริ่มต้น: เลือกค่าเริ่มต้น

3. เลือก เสร็จสิ้น เพื่อสร้างพารามิเตอร์

ใช้พารามิเตอร์ตามคิวรีแบบเลือกรายการเดียว

1. คิวรีตัวอย่างต่อไปนี้ที่มีพารามิเตอร์ State ใหม่ใช้_stateตัวแปร:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   พารามิเตอร์ใหม่จะปรากฏในรายการพารามิเตอร์ที่ด้านบนของแดชบอร์ด

2. เลือกค่าที่แตกต่างกันเพื่ออัปเดตวิชวล

พารามิเตอร์ตามคิวรีแบบเลือกได้หลายรายการ

ค่าพารามิเตอร์ตามคิวรีมาจากการเรียกใช้คิวรีที่ผู้ใช้ระบุเมื่อโหลดแดชบอร์ด ตัวอย่างต่อไปนี้แสดงวิธีการสร้างพารามิเตอร์แบบสอบถามแบบใช้แบบสอบถามแบบเลือกหลายส่วน

สร้างพารามิเตอร์ตามคิวรีแบบเลือกได้หลายรายการ

1. เลือก พารามิเตอร์ เพื่อเปิดบานหน้าต่าง พารามิเตอร์ แล้วเลือก + พารามิเตอร์ใหม่

2. ป้อนรายละเอียดตามที่อธิบายไว้ใน สร้างพารามิเตอร์แบบสอบถามแบบใช้การเลือกครั้งเดียว โดยมีการเปลี่ยนแปลงต่อไปนี้:

   • ป้ายชื่อ: รัฐ
   • ชนิดพารามิเตอร์: การเลือกหลายรายการ
   • ชื่อตัวแปร: _state

3. เลือก เสร็จสิ้น เพื่อสร้างพารามิเตอร์

ใช้พารามิเตอร์แบบคิวรีแบบเลือกได้หลายรายการ

1. คิวรีตัวอย่างต่อไปนี้ใช้พารามิเตอร์ State ใหม่โดยใช้_stateตัวแปร

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   หมายเหตุ

   ตัวอย่างนี้ใช้ตัวเลือก เลือกทั้งหมด โดยการตรวจหาค่าว่างด้วย isempty() ฟังก์ชัน

   พารามิเตอร์ใหม่จะปรากฏในรายการพารามิเตอร์ที่ด้านบนของแดชบอร์ด

2. เลือกค่าที่แตกต่างกันอย่างน้อยหนึ่งค่าเพื่ออัปเดตวิชวล

พารามิเตอร์ข้อความอิสระ

พารามิเตอร์ข้อความอิสระไม่มีค่าใดๆ ซึ่งช่วยให้คุณสามารถแนะนําค่าของคุณเองได้

สร้างพารามิเตอร์ข้อความอิสระ

1. เลือก พารามิเตอร์ เพื่อเปิดบานหน้าต่าง พารามิเตอร์ แล้วเลือก + พารามิเตอร์ใหม่
2. ป้อนรายละเอียดต่อไปนี้:
   • ป้ายชื่อ: รัฐ
   • ชนิดพารามิเตอร์: ข้อความอิสระ
   • ชื่อตัวแปร: _state
   • ชนิดข้อมูล: สตริง
   • ค่าเริ่มต้น: ไม่มีค่าเริ่มต้น
3. เลือก เสร็จสิ้น เพื่อสร้างพารามิเตอร์

ใช้พารามิเตอร์ข้อความอิสระ

1. เรียกใช้คิวรีตัวอย่างโดยใช้พารามิเตอร์ State ใหม่โดยใช้_stateชื่อตัวแปร:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

พารามิเตอร์แหล่งข้อมูล

หลังจากที่คุณ เพิ่มแหล่งข้อมูล ลงในแดชบอร์ดของคุณแล้ว คุณสามารถสร้างพารามิเตอร์ที่เลือกแหล่งข้อมูลที่พร้อมใช้งานอย่างน้อยหนึ่งแหล่งข้อมูล ใช้พารามิเตอร์นี้ในไทล์และพารามิเตอร์อื่นๆ

สร้างพารามิเตอร์แหล่งข้อมูล

1. เลือก พารามิเตอร์ เพื่อเปิดบานหน้าต่าง พารามิเตอร์ แล้วเลือก + พารามิเตอร์ใหม่

2. ป้อนรายละเอียดต่อไปนี้:

   • ป้ายชื่อ: แหล่งข้อมูล
   • ชนิดพารามิเตอร์: แหล่งข้อมูล
   • แสดงบนหน้า: เลือกทั้งหมด
   • ค่า: เลือกทั้งหมด
   • ค่าเริ่มต้น: StormEvents

   

3. เลือก เสร็จสิ้น

รายการพารามิเตอร์ที่ด้านบนของแดชบอร์ดจะแสดงพารามิเตอร์ใหม่

ใช้พารามิเตอร์แหล่งข้อมูล

1. ไปที่คิวรีของไทล์ใหม่หรือไทล์ที่มีอยู่

2. ใน แหล่งข้อมูล ให้เลือกชื่อของพารามิเตอร์ใหม่ของคุณภายใต้ พารามิเตอร์แหล่งข้อมูล เช่น พารามิเตอร์แหล่งข้อมูลใหม่

   

3. เลือก นําการเปลี่ยนแปลงไปใช้

4. ใช้พารามิเตอร์ แหล่ง เพื่อเปลี่ยนแหล่งข้อมูลสําหรับคิวรีที่เชื่อมต่อนี้

ใช้การค้นหาตัวกรองสําหรับตัวกรองการเลือกครั้งเดียวและหลายรายการ

ในตัวกรองการเลือกครั้งเดียวและการเลือกหลายรายการ ให้พิมพ์ค่าที่คุณต้องการ ตัวกรองจะอัปเดตเพื่อแสดงเฉพาะค่าที่ตรงกับข้อความค้นหา

เนื้อหาที่เกี่ยวข้อง

• สร้างและจัดการพารามิเตอร์แดชบอร์ด Real-Time
• กําหนดค่าการโต้ตอบใน Real-Time Dashboards