Étape 7 : interroger l'index secondaire global

Dans cette étape, vous allez interroger un index secondaire global sur la table Music à l'aide de la console Amazon DynamoDB ou de l' AWS CLI.

Pour plus d'informations sur les index secondaires globaux, consultez Utilisation d'index secondaires globaux dans DynamoDB.

AWS Management Console

Suivez ces étapes afin d'utiliser la console DynamoDB pour interroger les données via l'index secondaire global AlbumTitle-index.

1. Ouvrez la console DynamoDB à l'adresse https://console.aws.amazon.com/dynamodb/.

2. Dans le volet de navigation de gauche, choisissez Tables.

3. Dans la liste de tables, choisissez la table Music (Musique).

4. Sélectionnez Explore table items (Explorer les éléments de la table).

5. Dans Numériser ou interroger les éléments, conservez la sélection par défaut de Requête.

6. Pour Sélectionner une table ou un index, choisissez AlbumTitle-index.

7. Pour AlbumTitle, entrezSomewhat Famous, puis choisissez Exécuter.

AWS CLI

L' AWS CLI exemple suivant interroge un index secondaire global AlbumTitle-index sur la Music table. Vous pouvez procéder via l'API DynamoDB ou PartiQL, un langage de requête compatible SQL pour DynamoDB.

DynamoDB API

Vous interrogez l'index secondaire global via l'API DynamoDB à l'aide de query et en fournissant le nom d'index.

Linux

aws dynamodb query \
    --table-name Music \
    --index-name AlbumTitle-index \
    --key-condition-expression "AlbumTitle = :name" \
    --expression-attribute-values  '{":name":{"S":"Somewhat Famous"}}'

Windows CMD

aws dynamodb query ^
    --table-name Music ^
    --index-name AlbumTitle-index ^
    --key-condition-expression "AlbumTitle = :name" ^
    --expression-attribute-values  "{\":name\":{\"S\":\"Somewhat Famous\"}}"

L'utilisation de query renvoie l'exemple de résultat suivant.

{
    "Items": [
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "Awards": {
                "S": "1"
            },
            "Artist": {
                "S": "No One You Know"
            },
            "SongTitle": {
                "S": "Call Me Today"
            }
        },
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "Awards": {
                "N": "2"
            },
            "Artist": {
                "S": "No One You Know"
            },
            "SongTitle": {
                "S": "Howdy"
            }
        }
    ],
    "Count": 2,
    "ScannedCount": 2,
    "ConsumedCapacity": null
}

PartiQL for DynamoDB

Vous interrogez l'index secondaire global via PartiQL en utilisant l'instruction Select et en fournissant le nom de l'index.

Note

Vous devrez échapper aux guillemets doubles autour de Music et AlbumTitle-index car vous procédez via la CLI.

Linux

aws dynamodb execute-statement --statement "SELECT * FROM \"Music\".\"AlbumTitle-index\"  \
                                            WHERE AlbumTitle='Somewhat Famous'"

Windows CMD

aws dynamodb execute-statement --statement "SELECT * FROM \"Music\".\"AlbumTitle-index\" WHERE AlbumTitle='Somewhat Famous'"

Une telle utilisation de l'instruction Select renvoie l'exemple de résultat suivant.

{
    "Items": [
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "Awards": {
                "S": "1"
            },
            "Artist": {
                "S": "No One You Know"
            },
            "SongTitle": {
                "S": "Call Me Today"
            }
        },
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "Awards": {
                "S": "2"
            },
            "Artist": {
                "S": "No One You Know"
            },
            "SongTitle": {
                "S": "Howdy"
            }
        }
    ]
}

Pour plus d'informations sur l'interrogation de données avec PartiQL, consultez Instructions de sélection de PartiQL.