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.

Namen von Ausdrucksattributen (Aliase) in DynamoDB

Ein Ausdrucksattributname ist ein Alias (oder Platzhalter), den Sie in einem Amazon DynamoDB DynamoDB-Ausdruck als Alternative zu einem tatsächlichen Attributnamen verwenden. Der Name eines Ausdrucksattributs muss mit einem Rautenzeichen (#) beginnen und von einem oder mehreren alphanumerischen Zeichen gefolgt werden. Der Unterstrich (_) ist ebenfalls zulässig.

Dieser Abschnitt beschreibt einige Situationen, in denen Sie Ausdrucksattributnamen verwenden müssen.

Reservierte Wörter

In einigen Fällen kann es erforderlich sein, einen Ausdruck mit einem Attributnamen zu erstellen, der mit einem für DynamoDB reservierten Wort in Konflikt steht. (Eine vollständige Liste der reservierten Wörter finden Sie unter Reservierte Wörter in DynamoDB.)

Das folgende Beispiel würde AWS CLI beispielsweise fehlschlagen, weil COMMENT es ein reserviertes Wort ist.

aws dynamodb get-item \
    --table-name ProductCatalog \
    --key '{"Id":{"N":"123"}}' \
    --projection-expression "Comment"

Um dieses Problem zu vermeiden, können Sie Comment durch einen Ausdrucksattributnamen wie #c ersetzen. Das Rautezeichen # ist erforderlich und gibt an, dass es sich um einen Platzhalter für einen Attributnamen handelt. Das AWS CLI Beispiel würde jetzt wie folgt aussehen.

aws dynamodb get-item \
     --table-name ProductCatalog \
     --key '{"Id":{"N":"123"}}' \
     --projection-expression "#c" \
     --expression-attribute-names '{"#c":"Comment"}'

Attributnamen mit Sonderzeichen

In einem Ausdruck wird ein Punkt (".") als Trennzeichen in einem Dokumentpfad interpretiert. DynamoDB bietet allerdings die Möglichkeit, ein Punktzeichen und andere Sonderzeichen wie einen Bindestrich („-“) in einem Attributnamen zu verwenden. Dies kann in einigen Fällen zweideutig sein. Angenommen, Sie möchten das Attribut Safety.Warning aus einem ProductCatalog-Element abrufen (siehe Verweisen auf Elementattribute bei der Verwendung von Ausdrücken in DynamoDB).

In diesem Beispiel gehen wir davon aus, dass Sie auf Safety.Warning mit einem Projektionsausdruck zugreifen möchten.

aws dynamodb get-item \
    --table-name ProductCatalog \
    --key '{"Id":{"N":"123"}}' \
    --projection-expression "Safety.Warning"

DynamoDB gibt statt der erwarteten Zeichenfolge („Always wear a helmet“) ein leeres Ergebnis zurück. Der Grund dafür ist, dass DynamoDB einen Punkt in einem Ausdruck als Dokumentpfadtrennzeichen interpretiert. In diesem Fall müssen Sie einen Ausdrucksattributnamen (z. B. #sw) als Ersatz für Safety.Warning definieren. Anschließend können Sie den folgenden Projektionsausdruck verwenden.

aws dynamodb get-item \
    --table-name ProductCatalog \
    --key '{"Id":{"N":"123"}}' \
    --projection-expression "#sw" \
    --expression-attribute-names '{"#sw":"Safety.Warning"}'

DynamoDB gibt dann das richtige Ergebnis zurück.

Verschachtelte Attribute

Angenommen, Sie möchten auf das verschachtelte Attribut ProductReviews.OneStar zugreifen. In einem Ausdrucksattributnamen behandelt DynamoDB den Punkt („.“) als ein Zeichen im Namen eines Attributs. Um auf das verschachtelte Attribut zu verweisen, definieren Sie einen Ausdrucksattributnamen für jedes Element im Dokumentpfad:

Anschließend können Sie #pr.#1star für den folgenden Projektionsausdruck verwenden.

aws dynamodb get-item \
    --table-name ProductCatalog \
    --key '{"Id":{"N":"123"}}' \
    --projection-expression "#pr.#1star"  \
    --expression-attribute-names '{"#pr":"ProductReviews", "#1star":"OneStar"}'

DynamoDB gibt dann das richtige Ergebnis zurück.

Wiederholtes Verweisen auf Attributnamen

Ausdrucksattributnamen sind hilfreich, wenn Sie sich wiederholt auf den gleichen Attributnamen beziehen müssen. Betrachten Sie z. B. den folgenden Ausdruck zum Abrufen einiger Rezensionen aus einem ProductCatalog-Element.

aws dynamodb get-item \
    --table-name ProductCatalog \
    --key '{"Id":{"N":"123"}}' \
    --projection-expression "ProductReviews.FiveStar, ProductReviews.ThreeStar, ProductReviews.OneStar"

Um den Ausdruck prägnanter zu gestalten, können Sie ProductReviews durch einen Ausdrucksattributnamen wie #pr ersetzen. Der geänderte Ausdruck sieht wie folgt aus:

aws dynamodb get-item \
    --table-name ProductCatalog \
    --key '{"Id":{"N":"123"}}' \
    --projection-expression "#pr.FiveStar, #pr.ThreeStar, #pr.OneStar" \
    --expression-attribute-names '{"#pr":"ProductReviews"}'

Wenn Sie einen Ausdrucksattributnamen definieren, müssen Sie ihn im gesamten Ausdruck einheitlich verwenden. Sie dürfen außerdem nicht das Symbol # weglassen.