Spec-Zone.ru › AWS CLI v2

[ aws . glue ]

Обновление таблицы

Описание

Обновляет таблицу метаданных в каталоге данных.

См. также: Документацию API AWS

Синтаксис

  update-table
[--catalog-id <value>]
--database-name <value>
--table-input <value>
[--skip-archive | --no-skip-archive]
[--transaction-id <value>]
[--version-id <value>]
[--view-update-action <value>]
[--force | --no-force]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--catalog-id (строка)

Идентификатор каталога данных, в котором находится таблица. Если не указан, используется идентификатор учетной записи Amazon Web Services по умолчанию.

--database-name (строка)

Имя базы данных каталога, в которой находится таблица. Для совместимости с Hive это имя полностью в нижнем регистре.

--table-input (структура)

Обновленный объект TableInput, определяющий таблицу метаданных в каталоге.

Имя -> (строка)

Имя таблицы. Для совместимости с Hive это имя преобразуется в нижний регистр при сохранении.

Описание -> (строка)

Описание таблицы.

Владелец -> (строка)

Владелец таблицы. Включен для совместимости с Apache Hive. Не используется в обычном процессе работы с Glue.

Последнее время доступа -> (метка времени)

Последний раз, когда была обращена таблица.

Последнее время анализа -> (метка времени)

Последний раз, когда были вычислены статистические данные колонок для этой таблицы.

Срок хранения -> (целое число)

Срок хранения для этой таблицы.

Описание хранилища -> (структура)

Описание хранилища, содержащее информацию о физическом хранении этой таблицы.

Столбцы -> (список)

Список Columns в таблице.

(структура)

Столбец в Table.

Имя -> (строка)

Имя Column.

Тип -> (строка)

Тип данных Column.

Комментарий -> (строка)

Текст комментария.

Параметры -> (словарь)

Эти пары ключ-значение определяют свойства, связанные со столбцом.

ключ -> (строка)

значение -> (строка)

Расположение -> (строка)

Физическое расположение таблицы. По умолчанию, это расположение склада, затем расположение базы данных в складе, затем имя таблицы.

Дополнительные расположения -> (список)

Список расположений, указывающих на путь, где расположена таблица Delta.

(строка)

Формат входных данных -> (строка)

Формат входных данных: SequenceFileInputFormat (двоичный), или TextInputFormat, или пользовательский формат.

Формат выходных данных -> (строка)

Формат выходных данных: SequenceFileOutputFormat (двоичный), или IgnoreKeyTextOutputFormat, или пользовательский формат.

Сжатие -> (булево)

True, если данные в таблице сжаты, или False, если нет.

Количество блоков -> (целое число)

Должно быть указано, если таблица содержит столбцы измерений.

Информация о сериализации/десериализации -> (структура)

Информация о сериализации/десериализации (SerDe).

Имя -> (строка)

Имя SerDe.

Библиотека сериализации -> (строка)

Обычно класс, реализующий SerDe. Например, org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

Параметры -> (словарь)

Эти пары ключ-значение определяют параметры инициализации для SerDe.

ключ -> (строка)

значение -> (строка)

Столбцы блоков -> (список)

Список столбцов группировки редукторов, столбцов кластеризации и столбцов букетирования в таблице.

(строка)

Столбцы сортировки -> (список)

Список, определяющий порядок сортировки каждого букета в таблице.

(структура)

Определяет порядок сортировки сортированного столбца.

Столбец -> (строка)

Имя столбца.

Порядок сортировки -> (целое число)

Указывает, что столбец отсортирован в порядке возрастания (== 1), или в порядке убывания (==0).

Параметры -> (словарь)

Пользовательские свойства в формате ключ-значение.

ключ -> (строка)

значение -> (строка)

Информация о смещенных значениях -> (структура)

Информация о значениях, которые часто встречаются в столбце (смещенные значения).

Имена смещенных столбцов -> (список)

Список имен столбцов, содержащих смещенные значения.

(строка)

Смещенные значения столбцов -> (список)

Список значений, которые настолько часто встречаются, что считаются смещенными.

