Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Benutzerdefinierte Typen (UDTs) in Amazon Keyspaces
Ein benutzerdefinierter Typ (UDT) ist eine Gruppierung von Feldern und Datentypen, die Sie verwenden können, um eine einzelne Spalte in Amazon Keyspaces zu definieren. Gültige Datentypen für UDTs sind alle unterstützten Cassandra-Datentypen, einschließlich Sammlungen und anderer, UDTs die Sie bereits im selben Schlüsselraum erstellt haben. Weitere Informationen zu den unterstützten Cassandra-Datentypen finden Sie unter. [Unterstützung des Cassandra-Datentyps](cassandra-apis.md#cassandra-data-type)
Sie können benutzerdefinierte Typen (UDTs) in Amazon Keyspaces verwenden, um Daten effizienter zu organisieren. Sie können beispielsweise UDTs mit verschachtelten Sammlungen erstellen, wodurch Sie eine komplexere Datenmodellierung in Ihren Anwendungen implementieren können. Sie können auch das Schlüsselwort frozen für die Definition UDTs verwenden.
UDTs sind an einen Schlüsselraum gebunden und für alle Tabellen und UDTs im selben Schlüsselraum verfügbar. Sie können UDTs in Schlüsselräumen mit einer oder mehreren Regionen erstellen.
Sie können neue Tabellen erstellen oder bestehende Tabellen ändern und neue Spalten hinzufügen, die eine UDT verwenden. Um eine UDT mit einer verschachtelten UDT zu erstellen, muss die verschachtelte UDT eingefroren werden.
Informationen darüber, wie viele pro Schlüsselraum unterstützt UDTs werden, welche Ebenen der Verschachtelung unterstützt werden und welche anderen Standardwerte und Kontingente damit in Zusammenhang stehen, finden Sie unter. UDTs [Kontingente und Standardwerte für benutzerdefinierte Typen (UDTs) in Amazon Keyspaces](quotas.md#quotas-udts)
Hinweise zur Berechnung der codierten Größe von UDTs finden Sie unter. [Schätzen Sie die kodierte Größe von Datenwerten auf der Grundlage des Datentyps](calculating-row-size.md#calculating-row-size-data-types)
Weitere Hinweise zur CQL-Syntax finden Sie unter. [Benutzerdefinierte Typen () UDTs](cql.ddl.type.md)
Weitere Informationen zur Wiederherstellung UDTs zu einem bestimmten Zeitpunkt finden Sie unter. [PITR-Wiederherstellung von Tabellen mit benutzerdefinierten Typen () UDTs](PointInTimeRecovery_HowItWorks.md#howitworks_backup_udt)
**Topics**
+ [Konfigurieren von -Berechtigungen](configure-udt-permissions.md)
+ [Erstellen Sie ein UDT](keyspaces-create-udt.md)
+ [Ansicht UDTs](keyspaces-view-udt.md)
+ [Löschen Sie eine UDT](keyspaces-delete-udt.md)
# Berechtigungen für die Arbeit mit benutzerdefinierten Typen (UDTs) in Amazon Keyspaces konfigurieren
Wie Tabellen UDTs sind sie an einen bestimmten Schlüsselraum gebunden. Im Gegensatz zu Tabellen können Sie Berechtigungen für UDTs jedoch nicht direkt definieren. UDTs gelten nicht als Ressourcen in AWS und haben keine eindeutigen Kennungen im Format eines Amazon-Ressourcennamens (ARN). Um einem IAM-Prinzipal Berechtigungen zur Ausführung bestimmter Aktionen an einer UDT zu erteilen, müssen Sie stattdessen Berechtigungen für den Schlüsselraum definieren, an den die UDT gebunden ist. Für die Arbeit mit UDTs Schlüsselräumen mit mehreren Regionen sind zusätzliche Berechtigungen erforderlich.
Zum Erstellen, Anzeigen oder Löschen benötigt der Principal UDTs, z. B. ein IAM-Benutzer oder eine IAM-Rolle, dieselben Berechtigungen, die erforderlich sind, um dieselbe Aktion für den Schlüsselraum auszuführen, an den die UDT gebunden ist.
Weitere Informationen AWS Identity and Access Management zu finden Sie unter. [AWS Identity and Access Management für Amazon Keyspaces](security-iam.md)
## Berechtigungen zum Erstellen einer UDT
Um eine UDT in einem Schlüsselraum mit nur einer Region zu erstellen, benötigt der Principal `Create` Berechtigungen für den Schlüsselraum.
Die folgende IAM-Richtlinie ist ein Beispiel dafür.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "cassandra:Create",
"Resource": [
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/"
]
}
]
}
```
Um eine UDT in einem Schlüsselraum mit mehreren Regionen zu erstellen, benötigt der Principal zusätzlich zu den `Create` Berechtigungen auch Berechtigungen für die Aktion `CreateMultiRegionResource` für den angegebenen Schlüsselraum.
Die folgende IAM-Richtlinie ist ein Beispiel dafür.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [ "cassandra:Create", "cassandra:CreateMultiRegionResource" ],
"Resource": [
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/"
]
}
]
}
```
## Berechtigungen zum Anzeigen einer UDT
Zum Anzeigen oder Auflisten UDTs in einem Schlüsselraum mit nur einer Region benötigt der Principal Leseberechtigungen für den Systemschlüsselraum. Weitere Informationen finden Sie unter [`system_schema_mcs`](working-with-keyspaces.md#keyspace_system_schema_mcs).
Die folgende IAM-Richtlinie ist ein Beispiel dafür.
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":"cassandra:Select",
"Resource":[
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
]
}
]
}
```
Um einen Schlüsselraum mit mehreren Regionen anzuzeigen oder aufzulisten UDTs , benötigt der Principal Berechtigungen für die Aktionen `SELECT` und `SelectMultiRegionResource` für den Systemschlüsselraum. Weitere Informationen finden Sie unter [`system_multiregion_info`](working-with-keyspaces.md#keyspace_system_multiregion_info).
Die folgende IAM-Richtlinie ist ein Beispiel dafür.
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action": ["cassandra:Select", "cassandra:SelectMultiRegionResource"],
"Resource":[
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
]
}
]
}
```
## Berechtigungen zum Löschen einer UDT
Um eine UDT aus einem Schlüsselraum mit einer einzigen Region zu löschen, benötigt der Principal Berechtigungen für die `Drop` Aktion für den angegebenen Schlüsselraum.
Die folgende IAM-Richtlinie ist ein Beispiel dafür.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "cassandra:Drop",
"Resource": [
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/"
]
}
]
}
```
Um eine UDT aus einem Schlüsselraum mit mehreren Regionen zu löschen, benötigt der Principal Berechtigungen für die `Drop` Aktion und für die Aktion für den angegebenen `DropMultiRegionResource` Schlüsselraum.
Die folgende IAM-Richtlinie ist ein Beispiel dafür.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [ "cassandra:Drop", "cassandra:DropMultiRegionResource" ],
"Resource": [
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/"
]
}
]
}
```
# Erstellen Sie einen benutzerdefinierten Typ (UDT) in Amazon Keyspaces
Um eine UDT in einem Single-Region-Schlüsselraum zu erstellen, können Sie die `CREATE TYPE` Anweisung in CQL, den `create-type` Befehl mit der oder die Konsole verwenden. AWS CLI
UDT-Namen dürfen höchstens 48 Zeichen enthalten, müssen mit einem Buchstaben beginnen und dürfen nur alphanumerische Zeichen und Unterstriche enthalten. Amazon Keyspaces konvertiert Großbuchstaben automatisch in Kleinbuchstaben.
Alternativ können Sie einen UDT-Namen in doppelten Anführungszeichen angeben. Beim Angeben eines UDT-Namens in doppelten Anführungszeichen behält Amazon Keyspaces die Großschreibung bei und erlaubt Sonderzeichen.
Sie können beim Erstellen des UDT auch doppelte Anführungszeichen als Teil des Namens verwenden, Sie müssen jedoch jedes doppelte Anführungszeichen durch ein zusätzliches doppeltes Anführungszeichen maskieren.
Die folgende Tabelle zeigt Beispiele für zulässige UDT-Namen. Die erste Spalte zeigt, wie Sie den Namen eingeben, wenn Sie den Typ erstellen, die zweite Spalte zeigt, wie Amazon Keyspaces den Namen intern formatiert. Amazon Keyspaces erwartet den formatierten Namen für Operationen wie `GetType`.
| Eingegebener Name | Formatierter Name | Hinweis |
| --- | --- | --- |
| MY\$1UDT | my\$1udt | Ohne doppelte Anführungszeichen wandelt Amazon Keyspaces alle Großbuchstaben in Kleinbuchstaben um. |
| "MY\$1UDT" | MY\$1UDT | Bei doppelten Anführungszeichen berücksichtigt Amazon Keyspaces die Großbuchstaben und entfernt die doppelten Anführungszeichen aus dem formatierten Namen. |
| "1234" | 1234 | Bei doppelten Anführungszeichen kann der Name mit einer Zahl beginnen und Amazon Keyspaces entfernt die doppelten Anführungszeichen aus dem formatierten Namen. |
| "Special\$1Ch@r@cters<>\$1\$1" | Special\$1Ch@r@cters<>\$1\$1 | Bei doppelten Anführungszeichen kann der Name Sonderzeichen enthalten und Amazon Keyspaces entfernt die doppelten Anführungszeichen aus dem formatierten Namen. |
| "nested""""""quotes" | nested"""quotes | Amazon Keyspaces entfernt die äußeren doppelten Anführungszeichen und die doppelten Escape-Anführungszeichen aus dem formatierten Namen. |
------
#### [ Console ]
**Erstellen Sie einen benutzerdefinierten Typ (UDT) mit der Amazon Keyspaces-Konsole**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon Keyspaces-Konsole zu [https://console.aws.amazon.com/keyspaces/Hause](https://console.aws.amazon.com/keyspaces/home).
1. Wählen Sie im Navigationsbereich **Keyspaces** und dann einen Keyspace aus der Liste aus.
1. Wählen Sie die Registerkarte **UDTs** aus.
1. **Wählen Sie Create UDT**
1. Geben Sie unter **UDT-Details** den Namen für das UDT ein. Unter **UDT-Felder** definieren Sie das Schema der UDT.
1. Um den Vorgang abzuschließen, wählen Sie **Create UDT**.
------
#### [ Cassandra Query Language (CQL) ]
**Erstellen Sie einen benutzerdefinierten Typ (UDT) mit CQL**
In diesem Beispiel erstellen wir eine neue Version der Buchpreistabelle, die in verwendet wird. [Eine Tabelle in Amazon Keyspaces erstellen](getting-started.tables.md) In dieser Tabelle speichern wir alle Auszeichnungen, die ein Autor für ein bestimmtes Buch erhält. Wir erstellen zwei UDTs , die verschachtelt sind und Informationen über das Buch enthalten, das eine Auszeichnung erhalten hat.
1. Erstellen Sie einen Schlüsselraum mit dem Namen. `catalog`
```
CREATE KEYSPACE catalog WITH REPLICATION = {'class': 'SingleRegionStrategy'};
```
1. Erstellen Sie den ersten Typ. Dieser Typ speichert *BISAC-Codes*, die zur Definition des Genres von Büchern verwendet werden. Ein BISAC-Code besteht aus einem alphanumerischen Code und bis zu vier Themenbereichen.
```
CREATE TYPE catalog.bisac (
bisac_code text,
subject1 text,
subject2 text,
subject3 text,
subject4 text
);
```
1. Erstellen Sie einen zweiten Typ für Buchpreise, der die erste UDT verwendet. Das verschachtelte UDT muss eingefroren werden.
```
CREATE TYPE catalog.book (
award_title text,
book_title text,
publication_date date,
page_count int,
ISBN text,
genre FROZEN
);
```
1. Erstellt eine Tabelle mit einer Spalte für den Namen des Autors und verwendet einen Listentyp für die Buchpreise. Beachten Sie, dass das in der Liste verwendete UDT eingefroren werden muss.
```
CREATE TABLE catalog.authors (
author_name text PRIMARY KEY,
awards list >
);
```
1. In diesem Schritt fügen wir eine Datenzeile in die neue Tabelle ein.
```
CONSISTENCY LOCAL_QUORUM;
```
```
INSERT INTO catalog.authors (author_name, awards) VALUES (
'John Stiles' ,
[{
award_title: 'Wolf',
book_title: 'Yesterday',
publication_date: '2020-10-10',
page_count: 345,
ISBN: '026204630X',
genre: { bisac_code:'FIC014090', subject1: 'FICTION', subject2: 'Historical', subject3: '20th Century', subject4: 'Post-World War II'}
},
{award_title: 'Richard Roe',
book_title: 'Who ate the cake?',
publication_date: '2019-05-13',
page_count: 193,
ISBN: '9780262046305',
genre: { bisac_code:'FIC022130', subject1: 'FICTION', subject2: 'Mystery & Detective', subject3: 'Cozy', subject4: 'Culinary'}
}]
);
```
1. Im letzten Schritt lesen wir die Daten aus der Tabelle.
```
SELECT * FROM catalog.authors;
```
Die Ausgabe des Befehls sollte so aussehen.
```
author_name | awards
-------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
John Stiles | [{award_title: 'Wolf', book_title: 'Yesterday', publication_date: 2020-10-10, page_count: 345, isbn: '026204630X', genre: {bisac_code: 'FIC014090', subject1: 'FICTION', subject2: 'Historical', subject3: '20th Century', subject4: 'Post-World War II'}}, {award_title: 'Richard Roe', book_title: 'Who ate the cake?', publication_date: 2019-05-13, page_count: 193, isbn: '9780262046305', genre: {bisac_code: 'FIC022130', subject1: 'FICTION', subject2: 'Mystery & Detective', subject3: 'Cozy', subject4: 'Culinary'}}]
(1 rows)
```
Weitere Hinweise zur CQL-Syntax finden Sie unter[CREATE TYPE](cql.ddl.type.md#cql.ddl.type.create).
------
#### [ CLI ]
**Erstellen Sie einen benutzerdefinierten Typ (UDT) mit dem AWS CLI**
1. Um einen Typ zu erstellen, können Sie die folgende Syntax verwenden.
```
aws keyspaces create-type
--keyspace-name 'my_keyspace'
--type-name 'my_udt'
--field-definitions
'[
{"name" : "field1", "type" : "int"},
{"name" : "field2", "type" : "text"}
]'
```
1. Die Ausgabe dieses Befehls sieht ähnlich aus wie in diesem Beispiel. Beachten Sie, dass der formatierte Name der UDT `typeName` zurückgegeben wird.
```
{
"keyspaceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/",
"typeName": "my_udt"
}
```
------
# Benutzerdefinierte Typen (UDTs) in Amazon Keyspaces anzeigen
Um alles UDTs in einem Schlüsselraum mit einer Region anzuzeigen oder aufzulisten, können Sie die Tabelle `system_schema_mcs.types` im Systemschlüsselraum mit einer Anweisung in CQL abfragen oder die `list-type` Befehle `get-type` und mit der oder der AWS CLI Konsole verwenden.
Für beide Optionen benötigt der IAM-Principal Leseberechtigungen für den Systemschlüsselraum. Weitere Informationen finden Sie unter [Berechtigungen für die Arbeit mit benutzerdefinierten Typen (UDTs) in Amazon Keyspaces konfigurieren](configure-udt-permissions.md).
------
#### [ Console ]
**Benutzerdefinierte Typen (UDT) mit der Amazon Keyspaces-Konsole anzeigen**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon Keyspaces-Konsole zu [https://console.aws.amazon.com/keyspaces/Hause](https://console.aws.amazon.com/keyspaces/home).
1. Wählen Sie im Navigationsbereich **Keyspaces** und dann einen Keyspace aus der Liste aus.
1. Wählen Sie die **UDTs**Registerkarte aus, um die Liste aller Einträge UDTs im Schlüsselraum zu überprüfen.
1. Um eine UDT im Detail zu überprüfen, wählen Sie eine **UDT aus der Liste** aus.
1. Auf der Registerkarte **Schema** können Sie das Schema überprüfen. Auf der Registerkarte **Verwendet in** können Sie sehen, ob diese UDT in Tabellen oder anderen UDTs verwendet wird. Beachten Sie, dass Sie nur diejenigen löschen können UDTs , die weder von Tabellen noch von anderen UDTs verwendet werden.
------
#### [ Cassandra Query Language (CQL) ]
**Zeigen Sie die benutzerdefinierten Typen (UDTs) eines Schlüsselraums mit einer einzelnen Region mit CQL an**
1. Um die Typen zu sehen, die in einem bestimmten Schlüsselraum verfügbar sind, können Sie die folgende Anweisung verwenden.
```
SELECT type_name
FROM system_schema_mcs.types
WHERE keyspace_name = 'my_keyspace';
```
1. Um die Details zu einem bestimmten Typ anzuzeigen, können Sie die folgende Anweisung verwenden.
```
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. Sie können alles UDTs , was in dem Konto vorhanden ist, mit auflisten`DESC TYPE`.
```
DESC TYPES;
Keyspace my_keyspace
---------------------------
my_udt1 my_udt2
Keyspace my_keyspace2
---------------------------
my_udt1
```
1. Sie können alle UDTs im aktuell ausgewählten Schlüsselraum auflisten mit`DESC TYPE`.
```
USE my_keyspace;
my_keyspace DESC TYPES;
my_udt1 my_udt2
```
1. Um alle UDTs in einem Schlüsselraum mit mehreren Regionen aufzulisten, können Sie die Systemtabelle `types` im Schlüsselraum abfragen. `system_multiregion_info` Die folgende Abfrage ist ein Beispiel dafür.
```
SELECT keyspace_name, type_name, region, status FROM system_multiregion_info.types WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
Die Ausgabe dieses Befehls sieht in etwa so aus.
```
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 ]
**Zeigen Sie benutzerdefinierte Typen (UDTs) mit dem AWS CLI**
1. Um die in einem Schlüsselraum verfügbaren Typen aufzulisten, können Sie den `list-types` Befehl verwenden.
```
aws keyspaces list-types
--keyspace-name 'my_keyspace'
```
Die Ausgabe dieses Befehls sieht ähnlich aus wie in diesem Beispiel.
```
{
"types": [
"my_udt",
"parent_udt"
]
}
```
1. Um die Details zu einem bestimmten Typ anzuzeigen, können Sie den `get-type` Befehl verwenden.
```
aws keyspaces get-type
--type-name 'my_udt'
--keyspace-name 'my_keyspace'
```
Die Ausgabe dieses Befehls sieht ähnlich aus wie in diesem Beispiel.
```
{
"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/"
}
```
------
# Löschen Sie einen benutzerdefinierten Typ (UDT) in Amazon Keyspaces
Um eine UDT in einem Schlüsselraum zu löschen, können Sie die `DROP TYPE` Anweisung in CQL, den `delete-type` Befehl mit der oder die AWS CLI Konsole verwenden.
------
#### [ Console ]
**Löschen Sie einen benutzerdefinierten Typ (UDT) mit der Amazon Keyspaces-Konsole**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon Keyspaces-Konsole zu [https://console.aws.amazon.com/keyspaces/Hause](https://console.aws.amazon.com/keyspaces/home).
1. Wählen Sie im Navigationsbereich **Keyspaces** und dann einen Keyspace aus der Liste aus.
1. Wählen Sie die Registerkarte **UDTs** aus.
1. Wählen Sie das UDT aus, das Sie löschen möchten. Unter Benutzt **in** können Sie überprüfen, ob der Typ, den Sie löschen möchten, derzeit nicht von einer Tabelle oder einem anderen UDT verwendet wird.
1. Wählen Sie oberhalb der **Zusammenfassung** die Option **Löschen** aus.
1. Geben Sie den Text `Delete` in das daraufhin angezeigte Dialogfeld ein und wählen Sie „**UDT löschen**“.
------
#### [ Cassandra Query Language (CQL) ]
**Löschen Sie einen benutzerdefinierten Typ (UDT) mit CQL**
+ Um einen Typ zu löschen, können Sie die folgende Anweisung verwenden.
```
DROP TYPE my_keyspace.my_udt;
```
Weitere Hinweise zur CQL-Syntax finden Sie unter[DROP TYPE](cql.ddl.type.md#cql.ddl.type.drop).
------
#### [ CLI ]
**Löschen Sie einen benutzerdefinierten Typ (UDT) mit dem AWS CLI**
1. Um einen Typ zu löschen, können Sie den folgenden Befehl verwenden.
```
aws keyspaces delete-type
--keyspace-name 'my_keyspace'
--type-name 'my_udt'
```
1. Die Ausgabe des Befehls sieht ähnlich aus wie in diesem Beispiel.
```
{
"keyspaceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/",
"typeName": "my_udt"
}
```
------