Na}{

File Content: `scan.rst`

**To scan a table**

The following ``scan`` example scans the entire ``MusicCollection`` table, and then narrows the results to songs by the artist "No One You Know". For each item, only the album title and song title are returned. ::

    aws dynamodb scan \
        --table-name MusicCollection \
        --filter-expression "Artist = :a" \
        --projection-expression "#ST, #AT" \
        --expression-attribute-names file://expression-attribute-names.json \
        --expression-attribute-values file://expression-attribute-values.json

Contents of ``expression-attribute-names.json``::

    {
        "#ST": "SongTitle", 
        "#AT":"AlbumTitle"
    }

Contents of ``expression-attribute-values.json``::

    {
        ":a": {"S": "No One You Know"}
    }

Output::

    {
        "Count": 2, 
        "Items": [
            {
                "SongTitle": {
                    "S": "Call Me Today"
                }, 
                "AlbumTitle": {
                    "S": "Somewhat Famous"
                }
            }, 
            {
                "SongTitle": {
                    "S": "Scared of My Shadow"
                }, 
                "AlbumTitle": {
                    "S": "Blue Sky Blues"
                }
            }
        ], 
        "ScannedCount": 3, 
        "ConsumedCapacity": null
    }

For more information, see `Working with Scans in DynamoDB <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Scan.html>`__ in the *Amazon DynamoDB Developer Guide*.

Name	Size	Permission
wait	---	0755
batch-get-item.rst	1722 bytes	0644
batch-write-item.rst	1571 bytes	0644
create-backup.rst	860 bytes	0644
create-global-table.rst	1052 bytes	0644
create-table.rst	1748 bytes	0644
delete-backup.rst	1893 bytes	0644
delete-item.rst	700 bytes	0644
delete-table.rst	789 bytes	0644
describe-backup.rst	1935 bytes	0644
describe-continuous-backups.rst	745 bytes	0644
describe-contributor-insights.rst	1040 bytes	0644
describe-endpoints.rst	542 bytes	0644
describe-global-table-settings.rst	1590 bytes	0644
describe-global-table.rst	952 bytes	0644
describe-limits.rst	576 bytes	0644
describe-table-replica-auto-scaling.rst	4206 bytes	0644
describe-table.rst	1439 bytes	0644
describe-time-to-live.rst	551 bytes	0644
get-item.rst	951 bytes	0644
list-backups.rst	1005 bytes	0644
list-contributor-insights.rst	648 bytes	0644
list-global-tables.rst	739 bytes	0644
list-tables.rst	548 bytes	0644
list-tags-of-resource.rst	589 bytes	0644
put-item.rst	1601 bytes	0644
query.rst	1158 bytes	0644
restore-table-from-backup.rst	2219 bytes	0644
restore-table-to-point-in-time.rst	2100 bytes	0644
scan.rst	1518 bytes	0644
tag-resource.rst	510 bytes	0644
transact-get-items.rst	1826 bytes	0644
transact-write-items.rst	1484 bytes	0644
untag-resource.rst	521 bytes	0644
update-continuous-backups.rst	908 bytes	0644
update-contributor-insights.rst	648 bytes	0644
update-global-table-settings.rst	2197 bytes	0644
update-global-table.rst	1090 bytes	0644
update-item.rst	1558 bytes	0644
update-table-replica-auto-scaling.rst	6442 bytes	0644
update-table.rst	1646 bytes	0644
update-time-to-live.rst	585 bytes	0644

Name

Size

Permission

Action

wait

---

0755