최종 구성

최종 구성은 마법사의 마지막 단계로, connection configuration 바로 뒤에 나옵니다. 이 단계에서는 사용자가 이전 구성 단계에서 포함되지 않은 사용자 지정 구성을 제공할 수 있습니다. 또한, 싱크 데이터베이스 생성, Task Reactor 시작 등 구성과 관련된 마지막 작업을 수행하기 위해서도 사용할 수 있습니다. 이 단계의 진입점은 이름이 PUBLIC.FINALIZE_CONNECTOR_CONFIGURATION(CUSTOM_CONFIGURATION VARIANT) 인 프로시저입니다. SQL을 사용하여 바꾸거나 FinalizeConnectorHandlerBuilder 를 사용하여 사용자 지정할 수 있습니다. 기본적으로 제공되는 custom_configuration 은 데이터베이스에 지속되지 않으므로 설계에 필요한 경우 확장 메서드 중 하나(대부분 FINALIZE_CONNECTOR_CONFIGURATION_INTERNAL 에 있음)에 구성을 저장해야 합니다.

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

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

  1. 상태 유효성 검사

  2. 입력 유효성 검사

  3. 소스 유효성 검사

  4. 내부 콜백

  5. 상태 업데이트

요구 사항

구성을 마무리하려면 Native App 설치 중에 최소한 다음 SQL 파일을 실행해야 합니다.

  • core.sql

  • configuration/finalize_configuration.sql

  • 권장: configuration/app_config.sql

상태 유효성 검사

커넥터 마무리를 수행하려면 커넥터의 내부 상태가 CONFIGURING 이고 구성 상태가 CONNECTED 여야 합니다.

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

입력 유효성 검사

입력은 유효한 Variant 여야 합니다. 또한, 충족해야 하는 사용자 지정 유효성 검사도 있습니다. 1개의 저장 프로시저인 PUBLIC.FINALIZE_CONNECTOR_CONFIGURATION_VALIDATE(CUSTOM_CONFIGURATION VARIANT) 저장은 사용자가 사용자 지정할 수 있습니다. 기본적으로 이 프로시저는 'response_code': 'OK' 만 반환합니다. SQL을 덮어쓰거나 FinalizeConnectorHandlerBuilder 를 사용하여 사용자 지정하고 FinalizeConnectorValidator 인터페이스의 사용자 지정 구현을 제공합니다.

소스 유효성 검사

유효성 검사가 통과되면 프로시저 PUBLIC.VALIDATE_SOURCE(CUSTOM_CONFIGURATION VARIANT) 가 외부 원본에 연결합니다. 경우에 따라, 이 프로시저는 연결 구성 중에 실행된 TEST_CONNECTION 프로시저와 동일할 수 있습니다. 그러나 TEST_CONNECTION 은 기본적인 연결만 확인하도록 설계된 반면, VALIDATE_SOURCE 는 몇 가지 추가 구성이 필요할 수 있는 프로시저입니다. 예를 들어, 소스 시스템의 특정 리소스에 대한 권한을 확인하는 경우입니다. VALIDATE_SOURCE 의 기본 구현은 'response_code': 'OK' 를 반환합니다. 이 기본 구현은 SQL로 덮어쓰거나 FinalizeConnectorHandlerBuilder 를 사용하여 SourceValidator 인터페이스를 구현하여 덮어쓸 수 있습니다.

내부 콜백

내부 콜백은 기본적으로 'response_code': 'OK' 를 반환하는 PUBLIC.FINALIZE_CONNECTOR_CONFIGURATION_INTERNAL(CUSTOM_CONFIGURATION VARIANT) 을 호출하는 사용자 지정 가능한 단계입니다. 이 프로시저를 통해 사용자는 커넥터에 필요한 추가 구성을 수행할 수 있습니다. 예를 들어, 제공된 custom_configuration 을 STATE.CONNECTOR_CONFIGURATION 테이블에 저장합니다. SQL 스크립트를 통해 덮어쓰거나 FinalizeConnectorHandlerBuilder 를 사용하여 FinalizeConnectorCallback 인터페이스의 사용자 지정 구현을 제공함으로써 덮어쓸 수 있습니다.

상태 업데이트

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

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

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

응답

성공 응답

프로시저가 성공적으로 완료되면 FINALIZE_CONNECTOR_CONFIGURATION_INTERNAL 프로시저가 응답을 반환합니다. 다음 형식을 사용하는 것이 좋습니다.

{
  "response_code": "OK"
}
Copy

오류 응답

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

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

가능한 오류 코드:

  • INVALID_CONNECTOR_STATUS - 이미 구성된 커넥터에서 프로시저가 호출되었습니다.

  • INVALID_CONNECTOR_CONFIGURATION_STATUS - CONFIGURATION_STATUS 가 CONNECTED 와 다른 경우 프로시저가 호출되었습니다.

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

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

언어: 한국어