Обновление таблицы
Описание
Обновляет таблицу метаданных в каталоге данных.
См. также: Документацию 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 (строка)
--database-name (строка)
--table-input (структура)
Обновленный объект TableInput, определяющий таблицу метаданных в каталоге.
Имя -> (строка)
Описание -> (строка)
Владелец -> (строка)
Последнее время доступа -> (метка времени)
Последнее время анализа -> (метка времени)
Срок хранения -> (целое число)
Описание хранилища -> (структура)
Описание хранилища, содержащее информацию о физическом хранении этой таблицы.
Столбцы -> (список)
Список Columns в таблице.
(структура)
Столбец в Table.
Имя -> (строка)
Column.Тип -> (строка)
Column.Комментарий -> (строка)
Параметры -> (словарь)
Эти пары ключ-значение определяют свойства, связанные со столбцом.
ключ -> (строка)
значение -> (строка)
Расположение -> (строка)
Дополнительные расположения -> (список)
Список расположений, указывающих на путь, где расположена таблица Delta.
(строка)
Формат входных данных -> (строка)
SequenceFileInputFormat (двоичный), или TextInputFormat, или пользовательский формат.Формат выходных данных -> (строка)
SequenceFileOutputFormat (двоичный), или IgnoreKeyTextOutputFormat, или пользовательский формат.Сжатие -> (булево)
True, если данные в таблице сжаты, или False, если нет.Количество блоков -> (целое число)
Информация о сериализации/десериализации -> (структура)
Информация о сериализации/десериализации (SerDe).
Имя -> (строка)
Библиотека сериализации -> (строка)
org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.Параметры -> (словарь)
Эти пары ключ-значение определяют параметры инициализации для SerDe.
ключ -> (строка)
значение -> (строка)
Столбцы блоков -> (список)
Список столбцов группировки редукторов, столбцов кластеризации и столбцов букетирования в таблице.
(строка)
Столбцы сортировки -> (список)
Список, определяющий порядок сортировки каждого букета в таблице.
(структура)
Определяет порядок сортировки сортированного столбца.
Столбец -> (строка)
Порядок сортировки -> (целое число)
== 1), или в порядке убывания (==0).Параметры -> (словарь)
Пользовательские свойства в формате ключ-значение.
ключ -> (строка)
значение -> (строка)
Информация о смещенных значениях -> (структура)
Информация о значениях, которые часто встречаются в столбце (смещенные значения).
Имена смещенных столбцов -> (список)
Список имен столбцов, содержащих смещенные значения.
(строка)
Смещенные значения столбцов -> (список)
Список значений, которые настолько часто встречаются, что считаются смещенными.
(строка)
Сопоставления смещенных значений столбцов -> (словарь)
Сопоставление смещенных значений со столбцами, которые их содержат.
ключ -> (строка)
значение -> (строка)
Хранение в подкаталогах -> (булево)
True, если данные таблицы хранятся в подкаталогах, или False, если нет.Ссылка на схему -> (структура)
Объект, который ссылается на схему, хранящуюся в Glue Schema Registry.
При создании таблицы вы можете передать пустой список столбцов для схемы и вместо этого использовать ссылку на схему.
Идентификатор схемы -> (структура)
Структура, содержащая поля идентификации схемы. Или это, или SchemaVersionId должно быть предоставлено.
ARN схемы -> (строка)
SchemaArn, либо SchemaName.Имя схемы -> (строка)
SchemaArn, либо SchemaName.Имя реестра -> (строка)
Идентификатор версии схемы -> (строка)
SchemaId должно быть предоставлено.Номер версии схемы -> (длинное целое число)
Ключи разбиения -> (список)
Список столбцов, по которым разбивается таблица. В качестве ключей разбиения поддерживаются только примитивные типы.
При создании таблицы, используемой Amazon Athena, и вы не указываете никаких partitionKeys, вы должны по крайней мере установить значение partitionKeys в пустой список. Например:
"PartitionKeys": [](структура)
Столбец в Table.
Имя -> (строка)
Column.Тип -> (строка)
Column.Комментарий -> (строка)
Параметры -> (словарь)
Эти пары ключ-значение определяют свойства, связанные со столбцом.
ключ -> (строка)
значение -> (строка)
ViewOriginalText -> (строка)
VIRTUAL_VIEW, определенные конфигурации Athena закодированы в base64.ViewExpandedText -> (строка)
Тип таблицы -> (строка)
Тип этой таблицы. Glue создает таблицы с типом EXTERNAL_TABLE. Другие службы, такие как Athena, могут создавать таблицы с дополнительными типами таблиц.
Типы таблиц Glue:
Совместимый атрибут Hive - указывает таблицу, не управляемую Hive.
Используется Lake Formation. Glue Data Catalog понимает GOVERNED.
Параметры -> (словарь)
Эти пары ключ-значение определяют свойства, связанные с таблицей.
ключ -> (строка)
значение -> (строка)
Целевая таблица -> (структура)
Структура TableIdentifier, описывающая целевую таблицу для связывания ресурсов.
Идентификатор каталога -> (строка)
Имя базы данных -> (строка)
Имя -> (строка)
Регион -> (строка)
Определение представления -> (структура)
Структура, содержащая всю информацию, определяющую представление, включая диалект или диалекты для представления и запрос.
Защищено -> (булево)
Определяющий -> (строка)
Представления -> (список)
Список структур, содержащих диалект представления и запрос, определяющий представление.
(структура)
Структура, содержащая сведения о представлении для обновления или создания представления Lake Formation.
Диалект -> (строка)
Версия диалекта -> (строка)
ViewOriginalText -> (строка)
Подключение для проверки -> (строка)
ViewExpandedText -> (строка)
Подобъекты -> (список)
Список базовых 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 (строка)
Операция, которая должна быть выполнена при обновлении представления.
Возможные значения:
ADDREPLACEADD_OR_REPLACEDROP
--force | --no-force (булево)
--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.