Paginieren von Tabellenabfrageergebnissen

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 neue Query-Anforderung mit den gleichen Parametern wie bei der vorherigen Anforderung. 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 die verwenden AWS CLI , um dieses Verhalten anzuzeigen. Der AWS CLI sendet wiederholt Low-Level-QueryAnforderungen an DynamoDB, bis nicht mehr in den Ergebnissen vorhanden LastEvaluatedKey ist. Betrachten Sie das folgende AWS CLI Beispiel, das Filmtitel aus einem bestimmten Jahr abruft.

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

Normalerweise AWS CLI verarbeitet die die Paginierung automatisch. In diesem Beispiel begrenzt der AWS CLI --page-size Parameter jedoch die Anzahl der Elemente 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. Der gibt AWS CLI dann 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 bieten verschiedene Abstraktionen für die Paginierung von Query Ergebnissen. 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 Abfrageoperationen in DynamoDB.