Écriture de données dans une table

Les tables des bases de données relationnelles contiennent des lignes de données. Les lignes sont composées de colonnes. Les tables Amazon DynamoDB contiennent des éléments. Les éléments sont composés d'attributs.

Cette section décrit comment écrire une ligne (ou un élément) dans une table.

Écrire des données dans une table avec SQL

Une table d'une base de données relationnelle est une structure de données à deux dimensions, composée de lignes et de colonnes. Certains systèmes de gestion de base de données prennent également en charge les données semi-structurées, généralement avec des types de données natifs JSON ou XML de type de données. Cependant, les détails de la mise en œuvre varient selon les fournisseurs.

DansSQL, vous utiliseriez l'INSERTinstruction pour ajouter une ligne à un tableau.

INSERT INTO Music
    (Artist, SongTitle, AlbumTitle,
    Year, Price, Genre,
    Tags)
VALUES(
    'No One You Know', 'Call Me Today', 'Somewhat Famous',
    2015, 2.14, 'Country',
    '{"Composers": ["Smith", "Jones", "Davis"],"LengthInSeconds": 214}'
);

La clé primaire de ce tableau est composée de Artist et SongTitle. Vous devez spécifier les valeurs de ces colonnes.

Note

Cet exemple utilise la colonne Tags pour stocker les données semi-structurées sur les chansons de la table Music. La colonne Tags est définie en tant que typeTEXT, qui peut stocker jusqu'à 65 535 caractères dans My. SQL

Écrire de données dans une table dans DynamoDB

Dans Amazon DynamoDB, vous pouvez utiliser API DynamoDB ou partiQL SQL (un langage de requête compatible) pour ajouter un élément à une table.

DynamoDB API

Avec API DynamoDB, vous utilisez PutItem l'opération pour ajouter un élément à une table.

{
    TableName: "Music",
    Item: {
        "Artist":"No One You Know",
        "SongTitle":"Call Me Today",
        "AlbumTitle":"Somewhat Famous",
        "Year": 2015,
        "Price": 2.14,
        "Genre": "Country",
        "Tags": {
            "Composers": [
                  "Smith",
                  "Jones",
                  "Davis"
            ],
            "LengthInSeconds": 214
        }
    }
}

La clé primaire de ce tableau est composée de Artist et SongTitle. Vous devez spécifier les valeurs de ces attributs.

Voici quelques éléments clés à savoir sur cet exemple PutItem :

• DynamoDB fournit un support natif pour les documents, en utilisant. JSON Cela fait de DynamoDB un outil idéal pour stocker des données semi-structurées telles que des étiquettes. Vous pouvez également récupérer et manipuler des données à partir de JSON documents.

• La table Music ne possède aucun attribut prédéfini, à l'exception de la clé primaire (Artist et SongTitle).

• La plupart des SQL bases de données sont axées sur les transactions. Lorsque vous émettez une instruction INSERT, les modifications des données ne sont pas permanentes jusqu'à ce que vous lanciez une instruction COMMIT. Avec Amazon DynamoDB, les effets d'PutItemune opération sont permanents lorsque DynamoDB répond avec un code d'état 200 (). HTTP OK

Voici quelques autres exemples de PutItem.

{
    TableName: "Music",
    Item: {
        "Artist": "No One You Know",
        "SongTitle": "My Dog Spot",
        "AlbumTitle":"Hey Now",
        "Price": 1.98,
        "Genre": "Country",
        "CriticRating": 8.4
    }
}

{
    TableName: "Music",
    Item: {
        "Artist": "No One You Know",
        "SongTitle": "Somewhere Down The Road",
        "AlbumTitle":"Somewhat Famous",
        "Genre": "Country",
        "CriticRating": 8.4,
        "Year": 1984
    }
}

{
    TableName: "Music",
    Item: {
        "Artist": "The Acme Band",
        "SongTitle": "Still In Love",
        "AlbumTitle":"The Buck Starts Here",
        "Price": 2.47,
        "Genre": "Rock",
        "PromotionInfo": {
            "RadioStationsPlaying":[
                 "KHCR", "KBQX", "WTNR", "WJJH"
            ],
            "TourDates": {
                "Seattle": "20150625",
                "Cleveland": "20150630"
            },
            "Rotation": "Heavy"
        }
    }
}

{
    TableName: "Music",
    Item: {
        "Artist": "The Acme Band",
        "SongTitle": "Look Out, World",
        "AlbumTitle":"The Buck Starts Here",
        "Price": 0.99,
        "Genre": "Rock"
    }
}

Note

En plus de PutItem, DynamoDB prend en charge une opération BatchWriteItem pour écrire plusieurs éléments à la fois.

PartiQL for DynamoDB

Avec PartiQL, vous utilisez l'opération ExecuteStatement pour ajouter un élément à une table, à l'aide de l'instruction PartiQL Insert.

INSERT into Music value {  
    'Artist': 'No One You Know',
    'SongTitle': 'Call Me Today',
    'AlbumTitle': 'Somewhat Famous',
    'Year' : '2015',
    'Genre' : 'Acme'
}

La clé primaire de ce tableau est composée de Artist et SongTitle. Vous devez spécifier les valeurs de ces attributs.

Note

Pour des exemples de code utilisant Insert et ExecuteStatement, consultez Instructions d'insertion de PartiQL pour DynamoDB.