メインコンテンツまでスキップ
バージョン: 開発中

SQL SET OPTION

SQL SET OPTION ( option ; value )

引数説明
optionInteger設定するオプション番号
valueInteger, Text新しいオプションの値

このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。

説明

SQL SET OPTION コマンドを使用して、optionに渡したオプションのvalueを変更します。

optionには“SQL” テーマにある次の定数のうちいずれかを渡します:

定数コメント
SQL asynchronous10 = 同期接続 (デフォルト値)
1 (または非0値) = 非同期接続
SQL charset100(SQLパススルー経由で) 外部ソースに送られるリクエストで使用されるテキストエンコーディング。変更はカレントプロセスのカレント接続に対して実行されます。
値: MIBEnum識別子 (Note2を参照)、または値 -2 (Note3を参照)
デフォルト: 106 (UTF-8)
SQL connection timeout5SQL LOGINコマンド実行時にレスポンスを待ち受ける最大タイムアウト。この値が有効になるためには、接続を開く前に設定しなければなりません。
取りうる値: 秒数
デフォルト: タイムアウトしない
SQL data chunk size6サーバーへと送られるデータチャンクのサイズ。このオプションはSybase ODBC のような、実際のデータチャンクをサポートしないドライバーの場合に主に有効です。デフォルトの値より大きな値を設定することで一度に大きなデータを送信することができます。 値: バイト単位でのサイズ
デフォルト値: 8000
SQL max data length3返されるデータの最大長
SQL max rows2結果グループの最大行数 (プレビューで使用)
SQL query timeout4SQL EXECUTEコマンドの実行時に応答を待機する最大タイムアウト
値: 秒数
デフォルト:タイムアウトしない

Notes:

  1. 4Dの内部SQLカーネルを使用する場合、SQL Asynchronousオプションは意味を持ちません。この場合常に同期接続が使用されます。
  2. MIBEnum番号は、次のアドレスで参照できます。 http://www.iana.org/assignments/character-sets
  3. SQL Charsetのvalueと して-2を渡すと、4D SQLサーバが使用するエンコーディングは、自動で実行中のプラットフォームに合わせて適用されます (非Unicodeエンコーディング):
    • Windowsでは ISO8859-1が使用されます。
    • Mac OSではMAC-ROMANが使用されます。

システム変数およびセット

コマンドが正しく実行されるとOKシステム変数に1が、そうでなければ0が設定されます。

参照

SQL GET OPTION