การจัดการการเข้าถึงข้อมูล
ฟังก์ชันแหล่งข้อมูล
Data เชื่อมต่อ or wraps และกําหนดลักษณะการทํางานของฟังก์ชันแหล่งข้อมูลในไลบรารี M ตัวอย่างเช่น ส่วนขยายสําหรับ REST API จะทําให้ใช้ ฟังก์ชัน Web.Contents เพื่อสร้างคําขอ HTTP ในขณะนี้ มีการเปิดใช้งานชุดฟังก์ชันแหล่งข้อมูลที่จํากัดเพื่อสนับสนุนการขยายความสามารถ
ตัวอย่าง:
[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;
ประเภทของแหล่งข้อมูล
ฟังก์ชันที่DataSource.Kind
ทําเครื่องหมายเป็น shared
ในส่วนขยายของคุณสามารถเชื่อมโยงกับแหล่งข้อมูลเฉพาะได้โดยการรวมแอตทริบิวต์สัญพจน์บนฟังก์ชัน ที่มีชื่อของเรกคอร์ดข้อกําหนดแหล่งข้อมูล
ระเบียนแหล่งข้อมูลกําหนดชนิดการรับรองความถูกต้องที่ได้รับการสนับสนุนโดยแหล่งข้อมูลของคุณ และข้อมูลการสร้างแบรนด์พื้นฐาน (เช่น ชื่อที่แสดง / ป้ายชื่อ)
ชื่อของเรกคอร์ดจะกลายเป็นตัวระบุที่ไม่ซ้ํากัน
แต่ละฟังก์ชันที่เกี่ยวข้องกับแหล่งข้อมูลเดียวกันต้องมีพารามิเตอร์ฟังก์ชันที่จําเป็นเหมือนกัน รวมถึงชื่อ ชนิด และลําดับ (สําหรับวัตถุประสงค์ของชนิดแหล่งข้อมูล ไม่จําเป็นต้องมีการพิจารณาพารามิเตอร์หากมีการทําเครื่องหมาย optional
หรือถ้าเมตาดาต้าประกอบด้วย DataSource.Path = false
)
ฟังก์ชันสําหรับชนิดแหล่งข้อมูลเฉพาะสามารถใช้ข้อมูลประจําตัวที่เชื่อมโยงกับ ชนิด ดังกล่าวเท่านั้น ข้อมูลประจําตัวจะถูกระบุในขณะทํางานโดยดําเนินการค้นหาโดยยึดตามการรวมกันของพารามิเตอร์ที่จําเป็นของฟังก์ชัน สําหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีระบุข้อมูลประจําตัว ให้ดู เส้นทางของแหล่งข้อมูล
ตัวอย่าง:
HelloWorld = [
Authentication = [
Implicit = []
],
Label = Extension.LoadString("DataSourceLabel")
];
คุณสมบัติ
ตารางต่อไปนี้แสดงรายการเขตข้อมูลสําหรับระเบียนข้อกําหนดของแหล่งข้อมูลของคุณ
เขตข้อมูล | ขนิด | คำอธิบาย |
---|---|---|
การรับรองความถูกต้อง | เรก คอร์ด | ระบุการรับรองความถูกต้องอย่างน้อยหนึ่งชนิดที่สนับสนุนโดยแหล่งข้อมูลของคุณ ต้องมีอย่างน้อยหนึ่งชนิด แต่ละชนิดจะแสดงเป็นตัวเลือกในพร้อมท์ข้อมูลประจําตัวของ Power Query สําหรับข้อมูลเพิ่มเติม ดู ชนิดการรับรองความถูกต้อง |
ป้ายชื่อ | ข้อความ | (ไม่บังคับ) ชื่อที่แสดงที่เรียกง่ายสําหรับส่วนขยายนี้ในกล่องโต้ตอบข้อมูลประจําตัว |
SupportsEncryption | แบบ ลอจิ คัล | (ไม่บังคับ) เมื่อเป็นจริง UI จะแสดงตัวเลือกในการเชื่อมต่อกับแหล่งข้อมูลโดยใช้การเชื่อมต่อที่เข้ารหัสลับ โดยทั่วไปจะใช้สําหรับแหล่งข้อมูลที่มีกลไกแสดงแทนที่ไม่มีการเข้ารหัสลับ (โดยทั่วไปคือ ODBC หรือแหล่งข้อมูลตาม ADO.NET) |
เผยแพร่ไปยัง UI
คล้ายกับระเบียนข้อกําหนดแหล่งข้อมูล ระเบียนเผยแพร่มี UI ของ Power Query สําหรับข้อมูลที่จําเป็นต้องใช้เพื่อแสดงส่วนขยายนี้ในกล่องโต้ตอบรับข้อมูล
ตัวอย่าง:
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") }
];
คุณสมบัติ
ตารางต่อไปนี้แสดงรายการเขตข้อมูลสําหรับระเบียนเผยแพร่ของคุณ
เขตข้อมูล | ขนิด | คำอธิบาย |
---|---|---|
ButtonText | รายการ | รายการข้อความ รายการแรกจะกําหนดชื่อที่แสดงถัดจากไอคอนของแหล่งข้อมูลในกล่องโต้ตอบรับข้อมูลของ Power BI รายการที่สอง (ไม่บังคับ) จะกําหนดคําแนะนําเครื่องมือที่จะแสดงขึ้นเมื่อชื่อก่อนหน้าวางเมาส์เหนือ |
หมวดหมู่ | ข้อความ | ในกรณีที่ส่วนขยายควรแสดงในกล่องโต้ตอบรับข้อมูล ในปัจจุบัน ค่าประเภทเดียวที่มีการกําหนดราคาพิเศษคือ Azure และDatabase ค่าอื่น ๆ ทั้งหมดจะลงท้ายด้วยหมวดหมู่ อื่นๆ |
Beta | แบบ ลอจิ คัล | (ไม่บังคับ) เมื่อตั้งค่าเป็น true UI จะแสดงตัวระบุการแสดงตัวอย่าง/รุ่นเบต้าถัดจากชื่อตัวเชื่อมต่อของคุณและกล่องโต้ตอบคําเตือนว่าการใช้งานของตัวเชื่อมต่อจะขึ้นอยู่กับการเปลี่ยนแปลงที่เสียหาย |
LearnMoreUrl | ข้อความ | (ไม่บังคับ) URL ไปยังเว็บไซต์ที่มีข้อมูลเพิ่มเติมเกี่ยวกับแหล่งข้อมูลหรือตัวเชื่อมต่อนี้ |
SupportsDirectQuery | แบบ ลอจิ คัล | (ไม่บังคับ) เปิดใช้งานคิวรีโดยตรงสําหรับส่วนขยายของคุณ |
SourceImage | เรก คอร์ด | (ไม่บังคับ) เรกคอร์ดที่มีรายการของรูปภาพไบนารี (ที่มาจากไฟล์ส่วนขยายโดยใช้ เมธอด Extension.Contents ) ระเบียนมีสองเขตข้อมูล (Icon16, Icon32) แต่ละรายการมีรายการของตนเอง ไอคอนแต่ละอันควรมีขนาดแตกต่างกัน |
SourceTypeImage | เรก คอร์ด | (ไม่บังคับ) คล้ายกับ SourceImage ยกเว้นแบบแผนสําหรับตัวเชื่อมต่อที่ใช้ได้ทันทีคือการแสดงไอคอนแผ่นงานที่มีไอคอนเฉพาะแหล่งที่มาในมุมล่างขวา การมีชุดไอคอนที่แตกต่างกันสําหรับ SourceTypeImage เป็นตัวเลือก — ส่วนขยายจํานวนมากเพียงแค่ใช้ไอคอนชุดเดียวกันสําหรับทั้งสองเขตข้อมูลซ้ํา |