ALTER GATEWAY¶

구문¶

ALTER GATEWAY [ IF EXISTS ] <name>
  FROM SPECIFICATION <specification_text>

매개 변수¶

name

변경할 게이트웨이의 식별자를 지정합니다.

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

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

FROM SPECIFICATION

업데이트된 게이트웨이 사양을 인라인으로 지정합니다. 사양은 트래픽 분할 구성을 정의합니다.

사양에서는 다음 형식을 사용합니다.

CopyExpand

spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>

Show lessSee more

Scroll to top

사양 매개 변수¶

type

고정 값. ``traffic_split``으로 설정해야 합니다.

split_type

고정 값. ``custom``으로 설정해야 합니다.

targets

트래픽을 라우팅할 대상 엔드포인트의 목록입니다. 각 대상은 다음을 지정해야 합니다.

type

고정 값. ``endpoint``으로 설정해야 합니다.

value

db.schema.service!endpoint 형식의 정규화된 엔드포인트 이름입니다. 각 대상 엔드포인트가 있어야 합니다.

weight

이 엔드포인트의 트래픽 가중치로, 정수로 지정됩니다. 모든 가중치의 합은 최대 100이어야 합니다.

액세스 제어 요구 사항¶

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

필요한 권한을 부여하려면 다음 명령을 사용합니다.

-- Grant MODIFY or OWNERSHIP privilege on the gateway
GRANT MODIFY ON GATEWAY <gateway_name> TO ROLE <role_name>;
-- OR
GRANT OWNERSHIP ON GATEWAY <gateway_name> TO ROLE <role_name>;

-- Grant BIND SERVICE ENDPOINT privilege on the account
GRANT BIND SERVICE ENDPOINT ON ACCOUNT TO ROLE <role_name>;

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

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

사용법 노트¶

• 메타데이터 관련:

  주의

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

예¶

게이트웨이를 변경하여 트래픽 분할 구성을 업데이트합니다.

ALTER GATEWAY split_gateway
  FROM SPECIFICATION $$
spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: db.schema.s2!ep1
    weight: 60
  - type: endpoint
    value: db.schema.s1!ep1
    weight: 40
$$;