แชร์ผ่าน

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

  • บทความ

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

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

หมายเหตุ

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

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

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

หมายเหตุ

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

เพิ่มจุดสิ้นสุดแบบกําหนดเองเป็นปลายทาง

ถ้าคุณต้องการกําหนดเส้นทางข้อมูลเหตุการณ์ไปยังแอปของคุณ คุณสามารถเพิ่มจุดสิ้นสุดแบบกําหนดเองเป็นปลายทางเหตุการณ์ของคุณ:

  1. ถ้าคุณอยู่ในมุมมองสด สลับไปยังโหมดแก้ไข โดยการเลือก แก้ไข บน ribbon

    สกรีนช็อตที่แสดงปุ่มแก้ไขที่ช่วยให้คุณสลับไปยังโหมดแก้ไข

  2. ในโหมดแก้ไข เพิ่มปลายทางปลายทางแบบกําหนดเองหนึ่งในวิธีต่อไปนี้:

    • เลือก เพิ่มปลายทาง บนริบบอน เลือก จุดสิ้นสุดแบบกําหนดเอง แล้วเชื่อมต่อจุดสิ้นสุดกับสตรีมเริ่มต้นหรือสตรีมที่ได้รับ

      สกรีนช็อตที่แสดงการเลือกจุดสิ้นสุดแบบกําหนดเองเป็นปลายทางบนริบบอน

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

      สกรีนช็อตที่แสดงการเลือกจุดสิ้นสุดแบบกําหนดเองในตัวแก้ไข

  3. สําหรับ ชื่อปลายทาง ให้ใส่ชื่อสําหรับจุดสิ้นสุดแบบกําหนดเอง จากนั้น เลือก บันทึก

    สกรีนช็อตที่แสดงบานหน้าต่างสําหรับการป้อนชื่อสําหรับจุดสิ้นสุดแบบกําหนดเอง

  4. เชื่อมต่อไทล์สตรีมเริ่มต้นไปยังไทล์จุดสิ้นสุดแบบกําหนดเองถ้าไม่มีการเชื่อมต่อที่มีอยู่

    สกรีนช็อตที่แสดงการเชื่อมต่อกับไทล์จุดสิ้นสุดแบบกําหนดเอง

  5. เมื่อต้องการดูข้อมูลรายละเอียดของจุดสิ้นสุดแบบกําหนดเองของคุณ ให้เลือก เผยแพร่

    สกรีนช็อตที่แสดงปุ่มเผยแพร่

รับรายละเอียดจุดสิ้นสุดในบานหน้าต่างรายละเอียดเพื่อใช้เหตุการณ์

ในมุมมองสด เลือกไทล์จุดสิ้นสุดแบบกําหนดเอง บานหน้าต่างรายละเอียดที่ปรากฏขึ้นมีแท็บโพรโทคอลสามแท็บ: Event Hub, AMQP และ Kafka

สกรีนช็อตที่แสดงบานหน้าต่างรายละเอียดสําหรับจุดสิ้นสุดแบบกําหนดเอง

แต่ละแท็บโพรโทคอลมีสามหน้า: พื้นฐาน คีย์ และรหัสตัวอย่าง หน้าเหล่านี้มีรายละเอียดจุดสิ้นสุดด้วยโพรโทคอลที่สอดคล้องกันสําหรับการเชื่อมต่อ

พื้นฐาน แสดงชื่อ ชนิด และสถานะของจุดสิ้นสุดแบบกําหนดเองของคุณ

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

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

ฮับเหตุการณ์

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

สกรีนช็อตที่แสดงคีย์ฮับเหตุการณ์ในบานหน้าต่างรายละเอียดของมุมมองเหตุการณ์สด

รูปแบบฮับเหตุการณ์เป็นค่าเริ่มต้นสําหรับสายอักขระการเชื่อมต่อ และทํางานกับ Azure Event Hubs SDK รูปแบบนี้ช่วยให้คุณสามารถเชื่อมต่อกับเหตุการณ์ของคุณผ่านทางโพรโทคอล Event Hubs

ตัวอย่างต่อไปนี้แสดงให้เห็นว่าสายอักขระการเชื่อมต่อมีลักษณะเป็นอย่างไรในรูปแบบฮับเหตุการณ์:

Endpoint=sb://eventstream-xxxxxxx.servicebus.windows.net/; SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxx;EntityPath=es_xxxxxxx

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

สกรีนช็อตที่แสดงรหัสตัวอย่างฮับเหตุการณ์ในบานหน้าต่างรายละเอียดของมุมมองการถ่ายทอดสดเหตุการณ์

Kafka

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

สกรีนช็อตที่แสดงคีย์ Kafka ในบานหน้าต่างรายละเอียดของมุมมองการถ่ายทอดสดเหตุการณ์

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

สกรีนช็อตที่แสดงรหัสตัวอย่าง Kafka ในบานหน้าต่างรายละเอียดของมุมมองการถ่ายทอดสดเหตุการณ์

AMQP

รูปแบบ AMQP สามารถเข้ากันได้กับโปรโตคอล AMQP 1.0 ซึ่งเป็นโปรโตคอลการรับส่งข้อความมาตรฐานที่สนับสนุนการทํางานร่วมกันระหว่างแพลตฟอร์มและภาษาต่างๆ คุณสามารถใช้รูปแบบนี้เพื่อเชื่อมต่อกับเหตุการณ์ของคุณโดยใช้โพรโทคอล AMQP ได้

