기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Connect 분석 데이터 레이크의 사례 데이터
이 주제에서는 Amazon Connect 데이터 레이크 사례 테이블의 내용을 자세히 설명합니다. 테이블에는 콘텐츠의 열, 유형 및 설명이 나열됩니다.
분석 데이터 레이크에 액세스하고 공유할 데이터를 구성하는 두 가지 방법이 있습니다.
+ [옵션 1: Amazon Connect 콘솔 사용](access-datalake.md#option1-configure-data-to-be-shared)
+ [옵션 2: CLI 또는 CloudShell 사용](access-datalake.md#option2-configure-data-to-be-shared)
옵션 1을 사용하여 예약 테이블에 액세스할 수 없는 경우 옵션 2를 사용해 보세요.
**Topics**
+ [사례 이벤트](#data-lake-case-events)
+ [사례 관련 항목 이벤트](#data-lake-case-related-item-events)
## 사례 이벤트
테이블 이름: `case_events`
복합 프라이머리 키: \$1instance\$1id, event\$1id\$1
| **열** | **유형** | **설명** |
| --- | --- | --- |
| instance-id | 문자열 | Amazon Connect 인스턴스의 ID입니다. |
| aws\$1account\$1id | 문자열 | 사례를 소유한 AWS 계정의 ID입니다. |
| event\$1id | 문자열 | 사례 이벤트의 고유 ID입니다. |
| case\$1id | 문자열 | 사례의 ID입니다. |
| event\$1timestamp | 타임스탬프 | 이벤트가 발생한 시점의 UTC 타임스탬프입니다. |
| 변경\$1필드\$1ids | 문자열 배열 | 이 이벤트에서 수정된 필드 IDs. |
| event\$1type | 문자열 | 이벤트의 유형입니다. 유효한 값: CASE.CREATED, CASE.UPDATED, CASE.DELETED. |
| iam\$1principal에 의해\$1수행됨 | 문자열 | 이벤트를 트리거한 개체의 IAM 보안 주체 ARN입니다. |
| 사용자\$1arn\$1에 의해\$1수행됨 | 문자열 | 작업을 수행한 사용자의 ARN입니다. |
| 사용자 지정\$1엔터티별\$1수행 | 문자열 | 작업을 수행한 사용자 지정 개체입니다. |
| case\$1domain\$1arn | 문자열 | Amazon Connect Cases 도메인의 ARN입니다. |
| template\$1id | 문자열 | 사례를 생성하는 데 사용되는 사례 템플릿의 ID입니다. |
| template\$1name | 문자열 | 사례 템플릿의 이름입니다. 템플릿이 삭제된 경우이 값은 비어 있습니다. |
| last\$1updated\$1user | 문자열 | 사례를 업데이트한 마지막 사용자입니다. 시스템 last\$1updated\$1user 필드 값을 참조합니다. |
| reference\$1number | 문자열 | 사례에 대한 사람이 읽을 수 있는 참조 번호입니다. 시스템 reference\$1number 필드 값을 참조합니다. |
| status | 문자열 | 사례의 상태입니다. 시스템 status 필드 값을 참조합니다. |
| 배정된 사용자 | 문자열 | 사례에 할당된 사용자의 ARN입니다. 시스템 assigned\$1user 필드 값을 참조합니다. |
| assigned\$1queue | 문자열 | 사례에 할당된 대기열의 ARN입니다. 시스템 assigned\$1queue 필드 값을 참조합니다. |
| case\$1reason | 문자열 | 사례를 여는 이유입니다. 시스템 case\$1reason 필드 값을 참조합니다. |
| case\$1title | 문자열 | 사례의 제목입니다. 시스템 title 필드 값을 참조합니다. |
| case\$1summary | 문자열 | 사례에 대한 요약입니다. 시스템 summary 필드 값을 참조합니다. |
| customer\$1profile\$1arn | 문자열 | 사례와 연결된 고객 프로필의 ARN입니다. 시스템 customer\$1id 필드 값을 참조합니다. |
| created\$1timestamp | 타임스탬프 | 사례가 생성된 시점의 UTC 타임스탬프입니다. 시스템 created\$1datetime 필드 값을 참조합니다. |
| last\$1updated\$1timestamp | 타임스탬프 | 사례가 마지막으로 업데이트된 시점의 UTC 타임스탬프입니다. 시스템 last\$1updated\$1datetime 필드 값을 참조합니다. |
| next\$1sla\$1breach\$1timestamp | 타임스탬프 | UTC 단위의 다음 SLA 위반 기한의 타임스탬프입니다. 시스템 next\$1sla\$1breach\$1datetime 필드 값을 참조합니다. |
| last\$1closed\$1timestamp | 타임스탬프 | 케이스가 마지막으로 닫힌 시점의 UTC 타임스탬프입니다. 시스템 last\$1closed\$1datetime 필드 값을 참조합니다. |
| last\$1reopened\$1timestamp | 타임스탬프 | 사례가 마지막으로 다시 열린 시점의 UTC 타임스탬프입니다. 시스템 last\$1reopened\$1datetime 필드 값을 참조합니다. |
| custom\$1fields | array(구조) | 사례와 연결된 사용자 지정 필드 데이터가 포함된 객체의 배열입니다. 각 객체에는 필드 id, field\$1name 및 유형별 값 필드(string\$1value, double\$1value, boolean\$1value 또는 timestamp\$1value)가 포함됩니다. |
### 샘플 쿼리
Athena의 다음 예제 쿼리는 사례 이벤트 테이블에서 사용자 지정 필드를 평면화하는 보기를 생성합니다.
```
CREATE VIEW case_events_flattened AS
SELECT
ce.event_id,
ce.case_id,
ce.event_timestamp,
ce.event_type,
ce.instance_id,
-- ... other system fields
-- Flattened custom fields
cf.id AS custom_field_id,
cf.field_name AS custom_field_name,
CASE
WHEN cf.string_value IS NOT NULL THEN 'string'
WHEN cf.double_value IS NOT NULL THEN 'double'
WHEN cf.timestamp_value IS NOT NULL THEN 'timestamp'
WHEN cf.boolean_value IS NOT NULL THEN 'boolean'
ELSE 'unknown'
END AS custom_field_type,
cf.string_value AS custom_field_string_value,
cf.double_value AS custom_field_double_value,
-- Cast milliseconds to timestamp
CAST(from_unixtime(cf.timestamp_value / 1000.0) AS TIMESTAMP) AS custom_field_timestamp_value,
cf.boolean_value AS custom_field_boolean_value
FROM "case_events resource link table name" ce
CROSS JOIN UNNEST(ce.custom_fields) AS t(cf)
```
다음 예제에서는 각 사례에 대한 최신 상태를 반환하는 보기를 생성합니다.
```
CREATE OR REPLACE VIEW latest_case_state AS
SELECT *
FROM (
SELECT *,
ROW_NUMBER() OVER (
PARTITION BY case_id, instance_id
ORDER BY event_timestamp DESC
) AS rn
FROM "case_events resource link table name"
) t
WHERE rn = 1;
```
## 사례 관련 항목 이벤트
테이블 이름: `case_related_item_events`
복합 프라이머리 키: \$1instance\$1id, event\$1id\$1
| **열** | **유형** | **설명** |
| --- | --- | --- |
| instance-id | 문자열 | Amazon Connect 인스턴스의 ID입니다. |
| aws\$1account\$1id | 문자열 | 관련 항목을 소유한 AWS 계정의 ID입니다. |
| event\$1id | 문자열 | 관련 항목 이벤트의 고유 ID입니다. |
| related\$1item\$1id | 문자열 | 관련 항목의 ID입니다. |
| event\$1timestamp | 타임스탬프 | 이벤트가 발생한 시점의 UTC 타임스탬프입니다. |
| event\$1type | 문자열 | 이벤트의 유형입니다. 유효한 값: CASE.RELATED\$1ITEM.CREATED, CASE.RELATED\$1ITEM.UPDATED, CASE.RELATED\$1ITEM.DELETED. |
| iam\$1principal에 의해\$1수행됨 | 문자열 | 이벤트를 트리거한 개체의 IAM 보안 주체 ARN입니다. |
| 사용자\$1arn\$1에 의해\$1수행됨 | 문자열 | 작업을 수행한 사용자의 ARN입니다. |
| 사용자 지정\$1엔터티별\$1수행 | 문자열 | 작업을 수행한 사용자 지정 개체 식별자입니다. |
| case\$1domain\$1arn | 문자열 | Amazon Connect Cases 도메인의 ARN입니다. |
| associated\$1case\$1id | 문자열 | 이 관련 항목이 연결된 사례의 ID입니다. |
| related\$1item\$1type | 문자열 | 관련 항목의 유형입니다. 유효한 값: 주석, 파일, sla, 연결, 연락처, 사용자 지정. |
| created\$1timestamp | 타임스탬프 | 관련 항목이 생성된 시점의 UTC 타임스탬프입니다. |
| Comment\$1본문 | 문자열 | 설명의 본문 텍스트입니다. |
| comment\$1content\$1type | 문자열 | 설명 본문의 콘텐츠 유형입니다. 예: Text/Plain. |
| related\$1case\$1id | 문자열 | 관련 사례의 ID입니다. |
| Contact\$1채널 | 문자열 | 연락처의 통신 채널입니다. 예: VOICE, CHAT, TASK, EMAIL. |
| contact\$1id | 문자열 | 연락처 ID입니다. |
| file\$1arn | 문자열 | 파일 첨부 파일의 ARN입니다. |
| sla\$1name | 문자열 | SLA의 이름입니다. |
| sla\$1status | 문자열 | SLA의 현재 상태입니다. 예: 활성, 기한 경과, 충족, 충족되지 않음. |
| sla\$1target\$1timestamp | 타임스탬프 | SLA의 대상 기한의 UTC 타임스탬프입니다. |
| sla\$1type | 문자열 | 추적 중인 SLA 지표의 유형입니다. CaseField를 예로 들 수 있습니다. |
| sla\$1completion\$1timestamp | 타임스탬프 | SLA가 완료된 시점의 UTC 타임스탬프입니다. |
| sla\$1target\$1field\$1id | 문자열 | SLA가 대상으로 하는 필드의 ID입니다. |
| sla\$1target\$1field\$1values | 문자열 배열 | SLA를 완료하기 위한 sla\$1target\$1field\$1id의 대상 필드 값입니다. |
| custom\$1related\$1item\$1fields | array(구조) | 관련 항목과 연결된 사용자 지정 필드 데이터가 포함된 객체의 배열입니다. 각 객체에는 필드 id, field\$1name 및 유형별 값 필드(string\$1value, double\$1value, boolean\$1value 또는 timestamp\$1value)가 포함됩니다. |