[ aws . qldb-сессия ]
send-command
Описание
Отправляет команду в журнал Amazon QLDB.
Примечание
Вместо непосредственного взаимодействия с этим API, рекомендуется использовать драйвер QLDB или оболочку QLDB для выполнения операций с данными в журнале.
- При работе с AWS SDK используйте драйвер QLDB. Драйвер предоставляет высокоуровневый абстрактный слой над этим QLDB Session планом данных и управляет
SendCommandвызовами API за вас. Для получения информации и списка поддерживаемых языков программирования, см. Начало работы с драйвером в руководстве по разработке Amazon QLDB. - При работе с AWS CLI (интерфейсом командной строки AWS) используйте оболочку QLDB. Оболочка представляет собой интерфейс командной строки, который использует драйвер QLDB для взаимодействия с журналом. Для получения информации см. Доступ к Amazon QLDB с помощью оболочки QLDB.
См. также: Документация API AWS
Синтаксис
send-command
[--session-token <value>]
[--start-session <value>]
[--start-transaction <value>]
[--end-session <value>]
[--commit-transaction <value>]
[--abort-transaction <value>]
[--execute-statement <value>]
[--fetch-page <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]
Параметры
--session-token (строка)
Указывает токен сессии для текущей команды. Токен сессии остается постоянным на протяжении всей сессии.
Для получения токена сессии выполните команду StartSession. Этот SessionToken требуется для каждой последующей команды, выпущенной в текущей сессии.
--start-session (структура)
Команда для начала новой сессии. Токен сессии получается в качестве части ответа.
LedgerName -> (строка)
Сокращенный синтаксис:
LedgerName=string
Синтаксис JSON:
{
"LedgerName": "string"
}
--start-transaction (структура)
Синтаксис JSON:
{
}
--end-session (структура)
Синтаксис JSON:
{
}
--commit-transaction (структура)
Команда для подтверждения указанной транзакции.
TransactionId -> (строка)
CommitDigest -> (байты)
Указывает дайджест подтверждения для транзакции. Для каждой активной транзакции дайджест подтверждения должен быть передан. QLDB проверяет CommitDigest и отклоняет подтверждение с ошибкой, если дайджест, вычисленный на клиенте, не совпадает с дайджестом, вычисленным QLDB.
Цель параметра CommitDigest — гарантировать, что QLDB подтвердит транзакцию только в том случае, если сервер обработает точный набор инструкций, отправленных клиентом, в том же порядке, что и клиент, и без дубликатов.
Сокращенный синтаксис:
TransactionId=string,CommitDigest=blob
Синтаксис JSON:
{
"TransactionId": "string",
"CommitDigest": blob
}
--abort-transaction (структура)
Синтаксис JSON:
{
}
--execute-statement (структура)
Команда для выполнения инструкции в указанной транзакции.
TransactionId -> (строка)
Statement -> (строка)
Parameters -> (список)
Указывает параметры для параметризованной инструкции в запросе.
(структура)
Структура, которая может содержать значение в нескольких форматах кодирования.
IonBinary -> (байты)
ValueHolder.IonText -> (строка)
ValueHolder.Сокращенный синтаксис:
TransactionId=string,Statement=string,Parameters=[{IonBinary=blob,IonText=string},{IonBinary=blob,IonText=string}]
Синтаксис JSON:
{
"TransactionId": "string",
"Statement": "string",
"Parameters": [
{
"IonBinary": blob,
"IonText": "string"
}
...
]
}
--fetch-page (структура)
Команда для получения страницы.
TransactionId -> (строка)
NextPageToken -> (строка)
Сокращенный синтаксис:
TransactionId=string,NextPageToken=string
Синтаксис JSON:
{
"TransactionId": "string",
"NextPageToken": "string"
}
--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.
Вывод
StartSession -> (структура)
Содержит подробности о начатой сессии, включая маркер сессии. Это SessionToken необходимо для каждой последующей команды, выпущенной во время текущей сессии.
SessionToken -> (строка)
SessionToken необходимо для каждой последующей команды, выпущенной во время текущей сессии.TimingInformation -> (структура)
Содержит информацию о производительности на стороне сервера для команды.
ProcessingTimeMilliseconds -> (длинное целое)
StartTransaction -> (структура)
Содержит подробности о начатой транзакции.
TransactionId -> (строка)
TimingInformation -> (структура)
Содержит информацию о производительности на стороне сервера для команды.
ProcessingTimeMilliseconds -> (длинное целое)
EndSession -> (структура)
Содержит подробности о завершенной сессии.
TimingInformation -> (структура)
Содержит информацию о производительности на стороне сервера для команды.
ProcessingTimeMilliseconds -> (длинное целое)
CommitTransaction -> (структура)
Содержит подробности о подтвержденной транзакции.
TransactionId -> (строка)
CommitDigest -> (байтовый массив)
TimingInformation -> (структура)
Содержит информацию о производительности на стороне сервера для команды.
ProcessingTimeMilliseconds -> (длинное целое)
ConsumedIOs -> (структура)
Содержит метрики о количестве потребленных запросов ввода-вывода.
ReadIOs -> (длинное целое)
WriteIOs -> (длинное целое)
AbortTransaction -> (структура)
Содержит подробности об отмененной транзакции.
TimingInformation -> (структура)
Содержит информацию о производительности на стороне сервера для команды.
ProcessingTimeMilliseconds -> (длинное целое)
ExecuteStatement -> (структура)
Содержит подробности о выполненном операторе.
FirstPage -> (структура)
Содержит подробности о первой полученной странице.
Values -> (список)
Структура, содержащая значения в нескольких форматах кодирования.
(структура)
Структура, которая может содержать значение в нескольких форматах кодирования.
IonBinary -> (байтовый массив)
ValueHolder.IonText -> (строка)
ValueHolder.NextPageToken -> (строка)
TimingInformation -> (структура)
Содержит информацию о производительности на стороне сервера для команды.
ProcessingTimeMilliseconds -> (длинное целое)
ConsumedIOs -> (структура)
Содержит метрики о количестве потребленных запросов ввода-вывода.
ReadIOs -> (длинное целое)
WriteIOs -> (длинное целое)
FetchPage -> (структура)
Содержит подробности о полученной странице.
Page -> (структура)
Содержит подробности о полученной странице.
Values -> (список)
Структура, содержащая значения в нескольких форматах кодирования.
(структура)
Структура, которая может содержать значение в нескольких форматах кодирования.
IonBinary -> (байтовый массив)
ValueHolder.IonText -> (строка)
ValueHolder.NextPageToken -> (строка)
TimingInformation -> (структура)
Содержит информацию о производительности на стороне сервера для команды.
ProcessingTimeMilliseconds -> (длинное целое)
ConsumedIOs -> (структура)
Содержит метрики о количестве потребленных запросов ввода-вывода.
ReadIOs -> (длинное целое)
WriteIOs -> (длинное целое)
© Copyright 2025, Amazon Web Services. Created using Sphinx.