Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Analyser **Important** ***Cette section fait référence à l'API version 2011-12-05 qui est obsolète et ne doit pas être utilisée pour de nouvelles applications.*** **Pour une documentation sur l'API de bas niveau actuelle, consultez la [Référence d'API Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).** ## Description L'opération `Scan` renvoie un ou plusieurs éléments et leurs attributs en effectuant une analyse complète d'une table. Fournissez un `ScanFilter` pour obtenir des résultats plus spécifiques. **Note** Si le nombre total d'éléments analysés dépasse la limite de 1 Mo, l'analyse s'arrête et les résultats sont renvoyés à l'utilisateur avec une `LastEvaluatedKey` pour continuer l'analyse dans une opération subséquente. Les résultats incluent également le nombre d'éléments dépassant la limite. Il peut arriver qu'une analyse constate l'absence de données de table répondant aux critères de filtre. L'ensemble de résultats est éventuellement cohérent. ## Requêtes ### Syntaxe ``` // This header is abbreviated. // For a sample of a complete header, see API de bas niveau de DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.Scan content-type: application/x-amz-json-1.0 {"TableName":"Table1", "Limit": 2, "ScanFilter":{ "AttributeName1":{"AttributeValueList":[{"S":"AttributeValue"}],"ComparisonOperator":"EQ"} }, "ExclusiveStartKey":{ "HashKeyElement":{"S":"AttributeName1"}, "RangeKeyElement":{"N":"AttributeName2"} }, "AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]}, } ``` **** | Name (Nom) | Description | Obligatoire | | --- | --- | --- | | TableName | Nom de la table contenant les éléments demandés. Type : String | Oui | | AttributesToGet | Tableau de noms d'attribut. Si des noms d'attribut ne sont pas spécifiés, tous les attributs sont renvoyés. Si certains attributs ne sont pas trouvés, ils n'apparaissent pas dans le résultat.Type : Array | Non | | Limit | Nombre maximum d'éléments à évaluer (pas nécessairement le nombre d'éléments correspondants). Si DynamoDB traite le nombre d'éléments jusqu'à la limite lors du traitement des résultats, il arrête et renvoie les valeurs correspondantes jusqu'à ce point, ainsi qu'une valeur `LastEvaluatedKey` à appliquer dans une opération subséquente pour continuer à récupérer des éléments. Par ailleurs, si la taille du jeu de données dépasse 1 Mo avant que DynamoDB atteigne cette limite, DynamoDB arrête l'analyse et renvoie les valeurs correspondantes jusqu'à la limite, ainsi qu'une valeur `LastEvaluatedKey` à appliquer dans une opération subséquente pour continuer l'analyse.Type : nombre | Non | | Count | Si la valeur est définie sur `true`, DynamoDB renvoie un nombre total d'éléments pour l'opération d'analyse, même si celle-ci ne trouve pas d'élément pour le filtre affecté. Vous pouvez appliquer le paramètre Limit aux analyses de nombre uniquement. Ne définissez pas la valeur `Count` sur `true` tout en fournissant une liste `AttributesToGet` car, dans ce cas, DynamoDB renvoie une erreur de validation. Pour de plus amples informations, consultez [Comptabilisation des éléments dans les résultats](Scan.md#Scan.Count).Type : booléen | Non | | ScanFilter | Evalue les résultats de l'analyse et renvoie uniquement les valeurs souhaitées. S'il y a plusieurs conditions, celles-ci sont traitées comme des opérations « AND (ET) ». Toutes les conditions doivent être remplies pour être incluses dans les résultats. Type : mappage des noms d'attribut à des valeurs avec des opérateurs de comparaison. | Non | | ScanFilter:AttributeValueList | Valeurs et conditions d'évaluation des résultats d'analyse pour le filtre.Type : mappage de `AttributeValue` à un `Condition`. | Non | | ScanFilter:​ ComparisonOperator | Critères d'évaluation des attributs fournis, tels que Egal à, Supérieur à, etc. Les opérateurs de comparaison valides pour une opération d'analyse sont les suivants. Les comparaisons de valeurs de chaîne pour les critères Supérieur à, Egal à ou Inférieur à sont basées sur des valeurs de code de caractère ASCII. Par exemple, `a` est supérieur à `A`, et `aa` est supérieur à `B`. Pour obtenir la liste des valeurs des codes, consultez [http://fr.wikipedia.org/wiki/American\$1Standard\$1Code\$1for\$1Information\$1Interchange](http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters). Pour une valeur binaire, DynamoDB traite chaque octet des données binaires comme non signé quand il compare des valeurs binaires, par exemple, lors de l'évaluation d'expressions de requête. Type : chaîne ou binaire | Non | |   | `EQ` : égal. Pour `EQ`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si un élément contient une `AttributeValue` d'un type différent de celui spécifié dans la demande, la valeur ne correspond pas. Par exemple, `{"S":"6"}` n'est pas égal à `{"N":"6"}`. De même, `{"N":"6"}` n'est pas égal à `{"NS":["6", "2", "1"]}`. |   | |   | `NE` : non égal. Pour `NE`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si un élément contient une `AttributeValue` d'un type différent de celui spécifié dans la demande, la valeur ne correspond pas. Par exemple, `{"S":"6"}` n'est pas égal à `{"N":"6"}`. De même, `{"N":"6"}` n'est pas égal à `{"NS":["6", "2", "1"]}`. |   | |   | `LE` : inférieur ou égal. Pour `LE`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si un élément contient une `AttributeValue` d'un type différent de celui spécifié dans la demande, la valeur ne correspond pas. Par exemple, `{"S":"6"}` n'est pas égal à `{"N":"6"}`. De même, `{"N":"6"}` n'est pas comparable à `{"NS":["6", "2", "1"]}`. |   | |   | `LT` : inférieur. Pour `LT`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si un élément contient une `AttributeValue` d'un type différent de celui spécifié dans la demande, la valeur ne correspond pas. Par exemple, `{"S":"6"}` n'est pas égal à `{"N":"6"}`. De même, `{"N":"6"}` ne se compare pas à `{"NS":["6", "2", "1"]}`. |   | |   | `GE` : supérieur ou égal. Pour `GE`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si un élément contient une `AttributeValue` d'un type différent de celui spécifié dans la demande, la valeur ne correspond pas. Par exemple, `{"S":"6"}` n'est pas égal à `{"N":"6"}`. De même, `{"N":"6"}` ne se compare pas à `{"NS":["6", "2", "1"]}`. |   | |   | `GT` : supérieur. Pour `GT`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si un élément contient une `AttributeValue` d'un type différent de celui spécifié dans la demande, la valeur ne correspond pas. Par exemple, `{"S":"6"}` n'est pas égal à `{"N":"6"}`. De même, `{"N":"6"}` n'est pas comparable à `{"NS":["6", "2", "1"]}`. |   | |   | `NOT_NULL` : l'attribut existe. |   | |   | `NULL` : l'attribut n'existe pas. |   | |   | `CONTAINS` : vérifie la présence d'une sous-séquence ou d'une valeur dans un ensemble. Pour `CONTAINS`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si l'attribut cible de la comparaison est de type chaîne, l'opération vérifie la présence d'une sous-chaîne correspondante. Si l'attribut cible de la comparaison est de type binaire, l'opération vérifie la présence d'une sous-séquence de la cible correspondant à l'entrée. Si l'attribut cible de la comparaison est de type ensemble (« SS », « NS » ou « BS »), l'opération vérifie la présence d'un membre de l'ensemble (pas comme une sous-chaîne). |   | |   | `NOT_CONTAINS` : vérifie l'absence d'une sous-séquence ou d'une valeur dans un ensemble. Pour `NOT_CONTAINS`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Si l'attribut cible de la comparaison est de type chaîne, l'opération vérifie l'absence de sous-chaîne correspondante. Si l'attribut cible de la comparaison est de type binaire, l'opération vérifie l'absence d'une sous-séquence de la cible correspondant à l'entrée. Si l'attribut cible de la comparaison est de type ensemble (« SS », « NS » ou « BS »), l'opération vérifie l'absence d'un membre de l'ensemble (pas comme une sous-chaîne). |   | |   | `BEGINS_WITH` : vérifie la présence d'un préfixe. Pour `BEGINS_WITH`, `AttributeValueList` ne peut contenir qu'une seule `AttributeValue` de type chaîne ou binaire (pas nombre ou ensemble). L'attribut cible de la comparaison doit être une chaîne ou un binaire (pas un nombre ou un ensemble). |   | |   | `IN` : vérifie la présence de correspondances exactes. Pour `IN`, `AttributeValueList` peut contenir qu'une seule `AttributeValue` de type Chaîne, Nombre ou Binaire (et non Ensemble). Pour correspondre, l'attribut cible de la comparaison doit être du même type et avoir exactement la même valeur. Une chaîne ne correspond jamais à un ensemble de chaîne. |   | |   | `BETWEEN` : supérieur ou égal à la première valeur, et inférieur ou égal à la deuxième valeur. Pour `BETWEEN`, `AttributeValueList` doit inclure deux éléments `AttributeValue` du même type, Chaîne, Nombre ou Binaire (et non Ensemble). Un attribut cible correspond si la valeur cible est supérieure ou égale au premier élément, et inférieure ou égale au deuxième. Si un élément contient une `AttributeValue` d'un type différent de celui spécifié dans la demande, la valeur ne correspond pas. Par exemple, `{"S":"6"}` n'est pas comparable à `{"N":"6"}`. De même, `{"N":"6"}` n'est pas comparable à `{"NS":["6", "2", "1"]}`. |   | | ExclusiveStartKey | Clé primaire de l'élément à partir duquel continuer une analyse antérieure. Une analyse antérieure peut fournir cette valeur si cette opération d'analyse a été interrompue avant la fin, soit en raison de la taille de l'ensemble de résultats, soit en raison du paramètre `Limit`. La `LastEvaluatedKey` peut être retransmise dans une nouvelle demande d'analyse pour continuer l'opération à partir de ce point.Type : `HashKeyElement`, ou `HashKeyElement` et `RangeKeyElement` pour une clé primaire composite. | Non | ## Réponses ### Syntaxe ``` HTTP/1.1 200 x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375 content-type: application/x-amz-json-1.0 content-length: 229 {"Count":2,"Items":[{ "AttributeName1":{"S":"AttributeValue1"}, "AttributeName2":{"S":"AttributeValue2"}, "AttributeName3":{"S":"AttributeValue3"} },{ "AttributeName1":{"S":"AttributeValue4"}, "AttributeName2":{"S":"AttributeValue5"}, "AttributeName3":{"S":"AttributeValue6"}, "AttributeName5":{"B":"dmFsdWU="} }], "LastEvaluatedKey": {"HashKeyElement":{"S":"AttributeName1"}, "RangeKeyElement":{"N":"AttributeName2"}, "ConsumedCapacityUnits":1, "ScannedCount":2} } ``` **** | Name (Nom) | Description | | --- | --- | | Items | Conteneur pour les attributs répondant aux paramètres de l'opération.Type : mappage de noms d'attribut à leurs types de données et valeurs. | | Count | Nombre d'éléments dans la réponse. Pour de plus amples informations, consultez [Comptabilisation des éléments dans les résultats](Scan.md#Scan.Count). Type : nombre | | ScannedCount | Nombre d'éléments dans l'analyse complète avant l'application des filtres. Une valeur `ScannedCount` élevée avec peu ou pas de résultats `Count` indique une opération d'analyse inefficace. Pour de plus amples informations, consultez [Comptabilisation des éléments dans les résultats](Scan.md#Scan.Count).Type : nombre | | LastEvaluatedKey | Clé primaire de l'élément où l'opération d'analyse s'est arrêtée. Fournissez cette valeur dans une opération d'analyse subséquente pour poursuivre l'opération à partir de ce point.La `LastEvaluatedKey` a une valeur `null` quand l'ensemble des résultats de l'analyse est complet (c'est-à-dire que l'opération a traité la « dernière page »). | | ConsumedCapacityUnits | Nombre d'unités de capacité de lecture consommées par l'opération. Cette valeur indique le nombre appliqué à votre débit approvisionné. Pour plus d’informations, consultez [Mode de capacité provisionnée DynamoDB](provisioned-capacity-mode.md). Type : nombre | ## Erreurs spéciales **** | Erreur | Description | | --- | --- | | ResourceNotFoundException | La table spécifiée n'a pas été trouvée. | ## Exemples Pour des exemples d'utilisation du kit SDK AWS, consultez [Analyse de tables dans DynamoDB](Scan.md). ### Exemple de demande ``` // This header is abbreviated. For a sample of a complete header, see API de bas niveau de DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.Scan content-type: application/x-amz-json-1.0 {"TableName":"1-hash-rangetable","ScanFilter":{}} ``` ### Exemple de réponse ``` HTTP/1.1 200 x-amzn-RequestId: 4e8a5fa9-71e7-11e0-a498-71d736f27375 content-type: application/x-amz-json-1.0 content-length: 465 {"Count":4,"Items":[{ "date":{"S":"1980"}, "fans":{"SS":["Dave","Aaron"]}, "name":{"S":"Airplane"}, "rating":{"S":"***"} },{ "date":{"S":"1999"}, "fans":{"SS":["Ziggy","Laura","Dean"]}, "name":{"S":"Matrix"}, "rating":{"S":"*****"} },{ "date":{"S":"1976"}, "fans":{"SS":["Riley"]}," name":{"S":"The Shaggy D.A."}, "rating":{"S":"**"} },{ "date":{"S":"1985"}, "fans":{"SS":["Fox","Lloyd"]}, "name":{"S":"Back To The Future"}, "rating":{"S":"****"} }], "ConsumedCapacityUnits":0.5 "ScannedCount":4} ``` ### Exemple de demande ``` // This header is abbreviated. For a sample of a complete header, see API de bas niveau de DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.Scan content-type: application/x-amz-json-1.0 content-length: 125 {"TableName":"comp5", "ScanFilter": {"time": {"AttributeValueList":[{"N":"400"}], "ComparisonOperator":"GT"} } } ``` ### Exemple de réponse ``` HTTP/1.1 200 OK x-amzn-RequestId: PD1CQK9QCTERLTJP20VALJ60TRVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 262 Date: Mon, 15 Aug 2011 16:52:02 GMT {"Count":2, "Items":[ {"friends":{"SS":["Dave","Ziggy","Barrie"]}, "status":{"S":"chatting"}, "time":{"N":"2000"}, "user":{"S":"Casey"}}, {"friends":{"SS":["Dave","Ziggy","Barrie"]}, "status":{"S":"chatting"}, "time":{"N":"2000"}, "user":{"S":"Fredy"} }], "ConsumedCapacityUnits":0.5 "ScannedCount":4 } ``` ### Exemple de demande ``` // This header is abbreviated. For a sample of a complete header, see API de bas niveau de DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.Scan content-type: application/x-amz-json-1.0 {"TableName":"comp5", "Limit":2, "ScanFilter": {"time": {"AttributeValueList":[{"N":"400"}], "ComparisonOperator":"GT"} }, "ExclusiveStartKey": {"HashKeyElement":{"S":"Fredy"},"RangeKeyElement":{"N":"2000"}} } ``` ### Exemple de réponse ``` HTTP/1.1 200 OK x-amzn-RequestId: PD1CQK9QCTERLTJP20VALJ60TRVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 232 Date: Mon, 15 Aug 2011 16:52:02 GMT {"Count":1, "Items":[ {"friends":{"SS":["Jane","James","John"]}, "status":{"S":"exercising"}, "time":{"N":"2200"}, "user":{"S":"Roger"}} ], "LastEvaluatedKey":{"HashKeyElement":{"S":"Riley"},"RangeKeyElement":{"N":"250"}}, "ConsumedCapacityUnits":0.5 "ScannedCount":2 } ``` ## Actions connexes + [Requête](API_Query_v20111205.md) + [BatchGetItem](API_BatchGetItem_v20111205.md)