웨어하우스 업데이트¶

요구 사항¶

웨어하우스 구성을 위해서는 Native App 설치 중에 최소한 다음 SQL 파일을 실행해야 합니다.

• core.sql

• configuration/app_config.sql

• configuration/connector_configuration.sql

• configuration/update_warehouse.sql

상태 유효성 검사¶

웨어하우스 업데이트를 수행하려면 커넥터의 내부 상태가 PAUSED 여야 합니다.

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

입력 유효성 검사¶

입력은 새 웨어하우스가 포함된 String 이어야 합니다. 제공되는 이 웨어하우스는 UpdateWarehouseInputValidator 구현을 사용하여 검증됩니다. 기본적으로 다음 유효성 검사가 수행되며, 필수 기준이 충족되지 않으면 예외가 발생합니다.

1. 제공되는 웨어하우스가 유효한 Snowflake 식별자인지 확인합니다.

2. 새로운 웨어하우스가 이미 구성된 웨어하우스와 다른지 확인합니다.

3. 애플리케이션 인스턴스가 새 웨어하우스에 액세스할 수 있는지 확인합니다(SHOW WAREHOUSES 쿼리 사용).

이 입력 유효성 검사 단계는 UpdateWarehouseHandlerBuilder 를 사용하고 새로운 사용자 지정 핸들러 인스턴스를 빌드해야 사용자 지정할 수 있습니다.

내부 콜백¶

내부 콜백도 사용자 지정이 가능한 단계입니다. 기본적으로 PUBLIC.UPDATE_WAREHOUSE_INTERNAL 프로시저를 호출하며, 내부 콜백의 기본 구현은 'response_code': 'OK' 를 반환합니다. 이 단계는 애플리케이션 개발자가 만든 작업을 변경하는 등 웨어하우스 업데이트 프로세스에 대한 사용자 지정 논리를 제공하는 데 사용할 수 있습니다. 콜백은 SQL 스크립트를 통해 덮어쓰거나 UpdateWarehouseHandlerBuilder 를 사용하여 UpdateWarehouseCallback 인터페이스의 사용자 지정 구현을 제공함으로써 덮어쓸 수 있습니다.

SDK 콜백¶

SDK 콜백은 내부 콜백 단계와 유사합니다. 그 목적은 Task Reactor에 의해 생성된 작업과 같이 SDK 제어 구성 요소를 업데이트하는 것입니다.

이 유효성 검사는 UpdateWarehouseHandlerBuilder 를 사용하거나 저장 프로시저를 덮어쓰는 방식으로 덮어쓸 수 없습니다. 이러한 종류의 유효성 검사가 없는 사용자 지정 핸들러를 구현할 수도 있지만, 이는 권장되지 않습니다.

구성 업데이트¶

유효성 검사 및 콜백이 성공적으로 통과되면 새 웨어하우스가 내부 APP_CONFIG 테이블에 저장됩니다. 이를 처리하는 서비스는 제공된 웨어하우스를 connector_configuration 키에 저장하여 이전에 구성한 값을 대체합니다.

구성 보기¶

ADMIN 및 VIEWER 애플리케이션 역할이 사용할 수 있는 PUBLIC.CONNECTOR_CONFIGURATION 뷰가 있으며, 이 뷰는 내부 APP_CONFIG 테이블에서 현재 구성을 반환합니다.

응답¶

{
  "response_code": "OK"
}

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