構成リファレンスをリセットする¶

リセット構成機能に関連するオブジェクトとプロシージャの詳細。

データベースオブジェクトとプロシージャ¶

以下のデータベース・オブジェクトは、 configuration/reset_configuration.sql を使用して作成されます。

PUBLIC.RESET_CONFIGURATION()¶

ADMIN ロールで使用可能なエントリポイントプロシージャ。このプロシージャはJavaの ResetConfigurationHandler.resetConfiguration ハンドラーを呼び出します。

PUBLIC.RESET_CONFIGURATION_VALIDATE()¶

追加のコネクタ固有の検証を提供するために使用されます。デフォルトでは 'response_code': 'OK' を返します。デフォルトの ResetConfigurationValidator によって呼び出されます。SQL でもJavaでも上書きできます。

PUBLIC.RESET_CONFIGURATION_INTERNAL()¶

コネクタ固有の追加ロジックを提供するために使用されます。デフォルトでは 'response_code': 'OK' を返します。デフォルトの ResetConfigurationCallback によって呼び出されます。SQL でもJavaでも上書きできます。

カスタムハンドラー¶

ハンドラーは、 SQL を使って完全に置き換えたり、Java インターフェイスを実装することでカスタマイズできます。

SQL を使用して交換します。¶

以下のコンポーネントは SQL を使用して置き換えることができます。

ハンドラー¶

ResetConfigurationHandler のカスタム実装を提供するには、 PUBLIC.RESET_CONFIGURATION プロシージャを置き換える必要があります。例:

CREATE OR REPLACE PROCEDURE PUBLIC.RESET_CONFIGURATION()
RETURNS VARIANT
LANGUAGE JAVA
RUNTIME_VERSION = '11'
PACKAGES = ('com.snowflake:snowpark:1.11.0')
IMPORTS = ('/connectors-native-sdk.jar')
HANDLER = 'com.snowflake.connectors.application.configuration.reset.CustomResetConfigurationHandler.resetConfiguration';

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

内部プロシージャ¶

INTERNAL プロシージャは、 SQL を通じてカスタマイズすることもできます。

CREATE OR REPLACE PROCEDURE PUBLIC.RESET_CONFIGURATION_INTERNAL()
    RETURNS VARIANT
LANGUAGE SQL
EXECUTE AS OWNER
AS
BEGIN
    -- SOME CUSTOM LOGIC

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

また、別のJavaハンドラーを呼び出すこともできます。

CREATE OR REPLACE PROCEDURE PUBLIC.RESET_CONFIGURATION_INTERNAL()
RETURNS VARIANT
LANGUAGE JAVA
RUNTIME_VERSION = '11'
PACKAGES = ('com.snowflake:snowpark:1.11.0')
IMPORTS = ('/connectors-native-sdk.jar')
HANDLER = 'com.snowflake.connectors.application.configuration.reset.CustomResetConfigurationCallback.resetConfiguration';

ビルダーアプローチ¶

ResetConfigurationHandler は、 ResetConfigurationHandlerBuilder を使用してカスタマイズできます。このビルダーを使用すると、開発者は次のインターフェイスのカスタム実装を提供できます。

ResetConfigurationValidator
ResetConfigurationCallback
ConnectorErrorHelper

すべてのインターフェイスを実装する必要はありませんが、その場合は SDK が提供するデフォルトの実装が使われます。

次の例は、 ResetConfigurationValidator のカスタマイズ方法を示しています。

class CustomResetConfigurationValidator implements ResetConfigurationValidator {

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

class CustomHandler {

    // Path to this method needs to be specified in the SQL definition of the PUBLIC.RESET_CONFIGURATION procedure
    public static Variant resetConfiguration(Session session) {
        // Using the builder
        var handler = ResetConfigurationHandler.builder(session)
            .withValidator(new CustomResetConfigurationValidator())
            .build();
        return handler.resetConfiguration().toVariant();
    }
}