Google BigQuery (platform untuk analisis data)

Ringkasan

Barang	Deskripsi
Status Perilisan	Ketersediaan Umum
Produk	Power BI (Model Semantik) Power BI (Dataflow) Fabric (Dataflow Gen2) Power Apps (Aliran Data) Customer Insights (Alur Data)
Jenis Autentikasi Didukung	Akun organisasi Akun layanan

Nota

Beberapa kemampuan mungkin ada dalam satu produk tetapi tidak yang lain karena jadwal penyebaran dan kemampuan khusus host.

Nota

Mulai Juli 2021, Google menghentikan dukungan untuk masuk ke akun Google dari kerangka kerja browser yang disematkan. Karena perubahan ini, Anda perlu memperbarui versi Power BI Desktop Anda ke Juni 2021 atau yang lebih baru untuk mendukung masuk ke Google.

Nota

Sejak Mei 2025, kami memperkenalkan implementasi baru untuk konektor Google BigQuery, yang saat ini tersedia dalam pratinjau. Pelajari lebih lanjut tentang fitur ini .

Prasyarat

Anda memerlukan akun Google atau akun layanan Google untuk masuk ke Google BigQuery.

Kemampuan yang didukung

• Mengimpor
• DirectQuery (model semantik Power BI)

Menyambungkan ke data Google BigQuery dari Power Query Desktop

Untuk menyambungkan ke Google BigQuery dari Power Query Desktop, lakukan langkah-langkah berikut:

1. Pilih Google BigQuery dalam mendapatkan pengalaman data. Pengalaman mendapatkan data di Power Query Desktop bervariasi di antara aplikasi. Untuk informasi lebih lanjut tentang pengalaman dalam mendapatkan data menggunakan Power Query Desktop untuk aplikasi Anda, kunjungi Tempat mendapatkan data.

2. Jika Anda ingin menggunakan opsi tingkat lanjut apa pun, pilih Opsi tingkat lanjut. Jika tidak, pilih OK untuk melanjutkan. Untuk informasi selengkapnya, buka Menyambungkan menggunakan opsi tingkat lanjut.

   

3. Konektor Google BigQuery mendukung koneksi melalui akun organisasi atau akun layanan. Contoh ini menggunakan akun organisasi untuk masuk. Pilih Masuk untuk melanjutkan.

   

   Anda juga dapat masuk menggunakan akun layanan Google. Dalam hal ini, pilih Masuk Akun Layanan dan masukkan email akun layanan Anda dan konten file kunci JSON akun layanan Anda. Kemudian pilih Sambungkan.

4. Dialog Masuk dengan Google muncul. Pilih akun Google Anda dan setujui menyambungkan ke Power BI Desktop.

   

5. Setelah masuk, pilih Sambungkan untuk melanjutkan.

   

6. Setelah Anda berhasil tersambung, jendela Navigator muncul dan menampilkan data yang tersedia di server. Pilih data Anda di navigator. Lalu pilih Transformasi Data untuk mengubah data di Power Query atau Muat untuk memuat data di Power BI Desktop.

   

Menyambungkan ke data Google BigQuery dari Power Query Online

Untuk menyambungkan ke Google BigQuery dari Power Query Online, lakukan langkah-langkah berikut:

1. Pilih opsi Google BigQuery dalam mendapatkan pengalaman data. Aplikasi yang berbeda memiliki berbagai cara untuk masuk ke Power Query Online mendapatkan pengalaman data. Untuk informasi selengkapnya tentang cara masuk ke Power Query Online untuk mendapatkan pengalaman pengambilan data dari aplikasi Anda, silakan kunjungi Tempat mendapatkan data.

   

2. Dalam dialog Google BigQuery Database , Anda mungkin perlu membuat koneksi baru atau memilih koneksi yang sudah ada. Pilih akun organisasi atau layanan untuk masuk. Jika Anda menggunakan data lokal, pilih gateway data lokal. Lalu pilih Masuk.

   

3. Dialog Masuk dengan Google muncul. Pilih akun Google Anda dan setujui koneksi.

   Nota

   Meskipun kotak dialog masuk mengatakan Anda melanjutkan ke Power BI Desktop setelah masuk, Anda dikirim ke aplikasi online Anda sebagai gantinya.

   

