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, wird im Ergebnis jedes Dataset im angegebenen Projekt in einer eigenen Zeile dargestellt.

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.
sync_status JSON Der Synchronisierungsstatus zwischen den primären und sekundären Replikaten für Datasets für regionenübergreifende Replikation und Notfallwiederherstellung. Gibt NULL zurück, wenn das Replikat ein primäres Replikat ist oder das Dataset keine Replikation verwendet.

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 Trusted 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"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+