SQLトランスフォーメーションをマッピングに追加する場合は、

［SQL］

タブで、データベース接続およびトランスフォーメーションが処理するSQLのタイプを定義します。

SQLトランスフォーメーションでパラメータ化された接続を使用することを選択できます。実行時にパラメータファイルで定義された値を上書きすることもできます。SQLトランスフォーメーションでパラメータ化された接続を使用するには、最初に、有効な接続を使用するマッピングでSQLトランスフォーメーションを作成します。次に、SQLトランスフォーメーションで接続をパラメータ化します。SQLトランスフォーメーションを使用して、SnowflakeでJavaまたはSQLユーザー定義関数（UDF）から読み取りを行うこともできます。

SQLトランスフォーメーションを使用して、次のタイプのSQL文を処理できます。

ストアドプロシージャ

Snowflakeのストアドプロシージャを呼び出すようにSQLトランスフォーメーションを設定できます。ストアドプロシージャ名では大文字と小文字が区別されます。データベースからストアドプロシージャを選択するか、SQLトランスフォーメーションで呼び出すストアドプロシージャの正確な名前を入力します。SQLトランスフォーメーションを作成するには、Snowflakeデータベースにストアドプロシージャが存在している必要があります。

詳細SQLプロパティでSnowflakeデータベース、スキーマ、およびプロシージャ名を指定した場合、エージェントでは最初にストアドプロシージャで指定したプロパティが考慮され、次に詳細ソースプロパティ、次に接続内の追加のJDBC URLパラメータ、最後にソースオブジェクトのメタデータが考慮されます。

マッピングが開いている状態で新しいストアドプロシージャをデータベースに追加すると、新しいストアドプロシージャは使用可能なストアドプロシージャのリストに表示されません。リストを更新するには、マッピングを閉じてから再度開きます。

SQLクエリ

SQLエディタで定義した入力済みクエリを処理するようにSQLトランスフォーメーションを設定できます。SQLトランスフォーメーションで複数のSQLクエリを使用しないでください。

SQLトランスフォーメーションはクエリを処理し、行を返します。SQLトランスフォーメーションは、基になるデータベースからエラーが発生した場合、またはユーザー構文にエラーがある場合でもエラーを返します。

SQLクエリとストアドプロシージャの詳細については、

データ統合

のドキュメントにある「

トランスフォーメーション

」を参照してください。