2025년 Snowflake Connector for Python 릴리스 정보¶

BCR (Behavior Change Release) changes¶

• 그룹 또는 다른 사용자가 쓸 수 있는 구성 파일은 이제 자세한 권한 정보가 포함된 :codenowrap:`ConfigSourceError`를 발생시켜 잠재적인 자격 증명 변조를 방지합니다.

• Oauth 인증자에 대한 토큰 만료 시나리오의 경우 예외 유형 변경 사항을 :codenowrap:`DatabaseError`로 되돌렸습니다.

새로운 기능과 업데이트¶

• 새로운 인증서 해지 목록(CRL) 확인 메커니즘을 구현했습니다.

  CRLs를 활성화하면 TLS 핸드셰이크 프로세스 동안 해지된 인증서를 확인하여 보안이 개선됩니다. 자세한 내용은 `인증서 해지 확인 방법으로 OCSP를 CRL로 바꾸기<https://community.snowflake.com/s/article/Replacing-OCSP-with-CRL-as-the-method-of-certificate-revocation-checking>`_ 기술 자료 문서를 참조하세요.

  이 기능은 기본적으로 비활성화되어 있습니다. 이 기능 활성화에 대한 내용은 CertRevocationCheckMode 섹션을 참조하세요. 프로덕션에서 이 기능을 활성화하기 전에 권고 모드에서 이 기능을 테스트하는 것이 좋습니다.

• Workload Identity Federation에 대한 서비스 계정 가장을 지원하도록 workload_identity_impersonation_path 매개 변수를 추가했습니다. 가장은 Google Cloud 및 AWS 워크로드에만 사용할 수 있습니다.

• 연결 요청 본문에서 OAuth 클라이언트 자격 증명 전송을 지원하도록 oauth_credentials_in_body 매개 변수를 추가했습니다.

• SNOWFLAKE_NO_BOTO 환경 변수를 true``로 설정하여 설치 중에 ``botocore 및 boto3 종속성을 제외하는 옵션을 추가했습니다. 전체 세부 정보는 Python Connector 설치하기 섹션을 참조하세요.

• OCSP 루트 인증서 사전에 대해 잠금을 획득하여 시간 제한(초)을 설정하기 위한 ocsp_root_certs_dict_lock_timeout 연결 매개 변수를 추가했습니다. 기본값은 시간 제한이 없음을 나타내는 -1입니다.

버그 수정 사항¶

• ``DictCursor``를 사용하고 한 번에 여러 문을 실행할 때의 ``get_results_from_sfqid``를 수정했습니다.

• ECONNRESET 오류에 대한 재시도 동작을 수정했습니다.

• cursor_class 유형과 일치하도록 :codenowrap:`SnowflakeConnection.cursor(cursor_class)`의 반환 유형을 수정했습니다.

• fetchone, :code:fetchmany 및 :code:`fetchall`의 유형을 제한했습니다.

• WORKLOAD_IDENTITY 인증자에 대해 AWS 리전이 AWS_REGION 대신 AWS_DEFAULT_REGION 변수에 설정된 경우 발생하는 “AWS 리전을 찾을 수 없음” 오류를 수정했습니다.

새로운 기능과 업데이트¶

• 일-시간 및 연도-월 간격 유형에 대한 pandas 변환 지원을 추가했습니다.

버그 수정 사항¶

• 없습니다.

새로운 기능과 업데이트¶

• 신뢰 저장소의 중간 인증서가 루트 인증서 역할을 하도록 허용하기 위한 지원을 추가했습니다.

• 번들된 `urllib3`을 버전 v2.5.0으로 업데이트했습니다.

• 번들된 `requests`를 버전 v2.32.5로 업데이트했습니다.

• 1.1.1 버전보다 이전 버전인 OpenSSL에 대한 지원이 중단되었습니다.

버그 수정 사항¶

• 없습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 구성 파일 권한 경고 메시지가 개선되었습니다.

  • SF_SKIP_WARNING_FOR_READ_PERMISSIONS_ON_CONFIG_FILE 환경 변수를 사용하여 경고를 건너뛰는 방법에 대한 명확한 지침을 포함하도록, 읽을 수 있는 권한 문제에 대한 경고 메시지가 개선되었습니다.

• AWS에서 스테이징 pandas 데이터프레임 버그를 수정했습니다. 필요한 경우 리전 엔드포인트가 사용됩니다.

  • 이 수정 사항은 Snowpark의 create_dataframe 호출과 관련된 문제를 해결합니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

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

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

새로운 기능과 업데이트¶

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

버그 수정 사항¶

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

새로운 기능과 업데이트¶

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

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

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

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

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

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

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

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

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

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

버그 수정 사항¶

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

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

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

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

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

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

새로운 기능과 업데이트¶

• 결과 배치의 다중 처리 가져오기를 활성화하여 일반적으로 가져오기 시간을 단축하는 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 의 사용법을 수정했습니다.

비공개 미리 보기(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_tokens 및 oauth_enable_single_use_refresh_tokens 매개 변수를 추가했습니다.

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

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

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

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

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

버그 수정 사항¶

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

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

비공개 미리 보기(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 자격 증명 업데이트 및 만료된 자격 증명이 발견될 때 증분 재시도 관련 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 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 연결 매개 변수를 추가했습니다.

새로운 기능과 업데이트¶

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

버그 수정 사항¶

• 없습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

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

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

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

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

새로운 기능과 업데이트¶

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

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

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

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

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

버그 수정 사항¶

• 없습니다.