Spec-Zone.ru › AWS CLI v2

[ aws . sagemaker ]

create-feature-group

Описание

Создайте новую FeatureGroup . FeatureGroup — это группа Features, определённых в FeatureStore, чтобы описать Record.

FeatureGroup определяет схему и признаки, содержащиеся в FeatureGroup. Определение FeatureGroup состоит из списка Features, RecordIdentifierFeatureName, EventTimeFeatureName и конфигураций для его OnlineStore и OfflineStore. Проверьте квоты служб Amazon Web Services, чтобы узнать квоту FeatureGroup для вашей учётной записи Amazon Web Services.

Обратите внимание, что на предоставление OnlineStore FeatureGroup с InMemory StorageType может потребоваться приблизительно 10-15 минут.

Предупреждение

Вы должны включить по крайней мере один из OnlineStoreConfig и OfflineStoreConfig для создания FeatureGroup.

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

Синтаксис

  create-feature-group
--feature-group-name <value>
--record-identifier-feature-name <value>
--event-time-feature-name <value>
--feature-definitions <value>
[--online-store-config <value>]
[--offline-store-config <value>]
[--throughput-config <value>]
[--role-arn <value>]
[--description <value>]
[--tags <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]

Параметры

--feature-group-name (строка)

Имя группы FeatureGroup. Имя должно быть уникальным в регионе Amazon Web Services и в аккаунте Amazon Web Services.

Имя должно:

  • Начинаться с буквенно-цифрового символа.
  • Содержать только буквенно-цифровые символы, символы подчеркивания и дефисы. Пробелы запрещены.

--record-identifier-feature-name (строка)

Имя Feature, значение которого однозначно идентифицирует Record, определённую в FeatureStore. В OnlineStore будет храниться только последняя запись на каждый идентификатор. RecordIdentifierFeatureName должно соответствовать одному из имён определений функций.

Используйте RecordIdentifierFeatureName для доступа к данным в FeatureStore.

Это имя:

  • Должно начинаться с буквенно-цифрового символа.
  • Может содержать только буквенно-цифровые символы, дефисы и символы подчеркивания. Пробелы запрещены.

--event-time-feature-name (строка)

Имя функции, которая хранит EventTime события Record в FeatureGroup.

EventTime — момент времени, когда происходит новое событие, соответствующее созданию или обновлению Record в FeatureGroup. Все Records в FeatureGroup должны иметь соответствующее EventTime.

EventTime может быть String или Fractional.

  • Fractional: Значения функций EventTime должны быть метками времени Unix в секундах.
  • String: Значения функций EventTime должны быть строкой в формате ISO-8601. Поддерживаются следующие форматы: yyyy-MM-dd'T'HH:mm:ssZ и yyyy-MM-dd'T'HH:mm:ss.SSSZ, где yyyy, MM и dd представляют соответственно год, месяц и день, а HH, mm, ss и, при необходимости, SSS представляют соответственно час, месяц, секунду и миллисекунды. 'T' и Z — константы.

--feature-definitions (список)

Список имён и типов Feature. Name и Type обязательны для каждой Feature.

Допустимые типы FeatureType — Integral, Fractional и String.

FeatureName не могут быть ни одним из следующих: is_deleted, write_time, api_invocation_time

Вы можете создать до 2500 FeatureDefinition для каждой FeatureGroup.

(структура)

Список функций. Вы должны включить FeatureName и FeatureType. Допустимые типы FeatureType — Integral, Fractional и String.

FeatureName -> (строка)

Имя функции. Тип должен быть строкой. FeatureName не может быть ни одним из следующих: is_deleted, write_time, api_invocation_time.

Имя должно:

  • Начинаться с буквенно-цифрового символа.
  • Содержать только буквенно-цифровые символы, символы подчеркивания и дефисы. Пробелы запрещены.

FeatureType -> (строка)

Тип значения функции. Допустимые значения — Целое, Дробное или Строка.

CollectionType -> (строка)

Группа элементов, где каждый элемент в группе должен иметь тот же тип функции (String, Integral или Fractional).

  • List: Последовательность элементов.
  • Set: Неупорядоченная последовательность уникальных элементов.
  • Vector: Специализированный список, представляющий массив элементов фиксированного размера. Размерность вектора определяется вами. Должны содержать элементы с дробным типом функции.

CollectionConfig -> (структура помеченных объединений)

Конфигурация вашей коллекции.

Примечание

Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть задан: VectorConfig.

VectorConfig -> (структура)

Конфигурация вашего типа коллекции векторов.

  • Dimension: Количество элементов в вашем векторе.

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

Количество элементов в вашем векторе.

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

FeatureName=string,FeatureType=string,CollectionType=string,CollectionConfig={VectorConfig={Dimension=integer}} ...

Синтаксис JSON:

