SQL запросы (версия 3.xx)/HTTP
Источник данных HTTP предназначен для работы с данными при помощи стандартных http-запросов.
Поддерживаются SQL - операторы:
- select - выборка данных. В списке полей можно указать только * - все поля или имена полей, функции и различные преобразования не поддерживаются.
- where - позволяет указать условие выборки. Условие будет наложено на полученные данные.
Получение данных
Для получения данных методом GET можно использовать SQL-запрос:
select * from http_get ('https://www.calloffice.ru')
В этом случае, будет выполнен GET-запрос к указанному ресурсу и если в ответе будут данные json (Content-Type: application/json) или xml (Content-Type: text/xml или application/xml), результат будет преобразован в таблицу. Данные в формате json должны быть в виде:
[{"имя1":"Значение1","имя2":"Значение2"}, {"имя1":"Значение3","имя2":"Значение4"}, ...]
Если данные ответа не содержат данных json или xml запрос вернет одну строку с тремя полями:
- Status - код статуса ответа;
- Content_Type - тип содержимого (Content-Type);
- Content - текст ответа;
- Headers - заголовки ответа.
Допустимые функции
В выражении from можно использовать функции:
- http (Method, URL, Data, Headers) - http запрос на ресурс URL с методом Method, данными Data и заголовками Headers;
- http_get (Method, URL, Content_Type) - GET- запрос на ресурс URL, с типом содержимого Content_Type;
- http_post (URL, Data, Headers) - POST запрос на ресурс URL с данными Data и заголовками Headers;
- http_put (URL, Data, Headers) - PUT запрос на ресурс URL с данными Data и заголовками Headers;
- http_patch (URL, Data, Headers) - PATCH запрос на ресурс URL с данными Data и заголовками Headers;
- http_delete (URL, Data, Headers) - DELETE запрос на ресурс URL с данными Data и заголовками Headers;
Условия отбора where
Условие отбора записей накладывается на полученные данные и может быть двух вариантах:
- В виде обычных выражений SQL, поддерживаются только простые условия без скобок.
- В виде функции JavaScript, например:
select ip, connectionid, port from http_get ('https://www.calloffice.ru/test/http.php?s1s') where function () { return (port == 55893 && isssl); }
Если не указан список аргументов, он будет сформирован автоматически на основе списка полей, полученных в результате запроса. Список полей можно так же указать в явном виде:
select ip, connectionid, port from http_get ('https://www.calloffice.ru/test/http.php?s1s') where function (port, isssl) { return (port == 55893 && isssl); }