Mengelola dependensi BigQuery API

Anda dapat mengelola perilaku BigQuery dengan memahami pengaruh setiap API terhadap fitur Google Cloud yang bergantung pada API tersebut. Beberapa layanan API diaktifkan secara default di setiap project Google Cloud yang Anda buat, sementara layanan lainnya diaktifkan secara otomatis untuk semua project Google Cloud yang menggunakan BigQuery. Anda harus mengaktifkan layanan API yang tersisa secara eksplisit sebelum dapat menggunakan fungsinya.

Menonaktifkan dependensi secara tidak benar dapat memengaruhi fungsi BigQuery. Pahami dependensi ini untuk membuat keputusan yang tepat saat Anda mengaktifkan atau menonaktifkan layanan di project Google Cloud Anda.

Layanan diaktifkan secara default

Layanan berikut diaktifkan secara default untuk setiap project Google Cloud baru:

Layanan	Nama API	Fitur yang mengandalkannya	Efek menonaktifkan layanan ini
BigQuery sharing	analyticshub.googleapis.com	Memublikasikan pertukaran data Memublikasikan listingan dan mengelola langganan Ruang bersih data	Anda tidak dapat membuat atau mengelola pertukaran data, listingan, ruang bersih data, atau langganan. Anda tidak dapat menelusuri dan menjelajahi bursa atau listingan yang dibuat oleh penyedia lain. Langganan yang dibuat tetap ada, tetapi tidak dapat diakses. Set data tertaut dapat diakses selama BigQuery API diaktifkan. Anda tidak dapat membuat langganan baru
BigQuery Connection API	bigqueryconnection.googleapis.com	Kueri gabungan ke data yang disimpan di luar BigQuery Tabel dan set data eksternal BigQuery metastore	Anda tidak dapat mengelola koneksi eksternal. Anda tidak dapat membuat model jarak jauh. Anda tidak dapat membuat fungsi jarak jauh. Anda tidak dapat mengkueri tabel BigLake dan tabel objek.
BigQuery Migration Service	bigquerymigration.googleapis.com	Penilaian migrasi data Terjemahan kueri SQL	Anda tidak dapat membuat tugas atau penilaian migrasi. Tugas atau penilaian yang ada tidak tersedia. Catatan: Biasanya Anda dapat menonaktifkan layanan ini setelah menyelesaikan migrasi data.
BigQuery Data Policy	bigquerydatapolicy.googleapis.com	Penyamaran data	Anda tidak dapat mengelola kebijakan penyamaran data. Kebijakan penyamaran data tidak dihapus, tetapi kueri ke tabel yang menerapkan penyamaran data akan gagal.
BigQuery Data Transfer Service	bigquerydatatransfer.googleapis.com	Transfer data terjadwal	Anda tidak dapat mengelola transfer data terjadwal. Transfer data yang ada akan berhenti.
BigQuery Reservation API	bigqueryreservation.googleapis.com	Pengelolaan workload berbasis kapasitas	Anda tidak dapat membuat atau mengelola komitmen kapasitas, pemesanan, atau penetapan. Anda tidak dapat memantau penggunaan slot. Failover disaster recovery tidak tersedia. Penskalaan otomatis slot berhenti.
BigQuery Storage API	bigquerystorage.googleapis.com	Penyerapan data streaming Pemuatan data batch Pengambilan data perubahan	Anda tidak dapat menggunakan Storage Read API atau Storage Write API (gRPC) untuk mengakses data BigQuery Anda.
Dataform	dataform.googleapis.com	Dataform menyediakan repositori kode yang dimanfaatkan oleh fitur berikut: Pipeline BigQuery Kueri tersimpan Notebook Colab Dataform Persiapan data Kanvas data	Anda tidak dapat membuat pipeline, kueri tersimpan, notebook Colab, kanvas data, persiapan data, atau project Dataform. Pipeline, notebook, atau project Dataform terjadwal yang ada akan berhenti. Semua pipeline, kueri tersimpan, notebook Colab, kanvas data, persiapan data, atau project Dataform yang ada tidak dapat diakses.
Knowledge Catalog	dataplex.googleapis.com	Knowledge Catalog menyediakan kemampuan pembuatan katalog dan tata kelola data yang digunakan oleh hal berikut: Resource Explorer di BigQuery Studio Pelengkapan otomatis di editor SQL BigQuery Studio Penelusuran BigQuery Sharing (sebelumnya Analytics Hub) untuk listingan Insight profil Pemindaian kualitas data Melihat silsilah data Insight tabel dan set data Kanvas data	Penelusuran aset data BigQuery tidak tersedia. Penelusuran listingan berbagi tidak tersedia. Anda tidak dapat membuat insight profil, pemindaian kualitas data, atau saran kueri baru atau mengakses yang telah dibuat sebelumnya. Anda tidak dapat melihat detail aset data di grafik silsilah. Anda tidak dapat menelusuri aset data di kanvas data.

