View a markdown version of this page

User-defined types (UDT) - Amazon Keyspaces (pour Apache Cassandra)

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.

User-defined types (UDT)

UDT — Regroupement de champs et de types de données que vous pouvez utiliser pour définir une colonne unique dans Amazon Keyspaces. Les types de données valides pour les UDT sont tous les types de données Cassandra pris en charge, y compris les collections et autres UDT que vous avez déjà créés dans le même espace de touches. Pour plus d'informations sur les types de données Cassandra pris en charge, consultez Support des types de données Cassandra.

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

Déclarations pour les types

CREATE TYPE

Utilisez le CREATE TYPE instruction 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 EXISTS empêche CREATE TYPE d'échec si le type existe déjà. (Facultatif)

  • udt_name est le nom complet de l'UDT au format de type, par exemple my_keyspace.my_type. Si vous définissez l'espace clé actuel avec USE instruction, vous n'avez pas besoin de spécifier le nom de l'espace clé.

  • field_definition se 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 indique 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 doubles, Amazon Keyspaces convertit tous les caractères majuscules en minuscules.
"MY_UDT" MY_UDT Avec les guillemets doubles, Amazon Keyspaces respecte les majuscules et supprime les guillemets doubles du nom mis en forme.
"1234" 1234 Avec des guillemets doubles, le nom peut commencer par un chiffre, et Amazon Keyspaces supprime les guillemets doubles du nom mis en forme.
"Special_Ch@r@cters<>!!" Special_Ch@r@cters<>!! Avec les guillemets doubles, le nom peut contenir des caractères spéciaux, et Amazon Keyspaces supprime les guillemets doubles du nom mis en forme.
"nested""""""quotes" nested"""quotes Amazon Keyspaces supprime les guillemets extérieurs et les guillemets doubles d'échappement du nom mis en forme.

Exemples

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

Vous pouvez imbriquer des UDT si l'UDT imbriqué est gelé. Pour plus d'informations sur les valeurs par défaut et les quotas pour les types, voir Quotas UDT et valeurs par défaut d'Amazon Keyspaces.

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

Pour plus d'exemples de code qui montrent comment créer des UDT, voir User-defined types (UDT) dans Amazon Keyspaces.

DROP TYPE

Utilisez le DROP TYPE instruction pour supprimer un UDT. Vous pouvez uniquement supprimer 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 EXISTS empêche DROP TYPE d'échouer si le type n'existe pas. (Facultatif)

  • udt_name est le nom complet de l'UDT au format de type, par exemple my_keyspace.my_type. Si vous définissez l'espace clé actuel avec USE instruction, vous n'avez pas besoin de spécifier le nom de l'espace clé.

Exemple

DROP TYPE udt_name;