Types définis par l'utilisateur () UDTs - Amazon Keyspaces (pour Apache Cassandra)
CRÉER UN TYPETYPE DE CHUTE

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Types définis par l'utilisateur () UDTs

UDT : regroupement de champs et de types de données que vous pouvez utiliser pour définir une seule colonne dans Amazon Keyspaces. Les types de données valides pour UDTs sont tous les types de données Cassandra pris en charge, y compris les collections et les autres UDTs que vous avez déjà créées dans le même keyspace. Pour plus d'informations sur les types de données Cassandra pris en charge, consultezSupport des types de données Cassandra.

user_defined_type::= udt_name
udt_name::= [ keyspace_name '.' ] identifier
Déclarations pour les types

CRÉER UN TYPE

Utilisez l'CREATE TYPEinstruction pour créer un nouveau type.

Syntaxe

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

Où :

  • IF NOT EXISTSCREATE TYPEempêche l'échec si le type existe déjà. (Facultatif)

  • udt_nameest le nom complet de l'UDT au format type, par exemple. my_keyspace.my_type Si vous définissez le keyspace actuel avec l'USEinstruction, il n'est pas nécessaire de spécifier le nom du keyspace.

  • field_definitionse compose d'un nom et d'un type.

Le tableau suivant présente des exemples de noms UDT autorisés. La première colonne indique comment saisir le nom lorsque vous créez le type, la deuxième colonne montre comment Amazon Keyspaces met en forme le nom en interne. Amazon Keyspaces attend le nom formaté pour des opérations telles que. GetType

Nom saisi Nom formaté Remarque
MY_UDT my_udt Sans guillemets, Amazon Keyspaces convertit tous les caractères majuscules en minuscules.
"MY_UDT" MY_UDT Avec les guillemets, Amazon Keyspaces respecte les majuscules et supprime les guillemets du nom formaté.
"1234" 1234 Avec des guillemets doubles, le nom peut commencer par un chiffre, et Amazon Keyspaces supprime les guillemets du nom formaté.
"Special_Ch@r@cters<>!!" Special_Ch@r@cters<>!! Avec des guillemets, le nom peut contenir des caractères spéciaux, et Amazon Keyspaces supprime les guillemets du nom formaté.
"nested""""""quotes" nested"""quotes Amazon Keyspaces supprime les guillemets extérieurs et les guillemets d'échappement du nom formaté.

Exemples

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

Vous pouvez nicher UDTs si l'UDT imbriqué est gelé. Pour plus d'informations sur les valeurs par défaut et les quotas pour les types, consultezQuotas UDT et valeurs par défaut d'Amazon Keyspaces.

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

Pour d'autres exemples de code montrant comment créer UDTs, consultezTypes définis par l'utilisateur (UDTs) dans Amazon Keyspaces.

TYPE DE CHUTE

Utilisez l'DROP TYPEinstruction pour supprimer un UDT. Vous ne pouvez supprimer qu'un type qui n'est pas utilisé par un autre type ou une autre table.

Syntaxe

drop_type_statement ::=  DROP TYPE [ IF EXISTS ] udt_name

Où :

  • IF EXISTSDROP TYPEempêche l'échec si le type n'existe pas. (Facultatif)

  • udt_nameest le nom complet de l'UDT au format type, par exemple. my_keyspace.my_type Si vous définissez le keyspace actuel avec l'USEinstruction, il n'est pas nécessaire de spécifier le nom du keyspace.

Exemple

DROP TYPE udt_name;