Ringkasan koneksi default

Untuk menyederhanakan alur kerja, Anda dapat mengonfigurasi koneksi resource Cloud default di BigQuery untuk membuat tabel dan model.

BigQuery mendukung koneksi default dalam tabel dan model berikut:

Administrator mengonfigurasi koneksi resource Cloud default untuk project.

Jika membuat tabel dan model dalam project, Anda dapat memilih koneksi default yang telah dikonfigurasi oleh administrator dengan menentukan DEFAULT dalam klausa SQL berikut:

Jika bukan administrator, Anda tidak dapat mengubah izin koneksi default atau konfigurasi lainnya. Sebagai gantinya, koneksi default otomatis di-resolve ke koneksi yang ada yang dirujuk dalam konfigurasi project, sehingga memberikan izin dan resource yang diperlukan ke koneksi tersebut.

Sebelum memulai

Enable the BigQuery Connection API.

Enable the API

Peran dan izin yang diperlukan

Untuk mengetahui peran dan izin yang diperlukan guna mengonfigurasi dan menggunakan koneksi default di BigQuery, lihat Mengelola koneksi.

Penyediaan izin saat menggunakan CONNECTION DEFAULT

Bergantung pada jenis tabel atau model yang Anda buat dengan koneksi default, Google Cloud akan otomatis memperbarui peran yang ditetapkan ke akun layanan koneksi. Peran berikut diberikan secara otomatis ke akun layanan untuk koneksi tabel dan model ini:

Jenis tabel atau model Referensi jarak jauh Peran yang ditetapkan ke akun layanan koneksi
Tabel BigLake Cloud Storage Cloud Storage roles/storage.legacyBucketReader
roles/storage.legacyObjectReader
Tabel Objek Cloud Storage roles/storage.legacyBucketReader
roles/storage.legacyObjectReader
Tabel BigQuery untuk Iceberg Cloud Storage roles/storage.legacyBucketWriter
roles/storage.legacyObjectOwner
Model jarak jauh BigQuery ML melalui model Vertex AI Model milik Google roles/aiplatform.user
Dapat di-deploy ke endpoint dari Model Garden
Model pengguna
Model yang disesuaikan roles/aiplatform.serviceAgent
Model jarak jauh BigQuery ML melalui layanan Cloud AI Pemroses dokumen roles/documentai.apiUser
Pengenal ucapan roles/speech.serviceAgent
Cloud NLP roles/serviceusage.serviceUsageConsumer
Cloud Vision roles/serviceusage.serviceUsageConsumer
Cloud Translation roles/cloudtranslate.user

Mengonfigurasi koneksi default untuk project

Sebagai administrator, konfigurasikan koneksi resource Cloud default untuk project:

  • Untuk membuat dan mengonfigurasi koneksi resource Cloud default, gunakan pernyataan DDL ALTER PROJECT SET OPTIONS.

    Contoh berikut mengonfigurasi koneksi default untuk project:

    ALTER PROJECT PROJECT_ID
SET OPTIONS (
`region-REGION.default_cloud_resource_connection_id` = CONNECTION_ID);

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat Anda menetapkan koneksi default.
    • REGION: region koneksi.
    • CONNECTION_ID: ID atau nama koneksi yang akan digunakan sebagai default untuk tabel dan model. Hanya tentukan ID atau nama koneksi, dan kecualikan project ID dan awalan region yang dilampirkan ke nama atau ID.

Untuk informasi selengkapnya tentang cara mengonfigurasi koneksi default untuk project, lihat Mengelola konfigurasi default.

Membuat tabel menggunakan CONNECTION DEFAULT

Contoh berikut menunjukkan cara membuat tabel yang menentukan WITH CONNECTION DEFAULT di BigQuery.

Contoh: Membuat tabel BigLake Cloud Storage

Ekspresi SQL berikut membuat tabel BigLake Cloud Storage dengan koneksi default:

CREATE EXTERNAL TABLE PROJECT_ID.DATASET.EXTERNAL_TABLE_NAME
WITH CONNECTION DEFAULT
OPTIONS (
  format = 'TABLE_FORMAT',
  uris = ['BUCKET_PATH']);

Contoh: Membuat tabel objek dengan koneksi default

Ekspresi SQL berikut membuat tabel objek dengan koneksi default:

CREATE EXTERNAL TABLE PROJECT_ID.DATASET.EXTERNAL_TABLE_NAME
WITH CONNECTION DEFAULT
OPTIONS (
  object_metadata = 'SIMPLE'
  uris = ['BUCKET_PATH']);

Contoh: Membuat tabel BigQuery untuk Iceberg dengan koneksi default

Ekspresi SQL berikut membuat tabel BigQuery untuk Iceberg dengan koneksi default:

CREATE TABLE `myproject.tpch_clustered.nation` (
  n_nationkey integer,
  n_name string,
  n_regionkey integer,
  n_comment string)
CLUSTER BY n_nationkey
WITH CONNECTION DEFAULT
OPTIONS (
  file_format = 'PARQUET',
  table_format = 'ICEBERG',
  storage_uri = 'gs://mybucket/warehouse/nation');

Membuat model menggunakan REMOTE WITH CONNECTION DEFAULT

Contoh berikut menunjukkan cara membuat model yang menentukan REMOTE WITH CONNECTION DEFAULT di BigQuery.

Contoh: Membuat model jarak jauh melalui model Vertex AI

Ekspresi SQL berikut membuat model jarak jauh dengan koneksi default:

CREATE OR REPLACE MODEL `mydataset.flash_model`
  REMOTE WITH CONNECTION DEFAULT
  OPTIONS(ENDPOINT = 'gemini-1.5-flash-001');

Contoh: Membuat model jarak jauh melalui layanan Cloud AI

Ekspresi SQL berikut membuat SERVICE model jarak jauh dengan koneksi default:

CREATE MODEL `project_id.mydataset.mymodel`
REMOTE WITH CONNECTION DEFAULT
 OPTIONS(REMOTE_SERVICE_TYPE = 'CLOUD_AI_VISION_V1')

Contoh: Membuat model jarak jauh dengan endpoint HTTPS

Ekspresi SQL berikut membuat model jarak jauh dengan endpoint HTTPS dan koneksi default:

CREATE MODEL `project_id.mydataset.mymodel`
 INPUT(f1 INT64, f2 FLOAT64, f3 STRING, f4 ARRAY)
 OUTPUT(out1 INT64, out2 INT64)
 REMOTE WITH CONNECTION DEFAULT
 OPTIONS(ENDPOINT = 'https://us-central1-aiplatform.googleapis.com/v1/projects/myproject/locations/us-central1/endpoints/1234')

Langkah berikutnya