Bagikan melalui

Menyambungkan dengan data menggunakan kueri Power BI dan OData

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Untuk menarik data ke Power BI, kami sarankan Anda menggunakan kueri Open Data Protocol (OData). OData adalah standar yang ditetapkan oleh Organisasi untuk Kemajuan Standar Informasi Terstruktur (OASIS) dan disetujui oleh Organisasi Internasional untuk Standardisasi dan Komisi Elektroteknik Internasional (ISO/IEC). OData mendefinisikan praktik terbaik untuk membangun dan menggunakan REST API. Untuk informasi selengkapnya, lihat dokumentasi OData.

Untuk memulai dengan cepat, lihat Gambaran umum laporan sampel menggunakan kueri OData. Untuk informasi tentang pendekatan lain, lihat Tentang integrasi Power BI.

Power BI dapat menjalankan kueri OData, yang dapat mengembalikan kumpulan data yang difilter atau diagregasi ke Power BI. Kueri OData memiliki dua keuntungan:

  • Semua pemfilteran dilakukan di sisi server. Hanya data yang Anda butuhkan yang dikembalikan, yang mengarah ke waktu refresh yang lebih singkat.
  • Anda dapat mengagregasi data terlebih dahulu pada sisi server. Kueri OData dapat melakukan agregasi seperti penggabungan item kerja dan tingkat kegagalan dalam proses pembangunan. Agregasi dicapai di sisi server, dan hanya nilai agregat yang dikembalikan ke Power BI. Dengan menggunakan preaggregasi, Anda dapat melakukan agregasi di seluruh himpunan data besar tanpa perlu menarik semua data terperinci ke Power BI.

Di tutorial ini, Anda akan:

  • Menulis dan menguji kueri OData.
  • Jalankan kueri OData dari Power BI.

Prasyarat

Kategori Persyaratan
Tingkat-tingkat akses - Anggota proyek.
- Setidaknya akses Dasar .
Izin Secara default, anggota proyek memiliki izin untuk mengkueri Analytics dan membuat tampilan. Untuk informasi selengkapnya tentang prasyarat lain mengenai pengaktifan layanan dan fitur serta aktivitas pelacakan data umum, lihat Izin dan prasyarat untuk mengakses Analitik.

Menggunakan Visual Studio Code untuk menulis dan menguji kueri OData

Cara term mudah untuk menulis dan menguji OData adalah dengan menggunakan Visual Studio Code dengan ekstensi OData. Visual Studio Code adalah editor kode gratis yang tersedia di Windows, Mac, dan Linux. Ekstensi OData menyediakan penyorotan sintaks dan fungsi lain yang berguna untuk menulis dan menguji kueri.

Menginstal Visual Studio Code dan ekstensi OData

  1. Instal Visual Studio Code.

  2. Buka Visual Studio Code, pilih Ekstensi, lalu cari odata. Dalam daftar hasil, pilih vscode-odata, lalu instal ekstensi ini.

  3. Di Visual Studio Code, buat file OData dengan membuat file kosong yang memiliki ekstensi .odata. Anda dapat menamainya apa pun yang Anda inginkan, misalnya, filename.odata. Tetapi harus memiliki ekstensi .odata untuk mengaktifkan fungsionalitas ekstensi OData.

Tulis kueri OData

Tulis kueri OData. Untuk contoh kueri, lihat Gambaran umum laporan sampel menggunakan kueri OData.

Kueri berikut menampilkan 10 item kerja teratas pada jalur area tertentu. Untuk menggunakan kueri ini, ganti {organization}, {project}, dan {area path} dengan nilai Anda.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
      $select=WorkItemId,Title,WorkItemType,State,CreatedDate
      &$filter=startswith(Area/AreaPath,'{area path}')
      &$orderby=CreatedDate desc
      &$top=10

Untuk melakukan kueri di seluruh proyek, hapus /{project} sepenuhnya.

Untuk informasi selengkapnya, lihat Contoh laporan dan indeks referensi cepat.

Setelah Anda menulis kueri di Visual Studio Code, Anda akan melihat penyorotan sintaks.

Cuplikan layar yang memperlihatkan file OData di Visual Studio Code. Setiap jenis elemen kode memiliki warnanya sendiri.

Menguji kueri OData

  1. Untuk menguji kueri OData, letakkan kursor Anda di mana saja dalam teks kueri, lalu pilih Tampilkan>Palet Perintah.

  2. Dalam kotak pencarian, masukkan odata untuk memunculkan perintah OData.

    Cuplikan layar yang memperlihatkan palet perintah untuk ekstensi OData Visual Studio Code.

  3. Pilih OData: Buka. Tindakan ini menggabungkan kueri multibaris ke dalam URL satu baris, menjalankan kueri, dan membuka hasilnya di browser default Anda.

    • Kumpulan hasil kueri OData dalam format JSON. Untuk melihat hasilnya, instal ekstensi formatter JSON untuk browser Anda. Beberapa opsi tersedia untuk Chrome dan Microsoft Edge.

      Cuplikan layar browser yang memperlihatkan output JSON dari kueri OData yang ditampilkan dalam format yang dapat dibaca.

    • Jika kueri memiliki kesalahan, layanan Analytics mengembalikan kesalahan dalam format JSON. Misalnya, kesalahan berikut menyatakan bahwa kueri memilih bidang yang tidak ada.

      Cuplikan layar browser yang memperlihatkan output JSON dalam format yang dapat dibaca. Pesan dalam output menunjukkan kesalahan dalam kueri OData.

