Schlüsselbedingungsausdrücke für die Abfrage-Operation

Wenn Sie Suchkriterien angeben, verwenden Sie einen Schlüsselbedingungsausdruck – eine Zeichenkette, die die Elemente bestimmt, die von der Tabelle oder dem Index gelesen werden müssen.

Sie müssen den Namen und Wert des Partitionsschlüssels als Gleichheitsbedingung angeben. Sie können kein Nicht-Schlüssel-Attribut in einem Schlüsselbedingungsausdruck verwenden.

Sie können optional eine zweite Bedingung für den Sortierschlüssel (sofern vorhanden) angeben. Die Bedingung des Sortierschlüssels muss einen der folgenden Vergleichsoperatoren verwenden:

• a = b – True, wenn das Attribut a gleich groß ist wie b

• a < b – True, wenn a kleiner als b ist

• a <= b – True, wenn a kleiner oder gleich b ist

• a > b – True, wenn a größer als b ist

• a >= b – True, wenn a größer oder gleich b ist

• a BETWEEN b AND c – True, wenn a größer als oder gleich b und c ist.

Folgende Funktionen werden ebenfalls unterstützt:

• begins_with (a, substr) – True, wenn der Wert von Attribut a mit einer bestimmten Teilkettenfolge beginnt.

Die folgenden AWS Command Line Interface (AWS CLI)-Beispiele veranschaulichen die Verwendung von Schlüsselbedingungsausdrücken. Diese Ausdrücke verwenden Platzhalter (z. B. :name und :sub) anstelle tatsächlicher Werte. Weitere Informationen finden Sie unter Ausdrucksattributnamen in DynamoDB und Ausdrucksattributwerte.

Beispiel

Fragen Sie die Thread-Tabelle nach einem bestimmten ForumName (Partitionsschlüssel) ab. Alle Elemente mit diesem ForumName-Wert werden von der Abfrage gelesen, da der Sortierschlüssel (Subject) in KeyConditionExpression nicht enthalten ist.

aws dynamodb query \
    --table-name Thread \
    --key-condition-expression "ForumName = :name" \
    --expression-attribute-values  '{":name":{"S":"Amazon DynamoDB"}}'

Beispiel

Fragen Sie die Thread-Tabelle nach einem bestimmten ForumName (Partitions-Schlüssel) ab, aber dieses Mal geben Sie nur die Elemente mit einem bestimmten Subject (Sortierschlüssel) zurück.

aws dynamodb query \
    --table-name Thread \
    --key-condition-expression "ForumName = :name and Subject = :sub" \
    --expression-attribute-values  file://values.json

Die Argumente für --expression-attribute-values werden in der Datei values.json gespeichert:

{
    ":name":{"S":"Amazon DynamoDB"},
    ":sub":{"S":"DynamoDB Thread 1"}
}

Beispiel

Fragen Sie die Reply-Tabelle nach einer bestimmten Id (Partitionsschlüssel) ab, aber geben Sie nur die Elemente zurück, deren ReplyDateTime (Sortierschlüssel) mit bestimmten Zeichen beginnt.

aws dynamodb query \
    --table-name Reply \
    --key-condition-expression "Id = :id and begins_with(ReplyDateTime, :dt)" \
    --expression-attribute-values  file://values.json

Die Argumente für --expression-attribute-values werden in der Datei values.json gespeichert:

{
    ":id":{"S":"Amazon DynamoDB#DynamoDB Thread 1"},
    ":dt":{"S":"2015-09"}
}

Sie können alle Attributnamen in einem Schlüsselbedingungsausdruck verwenden, sofern das erste Zeichen a-z oder A-Z ist und die übrigen Zeichen (ab dem zweiten Zeichen, sofern vorhanden) a-z, A-Z oder 0-9 sind. Darüber hinaus müssen die Attributnamen nicht DynamoDB-reservierte Wörter sein. (Eine vollständige Liste finden Sie unter Reservierte Wörter in DynamoDB.) Wenn ein Attributname diesen Anforderungen nicht entspricht, müssen Sie einen Ausdruckattributnamen als Platzhalter definieren. Weitere Informationen finden Sie unter Ausdrucksattributnamen in DynamoDB.

Für Objekte, die mit einem bestimmten Partitionsschlüsselwert versehen sind, speichert DynamoDB diese Elemente nah beieinander, sortiert nach Sortierschlüsselwerten. In einer Query-Operation ruft DynamoDB die Elemente sortiert ab und verarbeitet dann die Elemente mit KeyConditionExpression und allen FilterExpression, die möglicherweise vorhanden sind. Nur dann werden die Query-Ergebnisse an den Client zurückgesendet.

Die Query-Operation gibt immer eine Ergebnismenge zurück. Wenn keine übereinstimmenden Elemente gefunden werden, ist die Ergebnismenge leer.

Query-Ergebnisse werden immer von dem Sortierschlüsselwert sortiert. Wenn der Datentyp des Sortierschlüssels als Number festgelegt ist, werden die Ergebnisse in der numerischen Reihenfolge zurückgegeben. Andernfalls werden die Ergebnisse in der Reihenfolge der UTF-8-Bytes zurückgegeben. Standardmäßig ist die Sortierreihenfolge aufsteigend. Um die Reihenfolge umzukehren, setzen Sie den Parameter ScanIndexForward auf false.

Eine einzelne Query-Operation kann bis zu 1 MB an Daten abrufen. Diese Größenbeschränkung gilt, bevor ein FilterExpression oder ProjectionExpression den Ergebnissen zugeordnet wird. Wenn LastEvaluatedKey in der Antwort vorhanden ist und nicht Null ist, müssen Sie die Ergebnismenge wechseln (siehe Paginieren von Tabellenabfrageergebnissen).