Standardkonfigurationseinstellungen verwalten

Mit den Standardkonfigurationseinstellungen in BigQuery können Sie in Ihrer Organisation die Sicherheit durchsetzen, Kosten kontrollieren und die Abfrageleistung optimieren. Als BigQuery-Administrator oder Projektinhaber können Sie diese Standardeinstellungen auf Organisations- und Projektebene festlegen, entfernen und abrufen oder für einzelne Sitzungen und Jobs überschreiben.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Angeben oder Abrufen von Konfigurationseinstellungen benötigen:

  • Konfigurationseinstellungen angeben: BigQuery-Administrator (roles/bigquery.admin) für Ihre Organisation oder Ihr Projekt
  • Konfigurationseinstellungen abrufen: BigQuery Job User (roles/bigquery.jobUser) für das angegebene Projekt

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Angeben oder Abrufen von Konfigurationseinstellungen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Konfigurationseinstellungen anzugeben oder abzurufen:

  • Konfigurationseinstellungen angeben: bigquery.config.update für Ihre Organisation oder Ihr Projekt
  • Konfigurationseinstellungen abrufen: bigquery.config.get für das angegebene Projekt

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Weitere Informationen zu IAM-Rollen und Berechtigungen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Globale Einstellungen festlegen

Globale Einstellungen gelten für alle Standorte und verwenden kein region-REGION.-Präfix. Im Gegensatz dazu gelten regionale Einstellungen nur für einen bestimmten Standort. Sie können globale Einstellungen auf Organisations- oder Projektebene festlegen. Der Standardstandort (default_location) ist die einzige globale Einstellung, die Sie konfigurieren können.

Wenn Sie keinen Standort explizit angeben, wird der Standort auf eine der folgenden Arten bestimmt:

  • Der Speicherort der Datasets, auf die in der Anfrage verwiesen wird. Wenn beispielsweise eine Abfrage auf eine Tabelle oder Ansicht in einem Dataset verweist, das in der Region asia-northeast1 gespeichert ist, wird der Abfragejob in asia-northeast1 ausgeführt.
  • Die Region, die für eine in einer Anfrage referenzierte Verbindung angegeben wurde.
  • Der Standort einer Zieltabelle.

Wenn der Standort nicht explizit angegeben ist und nicht anhand der Ressourcen in der Anfrage ermittelt werden kann, wird der Standardstandort verwendet. Wenn kein Standardspeicherort festgelegt ist, wird der Job in der multiregionalen Region US ausgeführt.

Beschränkungen

Für globale Konfigurationseinstellungen gelten die folgenden Einschränkungen:

  • Globale Organisations- und Projekteinstellungen werden in BigQuery Omni-Standorten nicht unterstützt. Sie können default_location nicht auf einen BigQuery Omni-Standort festlegen und keine globalen Einstellungen an einem BigQuery Omni-Standort konfigurieren oder ansehen.
  • Sie können globale und regionale Einstellungen nicht in derselben ALTER ORGANIZATION SET OPTIONS- oder ALTER PROJECT SET OPTIONS-DDL-Anweisung kombinieren.
  • Wenn Sie die globale Einstellung für default_location ändern, kann es bis zu 10 Minuten dauern, bis die Änderung übernommen wird. Bis die Einstellung übernommen wird, leitet BigQuery Jobs, die auf dem Standardstandort basieren, möglicherweise an den vorherigen Standardstandort weiter.

Globale Organisationseinstellungen konfigurieren

Sie können globale Einstellungen auf Organisationsebene mit der DDL-Anweisung ALTER ORGANIZATION SET OPTIONS konfigurieren. Der Standardspeicherort (default_location) ist die einzige globale Einstellung, die Sie auf Organisationsebene konfigurieren können. Alle anderen Einstellungen auf Organisationsebene sind regionale Einstellungen.

Die DDL-Anweisung ALTER ORGANIZATION SET OPTIONS gilt für die Organisation, zu der das aktuelle Projekt gehört.

So konfigurieren Sie die Einstellung default_location auf Organisationsebene:

