Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
User-defined tipos (UDT)
UDT — Un grupo de campos y tipos de datos que puede usar para definir una sola columna en Amazon Keyspaces. Los tipos de datos válidos para las UDT son todos los tipos de datos de Cassandra compatibles, incluidas las colecciones y otras UDT que ya haya creado en el mismo espacio de claves. Para obtener más información sobre los tipos de datos de Cassandra compatibles, consulta Compatibilidad con tipos de datos de Cassandra.
user_defined_type::= udt_name udt_name::= [ keyspace_name '.' ] identifier
Declaraciones para tipos
CREATE TYPE
Utilice el CREATE TYPE sentencia para crear un tipo nuevo.
Sintaxis
create_type_statement ::= CREATE TYPE [ IF NOT EXISTS ] udt_name '('field_definition ( ',' field_definition)* ')' field_definition::= identifier cql_type
Donde:
-
IF NOT EXISTSprevieneCREATE TYPEno falle si el tipo ya existe. (Opcional) -
udt_namees el nombre completo de la UDT en formato de tipo, por ejemplomy_keyspace.my_type. Si define el espacio de claves actual con elUSEsentencia, no es necesario especificar el nombre del espacio de claves. field_definitionse compone de un nombre y un tipo.
En la tabla siguiente se muestran ejemplos de nombres UDT permitidos. La primera columna muestra cómo introducir el nombre al crear el tipo, y la segunda muestra cómo Amazon Keyspaces formatea el nombre internamente. Amazon Keyspaces espera el nombre formateado para operaciones como GetType.
| Nombre introducido | Nombre formateado | Nota |
|---|---|---|
MY_UDT
|
my_udt |
Sin comillas dobles, Amazon Keyspaces convierte todos los caracteres en mayúsculas en minúsculas. |
"MY_UDT"
|
MY_UDT |
Con las comillas dobles, Amazon Keyspaces respeta los caracteres en mayúscula y elimina las comillas dobles del nombre formateado. |
"1234"
|
1234 |
Con las comillas dobles, el nombre puede empezar por un número y Amazon Keyspaces elimina las comillas dobles del nombre formateado. |
"Special_Ch@r@cters<>!!"
|
Special_Ch@r@cters<>!! |
Con las comillas dobles, el nombre puede contener caracteres especiales y Amazon Keyspaces elimina las comillas dobles del nombre formateado. |
"nested""""""quotes"
|
nested"""quotes |
Amazon Keyspaces elimina las comillas dobles exteriores y las comillas dobles de escape del nombre formateado. |
Ejemplos
CREATE TYPE my_keyspace.phone ( country_code int, number text );
Puede anidar las UDT si la UDT anidada está congelada. Para obtener más información sobre los valores predeterminados y las cuotas de los tipos, consulta Cuotas de UDT y valores predeterminados de Amazon Keyspaces.
CREATE TYPE my_keyspace.user ( first_name text, last_name text, phones FROZEN<phone> );
Para ver más ejemplos de código que muestran cómo crear UDT, consulta User-defined tipos (UDT) en Amazon Keyspaces.
DROP TYPE
Usa el DROP TYPE sentencia para eliminar una UDT. Solo puedes eliminar un tipo que no esté siendo utilizado por otro tipo o tabla.
Sintaxis
drop_type_statement ::= DROP TYPE [ IF EXISTS ] udt_name
Donde:
-
IF EXISTSprevieneDROP TYPEno falle si el tipo no existe. (Opcional) -
udt_namees el nombre completo de la UDT en formato de tipo, por ejemplomy_keyspace.my_type. Si define el espacio de claves actual con elUSEsentencia, no es necesario especificar el nombre del espacio de claves.
Ejemplo
DROP TYPE udt_name;