Efek menonaktifkan BigQuery API

Menonaktifkan BigQuery API juga akan menonaktifkan layanan berikut yang bergantung pada BigQuery API:

• Otorisasi Biner (binaryauthorization.googleapis.com)
• Google Kubernetes Engine (container.googleapis.com)
• Google Cloud API (cloudapis.googleapis.com)
• Dataprep by Trifacta (dataprep.googleapis.com)
• Open Service Broker untuk Google Cloud (servicebroker.googleapis.com)
• Data Fabric Telekomunikasi (telecomdatafabric.googleapis.com)

Layanan yang diaktifkan oleh BigQuery Unified API

BigQuery Unified API (bigqueryunified.googleapis.com) mencakup kumpulan layanan pilihan yang diperlukan agar berbagai fitur BigQuery dapat berfungsi. Jika Anda mengaktifkan BigQuery Unified API, semua layanan ini akan diaktifkan secara bersamaan. Google dapat mengupdate layanan dalam koleksi ini, dan layanan tersebut akan otomatis diaktifkan di project yang mengaktifkan API ini. Anda dapat menonaktifkan setiap layanan dan API.

Untuk mengetahui petunjuk cara mengaktifkan bigqueryunified.googleapis.com, lihat Mengaktifkan dan menonaktifkan layanan.

Layanan	Nama API	Fitur yang mengandalkannya	Efek menonaktifkan layanan ini
Vertex AI	aiplatform.googleapis.com	Notebook Colab Model jarak jauh BigQuery ML	Anda tidak akan dapat menjalankan notebook. Model jarak jauh BigQuery ML yang ada akan berhenti berfungsi. Notebook yang ada tetap dapat diakses untuk diedit.
BigQuery Unified API	bigqueryunified.googleapis.com	Menyediakan aktivasi sekali klik untuk layanan dependen BigQuery yang tercantum dalam dokumen ini, tidak termasuk API cloudaicompanion, composer, dan datalineage. Memastikan dependensi BigQuery baru diaktifkan di project Anda.	Dependensi mendatang tidak diaktifkan secara otomatis dalam project Anda.
Compute Engine	compute.googleapis.com	Google Compute Engine menyediakan lingkungan runtime untuk semua fitur yang disediakan oleh Managed Service untuk Apache Spark dan Gemini Enterprise Agent Platform.	Notebook Colab, model ML jarak jauh, Apache Spark, SparkSQL, dan tugas PySpark akan berhenti. Kode sumber tetap tersedia. Dataproc API dinonaktifkan.
Managed Service untuk Apache Spark	dataproc.googleapis.com	Buat kueri data dengan mesin open source seperti Apache Spark. Gunakan Spark SQL atau PySpark dengan Managed Service untuk Apache Spark. Gunakan prosedur tersimpan untuk Spark.	Anda tidak dapat membuat cluster Managed Service untuk Apache Spark guna menjalankan analisis data open source. Anda tidak dapat menjalankan workload Managed Service untuk Apache Spark. Anda tidak dapat menjalankan workload Spark di BigQuery.
Datastream	datastream.googleapis.com	Menyediakan pengambilan data perubahan dan replikasi ke BigQuery.	Semua aliran data dijeda dan tidak dapat diakses.

Layanan dinonaktifkan secara default

Anda harus mengaktifkan layanan berikut secara manual agar kemampuan yang sesuai tersedia:

