ALTER API INTEGRATION¶
기존 API 통합의 속성을 수정합니다.
구문¶
ALTER [ API ] INTEGRATION [ IF EXISTS ] <name> SET
[ API_AWS_ROLE_ARN = '<iam_role>' ]
[ AZURE_AD_APPLICATION_ID = '<azure_application_id>' ]
[ API_KEY = '<api_key>' ]
[ ENABLED = { TRUE | FALSE } ]
[ API_ALLOWED_PREFIXES = ('<...>') ]
[ API_BLOCKED_PREFIXES = ('<...>') ]
[ COMMENT = '<string_literal>' ]
ALTER [ API ] INTEGRATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER [ API ] INTEGRATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
ALTER [ API ] INTEGRATION [ IF EXISTS ] <name> UNSET {
API_KEY |
ENABLED |
API_BLOCKED_PREFIXES |
COMMENT
}
[ , ... ]
매개 변수¶
name
변경할 통합의 식별자입니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
SET ...
API 통합에 대해 설정할 하나 이상의 속성/매개 변수를 지정합니다(공백, 쉼표 또는 새 줄로 구분).
ENABLED = TRUE | FALSE
통합 작업을 시작할지 일시 중단할지 여부를 지정합니다.
TRUE
로 지정하면 통합을 실행할 수 있습니다.FALSE
로 지정하면 유지 관리를 위해 통합이 일시 중단됩니다. Snowflake와 서드 파티 서비스 간의 통합이 작동하지 않습니다.
API_AWS_ROLE_ARN = '<iam_role>'
iam_role
은 클라우드 플랫폼 역할의 ARN(Amazon 리소스 이름)입니다.이 매개 변수는 API_PROVIDER가
aws_api_gateway
로 설정된 경우에만 적용됩니다.AZURE_AD_APPLICATION_ID = '<azure_application_id>'
원격 서비스를 위한 Azure AD(Active Directory) 앱의 〈애플리케이션(클라이언트) ID’입니다.
이 매개 변수는 API_PROVIDER가
azure_api_management
로 설정된 경우에만 적용됩니다.API_KEY = '<api_key>'
API 키 (〈구독 키’라고도 함)입니다.
API_ALLOWED_PREFIXES = ('<...>')
통합을 사용하여 하나 이상의 HTTPS 프록시 서비스 엔드포인트(예: Amazon AWS API Gateway)와 이러한 프록시 내의 리소스를 참조하는 외부 함수를 명시적으로 제한합니다. 접두사로 처리되는 URLs의 쉼표로 구분된 목록을 지원합니다(자세한 내용은 아래 참조).
API_ALLOWED_PREFIXES = (...)
의 각 URL은 접두사로 처리됩니다. 다음과 같이 지정한다고 예를 들어 봅시다.https://xyz.amazonaws.com/production/
그 의미는
https://xyz.amazonaws.com/production/
아래의 모든 리소스가 허용된다는 뜻입니다. 예를 들어 다음이 허용됩니다.
https://xyz.amazonaws.com/production/ml1
보안을 극대화하려면 허용된 위치를 가능한 한 좁게 제한해야 합니다.
API_BLOCKED_PREFIXES = ('<...>')
Snowflake에서 호출할 수 없는 HTTPS 프록시 서비스의 엔드포인트와 리소스를 나열합니다.
위치에 대해 가능한 값은 위의
API_ALLOWED_PREFIXES
에 대한 것과 같은 규칙을 따릅니다.API_BLOCKED_PREFIXES가 API_ALLOWED_PREFIXES에 우선합니다. 둘 모두와 일치하는 접두사는 차단됩니다. 즉, Snowflake는 API_BLOCKED_PREFIXES와도 일치하는 값을 제외하고 API_ALLOWED_PREFIXES와 일치하는 모든 값을 허용합니다.
어떤 값이 API_ALLOWED_PREFIXES 외부에 있으면 이를 명시적으로 차단할 필요가 없습니다.
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
태그 이름과 태그 문자열 값을 지정합니다.
태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.
문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.
COMMENT = 'string_literal'
통합에 대한 설명을 지정하는 문자열(리터럴)입니다.
UNSET ...
API 통합에 대해 설정 해제할 속성/매개 변수를 하나 이상 지정하여 다시 기본값으로 재설정합니다.
ENABLED
API_BLOCKED_PREFIXES
TAG tag_name [ , tag_name ... ]
COMMENT
사용법 노트¶
API_PROVIDER는 변경할 수 없습니다.
메타데이터 관련:
주의
고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.