การจัดการการสนับสนุนเกตเวย์

ทดสอบการเชื่อมต่อ

การสนับสนุนเชื่อมต่อแบบกําหนดเองพร้อมใช้งานทั้งในโหมดส่วนบุคคลและมาตรฐานของเกตเวย์ข้อมูลภายในองค์กร โหมดเกตเวย์ทั้งสองรองรับการนําเข้า สนับสนุน Direct Query ในโหมด มาตรฐาน เท่านั้น OAuth สําหรับตัวเชื่อมต่อแบบกําหนดเองผ่านเกตเวย์ได้รับการรองรับเฉพาะสําหรับผู้ดูแลระบบเกตเวย์เท่านั้น แต่ไม่รองรับแหล่งข้อมูลอื่น ๆ

วิธีสําหรับการใช้ฟังก์ชัน Test เชื่อมต่อ ion มีแนวโน้มที่จะเปลี่ยนแปลงในขณะที่ฟังก์ชันการทํางานของ Power BI Custom Data เชื่อมต่อ or อยู่ในการแสดงตัวอย่าง

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

(dataSourcePath) as list => ...

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

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

ถ้าการเรียกฟังก์ชันส่งผลให้เกิดข้อผิดพลาด Test เชื่อมต่อ ion จะถือว่าล้มเหลว และข้อมูลประจําตัวจะไม่ยังคงอยู่

หมายเหตุ

ตามที่ระบุไว้ข้างต้น ชื่อฟังก์ชันที่กําหนดโดย Test เชื่อมต่อ ion ต้องเป็นสมาชิกshared

ตัวอย่าง: เชื่อมต่อ or ที่ไม่มีอาร์กิวเมนต์ที่จําเป็น

ส่วนย่อยของโค้ดด้านล่างใช้ Test เชื่อมต่อ ion สําหรับแหล่งข้อมูลที่ไม่มีพารามิเตอร์ที่จําเป็น (เช่น ที่พบในบทช่วยสอน TripPin) เชื่อมต่อ ors ที่ไม่มีพารามิเตอร์ที่จําเป็น (เรียกว่า 'Singletons') ไม่จําเป็นต้องใช้ข้อมูลป้อนเข้าใดๆ ที่ให้มาเพื่อทดสอบการเชื่อมต่อ (นอกเหนือจากข้อมูลประจําตัว) ในกรณีนี้ dataSourcePath ค่าจะเท่ากับชื่อของชนิดแหล่งข้อมูล และสามารถละเว้นได้ ฟังก์ชัน TripPin.Contents จะถูกเรียกใช้โดยไม่มีพารามิเตอร์เพิ่มเติม

TripPin = [
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin"
];

ตัวอย่าง: เชื่อมต่อ or ที่มีพารามิเตอร์ URL

หากฟังก์ชันแหล่งข้อมูลของคุณมีพารามิเตอร์เดียวที่จําเป็นของชนิด Uri.TypedataSourcePath ระบบจะเท่ากับ URL ที่ให้ไว้โดยผู้ใช้ ส่วนย่อยด้านล่างแสดงการใช้งาน Test เชื่อมต่อ ion จากตัวอย่าง Github

GithubSample = [
    TestConnection = (dataSourcePath) => {"GithubSample.Contents", dataSourcePath},
    Authentication = [
        OAuth = [
            StartLogin = StartLogin,
            FinishLogin = FinishLogin,
            Label = Extension.LoadString("AuthenticationLabel")
        ]
    ]
];

ตัวอย่าง: เชื่อมต่อ or ที่มีพารามิเตอร์ที่จําเป็น

ถ้าฟังก์ชันแหล่งข้อมูลของคุณมีพารามิเตอร์หลายรายการหรือพารามิเตอร์ dataSourcePath ที่ไม่ใช่ URL เดียว ค่าจะเป็นสตริง JSON ที่มีพารามิเตอร์ ส่วนย่อยด้านล่างนี้มาจากตัวอย่าง DirectQueryForSQL

DirectSQL = [
    TestConnection = (dataSourcePath) =>
        let
            json = Json.Document(dataSourcePath),
            server = json[server],
            database = json[database]
        in
            { "DirectSQL.Database", server, database },
    Authentication = [
        Windows = [],
        UsernamePassword = []
    ],
    Label = "Direct Query for SQL"
];