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`
Empfehlungen und Statistiken	`INSIGHTS` `RECOMMENDATIONS` `RECOMMENDATIONS_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`
Streaming	`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`
Aufrufe	`VIEWS` `MATERIALIZED_VIEWS`
API schreiben	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`

^† 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 einen Standort angeben, um eine INFORMATION_SCHEMA-Ansicht abzufragen. Das Abfragen einer INFORMATION_SCHEMA-Ansicht 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.

Abfragen für eine regional qualifizierte INFORMATION_SCHEMA-Ansicht werden in der von Ihnen angegebenen Region ausgeführt. Dies bedeutet, dass Sie keine einzelne Abfrage schreiben können, um Daten aus Ansichten in verschiedenen Regionen zusammenzuführen. Zum Kombinieren von INFORMATION_SCHEMA-Ansichten aus mehreren Regionen schreiben Sie die Abfrageergebnisse in Tabellen und kopieren Sie Ihre Tabellen oder verschieben Ihre Datasets auf eine gemeinsame Region.

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.
Wenn Sie Ressourcen aus einer INFORMATION_SCHEMA-Ansicht auflisten, werden die Berechtigungen nur auf der übergeordneten Ebene und nicht auf der Ebene einzelner Zeilen geprüft. Daher wird jede Ablehnungsrichtlinie (Vorschau) ignoriert, die mithilfe von Tags bedingt auf eine einzelne Zeile ausgerichtet ist.