INSERTBefehl in Amazon QLDB

Wichtig

Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter Migrieren eines Amazon QLDB Ledgers zu Amazon Aurora SQL Postgre.

Verwenden Sie in Amazon den INSERT BefehlQLDB, um einer Tabelle ein oder mehrere Amazon Ion-Dokumente hinzuzufügen.

Anmerkung

Informationen zur Steuerung des Zugriffs auf die Ausführung dieses PartiQL-Befehls für bestimmte Tabellen finden Sie unterErste Schritte mit dem Standardberechtigungsmodus in Amazon QLDB.

Syntax

Fügen Sie ein einzelnes Dokument ein.

INSERT INTO table_name VALUE document

Fügen Sie mehrere Dokumente ein.

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

Parameter

table_name

Der Name der Benutzertabelle, in die Sie die Daten einfügen möchten. Die Tabelle muss bereits vorhanden sein. DMLAnweisungen werden nur in der Standardbenutzeransicht unterstützt.

document

Ein gültiges QLDB-Dokument. Sie müssen mindestens ein Dokument angeben. Mehrere Dokumente müssen durch Kommas getrennt werden.

Das Dokument muss mit geschweiften Klammern () gekennzeichnet werden. {...}

Jeder Feldname im Dokument ist ein Ionen-Symbol, bei dem Groß- und Kleinschreibung beachtet wird und in PartiQL durch einfache Anführungszeichen ('...') gekennzeichnet werden kann.

Zeichenkettenwerte werden in PartiQL auch durch einfache Anführungszeichen ('...') gekennzeichnet.

Alle Ion-Literalwerte können mit umgekehrten Anführungszeichen angegeben werden (`...`).

Anmerkung

Doppelte eckige Klammern ( <<...>> ) bezeichnen eine ungeordnete Sammlung (in PartiQL als Tasche bezeichnet) und sind nur erforderlich, wenn Sie mehrere Dokumente einfügen möchten.

Rückgabewert

documentId— Die eindeutige ID jedes Dokuments, das Sie eingefügt haben.

Beispiele

Fügen Sie ein einzelnes Dokument ein.

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`
}

Diese Anweisung gibt die eindeutige ID des von Ihnen eingefügten Dokuments wie folgt zurück.

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

Fügen Sie mehrere Dokumente ein.

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'
}
>>

Diese Anweisung gibt die eindeutige ID jedes Dokuments zurück, das Sie wie folgt eingefügt haben.

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

Wird programmgesteuert mit dem Treiber ausgeführt

Informationen zum programmgesteuerten Ausführen dieser Anweisung mithilfe des QLDB Treibers finden Sie in den folgenden Tutorials unter Erste Schritte mit dem Treiber:

• Java: | Schnellstart-Tutorial Referenz zum Kochbuch

• .NET: Schnellstart-Tutorial | Referenz zum Kochbuch

• Gehe zu: Schnellstart-Tutorial | Referenz zum Kochbuch

• Node.js: Schnellstart-Tutorial | Referenz zum Kochbuch

• Python: Schnellstart-Tutorial | Referenz zum Kochbuch