2025년 Python용 Snowpark 라이브러리 릴리스 정보¶

개선 사항¶

• Snowflake 시스템 프로시저를 호출해도 프로시저의 반환 유형을 확인하기 위한 describe procedure 호출이 추가로 호출되지 않습니다.

• 스테이지 URL 및 FILE 데이터 타입으로 Session.create_dataframe() 지원이 추가되었습니다.

• session.read.option('mode', <mode>), option('rowTag', <tag_name>).xml(<stage_file_path>) 를 사용하여 XML 파일을 읽을 때 손상된 XML 레코드를 처리하기 위한 다양한 모드 지원이 추가되었습니다. 현재는 PERMISSIVE 및 FAILFAST 가 지원됩니다.

• 파일에서 지정된 ROWTAG 를 찾을 수 없을 때 XML 리더의 오류 메시지가 표시되는 문제를 개선했습니다.

• Dataframe.drop 에서 삭제된 열을 제외하기 위해 SELECT * EXCLUDE () 를 사용하도록 쿼리 생성을 개선했습니다. 이 기능을 활성화하려면 session.conf.set("use_simplified_query_generation", True) 를 설정합니다.

• VariantType 에 대한 지원을 StructType.from_json 에 추가했습니다.

버그 수정 사항¶

• DataFrameWriter.dbapi (비공개 미리 보기)에서 외부 데이터베이스의 Unicode 또는 큰따옴표로 묶인 열 이름이 올바르게 인용되지 않아 오류가 발생하는 버그가 수정되었습니다.

• 중첩된 OBJECT 데이터의 명명된 필드에 공백이 포함될 때 오류가 발생할 수 있는 버그가 수정되었습니다.

Snowpark 로컬 테스트 업데이트¶

Snowpark pandas API 업데이트¶

새로운 기능¶

• StoredProcedure.register():code: 에서 execute_as 인자의 restricted caller 권한에 대한 지원을 추가했습니다.

• DataFrame.to_pandas() 에서 비선택 문에 대한 지원이 추가되었습니다.

• Session.add_packages, Session.add_requirements, Session.get_packages, Session.remove_package, Session.clear_packages 에 artifact_repository 매개 변수에 대한 지원이 추가되었습니다.

• session.read.option('rowTag', <tag_name>).xml(<stage_file_path>) (실험적) 를 사용하여 XML 파일의 행 태그를 읽는 기능이 추가되었습니다.

  • 각 XML 레코드는 별도의 행으로 추출됩니다.

  • 해당 레코드 내의 각 필드는 VARIANT 유형의 별도 열이 되며, col(a.b.c) 와 같은 점 표기법을 사용하여 추가로 쿼리할 수 있습니다.

• DataFrameReader.dbapi (PrPr)에 업데이트가 추가되었습니다.

  • 여러 개의 가져온 데이터를 1개의 Parquet 파일로 병합하여 성능을 최적화하는 fetch_merge_count 매개 변수를 추가했습니다.

  • Databricks에 대한 지원이 추가되었습니다.

  • Snowflake UDTF 를 통한 수집 지원을 추가했습니다.

• functions.py (비공개 미리 보기)에서 다음 AI 기반 함수에 대한 지원이 추가되었습니다.

  • prompt

  • ai_filter (prompt() 함수 및 이미지 파일 지원 추가, 두 번째 인자 이름을 expr 에서 file 로 변경했습니다.)

  • ai_classify

Snowpark 로컬 테스트 업데이트¶

Snowpark pandas API 업데이트¶

새로운 기능¶

• relaxed_ordering 매개 변수를 도입하여 Dataframe.to_snowpark_pandas 에서 완화된 일관성 및 주문 보증을 지원합니다.

• DataFrameReader.dbapi (미리 보기)는 이제 session_init_statement 매개 변수에 대한 문자열 목록을 허용하여 세션 초기화 중에 여러 개의 SQL 문을 실행할 수 있습니다.

개선 사항¶