(строка)

Сопоставления смещенных значений столбцов -> (словарь)

Сопоставление смещенных значений со столбцами, которые их содержат.

ключ -> (строка)

значение -> (строка)

Хранение в подкаталогах -> (булево)

True, если данные таблицы хранятся в подкаталогах, или False, если нет.

Ссылка на схему -> (структура)

Объект, который ссылается на схему, хранящуюся в Glue Schema Registry.

При создании таблицы вы можете передать пустой список столбцов для схемы и вместо этого использовать ссылку на схему.

Идентификатор схемы -> (структура)

Структура, содержащая поля идентификации схемы. Или это, или SchemaVersionId должно быть предоставлено.

ARN схемы -> (строка)

Amazon Resource Name (ARN) схемы. Должно быть указано либо SchemaArn, либо SchemaName.

Имя схемы -> (строка)

Имя схемы. Должно быть указано либо SchemaArn, либо SchemaName.

Имя реестра -> (строка)

Имя реестра схем, содержащего схему.

Идентификатор версии схемы -> (строка)

Уникальный идентификатор, назначенный версии схемы. Либо это, либо SchemaId должно быть предоставлено.

Номер версии схемы -> (длинное целое число)

Номер версии схемы.

Ключи разбиения -> (список)

Список столбцов, по которым разбивается таблица. В качестве ключей разбиения поддерживаются только примитивные типы.

При создании таблицы, используемой Amazon Athena, и вы не указываете никаких partitionKeys, вы должны по крайней мере установить значение partitionKeys в пустой список. Например:

"PartitionKeys": []

(структура)

Столбец в Table.

Имя -> (строка)

Имя Column.

Тип -> (строка)

Тип данных Column.

Комментарий -> (строка)

Текст комментария.

Параметры -> (словарь)

Эти пары ключ-значение определяют свойства, связанные со столбцом.

ключ -> (строка)

значение -> (строка)

ViewOriginalText -> (строка)

Включен для совместимости с Apache Hive. Не используется в обычном процессе работы с Glue. Если таблица является VIRTUAL_VIEW, определенные конфигурации Athena закодированы в base64.

ViewExpandedText -> (строка)

Включен для совместимости с Apache Hive. Не используется в обычном процессе работы с Glue.

Тип таблицы -> (строка)

Тип этой таблицы. Glue создает таблицы с типом EXTERNAL_TABLE. Другие службы, такие как Athena, могут создавать таблицы с дополнительными типами таблиц.

Типы таблиц Glue:

EXTERNAL_TABLE

Совместимый атрибут Hive - указывает таблицу, не управляемую Hive.

GOVERNED

Используется Lake Formation. Glue Data Catalog понимает GOVERNED.

Параметры -> (словарь)

Эти пары ключ-значение определяют свойства, связанные с таблицей.

ключ -> (строка)

значение -> (строка)

Целевая таблица -> (структура)

Структура TableIdentifier, описывающая целевую таблицу для связывания ресурсов.

Идентификатор каталога -> (строка)

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

Имя базы данных -> (строка)

Имя базы данных каталога, содержащей целевую таблицу.

Имя -> (строка)

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

Регион -> (строка)

Регион целевой таблицы.

Определение представления -> (структура)

Структура, содержащая всю информацию, определяющую представление, включая диалект или диалекты для представления и запрос.

Защищено -> (булево)

Вы можете установить этот флаг в значение true, чтобы указать движку не подключать предоставленные пользователем операции в логический план представления при планировании запроса. Однако установка этого флага не гарантирует, что движок будет следовать этому. Обратитесь к документации движка, чтобы понять предоставляемые, если таковые имеются, гарантии.

Определяющий -> (строка)

Определяющий представление в SQL.

Представления -> (список)

Список структур, содержащих диалект представления и запрос, определяющий представление.

(структура)

Структура, содержащая сведения о представлении для обновления или создания представления Lake Formation.

Диалект -> (строка)

Параметр, определяющий тип движка конкретного представления.

Версия диалекта -> (строка)

