GET_CONTACTS

GET_CONTACTS

GET_CONTACTS는 객체에 연결된 컨택트(contact)를 반환하는 표(table) 함수예요. 객체에 대해 누구에게 연락해야 하는지 확인하고 싶을 때 유용해요.

출처: Snowflake SQL Reference

본문

카테고리: Table 함수

구문 (Syntax)

SNOWFLAKE.CORE.GET_CONTACTS (
  '<object_name>',
  '<object_type>'
  [ , '<contact_name>' ]
)

필수 인자 (Required arguments)

'<object_name>' — 컨택트를 연결할 수 있는 객체의 이름이에요.

'<object_type>' — 지정한 객체의 타입이에요. 가능한 값은 DATABASE, SCHEMA, TABLE(데이터베이스와 스키마에 포함된 모든 테이블 유사 객체)이에요. 지원되는 객체 타입 목록은 지원되는 객체를 참고해요.

선택 인자 (Optional arguments)

'<contact_name>' — 컨택트의 이름이에요. 컨택트를 지정하면 함수는 지정한 객체에 연결된 다른 컨택트에 대한 정보를 반환하지 않아요.

출력 (Output)

각 행이 다음 열을 가진 테이블을 반환해요:

열 데이터 타입 설명
purpose VARCHAR 컨택트와 지정한 객체 사이의 관계를 설명해요. purpose는 객체에 연결된 컨택트를 구분하는 데 도움을 줘서, 도움을 받기 위해 올바른 사람에게 연락할 수 있게 해줘요. 예를 들어 ACCESS_APPROVAL purpose는 그 컨택트가 객체에 대한 접근 권한을 얻는 데 도움을 줄 수 있다는 뜻이에요.
email_distribution_list VARCHAR 객체에 대해 누군가에게 연락하는 데 사용할 수 있는 이메일 주소.
url VARCHAR 객체에 대해 누군가에게 연락하는 데 사용할 수 있는 URL.
user VARCHAR 객체에 대해 연락할 수 있는 사용자.
level VARCHAR 컨택트가 연결된 객체 타입. level을 사용해 객체 계층에서 어디에 컨택트가 연결되었는지 알 수 있어요. 가능한 값은 DATABASE, SCHEMA, TABLE(데이터베이스와 스키마에 포함된 모든 테이블 유사 객체).

참고: 컨택트 객체의 이름은 이 함수의 출력에서 의도적으로 생략돼요.

접근 제어 요구 사항 (Access control requirements)

이 함수를 호출하려면 CORE_VIEWER 데이터베이스 역할이 있어야 해요.

사용 시 유의사항 (Usage notes)

컨택트 객체가 사용자 목록을 포함하면, 이 함수는 목록의 각 사용자에 대해 별도의 행을 반환해요.

예시 (Examples)

t1 테이블에 연결된 각 컨택트에 대해 행을 반환해요.

SELECT * FROM TABLE(SNOWFLAKE.CORE.GET_CONTACTS('t1', 'TABLE'));

더 알아보기