Fabric คลังข้อมูล เซิร์ฟเวอร์ MCP (พรีวิว)

นําไปใช้กับ:✅ จุดสิ้นสุดการวิเคราะห์ SQL และ Warehouse ใน Microsoft Fabric

เซิร์ฟเวอร์ MCP Fabric คลังข้อมูล ระยะไกลเป็นปลายทาง MCP ที่โฮสต์ซึ่งช่วยให้ตัวแทน AI สามารถทํางานกับคลังสินค้าโดยใช้ภาษาธรรมชาติได้ สร้างขึ้นบน Model Context Protocol (MCP) ช่วยให้ตัวแทนมีวิธีควบคุมในการเรียกใช้คําสั่ง T-SQL ผ่านexecuteSQLเครื่องมือ ตรวจสอบผลลัพธ์ และทําซ้ํากับบริบทของคลังสินค้าจริง โดยเคารพสิทธิ์ของ Fabric และขอบเขตความปลอดภัย

บทความนี้แสดงให้คุณรู้จักวิธี:

• เชื่อมต่อกับเซิร์ฟเวอร์ Fabric คลังข้อมูล MCP ระยะไกลใน Visual Studio Code

• กําหนดค่าตําแหน่งข้อมูลส่วนกลางหรือจุดสิ้นสุดที่มีขอบเขตรายการ

• ใช้ GitHub Copilot เพื่อสร้างและเรียกใช้ T-SQL กับ Fabric คลังข้อมูล

• ตรวจสอบการเชื่อมต่อด้วยแบบสอบถามทดสอบ

Prerequisites

ก่อนที่คุณจะเริ่มต้น ให้แน่ใจว่าคุณมี:

• Visual Studio Code: ติดตั้ง Visual Studio Code เวอร์ชันล่าสุด

  • ดาวน์โหลด Visual Studio Code

• GitHub Copilot: ติดตั้งและลงชื่อเข้าใช้ GitHub Copilot และ GitHub Copilot Chat ใน Visual Studio Code

  • ส่วนขยาย GitHub Copilot
  • ส่วนขยาย GitHub Copilot Chat

• การเข้าถึง Fabric คลังข้อมูล: คุณต้องเข้าถึงตําแหน่งข้อมูลการวิเคราะห์ Fabric คลังข้อมูล หรือการวิเคราะห์ SQL อย่างน้อยหนึ่งรายการ

• สิทธิ์คลังสินค้า: คุณต้องมีสิทธิ์พื้นที่ทํางาน Fabric และ SQL ที่จําเป็นเพื่อเรียกใช้คําสั่ง T-SQL ที่คุณขอให้ตัวแทนดําเนินการ

• บริบทคลังสินค้า: มีรหัสพื้นที่ทํางานและรหัสสินค้าคลังสินค้าพร้อมใช้งานหากคุณวางแผนที่จะใช้จุดสิ้นสุดที่มีขอบเขตสินค้า

เลือกปลายทาง

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

ปลายทางส่วนกลาง

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

https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint

ปลายทางที่กําหนดขอบเขตรายการ

ใช้ปลายทางที่มีขอบเขตรายการเมื่อต้องการให้การเชื่อมต่อเซิร์ฟเวอร์ MCP ผูกกับรายการ Fabric คลังข้อมูล ที่เฉพาะเจาะจง

https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/<workspace-id>/items/<item-id>/sqlEndpoint

แทน:

• <workspace-id>ด้วยรหัสพื้นที่ทํางาน Fabric

• <item-id>ด้วยรหัสสินค้า Fabric คลังข้อมูล

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

ตั้งค่าใน Visual Studio Code

กําหนดค่าเซิร์ฟเวอร์ Fabric คลังข้อมูล MCP ใน Visual Studio Code โดยเพิ่มการกําหนดค่าเซิร์ฟเวอร์ลงในไฟล์การตั้งค่า MCP ของคุณ เลือกระหว่างจุดสิ้นสุดส่วนกลางสําหรับการเลือกคลังสินค้าที่ยืดหยุ่น หรือจุดสิ้นสุดที่มีขอบเขตสินค้าเพื่อผูกการเชื่อมต่อกับคลังสินค้าเฉพาะ

ตัวเลือกที่ 1: กําหนดค่าตําแหน่งข้อมูลส่วนกลาง

เพิ่มการกําหนดค่าเซิร์ฟเวอร์ต่อไปนี้ไปยังไฟล์การกําหนดค่า Visual Studio Code MCP ของคุณ:

{
   "servers": {
      "fabric-dw-global": {
         "type": "http",
         "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint"
      }
   }
}

หลังจากบันทึกการกําหนดค่าแล้ว ให้รีสตาร์ทหรือรีเฟรชเซิร์ฟเวอร์ MCP ใน Visual Studio Code

