RunSqlProc
Назначение | Выполнить указанную процедуру на базе и возвращает результат выполнения. Для определенных ресторанов запрос пересылается в r_k Cloud. Наличие подключенного агента при этом не требуется. |
---|---|
Ограничения | Только для агрегатора RkReports |
Поддерживаемая версия агента | v2 |
PluggetSystemType | Sql |
Формат запроса
{
"taskType": "RunSqlProc",
"params": {
"async": {
"objectId": number,
"timeout": number
},
"sync": {
"objectId": number,
"timeout": number
},
"procName": "string",
"params": [
{
"name": "string",
"value": "string"
}
]
}
}
JSON
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
taskType | string | да | Тип задачи. Для данного метода — значение RunSqlProc |
-async | Асинхронный вызов метода: либо синхронный, либо асинхронный | ||
-sync | Синхронный вызов метода: либо синхронный, либо асинхронный | ||
--timeout | int | нет | Время ожидания ответа от агента в секундах. По умолчанию — 120 секунд |
--objectId | int | да | Код ресторана в системе лицензирования |
-procName | string | да | Полное название хранимой процедуры |
-params | нет | Параметры для вызываемой процедуры/функции | |
--name | string | да | Имя параметра |
--value | string | да | Значение параметра |
Формат синхронного ответа
{
"responseCommon":{
"taskGuid":"guid",
"taskType":"RunSqlProc",
"objectId": 0
},
"error":{
"wsError":{
"code":"string",
"desc":"string"
}
}
}
JSON
Параметр | Тип | Описание |
---|---|---|
-taskGuid | guid | Уникальный код этой задачи. Используется при получении задачи через очередь |
-taskType | string enum | Тип задачи |
-objectId | int | Код ресторана в системе лицензирования |
error | Контейнер ошибок, подробнее читайте в статье Описание ошибок |
Формат асинхронного ответа
Успешный ответ
{
"taskResponse": {
"queryResult": {
"rows": [
// Массив записей
]
}
},
"responseCommon": {
"taskGuid": "string",
"taskType": "RunSqlProc",
"objectId": 0
}
}
JSON
Ответ с ошибкой
{
"responseCommon": {
"taskGuid": "string",
"taskType": "RunSqlProc",
"objectId": 0
},
"error": {
"wsError": {
"code": "string",
"desc": "string"
},
"agentError": {
"code": 0,
"desc": "string"
}
}
}
JSON
Пример ответа
{
"taskResponse": {
"queryResult": {
"rows": [
{
"col_1": true,
"col_2": 2,
"col_3": "str"
},
{
"col_1": false,
"col_2": 3,
}
]
}
},
"responseCommon": {
"taskGuid": "464ca191-8d3a-439b-ad5b-485f628275e6",
"taskType": "RunSqlProc",
"objectId": 199997075
}
}
JSON
Параметр | Тип параметра | Обязательный | Описание |
---|---|---|---|
-queryResult | |||
--rows | array | Массив записей результата выполнения запроса | |
error | string enum | Контейнер ошибок, подробнее читайте в статье Описание ошибок |