Einführung in INFORMATION_SCHEMA

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_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
Konfigurationen	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGES` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGES`
Datasets	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICASscience`
Jobs	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
Jobs nach Zeitabschnitt	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
Reservierungen	`ASSIGNMENTS_BY_PROJECT^†` `ASSIGNMENT_CHANGES_BY_PROJECT^†` `CAPACITY_COMMITMENTS_BY_PROJECT^†` `CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^†` `RESERVATIONS_BY_PROJECT^†` `RESERVATION_CHANGES_BY_PROJECT^†` `RESERVATIONS_TIMELINE_BY_PROJECT^†`
Routinen	`PARAMETERS` `ROUTINES` `ROUTINE_OPTIONS`
Suchindexe	`SEARCH_INDEXES` `SEARCH_INDEX_COLUMNS`
Sitzungen	`SESSIONS_BY_PROJECT^†` `SESSIONS_BY_USER`
Storage Write API	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`
Streaming-Insert-Anweisungen	`STREAMING_TIMELINE_BY_PROJECT^†` `STREAMING_TIMELINE_BY_FOLDER` `STREAMING_TIMELINE_BY_ORGANIZATION`
Tabellen	`COLUMNS` `COLUMN_FIELD_PATHS` `CONSTRAINT_COLUMN_USAGE` `KEY_COLUMN_USAGE` `PARTITIONSscience` `TABLES` `TABLE_OPTIONS` `TABLE_CONSTRAINTS` `TABLE_SNAPSHOTS` `TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
Vektorindexe	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
Ansichten	`Views` `MATERIALIZED_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 mit kapazitätsbasierten Preisen verbrauchen Abfragen in INFORMATION_SCHEMA-Ansichten und -Tabellen Ihre erworbenen BigQuery-Slots. Weitere Informationen finden Sie unter Kapazitätsbasierte Preise.

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 mit einem Dataset oder einer Region qualifiziert werden.

Hinweis: Sie müssen den Standort angeben, um die INFORMATION_SCHEMA-Ansichten abzufragen. Das Abfragen der INFORMATION_SCHEMA-Ansichten schlägt mit dem folgenden Fehler fehl, wenn der Ort der Abfrageausführung nicht mit dem Speicherort des Datasets oder mit dem verwendeten regionalen Qualifier übereinstimmt:

Table myproject: region-us.INFORMATION_SCHEMA.[VIEW] not found in location US

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
MATERIALIZED_VIEWS
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) hat keine Auswirkungen auf die Ergebnisse.

Beschränkungen

BigQuery-INFORMATION_SCHEMA-Abfragen müssen der GoogleSQL-Syntax entsprechen. 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.
INFORMATION_SCHEMA-Ansichten enthalten keine Informationen zu ausgeblendeten Datasets.
INFORMATION_SCHEMA-Abfragen mit Regions-Qualifier können Metadaten aus Ressourcen in dieser Region aus gelöschten Datasets, die sich innerhalb Ihres Zeitreisefensters befinden, enthalten.