2023년 ODBC Driver 릴리스 정보¶
이 문서에는 ODBC Driver 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.
동작 변경 사항
새로운 기능
고객이 직면한 버그 수정
Snowflake는 ODBC Driver 업데이트에 의미 체계 버전 관리를 사용합니다.
버전 3.1.4(2023년 12월 7일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
외부 브라우저의 인증 관련 문제를 수정하기 위해
BROWSER_RESPONSE_TIMEOUT
연결 매개 변수를 추가했습니다.빈 프록시 설정이 구성 설정을 덮어쓸 수 있는 문제를 수정하기 위해
allowEmptyProxy
연결 매개 변수를 추가했습니다.원격 분석 데이터를 보낼 때 작동이 간헐적으로 중단되는 문제를 수정했습니다.
보안 문제로 인해 Microsoft에서 금지한 CRT 함수를 제거했습니다.
버전 3.1.3(2023년 11월 13일)¶
새로운 기능과 업데이트¶
다음 라이브러리를 업데이트했습니다.
openssl 3.0.9를 3.0.11로
curl 8.1.2를 8.4.0으로
실패한 쿼리에 대한 쿼리 ID를 반환하도록
SQLGetStmtAttr(SQL_SF_STMT_ATTR_LAST_QUERY_ID)
를 업데이트했습니다.실패한 연결 요청에 대한 재시도 빈도 관리에 대한 지원을 추가했습니다.
기본값이 300초인
retryTimeout
매개 변수를 추가했습니다.드라이버가
LOGIN_TIMEOUT
및maxHttpRetries
연결 매개 변수를 사용하는 방법을 업데이트하고LOGIN_TIMEOUT
의 기본값을 300초로 변경했습니다.
버그 수정 사항¶
OSCP 유효성 검사 시간 초과로 인해 쿼리 결과를 가져올 때 드라이버가 실패하는 문제를 수정했습니다.
파일 경로에 ASCII 이외의 문자가 포함된 경우 PUT 및 GET 명령이 실패하는 문제를 수정했습니다.
overwrite=true
가 지정되지 않은 경우 GCP의 PUT 명령이 기존 파일을 덮어쓰는 문제를 수정했습니다.보안 문제로 인해 Microsoft에서 금지한 CRT 함수를 제거했습니다.
버전 3.1.1(2023년 9월 29일)¶
새로운 기능과 업데이트¶
SSL 연결에 사용되는
cacert
번들을 업데이트했습니다.
버그 수정 사항¶
PUT/GET 명령 실패 시 “unknown exception” 대신 구체적인 오류를 제시하도록 관련 오류 메시지를 개선했습니다.
애플리케이션이 관련 쿼리를 취소한 후에도 ODBC 드라이버가 청크 다운로드를 계속 재시도하는 문제를 수정했습니다.
ARROW 결과 형식과 함께
SQLGetData()
를 사용하면 성능이 저하될 수 있는 문제를 수정했습니다.오류 메시지에 자격 증명이 표시되는 문제를 수정했습니다.
AWS PrivateLink 환경에서 OCSP 대체 요청 관련 문제를 수정했습니다.
OCSP 유효성 검사 수행 시 드라이버가 인증서에 있는 전체 OCSP URL을 사용하지 않는 문제를 수정했습니다.
버전 3.1.0(2023년 8월 23일)¶
BCR(동작 변경 릴리스) 변경 사항¶
특정 조건에서 드라이버가 HTTP 요청을 무기한으로 재시도할 수 있는 문제를 수정했습니다.
이전에는 가동 중단 중에 드라이버는 요청이 성공하거나 누군가 작업을 강제로 종료할 때까지 실패한 HTTP 호출을 계속해서 재시도했습니다.
이번 변경으로 드라이버는
execute
및executeQuery
호출에서 시작되는 무한 HTTP 재시도가 비활성화됩니다. 이제 드라이버는 기본적으로 HTTP 재시도 횟수를 7회로 제한합니다. 고객은maxHttpRetries
연결 매개 변수를 설정하여 최대 재시도 횟수를 사용자 지정할 수 있습니다. 고객은maxHttpRetries=0
으로 설정하여 재시도 횟수 제한을 제거할 수 있지만, 그러면 드라이버가 실패한 HTTP 호출을 무한히 재시도할 위험이 발생합니다.성능 향상을 위해
SQLExecDirect()
함수는 더 이상 쿼리에 대한 매개 변수 바인딩의 유효성을 불필요하게 검사하지 않습니다.이전에는 드라이버가 각
SQLExecDirect()
호출에 대해 설명 요청과 실행 요청이라는 두 가지 요청을 보냈습니다. 성능 향상을 위해 설명 요청을 생략했습니다. 이 변경으로 인해 드라이버는 쿼리에 필요한 매개 변수 바인딩의 유효성을 검사하지 않습니다.SQLFreeStmt(SQL_RESET_PARAMS)
를 사용하여 이전 쿼리의 매개 변수 바인딩이 지워지지 않으면 다음 쿼리에 잘못 적용되어 문제를 일으킬 수 있습니다.
새로운 기능과 업데이트¶
OOB(대역 외) 원격 분석 지원을 활성화 및 비활성화하기 위해
CLIENT_OUT_OF_BAND_TELEMETRY_ENABLED
세션 매개 변수를 추가했습니다.
버그 수정 사항¶
CALL과 같은 새로운 문 유형으로 시작하는 다중 문 쿼리에 대한 쿼리 결과를 가져올 때 드라이버가 실패할 수 있는 문제를 수정했습니다.
SQLColAttribute()
함수가VARCHAR
열에 잘못된SQL_DESC_OCTET_LENGTH
값을 반환하여 데이터가 잘릴 수 있는 문제를 수정했습니다.비공개 링크를 사용할 때 OOB(대역 외) 원격 분석 시간 제한을 잘못 전송하여 드라이버가 쿼리 결과를 다운로드하지 못하는 문제를 수정했습니다.
버전 3.0.2(2023년 7월 27일)¶
새로운 기능과 업데이트¶
다음 소프트웨어 라이브러리를 업데이트했습니다.
util-linux를 버전 2.39.0으로
curl을 버전 8.1.2로
HTAP(하이브리드 트랜잭션/분석 처리)를 강화했습니다.
Windows 플랫폼에서 실행 중인 ODBC 클라이언트의 경우
LogLevel
기본값을OFF
로 설정합니다.
버그 수정 사항¶
원격 분석을 보낼 때 작동이 간헐적으로 중단되는 문제를 수정했습니다.
버전 3.0.1(2023년 7월 6일)¶
BCR(동작 변경 릴리스) 변경 사항¶
ODBC 드라이버 버전 3.0.1부터 시작:
openssl 1.1.1에서 openssl 3.0.9로 업그레이드했습니다. 결과적으로, 이전 openssl 라이브러리 버전에서 더 이상 사용되지 않는 암호화 알고리즘을 사용하여 생성된 개인 키가 더 이상 작동하지 않습니다. ODBC 3.0.1로 업데이트할 때 키 페어 인증에 사용되는 개인 키 파일을 다시 생성해야 합니다.
CentOS 6 및 MacOS 10.14와 10.15를 위한 지원을 삭제했습니다.
새로운 기능과 업데이트¶
다음 소프트웨어 라이브러리를 업데이트했습니다.
openssl을 버전 3.0.9로
ICU를 버전 71.1.0으로
x86_64 및 arm64 Mac 시스템을 모두 지원하는 단일 통합 릴리스 패키지 아키텍처를 만들었습니다.
버그 수정 사항¶
Windows 시스템에서 CLIENT_SESSION_KEEP_ALIVE가 true로 설정된 경우 드라이버의 작동이 간헐적으로 중단되는 문제를 수정했습니다.
버전 2.25.12(2023년 6월 6일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
대량의 매개 변수 바인딩이 포함된 매우 큰 요청으로 인해 로깅 크기를 초과하여 애플리케이션의 작동이 중단될 수 있는 문제를 수정했습니다.
OCSP 유효성 검사 관련 문제를 수정했습니다.
Snowflake 로그 파일에서 프록시 비밀번호가 부주의로 드러날 수 있는 문제를 수정했습니다.
버전 2.25.11(2023년 4월 20일)¶
새로운 기능과 업데이트¶
libcurl 라이브러리를 버전 7.87.0에서 7.88.1로 업데이트했습니다.
zlib 라이브러리를 버전 1.2.11에서 1.2.13으로 업데이트했습니다.
버그 수정 사항¶
연결 설정 시 OCSP 유효성 검사 중에 발생할 수 있는 유효하지 않은 URL 문제를 수정했습니다.
자격 증명이 필요하지 않은 프록시를 사용할 경우 자격 증명을 입력할 때 연결이 실패하는 문제를 수정했습니다.
더 이상 사용되지 않는 openssl 함수 호출을 제거했습니다.
이중 유형 매개 변수 바인딩이 정밀도를 잃을 수 있는 문제를 수정했습니다.
Microsoft에서 금지한 안전하지 않은 함수 호출을 제거했습니다.
버전 2.25.10(2023년 3월 22일)¶
새로운 기능과 업데이트¶
libcurl 라이브러리를 버전 7.84.0에서 7.87.0으로 업데이트했습니다.
버그 수정 사항¶
클라이언트가 파일 DSN(데이터 원본 이름)을 생성하지 못하는 문제를 수정했습니다.
PUT 명령이 데이터 복제에 실패하는 문제를 수정했습니다.
ARM64 아키텍처를 실행하는 Macintosh 애플리케이션이 네이티브 Apple Silicon ODBC 드라이버를 사용하여 Snowflake에 연결하지 못하는 문제를 수정했습니다.
버전 2.25.9(2023년 2월 28일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
GEOMETRY 데이터가 포함된 메타데이터를 반환하는
SQLColumns()
함수를 호출할 때 발생하는 문제를 수정하기 위해SnowflakeType
열거형에 GEOMETRY 데이터 타입을 위한 지원을 추가했습니다.경우에 따라 타임스탬프 데이터가 NULL로 잘못 반환되는 문제를 수정했습니다.
버전 2.25.8(2023년 2월 8일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
세션에 스키마가 정의되지 않은 경우 배열 바인딩 INSERT 문이 실패하는 문제를 수정했습니다.
GET 및 PUT 쿼리를 실행할 때 가끔 ODBC 드라이버의 작동이 중단되는 문제를 수정했습니다.
세션이 약 120초간 유휴 상태로 있은 후 ODBC 드라이버가 SIGPIPE 신호를 보내는 문제를 수정했습니다.
HTTP 429 오류를 수신할 때 Okta 인증 사용이 실패하는 문제를 수정했습니다.