Ansicht SCHEMATA_OPTIONS

Die Ansicht INFORMATION_SCHEMA.SCHEMATA_OPTIONS enthält eine Zeile für jede Option jedes Datasets in einem Projekt.

Hinweise

Zum Abfragen der Ansicht SCHEMATA_OPTIONS 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_OPTIONS-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_OPTIONS abfragen, wird im Ergebnis jede Option jedes Datasets in einem Projekt in einer eigenen Zeile dargestellt.

Die Ansicht INFORMATION_SCHEMA.SCHEMATA_OPTIONS 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
`OPTION_NAME`	`STRING`	Ein Namenswert der Optionstabelle
`OPTION_TYPE`	`STRING`	Ein Datentypwert der Optionstabelle
`OPTION_VALUE`	`STRING`	Eine Wertoption der Optionstabelle

Optionstabelle

`OPTION_NAME`	`OPTION_TYPE`	`OPTION_VALUE`
`default_partition_expiration_days`	`FLOAT64`	Die Standardlebensdauer aller partitionierten Tabellen im Dataset in Tagen
`default_table_expiration_days`	`FLOAT64`	Die Standardlebensdauer aller Tabellen im Dataset in Tagen
`max_time_travel_hours`	`INTEGER`	Das Zeitreisefenster, ausgedrückt als Vielfaches von 24 (48, 72, 96, 120, 144, 168) zwischen 48 (2 Tage) und 168 (7 Tage)
`description`	`STRING`	Eine Beschreibung des Datasets
`friendly_name`	`STRING`	Eine Beschreibung des Datasets
`labels`	`ARRAY<STRUCT<STRING, STRING>>`	Ein `STRUCT`-Array, das die Labels des Datasets darstellt
`storage_billing_model`	`STRING`	Speicherabrechnungsmodell des Datasets.

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_OPTIONS`	Projektebene	US-Region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS	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

Hinweis: Sie müssen den Standort angeben, um die INFORMATION_SCHEMA-Ansichten abzufragen, und der Standort der Abfrageausführung muss mit der Region der Ansicht INFORMATION_SCHEMA übereinstimmen.

Beispiel

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

Beispiele

Standardtabellenablaufzeit für alle Datasets in Ihrem Projekt abrufen

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_OPTIONS

Beispiel: `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'default_table_expiration_days';

Das Ergebnis sieht etwa so aus:

  +----------------+---------------+-------------------------------+-------------+---------------------+
  |  catalog_name  |  schema_name  |          option_name          | option_type |    option_value     |
  +----------------+---------------+-------------------------------+-------------+---------------------+
  | myproject      | mydataset3    | default_table_expiration_days | FLOAT64     | 0.08333333333333333 |
  | myproject      | mydataset2    | default_table_expiration_days | FLOAT64     | 90.0                |
  | myproject      | mydataset1    | default_table_expiration_days | FLOAT64     | 30.0                |
  +----------------+---------------+-------------------------------+-------------+---------------------+

Labels für alle Datasets in Ihrem Projekt abrufen

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_OPTIONS

Beispiel: `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'labels';

Das Ergebnis sieht etwa so aus:

  +----------------+---------------+-------------+---------------------------------+------------------------+
  |  catalog_name  |  schema_name  | option_name |          option_type            |      option_value      |
  +----------------+---------------+-------------+---------------------------------+------------------------+
  | myproject      | mydataset1    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  | myproject      | mydataset2    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+