Befehl dynamoDB Delete-item

Der DynamoDB-Betrieb von Löschungen ist eines der meist verwendeten Dienstprogramme bei der Verwaltung der Datenbank. Es hilft, ein einzelnes Element mit dem Primärschlüssel aus Ihrer Tabelle aus zu löschen. Insbesondere stützt sich dieser Befehl auf der DynamoDB DeleteItem -API. Sie können es mit dem Befehl Delete-Item CLI aufrufen.

Durch die Durchführung eines bedingten Löschvorgangs in DynamoDB wird die vorhandenen Elemente oder Elemente mit den erwarteten Attributwerten entfernt. Nach dem Löschen eines Elements können Sie auch die Attributwerte des Elements mit dem Parameter DynamoDB ReturnValues ​​zurückgeben.

Dieser Artikel konzentriert sich auf den Betrieb von DynamoDB auf den Betrieb von Delete-Item. Zu den Bereichen, über die Sie erwarten sollten, dass Sie mehr über die Synopsis für Delete-Punkte, ihre Optionen, die Befehlszeile und das Beispiel gehören, umfassen.

DynamoDB Delete-item-Operationssynopsis

Das Folgende ist eine vollständige Zusammenfassung der Delete-El-Operation:

Element löschen
--Tabellenname
--Taste
[--erwartet ]
[-Konditionaler Operator ]
[-Return-Werte ]
[-Erzielung der Kapazität ]
[-Return-Eltem-Sammlung-Metrics ]
[-Kondition-Expression ]
[-expression-attribut-names ]
[-EXPRESSION-ATTRIBUTE-Werte ]
[--Cli-Input-Json ]
[-generiertes Cli-Skelett ]
[--debuggen]
[--endpoint-url ]
[-No-Verify-SSL]
[-no-paginate]
[--Ausgang ]
[--Anfrage ]
[--Profil ]
[--Region ]
[--Ausführung ]
[--Farbe ]
[-No-Sign-Request]
[--ca-bundle ]
[-Cli-Read-Timeout ]
[-Cli-Connect-Timeout ]

Befehloptionen für Dynamodb Delete-item

Im Folgenden finden Sie die Hauptoptionen für den Betrieb von Löschungen:

--Tabellenname (Zeichenfolge)

Diese Option gibt den Tabellennamen an, aus dem Sie ein Element löschen möchten.

--Schlüssel (Karte)

Es handelt sich um eine Karte, die die Attributnamen den jeweiligen AttributeValue -Objekten bezeichnet oder angehängt hat, die den Primärschlüssel des Elements darstellt, den Sie löschen möchten. Stellen Sie sicher, dass Sie den vollständigen Primärschlüssel bereitstellen.

Wenn das Element beispielsweise einen einfachen Primärschlüssel enthält, müssen Sie einen passenden Partitionschlüssel bereitstellen. Stellen Sie auf der anderen Seite sicher, dass Sie den Partitionschlüssel und den Sortierschlüssel für Elemente mit zusammengesetzten Primärschlüssel geben.

--erwartet (Karte)

Die Option -erwartete Option ist ein Legacy -Parameter. Sie sollten die ConditionExpression anstelle des Parameters verwenden.

--Bedingter Operator (String)

Dies ist auch ein Legacy -Parameter, und es ist ratsam, stattdessen den Conditionexpressionsparameter zu verwenden. Seine möglichen Werte sind und/oder.

--Rückkehrwerte (String)

Wenn Sie die Attribute für das Element möchten, das Sie löschen möchten, wie sie vor dem Löschen der Löschung angezeigt werden. Die möglichen Werte für den Parameter returnValues, wenn sie im Befehl delete-item verwendet werden, sind keine oder All_old.

Wenn Sie den Parameter der Rückgabewerte nicht angeben oder als gar nicht eingeben, enthält Ihr Ergebnis keine Attribute des gelöschten Elements. Im Idealfall bleibt keine die Standardspezifikation für diesen Parameter. Eine All_old-Spezifikation für den Parameter returnValues ​​während einer Lösch-Elemente-Operation bringt jedoch den Inhalt für das alte Element zurück.

--Rückkehr-konsumierte Kapazität (String)

Dieser Parameter bestimmt die Tiefe oder die Detaillierungsstufe des On-Demand oder der vorgesehenen Durchsatzverbrauch, die Ihre Antwort zurückgeben sollte. Die möglichen Werte für diese Option umfassen Indizes, Gesamt und keine.

Für Indizes sollte Ihre Antwort neben der Verbraucherkapazität, die jeder Tabelle zugeordnet ist, und die mit jeder Tabelle verbunden.

Andererseits bringt die Operationen mit der Gesamtspezifikation die Antworten zurück, die nur die Aggregat CEALEDEDCAPACITY für Ihren Prozess enthalten. Schließlich sind die None -Werte die Standardeinstellungen. Sie erhalten keine Details zur Verbraucherkapazität Ihres Betriebs.

--Rückkehr-Punkt-Sammel-Metricy (String)

Der Parameter-Return-item-Sammel-Metrics-Methode bestimmt, ob Sie die Antwort der Element-Sammlung in der Antwort benötigen. Sie können es entweder auf die Größe oder keine festlegen, wobei die Einstellung nicht die Standardeinstellung ist. In einer Größeneinstellung gibt Ihr Ergebnis die Details zu den Artikelsammlungen zurück, wenn Angaben vorhanden sind.

--Bedingungsausdruck (String)

Ein API -Anruf von DeleteItem wird nicht erfolgreich sein, wenn Ihr Befehl die Anforderung für die Konditionsexpression nicht erfüllt. Dieser Ausdruck enthält die Funktionen, Vergleichsparameter und logische Parameter.

So verwenden Sie die DynamoDB-Operation und ihr Beispiel

Der Befehl DynamoDB Delete-item zeigt zwei bemerkenswerte Funktionen. Erstens handelt es sich um eine idempotent.

Zweitens ist der Befehl DynamoDB Delete-Item eine Singleton-Operation. Diese Funktion macht es unmöglich, einen einzelnen Befehl auszuführen und gleichzeitig alle Zeilen in Ihrer Tabelle zu löschen.

Ein einfacher Befehl Löschen-Punkt sollte wie folgt aussehen:

AWS DynamoDB Delete-item \
--Tischname Musik \
--Schlüsseldatei: // Schlüssel.json \
--Rückkehrwerte All_old \
--Rückkehr-konsumierte Kapazität Total \
--Return-item-Collection-Metrics-Größe

Eine Beispielantwort für den vorherigen Befehl sieht folgendermaßen aus:

Abschluss

Der Befehl DynamoDB Delete-item spielt eine wichtige Rolle bei der Aktualisierung Ihrer Tabellen und Indizes, wenn die Elemente von ihnen gelöscht werden. Während dies ein CLI -Befehl ist, können Sie die Elemente aus den DynamoDB -Tabellen über die AWS -Verwaltungskonsole oder eines der AWS -SDKs wie Boto3 für Python löschen.