Menghapus label
Anda dapat menghapus label dari set data, tabel, atau tampilan dengan:
- Menggunakan konsol Google Cloud
- Menggunakan pernyataan DDL SQL
- Menggunakan perintah
bq update
alat command line bq - Memanggil metode API
datasets.patch
atautables.patch
- Menggunakan library klien
Sebelum memulai
Berikan peran Identity and Access Management (IAM) yang memberi pengguna izin yang diperlukan untuk melakukan setiap tugas dalam dokumen ini. Izin yang diperlukan untuk melakukan tugas (jika ada) tercantum di bagian "Izin yang diperlukan" pada tugas tersebut.
Menghapus label set data
Bagian berikut menentukan izin dan langkah-langkah untuk menghapus label set data.
Izin yang diperlukan
Untuk menghapus label set data, Anda memerlukan izin IAM berikut:
bigquery.datasets.get
bigquery.datasets.update
Setiap peran IAM bawaan berikut menyertakan izin yang Anda perlukan untuk menghapus label set data:
roles/bigquery.dataOwner
roles/bigquery.admin
Selain itu, jika memiliki izin bigquery.datasets.create
, Anda dapat menghapus label set data yang dibuat.
Untuk mengetahui informasi selengkapnya tentang peran dan izin IAM di BigQuery, lihat Peran dan izin bawaan.
Menghapus label set data
Untuk menghapus label dari set data, pilih salah satu opsi berikut:
Konsol
Di Konsol Google Cloud, pilih set data.
Di halaman detail set data, klik ikon pensil di sebelah kanan Label.
Pada dialog Edit label:
- Untuk setiap label yang ingin Anda hapus, klik hapus (X).
- Untuk menyimpan perubahan, klik Perbarui.
SQL
Gunakan
pernyataan DDL ALTER SCHEMA SET OPTIONS
untuk menetapkan label pada set data yang ada. Menetapkan label akan menimpa
label yang ada di set data. Contoh berikut menghapus semua label pada
set data mydataset
:
Di Konsol Google Cloud, buka halaman BigQuery.
Di editor kueri, masukkan pernyataan berikut:
ALTER SCHEMA mydataset SET OPTIONS (labels = []);
Klik
Run.
Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.
bq
Untuk menghapus label set data, berikan perintah bq update
dengan
flag clear_label
. Ulangi flag untuk menghapus beberapa label.
Jika set data berada dalam project selain project default Anda, tambahkan
project ID ke set data dalam format berikut:
project_id:dataset
.
bq update \ --clear_label key \ project_id:dataset
Dengan keterangan:
- key adalah kunci untuk label yang ingin Anda hapus.
- project_id adalah project ID Anda.
- dataset adalah set data yang Anda perbarui.
Contoh:
Untuk menghapus label department:shipping
dari mydataset
, masukkan
perintah bq update
dengan flag --clear_label
. mydataset
ada dalam
project default Anda.
bq update --clear_label department mydataset
Untuk menghapus label department:shipping
dari mydataset
di
myotherproject
, masukkan perintah bq update
dengan flag
--clear_label
.
bq update --clear_label department myotherproject:mydataset
Untuk menghapus beberapa label dari set data, ulangi flag clear_label
dan
tentukan setiap kunci label. Misalnya, untuk menghapus label
department:shipping
dan label cost_center:logistics
dari mydataset
di project
default Anda, masukkan:
bq update \
--clear_label department \
--clear_label cost_center \
mydataset
Untuk setiap contoh ini, outputnya akan terlihat seperti berikut:
Dataset 'myproject:mydataset' successfully updated.
API
Agar dapat menghapus label tertentu untuk set data yang ada, panggil metode
datasets.patch
dan perbarui properti labels
untuk resource set data
dengan menyetel nilai kunci label ke null
.
Untuk menghapus semua label dari set data, panggil metode
datasets.patch
dan hapus properti labels
.
Karena metode datasets.update
menggantikan seluruh resource set data,
metode datasets.patch
akan dipilih.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Go API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Java API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Node.js API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Python API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Menghapus label tabel atau tampilan
Anda dapat menghapus label tabel atau tampilan dengan cara berikut:
- Menggunakan konsol Google Cloud
- Menggunakan pernyataan DDL SQL
- Menggunakan perintah
bq update
alat command line bq - Memanggil metode API
tables.patch
- Karena tampilan diperlakukan seperti resource tabel,
tables.patch
digunakan untuk mengubah tampilan dan tabel.
- Karena tampilan diperlakukan seperti resource tabel,
- Menggunakan library klien
Izin yang diperlukan
Untuk menghapus label tabel atau tampilan, Anda memerlukan izin IAM berikut:
bigquery.tables.get
bigquery.tables.update
Setiap peran IAM bawaan berikut menyertakan izin yang diperlukan untuk menghapus label tabel atau tampilan:
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
Selain itu, jika memiliki izin bigquery.datasets.create
, Anda dapat menghapus label tabel dan tampilan di set data yang Anda buat.
Untuk mengetahui informasi selengkapnya tentang peran dan izin IAM di BigQuery, lihat Peran dan izin bawaan.
Menghapus label tabel atau tampilan
Untuk menghapus label dari tabel atau tampilan, pilih salah satu opsi berikut:
Konsol
Di konsol Google Cloud, pilih set data.
Klik tab Detail, lalu klik ikon pensil di sebelah kanan Label.
Pada dialog Edit label:
Untuk setiap label yang ingin Anda hapus, klik hapus (X).
Untuk menyimpan perubahan, klik Perbarui.
SQL
Gunakan
pernyataan DDL ALTER TABLE SET OPTIONS
untuk menetapkan label pada tabel yang ada, atau
pernyataan DDL ALTER VIEW SET OPTIONS
untuk menetapkan label pada tampilan yang ada. Menetapkan label akan menimpa
label yang ada di tabel atau tampilan. Contoh berikut akan menghapus semua
label dari tabel mytable
:
Di Konsol Google Cloud, buka halaman BigQuery.
Di editor kueri, masukkan pernyataan berikut:
ALTER TABLE mydataset.mytable SET OPTIONS (labels = []);
Klik
Run.
Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.
bq
Untuk menghapus label dari tabel atau tampilan, berikan perintah bq update
dengan
flag clear_label
. Ulangi flag untuk menghapus beberapa label.
Jika tabel atau tampilan berada dalam project selain project default Anda, tambahkan
project ID ke set data dalam format berikut:
project_id:dataset
.
bq update \ --clear_label key \ project_id:dataset.table_or_view
Dengan keterangan:
- key adalah kunci untuk label yang ingin Anda hapus.
- project_id adalah project ID Anda.
- dataset adalah set data yang Anda perbarui.
- table_or_view adalah nama tabel atau tampilan yang Anda perbarui.
Contoh:
Untuk menghapus label department:shipping
dari mydataset.mytable
, masukkan
perintah bq update
dengan flag --clear_label
. mydataset
ada dalam
project default Anda.
bq update --clear_label department mydataset.mytable
Untuk menghapus label department:shipping
dari mydataset.myview
di
myotherproject
, masukkan perintah bq update
dengan flag
--clear_label
.
bq update --clear_label department myotherproject:mydataset.myview
Untuk menghapus beberapa label dari tabel atau tampilan, ulangi flag
clear_label
dan tentukan setiap kunci label. Misalnya, untuk menghapus
label department:shipping
dan label cost_center:logistics
dari
mydataset.mytable
di project default Anda, masukkan:
bq update \
--clear_label department \
--clear_label cost_center \
mydataset.mytable
Untuk setiap contoh ini, outputnya akan terlihat seperti berikut:
Table 'myproject:mydataset.mytable' successfully updated.
API
Untuk menghapus label tertentu untuk tabel atau tampilan yang ada, panggil metode
tables.patch
dan perbarui properti labels
untuk resource tabel
dengan menyetel nilai kunci label ke null
.
Untuk menghapus semua label dari tabel atau tampilan, panggil metode
tables.patch
dan hapus properti labels
.
Karena tampilan diperlakukan seperti resource tabel, Anda harus menggunakan metode
tables.patch
untuk mengubah tampilan dan tabel. Selain itu, karena metode tables.update
menggantikan seluruh resource set data, sebaiknya gunakan metode
tables.patch
.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Go API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Java API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Node.js API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Python API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Menghapus label tugas
Saat ini, menghapus label dari tugas yang ada tidak didukung.
Langkah selanjutnya
- Pelajari cara menambahkan label ke resource BigQuery.
- Pelajari cara melihat label pada resource BigQuery.
- Pelajari cara memperbarui label pada resource BigQuery.
- Pelajari cara memfilter resource menggunakan label.
- Baca tentang Menggunakan label di dokumentasi Resource Manager.