ตัวเลือกที่ 2: กําหนดค่าปลายทางที่มีขอบเขตสินค้า

เพิ่มการกําหนดค่าเซิร์ฟเวอร์ต่อไปนี้ไปยังไฟล์การกําหนดค่า Visual Studio Code MCP ของคุณ:

{
   "servers": {
      "fabric-dw-item": {
         "type": "http",
         "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/<workspace-id>/items/<item-id>/sqlEndpoint"
      }
   }
}

แทนที่ และ <workspace-id> ด้วย <item-id> ค่า สําหรับคลังสินค้าของคุณ

หลังจากบันทึกการกําหนดค่าแล้ว ให้รีสตาร์ทหรือรีเฟรชเซิร์ฟเวอร์ MCP ใน Visual Studio Code

ทดสอบการเชื่อมต่อของคุณ

หลังจากที่คุณกําหนดค่าการเชื่อมต่อแล้ว ให้ตรวจสอบว่าการตั้งค่าทํางาน

1. เริ่มเซิร์ฟเวอร์ MCP ใน Visual Studio Code

   • เปิดแผงเซิร์ฟเวอร์ MCP

   • ยืนยันว่าเซิร์ฟเวอร์ Fabric คลังข้อมูล MCP แสดงว่าเชื่อมต่อแล้ว

2. เปิด GitHub Copilot Chat

   • เปิด Copilot Chat ใน Visual Studio Code

   • เปิดใช้งานโหมดตัวแทน

3. ระบุบริบทของคลังสินค้าหากคุณกําลังใช้จุดสิ้นสุดส่วนกลาง

   • หากคุณกําหนดค่าตําแหน่งข้อมูลส่วนกลาง ให้บอก Copilot ว่าจะใช้คลังสินค้าใดกับข้อความแจ้งเช่น:

     Use the Fabric Data Warehouse named SalesDW in the Sales Analytics workspace.
     

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

4. ถามคําถาม

   • ให้ใส่คำหรือวลีที่คุณกำลังค้นหาไว้ในเครื่องหมายคำพูด

   What tables and views are in this warehouse?
   

   • ให้ใส่คำหรือวลีที่คุณกำลังค้นหาไว้ในเครื่องหมายคำพูด

   Show me the top 10 products by sales revenue.
   

5. อนุญาตการใช้เครื่องมือ

   • เมื่อได้รับแจ้ง ให้ตรวจสอบและอนุมัติการ executeSQL เรียกใช้เครื่องมือ

   • รับรองความถูกต้องด้วยข้อมูลประจําตัวของ Microsoft หากมีการร้องขอ

6. ตรวจสอบคําตอบ

   • Copilot ใช้เซิร์ฟเวอร์ Fabric คลังข้อมูล MCP เพื่อรันคําสั่ง T-SQL ที่ได้รับอนุมัติ และส่งกลับผลลัพธ์ในการแชท

เครื่องมือที่พร้อมใช้งาน

เซิร์ฟเวอร์ Fabric คลังข้อมูล MCP แสดงเครื่องมือเดียว

เครื่องมือ	คำอธิบาย
executeSQL	ดําเนินการคําสั่ง T-SQL ที่ได้รับอนุมัติกับ Fabric คลังข้อมูล และส่งคืนผลลัพธ์

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

ตัวอย่างเช่น แทนที่จะเรียกใช้เครื่องมือค้นหาตารางแยกต่างหาก เอเจนต์สามารถใช้ executeSQL กับการสืบค้นหรือ INFORMATION_SCHEMA.TABLES มุมมองระบบอื่นๆ ที่รองรับ

ตรวจสอบความถูกต้องด้วยตัวอย่างพร้อมท์

ใช้พร้อมท์เหล่านี้เพื่อยืนยันว่าเซิร์ฟเวอร์สามารถสร้าง T-SQL เรียกใช้ T-SQL และอธิบายผลลัพธ์ได้

สํารวจออบเจ็กต์คลังสินค้า

• แสดงรายการ Schema ทั้งหมดในคลังสินค้านี้

• แสดงรายการตารางและมุมมองทั้งหมดที่จัดกลุ่มตาม Schema

• แสดงคอลัมน์ ชนิดข้อมูล และความสามารถในการเป็น Null สําหรับ dbo.Customers ตาราง

สร้างและเรียกใช้ T-SQL

• เขียนและเรียกใช้คิวรี T-SQL ที่ส่งคืนผลิตภัณฑ์ 10 อันดับแรกตามรายได้

• เรียกใช้แบบสอบถามที่นับแถวตามสถานะใบสั่งใน Orders ตาราง

