2025년 Snowflake Python APIs 릴리스 정보¶

새로운 기능과 업데이트¶

• 프록시 구성에 대한 지원을 추가했습니다. HTTPS_PROXY 환경 변수를 사용하여 프록시 설정을 제공할 수 있습니다.

버그 수정 사항¶

없습니다.

새로운 기능과 업데이트¶

• Time Travel을 사용하여 스트림을 만들 때 시점 참조를 지정하기 위해 다음 메서드에 대한 지원을 추가했습니다.

  • PointOfTimeStatement

  • PointOfTimeStream

  • PointOfTimeTimestamp

버그 수정 사항¶

• 경고 'allow_population_by_field_name' has been renamed to 'validate_by_name' 을 수정했습니다.

• 종료자 작업이 삭제되기 전에 drop_finalizer 를 True 로 설정해야 하도록 DAGOperation 의 drop 메서드 동작을 복원했습니다.

  9.20 Snowflake 릴리스의 변경 사항으로 인해, fetch_task_dependents 는 방향성 비순환 그래프(DAG)에 속하는 다른 작업과 함께 종료자 작업을 반환하기 시작했습니다. 이 동작으로 인해 drop 메서드가 항상 종료자를 삭제했습니다.

새로운 기능과 업데이트¶

• Cortex Search Service API에 대한 QueryRequest 에서 query 및 column 매개 변수를 선택 사항으로 설정했습니다.

버그 수정 사항¶

없습니다.

새로운 기능과 업데이트¶

없습니다.

버그 수정 사항¶

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

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

새로운 기능과 업데이트¶

• 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__ 구현은 이제 이름과 함께 인자 목록을 표시합니다.

새로운 기능과 업데이트¶

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

버그 수정 사항¶

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

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

새로운 기능과 업데이트¶

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

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

  중요

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

버그 수정 사항¶

없습니다.

새로운 기능과 업데이트¶

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

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

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

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

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

• Database 및 Schema 리소스에 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_boosts 및 vector_boosts 를 Function 모델로 변경합니다

  • weights 를 ScoringConfig 모델로

버그 수정 사항¶

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

새로운 기능과 업데이트¶

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

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

  • API 통합

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

버그 수정 사항¶

없습니다.

새로운 기능과 업데이트¶

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

버그 수정 사항¶

없습니다.

새로운 기능과 업데이트¶

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

버그 수정 사항¶

없습니다.

새로운 기능과 업데이트¶

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

버그 수정 사항¶

없습니다.