Power Queryใบรับรองตัวเชื่อมต่อ

บทนำ

การรับรองPower Queryตัวเชื่อมต่อแบบเองจะตัวเชื่อมต่อพร้อมใช้งานแบบสาธารณะ แบบนอกกล่อง Power BI Desktopเชื่อมต่อ ตัวเชื่อมต่อที่ได้รับการรับรอง PowerBI.com ในทุกเวอร์ชันและเวอร์ชันPremium Power BI ยกเว้นกระแสข้อมูล ใบรับรองถูกควบคุมโดยโปรแกรมการรับรองตัวเชื่อมต่อของ Microsoft ซึ่ง Microsoft ร่วมกับนักพัฒนาคู่ค้าเพื่อขยายความสามารถในการเชื่อมต่อข้อมูลของ Power BI

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

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

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

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

• Distributed โดย Microsoft

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

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

ตัวเชื่อมต่อที่ได้รับการรับรองด้วย TestConnection การใช้งานยังรองรับการรีเฟรชแบบ end-to-end ผ่านระบบคลาวด์ (บริการ Power BI) โดยไม่ต้องการเกตเวย์ข้อมูลภายในองค์กร สภาพแวดล้อมบริการของ Power BIโฮสต์ "เกตเวย์ระบบคลาวด์" ที่เรียกใช้คล้ายกับเกตเวย์ภายในองค์กรเป็นหลัก หลังจากการรับรอง เราจะปรับใช้ตัวเชื่อมต่อของคุณไปยังสภาพแวดล้อมนี้เพื่อให้พร้อมใช้งานกับลูกค้า Power BI ทั้งหมด มีข้อความต้องการของตัวเชื่อมต่อเพิ่มเติมที่ต้องใช้คอมโพเนนต์เพิ่มเติม เช่น โปรแกรมควบคุมตาม ODBC ตรวจสอบให้แน่ใจว่า ติดต่อ Microsoft ของคุณถ้าตัวเชื่อมต่อของคุณต้องใช้คอมโพเนนต์เพิ่มเติม

การรักษาความปลอดภัยตัวเชื่อมต่อแบบเองและการลงนาม

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

จากมุมมองของนักพัฒนา นักพัฒนาต้องลงนาม ในตัวเชื่อมต่อแบบ ปรับแต่งเองของพวกเขาด้วยตนเองและให้ผู้ใช้ของพวกเขามีข้อมูล (รหัสพรอมต์) เพื่อโหลดตัวเชื่อมต่ออย่างปลอดภัย

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

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

สิ่งที่จำเป็นต้องมี

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

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

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

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

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

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

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

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

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

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

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

  • ตัวอย่างเช่น วันที่ 15 กุมภาพันธ์ Power BI Desktopสิ้นสุดจะเป็นวันที่ 15 กุมภาพันธ์

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

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

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

  • ตัวอย่างเช่น วันที่ 15 มีนาคม Power BI Desktopกําหนดวันสิ้นสุดจะเป็นวันที่ 15 มีนาคม

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

ข้อขอการรับรอง

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

ไฟล์ที่ส่ง (วัตถุ)

โปรดตรวจสอบให้แน่ใจว่าไฟล์ตัวเชื่อมต่อที่คุณส่งรวมสิ่งต่อไปนี้ทั้งหมด:

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

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

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

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

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

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

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

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

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

คุณลักษณะและสไตล์

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

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

  • ใช้ รูปแบบเอกสารส่วน
  • ให้ การประดับเวอร์ชัน ในส่วน
  • มีเมตาดาต้าเอกสารฟังก์ชัน
  • มีตัวจัดการ TestConnection
  • ปฏิบัติตามแบบแผนการตั้งชื่อ (ตัวอย่างเช่น DataSourceKind.FunctionName ) ซึ่งไม่ควรมีข้อความเช่น "Power BI", "Connector" หรือ "API"

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

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

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

ความปลอดภัย

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

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

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

• ถ้ามีการใช้ฟังก์ชัน Diagnostics.*

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

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

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

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

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

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

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

แอปเทมเพลต (แนะนา)

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