Console

  1. Rufen Sie in der Google Cloud Console die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie auf search_insights Unbenannte Abfrage, um den Abfrageeditor zu öffnen.

  3. Geben Sie die folgende DDL-Anweisung in den Abfrageeditor ein, um die Einstellung default_location zu konfigurieren:

      ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

    Ersetzen Sie LOCATION durch einen regionalen oder multiregionalen BigQuery-Standort. Dieser Wert ist der Standort, den BigQuery zum Ausführen von Jobs verwendet, wenn der Jobstandort nicht aus der Anfrage abgeleitet werden kann, z. B. wenn eine Abfrage keine Datasets oder Verbindungen referenziert.

  4. Alternativ können Sie die default_location-Einstellung auf Organisationsebene entfernen, indem Sie die folgende DDL-Anweisung in den Abfrageeditor eingeben:

      ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );

  5. Klicken Sie auf Ausführen.

bq

Wenn Sie die Einstellung default_location auf Organisationsebene konfigurieren möchten, geben Sie den Befehl bq query mit dem auf false gesetzten Flag --use_legacy_sql ein und geben Sie die folgende DDL-Anweisung als Abfrageparameter an:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Ersetzen Sie LOCATION durch einen regionalen oder multiregionalen BigQuery-Standort. Dieser Wert ist der Standort, den BigQuery zum Ausführen von Jobs verwendet, wenn der Jobstandort nicht aus der Anfrage abgeleitet werden kann, z. B. wenn eine Abfrage keine Datasets oder Verbindungen referenziert.

Alternativ können Sie die Einstellung default_location auf Organisationsebene entfernen. Geben Sie dazu den Befehl bq query mit dem Flag --use_legacy_sql auf false gesetzt ein und geben Sie die folgende DDL-Anweisung als Abfrageparameter an:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );

API

Rufen Sie die Methode jobs.query auf und geben Sie die DDL-Anweisung im Attribut query des Anfragetextes an.

Globale Projekteinstellungen konfigurieren

Sie können globale Einstellungen auf Projektebene mit der DDL-Anweisung ALTER PROJECT SET OPTIONS konfigurieren. Der Standardspeicherort (default_location) ist die einzige globale Einstellung, die Sie auf Projektebene konfigurieren können. Alle anderen Einstellungen auf Projektebene sind regionale Einstellungen.

Die DDL-Anweisung ALTER PROJECT SET OPTIONS akzeptiert optional die Variable PROJECT_ID. Wenn Sie PROJECT_ID nicht angeben, wird die Anweisung standardmäßig auf das Projekt angewendet, in dem Sie die DDL-Anweisung ALTER PROJECT ausführen.

Konfigurationen auf Projektebene überschreiben Konfigurationen auf Organisationsebene. Konfigurationen auf Sitzungsebene können wiederum Konfigurationen auf Projektebene überschreiben und Konfigurationen auf Jobebene können Konfigurationen auf Sitzungsebene überschreiben.

So konfigurieren Sie die Einstellung default_location auf Projektebene:

Console

  1. Rufen Sie in der Google Cloud Console die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie auf search_insights Unbenannte Abfrage, um den Abfrageeditor zu öffnen.

  3. Geben Sie die folgende DDL-Anweisung in den Abfrageeditor ein, um die Einstellung default_location zu konfigurieren:

      ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Projekt-ID.

    • LOCATION: Eine BigQuery-Region oder ein BigQuery-Multiregion-Standort. Dieser Wert ist der Ort, an dem BigQuery Jobs ausführt, wenn der Jobort nicht aus der Anfrage abgeleitet werden kann, z. B. wenn in einer Abfrage keine Datasets oder Verbindungen referenziert werden.

  4. Alternativ können Sie die Einstellung default_location auf Projektebene entfernen, indem Sie die folgende DDL-Anweisung in den Abfrageeditor eingeben:

      ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );

    Wenn Sie die Einstellung default_location auf Projektebene entfernen, verwendet BigQuery die Standardeinstellung auf Organisationsebene, sofern vorhanden, oder die Standardeinstellung des Systems.

  5. Klicken Sie auf Ausführen.

bq

Wenn Sie die Einstellung default_location auf Projektebene konfigurieren möchten, geben Sie den Befehl bq query mit dem Flag --use_legacy_sql auf false ein und geben Sie die folgende DDL-Anweisung als Abfrageparameter an:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: Eine BigQuery-Region oder ein multiregionaler Standort. Dieser Wert ist der Ort, an dem BigQuery Jobs ausführt, wenn der Jobstandort nicht aus der Anfrage abgeleitet werden kann, z. B. wenn in einer Abfrage keine Datasets oder Verbindungen referenziert werden.

Alternativ können Sie die Einstellung default_location auf Projektebene entfernen. Geben Sie dazu den Befehl bq query mit dem Flag --use_legacy_sql auf false ein und geben Sie die folgende DDL-Anweisung als Abfrageparameter an:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );

Wenn Sie die Einstellung default_location auf Projektebene entfernen, verwendet BigQuery die Standardeinstellung auf Organisationsebene, falls vorhanden, oder die Standardeinstellung des Systems.

API

Rufen Sie die Methode jobs.query auf und geben Sie die DDL-Anweisung im Attribut query des Anfragetextes an.

Regionale Einstellungen angeben

Regionale Einstellungen gelten für einen bestimmten Standort und erfordern das Präfix region-REGION.. Sie können regionale Einstellungen auf Organisations- oder Projektebene konfigurieren.

Reservierungs- und Abrechnungseinstellungen

Sie können regionale Einstellungen auf Projektebene konfigurieren, um zu steuern, wie für Abfragen Reservierungen oder die On-Demand-Abrechnung verwendet werden. Diese Einstellungen tragen zur Kostenprognose bei, indem sie entweder eine flexible Reservierungsnutzung ermöglichen oder erfordern, dass für Abfragen Reservierungsslots verwendet werden.

Zu den gängigen Reservierungs- und Abrechnungssteuerungen gehören reservation_override_mode (Vorabversion) und disable_on_demand_billing (Vorabversion). Informationen zum Konfigurieren dieser Einstellungen finden Sie unter Regionale Projekteinstellungen konfigurieren. Eine vollständige Liste der Projektoptionen finden Sie in der ALTER PROJECT SET OPTIONS-Optionsliste.

Regionale Organisationseinstellungen konfigurieren

Mit der DDL-Anweisung ALTER ORGANIZATION SET OPTIONS können Sie regionale Einstellungen auf Organisationsebene konfigurieren. Sie müssen die Region angeben, in der die jeweilige Organisationseinstellung gilt. Sie können nur eine Region in einer Anweisung verwenden.

In den Beispielen in diesem Abschnitt werden die folgenden standardmäßigen regionalen Organisationseinstellungen angegeben:

  • Zeitzone: America/Chicago
  • Cloud KMS-Schlüssel: ein benutzerdefinierter Schlüssel
  • Zeitlimit für Abfragen: 30 Minuten (1.800.000 Millisekunden)
  • Zeitlimit für die Warteschlange für interaktive Abfragen: 10 Minuten (600.000 Millisekunden)
  • Zeitlimit der Warteschlange für Batchabfragen: 20 Minuten (1.200.000 Millisekunden)
  • Tabellenspeicher und Suchindex-INFORMATION_SCHEMA-Ansichten (enable_info_schema_storage): aktiviert

Weitere Informationen zu allen regionalen Organisationseinstellungen finden Sie unter organization_set_options_list.

So konfigurieren Sie regionale Organisationseinstellungen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie auf search_insights Unbenannte Abfrage, um den Abfrageeditor zu öffnen.

  3. Geben Sie die folgende DDL-Anweisung in den Abfrageeditor ein, um die regionalen Organisationseinstellungen zu konfigurieren:

      ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);

    Ersetzen Sie Folgendes:

    • REGION: die BigQuery-Region, die Ihrem Projekt oder Ihrer Organisation zugeordnet ist, z. B. us oder europe-west6. Der Wert für REGION muss für jede Option im Befehl gleich sein.
    • KMS_KEY: ein benutzerdefinierter Cloud KMS-Schlüssel. Weitere Informationen finden Sie unter Kundenverwaltete Cloud KMS-Schlüssel.

  4. Alternativ können Sie die regionalen Organisationseinstellungen entfernen, indem Sie die folgende DDL-Anweisung in den Abfrageeditor eingeben:

      ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

  5. Klicken Sie auf Ausführen.

bq

Geben Sie zum Konfigurieren der regionalen Organisationseinstellungen den Befehl bq query mit dem Flag --use_legacy_sql auf false ein und geben Sie die folgende DDL-Anweisung als Abfrageparameter an:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);

Ersetzen Sie Folgendes:

  • REGION: die BigQuery-Region, die Ihrem Projekt oder Ihrer Organisation zugeordnet ist, z. B. us oder europe-west6. Der Wert für REGION muss für jede Option im Befehl gleich sein.
  • KMS_KEY: ein benutzerdefinierter Cloud KMS-Schlüssel. Weitere Informationen finden Sie unter Kundenverwaltete Cloud KMS-Schlüssel.

Alternativ können Sie die regionalen Organisationseinstellungen entfernen, indem Sie den Befehl bq query mit dem Flag --use_legacy_sql auf false festlegen und die folgende DDL-Anweisung als Abfrageparameter angeben:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

Rufen Sie die Methode jobs.query auf und geben Sie die DDL-Anweisung im Attribut query des Anfragetextes an.

Regionale Projekteinstellungen konfigurieren

Sie können regionale Einstellungen auf Projektebene mit der DDL-Anweisung ALTER PROJECT SET OPTIONS konfigurieren. Sie müssen die Region angeben, in der die jeweilige Projekteinstellung gilt. Sie können nur eine Region in einer Anweisung verwenden.

Konfigurationen auf Projektebene überschreiben Konfigurationen auf Organisationsebene. Konfigurationen auf Sitzungsebene können wiederum Konfigurationen auf Projektebene überschreiben und Konfigurationen auf Jobebene können Konfigurationen auf Sitzungsebene überschreiben.

Die DDL-Anweisung ALTER PROJECT SET OPTIONS akzeptiert optional die Variable PROJECT_ID. Wenn Sie PROJECT_ID nicht angeben, wird die Anweisung standardmäßig auf das Projekt angewendet, in dem Sie die DDL-Anweisung ALTER PROJECT ausführen.

In den Beispielen in diesem Abschnitt werden die folgenden regionalen Standardprojekteinstellungen angegeben:

  • Zeitzone: America/Los_Angeles
  • Cloud KMS-Schlüssel: ein benutzerdefinierter Schlüssel
  • Zeitlimit für Abfragen: 1 Stunde (3.600.000 Millisekunden)
  • Zeitlimit für die Warteschlange für interaktive Abfragen: 10 Minuten (600.000 Millisekunden)
  • Zeitlimit der Warteschlange für Batchabfragen: 20 Minuten (1.200.000 Millisekunden)
  • Reservierungsbasierte Fairness: aktiviert
  • Globale Abfragen: aktiviert für die Ausführung und den Zugriff auf Daten
  • Tabellenspeicher und Suchindex INFORMATION_SCHEMA-Ansichten (enable_info_schema_storage): aktiviert

Weitere Informationen zu allen regionalen Projekteinstellungen finden Sie unter project_set_options_list.

