Snowflake 관리 Apache Iceberg™ v2 테이블에 대한 위치 삭제 파일과 Merge-on-read(보류 중)¶
- 변경 전:
Iceberg v2의 Snowflake 관리 Apache Iceberg™ 테이블의 경우, Snowflake는 DELETE, UPDATE 또는 MERGE 문을 실행할 때 merge-on-read를 위해 `위치 삭제 파일 <https://iceberg.apache.org/spec/#position-delete-files>`_을 작성하지 않습니다. Snowflake는 이러한 작업에 copy-on-write를 대신 사용합니다.
- 변경 후:
계정에서 2026_03 동작 변경 번들이 활성화된 경우, Iceberg v2의 Snowflake 관리 Apache Iceberg™ 테이블은 :code:`ENABLE_ICEBERG_MERGE_ON_READ`가 :code:`TRUE`일 때(시스템 기본값임) DELETE, UPDATE, MERGE 문에 대해 위치 삭제 파일과 함께 merge-on-read를 사용합니다. Snowflake는 테이블의 Iceberg 저장소 위치에 데이터 파일과 함께 위치 삭제 파일을 작성합니다. 이 동작은 merge-on-read가 활성화된 경우 Snowflake가 외부 관리 Iceberg v2 테이블에 대해 위치 삭제 파일을 이미 사용하는 방식과 일치합니다.
merge-on-read를 해제하고 이러한 DML 작업에 대해 copy-on-write를 대신 사용하려면 테이블, 스키마 또는 데이터베이스 수준에서
ENABLE_ICEBERG_MERGE_ON_READ매개 변수를FALSE`로 설정합니다. 자세한 내용은 :ref:`label-enable_iceberg_merge_on_read섹션을 참조하십시오.외부 쿼리 엔진과의 호환성
위치 삭제 파일을 사용하려면 외부 엔진에서 Iceberg 형식 버전의 지원이 필요합니다. v2 이전의 Iceberg 버전을 사용하는 외부 쿼리 엔진을 사용하는 경우, 해당 엔진은 위치 삭제 파일을 지원하지 않을 수 있으며 Snowflake가 위치 삭제 파일을 작성한 후 Snowflake 관리 Iceberg v2 테이블의 테이블 메타데이터를 읽지 못할 수 있습니다.
변경 사항이 프로덕션 계정에 적용되기 전에 다음을 수행합니다.
Snowflake 관리 Apache Iceberg™ v2 테이블을 읽는 데 사용하는 모든 외부 쿼리 엔진이 `위치 삭제 파일 <https://iceberg.apache.org/spec/#position-delete-files>`_(Iceberg v2 이상)을 지원하는지 확인합니다.
위치 삭제 파일을 지원하지 않는 엔진의 경우, 해당 엔진을 Iceberg v2 이상 기반 릴리스로 업그레이드하거나 관련 테이블(또는 스키마나 데이터베이스 포함)에 대해 :code:`ENABLE_ICEBERG_MERGE_ON_READ`를 :code:`FALSE`로 지정하여 Snowflake가 계속해서 copy-on-write를 사용하고 위치 삭제 파일을 작성하지 않도록 합니다.
Snowflake의 위치 삭제 파일, merge-on-read 및 관련 매개 변수에 대한 자세한 내용은 행 수준 삭제 사용 섹션을 참조하세요.
Ref: 2279