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

Helfen! Doppelte Bestelleinträge in meiner Verkaufstabelle

As a database developer, I've faced similar issues with duplicate entries in e-commerce systems. In one project, our order processing would someti ...

Geschrieben von NataliePasco am 18.07.2025 04:40:00
Forum: SQL / Datenbanken
CSV auslesen

Problem wurde gelöst.

Geschrieben von TomD am 16.07.2025 12:02:07
Forum: BRAINSTORMING PHP/SQL/HTML/JS/CSS
CSV auslesen

Hallo Zusammen. Möchte eine CSV auslesen und zusammenfassen. Habe jedoch einen Hänger und bekomme es nicht hin. Hier mal ein sample der .csv: 0 ...

Geschrieben von TomD am 15.07.2025 15:45:02
Forum: BRAINSTORMING PHP/SQL/HTML/JS/CSS
F1 Managerspiel sucht PHP Programmierer

Hallo, wir spielen seit den 90zigern ein F1 Manager Browserspiel welches zunächst als simple Exceltabelle begann und sich dann stetig gemausert ...

Geschrieben von Seb89 am 08.07.2025 17:26:17
Forum: Projekthilfe