카탈로그 통합 변경

카탈로그 통합 변경 (ALTER CATALOG INTEGRATION)

CREATE CATALOG INTEGRATION

기존 catalog integration의 속성을 수정합니다.

참조:

CREATE CATALOG INTEGRATION , DESCRIBE CATALOG INTEGRATION, DROP CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS

출처: 문서

본문

구문

ALTER CATALOG INTEGRATION [ IF EXISTS ]  SET
  REST_AUTHENTICATION = (
    restAuthenticationParams
  )
  [ REFRESH_INTERVAL_SECONDS =  ]
  [ COMMENT = '' ]

restAuthenticationParams는 인증 방법에 따라 다음과 같습니다.

OAuth

restAuthenticationParams (for OAuth) ::=

  OAUTH_CLIENT_SECRET = ''

Bearer 토큰

restAuthenticationParams (for Bearer token) ::=

  BEARER_TOKEN = ''

매개변수

name

변경할 카탈로그 통합의 식별자를 지정합니다.

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

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

SET ...

카탈로그 통합에 설정할 하나 이상의 지정된 속성 또는 매개변수를 설정합니다.

REFRESH_INTERVAL_SECONDS = value

Snowflake가 자동 새로 고침을 위한 메타데이터 업데이트를 위해 외부 Iceberg 카탈로그를 폴링하는 시도 사이에 대기하는 시간(초)을 지정합니다.

Delta 기반 테이블의 경우 Snowflake가 새 메타데이터를 위해 외부 클라우드 스토리지를 폴링하는 시도 사이에 대기하는 시간(초)을 지정합니다.

값: 30~86400(포함)

기본값: 30초

COMMENT = 'string_literal'

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

기본값: 값 없음

REST 인증 매개변수 (restAuthenticationParams)

OAuth

OAUTH_CLIENT_SECRET = oauth_client_secret

사용자의 OAuth2 클라이언트 시크릿입니다.

Bearer 토큰

BEARER_TOKEN = bearer_token

ID 공급자에 대한 Bearer 토큰입니다. 또는 개인 액세스 토큰(PAT)을 지정할 수 있습니다.

접근 제어 요구 사항

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

권한	개체	참고
OWNERSHIP	Integration (catalog)	%ac-ownership%

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

보안 개체에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반적인 정보는 접근 제어 개요를 참조하세요.

사용 참고 사항

메타데이터 관련:

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

예제

다음 예제는 자동 새로 고침의 새로 고침 간격을 30초로 업데이트합니다.

ALTER CATALOG INTEGRATION myCatalogIntegration SET REFRESH_INTERVAL_SECONDS = 30;

카탈로그 통합 변경