GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MONGODB::BULKWRITEVIEW (3)

.ds Aq ’

NAME

MongoDB::BulkWriteView - Bulk write operations against a query document

CONTENTS

VERSION

version v1.2.3

SYNOPSIS



    my $bulk = $collection->initialize_ordered_bulk_op;

    # Update one document matching the selector
    bulk->find( { a => 1 } )->update_one( { $inc => { x => 1 } } );

    # Update all documents matching the selector
    bulk->find( { a => 2 } )->update_many( { $inc => { x => 2 } } );

    # Update all documents
    bulk->find( {} )->update_many( { $inc => { x => 2 } } );

    # Replace entire document (update with whole doc replace)
    bulk->find( { a => 3 } )->replace_one( { x => 3 } );

    # Update one document matching the selector or upsert
    bulk->find( { a => 1 } )->upsert()->update_one( { $inc => { x => 1 } } );

    # Update all documents matching the selector or upsert
    bulk->find( { a => 2 } )->upsert()->update_many( { $inc => { x => 2 } } );

    # Replaces a single document matching the selector or upsert
    bulk->find( { a => 3 } )->upsert()->replace_one( { x => 3 } );

    # Remove a single document matching the selector
    bulk->find( { a => 4 } )->delete_one();

    # Remove all documents matching the selector
    bulk->find( { a => 5 } )->delete_many();

    # Remove all documents
    bulk->find( {} )->delete_many();



DESCRIPTION

This class provides means to specify write operations constrained by a query document.

To instantiate a MongoDB::BulkWriteView, use the find method from MongoDB::BulkWrite or the upsert method described below.

Except for upsert, all methods have an empty return on success; an exception will be thrown on error.

METHODS

    delete_many



    $bulk->delete_many;



Removes all documents matching the query document.

    delete_one



    $bulk->delete_one;



Removes a single document matching the query document.

    replace_one



    $bulk->replace_one( $doc );



Replaces the document matching the query document. The document to replace must not have any keys that begin with a dollar sign, $.

    update_many



    $bulk->update_many( $modification );



Updates all documents matching the query document. The modification document must have all its keys begin with a dollar sign, $.

    update_one



    $bulk->update_one( $modification );



Updates a single document matching the query document. The modification document must have all its keys begin with a dollar sign, $.

    upsert



    $bulk->upsert->replace_one( $doc );



Returns a new MongoDB::BulkWriteView object that will treat every update, update_one or replace_one operation as an upsert operation.

AUTHORS

o David Golden <david@mongodb.com>
o Mike Friedman <friedo@friedo.com>
o Kristina Chodorow <k.chodorow@gmail.com>
o Florian Ragwitz <rafl@debian.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2016 by MongoDB, Inc..

This is free software, licensed under:



  The Apache License, Version 2.0, January 2004



Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MONGODB::BULKWRITEVIEW (3) 2016-03-08

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.