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

  • บทความ

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

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 เป็นตัวเลือก — ส่วนขยายจํานวนมากเพียงแค่ใช้ไอคอนชุดเดียวกันสําหรับทั้งสองเขตข้อมูลซ้ํา