Esta página se ha traducido con Cloud Translation API.

Introducción a INFORMATION_SCHEMA

Las vistas INFORMATION_SCHEMA de BigQuery son de solo lectura y están definidas por el sistema. Proporcionan información de metadatos sobre tus objetos de BigQuery. En la siguiente tabla se enumeran todas las vistas INFORMATION_SCHEMA que puedes consultar para obtener información de metadatos:

Tipo de recurso	Vista INFORMATION_SCHEMA
Control de acceso	`OBJECT_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
Configuraciones	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGESscience` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGESscience`
Conjuntos de datos	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICASscience SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATIONscience`
Empleo	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
Tareas por fracción de tiempo	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
Recomendaciones y estadísticas	`INSIGHTSscience` `RECOMMENDATIONSscience` `RECOMMENDATIONS_BY_ORGANIZATIONscience`
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` `SEARCH_INDEX_COLUMN_OPTIONSscience` `SEARCH_INDEX_OPTIONS` `SEARCH_INDEXES_BY_ORGANIZATION`
Sesiones	`SESSIONS_BY_PROJECT^†` `SESSIONS_BY_USER`
Streaming	`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_FOLDER` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDERscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
Índices vectoriales	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
Vistas	`VIEWS` `MATERIALIZED_VIEWSscience`
API Write	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`

^† En las vistas *BY_PROJECT, el sufijo BY_PROJECT es opcional. Por ejemplo, las consultas INFORMATION_SCHEMA.JOBS_BY_PROJECT y INFORMATION_SCHEMA.JOBS devuelven los mismos resultados.

Precios

En los proyectos que usan precios bajo demanda, las consultas en vistas INFORMATION_SCHEMA incurren en un cargo mínimo de 10 MB de procesamiento de datos, aunque los bytes procesados por la consulta sean inferiores a 10 MB. 10 MB es el importe mínimo de facturación de las consultas bajo demanda. Para obtener más información, consulta los precios bajo demanda.

En los proyectos que usan precios basados en la capacidad, las consultas en INFORMATION_SCHEMAvistas y tablas consumen las ranuras de BigQuery que hayas comprado. Para obtener más información, consulta los precios basados en la capacidad.

Como las consultas INFORMATION_SCHEMA no se almacenan en caché, se te cobra cada vez que ejecutas una consulta INFORMATION_SCHEMA, aunque el texto de la consulta sea el mismo cada vez que la ejecutas.

No se te cobrarán tarifas de almacenamiento por las vistas INFORMATION_SCHEMA.

Sintaxis

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

Nota: Debes especificar una ubicación para consultar una vista INFORMATION_SCHEMA. Si la ubicación de la ejecución de la consulta no coincide con la del conjunto de datos o con el calificador regional utilizado, se produce un error al consultar una vista INFORMATION_SCHEMA.

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 de INFORMATION_SCHEMA admiten calificadores de conjuntos 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 mediante la sintaxis region-REGION. Se puede usar cualquier nombre de ubicación de 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, la siguiente consulta devuelve los metadatos de todos los conjuntos de datos de un proyecto de la multirregión US:

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

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

Si no se especifica ningún calificador de región ni de conjunto de datos, se producirá un error.

Las consultas en una vista INFORMATION_SCHEMA calificada por región se ejecutan en la región que especifiques, lo que significa que no puedes escribir una sola consulta para combinar datos de vistas de diferentes regiones. Para combinar vistas de INFORMATION_SCHEMA de varias regiones, lee y combina los resultados de la consulta de forma local o copia las tablas resultantes en una región común.

Calificador de proyectos

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 de INFORMATION_SCHEMA admiten calificadores de proyecto. Si no se especifica un calificador de proyecto, la vista se definirá de forma predeterminada como el proyecto en el que se ejecuta la consulta.

Especificar un calificador de proyecto para las vistas a nivel de organización (por ejemplo, STREAMING_TIMELINE_BY_ORGANIZATION) no influye en los resultados.

Limitaciones

Las consultas de BigQuery INFORMATION_SCHEMA deben tener la sintaxis de GoogleSQL. INFORMATION_SCHEMA no admite SQL antiguo.
Los resultados de las consultas de INFORMATION_SCHEMA no se almacenan en caché.
Las vistas INFORMATION_SCHEMA no se pueden usar en instrucciones DDL.
Las vistas de INFORMATION_SCHEMA no contienen información sobre los conjuntos de datos ocultos.
Las consultas INFORMATION_SCHEMA con calificadores de región pueden incluir metadatos de recursos de esa región de conjuntos de datos eliminados que estén dentro de tu periodo de recuperación.
Cuando enumeras recursos desde una vista INFORMATION_SCHEMA, los permisos se comprueban solo a nivel de elemento superior, no a nivel de fila individual. Por lo tanto, se ignorará cualquier política de denegación (vista previa) que se dirija de forma condicional a una fila concreta mediante etiquetas.