Skip to content

Sync EN: mongodb driver Server, ServerApi, ServerDescription, TopologyDescription #749

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
lacatoire wants to merge 1 commit into from
Closed

Sync EN: mongodb driver Server, ServerApi, ServerDescription, TopologyDescription #749

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 38 additions & 40 deletions reference/mongodb/mongodb/driver/server.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<reference xml:id="class.mongodb-driver-server" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

Expand All @@ -11,9 +11,9 @@
<!-- {{{ MongoDB\Driver\Server intro -->
<section xml:id="mongodb-driver-server.intro">
&reftitle.intro;
<para>
<simpara>

</para>
</simpara>
</section>
<!-- }}} -->

Expand Down Expand Up @@ -109,73 +109,73 @@
<varlistentry xml:id="mongodb-driver-server.constants.type-unknown">
<term><constant>MongoDB\Driver\Server::TYPE_UNKNOWN</constant></term>
<listitem>
<para>Tipo de servidor desconhecido, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<simpara>Tipo de servidor desconhecido, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-standalone">
<term><constant>MongoDB\Driver\Server::TYPE_STANDALONE</constant></term>
<listitem>
<para>Tipo de servidor autônomo, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<simpara>Tipo de servidor autônomo, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-mongos">
<term><constant>MongoDB\Driver\Server::TYPE_MONGOS</constant></term>
<listitem>
<para>Tipo de servidor Mongos, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<simpara>Tipo de servidor Mongos, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-possible-primary">
<term><constant>MongoDB\Driver\Server::TYPE_POSSIBLE_PRIMARY</constant></term>
<listitem>
<para>Tipo de servidor conjunto de réplicas, possivelmente primário, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<para>Um servidor pode ser identificado como um possível primário se ainda não tiver sido verificado, mas outra memória do conjunto de réplicas pensa que é o primário.</para>
<simpara>Tipo de servidor conjunto de réplicas, possivelmente primário, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
<simpara>Um servidor pode ser identificado como um possível primário se ainda não tiver sido verificado, mas outra memória do conjunto de réplicas pensa que é o primário.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-rs-primary">
<term><constant>MongoDB\Driver\Server::TYPE_RS_PRIMARY</constant></term>
<listitem>
<para>Tipo de servidor conjunto de réplicas primário, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<simpara>Tipo de servidor conjunto de réplicas primário, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-rs-secondary">
<term><constant>MongoDB\Driver\Server::TYPE_RS_SECONDARY</constant></term>
<listitem>
<para>Tipo de servidor conjunto de réplicas secundário, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<simpara>Tipo de servidor conjunto de réplicas secundário, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-rs-arbiter">
<term><constant>MongoDB\Driver\Server::TYPE_RS_ARBITER</constant></term>
<listitem>
<para>Tipo de servidor conjunto de réplicas árbitro, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<simpara>Tipo de servidor conjunto de réplicas árbitro, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-rs-other">
<term><constant>MongoDB\Driver\Server::TYPE_RS_OTHER</constant></term>
<listitem>
<para>Tipo de servidor conjunto de réplicas outros, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<para>Esses servidores podem estar ocultos, inicializando ou recuperando. Eles não podem ser consultados, mas suas listas de hosts são úteis para descobrir a configuração atual do conjunto de réplicas.</para>
<simpara>Tipo de servidor conjunto de réplicas outros, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
<simpara>Esses servidores podem estar ocultos, inicializando ou recuperando. Eles não podem ser consultados, mas suas listas de hosts são úteis para descobrir a configuração atual do conjunto de réplicas.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-rs-ghost">
<term><constant>MongoDB\Driver\Server::TYPE_RS_GHOST</constant></term>
<listitem>
<para>Tipo de servidor conjunto de réplicas fantasma, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<para>Os servidores podem ser identificados como tal em pelo menos três situações: brevemente durante a inicialização do servidor; em um conjunto de réplicas não inicializado; ou quando o servidor é evitado (ou seja, removido da configuração do conjunto de réplicas). Eles não podem ser consultados, nem sua lista de hosts pode ser usada para descobrir a configuração atual do conjunto de réplicas; entretanto, o cliente pode monitorar este servidor na esperança de que ele faça a transição para um estado mais útil.</para>
<simpara>Tipo de servidor conjunto de réplicas fantasma, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
<simpara>Os servidores podem ser identificados como tal em pelo menos três situações: brevemente durante a inicialização do servidor; em um conjunto de réplicas não inicializado; ou quando o servidor é evitado (ou seja, removido da configuração do conjunto de réplicas). Eles não podem ser consultados, nem sua lista de hosts pode ser usada para descobrir a configuração atual do conjunto de réplicas; entretanto, o cliente pode monitorar este servidor na esperança de que ele faça a transição para um estado mais útil.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-driver-server.constants.type-load-balancer">
<term><constant>MongoDB\Driver\Server::TYPE_LOAD_BALANCER</constant></term>
<listitem>
<para>Tipo de servidor balanceador de carga, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</para>
<simpara>Tipo de servidor balanceador de carga, retornada por <methodname>MongoDB\Driver\Server::getType</methodname>.</simpara>
</listitem>
</varlistentry>

Expand All @@ -185,30 +185,28 @@

