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 -> (строка)
DisableGlueTableCreation -> (булево)
Установите в True, чтобы отключить автоматическое создание таблицы Amazon Web Services Glue при настройке OfflineStore. Если установлено в False, Feature Store назовёт таблицу Glue OfflineStore в соответствии с рекомендациями Athena.
Значение по умолчанию — False.
DataCatalogConfig -> (структура)
Метаданные таблицы Glue, которая автоматически генерируется при создании OfflineStore.
TableName -> (строка)
Catalog -> (строка)
Database -> (строка)
TableFormat -> (строка)
Сокращённый синтаксис:
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)
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)
FeatureGroup. Это уникальный идентификатор для группы функций.
© Copyright 2025, Amazon Web Services. Created using Sphinx.