Introducción a INFORMATION_SCHEMA de BigQuery

Las vistas INFORMATION_SCHEMA de BigQuery son vistas de solo lectura definidas por el sistema que proporcionan información de metadatos sobre los objetos de BigQuery. En la siguiente tabla, se enumeran todas las vistas INFORMATION_SCHEMA que puedes consultar para recuperar información de metadatos:

Tipo de recurso Vista de INFORMATION_SCHEMA
Control de acceso OBJECT_PRIVILEGES
BI Reservations BI_CAPACITIES
BI_CAPACITY_CHANGES
Conjuntos de datos SCHEMATA
Opciones de conjuntos de datos SCHEMATA_OPTIONS
Metadatos de índice SEARCH_INDEXES
SEARCH_INDEXES_COLUMNS
Metadatos de trabajos JOBS_BY_PROJECT
JOBS_BY_USER
JOBS_BY_FOLDER
JOBS_BY_ORGANIZATION
Metadatos de trabajos por fragmento de tiempo JOBS_TIMELINE_BY_PROJECT
JOBS_TIMELINE_BY_USER
JOBS_TIMELINE_BY_FOLDER
JOBS_TIMELINE_BY_ORGANIZATION
Metadatos de reservas RESERVATIONS_BY_PROJECT
RESERVATION_CHANGES_BY_PROJECT
RESERVATIONS_TIMELINE_BY_PROJECT
ASSIGNMENTS_BY_PROJECT
ASSIGNMENT_CHANGES_BY_PROJECT
CAPACITY_COMMITMENTS_BY_PROJECT
CAPACITY_COMMITMENT_CHANGES_BY_PROJECT
Rutinas ROUTINES
Opciones de rutinas ROUTINE_OPTIONS
Parámetros de rutina PARAMETERS
Metadatos de sesión SESSIONS_BY_PROJECT
SESSIONS_BY_USER
Datos de transmisión STREAMING_TIMELINE_BY_PROJECT
STREAMING_TIMELINE_BY_FOLDER
STREAMING_TIMELINE_BY_ORGANIZATION
Metadatos de tablas TABLES
TABLE_OPTIONS
Columnas de la tabla COLUMNS
COLUMN_FIELD_PATHS
Particiones de tabla PARTITIONS
Instantáneas de tablas TABLE_SNAPSHOT
Uso de almacenamiento de tablas (actual) TABLE_STORAGE_BY_PROJECT
TABLE_STORAGE_BY_ORGANIZATION
Uso de almacenamiento de tablas en el tiempo TABLE_STORAGE_TIMELINE_BY_PROJECT
TABLE_STORAGE_TIMELINE_BY_ORGANIZATION
Vistas VIEWS

Para las vistas *BY_PROJECT, el sufijo BY_PROJECT es opcional. Por ejemplo, si consultas INFORMATION_SCHEMA.JOBS_BY_PROJECT y INFORMATION_SCHEMA.JOBS, se muestran los mismos resultados.

Precios

Para los proyectos que usan precios según demanda, las consultas en las vistas de INFORMATION_SCHEMA incurren en un mínimo de 10 MB de cargos de procesamiento de datos, incluso si los bytes que procesa la consulta son menos de 10 MB. 10 MB es el monto mínimo de facturación para consultas a pedido. Para obtener más información, consulta los precios según demanda.

Para los proyectos que usan precios de tasa fija, las consultas en tablas y vistas INFORMATION_SCHEMA consumen las ranuras compradas de BigQuery. Para obtener más información, consulta Precios con tasa fija.

Debido a que las consultas de INFORMATION_SCHEMA no se almacenan en caché, se te cobrará cada vez que ejecutes una consulta de INFORMATION_SCHEMA, incluso si el texto es siempre el mismo.

No se te cobran tarifas de almacenamiento por las vistas INFORMATION_SCHEMA.

Sintaxis

Es posible que una vista INFORMATION_SCHEMA deba estar calificada con un conjunto de datos o una región.

Calificador de conjunto de datos

Cuando está presente, un calificador de conjunto de datos restringe los resultados al conjunto de datos especificado. Por ejemplo:

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

Las siguientes vistas INFORMATION_SCHEMA admiten calificadores de conjunto de datos:

  • COLUMNS
  • COLUMN_FIELD_PATHS
  • PARAMETERS
  • PARTITIONS
  • ROUTINES
  • ROUTINE_OPTIONS
  • TABLES
  • TABLE_OPTIONS
  • VIEWS

Calificador de región

Los calificadores de región se representan con una sintaxis region-REGION. Se puede usar cualquier nombre de ubicación del conjunto de datos para REGION. Por ejemplo, los siguientes calificadores de región son válidos:

  • region-us
  • region-asia-east2
  • region-europe-north1

Cuando está presente, un calificador de región restringe los resultados a la ubicación especificada. Por ejemplo, mediante la siguiente consulta, se muestran los metadatos de todos los conjuntos de datos de un proyecto en la multirregión US:

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

Las siguientes vistas INFORMATION_SCHEMA no admiten calificadores de región:

Si no se especifica un calificador de región ni un conjunto de datos de conjunto de datos, recibirás un error.

Calificador de proyecto

Cuando está presente, un calificador de proyecto restringe los resultados al proyecto especificado. Por ejemplo:

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

Todas las vistas INFORMATION_SCHEMA admiten calificadores de proyecto. Si no se especifica un calificador de proyecto, la vista se establecerá de forma predeterminada en el proyecto en el que se ejecuta la consulta.

Especificar un calificador de proyecto para las vistas a nivel de la organización (p. ej., STREAMING_TIMELINE_BY_ORGANIZATION, TABLE_STORAGE_TIMELINE_BY_ORGANIZATION) no afecta los resultados.

Limitaciones

  • Las consultas de INFORMATION_SCHEMA de BigQuery deben tener sintaxis de SQL estándar. INFORMATION_SCHEMA no admite SQL heredado.
  • Los resultados de consultas de INFORMATION_SCHEMA no se almacenan en caché.
  • En la actualidad, no se pueden usar vistas INFORMATION_SCHEMA en las declaraciones DDL.