4. Jika Anda ingin menggunakan opsi lanjutan apa pun, pilih Opsi tingkat lanjut. Informasi selengkapnya: Menyambungkan menggunakan opsi tingkat lanjut

5. Setelah masuk, pilih Berikutnya untuk melanjutkan.

   

6. Setelah Anda berhasil tersambung, jendela Navigator muncul dan menampilkan data yang tersedia di server. Pilih data Anda di navigator. Lalu pilih Berikutnya untuk mengubah data di Power Query.

   

Menyambungkan menggunakan opsi tingkat lanjut

Power Query Desktop dan Power Query Online menyediakan sekumpulan opsi tingkat lanjut yang bisa Anda tambahkan ke kueri Anda jika diperlukan.

Tabel berikut ini mencantumkan semua opsi tingkat lanjut yang bisa Anda atur di Power Query Desktop dan Power Query Online.

Opsi tingkat lanjut	Deskripsi
ID Proyek Penagihan	Proyek yang digunakan Power Query untuk menjalankan kueri. Izin dan penagihan terkait dengan proyek ini. Jika tidak ada ID Proyek Penagihan yang disediakan, secara default proyek pertama yang tersedia yang dikembalikan oleh Google API digunakan.
Gunakan API Penyimpanan	Bendera yang memungkinkan penggunaan API Penyimpanan Google BigQuery. Opsi ini benar secara default. Opsi ini dapat diatur ke false untuk tidak menggunakan STORAGE API dan menggunakan REST API sebagai gantinya.
Durasi batas waktu koneksi	Pengaturan koneksi standar (dalam detik) yang mengontrol berapa lama Power Query menunggu koneksi selesai. Anda dapat mengubah nilai ini jika koneksi Anda tidak selesai sebelum 15 detik (nilai default.)
Durasi batas waktu perintah	Berapa lama Power Query menunggu kueri selesai dan mengembalikan hasil. Pengaturan bawaannya tergantung pada pengaturan bawaan dari driver. Anda dapat memasukkan nilai lain dalam hitungan menit agar koneksi tetap terbuka lebih lama.
ID Proyek	Proyek yang ingin Anda jalankan kueri aslinya.
Perintah SQL	Untuk informasi, buka Mengimpor data dari database menggunakan kueri database asli. Dalam versi fungsionalitas kueri database asli ini, Anda perlu menggunakan nama tabel yang sepenuhnya memenuhi syarat dalam format Database.Schema.Table, misalnya SELECT * FROM DEMO_DB.PUBLIC.DEMO_TABLE. Opsi ini hanya tersedia di Power Query Desktop.

Setelah Anda memilih opsi lanjutan yang Anda perlukan, pilih OK di Power Query Desktop atau Berikutnya di Power Query Online untuk menyambungkan ke data Google BigQuery Anda.

Implementasi konektor Google BigQuery baru (Pratinjau)

Sejak Mei 2025, kami memperkenalkan implementasi baru untuk konektor Google BigQuery untuk meningkatkan integrasi dengan Google BigQuery, yang saat ini tersedia dalam pratinjau. Ini menggunakan Arrow Database Connectivity (ADBC) alih-alih ODBC untuk menyambungkan dan mengambil data dari Google BigQuery yang meningkatkan performa terutama untuk kumpulan hasil besar. Saat kami terus meningkatkan dan menambahkan kemampuan baru ke konektor ini, kami mendorong Anda untuk meningkatkan ke versi terbaru untuk mencobanya dan memberi kami umpan balik.

Nota

Fitur ini didukung di Power BI Desktop versi 64-bit dan tidak berfungsi dalam versi 32-bit.

Untuk mengakses fitur ini di Power BI Desktop, navigasikan ke Opsi dan pengaturan (di bawah tab File) >Fitur Pratinjau>, lalu pilih kotak centang untuk mengaktifkan opsi Gunakan implementasi konektor Google BigQuery baru. Setelah opsi aktif, semua koneksi yang baru dibuat secara otomatis menggunakan implementasi konektor baru.

Koneksi Anda yang ada tetap tidak berubah. Anda dapat mencoba fitur dengan menambahkan Implementation="2.0" flag ke dalam GoogleBigQuery.Database kueri Anda sebagai berikut. Properti ini membedakan versi konektor yang Anda gunakan.

