แชร์ผ่าน


เพิ่มแหล่งข้อมูล HTTP ลงในสตรีมเหตุการณ์ (พรีวิว)

บทความนี้แสดงวิธีเพิ่มแหล่งข้อมูล HTTP ลงในสตรีมเหตุการณ์

ตัวเชื่อมต่อ HTTP ให้วิธีที่ไม่ต้องเขียนโค้ดและกําหนดค่าได้ในการสตรีมข้อมูลจาก REST API ใดๆ ไปยัง Eventstream โดยตรงสําหรับการประมวลผลแบบเรียลไทม์ ช่วยให้คุณสามารถดึงข้อมูลจากแพลตฟอร์ม SaaS และฟีดข้อมูลสาธารณะได้อย่างต่อเนื่อง และแยกวิเคราะห์การตอบกลับ JSON เป็นเหตุการณ์ที่มีโครงสร้างโดยอัตโนมัติ นอกจากนี้ยังมีตัวอย่างฟีดสาธารณะเพื่อช่วยให้คุณเริ่มต้นได้อย่างรวดเร็ว เพียงเลือก API ตัวอย่าง ป้อนคีย์ API ของคุณ และให้ Eventstream กรอกส่วนหัวและพารามิเตอร์ที่จําเป็นล่วงหน้า

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

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

เพิ่ม HTTP เป็นแหล่งที่มา

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

สกรีนช็อตที่แสดงการเลือกไทล์สําหรับการใช้แหล่งข้อมูลภายนอก

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

สกรีนช็อตที่แสดงการเลือกสําหรับการเพิ่มแหล่งข้อมูลภายนอก

ค้นหา http แล้วเลือก เชื่อมต่อ เพื่อเพิ่มตัวเชื่อมต่อ HTTP ไปยังสตรีมเหตุการณ์ของคุณ

สกรีนช็อตที่แสดงการเลือก HTTP เป็นชนิดแหล่งข้อมูลในตัวช่วยสร้าง เลือกแหล่งข้อมูล

กําหนดค่าและเชื่อมต่อกับ HTTP

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

ใช้ตัวอย่าง API สาธารณะ

  1. เลือก API สาธารณะตัวอย่างเพื่อตั้งค่าตัวเชื่อมต่อ HTTP อย่างรวดเร็ว: ภาพหน้าจอที่แสดงหน้า API ตัวอย่าง

    • ไบแนนซ์ รับราคา Bitcoin ล่าสุด
    • คอยน์ตุ๊กแก รับราคา Bitcoin ปัจจุบันเป็น USD
    • การขนส่งสําหรับลอนดอน รับการคาดการณ์การมาถึงแบบสดสําหรับสถานีในลอนดอน
    • อัลฟ่าแวนเทจ รับราคาหุ้น MSFT แบบเรียลไทม์
    • โอเพ่นเวทเธอร์ รับการพยากรณ์อากาศสําหรับสถานที่
    • ข่าว API รับพาดหัวข่าวธุรกิจล่าสุดในสหรัฐอเมริกา
  2. สําหรับ API ที่ต้องใช้คีย์ API ให้ใช้ลิงก์ที่ให้ไว้เพื่อสมัครคีย์ API และป้อนลงในช่องป้อนข้อมูล จากนั้นตัวเชื่อมต่อจะสร้างการเชื่อมต่อระบบคลาวด์ Fabric โดยอัตโนมัติ และกรอกส่วนหัวและพารามิเตอร์ HTTP ที่จําเป็นไว้ล่วงหน้า

    สําคัญ

    API ตัวอย่างของ Binance ไม่จําเป็นต้องใช้คีย์ API แต่คุณมีหน้าที่รับผิดชอบในการปฏิบัติตามข้อกําหนดการใช้งาน

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

  4. หรือ เลือกออก เพื่อปิดหน้าต่างและกําหนดค่าแหล่งที่มา HTTP ของคุณเองตั้งแต่เริ่มต้น

กําหนดค่าแหล่งที่มา HTTP ของคุณเอง

