SQL コードではコメントを使用できます。

 -- comment

1 行のコメントを指定するには、行頭に 2 つのハイフンを記述します。コメントは独立した行として記述できるほか、SQL コードと同じ行に記述することもできます。SQL コードの後にコメントを続ける場合は、コードの末尾に空白を 1 つ以上置き、その後にハイフン 2 つのコメント演算子を記述します。コメントには、ハイフンも含め、あらゆる文字を記述できます。その行の最後までがコメントです。

以下の例では、複数のコメントが使用されています。

-- The main query
-- for this section of code
SELECT Name,Age -- Two fields selected
FROM Sample.Person -- Table name
-- Other clauses could appear here
ORDER BY Age
-- End of query

埋め込み SQL 文は、ルーチンの .INT コード・バージョンのコメントとして保持することができます。そのためには以下のように、構成オプションを設定します。

このオプションを “真 (true)” (1) に設定すると、ルーチンの .INT コード・バージョンで SQL 文をコメントとして維持できます。また、“真 (true)” (1) に設定することで、コメントのテキスト中でその SQL 文が使用している非 % 変数をすべてリストにできます。このリストの変数を Caché ObjectScript プロシージャの PUBLIC 変数リストにもリストし、NEW コマンドで再び初期化する必要があります。詳細は、"ホスト変数" を参照してください。