

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

# Jenis yang ditentukan pengguna () UDTs
<a name="cql.ddl.type"></a>

*UDT* — Pengelompokan bidang dan tipe data yang dapat Anda gunakan untuk menentukan satu kolom di Amazon Keyspaces. Tipe data UDTs yang valid untuk semua tipe data Cassandra yang didukung, termasuk koleksi dan lainnya UDTs yang telah Anda buat di ruang kunci yang sama. Untuk informasi selengkapnya tentang tipe data Cassandra yang didukung, lihat. [Dukungan tipe data Cassandra](cassandra-apis.md#cassandra-data-type)

```
user_defined_type::= udt_name
udt_name::= [ keyspace_name '.' ] identifier
```

**Topics**
+ [BUAT TIPE](#cql.ddl.type.create)
+ [TIPE DROP](#cql.ddl.type.drop)

## BUAT TIPE
<a name="cql.ddl.type.create"></a>

Gunakan `CREATE TYPE` pernyataan untuk membuat tipe baru.

 **Sintaksis**

```
create_type_statement ::=  CREATE TYPE [ IF NOT EXISTS ] udt_name
    '('field_definition ( ',' field_definition)* ')'
            field_definition::= identifier cql_type
```

Di mana:
+ `IF NOT EXISTS``CREATE TYPE`mencegah kegagalan jika tipe sudah ada. (Opsional)
+ `udt_name`adalah nama UDT yang sepenuhnya memenuhi syarat dalam format tipe, misalnya. `my_keyspace.my_type` Jika Anda mendefinisikan keyspace saat ini dengan `USE` pernyataan, Anda tidak perlu menentukan nama keyspace.
+ `field_definition`terdiri dari nama dan tipe.

Tabel berikut menunjukkan contoh nama UDT yang diizinkan. Kolom pertama menunjukkan cara memasukkan nama saat Anda membuat jenis, kolom kedua menunjukkan bagaimana Amazon Keyspaces memformat nama secara internal. Amazon Keyspaces mengharapkan nama yang diformat untuk operasi seperti. `GetType`


| Nama yang dimasukkan | Nama yang diformat | Catatan | 
| --- | --- | --- | 
|  MY\$1UDT  | my\$1udt | Tanpa tanda kutip ganda, Amazon Keyspaces mengonversi semua karakter huruf besar menjadi huruf kecil. | 
|  "MY\$1UDT"  | MY\$1UDT | Dengan tanda kutip ganda, Amazon Keyspaces menghormati karakter huruf besar, dan menghapus tanda kutip ganda dari nama yang diformat. | 
|  "1234"  | 1234 | Dengan tanda kutip ganda, nama dapat dimulai dengan angka, dan Amazon Keyspaces menghapus tanda kutip ganda dari nama yang diformat. | 
|  "Special\$1Ch@r@cters<>\$1\$1"  | Special\$1Ch@r@cters<>\$1\$1 | Dengan tanda kutip ganda, nama dapat berisi karakter khusus, dan Amazon Keyspaces menghapus tanda kutip ganda dari nama yang diformat. | 
|  "nested""""""quotes"  | nested"""quotes | Amazon Keyspaces menghapus tanda kutip ganda luar dan tanda kutip ganda escape dari nama yang diformat. | 

**Contoh**

```
CREATE TYPE my_keyspace.phone (
    country_code int,
    number text
);
```

Anda dapat bersarang UDTs jika UDT bersarang dibekukan. Untuk informasi selengkapnya tentang nilai default dan kuota untuk tipe, lihat[Kuota UDT Amazon Keyspaces dan nilai default](quotas.md#udt-table).

```
CREATE TYPE my_keyspace.user (
    first_name text,
    last_name text,
    phones FROZEN<phone>
);
```

Untuk contoh kode lainnya yang menunjukkan cara membuat UDTs, lihat[Tipe yang ditentukan pengguna (UDTs) di Amazon Keyspaces](udts.md).

## TIPE DROP
<a name="cql.ddl.type.drop"></a>

Gunakan `DROP TYPE` pernyataan untuk menghapus UDT. Anda hanya dapat menghapus tipe yang tidak digunakan oleh tipe atau tabel lain.

 **Sintaksis**

```
drop_type_statement ::=  DROP TYPE [ IF EXISTS ] udt_name
```

Di mana:
+ `IF EXISTS``DROP TYPE`mencegah kegagalan jika tipenya tidak ada. (Opsional)
+ `udt_name`adalah nama UDT yang sepenuhnya memenuhi syarat dalam format tipe, misalnya. `my_keyspace.my_type` Jika Anda mendefinisikan keyspace saat ini dengan `USE` pernyataan, Anda tidak perlu menentukan nama keyspace.

**Contoh**

```
DROP TYPE udt_name;
```