ทําตามขั้นตอนเพื่อกําหนดค่าแหล่งที่มา HTTP ของคุณเองโดยไม่มี API ตัวอย่าง

  1. สร้างการเชื่อมต่อใหม่ เลือกการเชื่อมต่อ ใหม่ และป้อนคุณสมบัติที่จําเป็นสําหรับแหล่งข้อมูล HTTP ของคุณ:

    สกรีนช็อตที่แสดงตําแหน่งที่จะเลือกหน้าการเชื่อมต่อใหม่

    • URL พื้นฐาน: URL พื้นฐานของปลายทาง HTTP
    • Token Audience Uri (ไม่บังคับ): ทรัพยากรที่โทเค็นมีไว้สําหรับ
    • ชื่อการเชื่อมต่อ: ป้อนชื่อสําหรับการเชื่อมต่อ
    • ชนิดการรับรองความถูกต้อง: ปัจจุบัน ตัวเชื่อมต่อ HTTP รองรับ Anonymousเฉพาะ , Basicและ API Key การรับรองความถูกต้อง

    สกรีนช็อตที่แสดงหน้าการเชื่อมต่อใหม่

  2. วิธีการขอ: เลือก GET หรือPOST

  3. ส่วนหัวและพารามิเตอร์: หากคุณเลือกการตรวจสอบ สิทธิ์คีย์ API เมื่อคุณสร้างการเชื่อมต่อระบบคลาวด์ ให้ใช้พารามิเตอร์แบบไดนามิก ${apiKey} ในส่วนหัวหรือพารามิเตอร์ของคุณเพื่ออ้างอิงคีย์ API

    ตัวอย่างเช่น หากต้องการเชื่อมต่อกับ CoinGecko ให้ใช้ส่วนหัว: x_cg_demo_api_key = ${apiKey}

    สําคัญ

    อย่าป้อนคีย์ API หรือข้อมูลเข้าสู่ระบบอื่นๆ ในส่วนหัวหรือพารามิเตอร์

  4. ช่วงเวลาคําขอ: ระบุเวลาเป็นวินาทีเพื่อรอระหว่างคําขอที่ต่อเนื่องกัน ช่วงที่ถูกต้องคือ [1, 3600]

  5. การลองใหม่สูงสุด: จํานวนครั้งสูงสุดที่ตัวเชื่อมต่อลองคําขอใหม่เมื่อเกิดข้อผิดพลาด ช่วงที่ถูกต้องคือ [10, 100]

  6. ลองแบ็คออฟอีกครั้ง: เวลาเป็นวินาทีที่ต้องรอหลังจากเกิดข้อผิดพลาดก่อนที่ตัวเชื่อมต่อจะลองอีกครั้ง ช่วงที่ถูกต้องคือ [1, 3600]

  7. ลองรหัสสถานะอีกครั้ง: รหัสข้อผิดพลาด HTTP ที่ส่งคืนซึ่งแจ้งให้ตัวเชื่อมต่อลองคําขออีกครั้ง ป้อนรายการรหัสหรือช่วงของรหัสที่คั่นด้วยจุลภาค ช่วงจะถูกระบุด้วยรหัสเริ่มต้นและรหัสสิ้นสุดที่ไม่บังคับ เช่น:

    • 400- รวมรหัสทั้งหมดที่มากกว่าหรือเท่ากับ 400
    • 400-500 รวมรหัสตั้งแต่ 400 ถึง 500 รวมถึง 500
    • 404,408,500- พร้อมท์ตัวเชื่อมต่อให้ลองอีกครั้งใน 404 NOT FOUND, 408 REQUEST TIMEOUT และรหัสข้อผิดพลาด 5xx ทั้งหมด

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

    สกรีนช็อตที่แสดงการตั้งค่าที่กําหนดไว้

  8. ตรวจสอบสรุปการกําหนดค่าสําหรับแหล่งที่มา HTTP แล้วเลือกเพิ่ม

    สกรีนช็อตที่แสดงหน้าการตั้งค่าคอนฟิกการตรวจทาน

คุณสามารถดูแหล่งที่มาของ HTTP ที่เพิ่มลงในสตรีมเหตุการณ์ของคุณในโหมดแก้ไข

ภาพหน้าจอของแหล่งที่มา HTTP ที่เพิ่มในโหมดแก้ไขโดยเน้นปุ่มเผยแพร่

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

ภาพหน้าจอของแหล่งที่มา HTTP ที่เพิ่มในมุมมองสดที่มีปุ่ม เผยแพร่ ถูกเน้น

ข้อจำกัด

  • ปัจจุบันตัวเชื่อมต่อ HTTP รองรับเฉพาะการตอบกลับ JSON API เท่านั้น
  • ไม่รองรับการรับรองความถูกต้อง OAuth
  • แหล่งที่มาของ HTTP ไม่รองรับคุณลักษณะ CI/CD รวมถึง Git Integration และ Deployment Pipeline การส่งออกหรือนําเข้ารายการ Eventstream ที่มีแหล่งข้อมูลนี้ผ่าน Git อาจส่งผลให้เกิดข้อผิดพลาด

ตัวเชื่อมต่ออื่นๆ: