Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Einführung in INFORMATION_SCHEMA von BigQuery

Die INFORMATION_SCHEMA-Ansichten von BigQuery sind schreibgeschützte, systemdefinierte Ansichten, die Metadateninformationen über Ihre BigQuery-Objekte enthalten. In der folgenden Tabelle sind alle INFORMATION_SCHEMA-Ansichten aufgeführt, die Sie abfragen können, um Metadateninformationen abzurufen:

Ressourcentyp INFORMATION_SCHEMA-Ansicht
Zugriffssteuerung OBJECT_PRIVILEGES
BI-Reservierungen BI_CAPACITIES
BI_CAPACITY_CHANGES
Konfigurationsoptionen EFFECTIVE_PROJECT_OPTIONS
ORGANIZATION_OPTIONS
PROJECT_OPTIONS
Datasets SCHEMATA
Dataset-Optionen SCHEMATA_OPTIONS
Indexmetadaten SEARCH_INDEXES
SEARCH_INDEXES_COLUMNS
Jobmetadaten JOBS_BY_PROJECT
JOBS_BY_USER
JOBS_BY_FOLDER
JOBS_BY_ORGANIZATION
Jobs-Metadaten nach Zeitabschnitt JOBS_TIMELINE_BY_PROJECT
JOBS_TIMELINE_BY_USER
JOBS_TIMELINE_BY_FOLDER
JOBS_TIMELINE_BY_ORGANIZATION
Reservierungsmetadaten RESERVATIONS_BY_PROJECT
RESERVATION_CHANGES_BY_PROJECT
RESERVATIONS_TIMELINE_BY_PROJECT
ASSIGNMENTS_BY_PROJECT
ASSIGNMENT_CHANGES_BY_PROJECT
CAPACITY_COMMITMENTS_BY_PROJECT
CAPACITY_COMMITMENT_CHANGES_BY_PROJECT
Routinen ROUTINES
Routineoptionen ROUTINE_OPTIONS
Routineparameter PARAMETERS
Sitzungsmetadaten SESSIONS_BY_PROJECT
SESSIONS_BY_USER
Das Streaming von Daten STREAMING_TIMELINE_BY_PROJECT
STREAMING_TIMELINE_BY_FOLDER
STREAMING_TIMELINE_BY_ORGANIZATION
Tabellenmetadaten TABLES
TABLE_OPTIONS
Tabellenspalten COLUMNS
COLUMN_FIELD_PATHS
Tabellenpartitionen PARTITIONS
Tabellen-Snapshots TABLE_SNAPSHOT
Tabellenspeichernutzung (aktuell) TABLE_STORAGE_BY_PROJECT
TABLE_STORAGE_BY_ORGANIZATION
Tabellenspeichernutzung im Zeitverlauf TABLE_STORAGE_TIMELINE_BY_PROJECT
TABLE_STORAGE_TIMELINE_BY_ORGANIZATION
Aufrufe VIEWS

Bei *BY_PROJECT-Ansichten ist das Suffix BY_PROJECT optional. Beim Abfragen von INFORMATION_SCHEMA.JOBS_BY_PROJECT und INFORMATION_SCHEMA.JOBS werden beispielsweise dieselben Ergebnisse zurückgegeben.

Preise

Bei Projekten mit On-Demand-Preisen fallen für Abfragen von INFORMATION_SCHEMA-Ansichten Datenverarbeitungsgebühren für mindestens 10 MB an. Dies gilt auch, wenn von der Abfrage weniger als 10 MB verarbeitet werden. 10 MB ist der Mindestrechnungsbetrag für On-Demand-Abfragen. Weitere Informationen finden Sie unter On-Demand-Preise.

Bei Projekten, für die Pauschalpreise gelten, werden bei Abfragen mit INFORMATION_SCHEMA für Datenansichten und Tabellen Ihre gekauften BigQuery-Slots verbraucht. Weitere Informationen finden Sie unter Pauschalpreise.

Da INFORMATION_SCHEMA-Abfragen nicht im Cache gespeichert sind, werden Ihnen bei jeder INFORMATION_SCHEMA-Abfrage Gebühren in Rechnung gestellt, auch wenn der Abfragetext bei jeder Ausführung der gleiche ist.

Für die INFORMATION_SCHEMA-Ansichten werden keine Speichergebühren berechnet.

Syntax

Eine INFORMATION_SCHEMA-Ansicht muss möglicherweise mit einem Dataset oder mit einer Region qualifiziert werden.

Dataset-Qualifier

Wenn vorhanden, beschränkt ein Dataset-Qualifier die Ergebnisse auf das angegebene Dataset. Beispiel:

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

Die folgenden INFORMATION_SCHEMA-Ansichten unterstützen Dataset-Qualifier:

  • COLUMNS
  • COLUMN_FIELD_PATHS
  • PARAMETERS
  • PARTITIONS
  • ROUTINES
  • ROUTINE_OPTIONS
  • TABLES
  • TABLE_OPTIONS
  • VIEWS

Regions-Qualifier

Regions-Qualifier werden durch eine region-REGION-Syntax dargestellt. Für REGION kann jeder beliebige Dataset-Standortname verwendet werden. Die folgenden Regions-Qualifier sind beispielsweise gültig:

  • region-us
  • region-asia-east2
  • region-europe-north1

Wenn vorhanden, begrenzt ein Regions-Qualifier die Ergebnisse auf den angegebenen Standort. Die folgende Abfrage gibt beispielsweise Metadaten für alle Datasets in einem Projekt am multiregionalen Standort US zurück:

-- Returns metadata for all datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

Die folgenden INFORMATION_SCHEMA-Ansichten unterstützen keine Regions-Qualifier:

Wenn weder ein Regions-Qualifier noch ein Dataset-Qualifier angegeben ist, erhalten Sie eine Fehlermeldung.

Projekt-Qualifier

Wenn vorhanden, beschränkt ein Projekt-Qualifier die Ergebnisse auf das angegebene Projekt. Beispiel:

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

Alle INFORMATION_SCHEMA-Ansichten unterstützen Projekt-Qualifier. Wenn kein Projekt-Qualifier angegeben ist, wird standardmäßig die Projektansicht verwendet, in der die Abfrage ausgeführt wird.

Die Angabe eines Projekt-Qualifiers für Ansichten auf Organisationsebene (z. B. STREAMING_TIMELINE_BY_ORGANIZATION, TABLE_STORAGE_TIMELINE_BY_ORGANIZATION) hat keine Auswirkungen auf die Ergebnisse.

Beschränkungen

  • Abfragen von BigQuery INFORMATION_SCHEMA müssen mit der Google Standard-SQL-Syntax erstellt werden. INFORMATION_SCHEMA unterstützt kein Legacy-SQL.
  • Die Abfrageergebnisse für INFORMATION_SCHEMA werden nicht im Cache gespeichert.
  • INFORMATION_SCHEMA-Ansichten können nicht in DDL-Anweisungen verwendet werden.