GET_CONTACTS
GET_CONTACTS
GET_CONTACTS는 객체에 연결된 컨택트(contact)를 반환하는 표(table) 함수예요. 객체에 대해 누구에게 연락해야 하는지 확인하고 싶을 때 유용해요.
본문
카테고리: 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'));