<section role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 1.11.0</entry>
<entry>
<para>
A constante
<constant>MongoDB\Driver\Server::TYPE_LOAD_BALANCER</constant>
foi adicionada.
</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 1.11.0</entry>
<entry>
<simpara>
A constante
<constant>MongoDB\Driver\Server::TYPE_LOAD_BALANCER</constant>
foi adicionada.
</simpara>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>
Expand Down
6 changes: 3 additions & 3 deletions reference/mongodb/mongodb/driver/server/construct.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dcfd0933c0adfb15d1efafa5c553b2e57c03d3a0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<refentry xml:id="mongodb-driver-server.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -13,13 +13,13 @@
<modifier>final</modifier> <modifier>private</modifier> <methodname>MongoDB\Driver\Server::__construct</methodname>
<void />
</methodsynopsis>
<para>
<simpara>
Os objetos <classname>MongoDB\Driver\Server</classname> são criados internamente
pelo <classname>MongoDB\Driver\Manager</classname> quando uma conexão com o banco de dados
é estabelecida e podem ser retornados por
<function>MongoDB\Driver\Manager::getServers</function> e
<function>MongoDB\Driver\Manager::selectServer</function>.
</para>
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand Down
120 changes: 59 additions & 61 deletions reference/mongodb/mongodb/driver/server/executebulkwrite.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4639881688d3faaf0073ad71fe0a4b730aea15a0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<refentry xml:id="mongodb-driver-server.executebulkwrite" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -15,21 +15,21 @@
<methodparam><type>MongoDB\Driver\BulkWrite</type><parameter>bulk</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Executa uma ou mais operações de gravação neste servidor.
</para>
<para>
</simpara>
<simpara>
Um <classname>MongoDB\Driver\BulkWrite</classname> pode ser construído com
uma ou mais operações de gravação de vários tipos (por exemplo, atualizações, exclusões e
inserções). O driver tentará enviar operações do mesmo tipo ao
servidor no menor número possível de solicitações para otimizar viagens de ida e volta.
</para>
<para>
</simpara>
<simpara>
O valor padrão para a opção <literal>"writeConcern"</literal> será
inferido de uma transação ativa (indicada pela
opção <literal>"session"</literal>), seguida pelo
<link linkend="mongodb-driver-manager.construct-uri">URI de conexão</link>.
</para>
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand Down Expand Up @@ -82,60 +82,58 @@

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 2.0.0</entry>
<entry>
O parâmetro <parameter>options</parameter> não aceita mais uma instância de
<classname>MongoDB\Driver\WriteConcern</classname>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.21.0</entry>
<entry>
Passar um objeto <classname>MongoDB\Driver\WriteConcern</classname> como
<parameter>options</parameter> foi descontinuado e será removido na versão 2.0.
</entry>
</row>
<row>
<entry>PECL mongodb 1.4.4</entry>
<entry>
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
será lançada se a opção <literal>"session"</literal> for usada em combinação
com uma preocupação de gravação não reconhecida.
</entry>
</row>
<row>
<entry>PECL mongodb 1.4.0</entry>
<entry>
O terceiro parâmetro agora é um array <parameter>options</parameter>.
Para compatibilidade com versões anteriores, esse parâmetro ainda aceitará
um objeto <classname>MongoDB\Driver\WriteConcern</classname>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.3.0</entry>
<entry>
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
agora é lançada se <parameter>bulk</parameter> não contiver nenhuma operação
de gravação. Anteriormente, uma
<classname>MongoDB\Driver\Exception\BulkWriteException</classname> era
lançada.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 2.0.0</entry>
<entry>
O parâmetro <parameter>options</parameter> não aceita mais uma instância de
<classname>MongoDB\Driver\WriteConcern</classname>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.21.0</entry>
<entry>
Passar um objeto <classname>MongoDB\Driver\WriteConcern</classname> como
<parameter>options</parameter> foi descontinuado e será removido na versão 2.0.
</entry>
</row>
<row>
<entry>PECL mongodb 1.4.4</entry>
<entry>
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
será lançada se a opção <literal>"session"</literal> for usada em combinação
com uma preocupação de gravação não reconhecida.
</entry>
</row>
<row>
<entry>PECL mongodb 1.4.0</entry>
<entry>
O terceiro parâmetro agora é um array <parameter>options</parameter>.
Para compatibilidade com versões anteriores, esse parâmetro ainda aceitará
um objeto <classname>MongoDB\Driver\WriteConcern</classname>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.3.0</entry>
<entry>
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
agora é lançada se <parameter>bulk</parameter> não contiver nenhuma operação
de gravação. Anteriormente, uma
<classname>MongoDB\Driver\Exception\BulkWriteException</classname> era
lançada.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="notes">
Expand Down
14 changes: 7 additions & 7 deletions reference/mongodb/mongodb/driver/server/executebulkwritecommand.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 187032b3ea20fa28f1c9f29ba38d06820428f849 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<refentry xml:id="mongodb-driver-server.executebulkwritecommand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -14,22 +14,22 @@
<methodparam><type>MongoDB\Driver\BulkWriteCommand</type><parameter>bulk</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Executa uma ou mais operações de gravação neste servidor usando o comando
<link xlink:href="&url.mongodb.docs.command;bulkWrite">bulkWrite</link>
introduzido no MongoDB 8.0.
</para>
<para>
</simpara>
<simpara>
Um <classname>MongoDB\Driver\BulkWriteCommand</classname> pode ser construído
com uma ou mais operações de gravação de tipos variados (por exemplo, inserções, atualizações
e exclusões). Cada operação de gravação pode ter como alvo uma coleção diferente.
</para>
<para>
</simpara>
<simpara>
O valor padrão para a opção <literal>"writeConcern"</literal> será
inferido a partir de uma transação ativa (indicada pela opção
<literal>"session"</literal>), seguida pelo
<link linkend="mongodb-driver-manager.construct-uri">URI de conexão</link>.
</para>
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand Down
Loading
Loading