mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-21 07:50:49 +00:00
9aa6c7053f
* add dataTypes zh translate --> init docs * add dataTypes zh translate * finish dataTypes zh translate * fix punctuation in dataTypes zh translate
85 lines
2.4 KiB
Markdown
85 lines
2.4 KiB
Markdown
<a name="data_type-array"></a>
|
||
|
||
# Array(T)
|
||
|
||
由 `T` 类型元素组成的数组。
|
||
|
||
`T` 可以是任意类型，包含数组类型。不推荐使用多维数组，ClickHouse 对多维数组的支持有限。例如，不能存储在 `MergeTree` 表中存储多维数组。
|
||
|
||
## 创建数组
|
||
|
||
您可以使用一个函数创建数组：
|
||
|
||
```
|
||
array(T)
|
||
```
|
||
|
||
您也可以使用方括号：
|
||
|
||
```
|
||
[]
|
||
```
|
||
|
||
创建数组示例：
|
||
|
||
```
|
||
:) SELECT array(1, 2) AS x, toTypeName(x)
|
||
|
||
SELECT
|
||
[1, 2] AS x,
|
||
toTypeName(x)
|
||
|
||
┌─x─────┬─toTypeName(array(1, 2))─┐
|
||
│ [1,2] │ Array(UInt8) │
|
||
└───────┴─────────────────────────┘
|
||
|
||
1 rows in set. Elapsed: 0.002 sec.
|
||
|
||
:) SELECT [1, 2] AS x, toTypeName(x)
|
||
|
||
SELECT
|
||
[1, 2] AS x,
|
||
toTypeName(x)
|
||
|
||
┌─x─────┬─toTypeName([1, 2])─┐
|
||
│ [1,2] │ Array(UInt8) │
|
||
└───────┴────────────────────┘
|
||
|
||
1 rows in set. Elapsed: 0.002 sec.
|
||
```
|
||
|
||
## 使用数据类型
|
||
|
||
当动态创建数组时，ClickHouse 自动将参数类型定义为可以存储所有列出的参数的最窄的数据类型。如果存在任何 [NULL](../query_language/syntax.md#null-literal) 或者 [Nullable](nullable.md#data_type-nullable) 类型参数，那么数组元素的类型是 [Nullable](nullable.md#data_type-nullable)。
|
||
|
||
如果 ClickHouse 无法确定数据类型，它将产生异常。当尝试同时创建一个包含字符串和数字的数组时会发生这种情况 (`SELECT array(1, 'a')`)。
|
||
|
||
自动数据类型检测示例：
|
||
|
||
```
|
||
:) SELECT array(1, 2, NULL) AS x, toTypeName(x)
|
||
|
||
SELECT
|
||
[1, 2, NULL] AS x,
|
||
toTypeName(x)
|
||
|
||
┌─x──────────┬─toTypeName(array(1, 2, NULL))─┐
|
||
│ [1,2,NULL] │ Array(Nullable(UInt8)) │
|
||
└────────────┴───────────────────────────────┘
|
||
|
||
1 rows in set. Elapsed: 0.002 sec.
|
||
```
|
||
|
||
如果您尝试创建不兼容的数据类型数组，ClickHouse 将引发异常：
|
||
|
||
```
|
||
:) SELECT array(1, 'a')
|
||
|
||
SELECT [1, 'a']
|
||
|
||
Received exception from server (version 1.1.54388):
|
||
Code: 386. DB::Exception: Received from localhost:9000, 127.0.0.1. DB::Exception: There is no supertype for types UInt8, String because some of them are String/FixedString and some of them are not.
|
||
|
||
0 rows in set. Elapsed: 0.246 sec.
|
||
```
|