Layanan	Nama API	Fitur yang mengandalkannya	Efek menonaktifkan layanan ini
Gemini for Google Cloud API	cloudaicompanion.googleapis.com	Fitur Gemini di BigQuery	Fitur penyelesaian, pembuatan, dan penjelasan kode berhenti berfungsi. Pelajari lebih lanjut cara menonaktifkan Gemini di BigQuery.
Managed Service untuk Apache Airflow	composer.googleapis.com	Menjadwalkan workload	DAG Managed Service untuk Apache Airflow yang ada tidak tercantum di halaman Penjadwalan dan berhenti. Lingkungan Managed Airflow yang ada menjadi tidak beroperasi, berhenti berfungsi, dan menampilkan status error.
Data Lineage API	datalineage.googleapis.com	Perekaman dan tampilan silsilah data	Silsilah data tidak dicatat untuk project Anda. Anda tidak dapat melihat grafik silsilah.

Mengaktifkan aset kode BigQuery secara manual

Untuk mengelola aset kode di BigQuery, seperti notebook dan kueri tersimpan, Anda harus mengaktifkan API berikut:

• Compute Engine API
• Dataform API
• Vertex AI API

Sebelum Maret 2024, API ini tidak diaktifkan secara otomatis secara default. Jika Anda memiliki skrip otomatisasi dari sebelum Maret 2024 yang bergantung pada status API ini, Anda mungkin perlu mengupdatenya. Jika sudah mengaktifkan API ini, Anda akan melihat folder Notebooks dan Queries baru di panel Explorer di BigQuery.

Sebelum memulai

Untuk mengaktifkan pengelolaan aset kode secara manual, Anda harus memiliki peran Owner Identity and Access Management (IAM) (roles/owner).

Mengaktifkan aset kode BigQuery secara manual

Untuk mengaktifkan dependensi API yang diperlukan untuk aset kode, ikuti langkah-langkah berikut:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di Studio, di bilah tab panel editor, klik panah drop-down di samping tanda +, tahan kursor di atas Notebook, lalu pilih Empty notebook.

3. Klik Enable APIs.

   Jika Anda tidak melihat opsi ini, periksa apakah Anda memiliki peran Owner IAM yang diperlukan (roles/owner). Jika notebook kosong terbuka, berarti Anda sudah mengaktifkan API yang diperlukan.

4. Di panel Aktifkan fitur inti, di bagian API fitur inti, lakukan hal berikut:

   1. Untuk mengaktifkan semua dependensi BigQuery untuk streaming data, penjadwalan, dan notebook, di samping BigQuery Unified API, klik Enable.
   2. Opsional: Untuk memilih API yang akan diaktifkan, klik View and enable individual APIs, lalu klik Enable di samping setiap API yang ingin Anda aktifkan.
   3. Setelah API diaktifkan, klik Next.

5. Opsional: Tetapkan izin pengguna di bagian Permissions:

   • Untuk memberi akun utama kemampuan membuat aset kode, serta membaca, mengedit, dan menetapkan izin untuk aset kode yang mereka buat, ketik nama pengguna atau grup di kolom BigQuery Studio User.
   • Untuk memberi akun utama kemampuan membaca, mengedit, dan menetapkan izin untuk semua aset kode yang dibagikan kepada mereka, ketik nama pengguna atau grup di kolom BigQuery Studio Admin.

6. Klik Berikutnya.

7. Opsional: Di bagian Additional APIs, klik Enable all guna mengaktifkan API yang diperlukan untuk membuat prosedur jarak jauh BigQuery menggunakan BigQuery DataFrames.

8. Jika Anda memilih untuk tidak mengaktifkan API tambahan, klik Close untuk menutup panel Enable core features.

Membatasi akses ke aset kode

Anda dapat membantu mencegah pengaktifan API tambahan dengan menetapkan batasan kebijakan organisasi Batasi Penggunaan Layanan Resource. Anda dapat menonaktifkan API yang dipilih kapan saja.

Apa langkah selanjutnya?

• Untuk mempelajari cara mengelola layanan Google Cloud , lihat Mengaktifkan dan menonaktifkan layanan.
• Untuk mempelajari cara mengelola akses API di tingkat terperinci dengan batasan kebijakan organisasi, lihat Membatasi penggunaan resource.
• Untuk mempelajari cara mengontrol akses ke layanan dengan peran dan izin Identity and Access Management (IAM) untuk BigQuery, lihat Peran dan izin IAM BigQuery.