Clean Room 버전 관리¶

Clean Room 버전 번호 지정¶

Snowflake Clean Rooms는 버전이 관리됩니다. Python 코드가 없는 Clean Room의 초기 버전은 V1.0.0입니다.

Snowflake automatically creates a new version of a clean room after certain provider events, such as uploading Python code or enabling external or Apache Iceberg™ tables. Snowflake creates a new version only if the security scan triggered by this action passes. Relatively few provider actions can generate a new clean room version, and procedures that create a new version mention the new version in the procedure response.

Actions that fail the security scan don’t generate a new version.

Only provider actions can result in a new clean room version; consumer actions cannot.

Snowflake는 새 버전이 나올 때마다 패치 번호(마지막 자릿수)만 증가합니다. 따라서 연속된 세 버전의 버전 번호는 V1.0.0, V1.0.1, V1.0.2가 됩니다.

Clean Rooms는 네이티브 애플리케이션 패키지 로 구현되기 때문에 버전이 지정되어 있습니다. Snowflake의 네이티브 애플리케이션 프레임워크에서 버전 V1.0.2의 경우 “V1.0”(문자열)은 버전 번호이고 2(정수)는 패치 번호라는 규칙이 있습니다. Clean Room 설명서는 일반적으로 “버전”이라는 용어를 사용하여 단순히 “V1.0” 접두사(Native App Framework에서 가끔 사용되는 것처럼)가 아닌 전체 숫자(V1.0.1)를 표시합니다.

클린룸의 ID를 사용하여 :samp:`SHOW VERSIONS IN APPLICATION PACKAGE samooha_cleanroom_{CLEANROOM_ID};`을 호출하면 해당 클린룸의 버전 기록을 보고, 상태를 검토할 수 있습니다.

기본 릴리스 지시문¶

Each clean room is assigned a default release directive by the clean room provider. The default release directive specifies which version of the clean room should be installed or loaded in the user’s account. Consumers cannot specify which version of a clean room to install. Updates are handled automatically by Snowflake as available resources dictate, and there can be a delay before the new version is installed on the user’s account.

Clean Room 공급자는 Clean Room을 처음 공유할 때(내부 또는 외부) 또는 공급자가 코드를 업로드하고 보안 검사를 통과할 때마다 Clean Room의 기본 릴리스 지시문을 지정해야 합니다. Clean Room의 새 버전이 생성되었지만 기본 릴리스 지시문이 업데이트되지 않은 경우 컨슈머에게는 마지막 기본 버전이 계속 제공됩니다.

You must always set the default release directive before publishing a clean room. If you haven’t added Python code, it should be V1.0.0, as shown here:

CALL samooha_by_snowflake_local_db.provider.set_default_release_directive(
  $cleanroom_name, 'V1_0', '0');

Clean Room 공급자는 원하는 경우 기본 릴리스 지시문을 이전 릴리스로 롤백할 수 있습니다.

provider.set_default_release_directive 를 호출하여 Clean Room에 대한 기본 릴리스 지시문을 지정합니다.

공급자는 코드에서 클린룸을 생성하거나 수정할 때만 기본 릴리스 지시문을 설정해야 합니다. 클린룸 UI를 사용할 때 버전 관리가 자동으로 처리됩니다.

Snowflake generates a new version only if the security scan triggered by a provider action passes. Therefore you should check the security scan status for a clean room by calling provider.view_cleanrooom_scan_status before updating the default release directive. Not updating the default release directive will not cause an error, but the newer version with your changes will not be published to users if you don’t update the default release directive.

Versioning cheat sheet¶

이 Snowflake 계정에서 만든 모든 Clean Room 패키지(Clean Rooms)를 나열합니다.

SHOW APPLICATION PACKAGES STARTS WITH 'SAMOOHA_CLEANROOM_';

Clean Room MY_FIRST_CLEANROOM 의 모든 버전을 나열합니다.

SHOW VERSIONS IN APPLICATION PACKAGE SAMOOHA_CLEANROOM_MY_FIRST_CLEANROOM;

See your current default release directive:

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE SAMOOHA_CLEANROOM_<your_clean_room_name>;

방금 외부에서 만든 Clean Room이거나 이미 외부에서 만든 Clean Room인데 버전이 변경된 경우 버전을 설정하기 전에 스캔 검토 상태를 확인하십시오.

CALL samooha_by_snowflake_local_db.provider.view_cleanroom_scan_status('MY_FIRST_CLEANROOM');

-- When REVIEW_STATUS = APPROVED, you can update the default version to the
-- latest version, if you haven't done so already.
SHOW VERSIONS IN APPLICATION PACKAGE SAMOOHA_CLEANROOM_MY_FIRST_CLEANROOM;
CALL samooha_by_snowflake_local_db.provider.set_default_release_directive(
  $cleanroom_name, 'V1_0', '<<LATEST_PATCH_NUMBER>>');