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}/definition

Path-параметры

Параметр Описание
connection_id Идентификатор подключения.
table_name Имя таблицы.

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

{
  "partition_key": [
    "string"
  ],
  "replacing_key": [
    "string"
  ],
  "schema": [
    {
      "name": "string",
      "nullable": true,
      "title": "string",
      "type": "string"
    }
  ],
  "title": "string"
}
Поле Описание
partition_key[] string

Ключ партиционирования.

replacing_key[] string

Ключ замены данных.


Позволяет заменить данные, которые были загружены ранее по этому ключу.
schema[] object

Схема таблицы.

schema[].name string

Имя поля.

schema[].nullable boolean

Указывает, может ли поле принимать значение NULL.

schema[].title string

Заголовок поля.

schema[].type string

Тип данных. Допустимые типы данных:

  • string
  • integer
  • float
  • date
  • datetime
  • boolean
  • geopoint
title string

Заголовок таблицы.

Ответ

HTTP Code: 200 - OK

{
  "old_data_was_dropped": true,
  "old_table_definition": {
    "partition_key": [
      "string"
    ],
    "replacing_key": [
      "string"
    ],
    "meta": {
      "lastUploadTime": "2019-09-24T14:27:38.094Z"
    },
    "schema": [
      {
        "name": "string",
        "nullable": true,
        "title": "string",
        "type": "string"
      }
    ],
    "name": "string",
    "title": "string"
  },
  "new_table_definition": {
    "partition_key": [
      "string"
    ],
    "replacing_key": [
      "string"
    ],
    "meta": {
      "lastUploadTime": "2019-09-24T14:27:38.094Z"
    },
    "schema": [
      {
        "name": "string",
        "nullable": true,
        "title": "string",
        "type": "string"
      }
    ],
    "name": "string",
    "title": "string"
  }
}
Поле Описание
old_data_was_dropped boolean

Указывает, что старая информация о таблице была удалена.

old_table_definition object

Старая информация о таблице.

old_table_definition.partition_key[] string

Старый ключ партиционирования.

old_table_definition.replacing_key[] string

Старый ключ замены данных.


Позволяет заменить данные, которые были загружены ранее по этому ключу.
old_table_definition.meta object

Удаленные метаданные о таблице.

old_table_definition.meta.lastUploadTime string

Старые дата и время последнего обновления.
Строка в формате RFC3339.

old_table_definition.schema[] string

Старая схема таблицы.

old_table_definition.schema[].name string

Имя поля.

old_table_definition.schema[].nullable boolean

Указывает, может ли поле принимать значение NULL.

old_table_definition.schema[].title string

Заголовок поля.

old_table_definition.schema[].type string

Тип данных. Допустимые типы данных:

  • string
  • integer
  • float
  • date
  • datetime
  • boolean
  • geopoint
old_table_definition.name string

Имя таблицы.

old_table_definition.title string

Старый заголовок таблицы.

new_table_definition object

Информация, которая была добавлена.

new_table_definition.partition_key[] string

Ноый ключ партиционирования.

new_table_definition.replacing_key[] string

Новый ключ замены данных.

new_table_definition.meta object

Новые метаданные таблицы.

new_table_definition.meta.lastUploadTime string

Дата и время последнего обновления.
Строка в формате RFC3339.

new_table_definition.schema[] string

Новая схема таблицы.

new_table_definition.schema[].name string

Имя поля.

new_table_definition.schema[].nullable boolean

Указывает, может ли поле принимать значение NULL.

new_table_definition.schema[].title string

Заголовок поля.

new_table_definition.schema[].type string

Тип данных. Допустимые типы данных:

  • string
  • integer
  • float
  • date
  • datetime
  • boolean
  • geopoint
new_table_definition.name string

Новое имя таблицы.

new_table_definition.title string

Новый заголовок таблицы.

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