แปลงข้อมูลโดยการเรียกใช้สมุดบันทึก

ใช้กิจกรรมสมุดบันทึกเพื่อเรียกใช้ notebooks ที่คุณสร้างใน Microsoft Fabric โดยเป็นส่วนหนึ่งของไปป์ไลน์ Data Factory ของคุณ สมุดบันทึก ช่วยให้คุณเรียกใช้งาน Apache Spark เพื่อนําเข้า ล้าง หรือแปลงข้อมูลของคุณเป็นส่วนหนึ่งของเวิร์กโฟลว์ข้อมูลของคุณ การเพิ่มกิจกรรมโน้ตบุ๊กลงในไปป์ไลน์ของคุณใน Fabric เป็นเรื่องง่าย และคู่มือนี้จะแนะนําคุณในแต่ละขั้นตอน

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

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

• คุณต้องมีสิทธิ์เข้าถึงผู้เช่า Microsoft Fabric ที่มีการเตรียมใช้งาน capacity คุณสามารถทดลองใช้ Fabric ด้วยการทดลองใช้ฟรี
• Fabric workspace ที่กําหนดให้กับความจุนั้น

• สมุดบันทึกจะถูกสร้างขึ้นในพื้นที่ทํางานของคุณ หากต้องการสร้างสมุดบันทึกใหม่ ให้อ้างอิงกับ วิธีสร้างสมุดบันทึก Microsoft Fabric

สร้างกิจกรรมสมุดบันทึก

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

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

   

3. เลือกกิจกรรมสมุดบันทึกใหม่บนพื้นที่ทํางานถ้ายังไม่ได้เลือกไว้

   

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

กําหนดค่าการตั้งค่าสมุดบันทึก

เลือกแท็บ การตั้งค่า

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

เลือกสมุดบันทึกที่มีอยู่จากดรอปดาวน์ สมุด บันทึก และเลือกระบุพารามิเตอร์ใดๆ ที่จะส่งผ่านไปยังสมุดบันทึก

การใช้ Fabric Workspace Identity (WI) ในกิจกรรมสมุดบันทึก

1. สร้างข้อมูลประจําตัวของพื้นที่ทํางาน

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

   ดูเอกสารเกี่ยวกับ Workspace Identity

2. เปิดใช้งานการตั้งค่าระดับผู้เช่า

   เปิดใช้งานการตั้งค่าผู้เช่าต่อไปนี้ (ถูกปิดใช้งานโดยค่าเริ่มต้น): บริการหลักสามารถเรียกใช้ API สาธารณะ Fabric

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

3. ให้สิทธิ์พื้นที่ทํางานแก่ข้อมูลประจําตัวของพื้นที่ทํางาน

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

   ดูเอกสารเกี่ยวกับการให้สิทธิ์เข้าถึงพื้นที่ทํางานแก่ผู้ใช้

เติมพารามิเตอร์พื้นฐานโดยอัตโนมัติสําหรับกิจกรรมโน้ตบุ๊ก

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

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

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

วิธีการทำงาน

เมื่อคุณเลือกสมุดบันทึกในกิจกรรมสมุดบันทึก:

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

คุณสามารถตรวจสอบพารามิเตอร์ที่เติมข้อมูลอัตโนมัติและแทนที่ค่าพารามิเตอร์ (ไม่บังคับ)

ลักษณะการทํางานหลัก

• พารามิเตอร์จะเติมข้อมูลโดยอัตโนมัติเมื่อคุณเลือกสมุดบันทึก
• การเปลี่ยนสมุดบันทึกจะรีเฟรชรายการพารามิเตอร์
• ไม่มีเซลล์พารามิเตอร์→ไม่มีพารามิเตอร์ที่เติม

แท็กเซสชันการตั้งค่า

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

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

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

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

ปัญหาที่ทราบกันดี

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

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

• วิธีการตรวจสอบการเรียกใช้ไปป์ไลน์