Anda dapat mengakses, menganalisis, memvisualisasikan, dan membagikan miliaran baris data dari spreadsheet dengan Sheet yang Terhubung, konektor data Spreadsheet. Anda juga dapat menggunakan Sheet yang Terhubung untuk:
- Berkolaborasi dengan partner, analis, atau pemangku kepentingan lainnya dalam antarmuka spreadsheet yang sudah familier.
- Mengizinkan pengguna mendelegasikan akses kepada kolaborator.
- Memastikan satu sumber tepercaya untuk analisis data tanpa ekspor file .csv tambahan.
- Menganalisis data di dalam perimeter yang membatasi akses berdasarkan atribut, seperti alamat IP dan informasi perangkat pengguna.
Anda dapat menjalankan kueri dari Sheet yang Terhubung di BigQuery atau Looker secara manual atau pada jadwal yang ditentukan. Spreadsheet menyimpan hasil kueri ini di spreadsheet sehingga Anda dapat menganalisis dan membagikannya. Tonton tutorial video berikut untuk mempelajari lebih lanjut cara Menggunakan Sheet yang Terhubung dengan BigQuery.
Anda dapat melihat peristiwa kueri Sheet yang Terhubung di peristiwa log Drive.
Menyiapkan BigQuery untuk menganalisis data
Langkah 1: Aktifkan Google CloudPastikan Google Cloud diaktifkan untuk organisasi Anda. Untuk mengetahui petunjuknya, buka Melihat aplikasi mana yang diaktifkan untuk pengguna, grup, atau unit organisasi. Jika Anda perlu mengaktifkan Google Cloud, buka Mengaktifkan atau menonaktifkan Google Cloud untuk pengguna.
Untuk mengetahui petunjuk tentang cara menggunakan Sheet yang Terhubung dengan BigQuery, lihat Mulai menggunakan data BigQuery di Google Spreadsheet.
Anda menggunakan peran IAM (pengelolaan akses dan identitas) untuk menetapkan izin terkait data apa yang dapat diakses pengguna. Untuk menambahkan atau menggunakan project BigQuery di Spreadsheet, peran IAM pengguna di BigQuery harus berupa bigquery.user atau bigquery.jobUser dan bigquery.dataViewer.
Untuk mempelajari peran ini, lihat Peran IAM yang telah ditetapkan BigQuery.
Tindakan yang dapat dilakukan pengguna bergantung pada peran IAM dan izin spreadsheet mereka, bukan izin pemilik spreadsheet. Orang di luar organisasi hanya dapat berinteraksi dengan Spreadsheet di organisasi jika Anda mengizinkannya.
| Tindakan di Spreadsheet | Peran IAM yang diperlukan di BigQuery | Izin yang diperlukan di Spreadsheet |
|---|---|---|
| Membuat diagram, tabel pivot, formula, atau ekstrak menggunakan tabel atau tampilan BigQuery |
bigquery.user ataubigquery.jobUser dan bigquery.dataViewer |
Editor |
| Melihat diagram, tabel pivot, formula, ekstrak, atau pratinjau yang dibuat dari data BigQuery | Tidak ada | Editor atau pengakses lihat-saja |
| Membuat atau mengedit kueri BigQuery kustom |
bigquery.user atau bigquery.jobUser dan bigquery.dataViewer |
Editor |
| Melihat kueri BigQuery kustom | Tidak ada | Editor atau pengakses lihat-saja |
| Memperbarui data dari BigQuery |
bigquery.user atau bigquery.jobUser dan bigquery.dataViewer |
Editor |
Anda dapat menetapkan peran IAM ke set data di konsol BigQuery. Untuk mengetahui detailnya, buka Mengontrol akses ke fasilitas dengan IAM.
Selain menggunakan IAM untuk memberikan otorisasi kepada pengguna yang dapat mengakses data BigQuery, Anda dapat menggunakan Kontrol Layanan VPC untuk membuat perimeter layanan yang membatasi akses berdasarkan atribut seperti alamat IP dan informasi perangkat pengguna. Pengguna dapat menggunakan Sheet yang Terhubung untuk mengakses data BigQuery yang dilindungi oleh Kontrol Layanan VPC hanya jika Anda mengonfigurasi perimeter agar Spreadsheet dapat menyalin hasil kueri ke spreadsheet pengguna. Untuk mengetahui detailnya, buka Kontrol akses.
Menyiapkan Looker untuk menganalisis data
Untuk menggunakan Sheet yang Terhubung dengan Looker, Anda harus mengaktifkan akses ke layanan yang tidak dikontrol satu per satu di konsol Google Admin. Untuk mengetahui informasi selengkapnya, lihat Mengelola akses ke layanan yang tidak dikontrol satu per satu. Selain itu, admin Looker harus mengaktifkan Sheet yang Terhubung terlebih dahulu di UI admin Looker. Untuk mendapatkan petunjuk lebih detail, lihat Menggunakan Sheet yang Terhubung untuk Looker.
Mengizinkan pengguna mendelegasikan akses ke Sheet yang Terhubung untuk BigQuery
Anda dapat mengizinkan pengguna mendelegasikan akses ke Sheet yang Terhubung untuk BigQuery sehingga mereka dapat berkolaborasi dengan pengguna lain untuk menganalisis data dan menjalankan kueri.
Untuk mendelegasikan akses, pengguna perlu membagikan sheet kepada pengguna lain. Namun, mereka tidak dapat mendelegasikan akses ke sheet yang dibagikan secara publik dengan link. Anda dapat meninjau pengguna yang mendelegasikan akses dan pengguna yang menjalankan kueri di peristiwa log Drive atau Cloud Audit Logs.
Mengaktifkan atau menonaktifkan akses yang didelegasikan
-
Login ke Konsol Google Admin.
Login menggunakan akun administrator (bukan yang diakhiri dengan @gmail.com).
-
Di konsol Admin, buka Menu
Aplikasi
Google Workspace
- Untuk Akses yang didelegasikan untuk Sheet yang Terhubung, klik Edit
.
- (Opsional) Guna menerapkan setelan hanya untuk beberapa pengguna, di bagian samping, pilih unit organisasi (sering digunakan untuk departemen) atau konfigurasi grup (lanjutan). Tunjukkan caranya
Setelan grup menggantikan unit organisasi. Pelajari lebih lanjut
- Untuk Setelan delegasi, centang atau hapus centang Izinkan pengguna yang memiliki akses edit ke spreadsheet untuk mengaktifkan delegasi akses bagi Sheet yang Terhubung.
- Jika Anda mengonfigurasi unit organisasi atau grup, pilih Hanya pengguna di unit organisasi atau grup tertentu yang dapat menggunakan delegasi.
- Jika Anda ingin mengizinkan pengguna yang memiliki akses ke sheet mendelegasikan akses, pilih Setiap pengguna dapat menggunakan delegasi.
Opsi ini mencakup pengguna di luar organisasi Anda jika mereka memiliki akses ke sheet.
-
Klik Simpan. Atau, Anda dapat mengklik Ganti untuk unit organisasi.
Untuk memulihkan nilai yang diwarisi nanti, klik Warisi (atau Tidak disetel, untuk grup).
Jika Anda mengaktifkan delegasi, beri tahu pengguna bahwa mereka dapat mengikuti langkah-langkah ini untuk mendelegasikan akses ke sheet.
Melihat peristiwa log untuk Sheet yang Terhubung
Saat Sheet yang Terhubung mengakses data BigQuery dan Looker, entri dicatat di peristiwa log Drive. Entri juga dicatat di Cloud Audit Logs untuk akses BigQuery dan di Penjelajahan Histori Aktivitas Sistem untuk akses Looker. Log menunjukkan siapa yang telah mengakses data dan kapan.
Menganalisis peristiwa log Drive menggunakan Reports APIUntuk mengetahui detail tentang cara menganalisis peristiwa log Drive dari konsol Google Admin, lihat Mengakses data peristiwa log Drive.
Dengan Reports API, Anda dapat melihat peristiwa Kueri Sheet yang Terhubung. Contoh berikut mengambil semua peristiwa Drive menurut jenis peristiwa Kueri Sheet yang Terhubung:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/drive?eventName=connected_sheets_query
Respons JSON lengkap terhadap panggilan API ini ditampilkan di bagian Respons JSON Lengkap di bawah pada halaman ini.
Pengguna yang memulai kueri akan ditampilkan sebagai pelaku.
"actor": {
"email": "collaborator@example.com",
"profileId": "user’s unique Google Workspace profile ID"
}
Spreadsheet memberikan informasi tambahan tentang kueri yang dijalankan sebagai parameter.
"parameters": [
{
"name": "execution_trigger",
"value": "sheets_ui"
},
{
"name": "query_type",
"value": "big_query"
},
{
"name": "data_connection_id",
"value": "The Cloud project ID"
},
{
"name": "execution_id",
"multiValue": [
"jobs/big_query_job_id"
]
},
{
"name": "delegating_principal",
"value": "trix01@scary.docsplustesting.com"
},
Kolom execution_trigger ditetapkan berdasarkan cara kueri dipanggil dari Spreadsheet:
| Label | Cara menjalankan kueri |
|---|---|
| sheets_ui | Secara manual melalui UI Spreadsheet |
| jadwal | Melalui fitur pembaruan terjadwal di Spreadsheet |
| api | Melalui Sheets API |
| apps script | Melalui Apps Script |
Kolom
query_type ditetapkan berdasarkan konektor data.| Label | Konektor data |
|---|---|
| big_query | BigQuery |
| looker | Looker |
Kolom data_connection_id ditetapkan berdasarkan ID koneksi data. Untuk BigQuery, ini adalah ID project penagihan. Untuk Looker, ini adalah URL instance.
execution_id ditetapkan berdasarkan ID kueri yang dijalankan.
| Struktur nilai | Entitas kueri |
|---|---|
| jobs/<JOB_ID> | Tugas BigQuery |
| datasets/<DATASET_NAME>/tables/<TABLE_NAME> | Tabel BigQuery |
| query_tasks/<QUERY_TASK_ID> | Kueri Looker |
Alamat email pengguna yang kredensialnya digunakan tersedia di log sebagai kolom delegating_principal.
Respons JSON lengkap
{
"kind": "admin#reports#activity",
"id": {
"time": "2022-10-26T17:33:51.929Z",
"uniqueQualifier": "report’s unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"email": "collaborator@example.com",
"profileId": "user’s unique Google Workspace profile ID"
},
"events": [
{
"type": "access",
"name": "connected_sheets_query",
"parameters": [
{
"name": "execution_trigger",
"value": "sheets_ui"
},
{
"name": "query_type",
"value": "big_query"
},
{
"name": "data_connection_id",
"value": "The Cloud project ID"
},
{
"name": "execution_id",
"multiValue": [
"jobs/big_query_job_id"
]
},
{
"name": "doc_id",
"value": "aBC-123-xYz"
},
{
"name": "doc_type",
"value": "spreadsheet"
},
{
"name": "is_encrypted",
"boolValue": false
},
{
"name": "doc_title",
"value": "Document title"
},
{
"name": "visibility",
"value": "shared_internally"
},
{
"name": "actor_is_collaborator_account",
"boolValue": false
},
{
"name": "delegating_principal",
"value": "owner@example.com"
},
{
"name": "owner",
"value": "owner@example.com"
},
{
"name": "owner_is_shared_drive",
"boolValue": false
},
{
"name": "owner_is_team_drive",
"boolValue": false
}
]
}
]
}
Setiap spreadsheet memiliki ID Spreadsheet unik yang ditemukan di URL spreadsheet. Entri log dalam format BigQueryAuditMetadata berisi ID spreadsheet tempat permintaan akses data BigQuery dikirim.
Anda dapat membuat kueri untuk mengambil dan menganalisis log menggunakan Logs Explorer di konsol Google Cloud. Di Logs Explorer, masukkan:
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId
!= NULL_VALUE
Kode ini menunjukkan entri dengan ID spreadsheet yang tidak kosong, seperti yang ditunjukkan dalam contoh berikut:
metadata: {
@type: "type.googleapis.com/google.cloud.audit.BigQueryAuditMetadata"
firstPartyAppMetadata: {
sheetsMetadata: {
docId: "aBC-123_xYz"
}
}
Spreadsheet menambahkan informasi untuk membuat kueri tugas menggunakan label tugas. Informasi ini dapat memberikan lebih banyak data untuk dianalisis, seperti yang ditunjukkan dalam contoh berikut:
jobInsertion: {
job: {
jobConfig: {
labels: {
sheets_access_type: "normal"
sheets_connector: "connected_sheets"
sheets_trigger: "user"
}
Nilai kolom sheets_trigger ditetapkan berdasarkan cara kueri dipanggil dari Spreadsheet:
| Label | Cara menjalankan kueri |
|---|---|
| pengguna | Secara manual melalui UI Spreadsheet |
| jadwal | Melalui fitur pembaruan terjadwal di Spreadsheet |
| api | Melalui Sheets API |
| apps script | Melalui Apps Script |
Misalnya, untuk menemukan entri yang sesuai dengan pembaruan terjadwal Sheet yang Terhubung, Anda dapat menggunakan kueri berikut di Logs Explorer:
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId
!= NULL_VALUE
protoPayload.metadata.jobInsertion.job.jobConfig.labels.sheets_trigger
= "schedule"
Jika akses yang didelegasikan diaktifkan, Anda dapat menemukan alamat email pengguna yang kredensialnya digunakan untuk menjalankan kueri di log. Anda juga dapat menemukan alamat email pengguna yang memicu kueri, seperti yang ditunjukkan dalam contoh berikut:
"authenticationInfo": {
"principalEmail": "pemilik@example.com",
"serviceAccountDelegationInfo": [
{
"firstPartyPrincipal": {
"principalEmail": "kolaborator@example.com",
"serviceMetadata": {
"service": "sheets"
}
}
}
]
}
Catatan: Kolom serviceAccountDelegationInfo hanya tersedia jika akses yang didelegasikan digunakan untuk kueri. Dalam hal ini, orang yang tercantum dalam principalEmail adalah orang yang mendelegasikan akses.
Untuk melihat dokumentasi yang lebih detail, buka Menggunakan Logs Explorer dan Membuat kueri di Logs Explorer.
Pelajari lebih lanjut log audit BigQuery, ID spreadsheet, format BigQueryAuditMetadata, SheetsMetadata, berbagi spreadsheet, dan Google Sheets API.
- Di instance Looker Anda, klik Jelajahi
- Untuk Temukan Kolom, masukkan Nama Klien API, lalu klik Filter
guna menambahkan kolom ini ke set data.
- Pada bagian Filter, pilih sama dengan dan di kolom di sampingnya, masukkan Sheet yang Terhubung.
- Untuk Temukan Kolom, masukkan ID Spreadsheet Sheet yang Terhubung guna menambahkan kolom ini ke set data.
- Untuk Temukan Kolom, masukkan Pemicu Sheet yang Terhubung guna menambahkan kolom ini ke set data.
- Untuk Temukan Kolom, masukkan Slug Histori guna menambahkan kolom ini ke set data.
- Slug Histori sama dengan QUERY_TASK_ID yang dicatat dalam peristiwa log Drive. Jika Anda ingin menemukan kueri tertentu di log Drive, tambahkan filter di kolom tersebut.
- (Opsional) Untuk menambahkan kolom lain, seperti Nama Pengguna dan Tanggal Pembuatan Histori, pilih set data tersebut.
- (Opsional) Untuk menambahkan filter, pilih filter yang diinginkan.
Misalnya, Anda dapat memfilter Tanggal Pembuatan Histori ke dalam 7 hari terakhir, atau Anda dapat memfilter di ID Spreadsheet tertentu untuk hanya melihat kueri Looker yang dimulai dari ID spreadsheet tertentu. - Klik Jalankan.
Pemecahan masalah
Jika Spreadsheet errorDi bagian atas sheet, klik Kirim Masukan.
Di file Spreadsheet, klik Perbarui untuk mengambil pembaruan pada data BigQuery ke Sheet yang Terhubung. Untuk memperbarui setiap item dalam Sheet yang Terhubung, klik DataKonektor data
Perbarui data
Perbarui semua.
Jika Anda menyiapkan izin tertentu pada file Spreadsheet untuk organisasi, seperti membatasi pengguna di luar organisasi untuk mengakses file Spreadsheet, pengguna tersebut tidak akan dapat membuka file Sheet yang Terhubung. Untuk mengubah izin, lihat Menetapkan izin berbagi pengguna Drive.
Jika Anda masih mengalami masalah, lihat Memperbaiki masalah data BigQuery di Google Spreadsheet dan Memecahkan masalah Sheet yang Terhubung untuk Looker.
