การรับรองตัวเชื่อมต่อ Data Factory

สำคัญ

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

เจ้าของแหล่งข้อมูลที่พัฒนาตัวเชื่อมต่อแบบกําหนดเองสําหรับแหล่งข้อมูลของพวกเขาอาจต้องการแจกจ่ายตัวเชื่อมต่อแบบกําหนดเองของพวกเขาไปยังผู้ใช้ Data Factory อย่างกว้างขวางยิ่งขึ้น เมื่อสร้าง ใช้ และตรวจสอบตัวเชื่อมต่อแบบกําหนดเองโดยผู้ใช้ปลายทาง เจ้าของแหล่งข้อมูลสามารถส่งสําหรับใบรับรองของ Microsoft ได้

การรับรองตัวเชื่อมต่อ Data Factory ทําให้ตัวเชื่อมต่อพร้อมใช้งานแบบสาธารณะพร้อมใช้งานทันที Microsoft Fabric Data Factory และ Microsoft Power BI ในประสบการณ์การใช้งานต่อไปนี้:

• Microsoft Fabric Dataflow Gen2
• Microsoft Power BI Dataflow Gen1
• Microsoft Power BI Datamart
• แบบจําลองความหมายของ Microsoft Power BI (ในบริการของ Power BI)
• Microsoft Power BI Desktop
• เกตเวย์ข้อมูลภายในองค์กรสําหรับ Microsoft Fabric และ Microsoft Power BI

ตัวเชื่อมต่อที่ได้รับการรับรองคือ:

• ดูแลโดยนักพัฒนาคู่ค้า

• ได้รับการสนับสนุนโดยนักพัฒนาคู่ค้า

• ได้รับการรับรองโดย Microsoft

• เผยแพร่โดย Microsoft

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

หมายเหตุ

วันนี้คุณสามารถใช้ประโยชน์จาก Power Query SDK เพื่อสร้างตัวเชื่อมต่อที่สามารถได้รับการรับรองผ่านโปรแกรมการรับรองตัวเชื่อมต่อ Data Factory ได้ ตรงไปยัง ภาพรวม Power Query SDK เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับเครื่องมือนี้

ภาพรวมใบรับรอง

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

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

• ตัวเชื่อมต่อต้องเป็นสําหรับผลิตภัณฑ์สาธารณะ

• ตัวเชื่อมต่อต้องถือว่าเป็นโค้ดที่สมบูรณ์สําหรับเวอร์ชันการเผยแพร่เริ่มต้น โปรแกรมอนุญาตให้มีการเกิดซ้ําและการอัปเดตบ่อยครั้ง Microsoft ไม่มีความช่วยเหลือทางเทคนิคหรือให้คําปรึกษาการพัฒนาตัวเชื่อมต่อแบบกําหนดเอง เราขอแนะนําให้ใช้แหล่งข้อมูลสาธารณะ เช่น ที่เก็บเอกสาร SDK และตัวอย่างของเรา หากคุณต้องการความช่วยเหลือเพิ่มเติม เราสามารถแชร์รายการที่ปรึกษาการพัฒนาตัวเชื่อมต่อแบบกําหนดเองสําหรับอุตสาหกรรมบริษัทอื่นที่รู้จัก ซึ่งคุณอาจต้องการติดต่อโดยตรง แยกต่างหากจากโปรแกรมหรือพันธมิตรของ Microsoft Microsoft ไม่เกี่ยวข้องกับผู้ให้คําปรึกษาเหล่านี้และไม่รับผิดชอบต่อการใช้บริการของพวกเขา Microsoft แสดงรายการเพื่อความสะดวกของคุณและโดยไม่มีการรับประกัน คําแนะนํา หรือการรับประกันใด ๆ หากต้องการเรียนรู้เพิ่มเติม โปรดติดต่อผู้ติดต่อใบรับรอง Microsoft ของคุณ

• นักพัฒนาต้องให้การประเมินสําหรับการใช้งานในปัจจุบันและในอนาคต

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

• ตัวเชื่อมต่อต้องทํางานได้สําเร็จในระดับที่คาดว่าจะมีการใช้งานโดยลูกค้า

• ต้องมีเธรดในฟอรัม Fabric Ideas ที่ขับเคลื่อนโดยลูกค้าเพื่อระบุความต้องการเพื่อให้ตัวเชื่อมต่อพร้อมใช้งานแบบสาธารณะใน Data Factory และ / หรือ Power BI ไม่มีค่าเกณฑ์ของการมีส่วนร่วม อย่างไรก็ตามการมีส่วนร่วมมากขึ้นความต้องการหลักฐานสําหรับตัวเชื่อมต่อที่แข็งแกร่งยิ่งขึ้น

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

ข้อกําหนดการรับรอง

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

คุณสมบัติและรูปแบบ

ตัวเชื่อมต่อต้องเป็นไปตามชุดของคุณลักษณะและกฎสไตล์เพื่อให้เป็นไปตามมาตรฐานความสามารถในการใช้งานที่สอดคล้องกับตัวเชื่อมต่อที่ได้รับการรับรองอื่น ๆ

