기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 작업 데이터 세트 스키마 요구 사항(사용자 지정)
<a name="action-dataset-requirements"></a>

작업은 고객에게 추천하고 싶은 참여 활동입니다.** 작업에는 모바일 앱 설치, 멤버십 프로필 작성, 로열티 프로그램 가입, 프로모션 이메일 구독 등이 포함될 수 있습니다. 작업 데이터 세트는 사용자 행동에 대한 데이터를 저장합니다.** Amazon Personalize로 가져올 수 있는 작업 데이터 유형에 대한 내용은 [작업 메타데이터](actions-datasets.md) 섹션을 참조하세요.

 각 작업에 제공하는 데이터는 작업 데이터 세트 스키마와 일치해야 합니다. 스키마에 따라 작업 메타데이터에는 비어 있음/null 값이 포함될 수 있습니다.

최소한 각 항목의 작업 ID(최대 길이 256자)를 제공해야 합니다. 스키마에는 최소 하나 이상의 메타데이터 필드가 있어야 하지만 `null` 유형을 추가할 경우 작업에 대해 이 값이 null이 될 수 있습니다. 사용 사례와 데이터에 따라 별도의 필드를 추가할 수 있습니다. 필드가 필수 또는 예약된 상태로 나열되고 데이터 유형이 [스키마 데이터 유형](how-it-works-dataset-schema.md#personalize-datatypes)에 나열되지 않는 한, 필드 이름과 데이터 유형을 선택할 수 있습니다.

 범주형 필드를 추가하려면 스키마에서 `string` 유형 필드를 추가하고 필드의 범주형 속성을 `true`로 설정합니다. 그런 다음 대량 CSV 파일 및 개별 작업 가져오기에 범주형 데이터를 포함합니다. 범주형 값은 최대 1000자까지 포함할 수 있습니다. 범주형 값이 1,000자를 초과하는 작업이 있는 경우 데이터 세트 가져오기 작업이 실패합니다.

 작업 데이터 세트에 대한 자세한 최소 요구 사항 및 최대 데이터 한도 정보는 [Service Quotas](limits.md#limits-table) 섹션을 참조하세요.

## 작업 데이터 세트 스키마 예제(사용자 지정)
<a name="schema-examples-actions"></a>

다음 예제에서는 작업 스키마를 구성하는 방법을 보여줍니다. `ACTION_ID` 필드는 필수 사항입니다. `MEMBERSHIP_LEVEL` 필드는 범주형 문자열 필드입니다. `VALUE`, `CREATION_TIMESTAMP`, `REPEAT_FREQUENCY` 필드는 필수 유형이 포함된 예약된 키워드입니다. 최대 10개의 열을 추가할 수 있습니다. 스키마 요구 사항에 대한 자세한 내용은 [사용자 지정 데이터세트 및 스키마 요구 사항](custom-datasets-and-schemas.md#dataset-requirements)단원을 참조하세요.

```
{
  "type": "record",
  "name": "Actions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ACTION_ID",
      "type": "string"
    },
    {
      "name": "VALUE",
      "type": [
        "null",
        "long"
      ]
    },
    
    {
      "name": "MEMBERSHIP_LEVEL",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "REPEAT_FREQUENCY",
      "type": [
        "long",
        "null"
      ]
    }
  ],
  "version": "1.0"
}
```

이 스키마의 경우, CSV 파일의 이력 데이터의 처음 몇 줄은 다음과 같을 수 있습니다.

```
ACTION_ID,VALUE,MEMBERSHIP_LEVEL,CREATION_TIMESTAMP,REPEAT_FREQUENCY
1,10,Deluxe|Premium,1510003267,7
2,5,Basic,1580003267,7
3,5,Preview,1590003267,3
4,10,Deluxe|Platinum,1560003267,4
...
...
```