

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.

# Afficher les types définis par l'utilisateur (UDT) dans Amazon Keyspaces
<a name="keyspaces-view-udt"></a>

Pour afficher ou répertorier tous les UDT dans un espace de touches à région unique, vous pouvez interroger la table `system_schema_mcs.types` dans l'espace de touches du système à l'aide d'une instruction dans CQL, ou utiliser `list-type` les commandes `get-type` et avec le ou la AWS CLI console.

Quelle que soit l'option, le principal IAM a besoin d'autorisations de lecture sur l'espace de touches du système. Pour de plus amples informations, veuillez consulter [Configurer les autorisations pour travailler avec les types définis par l'utilisateur (UDT) dans Amazon Keyspaces](configure-udt-permissions.md).

------
#### [ Console ]

**Afficher les types définis par l'utilisateur (UDT) avec la console Amazon Keyspaces**

1. Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la à l'adresse. [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home)

1. Dans le volet de navigation, choisissez **Keyspaces**, puis choisissez un keyspace dans la liste.

1. Choisissez l'onglet **UDT** pour consulter la liste de tous les UDT dans le keyspace.

1. **Pour examiner un UDT en détail, choisissez-en un dans la liste.**

1. Dans l'onglet **Schéma**, vous pouvez consulter le schéma. Dans l'onglet **Utilisé dans**, vous pouvez voir si cet UDT est utilisé dans des tables ou dans d'autres UDT. Notez que vous ne pouvez supprimer que les UDT qui ne sont pas utilisés par des tables ou par d'autres UDT.

------
#### [ Cassandra Query Language (CQL) ]

**Afficher les types définis par l'utilisateur (UDT) d'un espace de touches à région unique avec CQL**

1. Pour voir les types disponibles dans un espace de touches donné, vous pouvez utiliser l'instruction suivante.

   ```
   SELECT type_name
   FROM system_schema_mcs.types
   WHERE keyspace_name = 'my_keyspace';
   ```

1. Pour afficher les détails relatifs à un type spécifique, vous pouvez utiliser l'instruction suivante.

   ```
   SELECT 
       keyspace_name,
       type_name,
       field_names,
       field_types,
       max_nesting_depth,
       last_modified_timestamp,
       status,
       direct_referring_tables,
       direct_parent_types
   FROM system_schema_mcs.types
   WHERE keyspace_name = 'my_keyspace' AND type_name = 'my_udt';
   ```

1. Vous pouvez répertorier tous les UDT présents dans le compte à l'aide `DESC TYPE` de. 

   ```
   DESC TYPES;
                               
    Keyspace my_keyspace
    ---------------------------
    my_udt1  my_udt2
                               
    Keyspace my_keyspace2
    ---------------------------
    my_udt1
   ```

1. Vous pouvez répertorier tous les UDT dans l'espace de touches actuellement sélectionné en utilisant. `DESC TYPE`

   ```
   USE my_keyspace;
   my_keyspace DESC TYPES;
                               
   my_udt1  my_udt2
   ```

1. Pour répertorier tous les UDT dans un espace de touches multirégional, vous pouvez interroger la table système `types` dans l'espace de touches. `system_multiregion_info` La requête suivante en est un exemple.

   ```
   SELECT keyspace_name, type_name, region, status FROM system_multiregion_info.types WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
   ```

   Le résultat de cette commande ressemble à ceci.

   ```
   keyspace_name     | table_name         | region                 | status
   mykeyspace        | mytable            | us-east-1              | ACTIVE
   mykeyspace        | mytable            | ap-southeast-1         | ACTIVE
   mykeyspace        | mytable            | eu-west-1              | ACTIVE
   ```

------
#### [ CLI ]

**Affichez les types définis par l'utilisateur (UDT) à l'aide du AWS CLI**

1. Pour répertorier les types disponibles dans un espace de touches, vous pouvez utiliser la `list-types` commande.

   ```
   aws keyspaces list-types
   --keyspace-name 'my_keyspace'
   ```

   Le résultat de cette commande ressemble à celui de cet exemple.

   ```
   {
       "types": [
           "my_udt",
           "parent_udt"
       ]
   }
   ```

1. Pour afficher les détails d'un type donné, vous pouvez utiliser la `get-type` commande.

   ```
   aws keyspaces get-type
   --type-name 'my_udt'
   --keyspace-name 'my_keyspace'
   ```

   Le résultat de cette commande ressemble à celui de cet exemple.

   ```
   {
       "keyspaceName": "my_keyspace",
       "typeName": "my_udt",
       "fieldDefinitions": [
           {
               "name": "a",
               "type": "int"
           },
           {
               "name": "b",
               "type": "text"
           }
       ],
       "lastModifiedTimestamp": 1721328225776,
       "maxNestingDepth": 3
       "status": "ACTIVE",
       "directReferringTables": [],
       "directParentTypes": [
           "parent_udt"
       ],
       "keyspaceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/"
   }
   ```

------