8.3.35　setHADBOrderMode(int mode)

(1)　機能

このConnectionオブジェクトによるHADBサーバへの接続で有効となる，ORDER BY句の文字データの並び替え順序を設定します。次のORDER BY句が対象になります。

• SELECT文の最も外側の問合せ式に指定したORDER BY句

• COPY文の最も外側の問合せ式本体に指定したORDER BY句

このメソッドで設定する内容は，クライアント定義のadb_clt_sql_order_modeオペランドに対応しています。

ページの先頭へ

(2)　形式

public void setHADBOrderMode(int mode) throws SQLException

ページの先頭へ

(3)　引数

int mode：

次のORDER BY句を指定したときの文字データの並び替え順序を指定します。

• SELECT文の最も外側の問合せ式に指定したORDER BY句

• COPY文の最も外側の問合せ式本体に指定したORDER BY句

次のどちらかの値を指定してください。

• AdbConnection.HADB_SQL_ORDER_MODE_BYTE

  文字データをバイトコード順に並び替えます。

• AdbConnection.HADB_SQL_ORDER_MODE_ISO

  文字データをソートコード順（ISO/IEC14651:2011準拠）に並び替えます。

ページの先頭へ

(4)　戻り値

なし。

ページの先頭へ

(5)　発生する例外

次に示す場合にSQLExceptionが投入されます。

• Connectionオブジェクトがクローズされている場合

• トランザクションがすでに開始している場合

• 並び替え順序に次の値以外を指定した場合

  ・AdbConnection.HADB_SQL_ORDER_MODE_BYTE

  ・AdbConnection.HADB_SQL_ORDER_MODE_ISO

ページの先頭へ

(6)　留意事項

• SELECT文の最も外側の問合せ式に指定したORDER BY句の文字データの並び替え順序は，次に示す優先順位に従って決定されます。また，COPY文の最も外側の問合せ式本体に指定したORDER BY句の文字データの並び替え順序も，次に示す優先順位に従って決定されます。番号が小さいほど優先順位が高くなります。1と2では1の指定が優先されます。

  1. setHADBOrderModeメソッドで指定した並び替え順序

  2. システムプロパティのadb_clt_sql_order_modeで指定した並び替え順序

  3. DriverManagerクラスのgetConnectionメソッドの引数infoに指定したadb_clt_sql_order_modeプロパティの値

  4. DriverManagerクラスのgetConnectionメソッドの引数urlに指定したadb_clt_sql_order_modeの値

  5. サーバ定義のadb_sql_order_modeオペランドで指定した並び替え順序

• setHADBOrderModeメソッドで指定した，SELECT文の最も外側の問合せ式に指定したORDER BY句の文字データの並び替え順序は，Connectionオブジェクトをいったんプールしたあとに再度使用した場合，前回の並び替え順序を引き継ぎません。setHADBOrderModeメソッドを実行していない状態と同じになります。また，setHADBOrderModeメソッドで指定した，COPY文の最も外側の問合せ式本体に指定したORDER BY句の文字データの並び替え順序も同様です。

• このメソッドは，AdbConnectionインタフェースで提供されるHADB独自のメソッドです。実行方法については，「12.2　Wrapperインタフェース」を参照してください。

ページの先頭へ