구성 재설정하기¶
구성 재설정은 마법사 단계에서만 가능하며 PUBLIC.RESET_CONFIGURATION()
프로시저를 호출하여 수행할 수 있습니다. 이 프로시저는 모든 필수 구성 요소를 완료되지 않은 것으로 재설정하고 이전에 저장된 구성을 삭제하며 커넥터 상태를 INSTALLED
로 설정합니다. 커넥터를 재구성해야 하는 경우(즉, 전제 조건, 연결 구성 또는 커넥터 구성 단계를 다시 거쳐야 하는 경우) 사용할 수 있습니다. 커넥터는 최종 구성 단계를 완료하지 않은 경우에만 재구성할 수 있습니다. 커넥터 재구성은 SQL 또는 ResetConfigurationHandlerBuilder
를 사용하여 사용자 지정할 수 있습니다.
ADMIN
애플리케이션 역할이 할당된 사용자만 PUBLIC.RESET_CONFIGURATION()
프로시저를 호출할 수 있습니다.
구성 재설정은 다음과 같은 구성 가능한 단계로 구성되며, 기본적으로 아무런 효과가 없습니다.
상태 유효성 검사
상태 유효성 검사
내부 콜백
SDK 콜백
상태 업데이트
요구 사항¶
구성 재설정을 위해서는 Native App 설치에서 다음 SQL 파일을 실행해야 합니다.
core.sql
configuration/app_config.sql
configuration/prerequisites.sql
configuration/connector_configuration.sql
configuration/connection_configuration.sql
configuration/reset_configuration.sql
상태 유효성 검사¶
구성을 재설정하려면 커넥터가 CONFIGURING
상태여야 합니다. 구성 상태는 INSTALLED
, PREREQUISITES_DONE
, CONFIGURED
또는 CONNECTED
중 하나와 같아야 합니다. 상태 전환에 대한 전체 다이어그램은 커넥터 흐름 섹션을 참조하십시오.
검증은 ResetConfigurationHandlerBuilder
또는 저장 프로시저 덮어쓰기를 사용하여 덮어쓸 수 없습니다. 하지만 이런 종류의 유효성 검사가 필요하지 않은 사용자 지정 핸들러를 구현하는 것도 가능합니다.
상태 유효성 검사¶
상태 검증 단계는 사용자 지정할 수 있으며, 기본적으로 'response_code': 'OK'
를 반환하는 PUBLIC.RESET_CONFIGURATION_VALIDATE()
프로시저를 실행합니다. 이 프로시저는 SQL 또는 ResetConfigurationValidator
인터페이스를 구현하여 프로시저를 대체하여 사용자 지정할 수 있습니다.
내부 콜백¶
내부 콜백 단계는 사용자 지정할 수 있으며, 기본적으로 'response_code': 'OK'
를 반환하는 PUBLIC.RESET_CONFIGURATION_INTERNAL()
프로시저를 실행합니다. 이 프로시저는 구성을 재설정할 때 필요한 사용자 지정 로직 실행을 지원합니다. 사용자 지정 구성 삭제를 예로 들 수 있습니다. 이 프로시저는 SQL 또는 ResetConfigurationCallback
인터페이스를 구현하여 프로시저를 대체하여 사용자 지정할 수 있습니다.
SDK 콜백¶
SDK 콜백은 SDK로 제어되는 구성 요소를 업데이트하는 데 사용됩니다. 이 단계는 단일 트랜잭션으로 실행되는 다음 프로세스로 구성됩니다.
모든 필수 구성 요소를 완료되지 않음으로 설정하기
Connector 구성 삭제하기
연결 구성 삭제하기
모든 필수 구성 요소를 완료되지 않음으로 설정하기¶
이 단계에서는 내부 PREREQUISITES
테이블의 모든 기록에 대해 IS_COMPLETED
열이 false로 설정됩니다.
Connector 구성 삭제하기¶
이 단계에서는 내부 APP_CONFIG
테이블에서 connector_configuration
이 삭제됩니다.
Connector 구성 삭제하기¶
이 단계에서는 내부 APP_CONFIG
테이블에서 connection_configuration
이 삭제됩니다.
SDK 콜백은 ResetConfigurationHandlerBuilder
또는 저장 프로시저 덮어쓰기를 사용하여 덮어쓸 수 없습니다. 이 콜백이 없는 사용자 지정 처리기를 구현할 수도 있습니다.
참고
PUBLIC.CONNECTOR_CONFIGURATION
뷰는 내부 APP_CONFIG
테이블의 현재 구성을 반환합니다. PUBLIC.PREREQUISITES
뷰는 내부 PREREQUISITES
테이블의 전제 조건을 반환합니다. 두 뷰 모두 ADMIN
및 VIEWER
애플리케이션 역할에서 사용할 수 있습니다.
상태 업데이트¶
이 단계가 완료되면 커넥터의 내부 상태가 다음으로 설정됩니다.
{
"status": "CONFIGURING",
"configurationStatus": "INSTALLED"
}
응답¶
성공 응답¶
프로시저가 성공적으로 완료되면 아래와 같이 OK
응답 코드가 반환됩니다.
{
"response_code": "OK"
}
오류 응답¶
오류가 발생하면 다음과 같은 응답이 반환됩니다.
{
"response_code": "<ERROR_CODE>",
"message": "<error message>"
}
가능한 오류 코드는 다음과 같습니다.
INVALID_CONNECTOR_STATUS
- 커넥터 상태가 잘못되었습니다. 예상 상태:[CONFIGURING]
.INVALID_CONNECTOR_CONFIGURATION_STATUS
- 커넥터 상태가 잘못되었습니다. 예상 상태:[INSTALLED, PREREQUISITES_DONE, CONFIGURED, CONNECTED]
.INTERNAL_ERROR
- 내부적으로 문제가 발생했습니다. 메시지에는 설명이 포함되어야 합니다.PROCEDURE_NOT_FOUND
- 호출한 프로시저가 존재하지 않습니다.UNKNOWN_SQL_ERROR
- 내부 프로시저 호출 시 예상치 못한 일이 발생할 때 발생하는 오류입니다.INVALID_RESPONSE
- 이 오류는 내부 프로시저에서 수신한 응답에response_code
가 포함되어 있지 않거나 오류 응답에message
가 포함되어 있지 않고response_code
가 포함된 경우 발생합니다.UNKNOWN_ERROR
- 예기치 않은 문제가 발생했음을 의미합니다(throw된 예외 메시지가 전달됨).RESET_CONFIGURATION_INTERNAL
및RESET_CONFIGURATION_VALIDATE
프로시저에서 수신한 사용자 지정 오류 코드 - 커넥터 개발자가 정의함.