Запись данных в таблицу
Записывает данные в указанную таблицу.
HTTP-запрос
POST https://upload.datalens.yandex.net/provider/v1/connection/{connection_id}/table/{table_name}/data
Path-параметры
Параметр | Описание |
---|---|
connection_id | Идентификатор подключения. |
table_name | Имя таблицы. |
Заголовки
Заголовок | Описание |
---|---|
X-DL-Client-Id | Идентификатор клиента. |
X-DL-Operation-UUID | Уникальный идентификатор операции. Значение генерируется на стороне клиента. Подробнее в разделе Operation UUID. |
X-DL-Table-Definition | Описание таблицы в формате JSON. Например:
Если переданная схема не совпадает с существующей, DataLens учитывает значение заголовка |
X-DL-Force-Truncate | Указывает, что необходимо удалить данные в таблице перед записью. Возможные значения: Если значение |
X-DL-Allow-Alter-Table | Разрешает изменение схемы таблицы на указанную в запросе, если схема не совпадает с записанной. При этом DataLens удаляет данные, которые были записаны в таблицу ранее. Возможные значения: Если значение |
X-DL-Data-Format | Формат данных. Возможное значение: array . |
Content-Type | Тип передаваемого контента в теле. Возможное значение: |
Параметры в теле запроса
# Данные в виде массивов JSON, например:
["fieldValue11", "fieldValue21"]
["fieldValue12", "fieldValue22"]
["fieldValue13", "fieldValue23"]
Примечание
Дата и время должны быть переданы в формате ISO 8601.
Если в дате и времени есть сведения о часовом поясе (time zone), DataLens автоматически приведет его к стандарту UTC.
Ответ
HTTP Code: 200 - OK
{
"old_data_was_dropped": true,
"row_count": 0
}
Поле | Описание |
---|---|
old_data_was_dropped | boolean Указывает, была ли удалена старая схема таблицы. |
row_count | integer Число записанных строк. |
HTTP Code: 400 - Bad Request
Невалидные входные параметры. Например, схема таблицы не совпадает с передаваемыми данными.
HTTP Code: 423 - Locked
В DataLens выполняется другая операция с указанной таблицей.