Setelah Anda memverifikasi bahwa kueri berfungsi dengan benar, Anda bisa menjalankannya dari Power BI.

Menjalankan kueri OData dari Power BI

Untuk menjalankan kueri OData dari Power BI, lakukan langkah-langkah di bagian berikut ini.

Menggabungkan kueri OData multibaris ke dalam kueri satu baris

Sebelum Anda menggunakan kueri di Power BI, Anda harus mengonversi kueri OData multibaris menjadi kueri satu baris. Untuk menggunakan perintah OData: Gabungkan untuk tujuan ini, lakukan langkah-langkah berikut:

  1. Buat salinan file OData yang berisi teks kueri multibaris Anda. Langkah ini direkomendasikan, karena tidak ada cara untuk mengonversi kueri baris tunggal kembali ke kueri multibaris yang dapat dibaca.

  2. Di Visual Studio Code, buka salinan file OData Anda dan letakkan kursor Anda di mana saja dalam teks kueri.

  3. Pilih Tampilkan>Palet Perintah. Di kotak pencarian, masukkan odata. Kemudian dalam daftar hasil, pilih OData: Gabungkan.

    Kueri multibaris dikonversi menjadi kueri satu baris.

    Cuplikan layar file OData di Visual Studio Code. File berisi kueri multibaris diikuti oleh versi baris tunggal kueri.

  4. Salin seluruh baris untuk digunakan di bagian berikutnya.

Menjalankan kueri dari Power BI

  1. Di Power BI, pilih Dapatkan data>umpan OData. Untuk informasi selengkapnya, lihat Membuat laporan Power BI dengan kueri OData.

    Cuplikan layar Power BI dengan opsi Ambil Data dan Umpan OData yang disorot.

  2. Di jendela umpan OData, dalam kotak URL , tempelkan kueri OData yang Anda salin di bagian sebelumnya, lalu pilih OK.

    Cuplikan layar dialog umpan OData. Kotak URL berisi kueri OData baris tunggal.

    Power BI menampilkan halaman pratinjau.

    Cuplikan layar halaman pratinjau di Power BI dengan tombol untuk memuat dan mengubah data. Tabel mencantumkan informasi tentang beberapa item kerja.

Tentukan opsi kueri

  1. Pada halaman pratinjau, pilih Ubah Data untuk membuka Editor Power Query.

    Cuplikan layar Editor Power Query. Tabel mencantumkan data umpan OData untuk beberapa item kerja.

  2. Pada pita, pilih Editor Tingkat Lanjut.

    Cuplikan layar pita Power BI. Editor Tingkat Lanjut disorot.

  3. Di jendela Editor Tingkat Lanjut, gulir secara horizontal untuk menampilkan [Implementation="2.0"] parameter dalam kueri.

    Cuplikan layar jendela Editor Tingkat Lanjut. Akhir kueri terlihat, dan parameter implementasi disorot.

  4. Ganti [Implementation="2.0"] dengan string berikut:

    [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

    Cuplikan layar jendela Editor Tingkat Lanjut. Akhir kueri terlihat. Ini berisi string pengganti dan disorot.

    Perubahan ini membantu mencegah kesalahan pengurangan kecepatan. Nilai baru memiliki efek berikut:

    • Mereka menginstruksikan Power BI untuk mereferensikan OData versi 4.
    • Mereka menginstruksikan layanan Analytics untuk menghilangkan nilai apa pun yang null, yang meningkatkan performa kueri.

    Power Query mencoba mengatasi nilai null sebagai kesalahan dengan menghasilkan kueri lain untuk setiap nilai null yang ditemuinya. Tindakan ini dapat menghasilkan ribuan kueri. Kueri ini dapat dengan cepat melebihi ambang penggunaan Anda, setelah itu akun pengguna Anda dibatasi kecepatannya.

  5. Pilih Selesai untuk menutup Editor Lanjutan dan kembali ke Editor Power Query Power BI. Anda dapat menggunakan Editor Power Query untuk melakukan tindakan opsional berikut:

    • Ganti nama Query1 kueri sebagai sesuatu yang lebih spesifik.
    • Mengubah kolom menjadi jenis tertentu. Power BI secara otomatis mendeteksi jenisnya, tetapi Anda mungkin ingin mengonversi kolom ke tipe data tertentu.
    • Tambahkan kolom komputasi.
    • Hapus kolom.
    • Perluas kolom ke bidang tertentu.

Membuat laporan dengan menggunakan data

Pilih Tutup & Terapkan untuk menyimpan pengaturan Anda dan tarik data ke Power BI. Setelah data di-refresh, Anda bisa membuat laporan seperti yang biasa Anda lakukan di Power BI.

Cuplikan layar pita Power BI. Tombol Tutup & Terapkan disorot.

Konten terkait

  • Last updated on