기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS IoT TwinMaker Athena 테이블 형식 데이터 커넥터
Athena 테이블 형식 데이터 커넥터를 사용하면 AWS IoT TwinMaker에서 Athena 데이터 저장소에 액세스하여 사용할 수 있습니다. 집중적인 데이터 마이그레이션 작업 없이 Athena 데이터를 사용하여 디지털 트윈을 구축할 수 있습니다. 사전 구축된 커넥터를 사용하거나 사용자 지정 Athena 커넥터를 생성하여 Athena 데이터 소스의 데이터에 액세스할 수 있습니다.
## AWS IoT TwinMaker Athena 데이터 커넥터 사전 조건
Athena 테이블 형식 데이터 커넥터를 사용하기 전에 다음 사전 조건을 완료합니다.
+ 관리형 Athena 테이블 및 관련 Amazon S3 리소스를 생성합니다. Athena 사용에 대한 자세한 내용은 [Athena 설명서](https://docs.aws.amazon.com//athena/latest/ug/what-is.html)를 참조하십시오.
+ AWS IoT TwinMaker 워크스페이스를 생성합니다. [AWS IoT TwinMaker 콘솔](https://console.aws.amazon.com/iottwinmaker/)에서 작업 영역을 생성할 수 있습니다.
+ Athena 권한으로 워크스페이스 IAM 역할을 업데이트합니다. 자세한 내용은 [Athena 데이터 커넥터를 사용하도록 워크스페이스 IAM 역할을 수정합니다.](twinmaker-gs-service-role.md#athena-tabular-data-connector-ws-IAM) 단원을 참조하십시오.
+ AWS IoT TwinMaker의 개체 구성 요소 시스템과 개체를 생성하는 방법을 숙지합니다. 자세한 내용은 [첫 번째 개체 생성](twinmaker-gs-entity.md) 단원을 참조하십시오.
+ AWS IoT TwinMaker의 데이터 커넥터에 익숙해지세요. 자세한 내용은 [AWS IoT TwinMaker 데이터 커넥터](data-connector-interface.md) 단원을 참조하십시오.
## Athena 데이터 커넥터 사용하기
Athena 데이터 커넥터를 사용하려면 Athena 커넥터를 구성 요소 유형으로 사용하여 구성 요소를 만들어야 합니다. 그런 다음 구성 요소를 장면 내의 개체에 첨부하여 AWS IoT TwinMaker에서 사용할 수 있습니다.
**Athena 데이터 커넥터를 사용하여 구성 요소 유형 만들기**
다음 절차에 따라 Athena 테이블 형식 데이터 커넥터를 사용하여 AWS IoT TwinMaker 구성 요소 유형을 생성합니다.
1. [AWS IoT TwinMaker 콘솔](https://console.aws.amazon.com/iottwinmaker/)로 이동합니다.
1. 기존 작업 영역을 열거나 [새 작업 영역을 생성합니다](twinmaker-gs-workspace.md).
1. 왼쪽 탐색 메뉴에서 **구성 요소 유형**을 선택하고 **구성 요소 유형 생성**을 선택하여 구성요소 유형 생성 페이지를 엽니다.
1. **구성 요소 유형 생성** 페이지에서 사용 사례에 맞는 ID로 **ID** 필드를 채웁니다.
1. **기본 유형**을 선택합니다. 드롭다운 목록에서 **com.amazon.athena.connector**라는 레이블이 붙은 Athena 테이블 형식 데이터 커넥터를 선택합니다.
1. 다음 필드에서 Athena 리소스를 선택하여 구성 요소 유형의 **데이터 소스**를 구성합니다.
+ **Athena 데이터 소스를** 선택합니다.
+ **Athena database** 데이터베이스를 선택합니다.
+ **Table name**을 선택합니다.
+ **Athena workGroup**을 선택하십시오.
1. 데이터 소스로 사용할 Athena 리소스를 선택한 후 테이블에서 포함할 열을 선택합니다.
1. **External ID column name**을 선택합니다. 이전 단계에서 외부 ID 열로 사용할 열을 선택합니다. 외부 ID는 Athena 자산을 나타내고 AWS IoT TwinMaker 개체에 매핑하는 데 사용되는 ID입니다.
1. **(선택 사항)** 이러한 리소스에 AWS 태그를 추가하여 태그를 그룹화하고 구성할 수 있습니다.
1. **구성 요소 유형 생성**을 선택하여 구성 요소 유형 생성을 완료합니다.
**Athena 데이터 커넥터 유형으로 컴포넌트를 생성하여 개체에 연결**
다음 절차에 따라 Athena 테이블 형식 데이터 커넥터를 사용하여 AWS IoT TwinMaker 구성 요소를 생성하고 개체에 연결합니다.
이 절차를 완료하려면 Athena 테이블 형식 데이터 커넥터를 데이터 소스로 사용하는 기존 구성 요소 유형이 있어야 합니다. 이 연습을 시작하기 전에 이전의 절차인 **Athena 데이터 커넥터를 사용하여 구성 요소 유형 만들기**를 참조하십시오.
1. [AWS IoT TwinMaker 콘솔](https://console.aws.amazon.com/iottwinmaker/)로 이동합니다.
1. 기존 작업 영역을 열거나 [새 작업 영역을 생성합니다](twinmaker-gs-workspace.md).
1. 왼쪽 탐색 메뉴에서 **개체를** 선택하고 구성 요소를 추가하거나 새 개체를 생성할 개체를 선택합니다.
1. [ 새 개체를 생성합니다](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/twinmaker-gs-entity.html).
1. 그런 다음 **구성 요소 추가**를 선택합니다. **구성 요소 이름** 필드에 사용 사례에 맞는 이름을 입력합니다.
1. **구성 요소 유형** 드롭다운 메뉴에서 이전 절차에서 만든 **구성 요소 유형 ID**를 선택합니다.
1. **구성 요소 정보**, **구성 요소 이름**을 입력하고 이전에 만든 하위 ComponentType을 선택합니다. Athena 데이터 커넥터를 사용하여 만든 ComponentType입니다.
1. **속성** 섹션에서 구성 요소에 대한 **athenaComponentExternalId**에 입력합니다.
1. **구성 요소 추가**를 선택하여 구성 요소 생성을 완료합니다.
이제 Athena 데이터 커넥터를 구성 요소 유형으로 사용하여 구성 요소를 성공적으로 생성하여 개체에 연결했습니다.
## Athena 테이블 형식 데이터 커넥터 JSON 참조 사용
다음 예는 Athena 테이블 형식 데이터 커넥터에 대한 전체 JSON 참조입니다. 이를 리소스로 사용하여 사용자 지정 데이터 커넥터 및 구성 요소 유형을 만듭니다.
```
{
"componentTypeId": "com.amazon.athena.connector",
"description": "Athena connector for syncing tabular data",
"workspaceId":"AmazonOwnedTypesWorkspace",
"propertyGroups": {
"tabularPropertyGroup": {
"groupType": "TABULAR",
"propertyNames": []
}
},
"propertyDefinitions": {
"athenaDataSource": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaDatabase": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaTable": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaWorkgroup": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaExternalIdColumnName": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true,
"isExternalId": false
},
"athenaComponentExternalId": {
"dataType": { "type": "STRING" },
"isStoredExternally": false,
"isRequiredInEntity": true,
"isExternalId": true
}
},
"functions": {
"tabularDataReaderByEntity": {
"implementedBy": {
"isNative": true
}
}
}
}
```
## Athena 데이터 커넥터 사용하기
Grafana에서 Athena 테이블을 사용하는 개체를 표시할 수 있습니다. 자세한 내용은 [AWS IoT TwinMaker Grafana 대시보드 통합을](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html) 참조하십시오.
Athena 테이블을 만들고 사용하여 데이터를 저장하는 방법에 대한 자세한 내용은 [Athena 설명서](https://docs.aws.amazon.com//athena/latest/ug/what-is.html)를 참조하십시오.
### Athena 데이터 커넥터 문제 해결
이 주제에서는 Athena 데이터 커넥터를 구성할 때 발생할 수 있는 일반적인 문제를 다룹니다.
Athena 작업 그룹 위치:
Athena 커넥터 componentType을 생성할 때는 Athena 작업그룹에 출력 위치가 설정되어 있어야 합니다. [작업 그룹 작업 방법](https://docs.aws.amazon.com//athena/latest/ug/user-created-workgroups.html)을 참조하십시오.
IAM 역할 권한 누락:
componentType을 생성하거나, 개체에 Ca 구성 요소를 추가하거나, GetPropertyValue API를 실행할 때 AWS IoT TwinMaker; 워크스페이스 역할에 Athena API 액세스 권한이 누락되었을 수 있습니다. IAM 권한을 업데이트하려면 [에 대한 서비스 역할 생성 및 관리를 AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html) 참조하세요.
## Grafana에서 Athena의 테이블 형식 데이터를 시각화하십시오.
Grafana 플러그인은에 대한 API 호출 AWS IoT TwinMaker또는 Athena와의 상호 작용 없이 선택한 속성을 기반으로 정렬 및 필터링과 같은 추가 기능을 사용하여 대시보드 패널인 Grafana에서 테이블 형식 데이터를 시각화하는 데에도 사용할 수 있습니다. 이 주제에서는 Athena 테이블 형식 데이터를 시각화하도록 Grafana를 구성하는 방법을 보여 줍니다.
### 사전 요구 사항
Athena 테이블 형식 데이터를 시각화하기 위해 Grafana 패널을 구성하기 전에 다음 사전 요구 사항을 검토하십시오.
+ Grafana 환경을 설정했습니다. 자세한 내용은 [AWS IoT TwinMaker Grafana 통합](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html)을 참조하십시오.
+ Grafana 데이터 소스를 구성할 수 있습니다. 자세한 내용은 [ Grafana AWS IoT TwinMaker](https://github.com/grafana/grafana-iot-twinmaker-app/blob/main/src/datasource/README.md)를 참조하세요.
+ 새 대시보드를 만들고 새 패널을 추가하는 방법에 익숙합니다.
### Grafana에서 Athena의 테이블 형식 데이터를 시각화하십시오.
이 절차는 Athena 테이블 형식 데이터를 시각화하기 위해 Grafana 패널을 설정하는 방법을 보여줍니다.
1. AWS IoT TwinMaker Grafana 대시보드를 엽니다.
1. 패널 설정에서 **테이블** 패널을 선택합니다.
1. 쿼리 구성에서 데이터 소스를 선택합니다.
1. **속성 값 가져오기** 쿼리를 선택합니다.
1. 개체를 선택합니다.
1. **Athena 기본 구성 요소 유형**을 확장하는 componentType이 있는 구성 요소를 선택합니다.
1. Athena 테이블의 속성 그룹을 선택합니다.
1. 속성 그룹에서 원하는 수의 속성을 선택합니다.
1. 필터 및 속성 순서 목록을 통해 표 형식의 조건을 구성합니다. 다음 옵션이 있습니다.
+ **필터**: 속성 값의 표현식을 정의하여 데이터를 필터링합니다.
+ **OrderBy**: 속성에 대해 데이터를 오름차순 또는 내림차순으로 반환할지 여부를 지정합니다.
