Справочник по HTTP API ¶

Текущая версия TCS поддерживает взаимодействие по HTTP-адресам /sql и /insert.

Содержание

/sql: выполнение SQL ¶

HTTP-адрес /sql используется как альтернатива SQL-драйверам для выполнения всех поддерживаемых SQL-запросов.

Тело запроса должно содержать SQL-оператор, например запрос SELECT:

SELECT * FROM catalog.schema.table WHERE column1=1"

Код	Описание
`200 OK`	Запрос или оператор успешно выполнен

Массив описаний выбранных объектов:

[
  {
    "column1": "2024-03-13T10:14:08",
    "column0": "1",
    "column2": false,
    "column3": "alice"
  }
]

HTTP-адрес /insert используется для выполнения запросов на вставку как более быстрая альтернатива SQL-драйверам и HTTP-адресу /sql.

HTTP-адрес должен содержать имя таблицы (/$name).

Тело запроса должно содержать массив описаний вставляемых объектов. См. подробнее в разделе Вставка данных через /insert.

Пример:

{[
    {"col1": 0, "col2": false},
    {"col1": 1, "col2": true}
]}

Код	Описание
`200 OK`	Объекты успешно добавлены
`400 Bad request`	Ошибка в запросе

Массив описаний выбранных объектов:

[
  {
    "column1": "2024-03-13T10:14:08",
    "column0": "1",
    "column2": false,
    "column3": "alice"
  }
]