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_PRIVILEGES
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_REPLICAS
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
Streaming STREAMING_TIMELINE_BY_PROJECT
STREAMING_TIMELINE_BY_FOLDER
STREAMING_TIMELINE_BY_ORGANIZATION
Tabellen COLUMNS
COLUMN_FIELD_PATHS
CONSTRAINT_COLUMN_USAGE
KEY_COLUMN_USAGE
PARTITIONS
TABLES
TABLE_OPTIONS
TABLE_CONSTRAINTS
TABLE_SNAPSHOTS
TABLE_STORAGE_BY_PROJECT
TABLE_STORAGE_BY_ORGANIZATION
TABLE_STORAGE_USAGE_TIMELINE
TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
Vektorindexe VECTOR_INDEXES
VECTOR_INDEX_COLUMNS
VECTOR_INDEX_OPTIONS
Ansichten 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.

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.