array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'mongodb-driver-server.executequery.php', 1 => 'MongoDB\\Driver\\Server::executeQuery', 2 => 'Executa uma consulta de banco de dados neste servidor', ), 'up' => array ( 0 => 'class.mongodb-driver-server.php', 1 => 'MongoDB\\Driver\\Server', ), 'prev' => array ( 0 => 'mongodb-driver-server.executecommand.php', 1 => 'MongoDB\\Driver\\Server::executeCommand', ), 'next' => array ( 0 => 'mongodb-driver-server.executereadcommand.php', 1 => 'MongoDB\\Driver\\Server::executeReadCommand', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mongodb/mongodb/driver/server/executequery.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\Driver\Server::executeQuery

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeQuery — Executa uma consulta de banco de dados neste servidor

Descrição

final public MongoDB\Driver\Server::executeQuery(string $namespace, MongoDB\Driver\Query $query, ?array $options = null): MongoDB\Driver\Cursor

Executa a consulta neste servidor.

Os valores padrão para a opção "readPreference" e para a opção "readConcern" da consulta serão inferidos de uma transação ativa (indicada pela opção "session"), seguida pelo URI de conexão.

Nota: A opção "readPreference" não controla o servidor ao qual o driver emite a operação; ela sempre será executada neste objeto servidor. Em vez disso, ela pode ser usada ao emitir a operação para um servidor secundário (de uma conexão de conjunto de réplicas, não autônomas) ou nós mongo para garantir que o driver defina o protocolo de conexão de acordo ou adicione a preferência de leitura à operação, respectivamente.

Parâmetros

namespace (string)

Um namespace totalmente qualificado (por exemplo, "nomeDoBancoDados.nomeDaColecao").

query (MongoDB\Driver\Query)

A consulta a ser executada.

options

Opções
Opção Tipo Descrição
readPreference MongoDB\Driver\ReadPreference

Uma preferência de leitura a ser usada para selecionar um servidor para a operação.

session MongoDB\Driver\Session

Uma sessão para associar à operação.

Valor Retornado

Retorna MongoDB\Driver\Cursor em caso de sucesso.

Erros/Exceções

Registro de Alterações

Versão Descrição
PECL mongodb 2.0.0 O parâmetro options não aceita mais uma instância de MongoDB\Driver\ReadPreference.
PECL mongodb 1.21.0 Passar um objeto MongoDB\Driver\ReadPreference como options foi descontinuado e será removido na versão 2.0.
PECL mongodb 1.4.0 O terceiro parâmetro agora é um array options. Para compatibilidade com versões anteriores, esse parâmetro ainda aceitará um objeto MongoDB\Driver\ReadPreference.

Veja Também