# 데이터 소스 커넥터 업데이트
Athena는 사용하는 데이터 소스 커넥터를 최신 버전으로 주기적으로 업데이트하여 새로운 기능과 향상된 기능을 활용하도록 권장합니다. 데이터 소스 커넥터 업데이트에는 다음 단계가 포함됩니다.
# Glue 연결(권장)
## 최신 Athena Query Federation 버전 찾기
Athena 데이터 소스 커넥터의 최신 버전 번호는 최신 Athena Query Federation 버전에 해당됩니다. 경우에 따라 GitHub 릴리스가 AWS Serverless Application Repository(SAR)에서 제공되는 것보다 조금 더 최신일 수 있습니다.
**최신 Athena Query Federation 버전 번호를 찾으려면**
1. GitHub URL [https://github.com/awslabs/aws-athena-query-federation/releases/latest](https://github.com/awslabs/aws-athena-query-federation/releases/latest)를 방문하세요.
1. 기본 페이지 제목의 릴리스 번호를 다음 형식으로 기록합니다.
**Athena Query Federation의** **릴리스 v***year*.*week\$1of\$1year*.*iteration\$1of\$1week*
예를 들어 **Athena Query Federation의 릴리스 v2023.8.3**의 릴리스 번호는 2023.8.3입니다.
## 커넥터 버전 찾기
다음 단계에 따라 현재 사용 중인 커넥터의 버전을 확인합니다.
**커넥터 버전을 찾으려면**
1. Lambda 애플리케이션의 Lambda 콘솔 페이지에서 **이미지** 탭을 선택합니다.
1. 이미지 탭에서 이미지 URI를 찾습니다. URI는 다음 형식을 따릅니다.
```
Image_location_account.dkr.ecr.us-west-2.amazonaws.com/athena-federation-repository:Version
```
1. 이미지 URI의 버전 번호는 `year.week_of_year.iteration_of_week` 형식(예: `2021.42.1`)을 따릅니다. 이 숫자는 커넥터 버전을 나타냅니다.
## 새 커넥터 버전 배포
다음 단계에 따라 커넥터의 새 버전을 배포합니다.
**새 커넥터 버전을 배포하려면**
1. 최신 Athena Query Federation 버전 찾기 절차에 따라 원하는 버전을 찾습니다.
1. 페더레이션 커넥터 Lambda 함수에서 ImageURI를 찾고 태그를 원하는 버전으로 업데이트합니다. 예제:
시작:
```
509399631660.dkr.ecr.us-east-1.amazonaws.com/athena-federation-repository:2025.15.1
```
끝:
```
509399631660.dkr.ecr.us-east-1.amazonaws.com/athena-federation-repository:2025.26.1
```
**참고**
현재 버전이 2025.15.1 이전 버전인 경우 다음과 같은 중요한 변경 사항에 유의하세요.
리포지토리 이름이 `athena-federation-repository`로 업데이트되었습니다.
이 업데이트 이전의 버전에서는 명령 재정의가 설정되지 않을 수 있습니다. 복합 핸들러로 설정해야 합니다.
# 레거시 연결
## 최신 Athena Query Federation 버전 찾기
Athena 데이터 소스 커넥터의 최신 버전 번호는 최신 Athena Query Federation 버전에 해당됩니다. 경우에 따라 GitHub 릴리스가 AWS Serverless Application Repository(SAR)에서 제공되는 것보다 조금 더 최신일 수 있습니다.
**최신 Athena Query Federation 버전 번호를 찾으려면**
1. GitHub URL [https://github.com/awslabs/aws-athena-query-federation/releases/latest](https://github.com/awslabs/aws-athena-query-federation/releases/latest)를 방문하세요.
1. 기본 페이지 제목의 릴리스 번호를 다음 형식으로 기록합니다.
**Athena Query Federation의** **릴리스 v***year*.*week\$1of\$1year*.*iteration\$1of\$1week*
예를 들어 **Athena Query Federation의 릴리스 v2023.8.3**의 릴리스 번호는 2023.8.3입니다.
## 리소스 이름 찾기
업그레이드를 준비하려면 다음 정보를 찾아 기록해야 합니다.
1. 커넥터의 Lambda 함수 이름.
1. Lambda 함수 환경 변수.
1. 커넥터의 Lambda 함수를 관리하는 Lambda 애플리케이션 이름.
**Athena 콘솔에서 리소스 이름을 찾으려면**
1. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)에서 Athena 콘솔을 엽니다.
1. 콘솔 탐색 창이 표시되지 않으면 왼쪽의 확장 메뉴를 선택합니다.
![\[확장 메뉴를 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/athena/latest/ug/images/nav-pane-expansion.png)
1. 탐색 창에서 **데이터 소스 및 카탈로그**를 선택합니다.
1. **데이터 소스 이름** 열에서 커넥터의 데이터 소스에 대한 링크를 선택합니다.
1. **데이터 소스 세부 정보** 섹션의 **Lambda 함수**에서 Lambda 함수에 대한 링크를 선택합니다.
![\[Lambda 함수에 대한 링크를 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/athena/latest/ug/images/connectors-updating-1.png)
1. **함수** 페이지의 **함수 이름** 열에서 커넥터의 함수 이름을 기록합니다.
![\[함수 이름을 기록합니다.\]](http://docs.aws.amazon.com/ko_kr/athena/latest/ug/images/connectors-updating-2.png)
1. 함수 이름 링크를 선택합니다.
1. **함수 개요** 섹션에서 **구성** 탭을 선택합니다.
1. 왼쪽의 창에서 **환경 변수**를 선택합니다.
1. **환경 변수** 섹션에서 키와 해당 값을 기록합니다.
1. 페이지 맨 위로 스크롤합니다.
1. **이 함수는 애플리케이션에 속해 있습니다. 관리하려면 여기를 클릭합니다.** 메시지에서 **여기를 클릭** 링크를 선택합니다.
1. **serverlessrepo-*your\$1application\$1name*** 페이지에서 **serverlessrepo**를 제외한 애플리케이션 이름을 기록합니다. 예를 들어 애플리케이션 이름이 **serverlessrepo-DynamoDbTestApp**인 경우 사용자 애플리케이션 이름은 **DynamoDbTestApp**입니다.
1. 애플리케이션의 Lambda 콘솔 페이지에서 **사용 중인 커넥터 버전 찾기** 단계를 계속 진행합니다.
## 사용 중인 커넥터의 버전 찾기
다음 단계에 따라 사용 중인 커넥터 버전을 찾습니다.
**사용 중인 커넥터 버전을 찾으려면**
1. Lambda 애플리케이션의 Lambda 콘솔 페이지에서 **배포** 탭을 선택합니다.
1. **배포** 탭에서 **SAM 템플릿**을 확장합니다.
1. **CodeUri**를 검색합니다.
1. **키** 필드의 **CodeUri**에서 다음 문자열을 찾습니다.
```
applications-connector_name-versions-year.week_of_year.iteration_of_week/hash_number
```
다음 예제는 CloudWatch 커넥터의 문자열을 보여줍니다.
```
applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...
```
1. *year*.*week\$1of\$1year*.*iteration\$1of\$1week*에 대한 값(예: **2021.42.1**)을 기록합니다. 이 버전은 커넥터의 버전입니다.
## 커넥터의 새 버전 배포
다음 단계에 따라 커넥터의 새 버전을 배포합니다.
**커넥터의 새 버전을 배포하려면**
1. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)에서 Athena 콘솔을 엽니다.
1. 콘솔 탐색 창이 표시되지 않으면 왼쪽의 확장 메뉴를 선택합니다.
![\[확장 메뉴를 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/athena/latest/ug/images/nav-pane-expansion.png)
1. 탐색 창에서 **데이터 소스 및 카탈로그**를 선택합니다.
1. **데이터 소스 및 카탈로그** 페이지에서 **데이터 소스 생성**을 선택합니다.
1. 업그레이드할 데이터 소스를 선택하고 **다음**을 선택합니다.
1. **연결 세부 정보** 섹션에서 **Lambda 함수 생성**을 선택합니다. 그러면 업데이트된 애플리케이션을 배포할 수 있는 Lambda 콘솔이 열립니다.
![\[AWS Lambda 콘솔의 커넥터 페이지.\]](http://docs.aws.amazon.com/ko_kr/athena/latest/ug/images/connectors-updating-3.png)
1. 실제로 새 데이터 소스를 생성하지는 않으므로 Athena 콘솔 탭을 닫아도 됩니다.
1. 커넥터의 Lambda 콘솔 페이지에서 다음 단계를 수행합니다.
1. 애플리케이션 이름에서 **serverlessrepo-** 접두사를 제거했는지 확인하고 애플리케이션 이름을 **애플리케이션 이름** 필드에 복사합니다.
1. Lambda 함수 이름을 **AthenaCatalogName** 필드에 복사합니다. 일부 커넥터에서 이 필드는 **LambdaFunctionName**으로 표시됩니다.
1. 기록했던 환경 변수를 해당 필드에 복사합니다.
1. **I acknowledge that this app creates custom IAM roles and resource policies** 옵션을 선택하고 **배포**를 선택합니다.
1. 애플리케이션이 업데이트되었는지 확인하려면 **배포** 탭을 선택합니다.
**배포 기록** 섹션에서 업데이트가 완료되었음을 표시합니다.
![\[커넥터 업데이트가 완료되었습니다.\]](http://docs.aws.amazon.com/ko_kr/athena/latest/ug/images/connectors-updating-4.png)
1. 새 버전 번호를 확인하려면 전과 같이 **SAM 템플릿**을 확장하고 **CodeUri**를 찾은 후에 **키** 필드에서 커넥터 버전 번호를 확인할 수 있습니다.
이제 업데이트된 커넥터를 사용하여 Athena의 페더레이션된 쿼리를 생성할 수 있습니다.