So konfigurieren Sie regionale Projekteinstellungen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie auf search_insights Unbenannte Abfrage, um den Abfrageeditor zu öffnen.

  3. Geben Sie die folgende DDL-Anweisung in den Abfrageeditor ein, um die regionalen Projekteinstellungen zu konfigurieren:

     ALTER PROJECT PROJECT_ID
 SET OPTIONS (
 `region-REGION.default_time_zone` = 'America/Los_Angeles',
 -- Ensure all service accounts under the project have permission to KMS_KEY
 `region-REGION.default_kms_key_name` = KMS_KEY,
 `region-REGION.default_query_job_timeout_ms` = 3600000,
 `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
 `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
 `region-REGION.enable_reservation_based_fairness` = true,
 `region-REGION.enable_global_queries_execution` = true,
 `region-REGION.enable_global_queries_data_access` = true,
 `region-REGION.enable_info_schema_storage` = true);

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Projekt-ID.
    • REGION: die BigQuery-Region, die mit Ihrem Projekt oder Ihrer Organisation verknüpft ist, z. B. us oder europe-west6. Der Wert für REGION muss für jede Option im Befehl gleich sein.
    • KMS_KEY: ein benutzerdefinierter Cloud KMS-Schlüssel. Weitere Informationen finden Sie unter Kundenverwaltete Cloud KMS-Schlüssel.

  4. Alternativ können Sie die folgenden DDL-Anweisung in den Abfrageeditor eingeben, um die regionalen Projekteinstellungen zu entfernen:

      ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

  5. Klicken Sie auf Ausführen.

bq

