2025년 Snowflake Connector for Python 릴리스 정보

이 문서에는 Snowflake Connector for Python 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.

  • 동작 변경 사항

  • 새로운 기능

  • 고객이 직면한 버그 수정

Snowflake는 Snowflake Connector for Python 업데이트에 의미 체계 버전 관리를 사용합니다.

설명서는 Python용 Snowflake 커넥터 섹션을 참조하십시오.

버전 3.17.2(2025년 8월 20일)

새로운 기능과 업데이트

  • 없습니다.

버그 수정 사항

  • platform_detection_timeout_seconds 를 zero로 설정하여 엔드포인트 기반 플랫폼 감지를 비활성화하는 기능을 추가했습니다.

  • platform_detection 이 존재하지 않는 엔드포인트에 대해 경고를 나타내며 실패한 요청을 재시도하는 버그를 수정했습니다.

버전 3.17.1(2025년 8월 14일)

새로운 기능과 업데이트

  • 전달된 데이터에 대한 스키마 추론을 수행하기 위해 infer_schema 매개 변수를 write_pandas 에 추가했습니다.

버그 수정 사항

  • snowflake 네임스페이스를 비모듈로 다시 복구했습니다.

버전 3.17.0(2025년 8월 13일)

새로운 기능과 업데이트

  • AWS, Azure, Google Cloud, Kubernetes 플랫폼에서 워크로드 ID 페더레이션에 대한 지원을 추가했습니다.

    • workload_identity_provider 연결 매개 변수를 추가했습니다.

    • WORKLOAD_IDENTITYauthenticator 연결 매개 변수 값에 추가했습니다.

  • 캐시 및 구성에 대한 파일 권한 검사를 건너뛰도록 unsafe_skip_file_permissions_check 플래그를 추가했습니다.

  • Interval 유형에 대한 기본 JSON 지원을 추가했습니다.

  • 내부 유형에 대해 ResultMetadatatype_code 를 채우는 기능을 추가했습니다.

  • PyArrow 버전 제약 조건을 완화했습니다. 이제 >= 19 버전을 사용할 수 있습니다.

  • snowflake_version property 을 연결에 도입했습니다.

  • write_pandas 함수에서 use_vectorized_scanner 매개 변수에 대한 지원을 추가했습니다.

  • 환경 변수를 내보내지 않고 연결 매개 변수를 사용한 프록시 설정 지원을 추가했습니다.

버그 수정 사항

  • OAuth 인증자 값을 수정했습니다.

  • external_session_idSnowflakeRestful.fetch 에 제공되지 않는 경우 외부 세션 인증자가 있는 PAT가 사용되는 버그를 수정했습니다.

  • Oauth 및 programmatic_access_token 인증자 값이 대소문자를 구분하도록 수정했습니다.

  • 잘못된 인증자 값에 대한 명확하지 않은 오류 메시지를 수정했습니다.

  • 엔드포인트가 스키마를 갖도록 GCS 스테이징을 수정했습니다.

  • pandas.DataFrame 또는 pyarrow.Table 로 가져온 표준 시간대 타임스탬프가 불필요한 정밀도로 인해 오버플로되는 버그를 수정했습니다. 이제 오버플로를 방지할 수 없는 경우 명확한 오류가 발생합니다.

버전 3.16.0(2025년 7월 1일)

새로운 기능과 업데이트

  • 결과 배치의 다중 처리 가져오기를 활성화하여 일반적으로 가져오기 시간을 단축하는 client_fetch_use_mp 연결 매개 변수를 추가했습니다.

  • 외부 세션 ID를 사용한 새로운 PAT(개인 액세스 토큰) 인증 메커니즘에 대한 지원을 추가했습니다.

  • write_pandas 함수에 bulk_upload_chunks 매개 변수를 추가했습니다. 이 매개 변수를 codenowrap:True 로 설정하면 write_pandas 함수의 동작이 모든 데이터 청크를 로컬 디스크에 먼저 쓴 다음, 스테이지에 청크 폴더의 와일드카드 업로드를 수행하는 것으로 변경됩니다. False (기본값)로 설정하면 청크가 하나씩 저장, 업로드 및 삭제됩니다.

  • Python 3.13에 대한 Windows 지원을 추가했습니다.

  • Interval 유형에 대한 기본 Arrow 지원을 추가했습니다.

  • 로컬 애플리케이션에 대해 Snowflake OAuth 지원을 추가했습니다.

버그 수정 사항

  • 위치 이름의 write_pandas 특수 문자 사용법을 수정했습니다.

  • Google Cloud Storage(GCS) 클라이언트의 위치를 빌드할 때 use_virtual_url 의 사용법을 수정했습니다.

