среда, 4 ноября 2009 г.

Функции: Функция QUERY

Функция QUERY является встроенной функцией, позволяющей выполнять запросы к массиву значений на базе языка запросов API визуализации Google.

Входные параметры QUERY

Диапазон - диапазон ячеек. Например: A1:B6, данные!B2:H6, ImportRange(ключ_таблицы;[лист!]диапазон)

На вход функции QUERY подается список строк, в котором первые строки (от нуля и больше) являются заголовками. Каждый из подаваемых на вход столбцов может содержать значения только следующих поддерживаемых типов:

  • 'boolean' - логическое значение true (истина)·или false (ложь), пример значения - v:"true";
  • 'number' - числовое значение, примеры значений - v:7, v:3,14, v:-55;
  • 'string' - строковое значение, пример значения - v:"привет";
  • 'date' - значение даты без времени, пример значения - v: "08/21/2009";
  • 'datetime' - значение даты со временем, пример значения - v: "08/21/2009 12:23";
  • 'timeofday' - значение времени дня, пример значения - v: "12:23".

Тип каждого столбца определяется большинством ячеек. Значения неверного типа рассматриваются как пустые значения.

Строка запроса - строка запроса, описывающая выполняемые над данными операции. В запросе используются идентификаторы столбцов непосредственно из входного диапазона и подмножество операторов языка SQL. Например: "select E", "select A, B", "sum(B),C group by C", "select D where D < 'Nick'".

Примечание. Пробелы разрешены, список идентификаторов должен быть разделен запятыми.

Дополнительную информацию см. в документе Google Visualization API Query Language (Язык запросов API визуализации Google).

Headers (необязательное значение) - число, задающее количество строк заголовков во входном диапазоне. Если параметр опущен или принимает значение -1, количество строк заголовка рассчитывается на основании входного диапазона. Этот параметр позволяет преобразовывать входные данные, состоящие из нескольких строк, во входные данные в виде одной строки (формат, поддерживаемый функцией QUERY).
Например:

Отдел
Мужской
Мужской
Женский
Женский

Рост
Вес
Рост
Вес
Тех.
180
70
175
50
Продажи
175
72
176
54

Отдел
Муж. - рост
Муж. - вес
Жен. - рост
Жен. - вес
Тех.
180
70
175
50
Продажи
175
72
176
54

Результаты, возвращаемые функцией QUERY

Любой массив значений. Эти значения являются результатом выполнения запроса на массиве значений. Этот массив представляет собой одну строку подписей столбцов, за которой следует список строк данных. Подписи могут быть пустыми; если все подписи пусты, строка подписей опускается.

В случае возникновения ошибки в ячейке формулы появляется соответствующий индикатор, а в примечание к ячейке добавляется сообщение. Например:
#VALUE! - ошибка. Неверный запрос: невозможно использовать PIVOT, когда в SELECT не определено ни одно объединение.
#VALUE! - ошибка. Неверный запрос: столбец [K] не существует в таблице.

Column IDs - идентификаторы столбцов из определенного диапазона листов. Например: A,B,...,AA,..

Полный пример: =QUERY(A1:E6;"select avg(A) pivot B")

Например:

пример использования функции query

Комментариев нет:

Отправить комментарий