연결 구성¶

상태 유효성 검사¶

연결 구성을 수행하려면 커넥터의 내부 상태는 CONFIGURING 이고, 구성 상태는 CONFIGURED 또는 CONNECTED 여야 합니다. 구성 상태 중 첫 번째는 커넥터 구성 단계 바로 뒤에 설정되며, 어떤 이유로 인해 이후 단계에서 연결 구성을 업데이트해야 하는 경우 후자의 상태가 표시됩니다.

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

입력 유효성 검사¶

입력은 속성 맵이 포함된 variant 여야 하지만, 일부 경우에는 적용되지 않을 수도 있습니다. 이러한 이유로 SDK는 내부 저장 프로시저 PUBLIC.SET_CONNECTION_CONFIG_VALIDATE(config VARIANT) 를 제공합니다. 기본적으로 이 프로시저는 'responseCode': 'OK' 만 반환하며, 이를 덮어쓰면 유효성 검사 중에 제공된 구성이 업데이트될 수 있습니다. 이 기능을 사용하면 사용자 지정 논리를 사용할 수 있습니다. 예를 들어, 입력 내용 잘라내기 또는 대문자/소문자로 변환 들이 이에 해당합니다. 어떤 식으로든 변환된 구성을 반환하려면 응답 Variant 에 추가 Variant 속성을 포함해야 하며, 이 속성에는 업데이트된 구성이 "config" 로 포함되어야 합니다. 이 프로시저는 SQL을 통해 덮어쓰거나 ConnectionConfigurationHandlerBuilder 를 사용하고 ConnectionConfigurationInputValidator 인터페이스의 사용자 지정 구현을 제공하여 사용자 지정할 수 있습니다.

다음은 변환을 포함한 사용자 지정 구현의 유효한 응답입니다.

{
    "response_code" : "OK",
    "config": {
        "key1": "value1",
        "key2": "value2"
    }
}

구성 업데이트¶

유효성 검사가 성공적으로 통과되면 구성이 내부 APP_CONFIG 테이블에 저장됩니다. 이를 담당하는 서비스는 공급자가 제공한 Variant 를 connection_configuration 키 아래에 저장합니다. 이 구성은 저장 시 추가적인 요구 사항을 따르지 않으며, 제공되는 속성 세트는 사용자에 따라 다릅니다.

내부 콜백¶

내부 콜백은 사용자 지정이 가능한 단계 중 하나입니다. 이는 기본적으로 PUBLIC.SET_CONNECTION_CONFIGURATION_INTERNAL(connection_configuration VARIANT) 을 호출하며, 'response_code': 'OK' 를 반환합니다. 예를 들어, 외부 액세스 통합을 허용하여 다른 프로시저를 변경하는 데 사용할 수 있습니다. SQL 스크립트를 통해 덮어쓰거나 ConnectionConfigurationHandlerBuilder 를 사용하여 ConnectionConfigurationCallback 인터페이스의 사용자 지정 구현을 제공함으로써 덮어쓸 수 있습니다.

연결 유효성 검사¶

이 단계에서는 PUBLIC.TEST_CONNECTION 프로시저를 트리거합니다. 이 프로시저는 원본 시스템에서 데이터에 대한 쿼리를 시도합니다. 이 프로시저는 기본적으로 구현되지 않으며 SDK 사용자가 제공해야 합니다. 또한 이 단계를 사용자 지정하기 위해 ConnectionValidator 인터페이스 구현을 ConnectionConfigurationHandlerBuilder 에 제공할 수 있으며, 이 경우 저장 프로시저를 구현할 필요가 없습니다. 이 절차에서는 최소한의 연결 확인만 수행하여 Snowflake의 외부 액세스 기능이 올바르게 구성되었는지, Connector에 해당 기능을 사용하는 데 필요한 모든 권한이 있는지 확인하는 것이 좋습니다.

상태 업데이트¶

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

{
    "status": "CONFIGURING",
    "configurationStatus": "CONNECTED"
}

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

구성 보기¶

내부 테이블에서 현재 연결 구성을 반환하는 ADMIN 및 VIEWER 사용자가 사용할 수 있는 PUBLIC.GET_CONNECTION_CONFIGURATION() 프로시저가 있습니다.

응답¶