

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# STRUCT 建構函數
<a name="struct_function"></a>

STRUCT 建構函數會建立具有指定欄位值的結構。

當您需要在 SQL 查詢中以程式設計方式建立新的資料結構時，像 STRUCT 這樣的建構器函數非常有用。它們可讓您建置複雜的資料結構，例如結構或記錄，可用於進一步的資料處理或分析。

## 語法
<a name="struct_function-syntax"></a>

```
struct(col1, col2, col3, ...)
```

## 引數
<a name="struct_function-arguments"></a>

 *col1*   
欄名或任何有效表達式。

## 傳回值
<a name="struct_function-returns"></a>

STRUCT 函數會傳回符合 expr*1* 類型的欄位 1 結構。 **

如果引數是具名參考，則名稱會用來命名 欄位。否則，欄位會命名為 *colN*，其中 N 是結構中欄位的位置。

## 範例
<a name="struct_function-examples"></a>

下列範例會建立新的結構，其中包含三個欄位：第一個欄位會獲指派值 1。第二個欄位會獲指派值 2。第三個欄位會獲指派值 3。根據預設，產生的結構中的欄位會根據其在引數清單中的位置命名為 `col1``col2`、 `col3`和 。產生的結構接著會傳回為 SQL 陳述式的輸出。

```
SELECT struct(1, 2, 3);
 {"col1":1,"col2":2,"col3":3}
```