DataWorks:コードエディター：高度な SQL (MyBatis 構文) の例

使用上の注意

このトピックでは、コードエディターで API を作成する際に、高度な SQL を使用してクエリロジックを記述する例を紹介します。また、SQL コードと、API 作成ページの リクエストパラメーター および 戻りパラメーター の対応関係についても説明します。ランタイムエラーを防ぐために、例に記載されているテーブル、フィールド、クエリ条件はお客様の環境に合わせて置き換えてください。

コードエディターで API を作成する方法の詳細については、「スクリプトモードで API を作成」をご参照ください。

このトピックでは、次の高度な SQL (MyBatis 構文) のユースケースの例を紹介します：

• 例 1：異なるテーブルフィールドで結果を条件付きでソート

• 例 2：異なるテーブルを条件付きでクエリ

• 例 3：パラメーターが null かどうかに基づいて WHERE 句を条件付きで含める

例 1：結果の条件付きソート

この動的 SQL の例では、var パラメーターの値によってソート順が決まります。

• var が 1 の場合、クエリは ORDER BY col01 を使用して結果をソートします。

• var が 2 の場合、クエリは ORDER BY col02 を使用して結果をソートします。

• var が 3 の場合、クエリは ORDER BY col01,col02 を使用して結果をソートします。

• var が 4 の場合、クエリは ORDER BY col02,col01 を使用して結果をソートします。

以下にコード例を示します。

select col01,col02
from table_name  
<choose>
    <when test='var == 1'>
    order by col01
    </when>
    <when test='var == 2'>
    order by col02
    </when>
    <when test='var == 3'>
    order by col01,col02
    </when>
    <when test='var == 4'>
    order by col02,col01
    </when>
</choose>

• リクエストパラメーター：

  パラメーター	型	位置	必須	サンプル値	デフォルト	説明
  var	INT	QUERY	はい	1	1	ソート順

• レスポンスパラメーター：

  パラメーター	型	サンプル値
  col01	STRING	shortname
  col02	STRING	name

例 2：異なるテーブルの条件付きクエリ

この動的 SQL の例では、var パラメーターの値に基づいて異なるテーブルをクエリします。クエリは col01 フィールドのデータを返します。

• var が 1 の場合、クエリは table_name01 テーブルの col01 フィールドからデータを取得します。

• var が 2 の場合、クエリは table_name02 テーブルの col01 フィールドからデータを取得します。

以下にコード例を示します。

select col01
from
<choose>
 <when test='var == 1'>
 table_name01
 </when>
 <when test='var == 2'>
 table_name02
 </when>
</choose>

• リクエストパラメーター：

  パラメーター	型	位置	必須	サンプル値	デフォルト
  var	INT	QUERY	はい	1	1

• レスポンスパラメーター：

  パラメーター	型	サンプル値
  col01	STRING	123

例 3：WHERE 句の条件付き追加

この例では、list コレクションの area 値に基づいてクエリ条件を動的に生成し、条件に基づいてデータをクエリします。

list が null でない場合、area フィールドの値を使用してクエリ条件が生成されます。さらに、list コレクションを反復して要素を指定の方法で連結し、area_id、area、amount フィールドのデータを返します。

以下にコード例を示します。

SELECT area_id, area, amount
FROM table_name
<where>
	<if test='list!=null'>
	area in
		<foreach collection="list" open="(" close=")" separator="," item="area">
		#{area}
		</foreach>
	</if>
</where>

• リクエストパラメーター：

  パラメーター	型	位置	必須	サンプル値	デフォルト
  list	STRING_LIST	QUERY	はい	Beijing,Hangzhou

• レスポンスパラメーター：

  パラメーター	型	サンプル値
  area_id	STRING	123120
  area	STRING	Beijing
  amount	STRING	50