Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex DataLens Partners API
  • Принцип работы
  • Аутентификация в API
  • Справочник API
    • Обзор
    • Создание связи с клиентом
    • Удаление связи с клиентом
    • Информация о подключении
    • Обновление таблицы
    • Удаление таблицы
    • Запись данных
    • Удаление данных
  • Квоты и лимиты
  • Правила тарификации
  1. Справочник API
  2. Запись данных

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

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

В этой статье:
  • HTTP-запрос
  • Path-параметры
  • Заголовки
  • Параметры в теле запроса
  • Ответ
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»