데이터 소스 커넥터 업데이트 - Amazon Athena

데이터 소스 커넥터 업데이트

Athena는 사용하는 데이터 소스 커넥터를 최신 버전으로 주기적으로 업데이트하여 새로운 기능과 향상된 기능을 활용하도록 권장합니다. 먼저 최신 버전 번호를 찾아야 합니다.

최신 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를 방문하세요.

  2. 기본 페이지 제목의 릴리스 번호를 다음 형식으로 기록합니다.

    Athena Query Federation의 릴리스 vyear.week_of_year.iteration_of_week

    예를 들어 Athena Query Federation의 릴리스 v2023.8.3의 릴리스 번호는 2023.8.3입니다.

리소스 이름 찾기 및 기록

업그레이드를 준비하려면 다음 정보를 찾아 기록해야 합니다.

  1. 커넥터의 Lambda 함수 이름.

  2. Lambda 함수 환경 변수.

  3. 커넥터의 Lambda 함수를 관리하는 Lambda 애플리케이션 이름.

Athena 콘솔에서 리소스 이름을 찾으려면
  1. https://console.aws.amazon.com/athena/에서 Athena 콘솔을 엽니다.

  2. 콘솔 탐색 창이 표시되지 않으면 왼쪽의 확장 메뉴를 선택합니다.

    확장 메뉴를 선택합니다.
  3. 탐색 창에서 데이터 원본(Data sources)을 선택합니다.

  4. 데이터 소스 이름 열에서 커넥터의 데이터 소스에 대한 링크를 선택합니다.

  5. 데이터 소스 세부 정보 섹션의 Lambda 함수에서 Lambda 함수에 대한 링크를 선택합니다.

    Lambda 함수에 대한 링크를 선택합니다.
  6. 함수 페이지의 함수 이름 열에서 커넥터의 함수 이름을 기록합니다.

    함수 이름을 기록합니다.
  7. 함수 이름 링크를 선택합니다.

  8. 함수 개요 섹션에서 구성 탭을 선택합니다.

  9. 왼쪽의 창에서 환경 변수를 선택합니다.

  10. 환경 변수 섹션에서 키와 해당 값을 기록합니다.

  11. 페이지 맨 위로 스크롤합니다.

  12. 이 함수는 애플리케이션에 속해 있습니다. 관리하려면 여기를 클릭합니다. 메시지에서 여기를 클릭 링크를 선택합니다.

  13. serverlessrepo-your_application_name 페이지에서 serverlessrepo를 제외한 애플리케이션 이름을 기록합니다. 예를 들어 애플리케이션 이름이 serverlessrepo-DynamoDbTestApp인 경우 사용자 애플리케이션 이름은 DynamoDbTestApp입니다.

  14. 애플리케이션의 Lambda 콘솔 페이지에서 사용 중인 커넥터 버전 찾기 단계를 계속 진행합니다.

사용 중인 커넥터 버전 찾기

다음 단계에 따라 사용 중인 커넥터 버전을 찾습니다.

사용 중인 커넥터 버전을 찾으려면
  1. Lambda 애플리케이션의 Lambda 콘솔 페이지에서 배포 탭을 선택합니다.

  2. 배포 탭에서 SAM 템플릿을 확장합니다.

  3. CodeUri를 검색합니다.

  4. 필드의 CodeUri에서 다음 문자열을 찾습니다.

    applications-connector_name-versions-year.week_of_year.iteration_of_week/hash_number

    다음 예제는 CloudWatch 커넥터의 문자열을 보여줍니다.

    applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...
  5. year.week_of_year.iteration_of_week에 대한 값(예: 2021.42.1)을 기록합니다. 이 버전은 커넥터의 버전입니다.

커넥터의 새 버전 배포

다음 단계에 따라 커넥터의 새 버전을 배포합니다.

커넥터의 새 버전을 배포하려면
  1. https://console.aws.amazon.com/athena/에서 Athena 콘솔을 엽니다.

  2. 콘솔 탐색 창이 표시되지 않으면 왼쪽의 확장 메뉴를 선택합니다.

    확장 메뉴를 선택합니다.
  3. 탐색 창에서 데이터 원본(Data sources)을 선택합니다.

  4. 데이터 원본(Data sources) 페이지에서 데이터 원본 생성(Create data source)을 선택합니다.

  5. 업그레이드할 데이터 소스를 선택하고 다음을 선택합니다.

  6. 연결 세부 정보 섹션에서 Lambda 함수 생성을 선택합니다. 그러면 업데이트된 애플리케이션을 배포할 수 있는 Lambda 콘솔이 열립니다.

    AWS Lambda 콘솔의 커넥터 페이지.
  7. 실제로 새 데이터 소스를 생성하지는 않으므로 Athena 콘솔 탭을 닫아도 됩니다.

  8. 커넥터의 Lambda 콘솔 페이지에서 다음 단계를 수행합니다.

    1. 애플리케이션 이름에서 serverlessrepo- 접두사를 제거했는지 확인하고 애플리케이션 이름을 애플리케이션 이름 필드에 복사합니다.

    2. Lambda 함수 이름을 AthenaCatalogName 필드에 복사합니다. 일부 커넥터에서 이 필드는 LambdaFunctionName으로 표시됩니다.

    3. 기록했던 환경 변수를 해당 필드에 복사합니다.

  9. I acknowledge that this app creates custom IAM roles and resource policies 옵션을 선택하고 배포를 선택합니다.

  10. 애플리케이션이 업데이트되었는지 확인하려면 배포 탭을 선택합니다.

    배포 기록 섹션에서 업데이트가 완료되었음을 표시합니다.

    커넥터 업데이트가 완료되었습니다.
  11. 새 버전 번호를 확인하려면 전과 같이 SAM 템플릿을 확장하고 CodeUri를 찾은 후에 필드에서 커넥터 버전 번호를 확인할 수 있습니다.

이제 업데이트된 커넥터를 사용하여 Athena의 페더레이션된 쿼리를 생성할 수 있습니다.