Paginieren von Tabellenabfrageergebnissen in DynamoDB - 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.

Paginieren von Tabellenabfrageergebnissen in DynamoDB

DynamoDB paginiert die Ergebnisse von Query-Operationen. Bei der Paginierung werden die Query-Ergebnisse in „Seiten“ mit Daten von einer Größe von 1 MB (oder weniger) unterteilt. Eine Anwendung kann die erste Ergebnisseite verarbeiten, dann die zweite Seite und so weiter.

Eine einzelne Query gibt nur einen Ergebnissatz zurück, der innerhalb des Grenzwerts von 1 MB liegt. Um zu bestimmen, ob es mehr Ergebnisse gibt, und diese seitenweise abzurufen, sollte eine Anwendung die folgenden Schritte ausführen:

  1. Überprüfen Sie das Query-Low-Level-Ergebnis:

    • Wenn das Ergebnis ein LastEvaluatedKey-Element enthält und es ist ungleich null, fahren Sie mit Schritt 2 fort.

    • Wenn im Ergebnis kein LastEvaluatedKey vorhanden ist, sind keine Elemente mehr zum Abrufen vorhanden.

  2. Erstellen Sie eine Query mit demselben KeyConditionExpression. Verwenden Sie jedoch dieses Mal den LastEvaluatedKey-Wert aus Schritt 1 als ExclusiveStartKey-Parameter in der neuen Query-Anforderung.

  3. Führen Sie die neue Query-Anforderung aus.

  4. Fahren Sie mit Schritt 1 fort.

Mit anderen Worten: Der LastEvaluatedKey einer Query-Antwort sollte als ExclusiveStartKey für die nächste Query-Anforderung verwendet werden. Wenn in einer LastEvaluatedKey-Antwort kein Query-Element vorhanden ist, haben Sie die letzte Ergebnisseite abgerufen. Wenn LastEvaluatedKey nicht leer ist, bedeutet dies nicht notwendigerweise, dass die Ergebnismenge mehr Daten enthält. Die einzige Möglichkeit zu erfahren, dass das Ende des Ergebnissatzes erreicht wurde, ist, dass LastEvaluatedKey leer ist.

Sie können dieses Verhalten mit der AWS CLI anzeigen. AWS CLI sendet wiederholt Low-Level-Query-Anforderungen an DynamoDB, bis LastEvaluatedKey in den Ergebnissen nicht mehr vorhanden ist. Sehen Sie sich das folgende AWS CLI-Beispiel zum Abrufen von Filmtiteln aus einem bestimmten Jahr an.

aws dynamodb query --table-name Movies \
    --projection-expression "title" \
    --key-condition-expression "#y = :yyyy" \
    --expression-attribute-names '{"#y":"year"}' \
    --expression-attribute-values '{":yyyy":{"N":"1993"}}' \
    --page-size 5 \
    --debug

In der Regel verarbeitet AWS CLI die Paginierung automatisch. In diesem Beispiel begrenzt der AWS CLI --page-size-Parameter jedoch die Anzahl von Elementen pro Seite. Der --debug-Parameter gibt Low-Level-Informationen zu Anforderungen und Antworten aus.

Wenn Sie das Beispiel ausführen, sieht die erste Antwort von DynamoDB ungefähr folgendermaßen aus.

2017-07-07 11:13:15,603 - MainThread - botocore.parsers - DEBUG - Response body:
b'{"Count":5,"Items":[{"title":{"S":"A Bronx Tale"}},
{"title":{"S":"A Perfect World"}},{"title":{"S":"Addams Family Values"}},
{"title":{"S":"Alive"}},{"title":{"S":"Benny & Joon"}}],
"LastEvaluatedKey":{"year":{"N":"1993"},"title":{"S":"Benny & Joon"}},
"ScannedCount":5}'

Der LastEvaluatedKey in der Antwort gibt an, dass nicht alle Elemente abgerufen wurden. Die AWS CLI gibt anschließend eine weitere Query-Anforderung an DynamoDB aus. Dieses Anforderungs- und Antwortmuster wird bis zur endgültigen Antwort fortgesetzt.

2017-07-07 11:13:16,291 - MainThread - botocore.parsers - DEBUG - Response body:
b'{"Count":1,"Items":[{"title":{"S":"What\'s Eating Gilbert Grape"}}],"ScannedCount":1}'

Das Fehlen von LastEvaluatedKey gibt an, dass keine abrufbaren Elemente mehr vorhanden sind.

Anmerkung

Die AWS SDKs verarbeiten die DynamoDB-Low-Level-Antworten (einschließlich des Vorhandenseins oder Fehlens von LastEvaluatedKey) und stellen verschiedene Abstraktionen für die Paginierung von Query-Ergebnissen bereit. Beispielsweise stellt SDK für die Java-Dokumentschnittstelle java.util.Iterator-Unterstützung bereit, sodass Sie die Ergebnisse nacheinander durchgehen können.

Codebeispiele in verschiedenen Programmiersprachen finden Sie im Amazon-DynamoDB-Handbuch für erste Schritte und in der AWS SDK-Dokumentation für Ihre Sprache.

Sie können die Seitengröße auch reduzieren, indem Sie die Anzahl der Elemente in der Ergebnismenge mit dem Limit-Parameter derQuery-Operation verwenden.

Weitere Informationen zur Verwendung der Abfrage mit DynamoDB finden Sie unter Abfragen von Tabellen in DynamoDB.