翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

1. ナビゲーションペインで、**キースペース**を選択し、リストからキースペースを選択します。

1. **UDTs** タブを選択して、キースペース内のすべての UDTsのリストを確認します。

1. 1 つの UDT の詳細を確認するには、リストから **UDT** を選択します。

1. **スキーマ**タブで、スキーマを確認できます。**「Use in**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/"
   }
   ```

------