La función QUERY es una función integrada que permite realizar una consulta dentro de un conjunto de valores con el lenguaje de consulta del API de visualización de Google.

La entrada QUERY

Intervalo: requiere un intervalo de celdas como, por ejemplo, A1:B6, data!B2:H6, ImportRange(spreadsheet_key, [sheet!]range).

La entrada de QUERY es una lista de filas en la que la primera fila, más de una fila o ninguna son encabezados. Cada columna de la entrada sólo puede contener valores de los tipos admitidos siguientes:

• "boolean": valor booleano ("true" o "false") Valor de ejemplo: v:"verdadero"
• "number": valor numérico Valores de ejemplo: v:7, v:3,14, v:-55
• "string": valor de la cadena Valor de ejemplo: v:"hola"
• "date": valor de la fecha sin incluir la hora Valor de ejemplo: v:"21/08/2009"
• "datetime": valor de la fecha incluyendo la hora Valor de ejemplo: v:"21/08/2009 12:23"
• "timeofday": valor de la hora del día Valores de ejemplo: v:"12:23"
  

El tipo de cada columna viene determinado por la mayoría de las celdas. Los valores del tipo erróneo se consideran valores nulos.

Cadena de consulta: la cadena de consulta en la que se aplican las operaciones de datos. La consulta opera en los ID de columna directamente desde el intervalo de entrada y utiliza un subconjunto del lenguaje SQL como, por ejemplo, "select E", "select A, B", "sum(B),C group by C", "select D where D < 'Nick'".

Nota: los espacios están permitidos, los identificadores de la lista se deben separar con comas.

Para obtener más información, lee el apartado Lenguaje de consulta del API de visualización de Google.

Encabezados (opcional): un número que indica el número de filas de encabezados del intervalo de entrada. Si se omite, o se establece en -1, el número de filas de encabezado se deduce del intervalo de entrada. Este parámetro permite transformar entradas de intervalo de filas con varios encabezados en las entradas con una sola fila de encabezado que admite la función QUERY.
Por ejemplo:

Resultado de la función QUERY

Se trata de una matriz de valores. Estos valores son el resultado de la ejecución de la consulta en la matriz de valores. La estructura de la matriz consiste en una única fila de etiquetas de columna seguida de una lista de filas de datos. Las etiquetas pueden estar en blanco; si todas lo están, la fila de etiquetas se omite.

En caso de error, se muestra un error en la celda de la fórmula y se añade un mensaje a la anotación de la celda. Por ejemplo:
#VALUE! - error: consulta no válida. No se puede utilizar PIVOT cuando no se ha definido ninguna agregación en SELECT.
#VALUE! - error: consulta no válida. La columna [K] no existe en la tabla.

ID de columna: corresponde al identificador de columna del intervalo de hoja subyacente. Por ejemplo: A,B,...,AA,..

Ejemplo completo: =QUERY(A1:E6, "select avg(A) pivot B")

A continuación, se muestra un ejemplo: