2025년 Snowflake Python APIs 릴리스 정보

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

  • 동작 변경 사항

  • 새로운 기능

  • 고객이 직면한 버그 수정

설명서는 Snowflake Python APIs: Python으로 Snowflake 오브젝트 관리하기 섹션을 참조하십시오.

버전 1.5.1(2025년 5월 28일)

새로운 기능과 업데이트

없습니다.

버그 수정 사항

  • extract 옵션을 ReturnTable 유형과 함께 사용할 때 call 메서드가 잘못된 결과를 반환하는 버그가 ProcedureResource 에서 수정되었습니다.

  • CortexInferenceService.complete 는 이제 Python 워크시트와 노트북에서 호출할 수 있습니다.

버전 1.5.0(2025년 5월 14일)

새로운 기능과 업데이트

  • ServiceResource.get_containers 메서드를 대신하여 ServiceResource.get_service_status 메서드를 더 이상 사용하지 않습니다.

  • procedure.call 메서드에 extract 옵션을 추가했습니다. 이 옵션을 활성화하면 메서드가 반환된 페이로드에서 결과를 추출합니다.

    예를 들어, (현재 기본 동작)을 설정하면 [{'procedure_name': 42}] 와 같은 결과 세트가 반환됩니다. 이 예제에서는 42 값을 반환하도록 extract=True 를 설정할 수 있습니다.

    참고

    extract=False 는 현재 기본 설정으로 유지되지만 이제 사용 중단 경고를 반환합니다. 다음 주요 릴리스에서 새로운 기본값이 될 extract=True 로 변환하는 것이 좋습니다.

  • 저장 프로시저 호출에서 VARIANT 유형을 매핑하는 기능이 추가되었습니다.

버그 수정 사항

  • 저장 프로시저의 GEOMETRY, GEOGRAPHY, OBJECT 반환 유형에 대한 유형 매핑을 수정했습니다.

  • 저장 프로시저 및 함수에 대한 __repr__ 구현은 이제 이름과 함께 인자 목록을 표시합니다.

버전 1.4.0(2025년 4월 23일)

새로운 기능과 업데이트

  • 모든 컬렉션, 리소스 및 모델 클래스에 대해 __repr__ 메서드를 구현했습니다.

버그 수정 사항

  • _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE 환경 변수를 기본적으로 활성화하도록 변경하여 인쇄된 오류 메시지에 전체 스택 추적이 표시되도록 했습니다.

    SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE 가 설정되지 않은 경우 발생하는 모든 예외에 대한 스택 추적을 비활성화하지 않기 위해 변경되었습니다.

버전 1.3.0(2025년 4월 9일)

새로운 기능과 업데이트

  • 오브젝트 식별자를 나타내는 snowflake.core.FQN 클래스를 추가했습니다.

  • DAGOperation.drop 메서드는 drop_finalizer 인자가 True 으로 설정된 경우DAG과 연결된 파이널라이저 작업을 삭제합니다.

    중요

    drop_finalizer 인자는 다음 주요 API 릴리스에서 제거될 예정이며, DAGOperation.drop 메서드는 항상 DAG 와 함께 연결된 파이널라이저 작업을 삭제합니다.

버그 수정 사항

없습니다.

버전 1.2.0(2025년 3월 26일)

새로운 기능과 업데이트

  • 기존의 모든 엔드포인트에서 비동기 요청에 대한 지원이 추가되었습니다.

    비동기 메서드는 이름에 _async 가 접미사로 표시되며 폴링을 사용하여 작업 완료 여부를 결정합니다.

    병렬로 실행할 수 있는 호출 수는 CPUs 수에 따라 다릅니다. 스레드 풀의 크기를 변경하려면 _SNOWFLAKE_MAX_THREADS 환경 변수를 사용하십시오.

    사용 예는 snowflake.core.PollingOperation 클래스 설명서를 참조하십시오.

  • StoredProcedureCall 정의를 사용하여 서버리스 작업을 생성할 수 있도록 지원이 추가되었습니다.

  • DatabaseSchema 리소스에 SERVERLESS_TASK_MIN_STATEMENT_SIZE 및 SERVERLESS_TASK_MAX_STATEMENT_SIZE 서버리스 특성에 대한 지원이 추가되었습니다(Snowflake 버전 9.8에 종속성).

  • 복제본 데이터베이스 및 스키마에서SUSPEND_TASK_AFTER_NUM_FAILURES, USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE, USER_TASK_TIMEOUT_MS 특성 설정에 대한 지원이 추가되었습니다(Snowflake 버전 9.8에 종속성).

  • CortexAgentService.run 으로 대체하기 위해 CortexAgentService.Run 을 폐지했습니다.

  • Cortex Search Service API 내의 다양한 모델에 새로운 선택적 특성을 추가했습니다.

    • text_boostsvector_boostsFunction 모델로 변경합니다

    • weightsScoringConfig 모델로

버그 수정 사항

  • 이제 iter 메서드에서 반환된 작업 오브젝트를 사용하여 create_or_alter 를 호출할 수 있습니다.

버전 1.1.0(2025년 3월 12일)

새로운 기능과 업데이트

  • 작업 리소스에 TARGET_COMPLETION_INTERVAL, SERVERLESS_TASK_MIN_STATEMENT_SIZE, SERVERLESS_TASK_MAX_STATEMENT_SIZE 서버리스 특성에 대한 지원이 추가되었습니다.

  • 다음과 같은 새로운 리소스에 대한 지원을 추가했습니다.

    • API 통합

    • Iceberg 테이블(Snowflake 버전 9.6의 종속성)

버그 수정 사항

없습니다.

버전 1.0.5(2025년 2월 19일)

새로운 기능과 업데이트

  • snowflake.core 에서 protobuf 종속성을 제거했습니다.

버그 수정 사항

없습니다.

버전 1.0.4(2025년 2월 13일)

새로운 기능과 업데이트

  • Cortex Lite Agent 리소스에 대한 지원이 추가되었습니다.

버그 수정 사항

없습니다.

버전 1.0.3(2025년 2월 4일)

새로운 기능과 업데이트

  • Cortex Embed 리소스에 대한 지원이 추가되었습니다.

버그 수정 사항

없습니다.