View a markdown version of this page

User-defined jenis (UDT) - Amazon Keyspaces (untuk Apache Cassandra)

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

User-defined jenis (UDT)

UDD - Pengelompokan bidang dan tipe data yang dapat Anda gunakan untuk menentukan satu kolom di Amazon Keyspaces. Tipe data yang valid untuk UDT adalah semua tipe data Cassandra yang didukung, termasuk koleksi dan UDT lain yang telah Anda buat di ruang kunci yang sama. Untuk informasi selengkapnya tentang tipe data Cassandra yang didukung, lihat Dukungan tipe data Cassandra.

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

Pernyataan untuk jenis

BUAT JENIS

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 mencegah CREATE TYPE dari gagal jika tipenya sudah ada. (Opsional)

  • udt_name adalah nama yang sepenuhnya memenuhi syarat dari UDT dalam format tipe, misalnya my_keyspace.my_type. Jika Anda menentukan ruang tombol 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 tipe, 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_UDT my_udt Tanpa tanda kutip ganda, Amazon Keyspaces mengubah semua karakter huruf besar menjadi huruf kecil.
"MY_UDT" MY_UDT 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_Ch@r@cters<>!!" Special_Ch@r@cters<>!! 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 membuat sarang UDT jika UDT bersarang dibekukan. Untuk informasi selengkapnya tentang nilai default dan kuota untuk jenis, lihat Kuota UDT Amazon Keyspaces dan nilai default.

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

Untuk contoh kode lainnya yang menunjukkan cara membuat UDT, lihat User-defined jenis (UDT) di Amazon Keyspaces.

JENIS DROP

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

Sintaksis

drop_type_statement ::= DROP TYPE [ IF EXISTS ] udt_name

Di mana:

  • IF EXISTS mencegah DROP TYPE dari gagal jika tipenya tidak ada. (Opsional)

  • udt_name adalah nama yang sepenuhnya memenuhi syarat dari UDT dalam format tipe, misalnya my_keyspace.my_type. Jika Anda menentukan ruang tombol saat ini dengan USE pernyataan, Anda tidak perlu menentukan nama keyspace.

Contoh

DROP TYPE udt_name;