Power BI REST API: Menghubungkan Data SQL Langsung Tanpa Driver ODBC

Power BI · API REST sebagai pengganti driver

Titik Power BI pada API REST, bukan driver basis data

Power BI biasanya mengakses basis data melalui driver di mesin Anda dan, untuk penyegaran terjadwal, melalui gateway lokal. Endpoint Query Streams adalah URL HTTPS biasa, sehingga Power BI Desktop dan layanan Power BI membacanya dengan konektor Web bawaan. Portal akan menulis Power Query M untuk Anda: Ekspor → Power Query M (.pq), tempel, tambahkan kunci Anda, selesai. File yang sama juga berfungsi di Excel.

Sekitar 5 menit Tidak ada driver, tidak ada gateway. Data tetap berada di jaringan Anda. Excel juga

Inilah hasil akhirnya

Tabel Power BI yang diisi dengan kueri SQL tersimpan melalui HTTPS, dapat diperbarui di layanan tanpa gateway lokal, karena endpoint-nya terlihat seperti API web biasa. Endpoint itu sendiri terlihat seperti ini di konsol portal:

{
  "kota": "Seattle"
}

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"city": "Seattle"}'

{
  "kolom": [ { "nama": "ID pelanggan", "jenis": "bilangan bulat" }, { "nama": "nama", "jenis": "rangkaian" }, { "nama": "kota", "jenis": "rangkaian" } ],
  baris: [
    { "ID pelanggan": 1042, "nama": "Pedagang Angin Utara", "kota": "Seattle" },
    { "ID pelanggan": 1057, "nama": "Penyedia Perlengkapan Pegunungan Alpen", "kota": "Denver" },
    { "ID pelanggan": 1063, "nama": "Harbour Foods", "kota": "Halifax" }
  ],
  "meta": { "jumlah_baris": 3, "durasi_agen_ms": 41, "request_id": "req_7Hq2mKd9" }
}

Alasan adanya driver adalah karena Power BI harus berkomunikasi dengan protokol jaringan setiap basis data dari mana pun ia dijalankan, itulah sebabnya mengapa penyegaran terjadwal membutuhkan gateway yang berada di dalam jaringan Anda. Dengan adanya endpoint, Agent yang sudah berada di basis data menjalankan kueri dan api.querystreams.com menjawab Power BI melalui HTTPS, sehingga Power BI tidak perlu menginstal apa pun dan layanan tidak perlu melakukan tunneling.

Yang Anda butuhkan

Akun Query Streams

Semua paket memiliki REST API. Paket gratis memberi Anda satu endpoint, dua kunci, dan 250 baris per panggilan, yang cukup untuk membuat panduan ini. Daftar di sini. my.querystreams.com.

Agen pada komputer yang dapat mengakses basis data Anda sendiri, dengan koneksi yang ditambahkan.

Seringkali server basis data itu sendiri atau komputer yang selalu aktif di jaringan yang sama.

Kueri yang tersimpan di Query Builder

