Diese Seite wurde von der Cloud Translation API übersetzt.

Standardverbindung – Übersicht

Um Ihren Workflow zu vereinfachen, können Sie in BigQuery Standard-Cloud-Ressourcenverbindungen zum Erstellen von Tabellen und Modellen konfigurieren.

BigQuery unterstützt Standardverbindungen in den folgenden Tabellen und Modellen:

Administratoren konfigurieren die standardmäßige Cloud-Ressourcen-Verbindung für ein Projekt.

Wenn Sie Tabellen und Modelle in einem Projekt erstellen, können Sie die Standardverbindung auswählen, die von Administratoren konfiguriert wurde. Geben Sie dazu DEFAULT in den folgenden SQL-Klauseln an:

Die WITH CONNECTION-Klausel einer CREATE TABLE-Anweisung
In der REMOTE WITH CONNECTION-Klausel einer CREATE MODEL-Anweisung.

Wenn Sie kein Administrator sind, können Sie die Berechtigungen oder andere Konfigurationen der Standardverbindung nicht ändern. Stattdessen wird die Standardverbindung automatisch auf eine vorhandene Verbindung aufgelöst, auf die in der Projektkonfiguration verwiesen wird. Dadurch erhält die Verbindung die erforderlichen Berechtigungen und Ressourcen.

Hinweise

Enable the BigQuery Connection API.

Enable the API

Erforderliche Rollen und Berechtigungen

Informationen zu den erforderlichen Rollen und Berechtigungen zum Konfigurieren und Verwenden von Standardverbindungen in BigQuery finden Sie unter Verbindungen verwalten.

Berechtigungsbereitstellung bei Verwendung von `CONNECTION DEFAULT`

Je nach Art der Tabelle oder des Modells, das Sie mit der Standardverbindung erstellen, aktualisiertGoogle Cloud automatisch die Rollen, die dem Dienstkonto der Verbindung zugewiesen sind. Dem Dienstkonto werden für die Verbindung mit diesen Tabellen und Modellen automatisch die folgenden Rollen zugewiesen:

Tabellen- oder Modelltyp	Remote-Ressource	Rollen, die dem Dienstkonto der Verbindung zugewiesen sind
BigLake-Tabelle in Cloud Storage	Cloud Storage	`roles/storage.legacyBucketReader` `roles/storage.legacyObjectReader`
Objekttabelle	Cloud Storage	`roles/storage.legacyBucketReader` `roles/storage.legacyObjectReader`
BigQuery-Tabellen für Iceberg	Cloud Storage	`roles/storage.legacyBucketWriter` `roles/storage.legacyObjectOwner`
BigQuery ML-Remote-Modelle über Vertex AI-Modelle	Von Google gehostete Modelle	`roles/aiplatform.user`
	Aus Model Garden auf einem Endpunkt bereitstellbar
	Nutzermodelle
	Abgestimmte Modelle	`roles/aiplatform.serviceAgent`
BigQuery ML-Remote-Modelle über Cloud AI-Dienste	Dokumentenprozessor	`roles/documentai.apiUser`
	Spracherkennung	`roles/speech.serviceAgent`
	Cloud NLP	`roles/serviceusage.serviceUsageConsumer`
	Cloud Vision	`roles/serviceusage.serviceUsageConsumer`
	Cloud Translation	`roles/cloudtranslate.user`

Standardverbindung für ein Projekt konfigurieren

Konfigurieren Sie als Administrator die Standard-Cloud-Ressourcenverbindung für das Projekt:

Verwenden Sie die DDL-Anweisung ALTER PROJECT SET OPTIONS, um die Standard-Cloud-Ressourcenverbindung zu erstellen und zu konfigurieren.

Im folgenden Beispiel wird die Standardverbindung für das Projekt konfiguriert:
```
ALTER PROJECT PROJECT_ID
SET OPTIONS (
`region-REGION.default_cloud_resource_connection_id` = CONNECTION_ID);
```
Ersetzen Sie Folgendes:
- PROJECT_ID: die ID des Projekts, in dem Sie die Standardverbindung festlegen.
- REGION: die Region der Verbindung.
- CONNECTION_ID: die ID oder der Name der Verbindung, die als Standard für Tabellen und Modelle verwendet werden soll. Geben Sie nur die Verbindungs-ID oder den Verbindungsnamen an und schließen Sie die Projekt-ID und die Regionspräfixe aus, die mit dem Namen oder der ID verknüpft sind.

Weitere Informationen zum Konfigurieren einer Standardverbindung für ein Projekt finden Sie unter Standardkonfigurationen verwalten.

Tabellen mit `CONNECTION DEFAULT` erstellen

In den folgenden Beispielen wird gezeigt, wie Sie Tabellen erstellen, in denen WITH CONNECTION DEFAULT in BigQuery angegeben ist.

Beispiel: BigLake-Tabelle in Cloud Storage erstellen

Mit dem folgenden SQL-Ausdruck wird eine Cloud Storage BigLake-Tabelle mit einer Standardverbindung erstellt:

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

Beispiel: Objekttabelle mit Standardverbindung erstellen

Mit dem folgenden SQL-Ausdruck wird eine Objekttabelle mit einer Standardverbindung erstellt:

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

Beispiel: BigQuery-Tabelle für Iceberg mit einer Standardverbindung erstellen

Mit dem folgenden SQL-Ausdruck wird eine BigQuery-Tabelle für Iceberg mit einer Standardverbindung erstellt:

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');

Modelle mit `REMOTE WITH CONNECTION DEFAULT` erstellen

In den folgenden Beispielen wird gezeigt, wie Sie Modelle erstellen, in denen REMOTE WITH CONNECTION DEFAULT in BigQuery angegeben wird.

Beispiel: Remote-Modell über ein Vertex AI-Modell erstellen

Mit dem folgenden SQL-Ausdruck wird ein Remote-Modell mit einer Standardverbindung erstellt:

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

Beispiel: Remote-Modell über einen Cloud AI-Dienst erstellen