Параметр, определяющий версию движка конкретного представления.

ViewOriginalText -> (строка)

Строка, представляющая исходный SQL-запрос, описывающий представление.

Подключение для проверки -> (строка)

Имя подключения, которое будет использоваться для проверки конкретного представления представления.

ViewExpandedText -> (строка)

Строка, представляющая SQL-запрос, описывающий представление с расширенными ARN ресурсов.

Подобъекты -> (список)

Список базовых ARN таблиц, составляющих представление.

(строка)

Синтаксис JSON:

{
  "Name": "string",
  "Description": "string",
  "Owner": "string",
  "LastAccessTime": timestamp,
  "LastAnalyzedTime": timestamp,
  "Retention": integer,
  "StorageDescriptor": {
    "Columns": [
      {
        "Name": "string",
        "Type": "string",
        "Comment": "string",
        "Parameters": {"string": "string"
          ...}
      }
      ...
    ],
    "Location": "string",
    "AdditionalLocations": ["string", ...],
    "InputFormat": "string",
    "OutputFormat": "string",
    "Compressed": true|false,
    "NumberOfBuckets": integer,
    "SerdeInfo": {
      "Name": "string",
      "SerializationLibrary": "string",
      "Parameters": {"string": "string"
        ...}
    },
    "BucketColumns": ["string", ...],
    "SortColumns": [
      {
        "Column": "string",
        "SortOrder": integer
      }
      ...
    ],
    "Parameters": {"string": "string"
      ...},
    "SkewedInfo": {
      "SkewedColumnNames": ["string", ...],
      "SkewedColumnValues": ["string", ...],
      "SkewedColumnValueLocationMaps": {"string": "string"
        ...}
    },
    "StoredAsSubDirectories": true|false,
    "SchemaReference": {
      "SchemaId": {
        "SchemaArn": "string",
        "SchemaName": "string",
        "RegistryName": "string"
      },
      "SchemaVersionId": "string",
      "SchemaVersionNumber": long
    }
  },
  "PartitionKeys": [
    {
      "Name": "string",
      "Type": "string",
      "Comment": "string",
      "Parameters": {"string": "string"
        ...}
    }
    ...
  ],
  "ViewOriginalText": "string",
  "ViewExpandedText": "string",
  "TableType": "string",
  "Parameters": {"string": "string"
    ...},
  "TargetTable": {
    "CatalogId": "string",
    "DatabaseName": "string",
    "Name": "string",
    "Region": "string"
  },
  "ViewDefinition": {
    "IsProtected": true|false,
    "Definer": "string",
    "Representations": [
      {
        "Dialect": "REDSHIFT"|"ATHENA"|"SPARK",
        "DialectVersion": "string",
        "ViewOriginalText": "string",
        "ValidationConnection": "string",
        "ViewExpandedText": "string"
      }
      ...
    ],
    "SubObjects": ["string", ...]
  }
}

--skip-archive | --no-skip-archive (булево)

По умолчанию, UpdateTable всегда создает архивную версию таблицы перед обновлением. Однако, если skipArchive установлено в значение true, UpdateTable не создает архивную версию.

--transaction-id (строка)

Идентификатор транзакции, в рамках которой необходимо обновить содержимое таблицы.

--version-id (строка)

Идентификатор версии, в рамках которой необходимо обновить содержимое таблицы.

--view-update-action (строка)

Операция, которая должна быть выполнена при обновлении представления.

Возможные значения:

  • ADD
  • REPLACE
  • ADD_OR_REPLACE
  • DROP

--force | --no-force (булево)

Флаг, который может быть установлен в значение true для игнорирования соответствия описанию хранилища и требованиям сопоставления подобъектов.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставляются в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного JSON, поскольку строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводится пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено значение yaml-input, будет выведен пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладочную запись в журнал.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команд.

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • включено
  • выключено
  • автоматически

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл с сертификатом CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию - 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию - 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка в кодировке base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить пагинатор cli для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры входных данных CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запроса параметров входных данных CLI.

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API