[
  {
    "FeatureName": "string",
    "FeatureType": "Integral"|"Fractional"|"String",
    "CollectionType": "List"|"Set"|"Vector",
    "CollectionConfig": {
      "VectorConfig": {
        "Dimension": integer
      }
    }
  }
  ...
]

--online-store-config (структура)

Вы можете включить или отключить OnlineStore, указав True для флага EnableOnlineStore в OnlineStoreConfig.

Вы также можете указать идентификатор ключа Amazon Web Services KMS (KMSKeyId) для шифрования данных OnlineStore в состоянии покоя.

Значение по умолчанию — False.

SecurityConfig -> (структура)

Используйте для указания идентификатора ключа KMS (KMSKeyId) для шифрования ваших данных OnlineStore в состоянии покоя.

KmsKeyId -> (строка)

Идентификатор ресурса ключа управления ключами Amazon Web Services (KMS), который SageMaker Feature Store использует для шифрования объектов Amazon S3 в состоянии покоя с использованием шифрования на стороне сервера Amazon S3.

Вызывающий абонент (пользователь или роль IAM) операции CreateFeatureGroup должен иметь указанные ниже разрешения на доступ к ключу OnlineStore KmsKeyId:

  • "kms:Encrypt"
  • "kms:Decrypt"
  • "kms:DescribeKey"
  • "kms:CreateGrant"
  • "kms:RetireGrant"
  • "kms:ReEncryptFrom"
  • "kms:ReEncryptTo"
  • "kms:GenerateDataKey"
  • "kms:ListAliases"
  • "kms:ListGrants"
  • "kms:RevokeGrant"

Вызывающий абонент (пользователь или роль IAM) всех операций с DataPlane (PutRecord, GetRecord, DeleteRecord) должен иметь следующие разрешения на доступ к ключу KmsKeyId:

  • "kms:Decrypt"

EnableOnlineStore -> (булево)

Отключить OnlineStore, указав False для флага EnableOnlineStore. Включить OnlineStore, указав True для флага EnableOnlineStore.

Значение по умолчанию — False.

TtlDuration -> (структура)

Срок хранения, после которого запись удаляется окончательно; ExpiresAt = EventTime + TtlDuration. Подробности об окончательном удалении см. в разделе API DeleteRecord в руководстве по API Amazon SageMaker.

Unit -> (строка)

Единица измерения TtlDuration.

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

Значение TtlDuration.

StorageType -> (строка)

Варианты различных уровней хранилища с низкой задержкой для получения данных в реальном времени.

  • Standard: Управляемое хранилище данных с низкой задержкой для групп функций.
  • InMemory: Управляемое хранилище данных для групп функций, которое поддерживает очень низкую задержку доступа.

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

SecurityConfig={KmsKeyId=string},EnableOnlineStore=boolean,TtlDuration={Unit=string,Value=integer},StorageType=string

Синтаксис JSON:

{
  "SecurityConfig": {
    "KmsKeyId": "string"
  },
  "EnableOnlineStore": true|false,
  "TtlDuration": {
    "Unit": "Seconds"|"Minutes"|"Hours"|"Days"|"Weeks",
    "Value": integer
  },
  "StorageType": "Standard"|"InMemory"
}

--offline-store-config (структура)

Используйте для настройки OfflineFeatureStore. Этот параметр позволяет указать:

  • Расположение Amazon Simple Storage Service (Amazon S3) OfflineStore.
  • Конфигурацию каталога данных Amazon Web Services Glue или Amazon Web Services Hive.
  • Ключ шифрования KMS для шифрования расположения Amazon S3, используемого для OfflineStore. Если ключ шифрования KMS не указан, по умолчанию все данные шифруются в состоянии покоя с помощью ключа KMS Amazon Web Services. Определив свой ключ на уровне ведра для SSE, вы можете уменьшить расходы на запросы Amazon Web Services KMS до 99 процентов.
  • Формат таблицы автономного хранилища. Поддерживаются форматы Glue (по умолчанию) и Apache Iceberg.

Дополнительные сведения об этом параметре см. в разделе OfflineStoreConfig.

S3StorageConfig -> (структура)

Расположение Amazon Simple Storage (Amazon S3) OfflineStore.

S3Uri -> (строка)

S3 URI или расположение в Amazon S3 OfflineStore.

S3 URI имеют формат, аналогичный следующему: s3://example-bucket/prefix/.

KmsKeyId -> (строка)

Идентификатор ресурса ключа управления ключами Amazon Web Services (KMS) ключа, используемого для шифрования любых объектов, записанных в расположение S3 OfflineStore.

IAM-роль roleARN, которая передаётся в качестве параметра к CreateFeatureGroup, должна иметь указанные ниже разрешения доступа к KmsKeyId:

  • "kms:GenerateDataKey"

ResolvedOutputS3Uri -> (строка)

