Edit Report a Bug

    MongoDB\Driver\BulkWrite::delete

    (mongodb >=1.0.0)

    MongoDB\Driver\BulkWrite::delete — Add a delete operation to the bulk

    Beschreibung

    public MongoDB\Driver\BulkWrite::delete(array|object $filter, ?array $deleteOptions = null): void

    Adds a delete operation to the MongoDB\Driver\BulkWrite.

    Parameter-Liste

    filter (array|object)

    Das » Abfrage-Prädikat. Ein leeres Prädikat passt auf alle Dokumente in der Sammlung.

    Hinweis: Bei der Auswertung von Abfragekriterien vergleicht MongoDB Typen und Werte gemäß seiner eigenen » Vergleichsregeln für BSON-Typen, die sich von PHPs Regeln für Typenvergleich und Typen-Jonglage unterscheidet. Wenn es eine Übereinstimmung mit einem speziellen BSON-Typ gibt, sollten die Abfragekriterien die entsprechende BSON-Klasse verwenden (z. B. MongoDB\BSON\ObjectId, um auf eine » ObjectId zu passen).

    deleteOptions

    deleteOptions
    Option Type Description Default
    collation array|object

    Die » Collation (Vergleichs-/Sortierregel) ermöglicht es dem Benutzer, sprachspezifische Regeln für den Vergleich von Zeichenketten anzugeben, so z. B. Regeln für die Groß- und Kleinschreibung und Akzentzeichen. Bei der Angabe der Sortierung ist das Feld "locale" obligatorisch; alle anderen Sortierfelder sind optional. Die Beschreibungen der Felder sind unter » Collation Document zu finden.

    Wenn keine Kollation angegeben wurde, aber die Sammlung eine Standardkollation hat, verwendet die Operation die für die Sammlung angegebene Kollation. Wenn weder für die Sammlung noch für die Operation eine Kollation angegeben wurde, verwendet MongoDB den einfachen binären Vergleich, der in früheren Versionen für den Vergleich von Zeichenketten verwendet wurde.

    Diese Option ist ab MongoDB 3.4 verfügbar. Wenn sie bei einer älteren Serverversion angegeben wird, kommt es bei der Ausführung zu einer Exception.

    hint string|array|object

    Index specification. Specify either the index name as a string or the index key pattern. If specified, then the query system will only consider plans using the hinted index.

    This option is available in MongoDB 4.4+ and will result in an exception at execution time if specified for an older server version.

    limit bool Delete all matching documents (false), or only the first matching document (true) false

    Rückgabewerte

    Es wird kein Wert zurückgegeben.

    Fehler/Exceptions

    Changelog

    Version Beschreibung
    PECL mongodb 1.8.0 Added the "hint" option.
    PECL mongodb 1.2.0 Added the "collation" option.

    Beispiele

    Beispiel #1 MongoDB\Driver\BulkWrite::delete() example

    <?php

    $bulk     = new MongoDB\Driver\BulkWrite;
    $bulk->delete(['x' => 1], ['limit' => 1]);
    $bulk->delete(['x' => 2], ['limit' => 0]);

    $manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');
    $result = $manager->executeBulkWrite('db.collection', $bulk);

    ?>

    Siehe auch

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top