SCHEMATA-Ansicht

Die Ansicht INFORMATION_SCHEMA.SCHEMATA enthält Informationen zu den Datasets in einem Projekt oder einer Region. Die Ansicht gibt für jedes Dataset eine Zeile zurück.

Hinweise

Zum Abfragen der Ansicht SCHEMATA für Dataset-Metadaten benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.datasets.get auf Projektebene.

Jede der folgenden vordefinierten IAM-Rollen enthält die Berechtigungen, die Sie zum Abrufen der SCHEMATA-Ansicht benötigen:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

Schema

Wenn Sie die Ansicht INFORMATION_SCHEMA.SCHEMATA abfragen, enthalten die Abfrageergebnisse eine Zeile für jedes Dataset in einem Projekt, auf das der aktuelle Nutzer Zugriff hat.

Die Ansicht INFORMATION_SCHEMA.SCHEMATA hat das folgende Schema:

Spaltenname Datentyp Wert
CATALOG_NAME STRING Der Name des Projekts, zu dem das Dataset gehört
SCHEMA_NAME STRING Der Name des Datasets, auch als datasetId bezeichnet
SCHEMA_OWNER STRING Der Wert ist immer NULL
CREATION_TIME TIMESTAMP Der Erstellungszeitpunkt des Datasets
LAST_MODIFIED_TIME TIMESTAMP Der Zeitpunkt der letzten Änderung des Datasets
LOCATION STRING Der geografische Standort des Datasets
DDL STRING Die CREATE SCHEMA-DDL-Anweisung, die zum Erstellen des Datasets verwendet werden kann
DEFAULT_COLLATION_NAME STRING Der Name der standardmäßigen Sortierspezifikation, falls vorhanden. Andernfalls NULL.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. Wenn Sie keinen Regions-Qualifier angeben, werden Metadaten aus der US-Region abgerufen. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:

Ansichtsname Ressourcenbereich Regionsbereich
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA Projektebene US-Region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA Projektebene REGION
Dabei gilt:

  • Optional: PROJECT_ID: die ID Ihres Google Cloud-Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: region-us

Beispiel

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

Beispiel

Wenn Sie die Abfrage für ein anderes Projekt als Ihr Standardprojekt ausführen möchten, fügen Sie dem Dataset die Projekt-ID im folgenden Format hinzu:

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA
Beispiel: `myproject`.INFORMATION_SCHEMA.SCHEMATA

SELECT
  * EXCEPT (schema_owner)
FROM
  INFORMATION_SCHEMA.SCHEMATA;

Das Ergebnis sieht etwa so aus. Zur besseren Lesbarkeit werden einige Spalten aus dem Ergebnis ausgeschlossen.

+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
|  catalog_name  |  schema_name  |    creation_time    | last_modified_time  |  location  |                   ddl                    |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset1    | 2018-11-07 19:50:24 | 2018-11-07 19:50:24 | US         | CREATE SCHEMA `myproject.mydataset1`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset2    | 2018-07-16 04:24:22 | 2018-07-16 04:24:22 | US         | CREATE SCHEMA `myproject.mydataset2`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   default_partition_expiration_days=3.0, |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset3    | 2018-02-07 21:08:45 | 2018-05-01 23:32:53 | US         | CREATE SCHEMA `myproject.mydataset3`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   description="My dataset",              |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+