Athena 엔진 버전 변경

Athena는 수시로 향상된 성능, 기능 및 코드 수정을 제공하기 위해 새로운 엔진 버전을 릴리스합니다. 새 엔진 버전을 이용할 수 있게 되면 Athena 콘솔에서 알림을 제공합니다. 사용자는 Athena가 업그레이드 시기를 결정하도록 선택하거나 작업 그룹별로 Athena 엔진 버전을 수동으로 지정할 수 있습니다.

작업 그룹의 쿼리 엔진 버전 찾기

작업 그룹페이지를 사용하여 작업 그룹의 현재 엔진 버전을 찾을 수 있습니다.

작업 그룹의 현재 엔진 버전을 찾으려면

1. https://console.aws.amazon.com/athena/에서 Athena 콘솔을 엽니다.

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

   

3. Athena 콘솔 탐색 창에서 작업 그룹(Workgroups)을 선택합니다.

4. 작업 그룹(Workgroups) 페이지에서 원하는 작업 그룹을 찾습니다. 작업 그룹의 쿼리 엔진 버전(Query engine version) 열에는 쿼리 엔진 버전이 표시됩니다.

Athena 콘솔에서 엔진 버전 변경

사용자는 새 엔진 버전을 이용할 수 있을 때 Athena가 작업 그룹을 업그레이드할 시기를 결정하도록 하거나 작업 그룹이 사용할 Athena 엔진 버전을 수동으로 지정할 수 있습니다. 현재 하나의 버전만 사용할 수 있는 경우 다른 버전을 수동으로 지정할 수 없습니다.

참고

작업 그룹의 엔진 버전을 변경하려면 작업 그룹에 대해 athena:ListEngineVersions 작업을 수행할 권한이 있어야 합니다. IAM 정책 예제는 작업 그룹 정책의 예 단원을 참조하세요.

Athena가 작업 그룹을 업그레이드할 시기를 결정하도록 하려면

1. https://console.aws.amazon.com/athena/에서 Athena 콘솔을 엽니다.

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

3. 콘솔 탐색 창에서 작업 그룹(Workgoups)을 선택합니다.

4. 작업 그룹 목록에서 구성할 작업 그룹에 대한 링크를 선택합니다.

5. 편집을 선택합니다.

6. 쿼리 엔진 버전(Query engine version) 섹션에서 쿼리 엔진 업데이트(Update query engine)에 대해 자동(Automatic)을 선택하여 Athena가 작업 그룹을 업그레이드할 시기를 선택할 수 있도록 합니다. 이것이 기본 설정입니다.

7. Save changes(변경 사항 저장)를 선택합니다.

   작업 그룹 목록에서 작업 그룹의 Query engine update status(쿼리 엔진 업데이트 상태)가 Automatic(자동)으로 표시됩니다.

엔진 버전을 수동으로 선택하려면

1. https://console.aws.amazon.com/athena/에서 Athena 콘솔을 엽니다.

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

3. 콘솔 탐색 창에서 작업 그룹(Workgoups)을 선택합니다.

4. 작업 그룹 목록에서 구성할 작업 그룹에 대한 링크를 선택합니다.

5. 편집을 선택합니다.

6. 쿼리 엔진 버전(Query engine version) 섹션에서 쿼리 엔진 업데이트(Update query engine)에 대해 수동(Manual)을 선택하여 수동으로 엔진 버전을 선택합니다.

7. 쿼리 엔진 버전(Query engine version) 옵션을 사용하여 작업 그룹에서 사용할 엔진 버전을 선택합니다. 다른 엔진 버전을 사용할 수 없는 경우 다른 엔진 버전을 지정할 수 없습니다.

8. Save changes(변경 사항 저장)를 선택합니다.

   작업 그룹 목록에서 작업 그룹의 Query engine update status(쿼리 엔진 업데이트 상태)가 Manual(수동)로 표시됩니다.

AWS CLI를 사용하여 엔진 버전 변경하기

AWS CLI를 사용하여 엔진 버전을 변경하려면 다음 예의 구문을 사용하세요.

