Spec-Zone.ru › AWS CLI v2

[ aws . glue ]

get-partitions

Описание

Извлекает информацию о разделах в таблице.

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

get-partitions является постраничной операцией. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничную обработку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе на запрос с постраничной обработкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Partitions

Синтаксис

  get-partitions
[--catalog-id <value>]
--database-name <value>
--table-name <value>
[--expression <value>]
[--segment <value>]
[--exclude-column-schema | --no-exclude-column-schema]
[--transaction-id <value>]
[--query-as-of-time <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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 (строка)

Имя таблицы разделов.

--expression (строка)

Выражение для фильтрации возвращаемых разделов.

Выражение использует синтаксис SQL, аналогичный синтаксису фильтрации SQL-запроса WHERE. Парсер SQL-выражений JSQLParser анализирует выражение.

Операторы: Ниже приведены операторы, которые можно использовать в вызове API Expression:

=

Проверяет, равны ли значения двух операндов; если равны, то условие истинно.

Пример: Предположим, что переменная 'a' имеет значение 10, а переменная 'b' – 20.

(a = b) – неверно.

< >

Проверяет, равны ли значения двух операндов; если значения не равны, то условие истинно.

Пример: (a < > b) – верно.

>

Проверяет, больше ли значение левого операнда значения правого операнда; если больше, то условие истинно.

Пример: (a > b) – неверно.

<

Проверяет, меньше ли значение левого операнда значения правого операнда; если меньше, то условие истинно.

Пример: (a < b) – верно.

>=

Проверяет, больше или равно ли значение левого операнда значения правого операнда; если больше или равно, то условие истинно.

Пример: (a >= b) – неверно.

<=

Проверяет, меньше или равно ли значение левого операнда значения правого операнда; если меньше или равно, то условие истинно.

Пример: (a <= b) – верно.

AND, OR, IN, BETWEEN, LIKE, NOT, IS NULL

Логические операторы.

Поддерживаемые типы ключей разделов: Ниже приведены поддерживаемые ключи разделов.
  • string
  • date
  • timestamp
  • int
  • bigint
  • long
  • tinyint
  • smallint
  • decimal

Если обнаружится недопустимый тип, будет выброшено исключение.

Ниже приведен список допустимых операторов для каждого типа. При определении ползунка создаётся partitionKey тип как STRING для совместимости с разделами каталога.

Пример вызова API :

--segment (структура)

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

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

Номера сегмента, начиная с нуля. Например, если общее количество сегментов равно 4, значения SegmentNumber варьируются от 0 до 3.

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

Общее количество сегментов.

Сокращённый синтаксис:

SegmentNumber=integer,TotalSegments=integer

Синтаксис JSON:

{
  "SegmentNumber": integer,
  "TotalSegments": integer
}

--exclude-column-schema | --no-exclude-column-schema (логическое значение)

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

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

Идентификатор транзакции, на котором нужно прочитать содержимое раздела.

--query-as-of-time (временная метка)

Время, по состоянию на которое следует прочитать содержимое раздела. Если не задано, будет использоваться время последнего завершения транзакции. Нельзя указать вместе с TransactionId.

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

--starting-token (строка)

Маркер для указания места начала постраничной обработки. Это NextToken из ранее усечённого ответа.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS CLI.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые необходимо вернуть в выводе команды. Если общее количество доступных элементов больше заданного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничную обработку, укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken непосредственно вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--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 (логическое значение)

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

Разбиения -> (список)

Список запрошенных разбиений.

(структура)

Представляет срез данных таблицы.

Значения -> (список)

Значения разбиения.

(строка)

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

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

Имя таблицы -> (строка)

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

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

Время создания разбиения.

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

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

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

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

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

Список 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.

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

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

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

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

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

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

Имя схемы. Должен быть предоставлен один из SchemaArn или SchemaName.

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

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

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

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

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

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

Параметры -> (карта)

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

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

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

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

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

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

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

Маркер следующей страницы -> (строка)

Маркер продолжения, если возвращённый список разбиений не включает последнее.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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