สร้างรายการฟังก์ชันข้อมูลผู้ใช้ Fabric ใน Visual Studio Code

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

ในการเริ่มต้นใช้งานด่วนนี้ คุณจะได้เรียนรู้วิธีการสร้างรายการฟังก์ชันข้อมูลผู้ใช้ในรหัส Visual Studio (VS)

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

• พื้นที่ทํางาน Fabric
• รหัส Visual Studio
• หลาม
• เครื่องมือหลักของ Azure Functions v4
• ส่วนขยาย Microsoft Fabric
• ส่วนขยายฟังก์ชันข้อมูลผู้ใช้

เลือกพื้นที่ทํางานของคุณ

1. เปิด VS Code และ ลงชื่อเข้าใช้ Fabric

2. ใน Fabric เปิด พื้นที่ทํางาน Fabric ของคุณหรือ สร้างพื้นที่ทํางานใหม่

3. เลือก + รายการใหม่ เพื่อเปิดบานหน้าต่างรายการใหม่

4. ในบานหน้าต่างรายการใหม่ ภายใต้ พัฒนาข้อมูลให้เลือกฟังก์ชันข้อมูลผู้ใช้ ชนิดรายการ

5. ระบุชื่อสําหรับรายการฟังก์ชันข้อมูลผู้ใช้ใหม่ และเลือก สร้าง รายการฟังก์ชันข้อมูลผู้ใช้ใหม่จะถูกสร้างขึ้น

6. ในริบบอน ให้เลือก Python เป็นภาษารันไทม์

7. สร้างสภาพแวดล้อมเสมือนสําหรับรายการฟังก์ชันข้อมูลผู้ใช้นี้

8. เลือกเวอร์ชันรันไทม์ Python ฟังก์ชันข้อมูลผู้ใช้จําเป็นต้องใช้ Python เวอร์ชัน 3.11

9. ตั้งค่าสภาพแวดล้อมเสมือนสําหรับโฟลเดอร์ โดยการเลือก ใช่

10. เปิด function_app.py เพื่อเพิ่มฟังก์ชันมากกว่าหนึ่งรายการ

    

เขียนฟังก์ชันแรกของคุณ

เขียนรายการฟังก์ชันข้อมูลผู้ใช้ด้วยมัมพอร์เตอร์ @udf.function() เพื่อกําหนดจุดเริ่มต้นของฟังก์ชัน คุณสามารถส่งผ่านการป้อนข้อมูลสําหรับฟังก์ชัน เช่น ชนิดข้อมูลดั้งเดิม เช่น str, int, float และอื่น ๆ ภายในฟังก์ชัน คุณสามารถเขียนตรรกะทางธุรกิจแบบกําหนดเองของคุณได้

นี่คือตัวอย่างของฟังก์ชัน hello_fabric

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!" 

จัดการฟังก์ชันข้อมูลผู้ใช้ใน VS Code

คุณสามารถดูรายการฟังก์ชันข้อมูลผู้ใช้ใน Fabric explorer ใน VS Code ภายในพื้นที่ทํางานที่เปิดอยู่ในปัจจุบัน

ฟังก์ชันทั้งหมดในพื้นที่ทํางาน Fabric สามารถเปิดได้ใน Explorer ใน VS Code เพื่อเริ่มการแก้ไข เลือกฟังก์ชันที่คุณต้องการเปิด จากนั้นเลือก เปิดใน Explorer คุณสามารถดูการเชื่อมต่อ ไลบรารี และฟังก์ชันทั้งหมดที่เขียนภายในรายการฟังก์ชันข้อมูลผู้ใช้ได้

จัดการการเชื่อมต่อและไลบรารี

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

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

• ฟังก์ชัน : คุณสามารถดูฟังก์ชันที่เผยแพร่ทั้งหมดได้ที่นี่ เลือกฟังก์ชันและดําเนินการเหล่านี้:

  • เรียกใช้และทดสอบ เพื่อทดสอบฟังก์ชันใน VS Code โดยไม่ต้องใช้เครื่องมือทดสอบ API
  • คัดลอก URL สาธารณะ ถ้าฟังก์ชันนี้ถูกเรียกแบบสาธารณะจากแอปพลิเคชันภายนอก

โฟลเดอร์ภายในเครื่องเพื่อจัดการฟังก์ชันข้อมูลผู้ใช้ของคุณ

รายการฟังก์ชันข้อมูลผู้ใช้ที่เปิดใน VS Code explorer สามารถมองเห็นได้ในมุมมองโฟลเดอร์ภายในเครื่อง โฟลเดอร์ภายในเครื่องช่วยให้คุณสามารถทดสอบและดูการเปลี่ยนแปลงภายในเครื่องที่ทํากับรายการฟังก์ชันข้อมูลผู้ใช้

• ฟังก์ชัน: คุณสามารถดูฟังก์ชันทั้งหมดที่อยู่ในไฟล์ function_app.py ภายในเครื่องของคุณได้ เริ่มต้นด้วยตัวอย่าง คลิกขวาบน ฟังก์ชัน และเลือก เพิ่ม ฟังก์ชัน เพื่อเพิ่มฟังก์ชันตัวอย่าง

  

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

• ดูการเชื่อมต่อและไลบรารีสําหรับฟังก์ชันภายในเครื่อง : คุณสามารถดูการเชื่อมต่อทั้งหมดที่มีอยู่ใน local.settings.json และไลบรารีในไฟล์ requirements.txt บนสภาพแวดล้อมภายในเครื่องของคุณได้

  • ซิงค์การเชื่อมต่อจาก local.settings แสดงรายการปัจจุบันของการเชื่อมต่อบนสภาพแวดล้อมภายในเครื่องของคุณ
  • ซิงค์ requirements.txt เพื่อแสดงรายการปัจจุบันของไลบรารีบนสภาพแวดล้อมภายในเครื่องของคุณ

เผยแพร่ฟังก์ชันข้อมูลผู้ใช้

เมื่อคุณทดสอบการเปลี่ยนแปลงของคุณ ให้เผยแพร่ฟังก์ชันข้อมูลผู้ใช้ไปยัง Fabric อาจใช้เวลาสักครู่ในการเผยแพร่การเปลี่ยนแปลง

การดีบักเฉพาะที่ด้วยจุดสั่งหยุด

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

ขั้นตอนถัดไป

• เรียนรู้เกี่ยวกับฟังก์ชันข้อมูลผู้ใช้แบบจําลองการเขียนโปรแกรม
• บทช่วยสอน : เรียกใช้ฟังก์ชันข้อมูลผู้ใช้จากแอปพลิเคชัน Python