STRUCT<field_name:field_type [COMMENT 'comment_string'], ... >?表示由多個 Field 組成的結構體，也可被理解為多個列的集合。

• 不能作為 Key 使用，目前 STRUCT 僅支持在 Duplicate 模型的表中使用。
• 一個 Struct 中的 Field 的名字和數量固定，總是為 Nullable，一個 Field 通常由下面部分組成。
  • field_name: Field 的標識符，不可重復
  • field_type: Field 的類型
  • COMMENT: Field 的注釋，可選 (暫不支持)

當前可支持的類型有：

BOOLEAN, TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL, DECIMALV3,
DATE, DATEV2, DATETIME, DATETIMEV2, CHAR, VARCHAR, STRING

CSV格式導入?

第 1 步：準備數據?

創建如下的 csv 文件：test_struct.csv?其中分隔符使用?|?而不是逗號，以便和 struct 中的逗號區分。

1|{10, 3.14, "Emily"}
2|{4, 1.5, null}
3|{7, null, "Benjamin"}
4|{}
5|null

第 2 步：在數據庫中建表?

CREATE TABLE struct_test (id          INT                                  NOT NULL,c_struct    STRUCT<f1:INT,f2:FLOAT,f3:STRING>    NULL
)
DUPLICATE KEY(id)
DISTRIBUTED BY HASH(id) BUCKETS 1
PROPERTIES ("replication_allocation" = "tag.location.default: 1"
);

第 3 步：導入數據?

curl --location-trusted \-u "root":"" \-H "column_separator:|" \-H "columns: id, c_struct" \-T "test_struct.csv" \http://localhost:8040/api/testdb/struct_test/_stream_load

第 4 步：檢查導入數據?

mysql> SELECT * FROM struct_test;
+------+--------------------------------------+
| id   | c_struct                             |
+------+--------------------------------------+
|    1 | {"f1":10, "f2":3.14, "f3":"Emily"}   |
|    2 | {"f1":4, "f2":1.5, "f3":null}        |
|    3 | {"f1":7, "f2":null, "f3":"Benjamin"} |
|    4 | {"f1":null, "f2":null, "f3":null}    |
|    5 | NULL                                 |
+------+--------------------------------------+
5 rows in set (0.01 sec)

JSON格式導入?

第 1 步：準備數據?

創建如下的 JSON 文件，test_struct.json

[{"id":1, "c_struct":{"f1":10, "f2":3.14, "f3":"Emily"}},{"id":2, "c_struct":{"f1":4, "f2":1.5, "f3":null}},{"id":3, "c_struct":{"f1":7, "f2":null, "f3":"Benjamin"}},{"id":4, "c_struct":{}},{"id":5, "c_struct":null}
]

第 2 步：在數據庫中建表?

CREATE TABLE struct_test (id          INT                                  NOT NULL,c_struct    STRUCT<f1:INT,f2:FLOAT,f3:STRING>    NULL
)
DUPLICATE KEY(id)
DISTRIBUTED BY HASH(id) BUCKETS 1
PROPERTIES ("replication_allocation" = "tag.location.default: 1"
);

第 3 步：導入數據?

curl --location-trusted \-u "root":"" \-H "format:json" \-H "columns: id, c_struct" \-H "strip_outer_array:true" \-T "test_struct.json" \http://localhost:8040/api/testdb/struct_test/_stream_load

第 4 步：檢查導入數據?

mysql> SELECT * FROM struct_test;
+------+--------------------------------------+
| id   | c_struct                             |
+------+--------------------------------------+
|    1 | {"f1":10, "f2":3.14, "f3":"Emily"}   |
|    2 | {"f1":4, "f2":1.5, "f3":null}        |
|    3 | {"f1":7, "f2":null, "f3":"Benjamin"} |
|    4 | {"f1":null, "f2":null, "f3":null}    |
|    5 | NULL                                 |
+------+--------------------------------------+
5 rows in set (0.00 sec)