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

หมายเหตุ

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

เจ้าของแหล่งข้อมูลที่พัฒนาตัวเชื่อมต่อแบบกําหนดเองสําหรับแหล่งข้อมูลของพวกเขาอาจต้องการแจกจ่ายตัวเชื่อมต่อแบบกําหนดเองของพวกเขาไปยังผู้ใช้ 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 ไม่มีค่าเกณฑ์ของการมีส่วนร่วม อย่างไรก็ตามการมีส่วนร่วมมากขึ้นความต้องการหลักฐานสําหรับตัวเชื่อมต่อที่แข็งแกร่งยิ่งขึ้น

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

กระบวนการและไทม์ไลน์

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

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

  • ตัวอย่างเช่น สําหรับการเผยแพร่ Power BI Desktop เดือนเมษายน เส้นตายจะเป็นวันที่ 15 กุมภาพันธ์

• การส่ง: การส่งไฟล์ตัวเชื่อมต่อสําหรับการตรวจสอบของ Microsoft การส่งนี้จะต้องเกิดขึ้นก่อนเดือนแรกก่อนการเผยแพร่ Power BI Desktop เป้าหมาย

  • ตัวอย่างเช่น สําหรับการเผยแพร่ Power BI Desktop เดือนเมษายน วันครบกําหนดจะเป็นวันที่ 1 มีนาคม

• การตรวจทานทางเทคนิค: การเสร็จสิ้นของไฟล์ตัวเชื่อมต่อ ผ่านการตรวจสอบและการรับรองของ Microsoft การตรวจสอบนี้จะต้องเกิดขึ้นภายในวันที่ 15 ของเดือนก่อนการเผยแพร่ Power BI Desktop ที่กําหนดเป้าหมาย

  • ตัวอย่างเช่น สําหรับการเผยแพร่ Power BI Desktop เดือนเมษายน เส้นตายจะเป็นวันที่ 15 มีนาคม

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

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

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

ไฟล์การส่ง (วัตถุ)

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

• ไฟล์ตัวเชื่อมต่อ (.mez)

  • ไฟล์ .mez ควรเป็นไปตามมาตรฐานลักษณะและตั้งชื่อคล้ายกับชื่อผลิตภัณฑ์หรือบริการ ซึ่งไม่ควรมีคําเช่น "Fabric", "Power BI", "Connector" หรือ "API"
  • ตั้งชื่อไฟล์ .mez: ProductName.mez

• ไฟล์ Power BI Desktop (.pbix) สําหรับการทดสอบ

  • เราต้องการรายงาน Power BI ตัวอย่าง (.pbix) เพื่อทดสอบตัวเชื่อมต่อของคุณ
  • รายงานควรมีคิวรีอย่างน้อยหนึ่งคิวรีเพื่อทดสอบแต่ละรายการในตารางการนําทางของคุณ
  • ถ้าไม่มีสคีมาที่ตั้งค่า (ตัวอย่างเช่น ฐานข้อมูล) รายงานจําเป็นต้องรวมคิวรีสําหรับแต่ละ "ชนิด" ของตารางที่ตัวเชื่อมต่ออาจจัดการ

• ทดสอบบัญชีกับแหล่งข้อมูลของคุณ

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

• คําแนะนําในการทดสอบ

  • ระบุเอกสารประกอบเกี่ยวกับวิธีการใช้ตัวเชื่อมต่อและทดสอบฟังก์ชันการทํางานของตัวเชื่อมต่อ

• ลิงก์ไปยังการขึ้นต่อกันภายนอก (ตัวอย่างเช่น โปรแกรมควบคุม ODBC)

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

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

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

  • ใช้รูปแบบเอกสารของส่วน
  • ประกอบด้วยส่วนหัว/เครื่องประดับเวอร์ชันเหนือเอกสารส่วน
  • มี เมตาดาต้าในเอกสารฟังก์ชัน
  • มี ตัวจัดการ 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ไม่ควรเป็นแบบไดนามิก (ซึ่งเรียกใช้จากการเรียกเว็บ)

กําลังลงทะเบียนเพื่อการรับรอง

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

ตรวจสอบให้แน่ใจว่าตัวเชื่อมต่อของคุณเป็นรหัสที่สมบูรณ์และได้รับการทดสอบทั้งในการเขียนใน Power BI Desktop และการรีเฟรชและปริมาณการใช้ในบริการของ Power BI ตรวจสอบให้แน่ใจว่าคุณได้ทดสอบการรีเฟรชแบบครบวงจรในบริการ Power BI โดยใช้เกตเวย์ข้อมูลภายในองค์กร

หากต้องการเริ่มต้นใช้งาน ให้กรอกแบบฟอร์มการลงทะเบียนของเราและผู้ติดต่อของ Microsoft จะติดต่อเพื่อเริ่มต้นกระบวนการ

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

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

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