array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'mysql-xdevapi-collection.removeone.php', 1 => 'Collection::removeOne', ), 'up' => array ( 0 => 'class.mysql-xdevapi-collection.php', 1 => 'mysql_xdevapi\\Collection', ), 'prev' => array ( 0 => 'mysql-xdevapi-collection.remove.php', 1 => 'Collection::remove', ), 'next' => array ( 0 => 'mysql-xdevapi-collection.replaceone.php', 1 => 'Collection::replaceOne', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/mysql_xdevapi/mysql_xdevapi/collection/removeone.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(No version information available, might only be in Git)
Collection::removeOne — Löscht ein Dokument einer Sammlung
Löscht das Dokument mit der zugehörigen ID aus der Sammlung. Dies ist eine
Kurzform für
Collection.remove("_id = :id").bind("id", id).execute()
.
id
Die ID des zu entfernenden Dokuments. Normalerweise ist dies die _id, die vom MySQL-Server beim Hinzufügen des Datensatzes erzeugt wurde.
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.
Beispiel #1 mysql_xdevapi\Collection::removeOne()-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];
$result = $collection->removeOne($alfred_id);
if(!$result->getAffectedItemsCount()) {
echo "Alfred mit der ID $alfred_id wurde nicht entfernt.";
} else {
echo "Auf Wiedersehen, Alfred, du kannst _id $alfred_id mitnehmen.";
}
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Auf Wiedersehen, Alfred, du kannst _id 00005b6b536100000000000000cb mitnehmen.