翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Keyspaces における Cassandra クエリ言語 (CQL) 要素
識別子、定数、用語、データ型など、Amazon Keyspaces でサポートされている Cassandra クエリ言語 (CQL) 要素について説明します。
**Topics**
+ [identifier](#cql.elements.identifier)
+ [constants](#cql.elements.constants)
+ [term](#cql.elements.term)
+ [
## データ型
](#cql.data-types)
+ [
## Amazon Keyspaces データ型の JSON エンコード
](#cql.data-types.JSON)
## 識別子
識別子 (または名前) は、テーブル、列、およびその他のオブジェクトの識別に使用されます。識別子は、引用符で囲んだものも、囲んでいないものも有効です。以下が適用されます。
```
identifier ::= unquoted_identifier | quoted_identifier
unquoted_identifier ::= re('[a-zA-Z][a-zA-Z0-9_]*')
quoted_identifier ::= '"' (any character where " can appear if doubled)+ '"'
```
## 定数
以下の定数が定義されます。
```
constant ::= string | integer | float | boolean | uuid | blob | NULL
string ::= '\'' (any character where ' can appear if doubled)+ '\''
'$$' (any character other than '$$') '$$'
integer ::= re('-?[0-9]+')
float ::= re('-?[0-9]+(\.[0-9]*)?([eE][+-]?[0-9+])?') | NAN | INFINITY
boolean ::= TRUE | FALSE
uuid ::= hex{8}-hex{4}-hex{4}-hex{4}-hex{12}
hex ::= re("[0-9a-fA-F]")
blob ::= '0' ('x' | 'X') hex+
```
## 用語
用語は、サポートされている値の種類を表します。用語は以下により定義されます。
```
term ::= constant | literal | function_call | arithmetic_operation | type_hint | bind_marker
literal ::= collection_literal | tuple_literal
function_call ::= identifier '(' [ term (',' term)* ] ')'
arithmetic_operation ::= '-' term | term ('+' | '-' | '*' | '/' | '%') term
```
## データ型
Amazon Keyspaces では、次のデータ型がサポートされています。
### 文字列型
****
| データ型 | 説明 |
| --- | --- |
| `ascii` | ASCII 文字列を表します。 |
| `text` | UTF-8 でエンコードされた文字列を表します。 |
| `varchar` | UTF-8 でエンコードされた文字列を表します (`varchar` は `text` のエイリアス)。 |
### 数値型
****
| データ型 | 説明 |
| --- | --- |
| `bigint` | 64 ビットの符号付き長整数を表します。 |
| `counter` | 64 ビットの符号付き整数カウンタを表します。詳細については、「[カウンタ](#cql.data-types.numeric.counters)」を参照してください。 |
| `decimal` | 可変精度の 10 進数を表します。 |
| `double` | 64 ビット の IEEE 754 浮動小数点を表します。 |
| `float` | 32 ビット の IEEE 754 浮動小数点を表します。 |
| `int` | 32 ビットの符号付き整数を表します。 |
| `varint` | \$1/-10^38 範囲内の整数値を表します。 |
#### カウンタ
`counter` 列に 64 ビットの符号付き整数が含まれます。カウンタ値は、[UPDATE](cql.dml.update.md) ステートメントを用いて増加または減少されます。直接設定することはできません。これにより、カウントの追跡に役立つ `counter` 列が作成されます。例えば、カウンタを使用して、ログファイル内のエントリ数や、ソーシャルネットワークで投稿が閲覧された回数を追跡することができます。`counter` 列には以下の制限があります。
+ `counter` 型の列をテーブルの `primary key` の一部にすることはできません。
+ `counter` 型の列が 1 つ以上含まれているテーブルでは、そのテーブルのすべての列は `counter` 型の列でなければなりません。
カウンタの更新が失敗した場合 (タイムアウトや Amazon Keyspaces との接続の喪失など)、カウンタ値の更新の有無がクライアントに認識されません。更新が再試行された場合、カウンタ値への更新が 2 回目に適用されることがあります。
### BLOB 型
****
| データ型 | 説明 |
| --- | --- |
| `blob` | 任意のバイトを表します。 |
### ブール型
****
| データ型 | 説明 |
| --- | --- |
| `boolean` | true または false を表します。 |
### 時間関連の型
****
| データ型 | 説明 |
| --- | --- |
| `date` | 形式の文字列--。 |
| `timestamp` | エポック (1970 年 1 月 1 日 00:00:00 GMT) からの日付と時刻をミリ秒単位で表す 64 ビットの符号付き整数。 |
| `timeuuid` | [バージョン 1 UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address)) を表します。 |
### コレクション型
****
| データ型 | 説明 |
| --- | --- |
| `list` | 順序が設定された一連のリテラル要素を表します。 |
| `map` | 順序が設定されていない一連のキーバリューペアを表します。 |
| `set` | 順序を設定した一連のリテラル要素 (1 つ以上) を表します。 |
コレクション型でコレクション列を宣言し、その後に山括弧で囲んだ別のデータ型 (たとえば、`TEXT` または `INT`) を使用します。次の例のように`TEXT` の `SET` で列を作成することも、`TEXT` および `INT` のキーと値のペアの `MAP` を作成することもできます。
```
SET
MAP
```
*非フリーズ*コレクションでは、個々のコレクション要素を更新できます。クライアント側のタイムスタンプと有効期限 (TTL) 設定は、個々の要素ごとに保存されます。
`FROZEN` コレクション型にキーワードを使用すると、コレクションの値は 1 つの不変の値にシリアル化され、Amazon Keyspaces ではそれらを `BLOB` のように扱われます。これは*フリーズ*コレクションです。`INSERT` または `UPDATE` ステートメントはフリーズされたコレクション全体を上書きします。フリーズコレクション内の個々の要素は更新できません。
クライアント側のタイムスタンプと有効期限 (TTL) の設定は、個々の要素ではなく、フリーズされたコレクション全体に適用されます。`Frozen` コレクション列は `PRIMARY KEY` のテーブルの一部にすることができます。
フリーズコレクションはネストできます。たとえば、次の例のように、`MAP` が `FROZEN` キーワードを使用している場合、`SET` 内の `MAP` を定義できます。
```
SET