• Dataframe.stat.sample_by 가 fractions 에서 각 키에 대해 UNION ALL 하위 쿼리를 생성하는 기존 방식에 비해 대규모 fractions 사전과 잘 어울리는 단일 플랫 쿼리를 생성하도록 쿼리 생성을 개선했습니다. 이 기능을 활성화하려면 session.conf.set("use_simplified_query_generation", True) 를 설정합니다.

• Parquet 파일을 테이블에 복사본으로 복사할 때 벡터화 옵션을 활성화하여 DataFrameReader.dbapi 의 성능을 개선했습니다.

• DataFrame.random_split 에 대한 쿼리 생성이 다음과 같은 방식으로 개선되었습니다. session.conf.set("use_simplified_query_generation", True) 를 설정하여 활성화할 수 있습니다.

  • 입력 데이터프레임의 내부 구현에서 cache_result 를 제거하여 순수한 지연 데이터프레임 작업을 수행할 필요가 없어졌습니다.

  • 이제 seed 인자는 여러 호출과 세션에서 반복 가능한 결과를 제공하는 예상대로 작동합니다.

• DataFrame.fillna 및 DataFrame.replace 는 이제 include_decimal 이 True 로 설정된 경우 int 및 float 를 Decimal 열에 맞추는 기능을 지원합니다.

• 다음 UDF 및 files.py 의 저장 프로시저 함수에 대한 설명서를 일반 공급에 따라 추가했습니다.

  • SnowflakeFile.write

  • SnowflakeFile.writelines

  • SnowflakeFile.writeable

• SnowflakeFile 및 SnowflakeFile.open() 에 대한 설명서가 일부 변경되었습니다.

버그 수정 사항¶

• 오류를 발생시키는 다음 함수의 버그를 수정했습니다. .cast() 가 출력에 적용됩니다.

  • from_json

  • size

Snowpark 로컬 테스트 업데이트¶

Snowpark pandas API 업데이트¶

Snowpark 로컬 테스트 업데이트¶

버그 수정 사항¶

• 저장 프로시저 및 Snowbooks에서 사용할 수 없는 DataFrameReader.dbapi (비공개 미리 보기)의 버그가 수정되었습니다.

새로운 기능¶

• functions.py (비공개 미리 보기)에서 다음 AI 기반 함수에 대한 지원이 추가되었습니다.

  • ai_filter

  • ai_agg

  • summarize_agg

• 새로운 FILE SQL 유형에 대한 지원이 추가되었으며 functions.py (비공개 미리 보기)에 다음과 같은 관련 함수가 추가되었습니다.

  • fl_get_content_type

  • fl_get_etag

  • fl_get_file_type

  • fl_get_last_modified

  • fl_get_relative_path

  • fl_get_scoped_file_url

  • fl_get_size

  • fl_get_stage

  • fl_get_stage_file_url

  • fl_is_audio

  • fl_is_compressed

  • fl_is_document

  • fl_is_image

  • fl_is_video

• 아티팩트 저장소(비공개 미리 보기)를 사용하여 PyPi 에서 서드 파티 패키지를 가져오는 기능이 추가되었습니다.

  • 저장 프로시저 또는 사용자 정의 함수를 등록할 때 키워드 인자 artifact_repository 및 artifact_repository_packages 를 사용하여 아티팩트 저장소와 패키지를 각각 지정하십시오.

  • 지원되는 APIs 는 다음과 같습니다.

    • Session.sproc.register

    • Session.udf.register

    • Session.udaf.register

    • Session.udtf.register

    • functions.sproc

    • functions.udf

    • functions.udaf

    • functions.udtf

    • functions.pandas_udf

    • functions.pandas_udtf

개선 사항¶

• 저장 프로시저 등록 시 snowflake-snowpark-python 패키지 호환성에 대한 버전 유효성 검사 경고가 개선되었습니다. 이제 메이저 또는 마이너 버전이 일치하지 않는 경우에만 경고가 트리거되며, 버그 수정 버전 차이로 인해 더 이상 경고가 생성되지 않습니다.

• 이전 버전 외에 cloudpickle==3.0.0 도 지원하도록 클라우드피클 종속성을 변경했습니다.

버그 수정 사항¶

• 스레드 안전 세션이 비활성화된 경우 많은 수의 값이 있는 데이터프레임을 생성하면 Unsupported feature 'SCOPED_TEMPORARY'. 오류가 발생하는 버그를 수정했습니다.

• 스테이지 파일을 읽어 DataFrame 을 생성하고 CTE 최적화가 활성화된 경우 df.describe 가 내부 SQL 실행 오류를 발생시키는 버그를 수정했습니다.

• session.conf.set("use_simplified_query_generation", True) 를 사용하여 간소화된 쿼리 생성이 활성화된 경우 df.order_by(A).select(B).distinct() 가 잘못된 SQL 을 생성하는 버그를 수정했습니다.

  • 기본적으로 단순화된 쿼리 생성을 비활성화합니다.

Snowpark pandas API 업데이트¶

Snowpark 로컬 테스트 업데이트¶

새로운 기능¶

• functions.py 에서 다음 함수에 대한 지원을 추가했습니다.

  • normal

  • randn

• Dataframe.union_by_name 및 Dataframe.union_all_by_name 에 allow_missing_columns 매개 변수에 대한 지원을 추가했습니다.

개선 사항¶

• 충돌을 방지하기 위해 무작위 오브젝트 이름 생성을 개선했습니다.

• Dataframe.distinct 쿼리 생성이 GROUP BY all columns 을 사용하여 SELECT 대신 SELECT DISTINCT 를 생성하도록 개선되었습니다. 이 기능을 비활성화하려면 session.conf.set("use_simplified_query_generation", False) 로 설정하십시오.

사용 중단¶

• 사용되지 않는 Snowpark Python 함수 snowflake_cortex_summarize. 사용자는 snowflake-ml-python 을 설치하고 대신 snowflake.cortex.summarize 함수를 사용할 수 있습니다.

• 사용되지 않는 Snowpark Python 함수 snowflake_cortex_sentiment. 사용자는 snowflake-ml-python 을 설치하고 대신 snowflake.cortex.sentiment 함수를 사용할 수 있습니다.

버그 수정 사항¶

• 여러 쿼리를 생성하는 DataFrames 에 대한 스택 추적에 의해 세션 수준 쿼리 태그를 덮어쓰는 버그를 수정했습니다. 이제 쿼리 태그는 session.conf.set("collect_stacktrace_in_query_tag", True) 경우에만 스택트레이스로 설정됩니다.

• Session._write_pandas 에서 Snowpark Pandas 오브젝트를 작성할 때 use_logical_type 매개 변수를 Session._write_modin_pandas_helper 로 잘못 전달하던 버그를 수정했습니다.

• 여러 값의 형식이 잘못 지정될 수 있는 SQL 생성 옵션의 버그를 수정했습니다.

• 데이터베이스 또는 스키마의 빈 문자열이 올바르게 처리되지 않고 잘못된 SQL 문을 생성하는 버그가 Session.catalog 에서 수정되었습니다.

실험적 기능¶

• Snowflake 테이블에 파이로우 테이블 쓰기 지원이 추가되었습니다.

Snowpark pandas API 업데이트¶

버그 수정 사항¶

• apply 에서 kwargs가 적용된 함수에 올바르게 전달되지 않던 버그를 수정했습니다.

Snowpark 로컬 테스트 업데이트¶

버그 수정 사항¶

• DataFrame.join 에서 열에 잘못된 입력이 발생하는 버그가 수정되었습니다.

• otherwise 절에서 잘못된 결과를 유발하는 when 문의 버그를 수정했습니다.

새로운 기능¶

functions.py 에서 다음 함수에 대한 지원을 추가했습니다.

• array_reverse

• divnull

• map_cat

• map_contains_key

• map_keys

• nullifzero

• snowflake_cortex_sentiment

• acosh

• asinh

• atanh

• bit_length

• bitmap_bit_position

• bitmap_bucket_number

• bitmap_construct_agg

• cbrt

• equal_null

• from_json

• ifnull

• localtimestamp

• max_by

• min_by

• nth_value

• nvl

• octet_length

• position

• regr_avgx

• regr_avgy

• regr_count

• regr_intercept

• regr_r2

• regr_slope

• regr_sxx

• regr_sxy

• regr_syy

• try_to_binary

• base64

• base64_decode_string

• base64_encode

• editdistance

• hex

• hex_encode

• instr

• log1p

• log2

• log10

• percentile_approx

• unbase64

• DataFrame.create_dataframe 을 호출할 때 스키마 문자열(암시적 구조체 구문 포함) 지정에 대한 지원을 추가했습니다.

• DataFrameWriter.insert_into/insertInto 를 지원하는 기능이 추가되었습니다. 이 방법은 로컬 테스트 모드도 지원합니다.

• 임시 뷰를 만들기 위한 DataFrame.create_temp_view 지원을 추가했습니다. 뷰가 이미 존재하면 실패합니다.

• map_cat 및 map_concat 함수에서 여러 열에 대한 지원을 추가했습니다.

• DataFrame.with_column 및 DataFrame.with_columns 에서 원래 열 순서를 유지하기 위한 옵션 keep_column_order 를 추가했습니다.

• StructType 열의 필드 이름을 바꾸거나 필드를 추가할 수 있는 열 캐스트에 옵션을 추가했습니다.

• contains_null parameter 에 대한 지원을 ArrayType 에 추가했습니다.

• 스테이지에서 파일을 읽어 만든 DataFrame 에서 DataFrame.create_or_replace_temp_view 를 통해 임시 뷰를 생성하는 기능을 추가했습니다.

• MapType 에 value_contains_null 매개 변수에 대한 지원을 추가했습니다.

• 현재 환경이 대화형 환경인지 여부를 나타내는 원격 분석에 대화형 기능을 추가했습니다.

• Native App에서 session.file.get 이 현재 버전에서 /로 시작하는 파일 경로를 읽을 수 있도록 허용합니다.

• DataFrame.pivot 이후 여러 집계 함수에 대한 지원을 추가했습니다.

실험적 기능¶

• Snowflake 오브젝트를 관리하는 Session.catalog 클래스를 추가했습니다. Session.catalog 를 통해 액세스할 수 있습니다.

  • snowflake.core 는 이 기능에 필요한 종속성입니다.

• 스테이지에서 JSON 파일을 읽을 때 사용자 입력 스키마 또는 사용자 입력 스키마를 허용합니다.

• DataFrame.create_dataframe 을 호출할 때 스키마 문자열(암시적 구조체 구문 포함) 지정에 대한 지원을 추가했습니다.

개선 사항¶

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

버그 수정 사항¶

• 로컬 테스트 모드에서 열에 0이 포함되어야 하는데 None이 포함되는 버그를 수정했습니다.

• StructField.from_json 에서 tzinfo 를 포함한 TimestampTypes 가 올바르게 구문 분석되지 않는 버그를 수정했습니다.

• 입력 열이 날짜 유형 또는 타임스탬프 유형일 때 오류를 발생시키는 function date_format 버그를 수정했습니다.

• Null이 아닌 열에 null 값을 삽입할 수 있는 DataFrame 버그를 수정했습니다.

• 열 식 오브젝트를 전달할 때 유형 힌트 어설션 오류가 발생하던 replace 및 lit 함수의 버그를 수정했습니다.

• pandas_udf 및 pandas_udtf 에서 세션 매개 변수가 잘못 무시되던 버그를 수정했습니다.

• session.call 을 통해 호출되는 시스템 함수에 대해 잘못된 유형 변환 오류가 발생하던 버그를 수정했습니다.

Snowpark pandas API 업데이트¶