Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Fungsi konstruktor
<a name="sql-functions-constructor"></a>

Fungsi konstruktor SQL adalah fungsi yang digunakan untuk membuat struktur data baru, seperti array atau peta.

 Mereka mengambil beberapa nilai input dan mengembalikan objek struktur data baru. Fungsi konstruktor biasanya dinamai berdasarkan tipe data yang mereka buat, seperti ARRAY atau MAP.

Fungsi konstruktor berbeda dari fungsi skalar atau fungsi agregat, yang beroperasi pada data yang ada dan mengembalikan satu nilai. Fungsi konstruktor digunakan untuk membuat struktur data baru yang kemudian dapat digunakan dalam pemrosesan atau analisis data lebih lanjut.

AWS Clean Rooms mendukung fungsi konstruktor berikut:

**Topics**
+ [Fungsi konstruktor MAP](map_function.md)
+ [Fungsi konstruktor NAMED\$1STRUCT](named-struct_function.md)
+ [Fungsi konstruktor STRUCT](struct_function.md)

# Fungsi konstruktor MAP
<a name="map_function"></a>

Fungsi konstruktor MAP membuat peta dengan pasangan kunci/nilai yang diberikan.

Fungsi konstruktor seperti MAP berguna ketika Anda perlu membuat struktur data baru secara terprogram dalam kueri SQL Anda. Mereka memungkinkan Anda untuk membangun struktur data yang kompleks yang dapat digunakan dalam pemrosesan atau analisis data lebih lanjut. 

## Sintaks
<a name="map_function-syntax"></a>

```
map(key0, value0, key1, value1, ...)
```

## Pendapat
<a name="map_function-arguments"></a>

 *kunci0*   
Ekspresi dari jenis apa pun yang sebanding. Semua *key0* harus berbagi jenis yang paling tidak umum.

 *nilai0*   
Ekspresi jenis apa pun. Semua *ValueN* harus berbagi jenis yang paling tidak umum.

## Pengembalian
<a name="map_function-returns"></a>

*Fungsi MAP mengembalikan MAP dengan kunci yang diketik sebagai tipe *key0 yang paling tidak umum dan nilai yang diketik sebagai tipe value0* yang paling tidak umum.*

## Contoh
<a name="map_function-examples"></a>

Contoh berikut membuat peta baru dengan dua pasangan kunci-nilai: Kunci `1.0` dikaitkan dengan nilai. `'2'` Kuncinya `3.0` dikaitkan dengan nilai`'4'`. Peta yang dihasilkan kemudian dikembalikan sebagai output dari pernyataan SQL. 

```
SELECT map(1.0, '2', 3.0, '4');
 {1.0:"2",3.0:"4"}
```

# Fungsi konstruktor NAMED\$1STRUCT
<a name="named-struct_function"></a>

Fungsi konstruktor NAMED\$1STRUCT membuat struct dengan nama bidang dan nilai yang diberikan.

Fungsi konstruktor seperti NAMED\$1STRUCT berguna ketika Anda perlu membuat struktur data baru secara terprogram dalam kueri SQL Anda. Mereka memungkinkan Anda untuk membangun struktur data yang kompleks, seperti struct atau catatan, yang dapat digunakan dalam pemrosesan atau analisis data lebih lanjut.

## Sintaks
<a name="named-struct_function-syntax"></a>

```
named_struct(name1, val1, name2, val2, ...)
```

## Argumen
<a name="snamed-truct_function-arguments"></a>

 *nama1*   
Bidang penamaan literal STRING 1.

 *val1*   
Ekspresi dari jenis apa pun yang menentukan nilai untuk bidang 1.

## Pengembalian
<a name="named-struct_function-returns"></a>

*Fungsi NAMED\$1STRUCT mengembalikan struct dengan bidang 1 yang cocok dengan jenis val1.* 

## Contoh
<a name="named-struct_function-examples"></a>

Contoh berikut membuat struct baru dengan tiga bidang bernama: `"a"` Bidang diberi nilai`1`. `"b"`Bidang diberi nilai `2.` `"c"` Bidang diberi nilai`3`. Struct yang dihasilkan kemudian dikembalikan sebagai output dari pernyataan SQL. 

```
SELECT named_struct("a", 1, "b", 2, "c", 3);
 {"a":1,"b":2,"c":3}
```

# Fungsi konstruktor STRUCT
<a name="struct_function"></a>

Fungsi konstruktor STRUCT menciptakan struct dengan nilai bidang yang diberikan.

Fungsi konstruktor seperti STRUCT berguna ketika Anda perlu membuat struktur data baru secara terprogram dalam kueri SQL Anda. Mereka memungkinkan Anda untuk membangun struktur data yang kompleks, seperti struct atau catatan, yang dapat digunakan dalam pemrosesan atau analisis data lebih lanjut.

## Sintaks
<a name="struct_function-syntax"></a>

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

## Argumen
<a name="struct_function-arguments"></a>

 *col1*   
Nama kolom atau ekspresi yang valid.

## Pengembalian
<a name="struct_function-returns"></a>

*Fungsi STRUCT mengembalikan struct dengan *field1 yang cocok dengan tipe expr1*.*

Jika argumen diberi nama referensi, nama digunakan untuk memberi nama bidang. Jika tidak, bidang diberi nama *ColN*, di mana N adalah posisi bidang dalam struct.

## Contoh
<a name="struct_function-examples"></a>

Contoh berikut membuat struct baru dengan tiga bidang: Bidang pertama diberi nilai 1. Bidang kedua diberi nilai 2. Bidang ketiga diberi nilai 3. Secara default, bidang dalam struct yang dihasilkan diberi nama `col1``col2`,`col3`, dan, berdasarkan posisinya dalam daftar argumen. Struct yang dihasilkan kemudian dikembalikan sebagai output dari pernyataan SQL.

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