Bagikan melalui

Menangani Akses Data

Fungsi Sumber Data

Konektor Data membungkus dan menyesuaikan perilaku fungsi sumber data di Pustaka M. Misalnya, ekstensi untuk REST API akan menggunakan fungsi Web.Contents untuk membuat permintaan HTTP. Saat ini, sekumpulan fungsi sumber data terbatas telah diaktifkan untuk mendukung ekstensibilitas.

Example:

[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;

Jenis Sumber Data

Fungsi yang ditandai sebagai shared dalam ekstensi Anda dapat dikaitkan dengan sumber data tertentu dengan menyertakan DataSource.Kind atribut harfiah pada fungsi dengan nama rekaman definisi Sumber Data. Rekaman Sumber Data menentukan jenis autentikasi yang didukung oleh sumber data Anda, dan informasi merek dasar (seperti nama tampilan /label). Nama rekaman menjadi pengidentifikasi uniknya.

Setiap fungsi yang terkait dengan sumber data yang sama harus memiliki parameter fungsi yang diperlukan yang sama, termasuk nama, jenis, dan urutan. (Untuk tujuan Jenis Sumber Data, parameter tidak dianggap diperlukan jika ditandai optional atau jika metadatanya berisi DataSource.Path = false.)

Fungsi untuk Jenis Sumber Data tertentu hanya dapat menggunakan kredensial yang terkait dengan Jenis tersebut. Kredensial diidentifikasi pada runtime dengan melakukan pencarian berdasarkan kombinasi parameter fungsi yang diperlukan. Untuk informasi selengkapnya tentang bagaimana kredensial diidentifikasi, lihat Jalur Sumber Data.

Example:

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

Karakteristik

Tabel berikut mencantumkan bidang untuk rekaman definisi Sumber Data Anda.

Bidang Tipe Detail lebih lanjut
Authentication rekaman Menentukan satu atau beberapa jenis autentikasi yang didukung oleh sumber data Anda. Setidaknya diperlukan satu jenis. Setiap jenis akan ditampilkan sebagai opsi dalam perintah kredensial Power Query. Untuk informasi selengkapnya, lihat Jenis Autentikasi.
Etiket kirim pesan teks (opsional) Nama tampilan yang mudah diingat untuk ekstensi ini dalam dialog kredensial.
SupportsEncryption logis (opsional) Jika benar, UI akan menyajikan opsi untuk menyambungkan ke sumber data menggunakan koneksi terenkripsi. Ini biasanya digunakan untuk sumber data dengan mekanisme fallback yang tidak dienkripsi (umumnya ODBC atau sumber berbasis ADO.NET).

Terbitkan ke UI

Mirip dengan catatan definisi Sumber Data, catatan Terbitkan menyediakan informasi yang diperlukan oleh UI Power Query untuk menampilkan ekstensi ini dalam dialog Dapatkan Data.

Example:

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") }
];

Karakteristik

Tabel berikut ini mencantumkan bidang untuk catatan Terbitkan Anda.

Bidang Tipe Detail lebih lanjut
Teks Tombol daftar Daftar item teks. Item pertama menentukan nama yang ditampilkan di samping ikon sumber data dalam dialog Dapatkan Data Power BI. Item kedua (opsional) mendefinisikan tooltip yang akan ditampilkan saat nama sebelumnya didaya-gulir.
Kategori kirim pesan teks Di mana ekstensi harus ditampilkan dalam dialog Dapatkan Data . Saat ini satu-satunya nilai kategori dengan penanganan khusus adalah Azure dan Database. Semua nilai lain akan berakhir di bawah kategori Lainnya.
Beta logis (opsional) Ketika diatur ke true, UI akan menampilkan label pratinjau/beta di samping nama konektor Anda dan dialog peringatan bahwa implementasi konektor dapat mengalami perubahan signifikan.
LearnMoreUrl kirim pesan teks (opsional) Url ke situs web yang berisi informasi selengkapnya tentang sumber data atau konektor ini.
Mendukung DirectQuery logis (opsional) Mengaktifkan Kueri Langsung untuk ekstensi Anda.
SourceImage rekaman (opsional) Rekaman yang berisi daftar gambar biner (bersumber dari file ekstensi menggunakan metode Extension.Contents ). Rekaman berisi dua bidang (Icon16, Icon32), masing-masing memiliki daftarnya sendiri. Setiap ikon harus berukuran berbeda.
SourceTypeImage rekaman (opsional) Mirip dengan SourceImage, kecuali konvensi untuk banyak konektor siap pakai adalah menampilkan ikon lembaran dengan ikon spesifik sumber di sudut kanan bawah. Memiliki serangkaian ikon yang berbeda untuk SourceTypeImage bersifat opsional—banyak ekstensi hanya menggunakan kembali kumpulan ikon yang sama untuk kedua bidang.
  • Last updated on