# ODBC 2.x 드라이버로 마이그레이션
<a name="odbc-v2-driver-migrating"></a>

대부분의 Athena ODBC 2.x 연결 파라미터는 ODBC 1.x 드라이버와 역호환되므로 대부분의 기존 연결 문자열을 Athena ODBC 2.x 드라이버에서 재사용할 수 있습니다. 하지만 다음 연결 파라미터는 수정이 필요합니다.

## 로그 수준
<a name="odbc-v2-driver-migrating-log-level"></a>

현재 ODBC 드라이버는 `LOG_OFF (0)`\$1`LOG_TRACE (6)`까지 다양한 사용 가능한 로깅 옵션을 제공하지만 Amazon Athena ODBC 2.x 드라이버에는 처음에 0(비활성화됨) 및 1(활성화됨)의 두 가지 값만 있습니다. 이제 버전 2.0.6.0부터 드라이버는 향상된 로깅 기능을 통해 보다 세분화된 로깅 수준을 지원합니다.
+ `OFF` - 로깅이 비활성화됨
+ `ERROR` - 오류 메시지만 로깅됨
+ `WARN` - 경고 메시지 및 오류가 로깅됨
+ `INFO` – 정보 메시지, 경고 및 오류가 로깅됨
+ `DEBUG` - 세부 디버그 정보와 모든 하위 수준 메시지가 로깅됨
+ `TRACE` - 가장 세부적인 로깅 수준(모든 메시지 포함)

ODBC 2.x 드라이버 로깅에 대한 자세한 내용은 [로깅 옵션](odbc-v2-driver-logging-options.md) 섹션을 참조하세요.


****  

|  | ODBC 1.x 드라이버 | ODBC 2.x 드라이버 | 
| --- | --- | --- | 
| 연결 문자열 이름 | LogLevel | LogLevel | 
| 파라미터 유형 | 선택 사항 | 선택 사항 | 
| 기본값 | 0 | OFF | 
| 가능한 값 | 0-6 | 2.0.6.0 이전 버전의 경우: `0,1` 버전 2.0.6.0 이상의 경우: `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, `TRACE`  | 
| 연결 문자열 예제 | LogLevel=6; | LogLevel=INFO; | 

**참고**  
버전 2.0.6.0 이상에서는 운영 지연과 과도한 로그 파일 생성을 줄이면서 이러한 세분화된 로그 수준을 통해 자세한 진단 정보를 제공하도록 로깅 프레임워크가 최적화되었습니다. 각 수준에는 아래 수준의 모든 메시지가 포함됩니다.

## MetadataRetrievalMethod
<a name="odbc-v2-driver-migrating-metadataretrievalmethod"></a>

현재 ODBC 드라이버는 Athena에서 메타데이터를 검색하는 몇 가지 옵션을 제공합니다. Amazon Athena ODBC 드라이버는 `MetadataRetrievalMethod`를 더 이상 사용하지 않으며 항상 Amazon Athena API를 사용하여 메타데이터를 추출합니다.

Athena는 외부 카탈로그 쿼리를 위해 `QueryExternalCatalogs` 플래그를 도입했습니다. 현재 ODBC 드라이버로 외부 카탈로그를 쿼리하려면 `MetadataRetrievalMethod`를 `ProxyAPI`로 설정합니다. Athena ODBC 드라이버로 외부 카탈로그를 쿼리하려면 `QueryExternalCatalogs`를 `1`로 설정합니다.


****  

|  | ODBC 1.x 드라이버 | ODBC 2.x 드라이버 | 
| --- | --- | --- | 
| 연결 문자열 이름 | MetadataRetrievalMethod | QueryExternalCatalogs | 
| 파라미터 유형 | 선택 사항 | 선택 사항 | 
| 기본값 | Auto | 0 | 
| 가능한 값 | Auto, AWS Glue, ProxyAPI, Query | 0,1 | 
| 연결 문자열 예제 | MetadataRetrievalMethod=ProxyAPI; | QueryExternalCatalogs=1; | 

## 연결 테스트
<a name="odbc-v2-driver-migrating-connection-test"></a>

ODBC 1.x 드라이버 연결을 테스트할 때 드라이버는 Amazon S3 버킷에서 두 개의 파일(결과 세트에 대한 파일 및 메타데이터에 대한 파일)을 생성하는 `SELECT 1` 쿼리를 실행합니다. 테스트 연결 요금은 [Amazon Athena 요금](https://aws.amazon.com/athena/pricing/) 정책에 따라 부과됩니다.

ODBC 2.x 드라이버 연결을 테스트하는 경우 드라이버는 [GetWorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetWorkGroup.html) Athena API 작업을 직접적으로 호출합니다. 직접 호출은 보안 인증 정보를 검색하기 위해 지정한 인증 유형 및 해당 보안 인증 제공업체를 사용합니다. ODBC 2.x 드라이버를 사용하는 경우 연결 테스트에 요금이 부과되지 않으며, 테스트할 때 Amazon S3 버킷에 쿼리 결과가 생성되지 않습니다.