แชร์ผ่าน


สร้างการแจ้งเตือนตัวกระตุ้นจากชุดคิวรี KQL

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

คุณสามารถกําหนดค่า Activator ให้ทริกเกอร์การแจ้งเตือนตามผลลัพธ์ของ KQL Queryset ในสองสถานการณ์:

  • เมื่อคิวรี KQL ตามกําหนดการจะส่งคืนผลลัพธ์
  • เมื่อคิวรี KQL ตามกําหนดการจะส่งคืนผลลัพธ์พร้อมการแสดงภาพที่ตรงตามเงื่อนไขเฉพาะ

ส่งการแจ้งเตือนถึงตัวคุณเอง หรือผู้อื่นในองค์กรของคุณ คุณสามารถกําหนดค่าการแจ้งเตือนที่จะส่งทางอีเมลหรือข้อความ Microsoft Teams

ตัวอย่างสถานการณ์

ต่อไปนี้คือตัวอย่างบางส่วนของวิธีใช้การแจ้งเตือน Activator กับการสืบค้น KQL:

  • ตรวจสอบบันทึกแอปพลิเคชันเพื่อหาข้อผิดพลาด: สมมติว่าคุณมีฐานข้อมูล KQL ที่จัดเก็บบันทึกแอปพลิเคชัน คุณสามารถกําหนดค่าการแจ้งเตือนเพื่อแจ้งให้คุณทราบหากระเบียนใด ๆ จากห้านาทีที่ผ่านมามีสตริงauthorization errorในคอลัมน์ข้อความ

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

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

  • พื้นที่ทํางาน ที่มีความจุ ที่เปิดใช้งาน Microsoft Fabric
  • ฐานข้อมูล KQL พร้อมข้อมูล
  • คิวรี KQL ที่เชื่อมต่อกับฐานข้อมูล KQL สําหรับข้อมูลเพิ่มเติม ดูข้อมูล คิวรีในชุดคิวรี KQL

สำคัญ

  • สนับสนุนเฉพาะคิวรีเทียบกับฐานข้อมูล KQL ภายใน Eventhouse เท่านั้น ถ้าชุดคิวรี KQL ของคุณเชื่อมต่อกับ คลัสเตอร์ Azure Data Explorer ภายนอก การสร้างการแจ้งเตือนจะไม่ได้รับการสนับสนุน
  • ผลกระทบของกฎการแจ้งเตือนบน Eventhouse ขึ้นอยู่กับความซับซ้อนของคิวรี การสืบค้นและการรวมอย่างง่ายมีน้ําหนักเบา ในขณะที่การรวม การแปลง และการเรียงลําดับนั้นใช้ทรัพยากรมากกว่า หากการสืบค้นทํางานทุกๆ 1 หรือ 5 นาที ระบบจะรักษา Eventhouse ให้อยู่ในสถานะ เปิดตลอดเวลา ได้อย่างมีประสิทธิภาพ หากไม่มีการสอบถามหรือนําเข้านานกว่า 5 นาที Eventhouse สามารถไม่ได้ใช้งาน ซึ่งช่วยลดต้นทุน สําหรับข้อมูลเพิ่มเติม โปรดดู เวลาทํางานของบ้านเหตุการณ์

ขั้นตอนต่อไปนี้แสดงวิธีการสร้างการแจ้งเตือนบนคิวรีที่สร้างการแสดงภาพ หรือในคิวรีที่ไม่สร้างการแสดงภาพ

เลือกแท็บที่สอดคล้องกับเวิร์กโฟลว์ที่คุณต้องการ

ตั้งค่าการแจ้งเตือนบนชุดคิวรี KQL

สำคัญ

การแสดงภาพแผนภูมิเวลาไม่ได้รับการสนับสนุนในสถานการณ์นี้ รองรับในสร้างการแจ้งเตือน Activator จากแดชบอร์ด Real-Time

  1. เปิดพื้นที่ทํางานที่มีคิวรี KQL ของคุณ

  2. เรียกดูชุดคิวรี KQL ของคุณ และเลือกเพื่อเปิด

  3. เรียกใช้คิวรีที่ส่งกลับการแสดงภาพ

  4. เมื่อคิวรีส่งกลับผลลัพธ์ เลือก ตั้งค่าการแจ้งเตือน บนริบบอนด้านบน

    สกรีนช็อตของปุ่ม ตั้งค่าการแจ้งเตือน ใน Ribbon ด้านบน

