create-dataset-import-job
Описание
Импортирует данные обучения в набор данных Amazon Forecast. Вы предоставляете расположение данных обучения в ведре Amazon Simple Storage Service (Amazon S3) и Amazon Resource Name (ARN) набора данных, в который вы хотите импортировать данные.
Вы должны указать объект DataSource, который включает роль Identity and Access Management (IAM), которую Amazon Forecast может принять, чтобы получить доступ к данным, так как Amazon Forecast создаёт копию ваших данных и обрабатывает их во внутренней системе Amazon Web Services. Дополнительную информацию см. в разделе Настройка разрешений.
Данные обучения должны быть в формате CSV или Parquet. Разделитель должен быть запятой (,).
Вы можете указать путь к конкретному файлу, ведру S3 или папке в ведре S3. В последних двух случаях Amazon Forecast импортирует все файлы до предела в 10 000 файлов.
Поскольку импорты наборов данных не агрегируются, ваш самый последний импорт набора данных используется при обучении предиктора или генерации прогноза. Убедитесь, что ваш последний импорт набора данных содержит все данные, по которым вы хотите создать модель, а не только новые данные, собранные с момента предыдущего импорта.
Чтобы получить список всех ваших заданий импорта набора данных, отфильтрованных по указанным критериям, используйте операцию ListDatasetImportJobs.
См. также: Документация по API AWS
Синтаксис
create-dataset-import-job
--dataset-import-job-name <value>
--dataset-arn <value>
--data-source <value>
[--timestamp-format <value>]
[--time-zone <value>]
[--use-geolocation-for-time-zone | --no-use-geolocation-for-time-zone]
[--geolocation-format <value>]
[--tags <value>]
[--format <value>]
[--import-mode <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]
Параметры
--dataset-import-job-name (строка)
20190721DatasetImport . Это может помочь вам избежать получения исключения ResourceAlreadyExistsException.--dataset-arn (строка)
--data-source (структура)
Расположение данных обучения для импорта и роль Identity and Access Management (IAM), которую Amazon Forecast может принять, чтобы получить доступ к данным. Данные обучения должны храниться в ведре Amazon S3.
Если используется шифрование, DataSource должен содержать ключ Key Management Service (KMS), а роль IAM должна разрешать Amazon Forecast доступ к ключу. Ключ KMS и роль IAM должны совпадать с теми, что указаны в параметре EncryptionConfig операции CreateDataset.
S3Config -> (структура)
Путь к данным, хранящимся в ведре Amazon Simple Storage Service (Amazon S3), а также учетные данные для доступа к данным.
Path -> (строка)
RoleArn -> (строка)
ARN роли Identity and Access Management (IAM), которую Amazon Forecast может принять для доступа к ведру Amazon S3 или файлам. Если вы предоставите значение для ключа KMSKeyArn, роль должна разрешить доступ к ключу.
Передача роли между учетными записями Amazon Web Services запрещена. Если вы передадите роль, которая не находится в вашей учетной записи, вы получите ошибку InvalidInputException.
KMSKeyArn -> (строка)
Сокращённый синтаксис:
S3Config={Path=string,RoleArn=string,KMSKeyArn=string}
Синтаксис JSON:
{
"S3Config": {
"Path": "string",
"RoleArn": "string",
"KMSKeyArn": "string"
}
}
--timestamp-format (строка)
Формат меток времени в наборе данных. Формат, который вы указываете, зависит от DataFrequency, указанного при создании набора данных. Поддерживаются следующие форматы:
- “yyyy-MM-dd” для следующих частот данных: Y, M, W и D
- “yyyy-MM-dd HH:mm:ss” для следующих частот данных: H, 30min, 15min и 1min; и необязательно для: Y, M, W и D
Если формат не указан, Amazon Forecast ожидает формат “yyyy-MM-dd HH:mm:ss”.
--time-zone (строка)
Единственный часовой пояс для каждого элемента в вашем наборе данных. Этот параметр идеален для наборов данных со всеми метками времени в одном часовом поясе или если все метки времени нормализованы к одному часовому поясу.
Обратитесь к API Joda-Time для получения полного списка допустимых названий часовых поясов.
--use-geolocation-for-time-zone | --no-use-geolocation-for-time-zone (булево)
--geolocation-format (строка)
Формат атрибута геолокации. Атрибут геолокации может быть отформатирован двумя способами:
LAT_LONG— широта и долгота в десятичном формате (Пример: 47.61_-122.33).CC_POSTALCODE(только США) — код страны (US), за которым следует 5-значный почтовый индекс (Пример: US_98121).
--tags (список)
Необязательные метаданные, которые вы применяете к заданию импорта набора данных, чтобы помочь вам классифицировать и организовать их. Каждый тег состоит из ключа и необязательного значения, которые вы определяете.
Применяются следующие основные ограничения к тегам:
- Максимальное количество тегов на ресурс — 50.
- Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
- Максимальная длина ключа — 128 символов Юникода в UTF-8.
- Максимальная длина значения — 256 символов Юникода в UTF-8.
- Если ваша схема тегов используется в нескольких службах и ресурсах, помните, что другие службы могут иметь ограничения на разрешенные символы. В общем, разрешенными являются: буквы, цифры и пробелы, представляемые в UTF-8, а также следующие символы: + - = . _ : / @.
- Ключи и значения тегов чувствительны к регистру.
- Не используйте
aws:,AWS:или любые сочетания таких префиксов в верхнем или нижнем регистре, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи тегов с этим префиксом. Значения могут иметь этот префикс. Если значение тега имеетawsв качестве префикса, но ключ — нет, то Forecast считает его пользовательским тегом и включит его в лимит в 50 тегов. Теги только с префиксом ключаawsне учитываются в лимите тегов на ресурс.
(структура)
Необязательные метаданные, которые вы применяете к ресурсу, чтобы помочь вам классифицировать и организовать их. Каждый тег состоит из ключа и необязательного значения, которые вы определяете.
Применяются следующие основные ограничения к тегам:
- Максимальное количество тегов на ресурс — 50.
- Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
- Максимальная длина ключа — 128 символов Юникода в UTF-8.
- Максимальная длина значения — 256 символов Юникода в UTF-8.
- Если ваша схема тегов используется в нескольких службах и ресурсах, помните, что другие службы могут иметь ограничения на разрешенные символы. В общем, разрешенными являются: буквы, цифры и пробелы, представляемые в UTF-8, а также следующие символы: + - = . _ : / @.
- Ключи и значения тегов чувствительны к регистру.
- Не используйте
aws:,AWS:или любые сочетания таких префиксов в верхнем или нижнем регистре, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи тегов с этим префиксом. Значения могут иметь этот префикс. Если значение тега имеетawsв качестве префикса, но ключ — нет, то Forecast считает его пользовательским тегом и включит его в лимит в 50 тегов. Теги только с префиксом ключаawsне учитываются в лимите тегов на ресурс.
Key -> (строка)
Value -> (строка)
Сокращённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--format (строка)
--import-mode (строка)
Указывает, является ли задание импорта набора данных импортом FULL или INCREMENTAL. Импорт набора данных FULL заменяет все существующие данные новыми импортированными данными. Импорт INCREMENTAL добавляет импортированные данные к существующим данным.
Возможные значения:
FULLINCREMENTAL
--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 (boolean)
Включить отладочную запись в журнал.
--endpoint-url (string)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет параметры из конфигурации/среды.
--version (string)
Показать версию этого инструмента.
--color (string)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл с сертификатом CA для проверки SSL-сертификатов. Переопределяет параметры из конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат 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 (boolean)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматический запрос параметров ввода CLI.
Вывод
DatasetImportJobArn -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.