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.
Um Daten aus einer Tabelle zu lesen, verwenden sie Operationen wie GetItem, Query oder Scan. Amazon DynamoDB gibt standardmäßig alle Elementattribute zurück. Verwenden Sie einen Projektionsausdruck, um nur einige und nicht alle Attribute abzurufen.
Ein Projektionsausdruck ist eine Zeichenfolge, mit der die gewünschten Attribute identifiziert werden. Zum Abrufen eines einzelnen Attributs geben Sie seinen Namen an. Für mehrere Attribute müssen die Namen durch Kommas getrennt werden.
Es folgen einige Beispiele für Projektionsausdrücke, basierend auf dem ProductCatalog-Element von Verweisen auf Elementattribute bei der Verwendung von Ausdrücken in DynamoDB:
-
Ein einzelnes Attribut auf oberster Ebene:
Title -
Drei Attribute auf oberster Ebene. DynamoDB ruft die gesamte
Color-Einstellung.Title, Price, Color -
Vier Attribute auf oberster Ebene. DynamoDB gibt den gesamten Inhalt von
RelatedItemsundProductReviewszurück.Title, Description, RelatedItems, ProductReviews
Anmerkung
Der Projektionsausdruck hat keine Auswirkung auf den bereitgestellten Durchsatzverbrauch. DynamoDB bestimmt die verbrauchten Kapazitätseinheiten anhand der Elementgröße und nicht anhand der Datenmenge, die an eine Anwendung zurückgegeben wird.
Reservierte Wörter und Sonderzeichen
DynamoDB hat reservierte Wörter und Sonderzeichen. In DynamoDB können Sie diese reservierten Wörter und Sonderzeichen für Namen verwenden. Wir empfehlen jedoch, dies zu vermeiden, da Sie Aliase für sie verwenden müssen, wenn Sie diese Namen in einem Ausdruck verwenden. Eine vollständige Liste finden Sie hier: Reservierte Wörter in DynamoDB.
In folgenden Fällen müssen Sie Ausdrucksattributnamen anstelle des eigentlichen Namens verwenden:
-
Der Attributname steht auf der Liste der reservierten Wörter in DynamoDB.
-
Der Attributname erfüllt nicht die Anforderung, dass das erste Zeichen
a-zoderA-Zund das zweite Zeichen (falls vorhanden)a-ZA-Z, oder ist.0-9 -
Der Attributname enthält ein # (Hash) oder: (Doppelpunkt).
Das folgende AWS CLI Beispiel zeigt, wie ein Projektionsausdruck mit einer GetItem Operation verwendet wird. Dieser Projektionsausdruck ruft ein skalares Attribut auf oberster Ebene (Description), das erste Element in einer Liste (RelatedItems[0]) und eine Liste, die innerhalb einer Zuordnung verschachtelt ist (ProductReviews.FiveStar), ab.
aws dynamodb get-item \ --table-name ProductCatalog \ --key '"Id": { "N": "123" } \ --projection-expression "Description, RelatedItems[0], ProductReviews.FiveStar"
In diesem Beispiel wird der folgende JSON zurückgegeben.
{
"Item": {
"Description": {
"S": "123 description"
},
"ProductReviews": {
"M": {
"FiveStar": {
"L": [
{
"S": "Excellent! Can't recommend it highly enough! Buy it!"
},
{
"S": "Do yourself a favor and buy this."
}
]
}
}
},
"RelatedItems": {
"L": [
{
"N": "341"
}
]
}
}
}