Untuk mengakses fitur ini di Dataflow Gen2, setelah Anda mengonfigurasi mendapatkan data dari Google BigQuery, buka Editor tingkat lanjut di pita atas, dan tambahkan Implementation="2.0" bendera dalam GoogleBigQuery.Database kueri Anda sebagai berikut untuk menggunakan konektor baru ini.

Source = GoogleBigQuery.Database([Implementation = "2.0"])

Nota

Saat Anda menggunakan gateway data lokal, perhatikan versi minimal yang didukung adalah Mei 2025. Anda disarankan untuk menggunakan versi terbaru untuk mengevaluasi fitur ini dengan kemampuan terbaru.

Untuk membantu mendiagnosis masalah potensial, Anda dapat menemukan Implementation sebagai "2.0" dan DriverType sebagai "ADBC" di log Mashup Anda.

Saat ini, konektor ini memiliki batasan yang diketahui berikut:

• Hubungan tidak didukung.
• Proksi tidak didukung.

Batasan dan pertimbangan

Bagian ini menjelaskan batasan atau pertimbangan konektor Google BigQuery.

Menyambungkan ke Google BigQuery di Power BI Desktop

Ada beberapa batasan dan pertimbangan yang perlu diingat saat menggunakan konektor Google BigQuery dengan Power BI.

Ketersediaan konektor

Konektor Google BigQuery tersedia di Power BI Desktop dan di layanan Power BI. Di layanan Power BI, konektor dapat diakses menggunakan koneksi Cloud-ke-Cloud dari Power BI ke Google BigQuery.

Kesalahan "Akses Ditolak"

Saat mencoba menyambungkan ke Google BigQuery dari Power BI Desktop, Anda mungkin mendapatkan pesan kesalahan berikut:

Datasource.Error: ODBC: ERROR [HY000][Microsoft][BigQuery] (100) Error interacting with REST API: Access Denied: Project <project name>: The user <user name> bigquery.jobs.create permissions in project <project name>.

Dalam hal ini, Anda mungkin perlu memasukkan ID Proyek Penagihan di opsi lanjutan Proyek Penagihan di pengaturan Koneksi Power Query.

Selain itu, jika Anda juga membuat laporan di layanan Power BI menggunakan gateway, Anda mungkin masih mendapatkan kesalahan ini. Dalam hal ini, Anda harus menyertakan ID Proyek Penagihan secara manual dalam kode M untuk koneksi menggunakan editor Power Query atau bilah rumus Power Query. Contohnya:

Source = GoogleBigQuery.Database([BillingProject="Include-Billing-Project-Id-Here"])

Bidang berlapis

Untuk mengoptimalkan pertimbangan performa, Google BigQuery berfungsi dengan baik dengan himpunan data besar saat didenormalisasi, diratakan, dan berlapis.

Konektor Google BigQuery mendukung bidang berlapis, yang dimuat sebagai kolom teks dalam format JSON.

Pengguna harus memilih Transformasi Data lalu menggunakan kemampuan penguraian JSON di editor Power Query untuk mengekstrak data.

1. Di bawah tab pita Transformasi , kategori Kolom Teks , pilih Uraikan lalu JSON.
2. Ekstrak bidang catatan JSON menggunakan opsi Perluas Kolom .

Menyiapkan akun layanan Google

Untuk informasi selengkapnya tentang menyiapkan atau menggunakan akun layanan Google, buka Membuat dan mengelola kunci akun layanan di Google dokumen.

Mengautentikasi melalui akun layanan Google

Saat Anda mengautentikasi melalui akun layanan Google di Power BI Desktop, ada format kredensial tertentu yang diperlukan oleh konektor.

• Email Akun Layanan: harus dalam format email.
• Konten file kunci JSON Akun Layanan: setelah kunci JSON ini diunduh, semua baris baru harus dihapus dari file sehingga konten berada dalam satu baris. Setelah file JSON dalam format tersebut, konten dapat ditempelkan ke bidang ini.

Saat Anda mengautentikasi melalui akun layanan Google di layanan Power BI atau Power Query Online, pengguna perlu menggunakan autentikasi "Dasar". Bidang Nama Pengguna memetakan ke bidang Email Akun Layanan , dan bidang Kata Sandi dipetakan ke bidang konten file kunci JSON Akun Layanan . Persyaratan format untuk setiap kredensial tetap sama di Power BI Desktop, layanan Power BI, dan Power Query Online.

