SQLクエリ

独自のSQLクエリを作成する

以下の手順を実行します。

1. SQL要素をアクションフローに追加します。
2. 必要に応じて、クエリパラメータを定義します。
3. SQLクエリを作成します。
4. SQLノードの出力に使用される出力ストラクチャを定義します。
5. SQLノードの出力リストを使用して、SQLクエリの結果にアクセスします。

SQLクエリをテストする

SQLエディタの下部にある［TEST］ボタンをクリックして、動作をテストすることができます。テストを成功させるには、以下を確認します。

1. クエリパラメータがある場合は、先に［Test Inputs］タブでテスト値を割り当てておく必要があります。

   注記: 値が割り当てられていない場合、空の値でクエリがテストされます。

2. SELECT文のアトリビュートと一致する出力エンティティ/ストラクチャが1つ以上あります。

3. ［TEST］をクリックします。

注記およびガイドライン

SQL要素を使用する場合には以下の点を考慮します。

データ定義言語を避ける

SQLツールの使用は、次の操作を実行する場合に限定する必要があります。SELECT、INSERT、UPDATEおよびDELETE文。CREATE TABLE、ALTER TABLE、DROP TABLE等のDDL（データ定義言語）を使用すると、OutSystemsメタモデルの一貫性が損なわれ、誤動作を招く可能性があります。

物理層のクエリを使わない

OutSystemsメタモデルの一貫性を常に保証するため、メタモデルの物理テーブルに直接クエリを実行することはできません。プレフィックスOSLOG、OSSYSまたはOSUSRを持つテーブルをクエリで使用すると、プラットフォームはエラーメッセージを表示します。

例外によってトリガーされるロールバック

OutSystemsは、Webリクエストがサーバーに届いたらトランザクションを開始し、ユーザーに応答を返す前にトランザクションをコミットします。例外が捕捉されずに残った場合、データの一貫性を常に保証するため、トランザクションはロールバックされます。これは、クエリがトランザクションの内部で処理され、失敗した場合は変更がロールバックされることを意味します。

ランタイムユーザーの権限の確認

クエリは、Configurationツールで指定されたランタイムユーザーを使用して、データベースでテスト・実行されます。このユーザーが、クエリで指定されたSQL文を実行する権限を持っていることを確認する必要があります。権限がない場合、実行時にそのクエリを実行したり、テストしたりするとエラーが発生します。

データベースサポートの確認

Database ModuleプロパティがAllに設定されていると、OutSystemsは、サポートされているすべてのデータベースにクエリが適合していることを確認します。適合していない場合は、警告メッセージが表示されます。

クエリパラメータのExpand Inlineプロパティを有効にしない

パラメータをインラインに展開して適切に使用することは困難です。なぜならば、すべてのユーザー入力を適切にエスケープ処理してからSQL文で使用する必要があるからです。できる限り、このプロパティを完全に有効にしないでください。
OutSystemsには、このプロパティを有効にせずに一般的なユースケースを実装する方法があります。「動的SQL文の適切な作成」をご覧ください。

AggregateをSQLに変換する

アプリケーションが大規模になるにつれ、既存のAggregateを変更して別の方法でデータを取得する必要がある場合があります。ユースケースで、サブクエリやIN句などのより高度なデータの取得を行う必要がある場合、AggregateではなくSQL要素を使用する必要があります。このような場合は、既存のAggregateをSQL要素に変換し、元のAggregateから生成されたSQLの改良を続けることができます。

SQL要素ではクエリを改良することができるのに対し、Aggregateには以下のようなメリットがあります。

• Aggregateの実行時SQL文は必要な数の行および列を取得できるように最適化されています。

• Aggregateのほうが管理が簡単です。

このため、最初は必ずAggregateを使用してデータを取得し、必要な場合にのみSQL要素に変換するようにしてください。