ウェアハウスを更新する¶

要件¶

ウェアハウスの構成では、ネイティブアプリのインストール時に少なくとも次の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 コールバックは内部コールバックフェーズと似ています。その目的は、タスクリアクターによって作成されたタスクなど、 SDK 制御コンポーネントを更新することです。

この検証は、 UpdateWarehouseHandlerBuilder を使用しても、ストアドプロシージャを上書きしても上書きできません。この種の検証を行わないカスタムハンドラーを実装することもできますが、推奨していません。

設定の更新¶

検証とコールバックが正常に完了すると、新しいウェアハウスが内部の APP_CONFIG テーブルに保存されます。これを担当するサービスは、提供されたウェアハウスを connector_configuration キーに保存し、以前に構成された値を置き換えます。

構成の表示¶

ADMIN および VIEWER アプリケーションロールで使用できる PUBLIC.CONNECTOR_CONFIGURATION ビューがあり、内部 APP_CONFIG テーブルから現在の構成を返します。

応答¶

{
  "response_code": "OK"
}

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