연결 구성 참조 업데이트

데이터베이스 오브젝트 및 프로시저

다음 데이터베이스 오브젝트는 configuration/update_connection_configuration.sql 을 통해 생성됩니다.

PUBLIC.UPDATE_CONNECTION_CONFIGURATION(connection_configuration VARIANT)

ADMIN 역할이 사용할 수 있는 진입점 프로시저입니다. 이 프로시저는 Java UpdateConnectionConfigurationHandler.updateConnectionConfiguration 핸들러를 호출합니다.

PUBLIC.UPDATE_CONNECTION_CONFIGURATION_VALIDATE(connection_configuration VARIANT)

추가적인 커넥터별 유효성 검사 논리를 제공하는 데 사용되는 프로시저입니다. 기본적으로 'response_code': 'OK' 를 반환합니다. 이 프로시저는 기본 ConnectionConfigurationInputValidator 에 의해 호출됩니다. SQL 및 Java 모두에서 덮어쓸 수 있습니다.

PUBLIC.DRAFT_CONNECTION_CONFIGURATION_INTERNAL(connection_configuration VARIANT)

추가적인 커넥터별 논리를 제공하는 데 사용되는 프로시저입니다. 기본적으로 'response_code': 'OK' 를 반환합니다. 이 프로시저는 기본 ConnectionConfigurationCallback 에 의해 호출됩니다. SQL 및 Java 모두에서 덮어쓸 수 있습니다.

사용자 지정 핸들러

핸들러와 그 내부는 다음 두 가지 접근법을 사용하여 사용자 지정할 수 있습니다.

프로시저 바꾸기 접근법

다음 구성 요소는 SQL을 사용하여 바꿀 수 있습니다.

핸들러

UpdateConnectionConfigurationHandler 의 사용자 지정 구현을 제공하려면 PUBLIC.UPDATE_CONNECTION_CONFIGURATION 프로시저를 바꿔야 합니다. 예:

CREATE OR REPLACE PROCEDURE PUBLIC.UPDATE_CONNECTION_CONFIGURATION(connection_configuration VARIANT)
  RETURNS VARIANT
  LANGUAGE JAVA
  RUNTIME_VERSION = '11'
  PACKAGES = ('com.snowflake:snowpark:1.11.0')
  IMPORTS = ('/connectors-native-sdk.jar')
  HANDLER = 'com.custom.handler.CustomUpdateConnectionConfigurationHandler.updateConnectionConfiguration';

GRANT USAGE ON PROCEDURE PUBLIC.UPDATE_CONNECTION_CONFIGURATION(VARIANT) TO APPLICATION ROLE ADMIN;

내부 프로시저

VALIDATE 및 INTERNAL 프로시저는 SQL을 통해 사용자 지정할 수도 있습니다. 다른 Java 핸들러를 호출할 수도 있습니다.

CREATE OR REPLACE PROCEDURE PUBLIC.DRAFT_CONNECTION_CONFIGURATION_INTERNAL(connection_configuration VARIANT)
  RETURNS VARIANT
  LANGUAGE SQL
  EXECUTE AS OWNER
  AS
  BEGIN
    -- SOME CUSTOM LOGIC BEGIN
    SELECT sysdate();
    -- SOME CUSTOM LOGIC END

    RETURN OBJECT_CONSTRUCT('response_code', 'OK');
  END;

  CREATE OR REPLACE PROCEDURE PUBLIC.UPDATE_CONNECTION_CONFIGURATION_VALIDATE(connection_configuration VARIANT)
    RETURNS VARIANT
    LANGUAGE JAVA
    RUNTIME_VERSION = '11'
    PACKAGES = ('com.snowflake:snowpark:1.11.0')
    IMPORTS = ('/connectors-native-sdk.jar')
    HANDLER = 'com.custom.handler.CustomConnectionConfigurationInputValidator.validate';

빌더 접근법

UpdateConnectionConfigurationHandler 는 UpdateConnectionConfigurationHandlerBuilder 를 사용하여 사용자 지정할 수 있습니다. 이 빌더를 사용하면 개발자는 다음 인터페이스의 사용자 지정 구현을 제공할 수 있습니다.

  • ConnectionConfigurationInputValidator

  • ConnectionConfigurationCallback

  • DraftConnectionValidator

  • ConnectionConfigurationCallback

  • ConnectionValidator

  • ConnectorErrorHelper

이 중 하나가 제공되지 않는 경우 SDK에서 제공하는 기본 구현이 사용됩니다.

class CustomConnectionConfigurationInputValidator implements ConnectionConfigurationInputValidator {

  @Override
  public ConnectorResponse validate(Variant configuration) {
    // CUSTOM VALIDATION LOGIC
    return ConnectorResponse.success();
  }
}

class CustomHandler {

  // Path to this method needs to be specified in the PUBLIC.UPDATE_CONNECTION_CONFIGURATION procedure using SQL
  public static Variant updateConnectionConfiguration(Session session, Variant configuration) {
    // Using the builder
    var handler = UpdateConnectionConfigurationHandler.builder(session)
      .withInputValidator(new CustomConnectionConfigurationInputValidator())
      .build();
    return handler.updateConnectionConfiguration(configuration).toVariant();
  }
}