本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 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` | 表示可变精度小数。 |
| `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` 的列的表中，所有列的类型都必须为 `counter`。
如果计数器更新失败（例如，因超时或与 Amazon Keyspaces 的连接断开），客户端将不知道计数器值是否已更新。如果重试更新，则可能会再次应用对计数器值的更新。
### Blob 类型
****
| 数据类型 | 说明 |
| --- | --- |
| `blob` | 表示任意字节。 |
### 布尔值类型
****
| 数据类型 | 说明 |
| --- | --- |
| `boolean` | 表示 true 或 false。 |
### 与时间相关的类型
****
| 数据类型 | 说明 |
| --- | --- |
| `date` | 格式为的字符串--。 |
| `timestamp` | 64 位有符号整数，表示自纪元（1970 年 1 月 1 日 00:00:00 GMT）以来的日期和时间，以毫秒为单位。 |
| `timeuuid` | 表示[版本 1 UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address))。 |
### 集合类型
****
| 数据类型 | 说明 |
| --- | --- |
| `list` | 表示文本元素的有序集合。 |
| `map` | 表示键/值对的无序集合。 |
| `set` | 表示一个或多个文本元素的无序集合。 |
您将通过在尖括号中使用集合类型后跟其他数据类型（如 `TEXT` 或 `INT`）来声明集合列。您可以创建包含 `TEXT` 的 `SET` 的列，也可以创建 `TEXT` 和 `INT` 键值对的 `MAP`，如以下示例所示。
```
SET
MAP
```
*非冻结*集合可让您对每个单独的集合元素进行更新。系统将为各个元素存储客户端时间戳和存活时间 (TTL) 设置。
当您对集合类型使用 `FROZEN` 关键字时，集合的值将被序列化为单个不可变值，并且 Amazon Keyspaces 会将它们视为 `BLOB`。这是一个*冻结*集合。`INSERT` 或 `UPDATE` 语句将覆盖整个冻结集合。您无法对冻结集合中的单个元素进行更新。
客户端时间戳和存活时间 (TTL) 设置适用于整个冻结集合，而不是单个元素。`Frozen` 集合列可以是表的 `PRIMARY KEY` 的一部分。
您可以嵌套冻结集合。例如，如果 `MAP` 使用了 `FROZEN` 关键字，您可以在 `SET` 中定义 `MAP`，如以下示例所示。
```
SET