Запись данных в таблицу

HTTP-запрос
Path-параметры
Заголовки
Параметры в теле запроса
Ответ

Записывает данные в указанную таблицу.

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. Например: `{"partition_key":["FieldName1","FieldName2"],"schema": [{"name": "fieldName1","type": "fieldType1"},{"name":"fieldName2", "type": "fieldType1"}]}`. Если переданная схема не совпадает с существующей, DataLens учитывает значение заголовка `X-DL-Allow-Alter-Table`.
X-DL-Force-Truncate	Указывает, что необходимо удалить данные в таблице перед записью. Возможные значения: `true` / `false`. Если значение `true`, DataLens удаляет данные в существующей таблице.
X-DL-Allow-Alter-Table	Разрешает изменение схемы таблицы на указанную в запросе, если схема не совпадает с записанной. При этом DataLens удаляет данные, которые были записаны в таблицу ранее. Возможные значения: `true` / `false`. Если значение `true`, DataLens удаляет существующую таблицу с данными и создает новую с переданной схемой.
X-DL-Data-Format	Формат данных. Возможное значение: `array`.
Content-Type	Тип передаваемого контента в теле. Возможное значение: `application/x-ndjson`.

Параметры в теле запроса

# Данные в виде массивов 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 выполняется другая операция с указанной таблицей.