커넥터 재개

마법사가 끝나면 커넥터를 재개할 수 있습니다. Finalize Configuration 뒤에 Pause Connector 로 추가적으로 실행할 수 있습니다. 이 단계에서는 사용자가 커넥터가 시작된 후 커넥터의 상태를 조작할 수 있습니다. 이 단계의 진입점은 이름이 PUBLIC.RESUME_CONNECTOR() 인 프로시저입니다. SQL을 사용하여 바꾸거나 ResumeConnectorHandlerBuilder 를 사용하여 사용자 지정할 수 있습니다. 커넥터를 재개하여 사용자가 일시 중단할 수 있는 역방향 프로세스는 커넥터 일시 중지 입니다.

이 프로시저를 호출하려면 사용자에게 ADMIN 애플리케이션 역할이 할당되어 있어야 합니다.

재개 커넥터 단계는 내부적으로 여러 단계로 구성됩니다. 단계 중 일부는 완전히 사용자 지정 가능하며, 기본적으로는 아무 작업도 수행하지 않습니다. 각 단계는 다음과 같습니다.

  1. 권한 유효성 검사

  2. 상태 유효성 검사

  3. 상태 유효성 검사

  4. 상태 업데이트(STARTING)

  5. 내부 콜백

  6. Task Reactor 재개(Task Reactor가 활성화된 경우)

  7. 상태 업데이트(STARTED)

요구 사항

재개 커넥터는 Native App 설치 중에 최소한 다음 SQL 파일을 실행해야 합니다.

  • core.sql

  • configuration/app_config.sql

  • lifecycle/resume.sql

  • 권장: lifecycle/pause.sql

  • 권장: configuration/finalize_configuration.sql

권한 유효성 검사

커넥터를 재개하려면 EXECUTE TASK 권한이 애플리케이션에 부여되어야 합니다.

이 유효성 검사는 ResumeConnectorHandlerBuilder 를 사용하거나 저장 프로시저를 덮어쓰는 방식으로 덮어쓸 수 없습니다. 하지만 사용자 지정 핸들러를 구현하는 것은 가능합니다.

상태 유효성 검사

커넥터를 재개하려면 커넥터의 내부 상태가 PAUSED 여야 합니다.

이 유효성 검사는 ResumeConnectorHandlerBuilder 를 사용하거나 저장 프로시저를 덮어쓰는 방식으로 덮어쓸 수 없습니다. 하지만 사용자 지정 핸들러를 구현하는 것은 가능합니다.

상태 유효성 검사

충족해야 하는 몇 가지 추가 사용자 지정 유효성 검사가 있는 경우 사용자가 지정할 수 있는 PUBLIC.RESUME_CONNECTOR_VALIDATE() 저장 프로시저가 있습니다. 기본적으로 이 프로시저는 'response_code': 'OK' 만 반환합니다. 이 프로시저는 SQL을 통해 덮어쓰거나 ResumeConnectorHandlerBuilder 를 사용하고 ResumeConnectorStateValidator 인터페이스의 사용자 지정 구현을 제공하여 사용자 지정할 수 있습니다.

내부 콜백

내부 콜백은 사용자 지정이 가능한 단계 중 하나입니다. 이는 기본적으로 PUBLIC.RESUME_CONNECTOR_INTERNAL() 을 호출하며, 'response_code': 'OK' 를 반환합니다. 이 프로시저를 통해 사용자는 커넥터를 재개할 때 필요한 추가적인 작업을 수행할 수 있습니다. 예를 들어, 커넥터별 추가 작업을 재개합니다. SQL 스크립트를 통해 덮어쓰거나 ResumeConnectorHandlerBuilder 를 사용하여 ResumeConnectorCallback 인터페이스의 사용자 지정 구현을 제공함으로써 덮어쓸 수 있습니다.

상태 업데이트

위의 모든 단계가 성공적으로 완료되면 커넥터의 내부 상태가 다음과 같이 업데이트됩니다.

{
    "status": "STARTED",
    "configurationStatus": "FINALIZED"
}
Copy

상태 전환의 전체 다이어그램은 커넥터 흐름 섹션을 참조하십시오.

응답

성공 응답

프로시저가 백그라운드에서 모든 작업을 성공적으로 재개하고 상태 tocSTARTED로 변경하면 ResumeConnectorHandler 메서드 본문에서 직접 Connector successfully resumed. 메시지가 반환됩니다. 다음 형식을 사용하는 것이 좋습니다.

{
  "response_code": "OK"
}
Copy

오류 응답

오류가 발생한 경우 응답은 아래 형식을 따릅니다.

{
  "response_code": "<ERROR_CODE>",
  "message": "error message"
}
Copy

가능한 오류 코드는 다음과 같습니다.

  • INVALID_CONNECTOR_STATUS - 상태가 [PAUSED, STARTING] 이 아닌 커넥터에서 프로시저가 호출되었습니다.

  • CONNECTOR_STATUS_NOT_FOUND - 커넥터 상태 레코드가 데이터베이스에 없음(이 스테이지에서 사용자의 입력과 관계 없음 - 내부 오류)

  • ROLLBACK_CODE - 오류가 발생했지만, 변경 사항이 성공적으로 되돌려졌습니다.

  • INTERNAL_ERROR - 내부적으로 문제가 발생했습니다. 메시지에는 설명이 포함되어야 합니다.

  • UNKNOWN_ERROR_CODE - 알 수 없는 오류가 발생하여 커넥터가 현재 지정되지 않은 상태입니다.

언어: 한국어