Mengelola dependensi BigQuery API

Anda dapat mengelola perilaku BigQuery dengan memahami pengaruh setiap API terhadap fitur yang bergantung pada API tersebut. Google Cloud Beberapa layanan API diaktifkan secara default di setiap project yang Anda buat, sementara layanan lainnya diaktifkan secara otomatis untuk semua project yang menggunakan BigQuery. Google Cloud Google Cloud 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 .

Layanan yang diaktifkan secara default

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

Layanan Fitur mana yang mengandalkannya Efek menonaktifkan layanan ini
analyticshub.googleapis.com
  • 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
bigqueryconnection.googleapis.com
  • Anda tidak dapat mengelola koneksi eksternal.
  • Anda tidak dapat membuat model jarak jauh.
  • Anda tidak dapat membuat fungsi jarak jauh.
  • Anda tidak dapat membuat kueri tabel BigLake dan tabel objek.
bigquerymigration.googleapis.com
  • 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.
bigquerydatapolicy.googleapis.com
  • Anda tidak dapat mengelola kebijakan penyamaran data Anda.
  • Kebijakan penyamaran data tidak dihapus, tetapi kueri ke tabel dengan penyamaran data yang diterapkan akan gagal.
bigquerydatatransfer.googleapis.com
  • Anda tidak dapat mengelola transfer data terjadwal.
  • Transfer data yang ada akan berhenti.
bigqueryreservation.googleapis.com
  • Anda tidak dapat membuat atau mengelola komitmen kapasitas, reservasi, atau penetapan.
  • Anda tidak dapat memantau penggunaan slot.
  • Failover disaster recovery tidak tersedia.
  • Penskalaan otomatis slot berhenti.
bigquerystorage.googleapis.com
dataform.googleapis.com
  • Anda tidak dapat membuat pipeline, kueri tersimpan, notebook Colab, kanvas data, persiapan data, atau project Dataform.
  • Pipeline terjadwal, notebook, atau project Dataform yang ada akan berhenti.
  • Semua pipeline yang ada, kueri tersimpan, notebook Colab, kanvas data, persiapan data, atau project Dataform menjadi tidak dapat diakses.
dataplex.googleapis.com
  • Penelusuran aset data BigQuery tidak tersedia.
  • Penelusuran listingan berbagi tidak tersedia.
  • Anda tidak dapat membuat atau mengakses insight profil, pemindaian kualitas data, atau saran kueri yang dibuat sebelumnya.
  • Anda tidak dapat melihat detail aset data pada 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:

  • binaryauthorization.googleapis.com
  • container.googleapis.com
  • cloudapis.googleapis.com
  • dataprep.googleapis.com
  • servicebroker.googleapis.com
  • 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 kumpulan ini, dan layanan tersebut akan otomatis diaktifkan di project yang mengaktifkan API ini. Anda dapat menonaktifkan setiap layanan dan API.

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

Layanan Fitur mana yang mengandalkannya Efek menonaktifkan layanan ini
aiplatform.googleapis.com
  • Anda tidak akan dapat menjalankan notebook.
  • Semua model jarak jauh BigQuery ML yang ada akan berhenti berfungsi.
  • Notebook yang ada tetap dapat diakses untuk diedit.
bigqueryunified.googleapis.com
  • Menyediakan aktivasi sekali klik untuk layanan dependen BigQuery yang tercantum dalam dokumen ini, kecuali API cloudaicompanion, composer, dan datalineage.
  • Memastikan dependensi BigQuery baru diaktifkan di project Anda.
  • Dependensi mendatang tidak otomatis diaktifkan di project Anda.
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, tugas Apache Spark, SparkSQL, dan PySpark akan berhenti.
  • Kode sumber tetap tersedia.
  • Dataproc API dinonaktifkan.
dataproc.googleapis.com
  • 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 Spark di workload BigQuery.
datastream.googleapis.com
  • 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 Fitur mana yang mengandalkannya Efek menonaktifkan layanan ini
cloudaicompanion.googleapis.com
  • Fitur Gemini di BigQuery
composer.googleapis.com
  • 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.
datalineage.googleapis.com
  • Silsilah data tidak direkam 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 memperbaruinya. 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 Pemilik 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 tab panel editor, klik drop-down panah di samping tanda +, arahkan kursor ke Notebook, lalu pilih Empty notebook.

  3. Klik Enable APIs.

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

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

    1. Untuk mengaktifkan semua dependensi BigQuery untuk streaming data, penjadwalan, dan notebook, klik Aktifkan di samping BigQuery Unified API.
    2. Opsional: Untuk memilih API yang akan diaktifkan, klik Lihat dan aktifkan API satu per satu lalu klik Aktifkan 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 Pengguna BigQuery Studio.
    • 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 Admin BigQuery Studio.

  6. Klik Berikutnya.

  7. Opsional: Di bagian Additional APIs, klik Enable all untuk mengaktifkan API yang diperlukan guna 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?