สกรีนช็อตที่แสดงคีย์ AMQP ในบานหน้าต่างรายละเอียดของมุมมองการถ่ายทอดสดเหตุการณ์

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

สกรีนช็อตที่แสดงรหัสตัวอย่าง AMQP ในบานหน้าต่างรายละเอียดของมุมมองการถ่ายทอดสดเหตุการณ์

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

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

หากต้องการเรียนรู้วิธีการเพิ่มปลายทางอื่น ๆ ในอีเวนต์สตรีม ให้ดูบทความต่อไปนี้:

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

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

หมายเหตุ

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

เพิ่มแอปแบบกําหนดเองเป็นปลายทาง

ถ้าคุณต้องการกําหนดเส้นทางข้อมูลเหตุการณ์ไปยังแอปพลิเคชันของคุณ คุณสามารถเพิ่มแอปแบบกําหนดเองเป็นปลายทางเหตุการณ์:

  1. เลือก ปลายทาง ใหม่ บนริบบอนหรือเครื่องหมายบวก (+) ในพื้นที่ทํางานของตัวแก้ไขหลัก จากนั้นเลือก แอปแบบกําหนดเอง

  2. ในบานหน้าต่างแอปแบบกําหนดเอง ใส่ชื่อปลายทางสําหรับแอปแบบกําหนดเอง จากนั้นเลือกเพิ่ม

    สกรีนช็อตของบานหน้าต่างสําหรับการกําหนดค่าแอปแบบกําหนดเองเป็นปลายทาง

รับรายละเอียดจุดสิ้นสุดในบานหน้าต่างรายละเอียดเพื่อใช้เหตุการณ์

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

สกรีนช็อตที่แสดงบานหน้าต่างรายละเอียดสําหรับปลายทางของแอปแบบกําหนดเอง

บานหน้าต่างรายละเอียดมีแท็บโพรโทคอลสามแท็บ: Event Hub, AMQP และ Kafka แต่ละแท็บโพรโทคอลมีสามหน้า: พื้นฐาน คีย์ และรหัสตัวอย่าง หน้าเหล่านี้มีรายละเอียดจุดสิ้นสุดด้วยโพรโทคอลที่สอดคล้องกันสําหรับการเชื่อมต่อ

พื้นฐาน แสดงชื่อ ชนิด และสถานะของแอปแบบกําหนดเองของคุณ

สกรีนช็อตที่แสดงรายละเอียดพื้นฐานสําหรับแอปแบบกําหนดเองในบานหน้าต่างรายละเอียดของเหตุการณ์

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

ฮับเหตุการณ์

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

สกรีนช็อตที่แสดงคีย์ฮับเหตุการณ์ในบานหน้าต่างรายละเอียดของเหตุการณ์

รูปแบบฮับเหตุการณ์เป็นค่าเริ่มต้นสําหรับสายอักขระการเชื่อมต่อ และทํางานกับ Azure Event Hubs SDK รูปแบบนี้ช่วยให้คุณสามารถเชื่อมต่อกับเหตุการณ์ของคุณผ่านทางโพรโทคอล Event Hubs

ตัวอย่างต่อไปนี้แสดงให้เห็นว่าสายอักขระการเชื่อมต่อมีลักษณะเป็นอย่างไรในรูปแบบฮับเหตุการณ์:

Endpoint=sb://eventstream-xxxxxxx.servicebus.windows.net/; SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxx;EntityPath=es_xxxxxxx

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

สกรีนช็อตที่แสดงรหัสตัวอย่างฮับเหตุการณ์ในบานหน้าต่างรายละเอียดของเหตุการณ์

Kafka

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

สกรีนช็อตที่แสดงคีย์ Kafka ในบานหน้าต่างรายละเอียดของเหตุการณ์

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

สกรีนช็อตที่แสดงรหัสตัวอย่าง Kafka ในบานหน้าต่างรายละเอียดของเหตุการณ์

AMQP

รูปแบบ AMQP สามารถเข้ากันได้กับโปรโตคอล AMQP 1.0 ซึ่งเป็นโปรโตคอลการรับส่งข้อความมาตรฐานที่สนับสนุนการทํางานร่วมกันระหว่างแพลตฟอร์มและภาษาต่างๆ คุณสามารถใช้รูปแบบนี้เพื่อเชื่อมต่อกับเหตุการณ์ของคุณโดยใช้โพรโทคอล AMQP ได้

สกรีนช็อตที่แสดงคีย์ AMQP ในบานหน้าต่างรายละเอียดของเหตุการณ์

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

สกรีนช็อตที่แสดงรหัสตัวอย่าง AMQP ในบานหน้าต่างรายละเอียดของเหตุการณ์

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

จัดการปลายทาง

คุณสามารถแก้ไข (ผ่าน คําสั่งแก้ไข ) หรือเอาออก (ผ่าน คําสั่งเอาออก ) ปลายทางเหตุการณ์กระแสข้อมูลผ่านบานหน้าต่าง ข้อมูล หรือพื้นที่ทํางาน

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

สกรีนช็อตที่แสดงตําแหน่งที่จะเลือกตัวเลือกปรับเปลี่ยนและลบสําหรับปลายทางบนพื้นที่ทํางาน

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

หากต้องการเรียนรู้วิธีการเพิ่มปลายทางอื่น ๆ ในอีเวนต์สตรีม ให้ดูบทความต่อไปนี้: