2024년 Snowflake Python APIs 릴리스 정보¶

새로운 기능과 업데이트¶

• 스택 추적을 단축하여 오류 메시지를 개선했습니다. 이 동작을 제어하려면 _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE 환경 변수 옵션을 사용합니다.

• 이제 모델에서 to_dict() 가 반환한 사전에 읽기 전용 속성을 기본적으로 포함합니다. 이 옵션을 전환하려면 to_dict (hide_readonly_properties=True) 를 사용합니다.

• 주어진 리소스가 존재하지 않을 경우 오류가 발생하지 않고 작업을 수행할 수 있는지 여부를 토글 전환하는 if_exists 속성을 다음 메서드와 리소스에 추가했습니다.

  • Database, NetworkPolicy, View, User, ComputePool, ImageRepository, Pipe, Role, Service, Stage, Table, Task, DynamicTable, Role, Alert, Procedure, Warehouse, Schema, Function 의 경우 drop().

  • Database 및 DynamicTable 의 경우 refresh().

  • Service, DynamicTable, Warehouse 의 경우 suspend() 및 resume().

  • DynamicTable 및 Table 의 경우 suspendRecluster() 및 resumeRecluster().

• Database 는 이제 undrop() 메서드를 지원합니다.

• Service 는 이제 iter() 의 from_name 매개 변수를 지원합니다.

• Table 은 이제 swap_with() 의 target_database 및 target_schema 매개 변수를 지원합니다.

• Procedure 는 이제 create() 의 copy_grants 매개 변수를 지원합니다.

버그 수정 사항¶

• 이제 동적 테이블을 올바로 생성하면 서로 다른 데이터베이스와 스키마에서 원본 오브젝트를 복제할 수 있습니다.

• 호스트 이름에 밑줄을 함께 사용할 경우 계정과 조직에 발생하는 SSL 연결 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 데이터베이스 역할 리소스에 대한 지원을 추가했습니다.

• 액세스 권한을 관리하기 위해 역할, 데이터베이스 역할, 사용자 리소스에 새로운 메서드를 추가했습니다.

• 시크릿이 스크러빙된 로그를 개선했습니다.

버그 수정 사항¶

• 없습니다.

새로운 기능과 업데이트¶

• API 설명서를 상당히 개선했습니다.

• snowflake.core 의 종속성인 snowflake-snowpark-python 을 제거했습니다. 그러나 이 패키지는 작업 그래프(DAG) 개념 등 일부 기능에 여전히 필요하며, 이러한 기능에 대한 검사 및 요구 사항은 런타임에 수행됩니다.

• Python 버전 3.8 이상의 모든 버전에 대한 지원을 추가했습니다.

• 테이블 복제를 위해 targetDatabase 및 targetSchema 에 대한 지원을 추가했습니다.

• 스키마 복제를 위해 targetDatabase 에 대한 지원을 추가했습니다.

• 타입 정의를 노출했습니다.

• ServiceCollection 에서 execute_job 에 대한 지원을 추가했습니다.

• ServiceResource 에서 get_containers, get_instances, get_roles 에 대한 지원을 추가했습니다.

• Service 및 ComputePool 에서 create_or_update 에 대한 지원을 추가했습니다.

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

  • 계정

  • 경고

  • 카탈로그 통합

  • 이벤트 테이블

  • 외부 볼륨

  • 관리되는 계정

  • 네트워크 정책

  • 노트북

  • 알림 통합

  • 파이프

  • 절차

  • 스트림

  • 사용자 정의 함수

  • 뷰

버그 수정 사항¶

• URL 로깅과 관련하여 일부 URL 조각이 로깅에 주입되지 않는 버그를 수정했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 대규모 결과 처리와 관련된 여러 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 이제 클라이언트는 재시도 가능한 오류 코드에 대해 요청을 재시도합니다.

• 다음 StageResource 메서드는 더 이상 사용되지 않으며 이름이 바뀌었습니다. 이전 메서드 이름은 지금은 별칭입니다.

  • upload_file 에서 put 로.

  • download_file 에서 get 로.

새로운 기능과 업데이트¶

• 디버그 기능을 강화하기 위해 라이브러리에 클라이언트 로깅을 추가했습니다.

• DynamicTable, Schema 및 Table 오브젝트 유형에 undrop 지원을 추가했습니다.

• 다음과 같은 제한 사항이 있는 Grant 오브젝트 유형에 대한 지원을 강화했습니다.

  • SQL 명령 SHOW GRANTS ON은 지원되지 않습니다.

  • Grants.to 메서드(SHOW GRANTS TO)의 피부여자 값으로 Grantees.role 만 지원됩니다.

• 동등한 SQL 명령과의 일관성을 유지하기 위해 다음 메서드는 이제 더 이상 사용되지 않으며 다음과 같이 이름이 바뀌었습니다. 이전 메서드 이름은 이제 새 메서드 이름을 호출하는 별칭이므로, 이전 메서드 이름을 사용해도 기대한 동작을 계속 수행합니다.

  • create_or_update 에서 create_or_alter 로.

  • delete 에서 drop 로.

  • undelete 에서 undrop 로.

버그 수정 사항¶

• 저장 프로시저에서 생성된 코드의 버그를 수정했습니다.

새로운 기능과 업데이트¶

• 다음 리소스에 대해 API 지원을 추가했습니다.

  • DynamicTable

  • Function (현재 서비스 함수만 지원)

  • Grant

• 작업 및 작업 그래프(DAG)에서 파이널라이저에 대한 지원을 추가했습니다.

새로운 기능과 업데이트¶

• 다음 리소스에 대해 실험 모드에서 API 지원을 추가했습니다.

  • User

  • Role

  • 관리 Stage

• Warehouse, Schema 및 Database 리소스에 대한 create_or_update 지원을 다시 추가했습니다.

  참고

  이러한 리소스에 대한 create_or_update 기능을 사용하려면 출시가 예정된 Snowflake 버전 8.23이 필요하지만, 2024년 6월 10일 현재 기준으로 아직 출시되지 않았습니다.

• 주어진 Service 오브젝트에 대한 엔드포인트 목록을 반환하는 get_endpoints 리소스에 대한 Service 메서드를 추가했습니다.

버그 수정 사항¶

• with_managed_access 는 이제 SchemaResource 의 속성으로 올바르게 반환됩니다.

새로운 기능과 업데이트¶

• SchemaResource 에 대한 create_or_update 에 with_managed_access 부울 옵션이 추가되었습니다. 이 옵션은 CREATE SCHEMA 의 WITH MANAGED ACCESS 선택적 매개 변수와 동일합니다.

  • 사용법 예:

    schema.create_or_update(schema_def, with_managed_access = True)
    

    Copy

• 주어진 Service 오브젝트에 대한 엔드포인트 목록을 반환하는 get_endpoints 리소스에 대한 Service 메서드를 추가했습니다.

동작 변경 사항¶

• TableResource 오브젝트의 fetch() 에서 deep 매개 변수를 제거했습니다. fetch() 는 항상 TableResource 의 세부 열 및 제약 조건 정보를 반환합니다.

• create_or_update() 는 현재 Schema, Warehouse, Database 및 ComputePool 리소스에서 더 이상 작동하지 않습니다. 이러한 리소스에는 create() 가 작동합니다.

• as_select 를 사용하여 테이블을 만들면 더 이상 as_select 쿼리에 사용된 원본 테이블의 정보를 가져오지 않습니다.

• 기존 테이블을 변경하는 create_or_update 문에서 명시적으로 설정하지 않은 경우 테이블의 data_retention_time_in_days 및 max_data_extension_time_in_days 속성은 스키마 또는 데이터베이스 설정에서 상속됩니다.

새로운 기능과 업데이트¶

• Cortex Search API 엔드포인트에 대한 지원이 추가되었습니다.

• 대규모 결과에 대한 지원이 추가되었습니다.

• 장기 실행 쿼리에 대한 지원이 추가되었습니다.

• Service 리소스에서 제공된 문자열에서 사양 유형을 추론하는 ServiceSpec 도우미 함수가 추가되었습니다.

• 모든 리소스에 Snowflake API REST 플랫폼을 사용하도록 업데이트되었습니다.

• pip install snowflake[ml] 은 snowflake-ml-python v1.4.0을 설치합니다.

버그 수정 사항¶

• 여러 버그가 수정되었습니다.

새로운 기능과 업데이트¶

snowflake 패키지 업데이트:

• 이제 pip install snowflake[ml] 을 실행하여 Snowpark ML 라이브러리를 추가 패키지 종속성으로 설치할 수 있습니다.

snowflake.core 패키지 업데이트:

• 이제 선행 작업이 완전히 정규화된 이름을 반환합니다.

• 노트북과 호환되도록 DAGRun 에 __str__() 및 __repr_html__() 메서드가 추가되었습니다.

• API 참조 설명서에서 “DAGs”를 “작업 그래프”로 대체하여 Snowflake 설명서와 더 잘 일치하도록 했습니다.

버그 수정 사항¶

snowflake.core 패키지 수정 사항:

• 코드 생성기를 수정하고 OpenAPI 사양 기반 모델을 업데이트했습니다.

• Pydantic 호환성 문제가 수정되었습니다.

• Task.error_integration 속성의 버그가 수정되었습니다.

• REST 속성이 누락된 경우 Task.config 속성의 버그를 수정했습니다.

새로운 기능과 업데이트¶

• 이제 DAGTask 의 >> 및 << 연산자가 함수를 직접 허용합니다.

• DAGTask 는 이제 기본적으로 DAG의 웨어하우스를 사용합니다.

• DAGTask 는 새 매개 변수 session_parameters 를 허용합니다.

• TaskContext 업데이트 완료:

  • 이제 get_predecessor_return_value 메서드가 DAGTask 의 긴 이름과 짧은 이름에 모두 유효합니다.

  • get_current_task_short_name 및 get_task_graph_config_property 메서드를 추가했습니다.

• pydantic 2.x에 대한 지원을 추가했습니다.

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

버그 수정 사항¶

• DAG에 일정이 없는 경우 DAGOperation.run() 이 예외를 발생시키는 버그를 수정했습니다.

• DAG를 삭제해도 모든 하위 작업이 삭제되지 않는 버그를 수정했습니다.

• DAG의 config 가 설정될 때 오류를 발생시킨 버그를 수정했습니다.