Class: Aws::SageMaker::Types::CreateFeatureGroupRequest

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-sagemaker/types.rb

Overview

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#descriptionString

A free-form description of a ‘FeatureGroup`.

Returns:

  • (String)


6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#event_time_feature_nameString

The name of the feature that stores the ‘EventTime` of a `Record` in a `FeatureGroup`.

An ‘EventTime` is a point in time when a new event occurs that corresponds to the creation or update of a `Record` in a `FeatureGroup`. All `Records` in the `FeatureGroup` must have a corresponding `EventTime`.

An ‘EventTime` can be a `String` or `Fractional`.

  • ‘Fractional`: `EventTime` feature values must be a Unix timestamp in seconds.

  • ‘String`: `EventTime` feature values must be an ISO-8601 string in the format. The following formats are supported `yyyy-MM-dd’T’HH:mm:ssZ` and ‘yyyy-MM-dd’T’HH:mm:ss.SSSZ` where ‘yyyy`, `MM`, and `dd` represent the year, month, and day respectively and `HH`, `mm`, `ss`, and if applicable, `SSS` represent the hour, month, second and milliseconds respsectively. `’T’‘ and `Z` are constants.

Returns:

  • (String)


6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#feature_definitionsArray<Types::FeatureDefinition>

A list of ‘Feature` names and types. `Name` and `Type` is compulsory per `Feature`.

Valid feature ‘FeatureType`s are `Integral`, `Fractional` and `String`.

‘FeatureName`s cannot be any of the following: `is_deleted`, `write_time`, `api_invocation_time`

You can create up to 2,500 ‘FeatureDefinition`s per `FeatureGroup`.

Returns:



6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#feature_group_nameString

The name of the ‘FeatureGroup`. The name must be unique within an Amazon Web Services Region in an Amazon Web Services account.

The name:

  • Must start with an alphanumeric character.

  • Can only include alphanumeric characters, underscores, and hyphens. Spaces are not allowed.

Returns:

  • (String)


6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#offline_store_configTypes::OfflineStoreConfig

Use this to configure an ‘OfflineFeatureStore`. This parameter allows you to specify:

  • The Amazon Simple Storage Service (Amazon S3) location of an ‘OfflineStore`.

  • A configuration for an Amazon Web Services Glue or Amazon Web Services Hive data catalog.

  • An KMS encryption key to encrypt the Amazon S3 location used for ‘OfflineStore`. If KMS encryption key is not specified, by default we encrypt all data at rest using Amazon Web Services KMS key. By defining your [bucket-level key] for SSE, you can reduce Amazon Web Services KMS requests costs by up to 99 percent.

  • Format for the offline store table. Supported formats are Glue (Default) and [Apache Iceberg].

To learn more about this parameter, see [OfflineStoreConfig].

[1]: docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-key.html [2]: iceberg.apache.org/ [3]: docs.aws.amazon.com/sagemaker/latest/APIReference/API_OfflineStoreConfig.html



6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#online_store_configTypes::OnlineStoreConfig

You can turn the ‘OnlineStore` on or off by specifying `True` for the `EnableOnlineStore` flag in `OnlineStoreConfig`.

You can also include an Amazon Web Services KMS key ID (‘KMSKeyId`) for at-rest encryption of the `OnlineStore`.

The default value is ‘False`.



6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#record_identifier_feature_nameString

The name of the ‘Feature` whose value uniquely identifies a `Record` defined in the `FeatureStore`. Only the latest record per identifier value will be stored in the `OnlineStore`. `RecordIdentifierFeatureName` must be one of feature definitions’ names.

You use the ‘RecordIdentifierFeatureName` to access data in a `FeatureStore`.

This name:

  • Must start with an alphanumeric character.

  • Can only contains alphanumeric characters, hyphens, underscores. Spaces are not allowed.

Returns:

  • (String)


6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#role_arnString

The Amazon Resource Name (ARN) of the IAM execution role used to persist data into the ‘OfflineStore` if an `OfflineStoreConfig` is provided.

Returns:

  • (String)


6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#tagsArray<Types::Tag>

Tags used to identify ‘Features` in each `FeatureGroup`.

Returns:



6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#throughput_configTypes::ThroughputConfig

Used to set feature group throughput configuration. There are two modes: ‘ON_DEMAND` and `PROVISIONED`. With on-demand mode, you are charged for data reads and writes that your application performs on your feature group. You do not need to specify read and write throughput because Feature Store accommodates your workloads as they ramp up and down. You can switch a feature group to on-demand only once in a 24 hour period. With provisioned throughput mode, you specify the read and write capacity per second that you expect your application to require, and you are billed based on those limits. Exceeding provisioned throughput will result in your requests being throttled.

Note: ‘PROVISIONED` throughput mode is supported only for feature groups that are offline-only, or use the [ `Standard` ][1] tier online store.

[1]: docs.aws.amazon.com/sagemaker/latest/APIReference/API_OnlineStoreConfig.html#sagemaker-Type-OnlineStoreConfig-StorageType



6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
# File 'lib/aws-sdk-sagemaker/types.rb', line 6902

class CreateFeatureGroupRequest < Struct.new(
  :feature_group_name,
  :record_identifier_feature_name,
  :event_time_feature_name,
  :feature_definitions,
  :online_store_config,
  :offline_store_config,
  :throughput_config,
  :role_arn,
  :description,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end