From 5903d8366e5915a9642e84b1b04454d9b2ed6ac2 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Sun, 7 Jun 2026 20:09:52 +0200 Subject: [PATCH] =?UTF-8?q?[Sync=20EN]=20mongodb:=20deutsche=20=C3=9Cberse?= =?UTF-8?q?tzung=20neuer=20Dateien?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../mongodb/driver/manager/startsession.xml | 230 +++++++++++++++++ .../mongodb/driver/readconcern/isdefault.xml | 121 +++++++++ reference/mongodb/mongodb/driver/server.xml | 238 ++++++++++++++++++ reference/mongodb/mongodb/driver/session.xml | 159 ++++++++++++ 4 files changed, 748 insertions(+) create mode 100644 reference/mongodb/mongodb/driver/manager/startsession.xml create mode 100644 reference/mongodb/mongodb/driver/readconcern/isdefault.xml create mode 100644 reference/mongodb/mongodb/driver/server.xml create mode 100644 reference/mongodb/mongodb/driver/session.xml diff --git a/reference/mongodb/mongodb/driver/manager/startsession.xml b/reference/mongodb/mongodb/driver/manager/startsession.xml new file mode 100644 index 000000000..1b68475e1 --- /dev/null +++ b/reference/mongodb/mongodb/driver/manager/startsession.xml @@ -0,0 +1,230 @@ + + + + + + + MongoDB\Driver\Manager::startSession + Startet eine neue Client-Sitzung zur Verwendung mit diesem Client + + + + &reftitle.description; + + final public MongoDB\Driver\SessionMongoDB\Driver\Manager::startSession + arraynulloptions&null; + + + Erzeugt eine MongoDB\Driver\Session für die + angegebenen Optionen. Die Sitzung kann anschließend bei der Ausführung von + Befehlen, Abfragen und Schreiboperationen angegeben werden. + + + + Eine MongoDB\Driver\Session kann nur mit dem + MongoDB\Driver\Manager verwendet werden, von dem sie + erstellt wurde. + + + + + + &reftitle.parameters; + + + options + + + + options + + + + Option + Typ + Beschreibung + Standardwert + + + + + causalConsistency + bool + + + Konfiguriert die kausale Konsistenz in einer Sitzung. Wenn &true;, + wird jede Operation in der Sitzung kausal nach der vorherigen Lese- + oder Schreiboperation geordnet. Auf &false; setzen, um die kausale + Konsistenz zu deaktivieren. + + + Weitere Informationen finden sich unter + Causal Consistency + im MongoDB-Handbuch. + + + &true; + + + defaultTransactionOptions + array + + + Standardoptionen, die auf neu erstellte Transaktionen angewendet + werden. Diese Optionen werden verwendet, sofern sie nicht + überschrieben werden, wenn eine Transaktion mit einem anderen Wert + für die jeweilige Option gestartet wird. + + +
+ options + + + + Option + Typ + Beschreibung + + + + &mongodb.option.maxCommitTimeMS; + &mongodb.option.readConcern; + &mongodb.option.readPreference; + &mongodb.option.writeConcern; + + +
+ + + Diese Option ist ab MongoDB 4.0 verfügbar. + + + [] + + + snapshot + bool + + + Konfiguriert Snapshot-Lesevorgänge in einer Sitzung. Wenn &true;, + wird ein Zeitstempel von der ersten unterstützten Leseoperation in + der Sitzung bezogen (d. h. find, + aggregate oder nicht-shardiertes + distinct). Nachfolgende Leseoperationen + innerhalb der Sitzung verwenden dann ein + "snapshot"-Read-Concern-Level, um + mehrheitlich bestätigte Daten ab diesem Zeitstempel zu lesen. Auf + &false; setzen, um Snapshot-Lesevorgänge zu deaktivieren. + + + Snapshot-Lesevorgänge erfordern MongoDB 5.0 oder neuer und können + nicht mit kausaler Konsistenz, Transaktionen oder + Schreiboperationen verwendet werden. Wenn + "snapshot" &true; ist, wird + "causalConsistency" standardmäßig &false; sein. + + + Weitere Informationen finden sich unter + Read Concern "snapshot" + im MongoDB-Handbuch. + + + &false; + + + + + + + + + + + + &reftitle.returnvalues; + + Gibt eine MongoDB\Driver\Session zurück. + + + + + &reftitle.errors; + + &mongodb.throws.argumentparsing; + Wirft eine MongoDB\Driver\Exception\InvalidArgumentException, wenn die Optionen "causalConsistency" und "snapshot" beide &true; sind. + Wirft eine MongoDB\Driver\Exception\RuntimeException, wenn die Sitzung nicht erstellt werden konnte (z. B. weil libmongoc keine Kryptografie unterstützt). + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + PECL mongodb 1.11.0 + + + Die Option "snapshot" wurde hinzugefügt. + + + + + PECL mongodb 1.6.0 + + + Die Option "maxCommitTimeMS" wurde zu + "defaultTransactionOptions" hinzugefügt. + + + + + PECL mongodb 1.5.0 + + + Die Option "defaultTransactionOptions" wurde + hinzugefügt. + + + + + + + + + + &reftitle.seealso; + + MongoDB\Driver\Session + Causal Consistency im MongoDB-Handbuch + + + + + + diff --git a/reference/mongodb/mongodb/driver/readconcern/isdefault.xml b/reference/mongodb/mongodb/driver/readconcern/isdefault.xml new file mode 100644 index 000000000..ff252df51 --- /dev/null +++ b/reference/mongodb/mongodb/driver/readconcern/isdefault.xml @@ -0,0 +1,121 @@ + + + + + + + MongoDB\Driver\ReadConcern::isDefault + Prüft, ob dies das standardmäßige Read Concern ist + + + + &reftitle.description; + + final public boolMongoDB\Driver\ReadConcern::isDefault + + + + Gibt zurück, ob dies das standardmäßige Read Concern ist (d. h. ob keine + Optionen angegeben sind). Diese Methode ist in erster Linie zur Verwendung in + Verbindung mit + MongoDB\Driver\Manager::getReadConcern gedacht, um + festzustellen, ob der Manager ohne Read-Concern-Optionen konstruiert wurde. + + + Der Treiber bindet kein standardmäßiges Read Concern in seine + Leseoperationen ein (z. B. + MongoDB\Driver\Manager::executeQuery), damit der + Server seinen eigenen Standardwert anwenden kann. Bibliotheken, die auf das + Read Concern des Managers zugreifen, um es in ihre eigenen Lesebefehle + einzubinden, sollten diese Methode verwenden, um sicherzustellen, dass + standardmäßige Read Concerns nicht gesetzt bleiben. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt &true; zurück, wenn dies das standardmäßige Read Concern ist, und + andernfalls &false;. + + + + + &reftitle.errors; + + &mongodb.throws.argumentparsing; + + + + + &reftitle.examples; + + <function>MongoDB\Driver\ReadConcern::isDefault</function> Beispiel + +isDefault()); + +$rc = new MongoDB\Driver\ReadConcern(MongoDB\Driver\ReadConcern::MAJORITY); +var_dump($rc->isDefault()); + +$manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1/?readConcernLevel=majority'); +$rc = $manager->getReadConcern(); +var_dump($rc->isDefault()); + +$manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1/'); +$rc = $manager->getReadConcern(); +var_dump($rc->isDefault()); + +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + MongoDB\Driver\Manager::getReadConcern + Read-Concern-Referenz + + + + + + diff --git a/reference/mongodb/mongodb/driver/server.xml b/reference/mongodb/mongodb/driver/server.xml new file mode 100644 index 000000000..e15fa5f71 --- /dev/null +++ b/reference/mongodb/mongodb/driver/server.xml @@ -0,0 +1,238 @@ + + + + + + + Die Klasse MongoDB\Driver\Server + MongoDB\Driver\Server + + + + +
+ &reftitle.intro; + + + +
+ + +
+ &reftitle.classsynopsis; + + + + MongoDB\Driver\Server + + + + final + + MongoDB\Driver\Server + + + + &Constants; + + const + int + MongoDB\Driver\Server::TYPE_UNKNOWN + 0 + + + const + int + MongoDB\Driver\Server::TYPE_STANDALONE + 1 + + + const + int + MongoDB\Driver\Server::TYPE_MONGOS + 2 + + + const + int + MongoDB\Driver\Server::TYPE_POSSIBLE_PRIMARY + 3 + + + const + int + MongoDB\Driver\Server::TYPE_RS_PRIMARY + 4 + + + const + int + MongoDB\Driver\Server::TYPE_RS_SECONDARY + 5 + + + const + int + MongoDB\Driver\Server::TYPE_RS_ARBITER + 6 + + + const + int + MongoDB\Driver\Server::TYPE_RS_OTHER + 7 + + + const + int + MongoDB\Driver\Server::TYPE_RS_GHOST + 8 + + + const + int + MongoDB\Driver\Server::TYPE_LOAD_BALANCER + 9 + + + &Methods; + + + + +
+ + +
+ &reftitle.constants; + + + + MongoDB\Driver\Server::TYPE_UNKNOWN + + Unbekannter Servertyp, zurückgegeben von MongoDB\Driver\Server::getType. + + + + + MongoDB\Driver\Server::TYPE_STANDALONE + + Eigenständiger Servertyp, zurückgegeben von MongoDB\Driver\Server::getType. + + + + + MongoDB\Driver\Server::TYPE_MONGOS + + Mongos-Servertyp, zurückgegeben von MongoDB\Driver\Server::getType. + + + + + MongoDB\Driver\Server::TYPE_POSSIBLE_PRIMARY + + Möglicher Primary-Servertyp eines Replica Sets, zurückgegeben von MongoDB\Driver\Server::getType. + Ein Server kann als möglicher Primary identifiziert werden, wenn er noch nicht überprüft wurde, ein anderes Mitglied des Replica Sets ihn jedoch für den Primary hält. + + + + + MongoDB\Driver\Server::TYPE_RS_PRIMARY + + Primary-Servertyp eines Replica Sets, zurückgegeben von MongoDB\Driver\Server::getType. + + + + + MongoDB\Driver\Server::TYPE_RS_SECONDARY + + Secondary-Servertyp eines Replica Sets, zurückgegeben von MongoDB\Driver\Server::getType. + + + + + MongoDB\Driver\Server::TYPE_RS_ARBITER + + Arbiter-Servertyp eines Replica Sets, zurückgegeben von MongoDB\Driver\Server::getType. + + + + + MongoDB\Driver\Server::TYPE_RS_OTHER + + Sonstiger Servertyp eines Replica Sets, zurückgegeben von MongoDB\Driver\Server::getType. + Solche Server können verborgen sein, gerade starten oder sich in der Wiederherstellung befinden. Sie können nicht abgefragt werden, ihre Host-Listen sind jedoch nützlich, um die aktuelle Konfiguration des Replica Sets zu ermitteln. + + + + + MongoDB\Driver\Server::TYPE_RS_GHOST + + Ghost-Servertyp eines Replica Sets, zurückgegeben von MongoDB\Driver\Server::getType. + Server können in mindestens drei Situationen als solche identifiziert werden: kurzzeitig während des Serverstarts; in einem nicht initialisierten Replica Set; oder wenn der Server gemieden wird (d. h. aus der Konfiguration des Replica Sets entfernt wurde). Sie können nicht abgefragt werden, und ihre Host-Liste kann auch nicht zur Ermittlung der aktuellen Konfiguration des Replica Sets verwendet werden; der Client kann diesen Server jedoch in der Hoffnung überwachen, dass er in einen nützlicheren Zustand übergeht. + + + + + MongoDB\Driver\Server::TYPE_LOAD_BALANCER + + Load-Balancer-Servertyp, zurückgegeben von MongoDB\Driver\Server::getType. + + + + +
+ + +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + + PECL mongodb 1.11.0 + + + Die Konstante + MongoDB\Driver\Server::TYPE_LOAD_BALANCER + wurde hinzugefügt. + + + + + + +
+ + + + &reference.mongodb.mongodb.driver.entities.server; + + + + diff --git a/reference/mongodb/mongodb/driver/session.xml b/reference/mongodb/mongodb/driver/session.xml new file mode 100644 index 000000000..92382c20f --- /dev/null +++ b/reference/mongodb/mongodb/driver/session.xml @@ -0,0 +1,159 @@ + + + + + + + Die Klasse MongoDB\Driver\Session + MongoDB\Driver\Session + + + + +
+ &reftitle.intro; + + Die Klasse MongoDB\Driver\Session repräsentiert eine + Client-Sitzung und wird von + MongoDB\Driver\Manager::startSession zurückgegeben. + Befehle, Abfragen und Schreiboperationen können anschließend mit der Sitzung + verknüpft werden. + +
+ + +
+ &reftitle.classsynopsis; + + + + MongoDB\Driver\Session + + + + final + + MongoDB\Driver\Session + + + + + &Constants; + + const + string + MongoDB\Driver\Session::TRANSACTION_NONE + none + + + const + string + MongoDB\Driver\Session::TRANSACTION_STARTING + starting + + + const + string + MongoDB\Driver\Session::TRANSACTION_IN_PROGRESS + in_progress + + + const + string + MongoDB\Driver\Session::TRANSACTION_COMMITTED + committed + + + const + string + MongoDB\Driver\Session::TRANSACTION_ABORTED + aborted + + + &Methods; + + + + +
+ + +
+ &reftitle.constants; + + + + MongoDB\Driver\Session::TRANSACTION_NONE + + + Es ist keine Transaktion im Gange. + + + + + + MongoDB\Driver\Session::TRANSACTION_STARTING + + + Eine Transaktion wurde gestartet, aber es wurde noch keine Operation an den Server gesendet. + + + + + + MongoDB\Driver\Session::TRANSACTION_IN_PROGRESS + + + Eine Transaktion ist im Gange. + + + + + + MongoDB\Driver\Session::TRANSACTION_COMMITTED + + + Die Transaktion wurde bestätigt. + + + + + + MongoDB\Driver\Session::TRANSACTION_ABORTED + + + Die Transaktion wurde abgebrochen. + + + + + +
+ + + + + &reference.mongodb.mongodb.driver.entities.session; + + + +