CREATE CONTACT

CREATE CONTACT

새 연락처(contact)를 만들거나 기존 연락처를 교체하는 명령이에요. 연락처는 스키마 안의 객체로, Snowflake 사용자·이메일 배포 목록·URL을 통해 관련 담당자에게 연락할 수 있는 방법을 지정해요.

출처: 문서

본문

새 연락처를 만들거나 기존 연락처를 교체해요.

함께 보기: ALTER CONTACT, DROP CONTACT, SHOW CONTACTS

구문 (Syntax)

CREATE [ OR REPLACE ] CONTACT [ IF NOT EXISTS ] <name>
  [ {
    USERS = ( '<user_name>' [ , '<user_name>' ... ] )
    | EMAIL_DISTRIBUTION_LIST = '<email>'
    | URL = '<url>'
    } ]
  [ COMMENT = '<string_literal>' ]

필수 매개변수 (Required parameters)

name 새 연락처의 이름을 지정해요.

또한 식별자는 반드시 알파벳 문자로 시작해야 하며, 전체 식별자 문자열이 큰따옴표로 묶이지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예: "My object"). 큰따옴표로 묶인 식별자는 대소문자를 구분해요.

자세한 내용은 식별자 요구 사항(Identifier requirements)을 참고해요.

선택 매개변수 (Optional parameters)

USERS = ( 'user_name' [ , 'user_name' ... ] ) 연락할 수 있는 Snowflake 사용자들의 쉼표로 구분된 목록으로, 사용자 객체의 이름으로 지정해요.

사용자 이름이 대소문자를 구분하거나 특수 문자·공백을 포함한다면 큰따옴표가 필요해요. 큰따옴표는 작은따옴표 안에 감싸야 해요. 예를 들어 사용자가 [email protected]이라면 '"[email protected]"'처럼 지정해야 해요.

EMAIL_DISTRIBUTION_LIST = 'email' 유효한 이메일 주소로, 배포 목록(distribution list)일 수도 있어요.

URL = 'url' 객체에 대해 담당자에게 연락할 때 사용할 수 있는 URL이에요.

COMMENT 사용자 정의 문자열로, 연락처에 대한 설명을 지정해요.

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

이 작업을 실행하는 데 사용하는 역할(role)은 최소한 다음 권한을 가져야 해요.

권한 (Privilege) 객체 (Object) 비고
CREATE CONTACT Schema

스키마 안의 객체를 작업하려면 상위 데이터베이스에 대한 권한이 최소 하나, 상위 스키마에 대한 권한이 최소 하나 필요해요.

지정된 권한 집합으로 사용자 지정 역할을 만드는 방법은 사용자 지정 역할 만들기(Creating custom roles)를 참고해요. 보호 가능한 객체(securable objects)에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여의 일반적인 내용은 접근 제어 개요(Overview of Access Control)를 참고해요.

사용 메모 (Usage notes)

메타데이터에 관해서는 다음 사항에 주의해요.

⚠️ 주의: 고객은 Snowflake 서비스를 사용할 때 (User 객체를 제외하고) 개인 데이터·민감 데이터·수출 통제 데이터·기타 규제 데이터를 메타데이터로 입력하지 않도록 해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참고해요.

CREATE OR REPLACE <object> 문은 원자적(atomic)으로 동작해요. 즉, 객체를 교체할 때 기존 객체는 삭제되고 새 객체는 단일 트랜잭션 안에서 생성돼요.

예시 (Examples)

CREATE CONTACT my_contact
  EMAIL_DISTRIBUTION_LIST = '[email protected]';

더 알아보기 (Learn more)