Spec-Zone.ru › AWS CLI v2

[ aws . glue ]

batch-update-partition

Описание

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

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

Синтаксис

  batch-update-partition
[--catalog-id <value>]
--database-name <value>
--table-name <value>
--entries <value>
[--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 (строка)

Имя базы данных метаданных, в которой необходимо обновить партицию.

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

Имя таблицы метаданных, в которой необходимо обновить партицию.

--entries (список)

Список до 100 объектов BatchUpdatePartitionRequestEntry для обновления.

(структура)

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

PartitionValueList -> (список)

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

(строка)

PartitionInput -> (структура)

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

Values -> (список)

Значения партиции. Хотя этот параметр не требуется SDK, вы должны указать этот параметр для допустимого входного значения.

Значения для ключей новой партиции должны быть переданы в виде массива объектов String, которые должны быть упорядочены так же, как ключи партиций, отображаемые в префиксе Amazon S3. В противном случае Glue добавит значения к неправильным ключам.

(строка)

LastAccessTime -> (метка времени)

Последнее время доступа к партиции.

StorageDescriptor -> (структура)

Предоставляет информацию о физическом расположении, где хранится партиция.

Columns -> (список)

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

(структура)

Столбец в Table.

Name -> (строка)

Имя Column.

Type -> (строка)

Тип данных Column.

Comment -> (строка)

Текстовый комментарий в свободном формате.

Parameters -> (карта)

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

key -> (строка)

value -> (строка)

Location -> (строка)

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

AdditionalLocations -> (список)

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

(строка)

InputFormat -> (строка)

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

OutputFormat -> (строка)

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

Compressed -> (булево)

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

NumberOfBuckets -> (целое число)

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

SerdeInfo -> (структура)

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

Name -> (строка)

Имя SerDe.

SerializationLibrary -> (строка)

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

Parameters -> (карта)

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

key -> (строка)

value -> (строка)

BucketColumns -> (список)

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

(строка)

SortColumns -> (список)

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

(структура)

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

Column -> (строка)

Имя столбца.

SortOrder -> (целое число)

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

Parameters -> (карта)

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

key -> (строка)

value -> (строка)

SkewedInfo -> (структура)

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

SkewedColumnNames -> (список)

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

(строка)

SkewedColumnValues -> (список)

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

(строка)

SkewedColumnValueLocationMaps -> (карта)

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

key -> (строка)

value -> (строка)

StoredAsSubDirectories -> (булево)

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

SchemaReference -> (структура)

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

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

SchemaId -> (структура)

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

SchemaArn -> (строка)

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

SchemaName -> (строка)

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

RegistryName -> (строка)

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

SchemaVersionId -> (строка)

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

SchemaVersionNumber -> (длинное целое число)

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

Parameters -> (карта)

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

key -> (строка)

value -> (строка)

LastAnalyzedTime -> (метка времени)

Последнее время вычисления статистических данных столбцов для этой партиции.

Синтаксис JSON:

[
  {
    "PartitionValueList": ["string", ...],
    "PartitionInput": {
      "Values": ["string", ...],
      "LastAccessTime": timestamp,
      "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
        }
      },
      "Parameters": {"string": "string"
        ...},
      "LastAnalyzedTime": timestamp
    }
  }
  ...
]

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

Используйте определённый профиль из файла с вашими учётными данными.

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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 (булево)

Отключает тулбар AWS CLI для вывода.

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

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

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

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

Вывод

Errors -> (список)

Ошибки, возникшие при попытке обновления запрошенных партиций. Список объектов BatchUpdatePartitionFailureEntry.

(структура)

Содержит информацию об ошибке пакетного обновления партиций.

PartitionValueList -> (список)

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

(строка)

ErrorDetail -> (структура)

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

ErrorCode -> (строка)

Код, связанный с этой ошибкой.

ErrorMessage -> (строка)

Сообщение, описывающее ошибку.

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

Spec-Zone.ru

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