Vista SCHEMATA_OPTIONS

A vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS contém uma linha para cada opção definida em cada conjunto de dados num projeto.

Antes de começar

Para consultar a vista SCHEMATA_OPTIONS para metadados do conjunto de dados, precisa da autorização de gestão de identidade e de acesso (IAM) bigquery.datasets.get ao nível do projeto.

Cada uma das seguintes funções de IAM predefinidas inclui as autorizações de que precisa para obter a vista SCHEMATA_OPTIONS:

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

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

Quando consulta a vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS, os resultados da consulta contêm uma linha para cada opção definida em cada conjunto de dados num projeto.

A vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
catalog_name STRING O nome do projeto que contém o conjunto de dados
schema_name STRING O nome do conjunto de dados, também conhecido como datasetId
option_name STRING O nome da opção. Para ver uma lista das opções suportadas, consulte a lista de opções de esquemas.

A opção storage_billing_model só é apresentada para conjuntos de dados que foram atualizados após 1 de dezembro de 2022. Para conjuntos de dados que foram atualizados pela última vez antes dessa data, o modelo de faturação de armazenamento é LOGICAL.
option_type STRING O tipo de dados da opção
option_value STRING O valor da opção

Âmbito e sintaxe

As consultas a esta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos da região dos EUA. A tabela seguinte explica o âmbito da região para esta vista:

Nome da vista Âmbito do recurso Âmbito da região
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_OPTIONS Nível do projeto Região dos EUA
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS Nível do projeto REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplo

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

Exemplos

Obtenha o tempo de expiração predefinido da tabela para todos os conjuntos de dados no seu projeto

Para executar a consulta num projeto que não seja o projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: 

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
 por exemplo, `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

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

O resultado é semelhante ao seguinte:

  +----------------+---------------+-------------------------------+-------------+---------------------+
  |  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                |
  +----------------+---------------+-------------------------------+-------------+---------------------+

Obtenha etiquetas para todos os conjuntos de dados no seu projeto

Para executar a consulta num projeto que não seja o projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: 

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
; por exemplo, `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

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

O resultado é semelhante ao seguinte:

  +----------------+---------------+-------------+---------------------------------+------------------------+
  |  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")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+