กําหนดเงื่อนไขการแจ้งเตือน

ในบานหน้าต่างด้านข้าง เพิ่มกฎ ที่ปรากฏขึ้น ให้ทําตามขั้นตอนเหล่านี้เพื่อกําหนดเงื่อนไขการแจ้งเตือนของคุณ:

  1. ในส่วน รายละเอียด ให้ระบุชื่อสําหรับกฎการแจ้งเตือน Activator ของคุณ

    สกรีนช็อตของส่วน รายละเอียด ในบานหน้าต่างด้านข้าง เพิ่มกฎ

  2. ในส่วน ตรวจสอบ ให้ตั้งค่าความถี่ของความถี่ในการเรียกใช้คิวรี ค่าเริ่มต้นคือ 5 นาที

    สกรีนช็อตของส่วน ตรวจสอบ ในบานหน้าต่างด้านข้าง เพิ่มกฎ

  3. ใน เงื่อนไข ระบุเงื่อนไขการแจ้งเตือนของคุณดังนี้:

    สกรีนช็อตของส่วน เงื่อนไข ในบานหน้าต่างด้านข้าง เพิ่มกฎ

    • ถ้าการแสดงภาพของคุณไม่มีขนาด คุณสามารถเลือกเปิด แต่ละเหตุการณ์เมื่อ เงื่อนไขเพื่อตรวจสอบการเปลี่ยนแปลงในสตรีมข้อมูลโดยการเลือกเขตข้อมูลเฉพาะเพื่อตรวจสอบ
    • ใน ดรอปดาวน์ เมื่อ ตั้งค่าที่จะประเมิน
    • ใน ดรอปดาวน์ เงื่อนไข ให้ตั้งค่าเงื่อนไขที่จะประเมิน สําหรับข้อมูลเพิ่มเติม ให้ดู เงื่อนไข
    • ในฟิลด์ เหตุการณ์ ให้ตั้งค่าจํานวนครั้งที่ต้องปฏิบัติตามเงื่อนไขก่อนที่จะทริกเกอร์การแจ้งเตือน
  4. ในส่วน การดําเนินการ ให้เลือกการดําเนินการอย่างใดอย่างหนึ่งต่อไปนี้:

    • ส่งการแจ้งเตือนทางอีเมล:

      1. สําหรับการดําเนินการเลือก ให้เลือกส่งอีเมล
      2. สําหรับ ถึง ให้ป้อนที่อยู่อีเมลของผู้รับหรือใช้รายการแบบเลื่อนลงเพื่อเลือกพร็อพเพอร์ตี้ที่มีค่าเป็นที่อยู่อีเมล โดยค่าเริ่มต้น ที่อยู่อีเมลของคุณจะถูกเติมไว้ที่นี่
      3. สําหรับ หัวเรื่อง ให้ป้อนหัวเรื่องของการแจ้งเตือนทางอีเมล
      4. ในส่วน บรรทัดแรก ให้ป้อนบรรทัดแรกของการแจ้งเตือนทางอีเมล
      5. ในส่วน โน้ต ให้ป้อนโน้ตสําหรับการแจ้งเตือนทางอีเมล

        Note

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

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

      สกรีนช็อตของส่วน ส่งการแจ้งเตือนทางอีเมล ในบานหน้าต่างด้านข้าง เพิ่มกฎ

    • ส่งการแจ้งเตือน Microsoft Teams: ส่งข้อความ Microsoft Teams ถึงตัวคุณเอง คุณสามารถปรับแต่งชื่อและเนื้อหาข้อความได้

      1. สําหรับ เลือกการดําเนินการ ให้เลือก ทีม -->ส่งข้อความถึงผู้ร่วมงาน หรือ ข้อความแชทกลุ่ม หรือ โพสต์ช่องทาง
      2. ทําตามขั้นตอนใดขั้นตอนหนึ่งต่อไปนี้ขึ้นอยู่กับการเลือกของคุณ:
        • หากคุณเลือกตัวเลือก ส่งข้อความถึงบุคคล ให้ป้อน ที่อยู่อีเมล ของผู้รับหรือใช้รายการแบบเลื่อนลงเพื่อเลือกพร็อพเพอร์ตี้ที่มีค่าเป็นอีเมล เมื่อตรงตามเงื่อนไข ระบบจะส่งอีเมลไปยังบุคคลที่ระบุ
        • หากคุณเลือกตัวเลือก ข้อความแชทกลุ่ม ให้เลือก แชทกลุ่ม จากรายการดรอปดาวน์ เมื่อตรงตามเงื่อนไข จะมีการโพสต์ข้อความไปยังแชทกลุ่ม
        • หากคุณเลือกตัวเลือก โพสต์ช่องทาง ให้เลือก ทีม และ ช่องทาง จากรายการดรอปดาวน์ เมื่อตรงตามเงื่อนไข จะมีการโพสต์ข้อความไปยังช่องทางที่เลือก
      3. สําหรับ บรรทัดแรก ให้ป้อนบรรทัดแรกของการแจ้งเตือน Teams
      4. สําหรับ โน้ต ให้ป้อนโน้ตสําหรับการแจ้งเตือน Teams

        Note

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

      5. สําหรับ บริบท ให้เลือกค่าจากรายการดรอปดาวน์ที่คุณต้องการรวมไว้ในการแจ้งเตือน Teams

      สกรีนช็อตของส่วน ส่งการแจ้งเตือน Microsoft Teams ในบานหน้าต่างด้านข้าง เพิ่มกฎ

    • เรียกใช้กิจกรรม Fabric: หากต้องการกําหนดค่าการแจ้งเตือนเพื่อเปิดใช้ไปป์ไลน์ Fabric, งาน Spark หรือสมุดบันทึกเมื่อตรงตามเงื่อนไข ให้ทําตามขั้นตอนเหล่านี้:

      1. สําหรับการดําเนินการเลือก ให้เลือก เรียกใช้ไปป์ไลน์ เรียกใช้งาน Spark เรียกใช้สมุดบันทึก หรือ เรียกใช้ฟังก์ชัน (พรีวิว)
      2. บน เลือกรายการ Fabric ที่จะเรียกใช้ ให้เลือกรายการ Fabric (ไปป์ไลน์ สมุดบันทึก งาน Spark หรือฟังก์ชัน) จากรายการ
      3. เลือก เพิ่มพารามิเตอร์ และระบุชื่อของพารามิเตอร์สําหรับรายการ Fabric และค่าสําหรับพารามิเตอร์นั้น คุณสามารถเพิ่มพารามิเตอร์ได้มากกว่าหนึ่งพารามิเตอร์ คุณสามารถส่งพารามิเตอร์จากข้อมูลการแจ้งเตือนได้โดยการพิมพ์ @ หรือเลือกปุ่มถัดจากกล่องข้อความ ตัวอย่างเช่น: @BikepointID สกรีนช็อตของส่วน เรียกใช้กิจกรรม Fabric ในบานหน้าต่างด้านข้าง เพิ่มกฎ
    • การดําเนินการแบบกําหนดเอง: หากต้องการกําหนดค่าการแจ้งเตือนเพื่อเรียกใช้การดําเนินการแบบกําหนดเองเมื่อตรงตามเงื่อนไข ให้ทําตามขั้นตอนเหล่านี้:

      1. สําหรับ เลือกการดําเนินการ ให้เลือก สร้างการดําเนินการแบบกําหนดเอง

        สกรีนช็อตของส่วน สร้างการดําเนินการแบบกําหนดเอง ในบานหน้าต่างด้านข้าง เพิ่มกฎ

      2. ตามที่กล่าวไว้ในส่วน การดําเนินการ ให้สร้างกฎก่อน จากนั้นจึงตั้งค่าการดําเนินการแบบกําหนดเองให้เสร็จสมบูรณ์โดยทําตามขั้นตอนจาก ทริกเกอร์การดําเนินการแบบกําหนดเอง (โฟลว์ Power Automate)

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

  5. ใน บันทึกตําแหน่งที่ตั้ง ระบุตําแหน่งที่จะบันทึกการแจ้งเตือน Activator ของคุณ เลือกพื้นที่ทํางานที่มีอยู่ และบันทึกลงในตัวกระตุ้นที่มีอยู่หรือพื้นที่ทํางานใหม่

    สกรีนช็อตของส่วน บันทึกตําแหน่งที่ตั้ง ในบานหน้าต่างด้านข้าง เพิ่มกฎ

  6. เลือก สร้าง เพื่อสร้างกฎการเปิดใช้งานของคุณ

ไม่บังคับ: แก้ไขกฎของคุณใน Activator

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

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

สําหรับข้อมูลเกี่ยวกับวิธีการแก้ไขกฎใน Activator ดู สร้างกฎตัวกระตุ้น

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