Collection::addOrReplaceOne

(No version information available, might only be in Git)

Collection::addOrReplaceOneAdd or replace collection document

Beschreibung

public mysql_xdevapi\Collection::addOrReplaceOne(string $id, string $doc): mysql_xdevapi\Result

Add a new document, or replace a document if it already exists.

Here are several scenarios for this method:

  • If neither the id or any unique key values conflict with any document in the collection, then the document is added.

  • If the id does not match any document but one or more unique key values conflict with a document in the collection, then an error is raised.

  • If id matches an existing document and no unique keys are defined for the collection, then the document is replaced.

  • If id matches an existing document, and either all unique keys in the replacement document match that same document or they don't conflict with any other documents in the collection, then the document is replaced.

  • If id matches an existing document and one or more unique keys match a different document from the collection, then an error is raised.

Parameter-Liste

id

This is the filter id. If this id or any other field that has a unique index already exists in the collection, then it will update the matching document instead.

By default, this id is automatically generated by MySQL Server when the record was added, and is referenced as a field named '_id'.

doc

This is the document to add or replace, which is a JSON string.

Rückgabewerte

A Result object.

Beispiele

Beispiel #1 mysql_xdevapi\Collection::addOrReplaceOne() example

<?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");
$create $schema->createCollection("people");

$collection $schema->getCollection("people");

// Using add()
$result $collection->add('{"name": "Wilma", "age": 23, "job": "Teacher"}')->execute();

// Using addOrReplaceOne()
// Note: we're passing in a known _id value here
$result $collection->addOrReplaceOne('00005b6b53610000000000000056''{"name": "Fred",  "age": 21, "job": "Construction"}');

?>

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

Was genau bedeutet "Vibe Coding"? Ein tiefgehender Blick für Entwickler

In der Welt der Softwareentwicklung gibt es unzählige Wege, wie man an ein Projekt herangeht. Manche schwören auf strikte Planung, andere auf bewährte Algorithmen und wieder andere lassen sich von etwas ganz anderem leiten: ihrem Gefühl. ...

admin

Autor : admin
Kategorie: Software & Web-Development

PHP cURL-Tutorial: Verwendung von cURL zum Durchführen von HTTP-Anfragen

cURL ist eine leistungsstarke PHP-Erweiterung, die es Ihnen ermöglicht, mit verschiedenen Servern über verschiedene Protokolle wie HTTP, HTTPS, FTP und mehr zu kommunizieren. ...

TheMax

Autor : TheMax
Kategorie: PHP-Tutorials

Midjourney Tutorial - Anleitung für Anfänger

Über Midjourney, dem Tool zur Erstellung digitaler Bilder mithilfe von künstlicher Intelligenz, gibt es ein informatives Video mit dem Titel "Midjourney Tutorial auf Deutsch - Anleitung für Anfänger" ...

Mike94

Autor : Mike94
Kategorie: KI Tutorials

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

db Abfrage mit mehreren ids im WHERE

eggy car (https://eggycar-game.io/)​ Bei diesem Skript komme ich einfach nicht weiter! Als erstes wird die Datenbank nach 10 zutreffenden id ...

Geschrieben von jakehobbs am 13.10.2025 05:26:32
Forum: PHP Developer Forum
Array auslesen

Du behauptest einfach etwas, dass Du mit den vorhandenen Hinweisen gar nicht beurteilen kannst. Das kann ich durchaus, denn durchnummerierte Arra ...

Geschrieben von scatello am 12.10.2025 20:45:10
Forum: PHP Developer Forum
Array auslesen

Du hast nichts verstanden! :goth: Aber ein Tipp zu deinem Problem: deine Datenstruktur ist einfach schlecht, deshalb verrennst du dich in dieses ...

Geschrieben von Psygonis am 12.10.2025 17:37:26
Forum: PHP Developer Forum
[Script] Suche umfangreiches Forum

Ich habe in den letzten Tagen nvcasino1.de - https://nvcasino1.de/ (https://nvcasino1.de/)ausprobiert. Die Registrierung war unkompliziert, und d ...

Geschrieben von michaelsmith120698 am 11.10.2025 23:19:13
Forum: Apps und PHP Script Gesuche