이벤트 라우팅 테이블 변경
이벤트 라우팅 테이블 변경 (ALTER EVENT ROUTING TABLE)
이벤트를 중앙 위치로 라우팅하는 데 사용되는 이벤트 라우팅 테이블을 변경해요. 이벤트 라우팅 테이블에는 다음과 같은 변경을 할 수 있어요:
SET RULES를 사용하여 새 규칙 집합을 지정하기SET RULE을 사용하여 새 규칙을 만들거나 단일 규칙을 교체하기UNSET RULE을 사용하여 규칙 삭제하기MODIFY RULE ... RENAME을 사용하여 규칙 이름 바꾸기- 이벤트 라우팅 테이블 이름 바꾸기
이벤트 라우팅 테이블에 대한 자세한 내용은 Configure centralized event sharing for an app을(를) 참조하세요.
출처: 문서
본문
구문
ALTER EVENT ROUTING TABLE [ FORCE ]
SET RULES
= (REGION_GROUP=, REGIONS=('', '', ...), DESTINATION_ACCOUNT = .),
...
ALTER EVENT ROUTING TABLE [ FORCE ]
SET RULE
REGION_GROUP= REGIONS=('', '', ...) DESTINATION_ACCOUNT = .
ALTER EVENT ROUTING TABLE [ FORCE ]
UNSET RULE
ALTER EVENT ROUTING TABLE
MODIFY RULE RENAME TO
ALTER EVENT ROUTING TABLE
RENAME TO
매개변수
table_name
변경할 이벤트 라우팅 테이블의 식별자(이름)를 지정해요. 식별자에 공백이나 특수 문자가 포함되어 있으면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶인 식별자는 대/소문자를 구분해요.
FORCE
이벤트 라우팅 테이블이 현재 조직에 대해 활성화되어 있더라도 작업을 수행하도록 지정해요. FORCE를 생략하고 테이블이 현재 활성화되어 있으면 명령이 실패해요. 이름 변경 명령에는 FORCE가 필요하지 않아요.
SET RULES
기존의 모든 규칙을 새 규칙 집합으로 교체해요. 각 규칙에는 다음과 같은 매개변수가 있어요:
rule_name (필수)
규칙의 이름을 지정해요. 규칙 이름은 이벤트 라우팅 테이블 내에서 고유해야 해요. REGIONS가 ALL로 설정된 경우 이름은 default여야 해요. 기본 규칙은 큰따옴표로 묶을 수 없어요. 다른 규칙 이름은 대/소문자를 유지하기 위해 큰따옴표로 묶을 수 있어요.
REGIONS = ('region1', 'region2', ...) (필수)
이벤트가 라우팅되는 리전을 지정해요. 개별 리전을 지정하거나 ALL을 사용하여 모든 리전을 지정할 수 있어요. 사용 가능한 리전에 대한 자세한 내용은 리전 ID를 참조해요.
DESTINATION_ACCOUNT = organization.account_name (필수)
이벤트를 라우팅할 대상 계정을 지정해요. 조직(organization)은 필수가 아니에요. 계정은 조직 내에 있어야 해요.
REGION_GROUP = region_group (선택)
리전 그룹을 지정해요. 지원되는 유일한 값은 PUBLIC이에요.
SET RULE
단일 규칙을 만들거나 교체해요. SET RULES와 동일한 매개변수를 사용해요.
UNSET RULE
이벤트 라우팅 테이블에서 규칙을 삭제해요.
rule_name (필수)
삭제할 규칙의 이름을 지정해요. 이벤트 라우팅 테이블에 규칙이 하나만 남아 있으면 삭제할 수 없어요.
MODIFY RULE rule_name RENAME TO new_rule_name
규칙의 이름을 변경해요.
rule_name (필수)
이름을 변경할 규칙의 이름을 지정해요.
new_rule_name (필수)
규칙의 새 이름을 지정해요.
RENAME TO new_table_name
이벤트 라우팅 테이블의 이름을 변경해요.
new_table_name (필수)
이벤트 라우팅 테이블의 새 이름을 지정해요.
액세스 제어 요구 사항
| 역할 | 참고 |
|---|---|
| ORGADMIN | 이 명령을 실행하는 데 필요해요. 조직 계정에서 GLOBALORGADMIN 역할이 활성화된 경우 GLOBALORGADMIN만 이 명령을 실행할 수 있어요. |
지정된 권한 집합으로 사용자 지정 역할을 만드는 방법은 를 참조해요.
보안 개체(securable objects)에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반적인 정보는 액세스 제어 개요를 참조해요.
사용 참고 사항
- 조직에 대해 현재 활성화된 이벤트 라우팅 테이블을 수정하려면
FORCE를 사용해요. 테이블은ALTER ORGANIZATION SET EVENT ROUTING TABLE FOR ALL APPLICATION LISTINGS명령으로 활성화돼요.FORCE를 생략하고 테이블이 활성화되어 있으면 명령이 실패해요. 이름 변경 명령에는FORCE가 필요하지 않아요. SET RULES는 기존의 모든 규칙을 교체해요. 다른 규칙에 영향을 주지 않고 단일 규칙을 추가하거나 업데이트하려면SET RULE을 사용해요.- 이벤트 라우팅 테이블에 규칙이 하나만 남아 있으면
UNSET RULE을 사용하여 제거할 수 없어요.
예제
org_table의 모든 규칙을 새 규칙 집합으로 교체해요:
ALTER EVENT ROUTING TABLE org_table FORCE
SET RULES
default = (REGION_GROUP=PUBLIC, REGIONS=('ALL'), DESTINATION_ACCOUNT = org.account1)
aws_us_east_rule = (REGION_GROUP=PUBLIC, REGIONS=('AWS_US_EAST_1', 'AWS_US_EAST_2'), DESTINATION_ACCOUNT = org.account1)
org_table에 AWS_EU_WEST_RULE이라는 규칙을 만들거나 교체하여 AWS_EU_WEST_1의 이벤트를 조직의 account2로 라우팅해요:
ALTER EVENT ROUTING TABLE org_table FORCE
SET RULE "AWS_EU_WEST_RULE"
REGION_GROUP=PUBLIC REGIONS=('AWS_EU_WEST_1') DESTINATION_ACCOUNT = org.account2
org_table에서 AWS_EU_WEST_RULE 규칙을 삭제해요:
ALTER EVENT ROUTING TABLE org_table FORCE
UNSET RULE aws_eu_west_rule
org_table에서 AWS_US_EAST_RULE 규칙의 이름을 RULE_1로 변경해요:
ALTER EVENT ROUTING TABLE org_table
MODIFY RULE aws_us_east_rule RENAME TO rule_1
이벤트 라우팅 테이블 org_table의 이름을 org_table_2로 변경해요:
ALTER EVENT ROUTING TABLE org_table
RENAME TO org_table_2