aws athena update-work-group --work-group workgroup-name --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}

작업 그룹을 만들 때 엔진 버전 지정

작업 그룹을 만들 때 작업 그룹이 사용할 엔진 버전을 지정하거나 작업 그룹을 업그레이드할 시기를 Athena가 결정하도록 할 수 있습니다. 새 엔진 버전을 사용할 수 있는 경우 다른 작업 그룹을 업그레이드하기 전에 새 엔진을 테스트할 작업 그룹을 생성하는 것이 가장 좋습니다. 작업 그룹의 엔진 버전을 지정하려면 작업 그룹에 대해 athena:ListEngineVersions 권한이 있어야 합니다. IAM 정책 예제는 작업 그룹 정책의 예 단원을 참조하세요.

작업그룹을 만들 때 엔진 버전을 지정하려면

1. https://console.aws.amazon.com/athena/에서 Athena 콘솔을 엽니다.

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

3. 콘솔 탐색 창에서 작업 그룹(Workgoups)을 선택합니다.

4. 작업 그룹 페이지에서 작업 그룹 생성을 선택합니다.

5. 작업 그룹 생성(Create workgroup) 페이지의 쿼리 엔진 버전(Query engine version) 섹션에서 다음 중 하나를 수행합니다.

   • 자동(Automatic)을 선택하면 Athena가 작업 그룹을 업그레이드할 시기를 선택할 수 있습니다. 이것이 기본 설정입니다.

   • 사용 가능한 경우 다른 엔진 버전을 수동으로 선택하려면 수동(Manual)을 선택합니다.

6. 필요에 따라 기타 필드에 정보를 입력합니다. 기타 필드에 대한 자세한 내용은 작업 그룹 만들기 단원을 참조하세요.

7. 작업 그룹 생성을 선택합니다.

엔진 버전 업그레이드 전 쿼리 테스트

작업 그룹이 새 엔진 버전으로 업그레이드되면 비호환성으로 인해 일부 쿼리가 중단될 수 있습니다. 엔진 버전 업그레이드가 원활하게 진행되는지 확인하기 위해 미리 쿼리를 테스트할 수 있습니다.

엔진 버전 업그레이드 전에 쿼리를 테스트하려면

1. 사용 중인 작업 그룹의 엔진 버전을 확인합니다. 작업 그룹(Workgroups) 페이지의 작업 그룹에 대한 쿼리 엔진 버전(Query engine version) 열에 사용 중인 엔진 버전이 표시됩니다. 자세한 내용은 작업 그룹의 쿼리 엔진 버전 찾기 단원을 참조하십시오.

2. 새 엔진 버전을 사용하는 테스트 작업 그룹을 만듭니다. 자세한 내용은 작업 그룹을 만들 때 엔진 버전 지정 단원을 참조하세요.

3. 새 작업 그룹을 사용하여 테스트하려는 쿼리를 실행합니다.

4. 쿼리가 실패하면 Athena 엔진 버전 참조를 이용하여 쿼리에 영향을 줄 수 있는 주요 변경 사항을 확인합니다. 일부 변경 사항의 경우 쿼리 구문의 업데이트가 필요할 수 있습니다.

5. 쿼리가 계속 실패하면 AWS Support에 지원을 문의하세요. AWS Management Console에서 지원(Support), 지원 센터(Support Center)를 선택하거나 Amazon Athena 태그를 사용하여 AWS re:Post에서 질문하세요.

실패한 쿼리 문제 해결

엔진 버전 업그레이드 후 쿼리가 실패하는 경우 Athena 엔진 버전 참조를 이용하여 쿼리의 구문에 영향을 줄 수 있는 변경 사항을 포함해 주요 변경 사항을 확인합니다.

쿼리가 계속 실패하면 AWS Support에 지원을 문의하세요. AWS Management Console에서 지원(Support), 지원 센터(Support Center)를 선택하거나 Amazon Athena 태그를 사용하여 AWS re:Post에서 질문하세요.