実行オプションを設定します。
Synopsis
SET OPTION option_keyword = value
SET OPTION 文では、コンパイル・モード、SQL 構成設定、および日付、時刻、数値規則を管理するロケール設定などの、実行オプションを設定します。
他の
SET OPTION 引数 (ここには記載されていません) は、Caché で SQL 互換性に対し解析されますが、実行はしません。
Caché でサポートされているオプションは以下の通りです。
BLOB_SUPPORT ：このブーリアン・オプションでは、ストリームがロジックをサポートするのをシステム全体で可能または不可能にします。動作を不可能にした際 (BLOB_SUPPORT = 0)、ストリーミング・データはサポートされません。 すべての LONGVARCHARs と LONGVARBINARYs は VARCHARs と VARBINARYs 同様に扱われます。既定値は 1 です。
COMPILEMODE ：コンパイル･モードを設定して、現在のネームスペースに DEFERRED、IMMEDIATE、または INSTALL を実行します。既定値は IMMEDIATE です。DEFERRED から IMMEDIATE コンパイル・モードへ変更すると、Deferred Compile Queue のいずれのクラスもすぐにコンパイルされます。すべてのクラスのコンパイルが成功すると、SQLCODE は 0 を返します。 エラーがある場合は、-400 を返します。 クラス・コンパイルのエラーは ^mtemp2 ("Deferred Compile Mode","Error") にログ・インしています。SQLCODE=–400 の場合は、このグローバル構造をビューして、エラーの詳細メッセージを表示します。INSTALL コンパイル・モードは DEFERRED コンパイル・モードと似ていますが、テーブルにデータがないDDL インストールにのみ使用してください。
LOCK_TIMEOUT ：この数値オプションで、SQL 実行中に構築される現在のプロセスのロックにタイムアウト (秒数) の設定ができます。このロック・タイムアウトは、グローバル参照で SQL コードの挿入、更新、削除、および選択にロックをかける必要がある際に使用します。タイムアウトの設定はプロセスごとに行います。ODBC 接続を切断し、再接続する場合、システム全体の既定のタイムアウト設定を使用して再接続します。このシステム全体のタイムアウトは、
Caché 構成マネージャ を使用して設定できます。[詳細] タブの [SQL] オプションから、
[ロック･タイムアウト (秒)] を設定します。
Locale options ：このオプションは、現在のプロセスの日付、時刻、数値規則のロケール設定に使用します。利用可能なキーワード・オプションは、AM、DATE_FORMAT、DATE_MAXIMUM、DATE_MINIMUM、DATE_SEPARATOR、DECIMAL_SEPARATOR、MIDNIGHT、MINUS_SIGN、MONTH_ABBR、MONTH_NAME、NOON、NUMERIC_GROUP_SEPARATOR、NUMERIC_GROUP_SIZE、PM、PLUS_SIGN、TIME_FORMAT、TIME_PRECISION、TIME_SEPARATOR、WEEKDAY_ABBR、WEEKDAY_NAME、および YEAR_OPTION です。これらのオプションはすべてリテラルに設定可能で、いずれも既定 (アメリカ英語記述規則) をとります。これらオプションのいずれかを無効な値に設定すると、「SQLCODE=–130 エラー (Illegal value for
SET OPTION locale property)」が返されます。日付と時刻形式とオプションの詳細は、Caché ObjectScript
$ZDATETIME 関数を参照してください。
PKEY_IS_IDKEY ：このブーリアン・オプションでは、主キーもシステム全体で ID キーであるか否かを指定します。利用可能な値は TRUE と FALSE です。TRUE の場合、主キーは ID キーとして生成されます。(つまり、テーブルの主キーはクラス定義の IDKey インデックスとなります。)これによりパフォーマンスは向上しますが、生成された主キーの変更はできないという制限も付きます。設定後は、主キーに割り当てられた値の変更や、別のキーを主キーに割り当てることはできません。このオプションを使用すると、主キーを照合する既定値も変更され、主キー文字列値は EXACT 照合を既定値に設定します。FALSE の場合、主キーと ID キーは別々に定義され、主キー値は変更可能ですが、主キー文字列値は SQLUPPER 照合を既定に設定します。この設定は、システム全体ですべてのプロセスに対して有効です。このオプションに対するシステム全体の既定は、
Caché 構成マネージャを使用して設定できます。[詳細] タブの [SQL] オプションから、
[DDL 経由で作成された主キーが ID キー] を設定します。この PKEY_IS_IDKEY 設定は、他の
SET OPTION PKEY_IS_IDKEY 経由でリセットするか、Caché 構成を再起動して、
Caché 構成マネージャ の設定パラメータがリセットされるまで有効です。
SUPPORT_DELIMITED_IDENTIFIERS ：このブーリアン・オプションで、区切り識別子がシステム全体を通してサポートされるか否かを指定します。利用可能な値は TRUE と FALSE です。TRUE の場合、二重引用符で区切られた文字列は、SQL 文の識別子と考えられます。FALSE の場合、SQL 文の文字列リテラルと考えられます。この設定は、システム全体ですべてのプロセスに対して有効です。このオプションは、構成マネージャの
[区切り識別子をサポート] でも設定できます。このオプションに対するシステム全体の既定は、
Caché 構成マネージャを使用して設定できます。[詳細] タブの [SQL] オプションから、
[区切り識別子をサポート] を設定します。この SUPPORT_DELIMITED_IDENTIFIERS 設定は、他の
SET OPTION SUPPORT_DELIMITED_IDENTIFIERS 経由でリセットするか、Caché 構成を再起動して、
Caché 構成マネージャ の設定パラメータがリセットされるまで有効です。