ใช้กิจกรรม KQL เพื่อเรียกใช้คิวรี

กิจกรรม KQL ใน Data Factory สําหรับ Microsoft Fabric ช่วยให้คุณสามารถเรียกใช้คิวรีใน Kusto Query Language (KQL) กับอินสแตนซ์ Azure Data Explorer

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

เมื่อต้องการเริ่มต้นใช้งาน คุณต้องดําเนินการข้อกําหนดเบื้องต้นต่อไปนี้ให้เสร็จสมบูรณ์:

เพิ่มกิจกรรม KQL ไปยังไปป์ไลน์ด้วย UI

หากต้องการใช้กิจกรรม KQL ในไปป์ไลน์ ให้ทําตามขั้นตอนต่อไปนี้:

การสร้างกิจกรรม

  1. สร้างไปป์ไลน์ใหม่ในพื้นที่ทํางานของคุณ

  2. ค้นหา KQL ในบานหน้าต่างกิจกรรมไปป์ไลน์ และเลือกเพื่อเพิ่มไปยังพื้นที่ทํางานของไปป์ไลน์

    หมายเหตุ

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

    สกรีนช็อตของ Fabric UI ที่มีบานหน้าต่างกิจกรรมและกิจกรรม KQL ที่เน้น

  3. เลือกกิจกรรม KQL ใหม่บนพื้นที่ตัวแก้ไขไปป์ไลน์ถ้ายังไม่ได้เลือกไว้

    สกรีนช็อตแสดงแท็บการตั้งค่าทั่วไปของกิจกรรม KQL

โปรดดูคําแนะนําการตั้งค่าทั่วไปเพื่อกําหนดค่าแท็บ การตั้งค่าทั่วไป

การตั้งค่ากิจกรรม KQL

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

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

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

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

บันทึกและเรียกใช้หรือจัดกําหนดการไปป์ไลน์

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

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

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

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

ข้อจำกัดที่ทราบ

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

วิธีแก้ปัญหาคือการใช้ตัวแปรพื้นที่ทํางาน (ไลบรารีตัวแปร) สําหรับคุณสมบัติการเชื่อมต่อเฉพาะพื้นที่ทํางานทั้งหมด และอ้างอิงผ่าน endpointVariableLibrary, artifactIdVariableLibrary และ workspaceIdVariableLibrary