Migrate from the legacy Snowflake data share target

Migrate from the legacy Snowflake data share target (레거시 Snowflake 데이터 공유 대상에서 마이그레이션)

Snowflake V2 데이터 공유 대상이 도입되면서 레거시 Snowflake 데이터 공유 대상에 연결된 데이터 공유는 Snowflake V2로 마이그레이션해야 해요. Snowflake와 Salesforce는 기존 데이터 공유를 자동으로 마이그레이션하지 않으므로 이 주제의 단계를 직접 완료해야 해요.

출처: Snowflake Documentation

본문

이 마이그레이션은 모든 Salesforce Data 360 에디션에서 사용할 수 있어요.

Salesforce에서 필요한 권한: Data Cloud Architect 권한 집합.

데이터 공유를 Snowflake V2 데이터 공유 대상에 연결

  1. Salesforce에서 Data 360 » Data Shares로 이동해요.
  2. 레거시 Snowflake 데이터 공유 대상에 연결된 데이터 공유를 선택해요.
  3. 데이터 공유를 Snowflake V2 데이터 공유 대상에 연결해요. 연결 단계는 Data Share를 Data Share Target에 연결을 참고해요.

아직 레거시 대상에서 데이터 공유를 연결 해제하지 마세요.

Snowflake V2 연결 확인

레거시 대상을 건드리기 전에 새 Zerocopy Connector를 통해 데이터가 Snowflake로 흐르는지 확인해요.

  • SYSTEM$ZEROCOPY_CONNECTOR_LIST_SHARES를 사용해 데이터 공유가 나타나고 상태가 예상대로 MOUNTED 또는 UNMOUNTED인지 확인해요. 공유 데이터 제품 나열 참고.
  • 카탈로그 연결 데이터베이스를 쿼리해 공유 데이터가 올바르게 보이는지 확인해요.

Important

Snowflake V2 연결이 작동하는지 확인하기 전에는 레거시 대상에서 데이터 공유를 연결 해제하지 마세요. Snowflake의 다운스트림 프로세스가 여전히 레거시 대상에서 만든 데이터베이스를 참조할 수 있어요.

Snowflake V2 데이터베이스로 전환

기존 파이프라인과 대시보드는 레거시 대상에서 만든 데이터베이스를 이름으로 참조해요. 모든 다운스트림 참조를 업데이트하는 대신 V2 카탈로그 연결 데이터베이스를 그 이름으로 전환해요. 전환은 원자적이며 1분 안에 완료돼요.

다음 옵션 중 하나를 선택해요.

옵션 1: Cortex Code 스킬 사용

Cortex Code가 있다면 Snowflake-Labs/coco-skills에서 swap-databases 스킬을 아래 명령이나 Snowflake UI를 통해 설치해요.

/swap-databases swap db_from_legacy db_from_v2

프롬프트가 표시되면 마이그레이션을 완료하려면 MODE C를 선택해요.

이 스킬은:

  • 레거시와 V2 데이터베이스 구조를 비교하고 필요한 V2 객체가 존재하는지 검증해요.
  • 원자적 데이터베이스 이름 전환을 수행해 다운스트림 참조가 계속 원래 프로덕션 데이터베이스 이름으로 해석되게 해요.

스킬이 확인을 요청할 때 두 데이터베이스의 스키마 이름이 일치하는지 확인해요. 이름이 일치하지 않으면 V2 카탈로그 연결 데이터베이스를 드롭하고 LEGACY_SALESFORCE_SCHEMA_ALIAS = TRUE로 다시 마운트해요.

Note

여러 데이터 공유를 단일 카탈로그 연결 데이터베이스로 병합한다면 스키마 이름이 일치하지 않아도 진행하도록 스킬에 알려요.

옵션 2: SQL 함수 사용

Cortex Code가 없다면 전환 전후에 데이터베이스와 스키마를 직접 검증한 다음 실행해요:

SELECT SYSTEM$ZEROCOPY_SWAP_IMPORTED_DB_WITH_CLD('<imported_db_name>', '<cld_db_name>');
  • <imported_db_name>: 레거시 대상에서 만든 데이터베이스.
  • <cld_db_name>: Zerocopy Connector(V2)에서 만든 카탈로그 연결 데이터베이스.

전환 후 문제가 발생하면 같은 함수로 데이터베이스를 다시 전환해 롤백할 수 있어요.

레거시 대상에서 데이터 공유 연결 해제

전환이 검증되면:

  1. 데이터 공유의 레코드 홈 페이지에서 Link/Unlink Data Share Target을 클릭해요.
  2. 레거시 데이터 공유 대상의 선택을 해제해요.
  3. Save를 클릭해요.

더 알아보기 (Learn more)