리소스 활성화하기¶
리소스 활성화는 특정 리소스에 대한 데이터 수집을 시작하는 데 사용됩니다. PUBLIC.ENABLE_RESOURCE
프로시저는 리소스를 활성화하기 위한 UI 또는 워크시트의 진입점입니다. 이는 리소스가 비활성화된 후 또는 리소스를 비활성화된 상태로 만들었으나 이제 활성화해야 할 때 사용할 수 있습니다.
이 프로시저를 호출하려면 사용자에게 ADMIN
애플리케이션 역할이 할당되어 있어야 합니다. 단계는 다음과 같습니다.
초기 유효성 검사
사용자 지정 유효성 검사
리소스가 활성화되기 전의 사용자 지정 논리
리소스 수집 정의를 활성화된 것으로 표시하고 새로운 수집 프로세스를 생성합니다.
리소스가 생성된 후의 사용자 지정 논리
초기 유효성 검사¶
초기 유효성 검사는 리소스 활성화 프로세스의 맨 처음에 수행되며 다음 사항을 확인합니다.
지정된 ID를 갖는 리소스가 있는지 여부
지정된 ID를 갖는 리소스가 이미 활성화되어 있는지 여부
리소스가 이미 활성화된 경우 아무 작업도 수행되지 않으며 성공 응답이 반환됩니다.
사용자 지정 유효성 검사¶
사용자 지정 유효성 검사는 초기 유효성 검사 후 실행되며, 사용자 지정 커넥터별 논리를 지원하도록 설계되었습니다. 예를 들어, 주어진 리소스가 소스 시스템에 여전히 있는지 확인하는 데 사용할 수 있습니다.
이는 기본적으로 PUBLIC.ENABLE_RESOURCE_VALIDATE(resource_ingestion_definition_id)
을 호출하며, 'response_code': 'OK'
를 반환합니다. SQL 스크립트를 통해 덮어쓰거나 EnableResourceHandlerBuilder
를 사용하여 EnableResourceValidator
인터페이스의 사용자 지정 구현을 제공함으로써 덮어쓸 수 있습니다.
사용자 지정 유효성 검사가 오류를 반환하면 다음 단계가 실행되지 않고 ENABLE_RESOURCE
프로시저에서 제공된 오류 응답이 반환됩니다.
리소스가 활성화되기 전의 사용자 지정 논리¶
리소스가 활성화되기 전에 사용자 지정 논리를 지정하고 실행할 수 있습니다.
이는 기본적으로 PUBLIC.PRE_ENABLE_RESOURCE(resource_ingestion_definition_id VARCHAR)
을 호출하며, 'response_code': 'OK'
를 반환합니다. SQL 스크립트를 통해 덮어쓰거나 EnableResourceHandlerBuilder
를 사용하여 PreEnableResourceCallback
인터페이스의 사용자 지정 구현을 제공함으로써 덮어쓸 수 있습니다.
사용자 지정 논리가 오류를 반환하면 다음 단계가 실행되지 않고 ENABLE_RESOURCE
프로시저에서 오류 응답이 반환됩니다.
리소스 수집 정의를 활성화된 것으로 표시하고 새로운 수집 프로세스를 생성합니다.¶
이 단계에서는 리소스 수집 정의의 enabled
플래그가 true
로 변경된 다음 각 수집 구성에 대해 새 수집 프로세스가 생성됩니다. 수집 프로세스는 SCHEDULED
상태로 생성되며, 이는 잠시 후 수집이 시작됨을 의미합니다. 새로운 수집 프로세스가 생성되면 메타데이터 열은 주어진 수집 구성 ID를 사용하여 마지막으로 완료된 프로세스에서 상속됩니다.
리소스가 활성화된 후의 사용자 지정 논리¶
사용자 지정 논리는 리소스가 활성화된 후 실행되도록 정의할 수 있습니다.
이는 기본적으로 PUBLIC.POST_ENABLE_RESOURCE(resource_ingestion_definition_id VARCHAR)
을 호출하며, 'response_code': 'OK'
를 반환합니다. SQL 스크립트를 통해 덮어쓰거나 EnableResourceHandlerBuilder
를 사용하여 PostEnableResourceCallback
인터페이스의 사용자 지정 구현을 제공함으로써 덮어쓸 수 있습니다.
사용자 지정 논리가 오류를 반환하는 경우, 주어진 오류 응답은 ENABLE_RESOURCE
프로시저에서 반환되지만, 리소스 수집 정의를 활성화된 것으로 표시하고 새 수집 프로세스를 생성하는 프로세스는 롤백되지 않습니다.
응답¶
성공 응답¶
프로시저가 성공하면 아래와 유사한 응답이 반환됩니다.
{ "response_code": "OK" }
오류 응답¶
프로시저 오류가 발생하면 아래와 유사한 응답이 반환됩니다.
{ "response_code": "<ERROR_CODE>", "message": "<error message>" }
가능한 오류 코드는 다음과 같습니다.
INVALID_INPUT
- 지정된 리소스 수집 정의 ID를 가진 리소스가 존재하지 않습니다.ENABLE_RESOURCE_ERROR
- 리소스 수집 정의를 업데이트하는 동안 또는 수집 프로세스를 생성하는 동안 예기치 않은 동작이 발생했습니다. 모든 변경 사항이 롤백됩니다.