Projektionsausdrücke - Amazon-DynamoDB

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.

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

    Title, Description, RelatedItems, ProductReviews

Anmerkung

Der Ausdruck der Projektion 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. DynamoDB ermöglicht es Ihnen, diese reservierten Wörter und Sonderzeichen für Namen zu 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-z oder A-Z und 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"

Folgendes JSON würde für dieses Beispiel zurückgegeben werden.

{
    "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"
                }
            ]
        }
    }
}