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
        
        Copy
    • 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 헤더 누락으로 인한 컴파일 문제를 수정했습니다.