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á.

# Visualize tipos definidos pelo usuário (UDTs) no Amazon Keyspaces
<a name="keyspaces-view-udt"></a>

Para visualizar ou listar tudo UDTs em um espaço de chave de região única, você pode consultar a tabela `system_schema_mcs.types` no espaço de chaves do sistema usando uma instrução em CQL ou usar os `list-type` comandos `get-type` e com o console AWS CLI.

Para qualquer uma das opções, o diretor do IAM precisa de permissões de leitura no espaço de chaves do sistema. Para obter mais informações, consulte [Configure permissões para trabalhar com tipos definidos pelo usuário (UDTs) no Amazon Keyspaces](configure-udt-permissions.md).

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

**Visualize tipos definidos pelo usuário (UDT) com o console Amazon Keyspaces**

1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)

1. No painel de navegação, escolha **Keyspaces** e, em seguida, escolha um keyspace na lista.

1. Escolha a **UDTs**guia para revisar a lista de todos UDTs no espaço de teclas.

1. Para revisar um UDT em detalhes, escolha um **UDT** na lista.

1. Na guia **Esquema**, você pode revisar o esquema. Na guia **Usado em**, você pode ver se esse UDT é usado em tabelas ou outras UDTs. Observe que você só pode excluir os UDTs que não estão sendo usados por tabelas ou outras UDTs.

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

**Visualize os tipos definidos pelo usuário (UDTs) de um keyspace de região única com CQL**

1. Para ver os tipos que estão disponíveis em um determinado espaço de teclas, você pode usar a seguinte declaração.

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

1. Para ver os detalhes sobre um tipo específico, você pode usar a seguinte declaração.

   ```
   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. Você pode listar tudo o UDTs que existe na conta usando`DESC TYPE`. 

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

1. Você pode listar tudo UDTs no espaço de teclas selecionado atualmente usando`DESC TYPE`.

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

1. Para listar tudo UDTs em um espaço de chave multirregional, você pode consultar a tabela do sistema `types` no `system_multiregion_info` espaço de chaves. A consulta a seguir é um exemplo disso.

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

   A saída desse comando é semelhante a essa.

   ```
   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 ]

**Exibir tipos definidos pelo usuário (UDTs) com o AWS CLI**

1. Para listar os tipos disponíveis em um keyspace, você pode usar o `list-types` comando.

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

   A saída desse comando é semelhante a este exemplo.

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

1. Para ver os detalhes sobre um determinado tipo, você pode usar o `get-type` comando.

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

   A saída desse comando é semelhante a este exemplo.

   ```
   {
       "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/"
   }
   ```

------