Obtén valores de configuración con INFORMATION_SCHEMA

INFORMATION_SCHEMA es una serie de vistas que proporcionan acceso a metadatos sobre conjuntos de datos, rutinas, tablas, vistas, trabajos, reservas y datos de transmisión.

Puedes consultar la vista de las opciones de configuración de INFORMATION_SCHEMA para recuperar metadatos en tiempo real sobre las opciones de configuración de BigQuery. Esta vista contiene la configuración predeterminada a nivel de la organización o del proyecto.

Antes de comenzar

Otorga roles de Identity and Access Management (IAM) que les brindan a los usuarios los permisos necesarios para realizar cada tarea de este documento.

Permisos necesarios

Para obtener los metadatos de las opciones de configuración, necesitas los siguientes permisos de IAM:

  • bigquery.config.get

Cada uno de los siguientes roles predefinidos de IAM incluye los permisos que necesitas para obtener los metadatos de las vistas:

  • roles/bigquery.jobUser
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner

Si deseas obtener más información acerca de los permisos de BigQuery en detalle, consulta las funciones y permisos.

Vista ORGANIZATION_OPTIONS

Sintaxis

Las consultas realizadas a esta vista deben tener un calificador de región.

-- Returns configurations for all set options within the organization.
SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Cuando consultas la vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS, los resultados contienen una fila por cada configuración de una organización.

La vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
OPTION_NAME STRING Uno de los valores de nombre de la tabla de opciones
OPTION_DESCRIPTION STRING La descripción de la opción
OPTION_TYPE STRING El tipo de datos de OPTION_VALUE
OPTION_VALUE STRING El valor actual de la opción
Tabla de opciones
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING La zona horaria predeterminada de esta organización
default_kms_key_name STRING El nombre de la clave predeterminada de esta organización
default_query_job_timeout_ms STRING El tiempo de espera predeterminado en milisegundos para esta organización

Examples

En el siguiente ejemplo, se recuperan las columnas OPTION_NAME, OPTION_TYPE y OPTION_VALUE de INFORMATION_SCHEMA.ORGANIZATION_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

El resultado es similar al siguiente:

  +---------------------------------+---------------+--------------------------+
  | option_name                     | option_type   | option_value             |
  +---------------------------------+---------------+--------------------------+
  | default_time_zone               | STRING        | America/Los_Angeles      |
  +---------------------------------+---------------+--------------------------+
  | default_kms_key_name            | STRING        | test/testkey1            |
  +---------------------------------+---------------+--------------------------+
  | default_query_job_timeout_ms    | INT64         | 18000000                 |
  +---------------------------------+---------------+--------------------------+

Vista PROJECT_OPTIONS

Sintaxis

Las consultas realizadas a esta vista deben tener un calificador de región.

-- Returns configurations for all set options within the project.
SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Cuando consultas la vista INFORMATION_SCHEMA.PROJECT_OPTIONS, los resultados contienen una fila por cada configuración de un proyecto.

La vista INFORMATION_SCHEMA.PROJECT_OPTIONS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
OPTION_NAME STRING ID de opción para la configuración especificada
OPTION_DESCRIPTION STRING La descripción de la opción
OPTION_TYPE STRING El tipo de datos de OPTION_VALUE
OPTION_VALUE STRING El valor actual de la opción
Tabla de opciones
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING La zona horaria predeterminada de este proyecto
default_kms_key_name STRING El nombre de la clave predeterminada de este proyecto
default_query_job_timeout_ms STRING El tiempo de espera predeterminado en milisegundos para este proyecto

Examples

En el siguiente ejemplo, se recuperan las columnas OPTION_NAME, OPTION_TYPE y OPTION_VALUE de la vista INFORMATION_SCHEMA.PROJECT_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

El resultado es similar al siguiente:

  +---------------------------------+---------------+----------------------+
  | option_name                     | option_type   | option_value         |
  +---------------------------------+---------------+----------------------+
  | default_time_zone               | STRING        | America/Chicago      |
  +---------------------------------+---------------+----------------------+
  | default_kms_key_name            | STRING        | test/testkey1        |
  +---------------------------------+---------------+----------------------+
  | default_query_job_timeout_ms    | INT64         | 36000000             |
  +---------------------------------+---------------+----------------------+

Vista EFFECTIVE_PROJECT_OPTIONS

Sintaxis

Las consultas realizadas a esta vista deben tener un calificador de región.

-- Returns effective configurations for all set options within the project.
SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Cuando consultas la vista INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS, los resultados contienen una fila por cada configuración de un proyecto.

La vista INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
OPTION_NAME STRING ID de opción para la configuración especificada
OPTION_DESCRIPTION STRING La descripción de la opción
OPTION_TYPE STRING El tipo de datos de OPTION_VALUE
OPTION_SET_LEVEL STRING El nivel de jerarquía en el que se define la configuración, con valores posibles de DEFAULT, ORGANIZATION o PROJECTS
OPTION_SET_ON_ID STRING Establece el valor en función del valor de OPTION_SET_LEVEL:
  • Si es DEFAULT, configúralo como null.
  • Si es ORGANIZATION, configúralo como "".
  • Si es PROJECT, configúralo como ID.
OPTION_VALUE STRING El valor actual de la opción
Tabla de opciones
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING La zona horaria predeterminada vigente de este proyecto
default_kms_key_name STRING El nombre de la clave predeterminada vigente para este proyecto
default_query_job_timeout_ms INT64 El tiempo de espera predeterminado efectivo en milisegundos para este proyecto

Examples

Ejemplo 1:

En el siguiente ejemplo, se recuperan las columnas OPTION_NAME, OPTION_TYPE, OPTION_VALUE, OPTION_SET_LEVEL y OPTION_SET_ON_ID de la vista INFORMATION_SCHEMA.PROJECT_OPTIONS.

SELECT
  option_name, option_type, option_value, option_set_level, option_set_on_id
FROM
  `region-us`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

El resultado es similar al siguiente:

  +---------------------------------+---------------+-----------------------+---------------------+-----------------------+
  | option_name                     | option_type   | option_value          | option_set_level    | option_set_on_id      |
  +---------------------------------+---------------+-----------------------+---------------------+-----------------------+
  | default_time_zone               | STRING        | America/New_York      | organizations       | my_organization_id    |
  +---------------------------------+---------------+-----------------------+---------------------+-----------------------+
  | default_kms_key_name            | STRING        | test/testkey1         | projects            | my_project_id         |
  +---------------------------------+---------------+-----------------------+---------------------+-----------------------+
  | default_query_job_timeout_ms    | INT64         | 18000000              | projects             | my_project_id        |
  +---------------------------------+---------------+-----------------------+---------------------+-----------------------+