웹훅 알림 통합 수정

웹훅 알림 통합 수정 (ALTER NOTIFICATION INTEGRATION (webhooks))

이 기능은 중화인민공화국에서는 사용할 수 없어요.

기존 알림 통합의 속성을 webhook에 대해 수정해요.

참조:

CREATE NOTIFICATION INTEGRATION (webhooks) , DESCRIBE NOTIFICATION INTEGRATION , DROP INTEGRATION , SHOW NOTIFICATION INTEGRATIONS

출처: 문서

본문

구문

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ]  SET
  [ ENABLED = { TRUE | FALSE } ]
  [ WEBHOOK_URL = '' ]
  [ WEBHOOK_SECRET =  ]
  [ WEBHOOK_BODY_TEMPLATE = '' ]
  [ WEBHOOK_HEADERS = ( ''='' [ , ''='', ... ] ) ]
  [ COMMENT = '' ]

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ]  UNSET {
  ENABLED               |
  WEBHOOK_SECRET        |
  WEBHOOK_BODY_TEMPLATE |
  WEBHOOK_HEADERS       |
  COMMENT
}

매개변수

name

변경할 integration의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자는 대소문자를 구분합니다.

자세한 내용은 식별자 요구 사항을 참조하세요.

SET ...

integration에 대한 하나 이상의 속성을 설정합니다:

ENABLED = { TRUE | FALSE }

integration의 작동을 시작할지 또는 일시 중단할지 지정합니다.

  • TRUE는 integration을 활성화합니다.
  • FALSE는 유지 관리를 위해 integration을 비활성화합니다. Snowflake와 타사 서비스 간의 모든 integration이 작동하지 않습니다.

이 값은 대소문자를 구분하지 않습니다.

기본값은 TRUE입니다.

WEBHOOK_URL = 'url'

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

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

  • Slack 웹훅용 URL입니다. 이 URL은 https://hooks.slack.com/services/로 시작해야 합니다.

  • Microsoft Teams 웹훅용 URL입니다. 이 URL은 다음과 같은 일반 형식을 사용해야 합니다:

    • 2025년 11월 30일까지 Microsoft Teams는 다음 형식의 URL을 지원합니다:

      https://..logic.azure.com:443/workflows/

    • 2025년 11월 30일부터, Microsoft Teams는 다음 형식의 URL을 지원합니다:

      https://default.environment.api.powerplatform.com/powerautomate/automations/direct/workflows//triggers/manual/paths/invoke

    WEBHOOK_URL 매개변수의 URL에서 포트 번호(:443)는 생략해야 합니다. Microsoft API 데이터 형식에 대한 자세한 내용은 https://adaptivecards.io/를 참조하세요.

  • PagerDuty 웹훅용 URL입니다. 이 URL은 https://events.pagerduty.com/v2/enqueue여야 합니다.

  • Jira 자동화 웹훅용 URL입니다. 이 URL은 https://api-private.atlassian.com/automation/webhooks/jira/로 시작해야 합니다.

  • ServiceNow 웹훅용 URL입니다. 이 URL은 ServiceNow 인스턴스의 호스트를 사용하며 다음과 같은 일반 형식을 가집니다:

    https://.service-now.com/

URL에 시크릿이 포함되어 있고 해당 시크릿에 대한 created a secret object for that secret을(를) 생성한 경우, URL에서 해당 시크릿을 SNOWFLAKE_WEBHOOK_SECRET으로 바꾸세요. 예를 들어, Slack webhook URL의 시크릿에 대한 created a secret object for the secret in a Slack webhook URL을(를) 생성한 경우, WEBHOOK_URL을 다음과 같이 설정하세요:

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

Jira 및 ServiceNow webhook의 경우 시크릿은 URL의 일부가 아닙니다. 대신 HTTP 헤더에 시크릿을 전달합니다 (WEBHOOK_HEADERS 파라미터 사용). 자세한 내용은 Sending webhook notifications을 참조하세요.

WEBHOOK_SECRET = secret_name

