CQLコマンド構文について

CQLで作成した識別子は、二重引用符で囲まない限り大文字と小文字が区別されません。これらのオブジェクトの名前を大文字で入力すると、データベースには小文字で格納されます。二重引用符を使用すると、大文字と小文字が区別されるようになります。例：

CREATE TABLE test (
  Foo int PRIMARY KEY,
  "Bar" int
);

以下の表に、testテーブルから結果を取得できるクエリーと取得できないクエリーの一部を示します。

SELECT "foo" FROM ...は、内部でデータベースがfooを小文字で格納するので有効です。二重引用符文字は、二重引用符のエスケープ文字として使用することができます。

以前のCQLバージョンでの大文字と小文字の区別の規則は、レガシー・テーブルを扱う場合に適用されます。

CQLキーワードでは、大文字と小文字が区別されません。たとえば、SELECTおよびselectキーワードは同じになります。このドキュメントでは、キーワードを大文字で示しています。

キースペースとテーブルの名前には、英数字とアンダースコアのみを使用できます。その他の名前には、どの文字でも使用できます（COLUMN、FUNCTION、AGGREGATE、TYPEなど）。

ピリオド（.）やハイフン（-）などの特殊文字を含む名前を指定するには、名前を二重引用符で囲みます。

CQLでは、CQLが解析できない文字が含まれているカラム名を二重引用符で囲む必要があります。

ドル記号引用符で囲まれた文字列を代わりに使用することもできます。ドル記号引用符で囲まれた文字列定数は、複雑な引用が必要な場合に、関数の作成、データの挿入、およびデータの選択を行うために使用できます。二重ドル記号を使用して、目的の文字列を囲みます。

INSERT INTO cycling.calendar (race_id, race_start_date, race_end_date, race_name) VALUES 
  (201, '2015-02-18', '2015-02-22', $$Women's Tour of New Zealand$$);

有効なリテラルは以下の種類の値で構成されます。

• BLOB

  0[xX](hex)+で定義される16進数です

• boolean

  trueまたはfalseで、大文字/小文字は区別されず、引用符で囲まれていません

• 数値定数

  数値定数は、整数0～9およびマイナス記号（-）のプレフィックスで構成されます。数値定数は浮動小数点型にもなります。浮動小数点型は、1つまたは複数の10進数の桁、その後に小数点（.）、さらに1つまたは複数の10進数の桁が続きます。任意指定のプラス記号（+）はありません。.42や42のような表記は使用できません。小数点の前後に先頭または末尾の0を使用することができます。たとえば、0.42や42.0などです。浮動小数点型定数はE表記で表され、以下の正規表現の文字から成ります。

  '-'?[0-9]+('.'[0-9]*)?([eE][+-]?[0-9+])?

  NaNおよび無限大は浮動小数点型です。

• 識別子

  テーブル、カラム、型、およびその他のオブジェクトの名前は識別子です。キースペースとテーブルの名前はシステム・ファイル名に使用されるため、英字または数字で始まり、英数字とアンダースコアのみを使用する必要があります。カラムやユーザー定義関数名など、その他の識別子には、どの文字でも使用できます。特殊文字を含む識別子を指定するには、名前を引用符で囲みます。

• 整数

  任意指定のマイナス記号（-）の後に、1つまたは複数の数字が続きます。

• 文字列リテラル

  単一引用符で囲まれた文字群。文字列リテラルで単一引用符自体を使用するには、単一引用符をもう1つ続けてエスケープしてください。たとえば、dog の所有格を表すには、''を使用してdog''sとします。

• uuid

  32桁の16進数で、0～9またはa～fを使用し、大文字と小文字は区別されず、8番目、12番目、16番目、20番目の数字がダッシュ（-）で区切られてます。例：01234567-0123-0123-0123-0123456789ab

• timeuuid

  00:00:00.00 UTC（60ビット）から100ナノ秒単位で間隔を取る時間、重複防止のためのクロック・シーケンス番号（14ビット）、およびIEEE 801 MACアドレス（48ビット）を使用して、一意識別子を生成します。例：d2177dd0-eaa2-11de-a572-001b779c76e3

• 空白文字

  用語を区切ったり文字列リテラル内で使用されたりしますが、それ以外の場合、CQLは空白文字を無視します。

CREATE TABLE test(
  id varchar PRIMARY KEY,
  value_double double,
  value_float float
);

INSERT INTO test (id, value_float, value_double)
  VALUES ('test1', -2.6034345E+38, -2.6034345E+38);

SELECT * FROM test;

 id    | value_double | value_float
-------+--------------+-------------
 test1 |  -2.6034e+38 | -2.6034e+38

この表には、キーワードとそのキーワードが予約されているかどうかを示します。予約済みのキーワードは、二重引用符で囲まない限り、識別子として使用することはできません。予約されていないキーワードは所定の文脈においては特定の意味を持ちますが、その文脈の外では識別子として使用することができます。