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_PRIVILEGES
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_REPLICAS
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
PARTITIONS
TABLES
TABLE_OPTIONS
TABLE_CONSTRAINTS
TABLE_SNAPSHOTS
TABLE_STORAGE_BY_PROJECT
TABLE_STORAGE_BY_ORGANIZATION
TABLE_STORAGE_USAGE_TIMELINE
TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
Í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.

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.