การจัดการการเข้าถึงข้อมูล

ฟังก์ชันแหล่งข้อมูล

ตัวเชื่อมต่อข้อมูลจะห่อและปรับแต่งลักษณะการทํางานของฟังก์ชันแหล่งข้อมูลในไลบรารี M ตัวอย่างเช่น ส่วนขยายสําหรับ REST API จะใช้ฟังก์ชัน Web.Contents เพื่อสร้างคําขอ HTTP ปัจจุบัน มีการเปิดใช้งานชุดฟังก์ชันแหล่งข้อมูลที่จํากัดเพื่อรองรับความสามารถในการขยาย

• เว็บ.สารบัญ
• OData.ฟีด
• Odbc.แหล่งข้อมูล
• AdoDotNet.แหล่งข้อมูล
• OleDb.แหล่งข้อมูล

ตัวอย่าง:

[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;

ประเภทแหล่งข้อมูล

ฟังก์ชันที่ทําเครื่องหมายว่าอยู่ใน shared ส่วนขยายของคุณสามารถเชื่อมโยงกับแหล่งข้อมูลเฉพาะได้โดยการรวม DataSource.Kind แอตทริบิวต์สัญพจน์บนฟังก์ชันที่มีชื่อของเรกคอร์ดข้อกําหนดแหล่งข้อมูล เรกคอร์ดแหล่งข้อมูลจะกําหนดชนิดการรับรองความถูกต้องที่แหล่งข้อมูลของคุณสนับสนุน และข้อมูลการสร้างแบรนด์พื้นฐาน (เช่น ชื่อที่แสดง / ป้ายชื่อ) ชื่อของเรกคอร์ดจะกลายเป็นตัวระบุเฉพาะของเรกคอร์ด

แต่ละฟังก์ชันที่เชื่อมโยงกับแหล่งข้อมูลเดียวกันต้องมีพารามิเตอร์ฟังก์ชันที่จําเป็นเหมือนกัน รวมถึงชื่อ ชนิด และลําดับ (สําหรับวัตถุประสงค์ของชนิดแหล่งข้อมูล พารามิเตอร์จะไม่ถือว่าจําเป็นหากมีการ optional ทําเครื่องหมายหรือหากข้อมูลเมตามีอยู่ DataSource.Path = false)

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

ตัวอย่าง:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

คุณสมบัติ

ตารางต่อไปนี้แสดงรายการฟิลด์สําหรับเรกคอร์ดข้อกําหนดแหล่งข้อมูลของคุณ

เขตข้อมูล	ประเภท	ราย ละเอียด
การรับรองความถูกต้อง	ระเบียน	ระบุการรับรองความถูกต้องอย่างน้อยหนึ่งชนิดที่แหล่งข้อมูลของคุณรองรับ ต้องมีอย่างน้อยหนึ่งชนิด แต่ละชนิดจะแสดงเป็นตัวเลือกในพร้อมท์ข้อมูลประจําตัว Power Query สําหรับข้อมูลเพิ่มเติม โปรดดู ชนิดการรับรองความถูกต้อง
ฉลาก	SMS	(ไม่บังคับ) ชื่อที่แสดงที่ง่ายสําหรับส่วนขยายนี้ในกล่องโต้ตอบข้อมูลประจําตัว
รองรับการเข้ารหัส	มีเหตุผล	(ไม่บังคับ) เมื่อเป็นจริง UI จะแสดงตัวเลือกในการเชื่อมต่อกับแหล่งข้อมูลโดยใช้การเชื่อมต่อที่เข้ารหัส โดยทั่วไปจะใช้สําหรับแหล่งข้อมูลที่มีกลไกสํารองที่ไม่ได้เข้ารหัส (โดยทั่วไปคือแหล่งข้อมูลที่ใช้ ODBC หรือ ADO.NET)

เผยแพร่ไปยัง UI

คล้ายกับเรกคอร์ดข้อกําหนดแหล่งข้อมูล เรกคอร์ดเผยแพร่จะให้ข้อมูลที่จําเป็นต่อ Power Query UI เพื่อแสดงส่วนขยายนี้ในกล่องโต้ตอบ รับข้อมูล

ตัวอย่าง:

HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];

HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

คุณสมบัติ

ตารางต่อไปนี้แสดงรายการเขตข้อมูลสําหรับระเบียนการเผยแพร่ของคุณ

เขตข้อมูล	ประเภท	ราย ละเอียด
ปุ่มข้อความ	รายการ	รายการข้อความ รายการแรกกําหนดชื่อที่แสดงถัดจากไอคอนของแหล่งข้อมูลในกล่องโต้ตอบ รับ ข้อมูล Power BI รายการที่สอง (ไม่บังคับ) จะกําหนดคําแนะนําเครื่องมือที่จะแสดงเมื่อวางเมาส์เหนือชื่อก่อนหน้า
หมวดหมู่	SMS	ตําแหน่งที่ส่วนขยายควรแสดงในกล่องโต้ตอบรับข้อมูล ปัจจุบันค่าหมวดหมู่เดียวที่มีการส่งมอบพิเศษคือ Azure และ Database. ค่าอื่นๆ ทั้งหมดจะอยู่ภายใต้ประเภทอื่นๆ
Beta	มีเหตุผล	(ไม่บังคับ) เมื่อตั้งค่าเป็น true UI จะแสดงตัวระบุ Preview/Beta ถัดจากชื่อตัวเชื่อมต่อของคุณ และกล่องโต้ตอบคําเตือนว่าการใช้งานตัวเชื่อมต่ออาจมีการเปลี่ยนแปลงที่เสียหาย
LearnMoreUrl	SMS	(ไม่บังคับ) URL ไปยังเว็บไซต์ที่มีข้อมูลเพิ่มเติมเกี่ยวกับแหล่งข้อมูลหรือตัวเชื่อมต่อนี้
สนับสนุน DirectQuery	มีเหตุผล	(ไม่บังคับ) เปิดใช้งานการสืบค้นโดยตรงสําหรับส่วนขยายของคุณ
ที่มาภาพ	ระเบียน	(ไม่บังคับ) เรกคอร์ดที่มีรายการของภาพไบนารี (ที่มาจากไฟล์นามสกุลโดยใช้เมธอด Extension.Contents ) เรกคอร์ดประกอบด้วยสองฟิลด์ (Icon16, Icon32) แต่ละฟิลด์มีรายการของตัวเอง แต่ละไอคอนควรมีขนาดต่างกัน
แหล่งที่มาประเภทภาพ	ระเบียน	(ไม่บังคับ) คล้ายกับ SourceImage ยกเว้นแบบแผนสําหรับตัวเชื่อมต่อแบบสําเร็จรูปจํานวนมากคือการแสดงไอคอนแผ่นงานที่มีไอคอนเฉพาะแหล่งที่มาที่มุมล่างขวา การมีชุดไอคอนที่แตกต่างกันสําหรับ SourceTypeImage เป็นทางเลือก ส่วนขยายจํานวนมากเพียงแค่นําชุดไอคอนชุดเดียวกันกลับมาใช้ใหม่สําหรับทั้งสองฟิลด์