Tidak dapat mengautentikasi dengan Google BigQuery Storage API

Konektor Google BigQuery menggunakan Google BigQuery Storage API secara default. Fitur ini dikontrol oleh opsi tingkat lanjut yang disebut UseStorageApi. Anda mungkin mengalami masalah dengan fitur ini jika Anda menggunakan izin terperinci. Dalam skenario ini, Anda mungkin melihat pesan kesalahan berikut atau gagal mendapatkan data apa pun dari kueri Anda:

ERROR [HY000] [Microsoft][BigQuery] (131) Unable to authenticate with Google BigQuery Storage API. Check your account permissions

Anda dapat mengatasi masalah ini dengan menyesuaikan izin pengguna untuk BIGQuery Storage API dengan benar. Izin API penyimpanan ini diperlukan untuk mengakses data dengan benar dengan BIGQueryStorage API:

• bigquery.readsessions.create: Membuat sesi baca baru melalui BIGQuery Storage API.
• bigquery.readsessions.getData: Membaca data dari sesi baca melalui BIGQuery Storage API.
• bigquery.readsessions.update: Memperbarui sesi baca melalui BIGQuery Storage API.

Izin ini biasanya disediakan dalam peran BigQuery.User. Untuk informasi selengkapnya, buka Peran dan izin yang telah ditentukan Google BigQuery.

Jika langkah-langkah di atas tidak mengatasi masalah, Anda dapat menonaktifkan BIGQuery Storage API.

Tidak dapat menggunakan data jenis DateTime dalam mode Kueri Langsung

Ada masalah yang sudah diketahui bahwa tipe DateTime tidak didukung melalui Kueri Langsung. Memilih kolom dengan tipe DateTime menyebabkan kesalahan Invalid query atau gangguan visual.

Batasan pada kolom kueri yang memiliki nama yang sama dengan nama tabel

Saat mengkueri kolom yang memiliki nama yang sama dengan nama tabel, BigQuery menginterpretasikan kolom sebagai struct yang menyertakan semua kolom dalam tabel alih-alih kolom yang ditentukan. Misalnya, SELECT debug FROM dataset.debug mengembalikan struct dengan semua kolom dalam tabel debug, bukan kolom debug yang ditentukan. Perilaku ini tidak intuitif dan perbaikan sedang diselidiki. Ada tiga solusi yang tersedia:

• Solusi sementara 1: Membungkus tabel dengan tampilan yang tidak bertentangan dengan nama kolom—CREATE VIEW dataset.new_view AS SELECT * FROM dataset.debug
• Solusi 2: Ganti nama kolom untuk menghindari konflik dengan nama tabel—ALTER TABLE dataset.debug RENAME COLUMN debug to new_debug
• Solusi sementara 3: Ubah kueri SELECT untuk menggunakan table.column untuk mereferensikan kolom konflik—SELECT debug.debug FROM dataset.debug

Tampilan materialisasi tidak didukung di navigator Power BI Desktop

Masalah yang diketahui adalah bahwa konektor Google BigQuery saat ini tidak mendukung tampilan materialisasi di navigator Power BI Desktop.

• Solusi alternatif: Gunakan pernyataan SQL kueri bawaan untuk mengambil tampilan materialisasi dari Google BigQuery.

Kesalahan HTTP 403: kuotaExceeded (Kuota terlampaui: Pengguna Anda melebihi kuota untuk permintaan project.lists bersamaan)

• Kuota terlampaui dalam penggunaan seluruh akun pelanggan pada panggilan API project.lists ke Google. Saat beberapa laporan di-refresh secara bersamaan, mungkin memicu kesalahan dalam kueri atau laporan yang berbeda. Untuk mencegah kesalahan, jadwalkan refresh laporan pada interval yang terjadwal bertahap.
• Perbarui kueri untuk menyertakan ID Proyek Penagihan - GoogleBigQuery.Database([BillingProject="Include-Billing-Project-Id-Here"]).
• Panggilan ke GoogleBigQuery.Database harus berada dalam kueri yang sama dengan skema dan pilihan tabel untuk menghindari kesalahan.