이 통합에 사용할 secret to use with this integration을 지정합니다.

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

알림을 보낼 때 secret 객체가 포함된 데이터베이스와 스키마가 활성화되지 않을 경우, qualify the secret name with the schema name or the database and schema names을(를) 수행하세요. 예를 들어:

WEBHOOK_SECRET = my_secrets_db.my_secrets_schema.my_slack_webhook_secret

이 파라미터를 지정하려면 secret(및 이를 포함하는 데이터베이스와 스키마)에 대한 USAGE 권한이 있어야 합니다.

기본값: 값 없음

WEBHOOK_BODY_TEMPLATE = 'template_for_http_request_body'

알림을 보내기 위해 전송할 HTTP 요청 본문의 템플릿을 지정합니다.

webhook이 HTTP 요청 본문에 특정 형식을 요구하는 경우(예: 특정 JSON 형식), 이 파라미터를 해당 형식을 지정하는 문자열로 설정하세요. 이 문자열에서:

  • 메시지에 시크릿을 포함해야 하고 created a secret object for that secret을(를) 생성한 경우, 메시지에서 시크릿이 표시되어야 하는 위치에 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",
    }
  }'

WEBHOOK_BODY_TEMPLATE를 설정하는 경우, 메시지 유형을 포함하는 Content-Type 헤더가 포함되도록 WEBHOOK_HEADERS도 설정해야 해요. 예를 들어, WEBHOOK_BODY_TEMPLATE를 JSON 형식의 템플릿으로 설정한다면, WEBHOOK_HEADERS에 Content-Type: application/json 헤더를 포함하도록 설정하세요:

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

기본값: 값 없음

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

웹훅에 대한 HTTP 요청에 포함할 HTTP 헤더와 값의 목록을 지정해요.

HTTP 헤더에 비밀 값(예: Authorization 헤더)을 포함해야 하고, 해당 비밀 값에 대한 created a secret object for that secret를 생성한 경우, 헤더 값에 SNOWFLAKE_WEBHOOK_SECRET 자리 표시자를 사용하세요. 예를 들어:

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

기본값: 값 없음

COMMENT = 'string_literal'

통합(integration)에 대한 주석을 지정하는 문자열(리터럴)이에요.

기본값: 값 없음

UNSET ...

통합에 대한 하나 이상의 속성을 설정 해제하며, 속성을 기본값으로 재설정해요:

  • ENABLED
  • WEBHOOK_SECRET
  • WEBHOOK_BODY_TEMPLATE
  • WEBHOOK_HEADERS
  • COMMENT

단일 ALTER 문으로 여러 속성이나 매개변수를 설정 해제하려면 각 속성이나 매개변수를 쉼표로 구분하세요.

속성이나 매개변수를 설정 해제할 때는 속성 또는 매개변수 이름만 지정하세요(위 구문에서 값을 지정해야 한다고 표시되지 않는 한). 값을 지정하면 오류가 반환돼요.

접근 제어 요구 사항

이 작업을 실행하는 데 사용되는 role은 최소한 다음 privileges을 보유해야 해요:

권한 객체 참고 사항
OWNERSHIP Integration %ac-ownership%
USAGE Secret WEBHOOK_SECRET 속성을 secret 객체로 설정하는 경우, 해당 secret과 그 secret을 포함하는 데이터베이스 및 스키마에 대해 USAGE 권한이 있어야 해요.

지정된 권한 집합을 가진 사용자 지정 역할을 만드는 방법에 대한 지침은 을(를) 참조하세요.

보안 개체에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반적인 정보는 Overview of Access Control을(를) 참조하세요.

사용 참고 사항

  • 메타데이터 관련:

고객은 Snowflake 서비스를 사용할 때 메타데이터로 개인 데이터(User object에 대한 데이터 제외), 민감한 데이터, 수출 통제 데이터 또는 기타 규제 대상 데이터를 입력하지 않도록 해야 해요. 자세한 내용은 Metadata fields in Snowflake을(를) 참조하세요.

더 알아보기 (Learn more)