Collection::replaceOne
(No version information available, might only be in Git)
Collection::replaceOne — Ersetzt ein Dokument einer Sammlung
Beschreibung
Aktualisiert (oder ersetzt) das durch die ID angegebene Dokument, sofern es vorhanden ist.
Parameter-Liste
-
id -
Die ID des Dokuments, das ersetzt oder aktualisiert werden soll. Normalerweise ist dies die _id, die vom MySQL-Server beim Hinzufügen des Datensatzes erzeugt wurde.
-
doc -
Das Dokument, mit dem das zum Parameter
idgehörende Dokument aktualisiert oder ersetzt werden soll.Dieses Dokument kann entweder ein Dokument-Objekt sein oder eine gültige JSON-Zeichenkette, die das neue Dokument beschreibt.
Rückgabewerte
Gibt ein Result-Objekt zurück, das verwendet werden kann, um die Anzahl der betroffenen Elemente und die Anzahl der durch die Operation erzeugten Warnungen abzufragen.
Beispiele
Beispiel #1 mysql_xdevapi\Collection::replaceOne()-Beispiel
<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");
$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();
$schema = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");
$result = $collection->add('{"name": "Alfred", "age": 18, "job": "Butler"}')->execute();
// Normalerweise ist die _id aus anderen Quellen bekannt, aber für
// dieses Beispiel rufen wir die generierte ID ab und verwenden sie
$ids = $result->getGeneratedIds();
$alfred_id = $ids[0];
// ...
$alfred = $collection->getOne($alfred_id);
$alfred['age'] = 81;
$alfred['job'] = 'Guru';
$collection->replaceOne($alfred_id, $alfred);
?>
add a note
