TripPin ตอนที่ 9 - TestConnection

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

ในบทเรียนนี้ คุณ:

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

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

1. เพิ่มตัวจัดการ TestConnection ไปยังตัวเชื่อมต่อของคุณ
2. ติดตั้งเกตเวย์ข้อมูลภายในองค์กรในโหมดส่วนบุคคล
3. เปิดใช้งานการสนับสนุนตัวเชื่อมต่อแบบกําหนดเองในเกตเวย์
4. เผยแพร่เวิร์กบุ๊กที่ใช้ตัวเชื่อมต่อของคุณเพื่อ PowerBI.com
5. กําหนดค่าการรีเฟรชตามกําหนดการเพื่อทดสอบตัวเชื่อมต่อของคุณ

ไปที่ การจัดการการสนับสนุนเกตเวย์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวจัดการ TestConnection

พื้นหลัง

มีข้อกําหนดเบื้องต้นสามประการสําหรับการกําหนดค่าแหล่งข้อมูลสําหรับการรีเฟรชตามกําหนดการโดยใช้ PowerBI.com:

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

สองรายการแรกจะได้รับการจัดการโดยการลงทะเบียนตัวเชื่อมต่อของคุณกับเกตเวย์ เมื่อผู้ใช้พยายามกําหนดค่าการรีเฟรชตามกําหนดการใน PowerBI.com ข้อมูลคิวรีจะถูกส่งไปยังเกตเวย์ส่วนบุคคลของคุณเพื่อตรวจสอบว่าแหล่งข้อมูลใด ๆ ในบริการของ Power BI ไม่รู้จัก (นั่นคือ แหล่งข้อมูลแบบกําหนดเองที่คุณสร้างขึ้น) ที่นั่นหรือไม่ รายการที่สามได้รับการจัดการโดยการเรียกใช้ตัวจัดการ TestConnection ที่กําหนดไว้สําหรับแหล่งข้อมูลของคุณ

การเพิ่มตัวจัดการ TestConnection

ตัวจัดการ TestConnection จะถูกเพิ่มลงในเรกคอร์ดการประกาศชนิดแหล่งข้อมูล (ตําแหน่งเดียวกับที่คุณประกาศชนิดการรับรองความถูกต้องที่รองรับ) ตัวจัดการเป็น a function ที่มีพารามิเตอร์เดียวของประเภท anyซึ่งส่งคืนlist ค่าแรกในรายการคือฟังก์ชันที่เรียกเพื่อทดสอบการเชื่อมต่อจริง โดยทั่วไปฟังก์ชันนี้จะเหมือนกับฟังก์ชันแหล่งข้อมูลหลักของคุณ ในบางกรณี คุณอาจต้องเปิดเผยฟังก์ชันแยกต่างหาก shared เพื่อให้การทดสอบการเชื่อมต่อที่มีประสิทธิภาพ

เนื่องจากฟังก์ชันแหล่งข้อมูล TripPin ไม่มีอาร์กิวเมนต์ที่จําเป็น การใช้งาน TestConnection จึงค่อนข้างง่าย:

// Data Source Kind description
TripPin = [
    // TestConnection is required to enable the connector through the Gateway
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin Part 9 - TestConnection"
];

การเปิดใช้งานตัวเชื่อมต่อแบบกําหนดเองในเกตเวย์ส่วนบุคคล

ดาวน์โหลดและติดตั้งเกตเวย์ข้อมูลภายในองค์กร เมื่อคุณเรียกใช้ตัวติดตั้ง ให้เลือกโหมดส่วนบุคคล

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

1. เลือกแท็บ ตัวเชื่อมต่อ

2. เลือกสวิตช์เพื่อเปิดใช้งานการสนับสนุนสําหรับตัวเชื่อมต่อข้อมูลแบบกําหนดเอง

3. เลือกไดเรกทอรีที่คุณต้องการโหลดตัวเชื่อมต่อแบบกําหนดเอง การเลือกนี้มักจะเป็นไดเรกทอรีเดียวกับที่คุณใช้สําหรับ Power BI Desktop แต่ค่าสามารถกําหนดค่าได้

4. ตอนนี้หน้าควรแสดงรายการไฟล์นามสกุลทั้งหมดในไดเร็กทอรีเป้าหมายของคุณ

   

ไปที่ เอกสารออนไลน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับเกตเวย์

การทดสอบการรีเฟรชตามกําหนดเวลา

เปิด Power BI Desktop และสร้างรายงานที่นําเข้าข้อมูลโดยใช้ตัวเชื่อมต่อ TripPin

เพิ่มวิชวลอย่างน้อยหนึ่งรายการลงในหน้ารายงานของคุณ (ไม่บังคับ) แล้วเผยแพร่รายงานไปยัง PowerBI.com

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

เลือกลิงก์ แก้ไขข้อมูลประจําตัว เพื่อเปิดกล่องโต้ตอบการรับรองความถูกต้อง แล้วเลือก ลงชื่อเข้าใช้

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

บทสรุป

ขอแสดงความยินดี! ตอนนี้คุณมีตัวเชื่อมต่อแบบกําหนดเองที่พร้อมใช้งานจริงซึ่งรองรับการรีเฟรชอัตโนมัติผ่านบริการของ Power BI

ขั้นตอนถัดไป

TripPin ตอนที่ 10 - การพับแบบสอบถาม