View a markdown version of this page

User-defined tipos (UDTs) - Amazon Keyspaces (para Apache Cassandra)

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 EXISTS previne CREATE TYPE de falhar se o tipo já existir. (Opcional)

  • udt_name é o nome totalmente qualificado do UDT em formato de tipo, por exemplo my_keyspace.my_type. Se você definir o espaço de teclas atual com o USE declaração, você não precisa especificar o nome do keyspace.

  • field_definition consiste 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 EXISTS previne DROP TYPE de falhar se o tipo não existir. (Opcional)

  • udt_name é o nome totalmente qualificado do UDT em formato de tipo, por exemplo my_keyspace.my_type. Se você definir o espaço de teclas atual com o USE declaração, você não precisa especificar o nome do keyspace.

Exemplo

DROP TYPE udt_name;