기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Keyspaces에서 사용자 정의 유형(UDTs) 보기
<a name="keyspaces-view-udt"></a>

단일 리전 키스페이스의 모든 UDTs를 보거나 나열하려면 CQL`system_schema_mcs.types`의 문을 사용하여 시스템 키스페이스의 테이블을 쿼리하거나 AWS CLI또는 콘솔에서 `get-type` 및 `list-type` 명령을 사용할 수 있습니다.

어느 옵션이든 IAM 보안 주체는 시스템 키스페이스에 대한 읽기 권한이 필요합니다. 자세한 내용은 [Amazon Keyspaces에서 사용자 정의 유형(UDTs)으로 작업하도록 권한 구성](configure-udt-permissions.md) 단원을 참조하십시오.

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

**Amazon Keyspaces 콘솔을 사용하여 사용자 정의 유형(UDT) 보기**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

1. 탐색 창의 **키스페이스를** 선택한 다음 목록에서 키스페이스를 선택합니다.

1. **UDTs** 탭을 선택하여 키스페이스의 모든 UDTs 목록을 검토합니다.

1. UDT 하나를 자세히 검토하려면 목록에서 **UDT**를 선택합니다.

1. **스키마** 탭에서 스키마를 검토할 수 있습니다. **에서 사용**됨 탭에서이 UDT가 테이블 또는 기타 UDTs. 테이블 또는 다른 UDTs에서 사용하지 않는 UDTs.

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

**CQL을 사용하여 단일 리전 키스페이스의 사용자 정의 유형(UDTs) 보기**

1. 지정된 키스페이스에서 사용할 수 있는 유형을 보려면 다음 문을 사용할 수 있습니다.

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

1. 특정 유형에 대한 세부 정보를 보려면 다음 문을 사용할 수 있습니다.

   ```
   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. 를 사용하여 계정에 있는 모든 UDTs를 나열할 수 있습니다`DESC TYPE`.

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

1. 를 사용하여 현재 선택한 키스페이스의 모든 UDTs를 나열할 수 있습니다`DESC TYPE`.

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

1. 다중 리전 키스페이스의 모든 UDTs를 나열하려면 `system_multiregion_info` 키스페이스`types`의 시스템 테이블을 쿼리하면 됩니다. 다음 쿼리는 이에 대한 예입니다.

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

   이 명령의 출력은 이와 비슷합니다.

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

**를 사용하여 사용자 정의 유형(UDTs) 보기 AWS CLI**

1. 키스페이스에서 사용 가능한 유형을 나열하려면 `list-types` 명령을 사용할 수 있습니다.

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

   해당 명령의 출력은이 예제와 비슷합니다.

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

1. 지정된 유형에 대한 세부 정보를 보려면 `get-type` 명령을 사용할 수 있습니다.

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

   이 명령의 출력은이 예제와 비슷합니다.

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

------