Google BigQuery

Artikel
07/31/2024

Ringkasan

Item	Deskripsi
Status Rilis	Ketersediaan Umum
Produk	Power BI (Model semantik) Power BI (Aliran Data) Fabric (Dataflow Gen2) Power Apps (Aliran Data) Customer Insights (Aliran Data)
Jenis Autentikasi Didukung	Akun organisasi Akun layanan

Catatan

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

Catatan

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.

Prasyarat

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

Kemampuan yang didukung

Impor
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:

Pilih Google BigQuery dalam mendapatkan pengalaman data. Pengalaman mendapatkan data di Power Query Desktop bervariasi di antara aplikasi. Untuk informasi selengkapnya tentang Power Query Desktop mendapatkan pengalaman data untuk aplikasi Anda, buka Tempat mendapatkan data.
Jika Anda ingin menggunakan opsi lanjutan apa pun, pilih Opsi tingkat lanjut. Jika tidak, pilih OK untuk melanjutkan. Informasi selengkapnya: Menyambungkan menggunakan opsi tingkat lanjut
Konektor Google BigQuery mendukung koneksi melalui akun organisasi atau rincian masuk akun layanan. Dalam contoh ini, gunakan 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.
Dialog Masuk dengan Google muncul. Pilih akun Google Anda dan setujui menyambungkan ke Power BI Desktop.
Setelah masuk, pilih Sambungkan untuk melanjutkan.
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:

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 mendapatkan pengalaman data dari aplikasi Anda, buka Tempat mendapatkan data.
Dalam dialog Google BigQuery Database, Anda mungkin perlu membuat koneksi baru atau memilih koneksi yang sudah ada. Jika Anda menggunakan data lokal, pilih gateway data lokal. Lalu pilih Masuk.
Dialog Masuk dengan Google muncul. Pilih akun Google Anda dan setujui koneksi.

Catatan

Meskipun kotak dialog masuk mengatakan Anda akan melanjutkan ke Power BI Desktop setelah masuk, Anda akan dikirim ke aplikasi online Anda sebagai gantinya.
Jika Anda ingin menggunakan opsi lanjutan apa pun, pilih Opsi tingkat lanjut. Informasi selengkapnya: Menyambungkan menggunakan opsi tingkat lanjut
Setelah masuk, pilih Berikutnya untuk melanjutkan.
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.

Tampilan opsi tingkat lanjut yang tersedia di Power Query Desktop.

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 akan menjalankan kueri Power Query. 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 akan digunakan.
Menggunakan Storage Api	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. Defaultnya tergantung pada default driver. Anda dapat memasukkan nilai lain dalam hitungan menit agar koneksi tetap terbuka lebih lama.
ID Proyek	Proyek yang ingin Anda jalankan kueri aslinya. Opsi ini hanya tersedia di Power Query Desktop.
Pernyataan 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.

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 sambungan 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.

Dukungan Google BigQuery Nested Fields.

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

Di bawah tab pita Transformasi , kategori Kolom Teks, pilih Uraikan lalu JSON.
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 BigQuery.User peran. Informasi selengkapnya, peran dan izin google BigQuery Yang telah ditentukan sebelumnya

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 diketahui di mana jenis DateTime tidak didukung melalui Kueri Langsung. Memilih kolom dengan jenis DateTime menyebabkan kesalahan "Kueri tidak valid" atau kesalahan 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 sementara: Gunakan pernyataan SQL kueri asli untuk mengambil tampilan materialisasi dari Google BigQuery.

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

Kuota terlampaui di seluruh penggunaan akun pelanggan dari 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 terhuyung-ambing.
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.

Bagikan melalui