2024년 Snowflake Connector for Python 릴리스 정보¶
이 문서에는 Snowflake Connector for Python 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.
동작 변경 사항
새로운 기능
고객이 직면한 버그 수정
Snowflake는 Snowflake Connector for Python 업데이트에 의미 체계 버전 관리를 사용합니다.
설명서는 Python용 Snowflake 커넥터 섹션을 참조하십시오.
버전 3.12.3(2024년 10월 24일)¶
보안 수정 사항¶
CVE-2024-49750에서 제기된 문제를 해결했습니다. 자세한 내용은 GHSA-5vvg-pvhp-hv2m 권고 사항을 참조하십시오.
새로운 기능과 업데이트¶
더 명확한 해결 지침을 제공하고자 SSL 관련 문제에 대한 오류 메시지를 개선했습니다.
시간 제한으로 인해 발생하는 SQL 실행 취소에 대한 오류 메시지를 개선했습니다.
버그 수정 사항¶
없습니다.
버전 3.12.2(2024년 9월 11일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
비동기 쿼리 실패 시 더 자세하고 유익한 오류 메시지를 제공하도록 비동기 쿼리에 대한 오류 처리를 개선했습니다.
중국의 어떤 리전을 지정하는 계정의 최상위 도메인 추론을 개선하여, 이제는 기본적으로
snowflakecomputing.cn
으로 기본 설정됩니다.충돌 가능성을 줄이기 위해
snowflake.connector.util_text.random_string
구현을 개선했습니다.OCSP 페일 오픈(fail-open) 경고 메시지의 로그 수준을 ERROR에서 WARNING으로 업데이트했습니다.
버전 3.12.1(2024년 8월 20일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
세션을 갱신할 때 세션 토큰을 기록하는 버그를 수정했습니다.
클라이언트 원격 분석 비활성화가 작동하지 않는 버그를 수정했습니다.
로그인 재시도 단계에서
login_timeout
을 문자열로 전달하면TypeError
가 발생하는 버그를 수정했습니다.기본 구성 파일 위치를 확인하기 위해
os
대신pathlib
를 사용하도록 커넥터를 업데이트했습니다.상단
cryptogaphy
버전 핀을 제거했습니다.이전 버전에서 지원 모듈이 제거되었으므로
snowflake-export-certs
스크립트에 대한 참조를 제거했습니다.서버 응답이 수신되지 않을 때 쿼리 결과 폴링 중에 일시적인 네트워크 장애를 처리하기 위한 재시도 메커니즘을 향상했습니다.
버전 3.12.0(2024년 7월 26일)¶
새로운 기능과 업데이트¶
파일 전송 시 HTTP 호출에 대해 기본 연결 시간 제한을 10초로 설정하고 소켓 읽기 시간을 10분으로 설정했습니다.
여러 도메인에 연결하는 기능을 추가했습니다.
완전 병렬 다운로드 논리를 사용하여
to_pandas()
성능을 최적화했습니다.키링 종속성을 g>=23.1.0,<25.0.0에서 g>=23.1.0,<26.0.0으로 상향 조정했습니다.
버그 수정 사항¶
snowflake-sqlalchemy
에서client_session_keep_alive_heartbeat_frequency
를 지정하면 커넥터가 응답하지 않을 수도 있는 버그를 수정했습니다.잘못된
private_key
연결 매개 변수 유형 힌트를 수정했습니다.
버전 3.11.0(2024년 6월 18일)¶
새로운 기능과 업데이트¶
Snowflake에 연결할 때 파일에서 OAuth 토큰을 읽기 위해
token_file_path
연결 매개 변수에 대한 지원을 추가했습니다.화살표 데이터 구문 분석에 실패한 경우 원시 화살표 데이터를 디버깅할 수 있도록
debug_arrow_chunk
연결 매개 변수에 대한 지원을 추가했습니다.OKTA 인증에서 SAML URL 검사를 비활성화하는
disable_saml_url_check
연결 매개 변수에 대한 지원을 추가했습니다.
버그 수정 사항¶
SHA384 알고리즘을 사용하여 서명된 OCSP 인증서를 확인할 수 없는 버그를 수정했습니다.
PUT 명령이 400 오류가 발생하며 실패한 경우 상태 코드가 업로드됨으로 표시되는 버그를 수정했습니다.
현재 사용자에게 구성 파일 경로의 상위 디렉터리에 대한 올바른 권한이 없는 경우
PermissionError
가 발생하는 버그를 수정했습니다.OCSP GET URL에 슬래시가 포함된 경우 이 URL이 올바르게 인코딩되지 않는 버그를 수정했습니다.
SSO URL이
https://sso.abc.com/idp/startSSO.ping?PartnerSpId=https://xyz.snowflakecomputing.com/
에서처럼 쿼리 매개 변수에서:
을 허용하지 않는 버그를 수정했습니다.
버전 3.10.1(2024년 5월 21일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
화살표 데이터 변환 중에 발생할 수 있는 잘못된 오류 로그 메시지를 제거했습니다.
버전 3.10.0(2024년 5월 29일)¶
새로운 기능과 업데이트¶
fetch_pandas_all
에 정형 타입에 대한 지원이 추가되었습니다.
버그 수정 사항¶
잘못 구성된 중국 S3 엔드포인트와 관련된 문제를 수정했습니다.
버전 3.9.1(2024년 4월 22일)¶
새로운 기능과 업데이트¶
중국 엔드포인트에 연결할 때 HTTP 400 오류가 발생하는 문제를 수정했습니다.
버그 수정 사항¶
없습니다.
버전 3.9.0(2024년 4월 18일)¶
새로운 기능과 업데이트¶
로깅 구성 파일 에 로그 설정에 대한 지원이 추가되었습니다.
중국 엔드포인트에 연결할 때 S3 가속 로직이 개선되었습니다.
버그 수정 사항¶
없습니다.
버전 3.8.1(2024년 4월 9일)¶
새로운 기능과 업데이트¶
컨테이너화된 환경에서
externalbrowser
인증이 개선되었습니다.성공 페이지에서
/favicon
을 가져오지 않도록 브라우저에 지시합니다.빈
socket.recv
호출에 간단한 재시도 전략을 사용합니다.SNOWFLAKE_AUTH_SOCKET_REUSE_PORT
플래그(SNOWFLAKE_AUTH_SOCKET_REUSE_PORT=true
)를 추가하여 기본 소켓의SO_REUSEPORT
플래그를 설정합니다(소켓 설명서 페이지 의 설명 참조).이 플래그를 설정하면 컨테이너 엔진이 호스트에 대한 포트 포워딩을 완료하기 전에 로컬 호스트 콜백 URL에 사용된 임의의 포트를 따르는 경우에 유용합니다.
그런 다음 호스트와 컨테이너 사이에 포트를 정적으로 매핑하고 다음과 유사한 명령으로 해당 포트를 빠르게 연속해서 재사용할 수 있습니다.
SF_AUTH_SOCKET_PORT=3037 SNOWFLAKE_AUTH_SOCKET_REUSE_PORT=true poetry run python somescript.py
SNOWFLAKE_AUTH_SOCKET_MSG_DONTWAIT
플래그(SNOWFLAKE_AUTH_SOCKET_MSG_DONTWAIT=true
)를 추가하여 차단되지 않은socket.recv
호출을 하고 오류 시 재시도합니다.
스키마 쿼리에서 정형 타입 정보 구문 분석에 대한 지원이 추가되었습니다.
platformdirs
를 >=2.6.0,<4.0.0에서 >=2.6.0,<5.0.0로 상향 조정했습니다.system$whitelist
대신system$allowlist
를 사용하도록 진단을 업데이트했습니다.이제 연결에서
__del__
메서드 대신 인터프리터 종료를 사용하도록 정리 논리가 개선되었습니다.SnowflakeCursor.execute
를 사용하여 실행된 쿼리를 로깅할 때 로깅 수준을 INFO에서 DEBUG로 업데이트했습니다.
버그 수정 사항¶
로그에서 잘린 비밀번호가 마스크되지 않는 버그를 수정했습니다.
버전 3.7.1(2024년 2월 22일)¶
새로운 기능과 업데이트¶
다음 종속성의 버전을 높였습니다.
pandas 1.0.0 이상, 2.2.0 미만의 버전을 1.0.0 이상, 3.0.0 미만의 버전으로
cryptography 3.1.0 이상, 42.0.0 미만의 버전을 3.1.0 이상, 43.0.0 미만의 버전으로
pyOpenSSL 16.2.0 이상, 24.0.0 미만의 버전을 16.2.0 이상, 25.0.0 미만의 버전으로
보안 취약점을 해결하기 위해 인증 키 종속성 하한을 버전 23.1.0으로 높였습니다.
버그 수정 사항¶
10진수 데이터 변환 시 메모리 누수 문제를 수정했습니다.
write_pandas
가 대상 테이블을 자르지 않는 버그를 수정했습니다.
버전 3.7.0(2024년 1월 26일)¶
새로운 기능과 업데이트¶
Python 3.12 지원을 추가했습니다.
제로 행인
pyarrow.Table
을 강제로 반환하도록 새로운 부울force_return_table
매개 변수를SnowflakeCursor.fetch_arrow_all
에 추가했습니다.일부 C++ 코드 경고 및 성능 문제를 정리합니다.
암시적 가정에 대해 로컬 테스트를 더욱 강인하게 만들었습니다.
세션 및 마스터 토큰을 통해 기존 연결을 사용하여 연결하기 위한 지원을 추가했습니다.
외부 브라우저를 사용하여 여러 SAML IDP로 인증함으로써 Snowflake에 연결하기 위한 지원을 추가했습니다.
구성 권한 경고 메시지를 개선했습니다.
버그 수정 사항¶
PyArrow 테이블 유형 힌트 관련 문제를 수정했습니다.
gcc13의
cstdint
헤더 누락으로 인한 컴파일 문제를 수정했습니다.