разделение-шарда

Описание

Разделяет шард на два новых шарда в потоке данных Kinesis, чтобы увеличить емкость потока для приема и передачи данных. SplitShard вызывается, когда требуется увеличить общую емкость потока из-за ожидаемого увеличения объема записей данных, принимаемых на вход. Этот API поддерживается только для потоков данных с режимом предоставленной емкости.

Вы также можете использовать SplitShard, когда шард, по-видимому, приближается к максимальной загрузке; например, производители, отправляющие данные в конкретный шард, внезапно отправляют больше данных, чем ожидалось ранее. Вы также можете вызвать SplitShard для увеличения емкости потока, чтобы больше приложений Kinesis Data Streams могли одновременно читать данные из потока для обработки в режиме реального времени.

Вы должны указать шард для разделения и новый хеш-ключ, который представляет собой позицию в шарде, где шард разделяется на два. В многих случаях новый хеш-ключ может быть средним значением начального и конечного хеш-ключа, но это может быть любое значение хеш-ключа в диапазоне, отображаемом в шард. Дополнительную информацию см. в разделе Разделение шарда в Руководстве разработчика Amazon Kinesis Data Streams.

Вы можете использовать API DescribeStreamSummary и ListShards для определения идентификатора шарда и значений хеш-ключа для параметров ShardToSplit и NewStartingHashKey, указанных в запросе SplitShard.

Вы можете использовать DescribeStreamSummary для проверки состояния потока, которое возвращается в StreamStatus. Если поток находится в состоянии ACTIVE, вы можете вызвать SplitShard.

Если указанный поток не существует, DescribeStreamSummary возвращает ResourceNotFoundException. Если вы пытаетесь создать больше шардов, чем разрешено для вашей учетной записи, вы получите LimitExceededException.

Предельные значения для шардов в аккаунте Amazon Web Services см. в разделе Пределы Kinesis Data Streams в Руководстве разработчика Amazon Kinesis Data Streams. Для увеличения этого предела обратитесь в службу поддержки Amazon Web Services.

Если вы пытаетесь одновременно обработать слишком много потоков с использованием CreateStream, DeleteStream, MergeShards и/или SplitShard, вы получите LimitExceededException.

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

Синтаксис

  split-shard
[--stream-name <value>]
--shard-to-split <value>
--new-starting-hash-key <value>
[--stream-arn <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]

Параметры

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

--shard-to-split (строка)

--new-starting-hash-key (строка)

--stream-arn (строка)

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

Отключить пейджер CLI для вывода.

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

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

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

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

Примеры

Для разделения шардов

Следующий split-shard пример разделяет указанный шард на два новых шарда, используя новый начальный хеш-ключ 10.

aws kinesis split-shard \
    --stream-name samplestream \
    --shard-to-split shardId-000000000000 \
    --new-starting-hash-key 10

Эта команда не выводит никаких данных.

Дополнительную информацию см. в разделе Разделение шардов в Руководстве разработчика Amazon Kinesis Data Streams.

Вывод

Нет