Обновление информации о таблице

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 Новый заголовок таблицы.