버전 3.15.0(2025년 4월 28일)

비공개 미리 보기(PrPr) 기능

AWS, Azure, GCP 및 Kubernetes 플랫폼에서 워크로드 ID 페더레이션에 대한 지원을 추가했습니다.

면책 조항:

  • 이 기능은 SF_ENABLE_EXPERIMENTAL_AUTHENTICATION 환경 변수를:codenowrap:true 로 설정해야 액세스할 수 있습니다.

  • 이 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.

  • 이 PrPr 기능은 지원팀에서 담당하지 않습니다. 그러나 제품 및 엔지니어링 팀은 PrPr 단계에서 이용할 수 있습니다.

  • 참여 및 설명서는 계정 팀에 문의하십시오.

새로운 기능과 업데이트

  • OAuth 2.0 승인 코드 플로우, OAuth 2.0 클라이언트 자격 증명 플로우 및 OAuth 토큰 캐싱에 대한 새로운 인증 방법 지원이 추가되었습니다.

    • OAuth 2.0 승인 코드 플로우의 경우:

      • oauth_client_id, oauth_client_secret, oauth_authorization_url, oauth_token_request_url, oauth_redirect_uri, oauth_scope, oauth_disable_pkce, oauth_enable_refresh_tokensoauth_enable_single_use_refresh_tokens 매개 변수를 추가했습니다.

      • 매개 변수 인증자에 대해 OAUTH_AUTHORIZATION_CODE 값을 추가했습니다.

    • OAuth 2.0 클라이언트 자격 증명 플로우의 경우:

      • oauth_client_id, oauth_client_secret, oauth_token_request_urloauth_scope 매개 변수를 추가했습니다.

      • 매개 변수 인증자에 대해 OAUTH_CLIENT_CREDENTIALS 값을 추가했습니다.

    • OAuth 토큰 캐싱의 경우: 드라이버 구성으로의 사용자 이름 전달은 필수이며, client_store_temporary_credential propertytrue 로 설정해야 합니다.

버그 수정 사항

  • 최소 필수 botobotocore 버전이 1.24로 증가했습니다.

  • 신뢰할 수 있는 인증서에 이미 도달한 경우 인증서의 체인 통과를 종료하여 OSCP 관련 문제를 수정했습니다.

버전 3.14.1(2025년 4월 21일)

비공개 미리 보기(PrPr) 기능

  • 쿼리 결과를 가져오는 스레드를 더 잘 활용하기 위해 client_fetch_threads 실험 매개 변수가 추가되었습니다.

  • 새로운 실험적 인증 방법을 추가했습니다.

    • OAuth 승인 코드 및 클라이언트 자격 증명 플로우.

    • AWS, Azure, GCP 및 Kubernetes 플랫폼용 워크로드 ID 페더레이션.

면책 조항:

  • 이 기능은 SF_ENABLE_EXPERIMENTAL_AUTHENTICATION 환경 변수를:codenowrap:true 로 설정해야 액세스할 수 있습니다.

  • 이러한 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.

  • 이러한 PrPr 기능은 지원팀에서 담당하지 않습니다. 그러나 제품 및 엔지니어링 팀은 PrPr 단계에서 이용할 수 있습니다.

  • 참여 및 설명서는 계정 팀에 문의하십시오.

새로운 기능과 업데이트

  • Python 3.13 지원을 추가했습니다.

    참고

    Windows 64 지원은 아직 실험 단계이므로 아직 프로덕션 환경에 사용해서는 안 됩니다.

  • Python 3.8에 대한 지원이 중단되었습니다.

  • 기본 소수점 floating-point 유형에 대한 지원이 추가되었습니다.

  • password 필드에 PAT 제공을 위한 지원이 추가되었습니다.

  • GCS 리전 엔드포인트에 대한 지원이 추가되었습니다.

  • GCS 가상 URLs 에 대한 지원이 추가되었습니다. 자세한 내용은 엔드포인트 요청 섹션을 참조하십시오.

  • 커넥터가 HTTP 요청 ID 에 사용할 UUID4 를 자동으로 생성하는 대신, 문 매개 변수(필드: requestId)에 제공된 UUID4 생성 업스트림을 상속할 수 있도록 지원이 추가되었습니다.

  • 향후 외부 소유 라이브러리로 마이그레이션한 후에도 데이터 마스킹을 보장하기 위해 urllib3, boto3 및 botocore 라이브러리의 로그가 개선되었습니다.

  • 일부 메시지의 로그 수준을 info 에서 debug 로 낮추어 출력을 더 쉽게 볼 수 있도록 했습니다.

  • 임시 자격 증명 캐시 저장소에 대한 보안 및 견고성이 향상되었습니다.

  • insecure_mode 연결 속성을 더 이상 사용하지 않고 이전 속성과 동작이 동일한 disable_ocsp_checks 로 대체했습니다.

  • 토큰 캐싱 개선을 포함하여 Linux용 파일 기반 자격 증명 캐시를 구현하고 개선했습니다.

