INSERTcommande dans Amazon QLDB - Base de données Amazon Quantum Ledger (AmazonQLDB)
SyntaxeParamètresValeur renvoyéeExemplesExécution par programmation à l'aide du pilote

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.

INSERTcommande dans Amazon QLDB

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

Dans AmazonQLDB, utilisez la INSERT commande pour ajouter un ou plusieurs documents Amazon Ion à un tableau.

Note

Pour savoir comment contrôler l'accès afin d'exécuter cette commande partiQL sur des tables spécifiques, consultez. Commencer à utiliser le mode d'autorisation standard sur Amazon QLDB

Syntaxe

Insérez un document unique.

INSERT INTO table_name VALUE document

Insérez plusieurs documents.

INSERT INTO table_name << document, document, ... >>

Paramètres

table_name

Nom de la table utilisateur dans laquelle vous souhaitez insérer les données. La table doit déjà exister. DMLles instructions ne sont prises en charge que dans la vue utilisateur par défaut.

document

Un QLDBdocument valide. Vous devez spécifier au moins un document. Les documents multiples doivent être séparés par des virgules.

Le document doit être indiqué par des accolades (). {...}

Chaque nom de champ du document est un symbole ionique sensible aux majuscules et minuscules qui peut être indiqué par des guillemets simples ('...') dans PartiQL.

Les valeurs de chaîne sont également indiquées par des guillemets simples ('...') dans PartiQL.

Tous les littéraux d'ions peuvent être indiqués par des backticks (). `...`

Note

Les crochets à double angle (<<...>>) indiquent une collection non ordonnée (appelée sac dans PartiQL) et ne sont obligatoires que si vous souhaitez insérer plusieurs documents.

Valeur renvoyée

documentId— L'identifiant unique de chaque document que vous avez inséré.

Exemples

Insérez un document unique.

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidFromDate' : `2017-09-14T`, --Ion timestamp literal with day precision
    'ValidToDate' : `2020-06-25T`
}

Cette instruction renvoie l'identifiant unique du document que vous avez inséré, comme suit.

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

Insérez plusieurs documents.

INSERT INTO Person << 
{
    'FirstName' : 'Raul',
    'LastName' : 'Lewis',
    'DOB' : `1963-08-19T`,
    'GovId' : 'LEWISR261LL',
    'GovIdType' : 'Driver License',
    'Address' : '1719 University Street, Seattle, WA, 98109'
},
{
    'FirstName' : 'Brent',
    'LastName' : 'Logan',
    'DOB' : `1967-07-03T`,
    'GovId' : 'LOGANB486CG',
    'GovIdType' : 'Driver License',
    'Address' : '43 Stockert Hollow Road, Everett, WA, 98203'
},
{
    'FirstName' : 'Alexis',
    'LastName' : 'Pena',
    'DOB' : `1974-02-10T`,
    'GovId' : '744 849 301',
    'GovIdType' : 'SSN',
    'Address' : '4058 Melrose Street, Spokane Valley, WA, 99206'
}
>>

Cette instruction renvoie l'identifiant unique de chaque document que vous avez inséré, comme suit.

{
    documentId: "6WXzLscsJ3bDWW97Dy8nyp"
},
{
    documentId: "35e0ToZyTGJ7LGvcwrkX65"
},
{
    documentId: "BVHPcH612o7JROQ4yP8jiH"
}

Exécution par programmation à l'aide du pilote

Pour savoir comment exécuter cette instruction par programmation à l'aide du QLDB pilote, consultez les didacticiels suivants dans Getting started with the driver :