ROUTINE_OPTIONS view

A vista INFORMATION_SCHEMA.ROUTINE_OPTIONS contém uma linha para cada opção de cada rotina num conjunto de dados.

Autorizações necessárias

Para consultar a vista INFORMATION_SCHEMA.ROUTINE_OPTIONS, precisa das seguintes autorizações de gestão de identidade e de acesso (IAM):

  • bigquery.routines.get
  • bigquery.routines.list

Cada uma das seguintes funções de IAM predefinidas inclui as autorizações de que precisa para obter metadados de rotina:

  • roles/bigquery.admin
  • roles/bigquery.metadataViewer
  • 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.ROUTINE_OPTIONS, os resultados da consulta contêm uma linha para cada opção de cada rotina num conjunto de dados.

A vista INFORMATION_SCHEMA.ROUTINE_OPTIONS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
SPECIFIC_CATALOG STRING O nome do projeto que contém a rotina onde a opção é definida
SPECIFIC_SCHEMA STRING O nome do conjunto de dados que contém a rotina onde a opção está definida
SPECIFIC_NAME STRING O nome da rotina
OPTION_NAME STRING Um dos valores de nome na tabela de opções
OPTION_TYPE STRING Um dos valores do tipo de dados na tabela de opções
OPTION_VALUE STRING Uma das opções de valor na tabela de opções
Tabela de opções
OPTION_NAME OPTION_TYPE OPTION_VALUE
description STRING A descrição da rotina, se definida
library ARRAY Os nomes das bibliotecas referenciadas na rotina. Aplicável apenas a UDFs JavaScript
data_governance_type DataGovernanceType O nome do tipo de governação de dados suportado. Por exemplo, DATA_MASKING.

Âmbito e sintaxe

As consultas desta vista têm de incluir um conjunto de dados ou um qualificador de região. Para mais informações, consulte a secção Sintaxe. A tabela seguinte explica os âmbitos da região e dos recursos para esta vista:

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS Nível do projeto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS Nível do conjunto de dados Localização do conjunto de dados
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`.
  • DATASET_ID: o ID do seu conjunto de dados. Para mais informações, consulte o artigo Qualificador de conjunto de dados.

Exemplo

-- Returns metadata for routines in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

-- Returns metadata for routines in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

Exemplo

Exemplo 1:

O exemplo seguinte obtém as opções de rotina para todas as rotinas em mydataset no seu projeto predefinido (myproject) consultando a vista INFORMATION_SCHEMA.ROUTINE_OPTIONS:

SELECT
  *
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

O resultado é semelhante ao seguinte:

+-------------------+------------------+---------------+----------------------+---------------+------------------+
| specific_catalog  | specific_schema  | specific_name |     option_name      | option_type   | option_value     |
+-------------------+------------------+---------------+----------------------+---------------+------------------+
| myproject         | mydataset        | myroutine1    | description          | STRING        | "a description"  |
| myproject         | mydataset        | myroutine2    | library              | ARRAY<STRING> | ["a.js", "b.js"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+