SQLトランスフォーメーションを使用したSQLクエリとストアドプロシージャの処理

ストアドプロシージャ

Microsoft Azure Synapse SQLのストアドプロシージャを呼び出すようにSQLトランスフォーメーションを設定できます。SQLトランスフォーメーションを作成するには、ストアドプロシージャがMicrosoft Azure Synapse SQLデータベースに存在している必要があります。SQLトランスフォーメーションは、ストアドプロシージャを処理する場合、入力パラメータをストアドプロシージャに渡します。ストアドプロシージャは値をトランスフォーメーションの出力フィールドに返します。

SQLクエリ

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

SQLトランスフォーメーションの設定

1. 1SQLトランスフォーメーションの名前と説明を入力します。
2. 2［受信フィールド］タブで、トランスフォーメーションに含めるデータを決定するフィールドルールを定義します。
3. 3SQLトランスフォーメーションの［プロパティ］パネルで［SQL］タブをクリックします。
4. 4［SQL］タブで、次のタスクを実行します。
1. aデータベースへの接続を選択します。接続を選択するか、パラメータを使用することができます。
2. bSQLタイプを［ストアドプロシージャ］に設定します。
3. c［選択］をクリックしてデータベースからストアドプロシージャを選択するか、呼び出すストアドプロシージャの正確な名前を入力します。
ストアドプロシージャ名では大文字と小文字が区別されます。
注: マッピングが開いている状態で新しいストアドプロシージャをデータベースに追加すると、新しいストアドプロシージャは使用可能なストアドプロシージャのリストに表示されません。リストを更新するには、マッピングを閉じてから再度開きます。
5. 5［フィールドマッピング］タブで、選択したストアドプロシージャの入力フィールドに受信フィールドをマッピングする方法を指定します。
6. 6要件に応じて、トランスフォーメーションに詳細プロパティを定義します。

SQLトランスフォーメーションのルールとガイドライン

• •RETURN_VALUEパラメータは、Microsoft Azure Synapse SQLコネクタには適用されません。
• •ストアドプロシージャは、整数値のみを含む出力フィールドを返します。例えば、int、bigint、tinyint、smallint、およびbitデータ型のフィールドが出力フィールドとして返されます。
• •ストアドプロシージャにdatetimeoffset、binary、またはvarbinaryデータ型の入力フィールドを含めることはできません。
• •Microsoft Azure Synapse SQLでストアドプロシージャを呼び出すようにマッピングを設定する場合は、スキーマのオーバーライドを設定しないでください。スキーマ名のオーバーライドを指定すると、Secure Agentはストアドプロシージャからのメタデータの取得に失敗します。
• •名前にUnicode文字が含まれているストアドプロシージャから読み取ることはできません。マッピングはSQLコンパイルエラーで失敗します。
• •SQLトランスフォーメーションで複数のSQLクエリを指定しないでください。複数のSQLクエリを使用したマッピングは失敗します。
• •入力したクエリからストアドプロシージャを呼び出すことはできません。
• •SQLトランスフォーメーションで接続をパラメータ化する場合は、次の手順を実行します。
1. 1SQLトランスフォーメーションに有効なパラメータ化されていない接続を選択します。
2. 2ストアドプロシージャまたはSQLクエリを設定します。
3. 3接続をパラメータ化された接続に変更します。
• •SQLクエリにパラメータ化された接続を使用する場合、新しい出力フィールドを追加することはできません。
• •接続とSQLクエリが異なるスキーマを指している場合、エージェントはSQLクエリで指定されたスキーマを考慮します。