MongoDB\Driver\BulkWriteCommand::__construct

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommand::__construct ā€” Cria um novo BulkWriteCommand

DescriĆ§Ć£o

public function MongoDB\Driver\BulkWriteCommand::__construct(?array $options = null)

Cria um novo MongoDB\Driver\BulkWriteCommand, que pode ser usado para executar diversas operaƧƵes de inserĆ§Ć£o, atualizaĆ§Ć£o e exclusĆ£o em vĆ”rias coleƧƵes em uma Ćŗnica solicitaĆ§Ć£o usando o comando Ā»Ā bulkWrite introduzido no MongoDB 8.0. Isso difere de MongoDB\Driver\BulkWrite, que Ć© suportado por todas as versƵes do servidor, mas limitado a uma Ćŗnica coleĆ§Ć£o.

ApĆ³s todas as operaƧƵes de gravaĆ§Ć£o terem sido adicionadas, este objeto pode ser executado com MongoDB\Driver\Manager::executeBulkWriteCommand().

ParĆ¢metros

options (array)

OpƧƵes
OpĆ§Ć£o Tipo DescriĆ§Ć£o PadrĆ£o
bypassDocumentValidation bool Se true, permite que operaƧƵes de inserĆ§Ć£o e atualizaĆ§Ć£o contornem a validaĆ§Ć£o em nĆ­vel de documento. false
comment mixed Um comentĆ”rio arbitrĆ”rio para ajudar a rastrear a operaĆ§Ć£o por meio do profiler do banco de dados, da saĆ­da currentOp e dos registros.
let array|object Mapa de nomes e valores de parĆ¢metros. Os valores devem ser expressƵes constantes ou fechadas que nĆ£o fazem referĆŖncia a campos do documento. Os parĆ¢metros podem entĆ£o ser acessados como variĆ”veis em um contexto de expressĆ£o agregada (por exemplo, $$var). Esta opĆ§Ć£o estĆ” disponĆ­vel no MongoDB 5.0+ e resultarĆ” em uma exceĆ§Ć£o em tempo de execuĆ§Ć£o se for especificada para uma versĆ£o de servidor mais antiga.
ordered bool Se as operaƧƵes nesta gravaĆ§Ć£o em massa devem ser executadas na ordem em que foram especificadas. Se false, as gravaƧƵes continuarĆ£o a ser executadas se uma gravaĆ§Ć£o individual falhar. Se true, as gravaƧƵes deixarĆ£o de ser executadas se uma gravaĆ§Ć£o individual falhar. true
verboseResults bool Se os resultados detalhados de cada operaĆ§Ć£o bem-sucedida devem ser incluĆ­dos no MongoDB\Driver\BulkWriteCommandResult retornado. false

Erros/ExceƧƵes

Exemplos

Exemplo #1 Exemplo de MongoDB\Driver\BulkWriteCommand::__construct()

<?php

$manager = new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand;

// Exclui documentos de ambas as coleƧƵes
$bulk->deleteMany('db.coll_one', []);
$bulk->deleteMany('db.coll_two', []);

// Insere documentos em duas coleƧƵes
$bulk->insertOne('db.coll_one', ['_id' => 1]);
$bulk->insertOne('db.coll_two', ['_id' => 2]);
$bulk->insertOne('db.coll_two', ['_id' => 3]);

// Atualiza um documento em "coll_one"
$bulk->updateOne('db.coll_one', ['_id' => 1], ['$set' => ['x' => 1]]);

$result = $manager->executeBulkWriteCommand($bulk);

printf("Inserido(s) %d documento(s)\n", $result->getInsertedCount());
printf("Atualizado(s) %d documento(s)\n", $result->getModifiedCount());

?>

O exemplo acima produzirĆ”:

Inserido(s) 3 documento(s)
Atualizado(s) 1 documento(s)

Veja TambƩm

Melhore Esta PƔgina

Aprenda Como Melhorar Esta PĆ”gina ā€¢ Envie uma SolicitaĆ§Ć£o de ModificaĆ§Ć£o ā€¢ Reporte um Problema
ļ¼‹adicionar nota

Notas de UsuƔrios

NĆ£o hĆ” notas de usuĆ”rios para esta pĆ”gina.