# Amazon Athena ODBC 2.x 릴리스 정보
이 릴리스 정보에서는 Amazon Athena ODBC 2.x 드라이버의 개선 사항, 기능, 알려진 문제 및 워크플로 변경 사항에 대한 세부 정보를 제공합니다.
## 2.1.0.0
2026년 3월 20일 릴리스
Amazon Athena ODBC v2.1.0.0 드라이버에는 보안 개선 사항이 포함되어 있습니다. 이번 릴리스에서는 인증 흐름, 쿼리 처리 및 전송 보안이 향상되었습니다. 가능한 한 빨리 이 버전으로 업그레이드하세요.
### 호환성에 영향을 미치는 변경 사항
+ **SSL 인증서 검증이 기본적으로 활성화됨** - 이제 드라이버가 ID 제공업체에 연결할 때 SSL 인증서 확인을 시행합니다. 유효한 SSL 인증서 없이 로컬 ID 제공업체를 사용하는 경우 연결 문자열에 `SSL_Insecure=1`을 명시적으로 설정해야 합니다. 자세한 내용은 [SSL 비보안(IdP)](odbc-v2-driver-common-authentication-parameters.md#odbc-v2-driver-common-authentication-parameters-ssl-insecure-idp) 섹션을 참조하세요.
+ **TLS 1.2 이상만 허용** - 이제 드라이버가 ID 제공업체에 대한 TLS 1.0 또는 TLS 1.1 연결을 허용하지 않습니다. 이제 모든 IdP 연결에 TLS 1.2 이상이 필요합니다.
+ **BrowserSSOOIDC 인증 흐름 업데이트됨** - BrowserSSOOIDC 플러그인은 이제 디바이스 코드 권한 부여 대신 PKCE를 사용한 권한 부여 코드를 사용합니다. OAuth 2.0 콜백 서버에는 새로운 선택적 파라미터 `listen_port`(기본값 7890)를 사용할 수 있습니다. 네트워크에서 이 포트를 허용 목록에 추가해야 할 수도 있습니다. 기본 범위가 `sso:account:access`로 변경되었습니다. 자세한 내용은 [브라우저 SSO OIDC](odbc-v2-driver-browser-sso-oidc.md) 섹션을 참조하세요.
### 개선 사항
+ **BrowserSSOOIDC** - 보안 강화를 위해 디바이스 코드 흐름에서 PKCE를 사용한 권한 부여 코드로 마이그레이션되었습니다.
+ **BrowserAzureAD** - 권한 부여 코드 가로채기 공격을 방지하기 위해 OAuth 2.0 권한 부여 흐름에 PKCE(Proof Key for Code Exchange)가 추가되었습니다.
+ **BrowserSAML** - SAML 토큰 주입 공격을 방지하기 위해 RelayState CSRF 보호가 추가되었습니다.
+ **자격 증명 캐시** - v2.1.0.0부터 캐시된 자격 증명이 AWS CLI에서 로컬로 저장된 자격 증명을 보호하는 방식과 일관되게 `user-profile/.athena-odbc/` 디렉터리에 일반 텍스트 JSON으로 저장되며 파일 권한은 소유 사용자로 제한됩니다.
+ **IAM 프로파일** - 기존 `Ec2InstanceMetadata`와 함께 `EcsContainer` 및 `Environment` 자격 증명 소스에 대한 지원이 추가되었습니다.
+ **연결 문자열 파서**- 적절한 ODBC `}}` 이스케이프 처리가 구현되었습니다.
+ **카탈로그 쿼리** - 스키마 이름과 테이블 패턴에 대한 SQL 식별자 이스케이프가 추가되었습니다.
+ **ODBC 패턴 매칭** - 정규식 기반 매칭이 직접 ODBC LIKE 와일드카드 매처로 대체되었습니다.
+ **XML 구문 분석** - SAML 토큰에 대한 재귀 깊이 제한(100개 수준)과 크기 제한(1MB)이 추가되었습니다.
+ **ADFS 인증** - ADFS 서버 응답에 대한 응답 크기 제한(200KB)이 추가되었습니다.
### 수정 사항
+ 인증 구성 요소에서 특수 요소가 제대로 중화되지 않아 조작된 연결 파라미터를 통해 코드 실행이나 인증 흐름 리디렉션이 발생할 수 있었던 문제가 수정되었습니다. BrowserSSOOIDC, BrowserAzureAD 및 BrowserSAML 플러그인에 영향을 줍니다.
+ 쿼리 처리 구성 요소에서 특수 요소가 제대로 중화되지 않아 조작된 테이블 메타데이터를 통해 서비스 거부나 SQL 인젝션이 발생할 수 있었던 문제가 수정되었습니다.
+ ID 제공업체에 연결할 때 부적절한 인증서 검증이 수정되었습니다.
+ 브라우저 기반 인증 흐름에서 누락된 인증 보안 제어가 수정되었습니다. 여기에는 OAuth용 PKCE, SAML용 CSRF 보호, 안전한 자격 증명 캐싱 및 전용 콜백 포트 바인딩이 포함됩니다.
+ 조작된 입력 패턴, 무한 서버 응답 또는 깊게 중첩된 XML 페이로드를 통해 서비스 거부를 유발할 수 있었던 구성 요소 구문 분석 시 제어되지 않는 리소스 소비가 수정되었습니다.
+ Power BI 가져오기 모드에서 교차 계정 페더레이션 카탈로그와 함께 `SQLColumns` 사용 시 `UseSingleCatalogAndSchema=1`와 `SQLTables`가 아무 결과도 반환하지 않는 문제가 수정되었습니다.
새 ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하세요. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.6.0
2025년 11월 21일 릴리스
### 개선 사항
+ **브라우저의 신뢰할 수 있는 ID 전파 인증 플러그인** - 신뢰할 수 있는 ID 전파를 통해 브라우저 기반 OpenID Connect(OIDC) 인증을 지원하는 새 인증 플러그인을 추가했습니다. 이 플러그인은 기본 브라우저를 통해 전체 OAuth 2.0 흐름을 처리하고, JSON 웹 토큰(JWT)을 자동으로 가져오며, 신뢰할 수 있는 ID 전파에 통합되어 원활한 인증 환경을 제공합니다. 플러그인은 단일 사용자 데스크톱 환경을 위해 특별히 설계되었습니다. 신뢰할 수 있는 ID 전파를 활성화하고 사용하는 방법에 대한 자세한 내용은 [What is trusted identity propagation?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)을 참조하세요.
+ **향상된 로깅 프레임워크** - 다음을 통해 드라이버의 로깅 메커니즘을 크게 개선했습니다.
+ 기본 0/1 옵션 이상의 보다 세분화된 로그 수준 도입
+ 중복 로그 문 제거
+ 진단 관련 정보를 포함하도록 로깅 프레임워크 최적화
+ 운영 지연을 일으킨 성능 문제 해결
+ 로깅이 활성화된 경우 과도한 로그 파일 생성 감소
### 수정 사항
+ **결과 가져오기 최적화** - 가져오기 크기 파라미터 제한 사항이 스트리밍 및 스트리밍 이외 결과 가져오기 모두에 잘못 적용되는 문제를 수정했습니다. 이제 제한 사항이 스트리밍 이외 결과 가져오기에만 올바르게 적용됩니다.
새 ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하세요. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.5.1
2025년 10월 13일 릴리스
### 수정 사항
Amazon Athena ODBC v2.0.5.1 드라이버에는 브라우저 기반 인증 플러그인에 대한 다음과 같은 수정 사항이 포함되어 있습니다.
+ 로그인 URL과 스키마 검사에 대한 검증을 구현했습니다.
+ Linux에서 시스템 API를 활용하도록 개선된 브라우저 실행 메커니즘으로 안정성과 보안이 향상되었습니다.
새 ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하세요. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.5.0
2025년 9월 10일 릴리스
### 개선 사항
+ **JWT 신뢰할 수 있는 ID 제공업체(TIP) 인증 플러그인** - ODBC 드라이버와의 JWT 신뢰할 수 있는 ID 제공업체(TIP) 통합을 지원하는 새 인증 플러그인을 추가했습니다. 이 인증 유형을 사용하면 외부 ID 제공업체로부터 얻은 JSON 웹 토큰(JWT)을 연결 파라미터로 사용하여 Athena로 인증할 수 있습니다. TIP를 사용하면 ID 컨텍스트가 IAM 역할에 추가되어 AWS 리소스에 대한 액세스를 요청하는 사용자를 식별합니다. TIP 활성화 및 사용에 대한 자세한 내용은 [What is Trusted Identity Propagation?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)을 참조하세요.
+ **사용자 지정 SSO 관리자 엔드포인트 지원** - ODBC 드라이버에 사용자 지정 SSO 관리자 엔드포인트에 대한 지원이 추가되었습니다. 이 향상된 기능을 통해 VPC 환경에서 ODBC를 실행할 때 SSO 서비스용 엔드포인트를 지정할 수 있습니다..
+ **AWS SDK 버전 업데이트** - 드라이버에 사용된 AWS SDK 버전을 2.32.16으로 업데이트하고 릴리스 2.0.5.0의 프로젝트 종속성을 업데이트했습니다.
## 2.0.4.0
2025년 6월 17일 릴리스
Amazon Athena ODBC v2.0.4.0 드라이버에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.
### 개선 사항
+ **결과 페처** - 이제 드라이버가 쿼리 결과를 다운로드할 방식을 자동으로 선택합니다. 이렇게 하면 대부분의 상황에서 페처를 수동으로 구성할 필요가 없습니다. 자세한 내용은 [결과 페처](odbc-v2-driver-advanced-options.md#odbc-v2-driver-advanced-options-result-fetcher) 섹션을 참조하세요.
+ Curl 라이브러리가 8.12.1 버전으로 업데이트되었습니다.
### 수정 사항
+ STS에 연결하는 경우의 IAM 프로파일 프록시 구성을 수정했습니다. 해당 수정을 통해 IAM 프로파일을 성공적인 인증에 사용할 수 있게 됩니다.
+ 인증 플러그인을 사용하여 IAM 프로파일에 대한 모든 추가 구성 옵션을 읽습니다. 여기에는 영향 받는 플러그인의 잘못된 구성을 해결하기 위해 `UseProxyForIdP`, `SSL_Insecure`, `LakeformationEnabled` 및 `LoginToRP`가 포함됩니다.
+ 라운드 함수가 선택적 두 번째 파라미터를 가져오도록 수정했습니다. 이스케이프 구문이 포함된 쿼리를 실패 없이 처리합니다.
+ `TIME WITH TIME ZONE` 및 `TIMESTAMP WITH TIME ZONE` 데이터 형식에 대한 열 크기를 수정했습니다. 타임스탬프 및 시간대 데이터 형식이 있는 값이 잘려 보이지 않습니다.
새 ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하세요. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.3.0
2024년 4월 8일 릴리스
Amazon Athena ODBC v2.0.3.0 드라이버에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.
### 개선 사항
+ Linux 및 Mac 플랫폼에서 Okta 인증 플러그인에 대한 MFA 지원을 추가했습니다.
+ 이제 Windows에 대해 `athena-odbc.dll` 라이브러리와 `AmazonAthenaODBC-2.x.x.x.msi` 설치 프로그램이 모두 서명됩니다.
+ 드라이버와 함께 설치된 CA 인증서 `cacert.pem` 파일을 업데이트했습니다.
+ Lambda 카탈로그에 테이블을 나열하는 데 필요한 시간을 개선했습니다. `LAMBDA` 카탈로그 유형의 경우 ODBC 드라이버가 이제 [SHOW TABLES](show-tables.md) 쿼리를 제출하여 사용 가능한 테이블 목록을 가져올 수 있습니다. 자세한 내용은 [쿼리를 사용하여 테이블 나열](odbc-v2-driver-advanced-options.md#odbc-v2-driver-advanced-options-use-query-to-list-tables) 섹션을 참조하세요.
+ `SQL_WCHAR` 및 `SQL_WVARCHAR`를 사용하여 문자열 데이터 유형을 보고하는 `UseWCharForStringTypes` 연결 파라미터를 도입했습니다. 자세한 내용은 [문자열 유형에 WCHAR 사용](odbc-v2-driver-advanced-options.md#odbc-v2-driver-advanced-options-use-wchar-for-string-types) 섹션을 참조하세요.
### 수정 사항
+ Get-OdbcDsn PowerShell 도구를 사용할 때 발생했던 레지스트리 손상 경고를 수정했습니다.
+ 쿼리 문자열 시작 시 주석을 처리하도록 구문 분석 로직을 업데이트했습니다.
+ 날짜 및 타임스탬프 데이터 유형에서 이제 연도 필드에 0을 사용할 수 있습니다.
새 ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하세요. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.2.2
2024년 2월 13일 릴리스
Amazon Athena ODBC v2.0.2.2 드라이버에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.
### 개선 사항
+ 문자열 및 복합 데이터 유형의 기본 열 길이를 변경하는 데 사용할 수 있는 연결 파라미터인 `StringColumnLength` 및 `ComplexTypeColumnLength`를 추가했습니다. 자세한 내용은 [문자열 열 길이](odbc-v2-driver-advanced-options.md#odbc-v2-driver-advanced-options-string-column-length) 및 [복합 유형 열 길이](odbc-v2-driver-advanced-options.md#odbc-v2-driver-advanced-options-complex-type-column-length)(을)를 참조하세요.
+ Linux 및 macOS(Intel 및 ARM) 운영 체제에 대한 지원이 추가되었습니다. 자세한 내용은 [Linux](odbc-v2-driver-getting-started-linux.md) 및 [macOS](odbc-v2-driver-getting-started-macos.md)(을)를 참조하세요.
+ AWS-SDK-CPP가 1.11.245 태그 버전으로 업데이트되었습니다.
+ curl 라이브러리가 8.6.0 버전으로 업데이트되었습니다.
### 수정 사항
+ 정밀도 열의 문자열과 유사한 데이터 유형에 대한 결과 세트 메타데이터에서 잘못된 값이 보고되는 문제를 해결했습니다.
ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하십시오. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.2.1
2023년 12월 7일 출시
Amazon Athena ODBC v2.0.2.1 드라이버에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.
### 개선 사항
+ 모든 인터페이스의 ODBC 드라이버 스레드 안전이 개선되었습니다.
+ 로깅이 활성화되면 이제 날짜 시간 값이 밀리초 단위로 기록됩니다.
+ [브라우저 SSO OIDC](odbc-v2-driver-browser-sso-oidc.md) 플러그인으로 인증하는 동안 이제 터미널이 열려 사용자에게 디바이스 코드가 표시됩니다.
### 수정 사항
+ 스트리밍 API의 결과를 구문 분석할 때 발생하는 메모리 릴리스 문제가 해결되었습니다.
+ 이제 `SQLTablePrivileges()`, `SQLSpecialColumns()`, `SQLProcedureColumns()` 및 `SQLProcedures()` 인터페이스에 대한 요청이 빈 결과 세트를 반환합니다.
ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하십시오. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.2.0
2023년 10월 17일 출시
Amazon Athena ODBC v2.0.2.0 드라이버에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.
### 개선 사항
+ 브라우저 Azure AD, 브라우저 SSO OIDC 및 Okta 브라우저 기반 인증 플러그인에 파일 캐시 기능이 추가되었습니다.
Power BI와 같은 BI 도구 및 브라우저 기반 플러그인은 여러 브라우저 창을 사용합니다. 새 파일 캐시 연결 파라미터를 사용하면 임시 보안 인증을 캐시하여 BI 애플리케이션에서 여는 여러 프로세스 간에 재사용할 수 있습니다.
+ 이제 애플리케이션에서 명령문이 준비된 후 결과 세트에 대한 정보를 쿼리할 수 있습니다.
+ 느린 클라이언트 네트워크에서 사용할 수 있도록 기본 연결 및 요청 시간 제한이 늘어났습니다. 자세한 내용은 [연결 제한 시간](odbc-v2-driver-advanced-options.md#odbc-v2-driver-advanced-options-connection-timeout) 및 [요청 제한 시간](odbc-v2-driver-advanced-options.md#odbc-v2-driver-advanced-options-request-timeout)(을)를 참조하세요.
+ SSO 및 SSO OIDC에 대한 엔드포인트 재정의가 추가되었습니다. 자세한 내용은 [엔드포인트 재정의](odbc-v2-driver-endpoint-overrides.md) 섹션을 참조하세요.
+ 인증 요청을 위한 URI 인수를 Ping에 전달하는 연결 파라미터가 추가되었습니다. 이 파라미터를 사용하여 Lake Formation 단일 역할 제한을 우회할 수 있습니다. 자세한 내용은 [Ping URI 파라미터](odbc-v2-driver-ping.md#odbc-v2-driver-ping-uri-param) 섹션을 참조하세요.
### 수정 사항
+ 행 기반 바인딩 메커니즘을 사용할 때 발생하는 정수 오버플로 문제가 수정되었습니다.
+ 브라우저 SSO OIDC 인증 플러그인의 필수 연결 파라미터 목록에서 제한 시간이 제거되었습니다.
+ `SQLStatistics()`, `SQLPrimaryKeys()`, `SQLForeignKeys()` 및 `SQLColumnPrivileges()`에 대한 누락된 인터페이스가 추가되고 요청 시 빈 결과 세트를 반환하는 기능이 추가되었습니다.
새 ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하세요. 연결 정보는 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.
## 2.0.1.1
2023년 8월 10일 출시
Amazon Athena ODBC v2.0.1.1 드라이버에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.
### 개선 사항
+ Okta 인증 플러그인에 URI 로깅을 추가했습니다.
+ 외부 보안 인증 제공업체 플러그인에 기본 역할 파라미터를 추가했습니다.
+ AWS 구성 파일의 프로파일 이름에서 프로파일 접두사에 대한 처리를 추가했습니다.
### 수정 사항
+ Lake Formation 및 AWS STS 클라이언트에서 작업할 때 발생한 AWS 리전 사용 문제를 수정했습니다.
+ 누락된 파티션 키를 테이블 열 목록에 복원했습니다.
+ 누락된 `BrowserSSOOIDC` 인증 유형을 AWS 프로파일에 추가했습니다.
새 ODBC v2 드라이버를 다운로드하려면 [ODBC 2.x 드라이버 다운로드](odbc-v2-driver.md#odbc-v2-driver-download) 섹션을 참조하세요.
## 2.0.1.0
2023년 6월 29일 출시
Amazon Athena가 ODBC v2.0.1.0 드라이버를 출시합니다.
Athena에서 호환되는 SQL 개발 및 비즈니스 인텔리전스 애플리케이션의 데이터에 연결하고 쿼리하며 시각화하는 경험을 개선하는 새로운 ODBC 드라이버를 출시했습니다. Athena ODBC 드라이버의 최신 버전은 기존 드라이버의 기능을 지원하면서 업그레이드도 간단합니다. 새 버전에는 [AWS IAM Identity Center](https://aws.amazon.com/iam/identity-center/)를 통한 사용자 인증 지원이 포함되어 있습니다. 또한 Amazon S3에서 쿼리 결과를 읽는 옵션을 제공하므로 쿼리 결과를 더 빨리 사용할 수 있습니다.
자세한 내용은 [Amazon Athena ODBC 2.x](odbc-v2-driver.md) 섹션을 참조하세요.