Путь в S3, где записываются автономные записи.

DisableGlueTableCreation -> (булево)

Установите в True, чтобы отключить автоматическое создание таблицы Amazon Web Services Glue при настройке OfflineStore. Если установлено в False, Feature Store назовёт таблицу Glue OfflineStore в соответствии с рекомендациями Athena.

Значение по умолчанию — False.

DataCatalogConfig -> (структура)

Метаданные таблицы Glue, которая автоматически генерируется при создании OfflineStore.

TableName -> (строка)

Имя таблицы Glue.

Catalog -> (строка)

Имя каталога таблицы Glue.

Database -> (строка)

Имя базы данных таблицы Glue.

TableFormat -> (строка)

Формат таблицы автономного хранилища. Поддерживаются форматы Glue (по умолчанию) и Apache Iceberg.

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

S3StorageConfig={S3Uri=string,KmsKeyId=string,ResolvedOutputS3Uri=string},DisableGlueTableCreation=boolean,DataCatalogConfig={TableName=string,Catalog=string,Database=string},TableFormat=string

Синтаксис JSON:

{
  "S3StorageConfig": {
    "S3Uri": "string",
    "KmsKeyId": "string",
    "ResolvedOutputS3Uri": "string"
  },
  "DisableGlueTableCreation": true|false,
  "DataCatalogConfig": {
    "TableName": "string",
    "Catalog": "string",
    "Database": "string"
  },
  "TableFormat": "Default"|"Glue"|"Iceberg"
}

--throughput-config (структура)

Используется для настройки конфигурации пропускной способности группы функций. Существуют два режима: ON_DEMAND и PROVISIONED. В режиме по запросу вы платите за чтение и запись данных, которые выполняет ваше приложение в вашей группе функций. Вам не нужно указывать пропускную способность чтения и записи, поскольку Feature Store адаптируется к вашим рабочим нагрузкам по мере их нарастания и снижения. Вы можете переключить группу функций на режим по запросу только один раз в 24 часа. В режиме выделенной пропускной способности вы указываете требуемую пропускную способность чтения и записи в секунду, которую, как ожидается, будет использовать ваше приложение, и оплачиваете по этим лимитам. Превышение выделенной пропускной способности приведет к ограничению ваших запросов.

Примечание: PROVISIONED режим пропускной способности поддерживается только для групп функций, которые являются только автономными или используют ` Standard https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_OnlineStoreConfig.html#sagemaker-Type-OnlineStoreConfig-StorageType`__ уровень онлайн-хранилища.

ThroughputMode -> (string)

Режим, используемый для вашей группы функций: ON_DEMAND или PROVISIONED.

ProvisionedReadCapacityUnits -> (integer)

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

Это поле не применимо для групп функций по запросу.

ProvisionedWriteCapacityUnits -> (integer)

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

Это поле не применимо для групп функций по запросу.

Краткая синтаксическая запись:

ThroughputMode=string,ProvisionedReadCapacityUnits=integer,ProvisionedWriteCapacityUnits=integer

Синтаксис JSON:

{
  "ThroughputMode": "OnDemand"|"Provisioned",
  "ProvisionedReadCapacityUnits": integer,
  "ProvisionedWriteCapacityUnits": integer
}

--role-arn (string)

Amazon Resource Name (ARN) роли IAM выполнения, используемой для сохранения данных в OfflineStore, если предоставлен OfflineStoreConfig.

--description (string)

Свободное описание FeatureGroup.

--tags (list)

Теги, используемые для идентификации Features в каждой FeatureGroup.

(структура)

Объект тега, состоящий из ключа и необязательного значения, используемый для управления метаданными для ресурсов SageMaker Amazon Web Services.

Вы можете добавлять теги к экземплярам ноутбуков, задачам обучения, задачам настройки гиперпараметров, задачам пакетного преобразования, моделям, задачам маркировки, рабочим группам, конфигурациям конечных точек и конечным точкам. Дополнительную информацию об добавлении тегов к ресурсам SageMaker см. в разделе AddTags .

Дополнительную информацию о добавлении метаданных к вашим ресурсам Amazon Web Services с помощью тегов см. в разделе Тегирование ресурсов Amazon Web Services . Советы по лучшим практикам управления ресурсами Amazon Web Services с помощью тегов см. в разделе Практические рекомендации по тегированию: внедрение эффективной стратегии тегирования ресурсов Amazon Web Services .

Key -> (string)

Ключ тега. Ключи тегов должны быть уникальными для каждого ресурса.

Value -> (string)

Значение тега.

Краткая синтаксическая запись:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

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

--generate-cli-skeleton (string) Выводит 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-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Вывод

FeatureGroupArn -> (string)

Amazon Resource Name (ARN) FeatureGroup. Это уникальный идентификатор для группы функций.

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

Spec-Zone.ru

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