[ aws . timestream-query ]
describe-scheduled-query
Описание
Предоставляет подробную информацию о запланированном запросе.
См. также: Документация AWS API
Синтаксис
describe-scheduled-query
--scheduled-query-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]
Параметры
--scheduled-query-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
- таблица
- 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.
Вывод
ScheduledQuery -> (структура)
Расписание запроса.
Arn -> (строка)
Name -> (строка)
QueryString -> (строка)
CreationTime -> (временная метка)
State -> (строка)
PreviousInvocationTime -> (временная метка)
NextInvocationTime -> (временная метка)
ScheduleConfiguration -> (структура)
Настройка расписания.
ScheduleExpression -> (строка)
NotificationConfiguration -> (структура)
Настройка уведомлений.
SnsConfiguration -> (структура)
Подробности о настройке Amazon Simple Notification Service (SNS). Это поле отображается только при предоставлении темы SNS при обновлении настроек учетной записи.
TopicArn -> (строка)
TargetConfiguration -> (структура)
Настройка назначения хранилища для расписанного запроса.
TimestreamConfiguration -> (структура)
Настройки для записи данных в базу данных Timestream и таблицу.
DatabaseName -> (строка)
TableName -> (строка)
TimeColumn -> (строка)
DimensionMappings -> (список)
Это позволяет сопоставить столбцы из результата запроса с измерениями в целевой таблице.
(структура)
Этот тип используется для сопоставления столбцов из результата запроса с измерением в целевой таблице.
Name -> (строка)
DimensionValueType -> (строка)
MultiMeasureMappings -> (структура)
Сопоставления для нескольких измерений.
TargetMultiMeasureName -> (строка)
MultiMeasureAttributeMappings -> (список)
Обязательно. Сопоставления атрибутов для сопоставления результатов запроса с данными, которые будут загружены для атрибутов нескольких измерений.
(структура)
Сопоставление атрибутов для значений измерений MULTI.
SourceColumn -> (строка)
TargetMultiMeasureAttributeName -> (строка)
MeasureValueType -> (строка)
MixedMeasureMappings -> (список)
Указывает, как сопоставить измерения с записями нескольких измерений.
(структура)
MixedMeasureMappings - это сопоставления, которые могут использоваться для загрузки данных в смесь узких и нескольких измерений в таблице вывода.
MeasureName -> (строка)
SourceColumn -> (строка)
TargetMeasureName -> (строка)
MeasureValueType -> (строка)
MultiMeasureAttributeMappings -> (список)
Требуется, когда measureValueType равен MULTI. Сопоставления атрибутов для значений измерений MULTI.
(структура)
Сопоставление атрибутов для значений измерений MULTI.
SourceColumn -> (строка)
TargetMultiMeasureAttributeName -> (строка)
MeasureValueType -> (строка)
MeasureNameColumn -> (строка)
ScheduledQueryExecutionRoleArn -> (строка)
KmsKeyId -> (строка)
ErrorReportConfiguration -> (структура)
Настройка отчетов об ошибках для расписанного запроса.
S3Configuration -> (структура)
Настройка S3 для отчетов об ошибках.
BucketName -> (строка)
ObjectKeyPrefix -> (строка)
EncryptionOption -> (строка)
LastRunSummary -> (структура)
Резюме выполнения последнего запуска расписанного запроса.
InvocationTime -> (временная метка)
@scheduled_runtime может быть использован в запросе для получения значения.TriggerTime -> (временная метка)
RunStatus -> (строка)
ExecutionStats -> (структура)
Статистика выполнения расписанного запуска.
ExecutionTimeInMillis -> (длинное целое число)
DataWrites -> (длинное целое число)
BytesMetered -> (длинное целое число)
CumulativeBytesScanned -> (длинное целое число)
RecordsIngested -> (длинное целое число)
QueryResultRows -> (длинное целое число)
QueryInsightsResponse -> (структура)
Предоставляет различные сведения и метрики, связанные с резюме выполнения расписанного запроса.
QuerySpatialCoverage -> (структура)
Предоставляет сведения о пространственном охвате запроса, включая таблицу с неэффективным (максимальным) пространственным прореживанием. Эта информация может помочь вам определить области для улучшения вашей стратегии разбиения, чтобы улучшить пространственное прореживание.
Max -> (структура)
Предоставляет сведения о пространственном охвате выполненного запроса и таблице с наименее эффективным пространственным прореживанием.
-
Value– Максимальное соотношение пространственного охвата. -
TableArn– Amazon Resource Name (ARN) таблицы с неэффективным пространственным прореживанием. -
PartitionKey– Ключ разбиения, используемый для разбиения, который может быть по умолчаниюmeasure_nameили CDPK.
Value -> (двойное число)
TableArn -> (строка)
PartitionKey -> (список)
Ключ разбиения, используемый для разбиения, который может быть по умолчанию measure_name или пользовательским ключом разбиения.
(строка)
QueryTemporalRange -> (структура)
Предоставляет сведения о временном диапазоне запроса, включая таблицу с наибольшим (максимальным) временным диапазоном. Вот некоторые потенциальные варианты оптимизации временного прореживания:
- Добавить недостающие временные предикаты.
- Удалить функции вокруг временных предикатов.
- Добавить временные предикаты ко всем подзапросам.
Max -> (структура)
Содержит следующие свойства, предоставляющие сведения о таблице с наихудшей производительностью по временной оси:
-
Value– Максимальная продолжительность в наносекундах между началом и концом запроса. -
TableArn– Amazon Resource Name (ARN) таблицы, которая запрашивается с наибольшим временным диапазоном.
Value -> (длинное целое число)
TableArn -> (строка)
QueryTableCount -> (длинное целое число)
OutputRows -> (длинное целое число)
OutputBytes -> (длинное целое число)
ErrorReportLocation -> (структура)
Местоположение в S3 для отчета об ошибках.
S3ReportLocation -> (структура)
Местоположение в S3, где записываются отчеты об ошибках.
BucketName -> (строка)
ObjectKey -> (строка)
FailureReason -> (строка)
RecentlyFailedRuns -> (список)
Краткое описание последнего запуска запланированного запроса, завершившегося ошибкой (за последние пять запусков).
(структура)
Описание запуска запланированного запроса
InvocationTime -> (временная метка)
@scheduled_runtime может быть использован в запросе для получения этого значения.TriggerTime -> (временная метка)
RunStatus -> (строка)
ExecutionStats -> (структура)
Статистические данные выполнения для запланированного запуска.
ExecutionTimeInMillis -> (длинное целое)
DataWrites -> (длинное целое)
BytesMetered -> (длинное целое)
CumulativeBytesScanned -> (длинное целое)
RecordsIngested -> (длинное целое)
QueryResultRows -> (длинное целое)
QueryInsightsResponse -> (структура)
Предоставляет различные сведения и метрики, связанные с описанием запуска запланированного запроса.
QuerySpatialCoverage -> (структура)
Предоставляет сведения о пространственном охвате запроса, включая таблицу с неэффективными (максимальными) пространственными сокращениями. Эта информация может помочь вам определить области для улучшения стратегии разбиения, чтобы повысить эффективность пространственного сокращения.
Max -> (структура)
Предоставляет сведения о пространственном охвате выполненного запроса и таблице с наименее эффективным пространственным сокращением.
-
Value– Максимальное соотношение пространственного охвата. -
TableArn– Amazon Resource Name (ARN) таблицы с неэффективным пространственным сокращением. -
PartitionKey– Ключ разбиения, используемый для разбиения, который может быть стандартнымmeasure_nameили CDPK.
Value -> (двойное число)
TableArn -> (строка)
PartitionKey -> (список)
Ключ разбиения, используемый для разбиения, который может быть стандартным measure_name или пользовательским ключом разбиения.
(строка)
QueryTemporalRange -> (структура)
Предоставляет сведения о временном диапазоне запроса, включая таблицу с наибольшим (максимальным) временным диапазоном. Ниже приведены некоторые потенциальные варианты оптимизации временного сокращения:
- Добавить недостающие временные предикаты.
- Удалить функции вокруг временных предикатов.
- Добавить временные предикаты ко всем подзапросам.
Max -> (структура)
Содержит следующие свойства, которые предоставляют информацию о наиболее неэффективной таблице на временной оси:
-
Value– Максимальная продолжительность в наносекундах между началом и концом запроса. -
TableArn– Amazon Resource Name (ARN) таблицы, которая запрашивается с наибольшим временным диапазоном.
Value -> (длинное целое)
TableArn -> (строка)
QueryTableCount -> (длинное целое)
OutputRows -> (длинное целое)
OutputBytes -> (длинное целое)
ErrorReportLocation -> (структура)
Местоположение в S3 для отчета об ошибках.
S3ReportLocation -> (структура)
Местоположение в S3, где записываются отчеты об ошибках.
BucketName -> (строка)
ObjectKey -> (строка)
FailureReason -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.