Geben Sie zum Konfigurieren der regionalen Projekteinstellungen den Befehl bq query mit dem auf false gesetzten Flag --use_legacy_sql ein und geben Sie die folgende DDL-Anweisung als Abfrageparameter an:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = 'America/Los_Angeles',
  -- Ensure all service accounts under the project have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 3600000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_reservation_based_fairness` = true,
  `region-REGION.enable_global_queries_execution` = true,
  `region-REGION.enable_global_queries_data_access` = true,
  `region-REGION.enable_info_schema_storage` = true);

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • REGION: die BigQuery-Region, die mit Ihrem Projekt oder Ihrer Organisation verknüpft ist, z. B. us oder europe-west6. Der Wert für REGION muss für jede Option im Befehl gleich sein.
  • KMS_KEY: ein benutzerdefinierter Cloud KMS-Schlüssel. Weitere Informationen finden Sie unter Kundenverwaltete Cloud KMS-Schlüssel.

Alternativ können Sie die regionalen Projekteinstellungen entfernen, indem Sie den Befehl bq query mit dem Flag --use_legacy_sql auf false festlegen und die folgende DDL-Anweisung als Abfrageparameter angeben:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

Rufen Sie die Methode jobs.query auf und geben Sie die DDL-Anweisung im Attribut query des Anfragetextes an.

Konfigurationseinstellungen abrufen

Sie können die Konfigurationseinstellungen für eine Organisation oder ein Projekt mit den folgenden INFORMATION_SCHEMA-Ansichten aufrufen:

Es kann einige Minuten dauern, bis neue Konfigurationen wirksam werden und in den INFORMATION_SCHEMA-Ansichten angezeigt werden.

Beispielabfragen zum Abrufen von Einstellungen

Mit den folgenden Beispielabfragen können Sie Ihre Projekt- und Organisationseinstellungen aus den INFORMATION_SCHEMA-Ansichten abrufen.

Globale Einstellungen ansehen

Führen Sie die folgende Abfrage aus, um alle globalen Organisationseinstellungen aufzurufen:

SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Führen Sie die folgende Abfrage aus, um nur die Organisationseinstellung default_location aufzurufen:

SELECT
    option_value
FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS
WHERE option_name = 'default_location'

Führen Sie die folgende Abfrage aus, um alle effektiven globalen Konfigurationen für Ihr Standardprojekt aufzurufen:

SELECT * FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Wenn Sie nur die effektive default_location-Einstellung für Ihr Standardprojekt aufrufen möchten, führen Sie die folgende Abfrage aus:

SELECT
    option_value
FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
WHERE option_name = 'default_location'

Führen Sie die folgende Abfrage aus, um alle globalen Konfigurationen für Ihr Standardprojekt aufzurufen:

SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;

Wenn Sie nur die default_location-Einstellung für Ihr Standardprojekt aufrufen möchten, führen Sie die folgende Abfrage aus:

SELECT
    option_value
FROM INFORMATION_SCHEMA.PROJECT_OPTIONS
WHERE option_name = 'default_location'

Regionale Einstellungen ansehen

Führen Sie folgende Abfrage aus, um die Konfigurationen unter einer Organisation in der us-Region anzuzeigen:

SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Führen Sie folgende Abfrage aus, um die effektiven Konfigurationen unter Ihrem Standardprojekt in der us-Region aufzurufen:

SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Wenn Sie die Konfigurationen unter Ihrem Standardprojekt in der us-Region aufrufen möchten, führen Sie folgende Abfrage aus:

SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Standardkonfigurationseinstellungen

In den folgenden Abschnitten werden die Konfigurationseinstellungen beschrieben, die Sie angeben können.

Einstellungen für die Abfrage- und Jobausführung

Mit den folgenden Einstellungen können Sie steuern, wie Abfragen ausgeführt, zeitlich geplant und in die Warteschlange gestellt werden.

  • default_batch_query_queue_timeout_ms: Die Standardzeit in Millisekunden, die eine Batchabfrage in einer Abfragewarteschlange wartet. Wenn nicht festgelegt, beträgt die Standardeinstellung 24 Stunden. Der Mindestwert beträgt 1 Millisekunde. Der Höchstwert beträgt 48 Stunden. Wenn Sie die Warteschlange für Batchabfragen deaktivieren möchten, setzen Sie den Wert auf -1.

  • default_interactive_query_queue_timeout_ms: Die Standardzeit in Millisekunden, die eine interaktive Abfrage in einer Abfragewarteschlange wartet. Wenn nicht festgelegt, beträgt die Standardeinstellung 6 Stunden. Der Mindestwert beträgt 1 Millisekunde und der Höchstwert 48 Stunden. Wenn Sie die Warteschlange für interaktive Abfragen deaktivieren möchten, legen Sie den Wert auf -1 fest.

  • default_query_job_timeout_ms: Die Standardzeit, nach der ein Abfragejob das Zeitlimit überschreitet, einschließlich der Zeit, in der der Job in der Warteschlange steht, und der Zeit, in der er ausgeführt wird. Das Zeitlimit muss zwischen 5 Minuten und 48 Stunden liegen. Dieses Zeitlimit gilt nur für einzelne Abfragejobs und die untergeordneten Jobs von Skripts. Wenn Sie ein Zeitlimit für Skriptjobs festlegen möchten, verwenden Sie die API-Methode jobs.insert und legen Sie das Feld jobTimeoutMs fest.

  • default_location: Die Konfigurationseinstellung default_location wird verwendet, um Jobs auszuführen, wenn der Standort nicht festgelegt ist oder nicht bestimmt werden kann. Wenn default_location nicht festgelegt ist, wird der Job am multiregionalen Standort US ausgeführt. Weitere Informationen finden Sie unter Standorte angeben.

  • enable_reservation_based_fairness: Die Option, die bestimmt, wie inaktive Slots freigegeben werden. Bei Verwaltungsprojekten, die nach dem 10. Oktober 2026 erstellt wurden, ist diese Option standardmäßig aktiviert (TRUE). Bei Projekten, die vor dem 10. Oktober 2026 erstellt wurden, ist der Standardwert FALSE. Das bedeutet, dass inaktive Slots gleichmäßig auf alle Abfrageprojekte verteilt werden. Wenn Sie diese Option aktivieren, werden inaktive Slots zuerst gleichmäßig auf alle Reservierungen und dann auf die Projekte innerhalb jeder Reservierung verteilt. Weitere Informationen finden Sie unter Reservierungsbasierte Fairness. Diese Option wird nur auf Projektebene unterstützt. Sie können sie nicht auf Organisations- oder Jobebene angeben.

  • default_time_zone: Standardzeitzone, die in zeitzonenabhängigen GoogleSQL-Funktionen verwendet wird, wenn keine Zeitzone als Argument angegeben ist. Diese Konfiguration gilt nicht für nach Zeiteinheit partitionierte Tabellen (die die Zeitzone UTC verwenden), für Übertragungen des Storage Transfer Service oder das Laden von Daten mit dem bq-Befehlszeilentool. Weitere Informationen finden Sie unter Zeitzonen.

  • default_query_optimizer_options: Die verlaufsbasierten Abfrageoptimierungen. Mögliche Optionen:

    • 'adaptive=on': Verwenden Sie verlaufsbasierte Abfrageoptimierungen.
    • 'adaptive=off': Verwenden Sie keine verlaufsbasierten Abfrageoptimierungen.
    • NULL (Standardeinstellung): Verwenden Sie die Standardeinstellung für die verlaufsbasierte Abfrageoptimierung, die 'adaptive=on' entspricht.

  • default_sql_dialect_option: Der Standard-SQL-Abfragedialekt für die Ausführung von Abfragejobs mit dem bq-Befehlszeilentool oder der BigQuery API. Das Ändern dieser Einstellung wirkt sich nicht auf den Standarddialekt in der Konsole aus. Mögliche Optionen:

    • 'default_legacy_sql' (Standard): Legacy-SQL verwenden, wenn der Abfragedialekt nicht auf Jobebene angegeben ist.
    • 'default_google_sql': GoogleSQL wird verwendet, wenn der Abfragedialekt nicht auf Jobebene angegeben ist.
    • 'only_google_sql': GoogleSQL wird verwendet, wenn der Abfragedialekt nicht auf Jobebene angegeben ist. Jobs ablehnen, deren Abfragedialekt auf Legacy-SQL festgelegt ist.
    • NULL: Verwenden Sie die Standardeinstellung für den Abfragedialekt, die 'default_legacy_sql' entspricht.

  • enable_global_queries_execution: Die Option, die bestimmt, ob globale Abfragen ausgeführt werden können. Der Standardwert ist FALSE. Das bedeutet, dass globale Abfragen nicht aktiviert sind.

  • enable_global_queries_data_access: Die Option, mit der festgelegt wird, ob globale Abfragen auf Daten zugreifen können, die in der Region gespeichert sind. Der Standardwert ist FALSE. Das bedeutet, dass bei globalen Abfragen keine Daten aus dieser Region kopiert werden können, unabhängig vom Projekt, in dem sie ausgeführt werden.

  • reusable_column_aliases_mode: Die Option, die bestimmt, ob wiederverwendbare Spalten-Aliasse für Abfragen aktiviert sind. Der Standardwert ist off. Das bedeutet, dass keine wiederverwendbaren Spaltenaliase aktiviert sind. Weitere Informationen finden Sie unter Wiederverwendbare Spaltenaliase.

Einstellungen für die Datenverwaltung

Verwenden Sie die folgenden Einstellungen, um Regeln für die Datenerstellung, die Sicherheit und den Lebenszyklus zu definieren.

  • default_column_name_character_map: Der Standardbereich und die Standardbehandlung von Zeichen in Spaltennamen. Falls nicht festgelegt, schlagen Ladejobs, die nicht unterstützte Zeichen in Spaltennamen verwenden, mit einer Fehlermeldung fehl. Einige ältere Tabellen sind möglicherweise so festgelegt, dass nicht unterstützte Zeichen in Spaltennamen ersetzt werden. Weitere Informationen finden Sie unter load_option_list.

  • default_data_policy_projects: Die Standardliste der Projekte, deren Datenrichtlinien ausgewertet werden, wenn auf Spalten zugegriffen wird, die durch Data Governance-Tags geschützt sind. Standardmäßig werden nur die Datenrichtlinien des Projekts der Tabelle ausgewertet. Wenn Sie ein Standardprojekt für Datenrichtlinien auf Organisationsebene konfigurieren, wertet BigQuery sowohl die Datenrichtlinien des Projekts der Tabelle als auch die des Standardprojekts für Datenrichtlinien aus. Wenn in beiden Projekten widersprüchliche Richtlinien vorhanden sind, haben die Datenrichtlinien im Projekt der Tabelle Vorrang. Sie können diese Einstellung nur auf Organisationsebene mit der ALTER ORGANIZATION SET OPTIONS-Anweisung konfigurieren, z. B. region-us.default_data_policy_projects = ["my_default_project"]. Weitere Informationen finden Sie unter Standardprojekt für Datenrichtlinien konfigurieren.

  • default_kms_key_name: Der standardmäßige Cloud Key Management Service-Schlüssel zum Verschlüsseln von Tabellendaten, einschließlich temporärer oder anonymer Tabellen. Weitere Informationen finden Sie unter Kundenverwaltete Cloud KMS-Schlüssel.

  • default_max_time_travel_hours: Das Standardzeitfenster für neue Datasets in Stunden. Die Dauer muss zwischen 48 und 168 (inklusiv) liegen und durch 24 teilbar sein. Eine Änderung der standardmäßigen maximalen Zeitreisestunden wirkt sich nicht auf vorhandene Datasets aus. Weitere Informationen finden Sie unter Zeitreise und Datenaufbewahrung.

  • enable_info_schema_storage: Die Option, die Zugriff auf die Ansichten INFORMATION_SCHEMA.TABLE_STORAGE und SEARCH_INDEXES und ihre Varianten bietet. Diese Option ist standardmäßig nicht aktiviert. Wenn Sie diese Ansichten zum ersten Mal abfragen, ohne diese Option auf TRUE festzulegen, schlägt die Abfrage fehl und Sie erhalten eine Anleitung zum Aktivieren der Option. Nachdem Sie diese Option aktiviert haben, werden Abfragen sofort ausgeführt und geben Daten zurück, die ab diesem Zeitpunkt generiert wurden. Es kann etwa einen Tag dauern, bis ein vollständiger Backfill von Verlaufsdaten in den Ansichten verfügbar ist. Wenn Sie diese Ansichten verwendet haben, bevor diese Einstellung eingeführt wurde, ist diese Option bereits aktiviert.

Kosten- und Ressourceneinstellungen

Mit den folgenden Einstellungen können Sie festlegen, wie Ressourcen abgerechnet und verbunden werden.

  • default_storage_billing_model: Das Standardspeicherabrechnungsmodell für neue Datasets. Legen Sie den Wert auf PHYSICAL fest, um physische Bytes bei der Berechnung der Speichergebühren zu verwenden, oder auf LOGICAL, um logische Byte zu verwenden. Eine Änderung des Standardspeicherabrechnungsmodells hat keine Auswirkungen auf vorhandene Datasets. Weitere Informationen finden Sie unter Abrechnungsmodelle für Speicher.
  • default_cloud_resource_connection_id: Die Standardverbindung, die beim Erstellen von Tabellen und Modellen verwendet wird. Geben Sie nur die ID oder den Namen der Verbindung an und schließen Sie die angehängte Projekt-ID und die Regionspräfixe aus. Wenn Sie Standardverbindungen verwenden, aktualisiert BigQuery möglicherweise die Berechtigungen, die dem Dienstkonto der Verbindung gewährt wurden, je nach Typ der Tabelle oder des Modells, das Sie erstellen. Weitere Informationen finden Sie unter Standardverbindung – Übersicht.
  • reservation_override_mode (Vorabversion): Gibt an, wie Abfragereservierungen in der Region (z. B. 'ALLOW_ANY_OVERRIDE') überschrieben werden können. Weitere Informationen finden Sie in der Liste der ALTER PROJECT SET OPTIONS-Optionen.
  • disable_on_demand_billing (Vorabversion): Bestimmt, ob die On-Demand-Abrechnung für Abfragen in der Region deaktiviert ist. Bei true müssen alle Abfragen eine zugewiesene Reservierung verwenden, da sie sonst fehlschlagen. Weitere Informationen finden Sie in der Liste der ALTER PROJECT SET OPTIONS-Optionen.
  • preflight_fluid_autoscaling_reservations: Die Liste der Reservierungen, für die die fluide Skalierung für die sekundengenaue Abrechnung ohne Mindestdauer aktiviert ist. Weitere Informationen finden Sie unter Reservierungen.

Preise

Für die Nutzung des BigQuery-Konfigurationsdienstes fallen keine zusätzlichen Gebühren an. Weitere Informationen finden Sie unter BigQuery-Preise.