조인 정책 변경

조인 정책 변경 (ALTER JOIN POLICY)

Enterprise Edition(또는 그 이상)을 사용하는 모든 계정에서 사용할 수 있어요.

업그레이드에 대해 문의하려면 Snowflake Support에 연락해 주세요.

join policy에 대한 기존 규칙이나 설명을 대체해요. 또한 join policy의 이름을 바꿀 수도 있어요.

함께 보기:

출처: 문서

본문

구문

ALTER JOIN POLICY [ IF EXISTS ]  RENAME TO 

ALTER JOIN POLICY [ IF EXISTS ]  SET BODY -> 

ALTER JOIN POLICY  SET TAG  = '' [ ,  = '' ... ]

ALTER JOIN POLICY  UNSET TAG  [ ,  ... ]

ALTER JOIN POLICY [ IF EXISTS ]  SET COMMENT = ''

ALTER JOIN POLICY [ IF EXISTS ]  UNSET COMMENT

매개 변수

name

변경할 조인 정책의 식별자를 지정해요.

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

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

RENAME TO new_name

조인 정책의 새 식별자를 지정해요. 스키마 내에서 고유해야 해요. 다른 조인 정책에 이미 사용 중인 식별자는 새 식별자로 사용할 수 없어요.

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

객체를 선택적으로 이름을 바꾸면서 다른 데이터베이스 및/또는 스키마로 이동할 수 있어요. 이렇게 하려면 각각 db_name.schema_name.object_name 또는 schema_name.object_name 형식으로 새 데이터베이스 및/또는 스키마 이름을 포함하는 정규화된 new_name 값을 지정해요.

대상 데이터베이스 및/또는 스키마는 이미 존재해야 해요. 또한 새 위치에 같은 이름의 객체가 이미 있으면 안 돼요. 그렇지 않으면 명령문이 오류를 반환해요.
관리 액세스 스키마로 객체를 이동하는 것은 객체 소유자(즉, 객체에 대한 OWNERSHIP 권한이 있는 역할)가 대상 스키마도 소유하지 않는 한 금지돼요.

SET ...

조인 정책에 설정할 하나 이상의 속성을 지정해요:

BODY -> expression

조인 정책의 제한 사항을 결정하는 SQL 표현식이에요.

조인 정책의 본문을 정의하려면 TRUE 또는 FALSE를 반환하는 JOIN_CONSTRAINT 함수를 호출해요. 함수가 TRUE를 반환하면 쿼리는 결과를 반환하기 위해 조인을 사용해야 해요.

JOIN_CONSTRAINT 함수의 구문은 다음과 같아요:

JOIN_CONSTRAINT (
  { JOIN_REQUIRED =>  }
  )

여기서:

JOIN_REQUIRED => boolean_expression

조인 정책이 할당된 테이블 또는 뷰에서 데이터를 선택할 때 쿼리에 조인이 필요한지 여부를 지정해요.

정책의 본문은 사용자 정의 함수, 테이블 또는 뷰를 참조할 수 없어요.

허용되는 조인 열은 정책이 적용되는 테이블 또는 뷰에 대한 CREATE 또는 ALTER 문에서 지정되며, CREATE JOIN POLICY 문에서는 지정되지 않아요.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

tag 이름과 tag 문자열 값을 지정합니다.

tag 값은 항상 string이며, tag 값의 최대 문자 수는 256입니다.

문에서 tags를 지정하는 방법에 대한 정보는 을(를) 참조하세요.

COMMENT = 'string_literal'

join policy에 대한 comment를 추가하거나 기존 comment를 덮어씁니다.

기본값: 값 없음

UNSET ...

join policy에 대해 하나 이상의 속성 및/또는 매개변수를 기본값으로 재설정하여 unset하도록 지정합니다.

TAG tag_name [ , tag_name ... ]
COMMENT

속성/매개변수를 재설정할 때는 이름만 지정하세요. 속성에 값을 지정하면 오류가 반환됩니다.

액세스 제어 요구 사항

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

권한	객체	비고
OWNERSHIP	Join policy	%ac-ownership%

schema의 object에 대해 작업하려면 상위 database에 대한 최소 하나의 privilege와 상위 schema에 대한 최소 하나의 privilege가 필요합니다.

지정된 privileges 집합을 가진 custom role을 만드는 방법에 대한 지침은 을(를) 참조하세요.

securable objects에 대해 SQL 작업을 수행하기 위한 roles 및 privilege grants에 대한 일반 정보는 Overview of Access Control을(를) 참조하세요.

join policy DDL 및 privileges에 대한 자세한 내용은 을(를) 참조하세요.

사용 참고 사항

기존 조인 정책을 업데이트하려고 할 때 정책의 현재 본문을 확인해야 한다면, DESCRIBE JOIN POLICY 명령을 실행해 보세요. GET_DDL 함수를 사용해서 조인 정책의 본문을 포함한 전체 정의를 가져올 수도 있습니다.
조인 정책을 관리형 액세스 스키마로 이동하는 것(ALTER JOIN POLICY ... RENAME TO 구문 사용)은 조인 정책 소유자(즉, 조인 정책에 대한 OWNERSHIP 권한을 가진 역할)가 대상 스키마도 소유한 경우가 아니라면 금지됩니다.
메타데이터 관련:

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

예제

조인 정책의 SQL 식을 수정해 보세요:

ALTER JOIN POLICY jp3 SET BODY -> JOIN_CONSTRAINT(JOIN_REQUIRED => FALSE);

조인 정책 이름을 변경해 보세요:

ALTER JOIN POLICY my_join_policy RENAME TO my_join_policy_2;

조인 정책 변경