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:

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.

Ein Wert, der nicht leer ist, bedeutet LastEvaluatedKey nur, dass die vorherige Seite an einer Seitengrenze (1 MB Seitengrößenbeschränkung oder einem Limit Wert) Query aufgehört hat, nicht, dass unbedingt mehr übereinstimmende Elemente übrig bleiben. Insbesondere, wenn Sie a verwendenFilterExpression, Query wendet die Obergrenze von 1 MB pro Limit Seite auf die gelesenen Elemente an, bevor der Filter angewendet wird. Eine Seite kann also null übereinstimmende Elemente zurückgeben und trotzdem einen enthalten. LastEvaluatedKey Stellen Sie so lange Anfragen mit den zurückgegebenen Anfragen, LastEvaluatedKey bis die Antwort keine mehr enthält.

Sie können das verwenden AWS CLI , um dieses Verhalten zu sehen. Der AWS CLI sendet wiederholt Query Low-Level-Anfragen an DynamoDB, bis sie LastEvaluatedKey nicht mehr in den Ergebnissen enthalten sind. 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 das 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 sendet AWS CLI dann eine weitere Query Anfrage an DynamoDB. 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.

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.