• ตัวเชื่อมต่อต้อง:

  • ใช้รูปแบบเอกสารของส่วน
  • ประกอบด้วยส่วนหัว/เครื่องประดับเวอร์ชันเหนือเอกสารส่วน
  • มี เมตาดาต้าในเอกสารฟังก์ชัน
  • มี ตัวจัดการ TestConnection
  • ปฏิบัติตามมาตรฐานการตั้งชื่อ (ตัวอย่างเช่น DataSourceKind.FunctionName) ซึ่งไม่ควรมีคําเช่น "Fabric", "Power BI", "Connector" หรือ "API"
  • ส่งกลับข้อมูลในรูปแบบตาราง จัดเป็นตารางที่มีคอลัมน์ เช่นเดียวกับแหล่งข้อมูลเชิงสัมพันธ์ รูปแบบหลายมิติที่ยึดตามคิวบ์ มิติ และหน่วยวัดไม่ได้รับการสนับสนุน
  • ทํางานเหมือนกันในโหมดนําเข้าและ DirectQuery ซึ่งแสดงผลลัพธ์ที่เหมือนกัน
  • ตั้งค่าสถานะเบต้าเป็น True ในการเผยแพร่ครั้งแรก

• FunctionNameควรเหมาะสมสําหรับโดเมน (ตัวอย่างเช่น "เนื้อหา", "ตาราง", "เอกสาร", "ฐานข้อมูล", และอื่น ๆ)

• ตัวเชื่อมต่อควร:

  • มีไอคอน
  • ระบุตารางนําทาง
  • ใส่สตริงใน resources.resx ไฟล์ URL และค่าควรเป็นแบบฮาร์ดโค้ดในรหัสตัวเชื่อมต่อและไม่ได้วางไว้ใน resources.resx ไฟล์

ความปลอดภัย

มีข้อควรพิจารณาด้านความปลอดภัยเฉพาะที่ตัวเชื่อมต่อของคุณต้องจัดการ

• หาก Extension.CurrentCredentials() ใช้:

  • ต้องการการใช้งานหรือไม่? ถ้าเป็นเช่นนั้น ข้อมูลประจําตัวจะถูกส่งไปยังที่ไหน
  • คําขอรับประกันว่าจะดําเนินการผ่าน HTTPS หรือไม่
    • คุณสามารถใช้ฟังก์ชันตัวช่วยเหลือการบังคับใช้ HTTPS ได้
  • ถ้าข้อมูลประจําตัวถูกส่งโดยใช้ Web.Contents() ผ่านทาง GET:
    • สามารถเปลี่ยนเป็นโพสต์ได้หรือไม่?
    • ถ้า GET จําเป็น ตัวเชื่อมต่อต้องใช้ CredentialQueryString ระเบียนใน Web.Contents() เรกคอร์ดตัวเลือกเพื่อส่งผ่านข้อมูลประจําตัวที่ละเอียดอ่อน

• ถ้ามี การใช้ฟังก์ชัน การวินิจฉัย*:

  • ตรวจสอบความถูกต้องของสิ่งที่กําลังมีการติดตาม ข้อมูล ต้องไม่มี PII หรือจํานวนข้อมูลที่ไม่จําเป็นจํานวนมาก
  • หากคุณใช้การติดตามที่สําคัญในการพัฒนา คุณควรใช้ตัวแปรหรือแฟล็กคุณลักษณะที่กําหนดว่าควรเปิดการติดตามหรือไม่ ต้อง ปิด การติดตามนี้ก่อนที่จะส่งใบรับรอง

• หาก Expression.Evaluate() ใช้:

  • ตรวจสอบว่านิพจน์มาจากที่ใดและนิพจน์มาจากที่ใด (นั่นคือ สามารถสร้างการเรียกไปยัง Extension.CurrentCredentials()และอื่น ๆ แบบไดนามิกได้)
  • Expressionไม่ควรเป็นผู้ใช้ที่ระบุหรือรับข้อมูลป้อนเข้าจากผู้ใช้
  • Expressionไม่ควรเป็นแบบไดนามิก (ซึ่งเรียกใช้จากการเรียกเว็บ)

หลังจากการรับรอง

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

• คุณและผู้ใช้ปลายทางควรใช้เวอร์ชันตัวเชื่อมต่อที่ผ่านการรับรองที่รวมอยู่ในสภาพแวดล้อมก่อนการรับรอง (เช่น Power BI Desktop และเกตเวย์ข้อมูล) และลบไฟล์ .mez หรือ .pqx ที่มีอยู่ (ตัวเชื่อมต่อแบบกําหนดเอง) ที่ใช้ก่อนหน้าใบรับรอง ความล้มเหลวในการทําเช่นนั้นอาจส่งผลให้การทดสอบตัวเชื่อมต่อแบบกําหนดเองของคุณถูกใช้โดย Power Query โดยไม่ได้ตั้งใจแทนที่จะเป็นตัวเชื่อมต่อที่ได้รับการรับรองใหม่
• ควรใช้ตัวเชื่อมต่อแบบกําหนดเองเพื่อทดสอบเวอร์ชันใหม่ของตัวเชื่อมต่อเท่านั้น
• เมื่อทํางานกับผู้ใช้ปลายทางและลูกค้า ตรวจสอบให้แน่ใจว่า พวกเขาเข้าใจเวอร์ชันตัวเชื่อมต่อแบบกําหนดเองที่ใช้ในการทดสอบก่อนการรับรองควรถูกลบออกหลังจากการทดสอบเสร็จสมบูรณ์ และพร้อมใช้งานเวอร์ชันตัวเชื่อมต่อที่ได้รับการรับรองใหม่