특성 그룹에 특성 및 레코드 추가

Amazon SageMaker Feature Store API 또는 콘솔을 사용하여 특성 그룹을 업데이트 및 설명하고 특성 그룹에 특성과 레코드를 추가할 수 있습니다. 특성 그룹은 데이터를 포함하는 객체이며 특성은 테이블의 열을 설명합니다. 특성 그룹에 특성을 추가하면 테이블에 열이 효과적으로 추가됩니다. 특성 그룹에 새 레코드를 추가하면 특정 레코드 식별자와 관련된 특성의 값이 입력됩니다. 특성 저장소 개념에 대한 자세한 내용은 특성 저장소 개념섹션을 참조하세요.

특성 그룹에 특성을 성공적으로 추가한 후에는 해당 특성을 제거할 수 없습니다. 추가한 특성은 레코드에 데이터를 추가하지 않습니다. 새 레코드를 특성 그룹에 추가하거나 PutRecord API를 사용하여 새 레코드를 덮어쓸 수 있습니다. 레코드를 업데이트 및 설명하고, 특성 그룹에 추가하는 방법에 대한 예는 예제 코드섹션을 참조하세요.

콘솔을 사용하여 특성 그룹에 특성을 추가할 수 있습니다. 콘솔을 사용하여 특성 그룹을 업데이트하는 방법에 대한 자세한 내용은 콘솔에서 특성 그룹 업데이트 섹션을 참조하세요.

다음 섹션에서는 특성 저장소 API를 사용하여 특성 그룹에 특성을 추가하는 방법에 대한 개요와 예제를 제공합니다. API를 사용하면 특성 그룹을 업데이트한 후 레코드를 추가하거나 덮어쓸 수도 있습니다.

API

UpdateFeatureGroup 작업을 사용하여 특성 그룹에 특성을 추가할 수 있습니다.

DescribeFeatureGroup 작업을 사용하여 특성을 성공적으로 추가했는지 확인할 수 있습니다.

레코드를 추가하거나 덮어쓰려면 PutRecord작업을 사용하세요.

레코드에 적용한 업데이트를 보려면 GetRecord작업을 사용하세요. 여러 레코드에 적용한 업데이트를 보려면 BatchGetRecord작업을 사용하세요. 업데이트한 내용이 표시되는 데 최대 5분이 걸릴 수 있습니다.

다음 섹션의 예제 코드를 사용하여 AWS SDK for Python (Boto3)를 통해 특성 및 레코드를 추가하는 과정을 알아봅니다.

예제 코드

예제 코드는 다음 프로세스를 설명합니다.

1. 특성 그룹에 특성 추가

2. 성공적으로 추가했는지 확인

3. 특성 그룹에 레코드 추가

4. 성공적으로 추가했는지 확인

1단계: 특성 그룹에 특성 추가

다음 코드는 UpdateFeatureGroup작업을 사용하여 특성 그룹에 새 특성을 추가합니다. 여기서는 특성 저장소를 설정하고 특성 그룹을 생성했다고 가정합니다. 시작하기에 대한 자세한 내용은 특성 저장소 소개 예제 노트북섹션을 참조하세요.

import boto3

sagemaker_client = boto3.client("sagemaker")

sagemaker_client.update_feature_group(
    FeatureGroupName=feature_group_name,
    FeatureAdditions=[
        {"FeatureName": "new-feature-1", "FeatureType": "Integral"},
        {"FeatureName": "new-feature-2", "FeatureType": "Fractional"},
        {"FeatureName": "new-feature-3", "FeatureType": "String"}
    ]
)              
          

다음 코드에서는 DescribeFeatureGroup작업을 사용하여 업데이트 상태를 확인합니다. LastUpdateStatus 필드가 Successful과 같으면 특성을 성공적으로 추가한 것입니다.

sagemaker_client.describe_feature_group(
    FeatureGroupName=feature_group_name
)
          

2단계: 새 레코드를 특성 그룹에 추가

다음 코드는 PutRecord작업을 사용하여 생성한 특성 그룹에 레코드를 추가합니다.

record_identifier_value = 'new_record'

sagemaker_featurestore_runtime_client = boto3.client("sagemaker-featurestore-runtime")

sagemaker_runtime_client.put_record(
    FeatureGroupName=feature_group_name,
    Record=[
        {
            'FeatureName': "record-identifier-feature-name",
            'ValueAsString': record_identifier_value
        },
        {
            'FeatureName': "event-time-feature",
            'ValueAsString': "timestamp-that-feature-store-returns"
        },
        {
            'FeatureName': "new-feature-1", 
            'ValueAsString': "value-as-string"
        },
        {
            'FeatureName': "new-feature-2", 
            'ValueAsString': "value-as-string"
        },
        {
            'FeatureName': "new-feature-3", 
            'ValueAsString': "value-as-string"
        },
    ]
)              
          

GetRecord 작업을 사용하면 추가한 특성에 대한 데이터가 없는 특성 그룹의 레코드 중 어떤 레코드가 있는지 확인할 수 있습니다. PutRecord 작업을 사용하여 추가한 기능에 대한 데이터가 없는 레코드를 덮어쓸 수 있습니다.