데이터 등록하기¶

이 항목에서는 Snowflake Data Clean Room 에 연결할 수 있도록 데이터를 등록하는 방법에 대해 설명합니다.

지원되는 오브젝트¶

클린룸에 연결할 수 있는 오브젝트 유형은 웹 앱에서 생성했는지, 개발자 APIs를 사용했는지에 따라 다릅니다. 이러한 유형의 특정 오브젝트는 연결되기 전에 등록되어야 합니다.

웹 앱:

Snowflake Data Clean Rooms 의 웹 앱이 지원하는 오브젝트는 다음과 같습니다.

테이블
외부 테이블
Apache Iceberg™ 테이블
뷰
구체화된 뷰
보안 뷰. 보안 뷰의 소유자는 SAMOOHA_APP_ROLE 역할이어야 합니다.

개발자 API:

Snowflake Data Clean Rooms는 Snowflake Native App Framework을 활용하므로, Snowflake Native App Framework에서 지원되는 모든 오브젝트를 연결할 수 있습니다.

참고

외부 테이블과 Iceberg 테이블은 클린룸에서 명시적으로 연결할 수 있도록 허용해야 합니다. 자세한 내용은 Snowflake Data Clean Rooms: 외부 및 Iceberg 테이블 섹션을 참조하십시오.

데이터 오브젝트 등록하기¶

사용자가 데이터를 Snowflake Data Clean Room 에 연결하려면 먼저 데이터베이스, 스키마 또는 오브젝트 수준에서 데이터를 등록해야 합니다. 데이터베이스나 스키마를 등록하면 해당 데이터베이스나 스키마에 있는 모든 오브젝트가 등록됩니다.

Snowsight 또는 개발자 APIs 를 사용하여 데이터베이스, 스키마 및 오브젝트를 등록할 수 있습니다. Snowsight 를 사용하는 것이 더 간단하지만 ACCOUNTADMIN 역할이 있어야 합니다. 개발자 APIs를 사용하면 계정 관리자가 아니더라도 오브젝트의 소유자가 등록할 수 있습니다.

데이터베이스, 스키마 또는 오브젝트를 등록하면 개발자가 개발자 APIs를 실행할 때 사용하는 역할인 SAMOOHA_APP_ROLE 역할에 대한 액세스 권한이 부여됩니다.

참고

데이터베이스 또는 스키마를 등록해도 등록 이후에 추가된 오브젝트는 자동으로 등록되지 않습니다. 새 오브젝트를 개별적으로 등록하거나 웹 앱의 Snowflake Admin 옵션을 사용하여 Database Registration 섹션으로 돌아가서 Resync 를 선택해야 합니다.

Snowsight 에서 데이터 등록하기¶

Snowsight 에 데이터베이스, 스키마 또는 오브젝트를 등록하려면 다음을 수행합니다.

웹 앱에 로그인합니다.
Admin » Snowflake Admin 를 선택합니다.
Login to Snowflake 를 선택하고 ACCOUNTADMIN 역할이 있는 사용자로 인증합니다.
Database Registration 섹션에서 Edit 를 선택한 다음 데이터베이스, 스키마 또는 오브젝트를 선택합니다.
Save 를 선택합니다.

개발자 APIs를 사용하여 데이터 등록하기¶

개발자 APIs를 사용하면 계정 관리자가 데이터베이스, 스키마 및 오브젝트를 프로그래밍 방식으로 등록할 수 있습니다. 데이터베이스, 스키마 또는 오브젝트의 소유자가 이를 등록할 수 있습니다.

다음 APIs를 사용할 수 있습니다.

작업	API	입력
데이터베이스 등록하기	`provider.register_db` (공급자의 경우) `consumer.register_db` (컨슈머의 경우)	데이터베이스 이름(문자열)
스키마 등록	`library.register_schema`	스키마 이름(문자열 배열)
관리되는 액세스 스키마 등록하기	`library.register_managed_access_schema`	관리되는 액세스 스키마 이름(문자열 배열)
모든 유형의 오브젝트 등록하기	`library.register_table_or_view`	오브젝트 이름(문자열 배열) is_view(부울) is_iceberg(부울) is_external(부울) is_under_managed_access_schema (boolean)
테이블 등록하기	`library.register_table`	테이블 이름(문자열 배열)
뷰 등록하기	`library.register_view`	뷰 이름(문자열 배열)
관리되는 액세스 스키마에 테이블 등록하기	`library.register_managed_access_table`	테이블 이름(문자열 배열)
관리되는 액세스 스키마에 뷰 등록하기	`library.register_managed_access_view`	뷰 이름(문자열 배열)

예를 들어, MY_SCHEMA 스키마의 소유자는 워크시트에서 다음 명령을 실행하여 스키마를 등록할 수 있습니다.

CALL samooha_by_snowflake_local_db.library.register_schema(['MY_DB.MY_SCHEMA']);

Copy

개발자 APIs를 사용하여 데이터 등록 취소하기¶

다음 APIs를 사용하여 데이터베이스, 스키마 및 오브젝트의 등록을 되돌릴 수 있습니다.

작업	API	입력
데이터베이스 등록 취소하기	`library.unregister_db`	데이터베이스 이름(문자열)
스키마 등록 취소하기	`library.unregister_schema`	스키마 이름(문자열 배열)
관리되는 액세스 스키마 등록 취소하기	`library.unregister_managed_access_schema`	관리되는 액세스 스키마 이름(문자열 배열)
모든 유형의 오브젝트 등록 취소하기	`library.unregister_table_or_view`	오브젝트 이름(문자열 배열) is_view(부울) is_iceberg(부울) is_external(부울) is_under_managed_access_schema (boolean)
테이블 등록 취소하기	`library.unregister_table`	테이블 이름(문자열 배열)
뷰 등록 취소하기	`library.unregister_view`	뷰 이름(문자열 배열)
관리되는 액세스 스키마에서 테이블 등록 취소하기	`library.unregister_managed_access_table`	테이블 이름(문자열 배열)
관리되는 액세스 스키마에서 뷰 등록 취소하기	`library.unregister_managed_access_view`	뷰 이름(문자열 배열)