• สร้างแบบสอบถามที่รวม Orders, Customers, และ ProductsRegions เพื่อแสดงรายได้ตามภูมิภาค

ทําความเข้าใจและปรับปรุงการสืบค้น

• อธิบายว่าคิวรี T-SQL นี้ทําอะไรก่อนเรียกใช้

• เขียนแบบสอบถามนี้ใหม่เพื่อให้อ่านได้ง่ายขึ้นโดยไม่ต้องเปลี่ยนผลลัพธ์

• แนะนําการปรับปรุงรูปแบบการสืบค้นนี้ แล้วแสดง T-SQL ที่แก้ไขแล้ว

ตรวจสอบกิจกรรมคลังสินค้า

• แสดงกิจกรรมการสอบถามล่าสุดสําหรับคลังสินค้านี้

• ค้นหาคําค้นหาหรือเซสชันที่ทํางานเป็นเวลานานซึ่งอาจต้องให้ความสนใจ

• สรุปความล้มเหลวของคิวรีล่าสุดและจัดกลุ่มตามสาเหตุที่แท้จริงที่น่าจะเป็นไปได้

Note

คิวรีการตรวจสอบที่แน่นอนขึ้นอยู่กับมุมมองระบบที่พร้อมใช้งานในสภาพแวดล้อมคลังสินค้า

ความปลอดภัยและสิทธิ์

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

การเรียกใช้เครื่องมือที่ executeSQL ควรต้องได้รับการอนุมัติจากผู้ใช้อย่างชัดเจนในไคลเอ็นต์ MCP ตรวจสอบ T-SQL ที่สร้างขึ้นก่อนที่จะอนุญาตให้executeSQLเรียกใช้ โดยเฉพาะอย่างยิ่งสําหรับการดําเนินการเขียน เช่น CREATE, ALTER, , DROPINSERT, UPDATE, หรือ DELETE.

ใช้สิทธิ์การเข้าถึงที่มีสิทธิ์น้อยที่สุดสําหรับคลังสินค้าการผลิต

เริ่มต้นด้วยการสืบค้นแบบอ่านอย่างเดียวและการสํารวจข้อมูลเมตาก่อนที่จะเปิดใช้งานเวิร์กโฟลว์ที่ปรับเปลี่ยนออบเจ็กต์คลังสินค้า

แก้ไขปัญหา

หากคุณมีปัญหาในการตั้งค่าหรือใช้เซิร์ฟเวอร์ Fabric คลังข้อมูล MCP ให้ใช้สถานการณ์ต่อไปนี้เพื่อแก้ไขปัญหาทั่วไป

เซิร์ฟเวอร์ MCP ไม่แสดงว่าเชื่อมต่อแล้ว

ยืนยันว่ามีการบันทึกการกําหนดค่า MCP อย่างถูกต้อง URL ปลายทางถูกต้อง และคุณรีสตาร์ทหรือรีเฟรชเซิร์ฟเวอร์ MCP ใน Visual Studio Code หลังจากทําการเปลี่ยนแปลง

Copilot ไม่พบคลังสินค้า

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

การรับรองความถูกต้องล้มเหลว

ลงชื่อเข้าใช้อีกครั้งด้วยบัญชี บัญชี Microsoft ของคุณ ตรวจสอบให้แน่ใจว่าคุณใช้ผู้เช่าและไดเรกทอรีที่ถูกต้อง

การเรียกใช้เครื่องมือล้มเหลวโดยมีข้อผิดพลาดในการอนุญาต

ยืนยันว่าคุณมีบทบาทพื้นที่ทํางาน Fabric สิทธิ์ของรายการ และสิทธิ์ SQL ที่จําเป็น เซิร์ฟเวอร์ไม่เลี่ยงการรักษาความปลอดภัยของ Fabric

ตัวแทนไม่สามารถแสดงรายการ Schema หรือตารางได้

เซิร์ฟเวอร์เปิดเผย executeSQLเฉพาะ . ขอให้ตัวแทนใช้คิวรีเมตาดาต้า SQL แทนที่จะคาดหวังเครื่องมือค้นหาสคีมาแยกต่างหาก

ให้ใส่คำหรือวลีที่คุณกำลังค้นหาไว้ในเครื่องหมายคำพูด

Use executeSQL with INFORMATION_SCHEMA views to list the tables in this warehouse.

ผลลัพธ์แบบสอบถามไม่คาดคิด

ถาม Copilot แสดง T-SQL ที่สร้างขึ้นก่อนดําเนินการ ตรวจสอบชื่อตาราง การรวม ตัวกรอง ตรรกะวันที่ และตรรกะการรวมก่อนอนุมัติการเรียกใช้เครื่องมือ

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

• เซิร์ฟเวอร์ MCP ใน Visual Studio Code