HEX
Server: Apache/2.4.41 (Ubuntu)
System: Linux ip-172-31-42-149 5.15.0-1084-aws #91~20.04.1-Ubuntu SMP Fri May 2 07:00:04 UTC 2025 aarch64
User: ubuntu (1000)
PHP: 7.4.33
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare,
Upload Files
File: //usr/local/aws-cli/v2/current/dist/awscli/examples/ddb/select.rst
**To scan an entire table**

This 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.

Command::

    aws ddb select MusicCollection --projection 'SongTitle, AlbumTitle' \
        --filter 'Artist = "No One You Know"'

Output::

    Count: 2
    Items:
    - SongTitle: "Call Me Today"
      AlbumTitle: "Somewhat Famous"
    - SongTitle: "Scared of My Shadow"
      AlbumTitle: "Blue Sky Blues"
    ScannedCount: 3

**To query for specific primary keys**

This example queries items in the *MusicCollection* table. The table has a
hash-and-range primary key (*Artist* and *SongTitle*), but this query only
specifies the hash key value. It returns song titles by the artist named "No
One You Know".

Command::

    aws ddb select MusicCollection --projection SongTitle \
        --key-condition 'Artist = "No One You Know"'

Output::

    Count: 2
    Items:
    - SongTitle: "Call Me Today"
    - SongTitle: "Scared of My Shadow"
    ScannedCount: 2