CREATE NOTIFICATION INTEGRATION(웹후크)¶

구문¶

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  TYPE = WEBHOOK
  ENABLED = { TRUE | FALSE }
  WEBHOOK_URL = '<url>'
  [ WEBHOOK_SECRET = <secret_name> ]
  [ WEBHOOK_BODY_TEMPLATE = '<template_for_http_request_body>' ]
  [ WEBHOOK_HEADERS = ( '<header_1>'='<value_1>' [ , '<header_N>'='<value_N>', ... ] ) ]
  [ COMMENT = '<string_literal>' ]

필수 매개 변수¶

name

통합에 대한 식별자(즉, 이름)를 지정하는 문자열로, 계정에서 고유해야 합니다.

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

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

ENABLED = { TRUE | FALSE }

통합 작업을 시작할지 일시 중단할지 여부를 지정합니다.

• TRUE 로 지정하면 통합이 활성화됩니다.

• FALSE 로 지정하면 유지 관리를 위해 통합이 비활성화됩니다. Snowflake와 서드 파티 서비스 간의 통합이 작동하지 않습니다.

TYPE = WEBHOOK

이것이 웹후크에 대한 알림 통합임을 지정합니다.

WEBHOOK_URL = 'url'

웹후크의 URL을 지정합니다. URL은 https:// 프로토콜을 사용해야 합니다.

다음 URL만 지정할 수 있습니다.

• Slack 웹후크의 URL. 이러한 URL은 https://hooks.slack.com/services/ 로 시작해야 합니다.

• Teams 웹후크의 URL. 이러한 URL은 다음과 같은 일반 형식을 사용해야 합니다.

  https://<hostname>.webhook.office.com/webhookb2/<path_components>/IncomingWebhook/<path_components>
  

  Copy

• PagerDuty 웹후크의 URL. 이 URL은 https://events.pagerduty.com/v2/enqueue 여야 합니다.

URL에 시크릿이 포함되어 있고 해당 시크릿에 대한 시크릿 오브젝트를 생성한 경우 URL에서 해당 시크릿을 SNOWFLAKE_WEBHOOK_SECRET으로 바꾸십시오. 예를 들어, Slack 웹후크 URL에서 시크릿에 대한 시크릿 오브젝트를 생성한 경우 WEBHOOK_URL을 다음으로 설정합니다.

WEBHOOK_URL='https://hooks.slack.com/services/SNOWFLAKE_WEBHOOK_SECRET'

Copy

선택적 매개 변수¶

WEBHOOK_SECRET = secret_name

이 통합에서 사용할 시크릿 을 지정합니다.

WEBHOOK_URL, WEBHOOK_BODY_TEMPLATE 또는 WEBHOOK_HEADERS에 SNOWFLAKE_WEBHOOK_SECRET 자리 표시자를 사용하는 경우 알림을 보낼 때 자리 표시자가 이 시크릿으로 바뀝니다.

알림을 보낼 때 시크릿 오브젝트가 포함된 데이터베이스와 스키마가 활성화되지 않을 경우 스키마 이름이나 데이터베이스 및 스키마 이름으로 시크릿 이름을 한정합니다. 예:

WEBHOOK_SECRET = my_secrets_db.my_secrets_schema.my_slack_webhook_secret

Copy

이 매개 변수를 지정하려면 시크릿과 시크릿을 포함하는 데이터베이스와 스키마에 대한 USAGE 권한이 있어야 합니다.

기본값: 값 없음

WEBHOOK_BODY_TEMPLATE = 'template_for_http_request_body'

알림을 위해 보낼 HTTP 요청 본문의 템플릿을 지정합니다.

웹후크에서 HTTP 요청 본문에 대해 특정 형식(예: 특정 JSON 형식)이 필요한 경우, 이를 형식을 지정하는 문자열로 설정합니다. 이 문자열에서 다음을 수행합니다.

• 메시지에 시크릿을 포함해야 하고 해당 시크릿에 대한 시크릿 오브젝트를 생성한 경우 메시지에 시크릿이 나타나야 할 위치에 SNOWFLAKE_WEBHOOK_SECRET 자리 표시자를 사용하십시오.

• 알림 메시지를 포함해야 하는 곳에 SNOWFLAKE_WEBHOOK_MESSAGE 자리 표시자를 사용하십시오.

예:

WEBHOOK_BODY_TEMPLATE='{
  "routing_key": "SNOWFLAKE_WEBHOOK_SECRET",
  "event_action": "trigger",
  "payload":
    {
      "summary": "SNOWFLAKE_WEBHOOK_MESSAGE",
      "source": "Snowflake monitoring",
      "severity": "INFO",
    }
  }'

Copy

WEBHOOK_BODY_TEMPLATE을 설정하는 경우 메시지 유형과 함께 Content-Type 헤더를 포함하도록 WEBHOOK_HEADERS도 설정해야 합니다. 예를 들어, WEBHOOK_BODY_TEMPLATE을 JSON 형식의 템플릿으로 설정하는 경우 헤더 Content-Type: application/json 을 포함하도록 WEBHOOK_HEADERS를 설정하십시오.

WEBHOOK_HEADERS=('Content-Type'='application/json')

Copy

기본값: 값 없음

WEBHOOK_HEADERS = ( 'header'='value' [ , 'header'='value', ... ] )

웹후크에 대한 HTTP 요청에 포함할 HTTP 헤더와 값의 목록을 지정합니다.

HTTP 헤더에 시크릿(예: Authorization 헤더)을 포함해야 하는 경우 해당 시크릿에 대한 시크릿 오브젝트를 생성한 경우 헤더 값에 SNOWFLAKE_WEBHOOK_SECRET 자리 표시자를 사용합니다. 예:

WEBHOOK_HEADERS=('Authorization'='Basic SNOWFLAKE_WEBHOOK_SECRET')

Copy

기본값: 값 없음

COMMENT = 'string_literal'

통합에 대한 설명을 지정하는 문자열(리터럴)입니다.

기본값: 값 없음

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

• 메타데이터 관련:

  주의

  고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

• OR REPLACE 및 IF NOT EXISTS 절은 상호 배타적입니다. 두 문자를 같은 문에 함께 사용할 수 없습니다.

• CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.

예¶

웹훅 알림 통합 만들기 섹션을 참조하십시오.