버그 수정 사항

  • 시간 제한으로 인한 클라이언트 측 쿼리 취소에 대한 오류 메시지가 개선되었습니다.

  • 잘못된 날짜 뒤에 올바른 날짜가 올 때 TO_DATE 화살표를 Python으로 변환할 때 드라이버가 자동으로 실패하는 버그를 수정했습니다.

  • 마지막 열에서 오류가 발생할 때까지 드라이버가 오류를 무시하는 이전 동작을 복원하기 위해 check_arrow_conversion_error_on_every_column 으로 설정할 수 있는 False 연결 속성을 추가했습니다. 이 옵션을 사용하면 버그 수정의 영향을 받을 수 있고 이후 릴리스에서 제거될 워크플로의 차단을 해제할 수 있습니다.

  • 만료된 S3 자격 증명 업데이트 및 만료된 자격 증명이 발견될 때 증분 재시도 관련 문제를 수정했습니다.

버전 3.14.0(2025년 3월 3일)

새로운 기능과 업데이트

  • pyOpenSSL 종속성 상한을 <25.0.0에서 <26.0.0으로 상향 조정했습니다.

  • 가져오기 속도 향상을 위해 배포 패키지 조회를 최적화했습니다.

  • Iceberg 테이블에 대한 지원이 write_pandas 에 추가되었습니다.

  • File 유형에 대한 지원이 추가되었습니다.

버그 수정 사항

  • Azure 배치에 영향을 미치는 버그에 대한 해결 방법으로 <19.0.0 핀을 pyarrow 에 추가했습니다.

  • 비공개 링크 계정 이름이 대문자로 지정된 경우 비공개 링크 OCSP 캐시 URL을 확인할 수 없는 버그를 수정했습니다.

  • Base64로 인코딩된 개인 키 테스트 수정.

  • Windows에서 파일 권한 확인 관련 버그를 수정했습니다.

  • 644 권한으로 GET 으로 다운로드한 파일을 저장하는 이전 동작을 복원하는 unsafe_file_write 연결 매개 변수를 추가했습니다.

버전 3.13.2(2025년 1월 30일)

새로운 기능과 업데이트

  • 커넥터는 더 이상 범위가 지정된 임시 오브젝트를 사용하지 않습니다.

버그 수정 사항

  • 없습니다.

버전 3.13.1(2025년 1월 29일)

새로운 기능과 업데이트

  • 없습니다.

버그 수정 사항

  • SQL 주입에 맞서 sparkling.connector.pandas_tools 모듈을 강화했습니다. 자세한 내용은 CVE-2025-24793 섹션을 참조하십시오.

  • 로컬 OCSP 캐시는 내용을 직렬화할 때 pickle 대신 JSON 모듈을 사용하도록 업데이트되었습니다. 자세한 내용은 CVE-2025-24794 섹션을 참조하십시오.

  • Linux 자격 증명 캐시 파일 권한이 소유자만 읽을 수 있도록 명시적으로 업데이트되었습니다. 자세한 내용은 CVE-2025-24795 섹션을 참조하십시오.

  • GET 을 사용하여 다운로드한 파일에 대한 파일 권한을 파일 소유자만 읽을 수 있도록 업데이트했습니다.

버전 3.13.0(2025년 1월 23일)

새로운 기능과 업데이트

  • iobound_tpe_limit 연결 매개 변수를 추가하여 PUT 및 GET 명령 실행 중에 IO 에 바인딩된 ThreadPoolExecutors 의 크기를 제한합니다. 기본적으로 크기는 파일 수와 CPU 코어 수 중 적은 값으로 계산됩니다.

  • 연결이 쿼리를 수신할 수 있을 만큼 안정적인지 확인하는 Connection.is_valid() 메서드를 추가했습니다.

  • 커서의 청크 rowcount 에 대한 로그 수준을 INFO 에서 DEBUG 로 업데이트했습니다.

  • private_key 인증 유형에서 base64로 인코딩된 DER 개인 키 문자열에 대한 지원을 추가했습니다.

  • cosign 을 사용하여 패키지 서명을 확인하는 방법에 대한 지침을 포함하도록 README.md 를 업데이트했습니다.

버그 수정 사항

  • 없습니다.