As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
User-defined tipos (UDTs)
UDT — Um agrupamento de campos e tipos de dados que você pode usar para definir uma única coluna no Amazon Keyspaces. Todos os tipos de dados válidos para UDTs são tipos de dados do Cassandra compatíveis, incluindo coleções e outros UDTs que você já criou no mesmo espaço de chave. Para obter mais informações sobre os tipos de dados compatíveis do Cassandra, consulte Suporte ao tipo de dados do Cassandra.
user_defined_type::= udt_name udt_name::= [ keyspace_name '.' ] identifier
Declarações para tipos
CREATE TYPE
Use o CREATE TYPE declaração para criar um novo tipo.
Sintaxe
create_type_statement ::= CREATE TYPE [ IF NOT EXISTS ] udt_name '('field_definition ( ',' field_definition)* ')' field_definition::= identifier cql_type
Em que:
-
IF NOT EXISTSprevineCREATE TYPEde falhar se o tipo já existir. (Opcional) -
udt_nameé o nome totalmente qualificado do UDT em formato de tipo, por exemplomy_keyspace.my_type. Se você definir o espaço de teclas atual com oUSEdeclaração, você não precisa especificar o nome do keyspace. field_definitionconsiste em um nome e um tipo.
A tabela a seguir mostra exemplos de nomes UDT permitidos. A primeira coluna mostra como inserir o nome ao criar o tipo, a segunda coluna mostra como o Amazon Keyspaces formata o nome internamente. O Amazon Keyspaces espera o nome formatado para operações como GetType.
| Nome inserido | Nome formatado | Observação |
|---|---|---|
MY_UDT
|
my_udt |
Sem aspas duplas, o Amazon Keyspaces converte todos os caracteres maiúsculos em minúsculos. |
"MY_UDT"
|
MY_UDT |
Com aspas duplas, o Amazon Keyspaces respeita os caracteres maiúsculos e remove as aspas duplas do nome formatado. |
"1234"
|
1234 |
Com aspas duplas, o nome pode começar com um número, e o Amazon Keyspaces remove as aspas duplas do nome formatado. |
"Special_Ch@r@cters<>!!"
|
Special_Ch@r@cters<>!! |
Com aspas duplas, o nome pode conter caracteres especiais, e o Amazon Keyspaces remove as aspas duplas do nome formatado. |
"nested""""""quotes"
|
nested"""quotes |
O Amazon Keyspaces remove as aspas duplas externas e as aspas duplas de escape do nome formatado. |
Exemplos
CREATE TYPE my_keyspace.phone ( country_code int, number text );
Você pode aninhar UDTs se o UDT aninhado estiver congelado. Para obter mais informações sobre valores padrão e cotas para tipos, consulte Cotas de UDT e valores padrão do Amazon Keyspaces.
CREATE TYPE my_keyspace.user ( first_name text, last_name text, phones FROZEN<phone> );
Para obter mais exemplos de código que mostram como criar UDTs, consulte User-defined tipos (UDTs) no Amazon Keyspaces.
DROP TYPE
Use o DROP TYPE declaração para excluir um UDT. Você só pode excluir um tipo que não esteja sendo usado por outro tipo ou tabela.
Sintaxe
drop_type_statement ::= DROP TYPE [ IF EXISTS ] udt_name
Em que:
-
IF EXISTSprevineDROP TYPEde falhar se o tipo não existir. (Opcional) -
udt_nameé o nome totalmente qualificado do UDT em formato de tipo, por exemplomy_keyspace.my_type. Se você definir o espaço de teclas atual com oUSEdeclaração, você não precisa especificar o nome do keyspace.
Exemplo
DROP TYPE udt_name;