Projektionsausdrücke

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 Angeben von Elementattributen bei der Verwendung von Ausdrücken:

• 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 RelatedItems und ProductReviews zurück.

  Title, Description, RelatedItems, ProductReviews

DynamoDB verfügt über eine Liste mit reservierten Wörtern und Sonderzeichen. Sie können jeden Attributnamen in einem Projektionsausdruck verwenden, sofern das erste Zeichen a-z oder A-Z und das zweite Zeichen (sofern vorhanden) a-z, A-Zoder 0-9 ist. Wenn ein Attributname diese Anforderung nicht erfüllt, müssen Sie einen Ausdrucksattributnamen als Platzhalter definieren. Eine vollständige Liste finden Sie hier: Reservierte Wörter in DynamoDB. Außerdem haben die folgenden Zeichen in DynamoDB eine besondere Bedeutung: # (Hash) und : (Doppelpunkt).

Auch wenn DynamoDB diese reservierten Wörter und Sonderzeichen für Namen zulässt, empfehlen wir, diese nicht zu verwenden, da Sie Platzhaltervariablen definieren müssen, sobald Sie diese Namen in einem Ausdruck verwenden. Weitere Informationen finden Sie unter Ausdrucksattributnamen in DynamoDB.

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 file://key.json \
    --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"
                }
            ]
        }
    }
}

Die Argumente für --key werden in der Datei key.json gespeichert:

{
    "Id": { "N": "123" }
}

Informationen zum Programmieren von sprachspezifischen Codebeispielen finden Sie unter Erste Schritte mit DynamoDB und den SDKs AWS.