Endpoint tersebut membungkus tepat satu kueri yang tersimpan. Tulis SELECT, jalankan sekali, lalu simpan. Tambahkan Filter Dinamis (sebuah @variable (dalam klausa WHERE) jika pemanggil harus dapat melakukan filter.

Ditambah Power BI Desktop, atau Excel 2016 atau versi yang lebih baru. Jika Anda belum memiliki endpoint, maka Pusat API REST basis data Membawa Anda dari kueri yang tersimpan ke URL dalam empat langkah.

Hubungkan Power BI dalam empat langkah

1. Ekspor file M Power Query

   Di dalam API Buka endpoint Anda, klik Ekspor dan memilih Power Query M (.pq)File tersebut lengkap. biarkan … masuk Ekspresi dengan URL endpoint dan parameter yang dapat dipanggil sudah tersedia. Tampilannya seperti ini:

   Ekspor · Power Query M (.pq)

   membiarkan
     Sumber = Json.Dokumen(Web.Isi(
       "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19", [Header = [#"Kunci API-X" = "qsapi_KUNCI_ANDA"], Kueri = [kompresi = "tidak ada"]])), baris = Sumber[baris], tabel = Tabel.Dari Catatan(baris)
   di dalam
     meja

   Ekspor selalu meminta kompresi=tidak ada, karena Power Query tidak dapat mendekode frame LZ4; JSON melalui gzip adalah format yang diharapkan Power BI.

2. Tempelkan ke Power BI

   Di Power BI Desktop, pilih Beranda → Transformasi data → Sumber Baru → Kueri Kosong, buka Editor Tingkat Lanjut, ganti isinya dengan file tersebut dan klik SelesaiDi Excel, jalurnya adalah... Data → Dapatkan Data → Dari Sumber Lain → Kueri Kosong, lalu editor tingkat lanjut yang sama.

3. Tambahkan kunci Anda

   Ganti placeholder dengan kunci 49 karakter Anda yang dimulai dengan qsapi_ dari titik akhir Berbagi tab. Saat Power BI menanyakan cara terhubung, pilih Anonim: kunci tersebut berada di dalam Kunci API X Header kueri sudah diatur, jadi tidak diperlukan kredensial Power BI.

4. Muat dan segarkan

   Klik Tutup & Terapkan. Itu baris Array akan menjadi tabel Anda dengan satu kolom per kolom kueri. Publikasikan ke layanan Power BI dan atur jadwal penyegaran: karena sumbernya adalah URL web, tidak diperlukan gateway lokal. Setiap penyegaran adalah satu panggilan pada endpoint. Aktivitas tab.

Permintaan yang dibuat oleh Power BI

Secara internal, cara kerjanya sama seperti yang dapat Anda lakukan dengan curl. Parameter yang ditandai sebagai Callable dapat diteruskan dari Power Query sebagai Kueri = [kota = "Seattle"]:

curl "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19?city=Seattle" \ -H "X-API-Key: qsapi_KUNCI_ANDA"

{
  "kolom": [ { "nama": "ID pelanggan", "jenis": "bilangan bulat" }, { "nama": "nama", "jenis": "rangkaian" }, { "nama": "kota", "jenis": "rangkaian" } ],
  baris: [
    { "ID pelanggan": 1042, "nama": "Pedagang Angin Utara", "kota": "Seattle" },
    { "ID pelanggan": 1057, "nama": "Penyedia Perlengkapan Pegunungan Alpen", "kota": "Denver" },
    { "ID pelanggan": 1063, "nama": "Harbour Foods", "kota": "Halifax" }
  ],
  "meta": { "jumlah_baris": 3, "durasi_agen_ms": 41, "request_id": "req_7Hq2mKd9" }
}

Baris dikembalikan sebagai objek yang dikunci berdasarkan nama kolom, dengan daftar kolom dan sebuah meta Blok yang memberi tahu Anda berapa banyak baris yang ada, apakah hasilnya terpotong, dan ID permintaan yang dapat Anda kutip untuk mendukung permintaan tersebut. Panggilan yang sama seperti POST menempatkan parameter dalam badan JSON, yang merupakan pilihan tepat untuk daftar nilai yang panjang:

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"params": {"city": "Seattle"}}'

?format=csv

CSV, bukan JSON, termasuk baris header. Menerima format teks/csv melakukan hal yang sama. Endpoint streaming mengembalikan NDJSON (satu objek JSON per baris) dengan akhiran {"_ringkasan": benar, "jumlah_baris": N} baris; periksa baris terakhir itu.

?sampel=benar

Maksimal lima baris, tidak dikenakan biaya. Cocok untuk memasang kabel pada klien.

kompresi=lz4

Badan rangka LZ4 untuk penelepon bervolume tinggi dengan dekoder; Kode Tab tersebut berisi cuplikan dekoder per bahasa. Kompresi gzip biasa terjadi secara otomatis saat klien Anda mengirimkan data. Accept-Encoding: gzip.

Otorisasi: Bearer qsapi_…

Diterima sebagai alias untuk Kunci API XGunakan dari kode browser.

Di luar Power BI

Apa yang diizinkan oleh rencana tersebut

Setiap panggilan juga memiliki batas waktu kueri tetap 60 detik dan batas respons 8 MiB, dan byte yang dikembalikan akan dihitung terhadap kuota data bulanan paket Anda, kuota yang sama yang digunakan oleh add-in Excel dan Google Sheets. Paket gratis memiliki satu endpoint dan 5 MB per bulan, yang cukup untuk tabel kecil yang dipanggil berkali-kali dalam sehari. Lihat halaman harga. untuk tunjangan berdasarkan rencana.

Untuk laporan, batasi kueri hanya pada kolom yang dibutuhkan visual dan biarkan jadwal penyegaran melakukan sisanya; Power BI membaca seluruh hasil pada setiap penyegaran, sehingga batasan jumlah baris statis pada rencana Anda adalah batas atas untuk satu tabel.

Menjaganya tetap aman

Ketika sesuatu tidak berfungsi

Setiap badan kesalahan memiliki bentuk {"kesalahan": {"kode": "…", "pesan": "…"}} dan setiap respons membawa sebuah ID Permintaan X-QS Header. Kutip ID saat Anda menghubungi dukungan.

Dua hal spesifik tentang Power Query: a) Sumber Data.Kesalahan penamaan 401 artinya kunci dalam file M salah atau telah dicabut; Expression.Error: Kolom 'rows' pada record tidak ditemukan Artinya, endpoint mengembalikan amplop kesalahan, jadi jalankan URL di konsol portal untuk membacanya.

Pertanyaan yang diajukan orang

Panduan terkait

• API REST Basis Data: Ubah Kueri SQL Apa Pun Menjadi Titik Akhir
• API REST Microsoft SQL Server
• API REST PostgreSQL
• Menghubungkan REST API ke Excel tanpa VBA atau Power Query