Introducción a INFORMATION_SCHEMA

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_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
Configuraciones	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGES` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGES`
Conjuntos de datos	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICASscience`
Trabajos	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
Trabajos por fragmento de tiempo	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
Recomendaciones y estadísticas	`INSIGHTS` `RECOMMENDATIONS` `RECOMMENDATIONS_BY_ORGANIZATION`
Reservas	`ASSIGNMENTS_BY_PROJECT^†` `ASSIGNMENT_CHANGES_BY_PROJECT^†` `CAPACITY_COMMITMENTS_BY_PROJECT^†` `CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^†` `RESERVATIONS_BY_PROJECT^†` `RESERVATION_CHANGES_BY_PROJECT^†` `RESERVATIONS_TIMELINE_BY_PROJECT^†`
Rutinas	`PARAMETERS` `ROUTINES` `ROUTINE_OPTIONS`
Índices de búsqueda	`SEARCH_INDEXES` `SEARCH_INDEX_COLUMNS`
Sesiones	`SESSIONS_BY_PROJECT^†` `SESSIONS_BY_USER`
Transmisión	`STREAMING_TIMELINE_BY_PROJECT^†` `STREAMING_TIMELINE_BY_FOLDER` `STREAMING_TIMELINE_BY_ORGANIZATION`
Tablas	`COLUMNS` `COLUMN_FIELD_PATHS` `CONSTRAINT_COLUMN_USAGE` `KEY_COLUMN_USAGE` `PARTITIONSscience` `TABLES` `TABLE_OPTIONS` `TABLE_CONSTRAINTS` `TABLE_SNAPSHOTS` `TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
Índices vectoriales	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
Vistas	`VIEWS` `MATERIALIZED_VIEWS`
API de Write	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`

^† 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 devuelven 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 basados en la capacidad, las consultas en tablas y vistas INFORMATION_SCHEMA consumen las ranuras compradas de BigQuery. Para obtener más información, consulta Precios por capacidad.

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

Una vista INFORMATION_SCHEMA debe estar calificada con un conjunto de datos o una región.

Nota: Debes especificar una ubicación para consultar una vista de INFORMATION_SCHEMA. Consultar un vista INFORMATION_SCHEMA falla con el siguiente error si la ubicación de la ejecución de la consulta no coincide con la ubicación del conjunto de datos o el calificador regional que se usó:

Table myproject: region-us.INFORMATION_SCHEMA.[VIEW] not found in location US

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
MATERIALIZED_VIEWS
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, a través de la siguiente consulta, se devuelven 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.

Las consultas en una vista INFORMATION_SCHEMA calificada por región se ejecutan en la región que especificas, lo que significa que no puedes escribir una sola consulta para unir datos de vistas en regiones diferentes. Para combinar las vistas INFORMATION_SCHEMA de varias regiones, escribe los resultados de tu consulta en las tablas y, luego, copia las tablas o mueve tus conjuntos de datos a ella. una región común.

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, ) no afecta los resultados.

Limitaciones

Las consultas de INFORMATION_SCHEMA de BigQuery deben tener sintaxis de GoogleSQL. 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.
Las vistas INFORMATION_SCHEMA no contienen información sobre los conjuntos de datos anónimos.
Las consultas de INFORMATION_SCHEMA con calificadores de región pueden incluir metadatos de recursos en esa región de conjuntos de datos borrados que se encuentran dentro de tu período de viaje en el tiempo.
Cuando enumeras recursos desde una vista INFORMATION_SCHEMA, los permisos se verifican solo a nivel del superior, no a nivel de la fila individual. Por lo tanto, se ignora cualquier política de denegación (vista previa) que se oriente de forma condicional a una fila individual a través de etiquetas.