Язык запросов Google Visualization API позволяет выполнять различные манипуляции с данными с запросом к источнику данных.

Введение

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

Язык запросов позволяет отправлять запросы на манипулирование данными и форматирование в источник данных, а также обеспечивать соответствие возвращаемой структуры данных и содержимого ожидаемой структуре.

Синтаксис языка запросов аналогичен SQL. Разработчики, знакомые с SQL, должны быть в состоянии быстро изучить и использовать этот язык запросов. В Интернете доступно множество учебных пособий по SQL . Существуют некоторые различия между этим языком запросов и SQL, которые описаны в разделе о синтаксисе .

Обратите внимание, что источники данных не требуются для реализации языка запросов, а если и требуются, то для реализации всех функций языка. Если у вас нет оснований полагать иначе, вы не должны полагаться на источник данных для реализации всех функций этого языка.

Использование языка запросов

Вы можете прикрепить строку запроса к запросу источника данных двумя способами: задав строку запроса из кода JavaScript или задав строку запроса в качестве параметра в URL-адресе источника данных . Если ваш запрос не включает строку запроса, поведение источника данных по умолчанию заключается в возврате всех строк и столбцов с использованием стандартного порядка строк и столбцов и форматирования. Вы можете изменить это, включив строку запроса в свой запрос к источнику данных.

Настройка запроса из JavaScript

Чтобы задать строку запроса из кода JavaScript, вызовите метод setQuery класса google.visualization.Query .

var query = new google.visualization.Query(DATA_SOURCE_URL);
query.setQuery('select dept, sum(salary) group by dept');
query.send(handleQueryResponse);

Настройка запроса в URL-адресе источника данных

Строку запроса можно добавить к URL-адресу источника данных с помощью параметра tq . Установка запроса в параметре URL вместо JavaScript позволяет легко использовать визуализации, написанные другими разработчиками, и по-прежнему иметь возможность настраивать запрос.

Строка запроса должна быть правильно закодирована как параметр URL. Вы можете закодировать URL-адрес, используя функцию JavaScript encodeURIComponent , или вы можете закодировать его вручную, используя инструмент кодирования в конце этого раздела.

Пример:

Рассмотрим следующую строку запроса для электронной таблицы Google. (Обратите внимание, что идентификаторы столбцов в электронных таблицах всегда представляют собой буквы; текст заголовков столбцов, отображаемый в опубликованной электронной таблице, является метками, а не идентификаторами. В строке запроса необходимо использовать идентификатор, а не метку.)

select A, sum(B) group by A

При кодировании этот запрос становится:

select%20A%2C%20sum(B)%20group%20by%20A

Предположим, что это URL-адрес вашей электронной таблицы:

https://docs.google.com/a/google.com/spreadsheets/d/1r8_mfnZAvTFmT02JHi1XgOwn_-sLCR9XgmR8wEQ4uW4

Добавьте /gviz/tq?tq= YOUR_QUERY_STRING к URL электронной таблицы, чтобы получить окончательную строку запроса:

https://docs.google.com/a/google.com/spreadsheets/d/1r8_mfnZAvTFmT02JHi1XgOwn_-sLCR9XgmR8wEQ4uW4/gviz/tq?tq=select%A%2C%20sum(B)%20group%20by%20A

Используйте приведенный ниже инструмент для кодирования или декодирования строки запроса:

Синтаксис языка

Обзор

Синтаксис языка запросов API визуализации Google похож на синтаксис SQL. Однако это подмножество SQL с некоторыми собственными функциями, которые вам необходимо изучить. Если вы знакомы с SQL, его изучение не должно составить особого труда.

Таблица, используемая во всех примерах:

В этом разделе все примеры запросов относятся к следующей таблице. Заголовки столбцов являются идентификаторами столбцов.

Языковые пункты

Синтаксис языка запросов состоит из следующих предложений. Каждое предложение начинается с одного или двух ключевых слов. Все пункты необязательны. Предложения разделяются пробелами. Порядок предложений должен быть следующим: