mongo 1.12.5 → 2.0.0.beta
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +0 -0
- data.tar.gz.sig +0 -0
- data/CONTRIBUTING.md +64 -0
- data/LICENSE +1 -1
- data/README.md +23 -125
- data/Rakefile +26 -21
- data/bin/mongo_console +6 -38
- data/lib/mongo.rb +23 -82
- data/lib/mongo/address.rb +111 -0
- data/lib/mongo/address/ipv4.rb +85 -0
- data/lib/mongo/address/ipv6.rb +85 -0
- data/lib/mongo/address/unix.rb +76 -0
- data/lib/mongo/auth.rb +108 -0
- data/lib/mongo/auth/cr.rb +44 -0
- data/lib/mongo/auth/cr/conversation.rb +119 -0
- data/lib/mongo/auth/executable.rb +52 -0
- data/lib/mongo/auth/ldap.rb +48 -0
- data/lib/mongo/auth/ldap/conversation.rb +92 -0
- data/lib/mongo/auth/roles.rb +104 -0
- data/lib/mongo/auth/scram.rb +53 -0
- data/lib/mongo/auth/scram/conversation.rb +450 -0
- data/lib/mongo/auth/user.rb +159 -0
- data/lib/mongo/auth/user/view.rb +102 -0
- data/lib/mongo/auth/x509.rb +48 -0
- data/lib/mongo/auth/x509/conversation.rb +92 -0
- data/lib/mongo/{gridfs.rb → bulk.rb} +2 -5
- data/lib/mongo/bulk/bulk_write.rb +307 -0
- data/lib/mongo/client.rb +233 -0
- data/lib/mongo/cluster.rb +203 -0
- data/lib/mongo/cluster/topology.rb +60 -0
- data/lib/mongo/cluster/topology/replica_set.rb +160 -0
- data/lib/mongo/cluster/topology/sharded.rb +132 -0
- data/lib/mongo/cluster/topology/standalone.rb +132 -0
- data/lib/mongo/cluster/topology/unknown.rb +155 -0
- data/lib/mongo/collection.rb +130 -1101
- data/lib/mongo/collection/view.rb +169 -0
- data/lib/mongo/collection/view/aggregation.rb +108 -0
- data/lib/mongo/collection/view/explainable.rb +49 -0
- data/lib/mongo/collection/view/immutable.rb +43 -0
- data/lib/mongo/collection/view/iterable.rb +48 -0
- data/lib/mongo/collection/view/map_reduce.rb +191 -0
- data/lib/mongo/collection/view/readable.rb +363 -0
- data/lib/mongo/collection/view/writable.rb +169 -0
- data/lib/mongo/cursor.rb +79 -680
- data/lib/mongo/database.rb +224 -0
- data/lib/mongo/database/view.rb +101 -0
- data/lib/mongo/error.rb +81 -0
- data/lib/mongo/error/bulk_write_failure.rb +41 -0
- data/lib/mongo/{utils/thread_local_variable_manager.rb → error/empty_batch.rb} +22 -8
- data/{test/functional/db_connection_test.rb → lib/mongo/error/invalid_bulk_operation.rb} +19 -8
- data/lib/mongo/error/invalid_collection_name.rb +39 -0
- data/lib/mongo/error/invalid_database_name.rb +39 -0
- data/{test/replica_set/ssl_test.rb → lib/mongo/error/invalid_document.rb} +21 -14
- data/lib/mongo/error/invalid_file.rb +38 -0
- data/lib/mongo/error/invalid_nonce.rb +46 -0
- data/lib/mongo/error/invalid_replacement_document.rb +39 -0
- data/lib/mongo/error/invalid_signature.rb +47 -0
- data/{test/functional/ssl_test.rb → lib/mongo/error/invalid_update_document.rb} +22 -12
- data/lib/mongo/error/max_bson_size.rb +40 -0
- data/lib/mongo/error/max_message_size.rb +42 -0
- data/lib/mongo/{utils.rb → error/need_primary_server.rb} +10 -6
- data/lib/mongo/{connection.rb → error/operation_failure.rb} +10 -6
- data/lib/mongo/error/parser.rb +77 -0
- data/lib/mongo/{connection/socket.rb → error/socket_error.rb} +10 -5
- data/lib/mongo/error/socket_timeout_error.rb +23 -0
- data/lib/mongo/error/unsupported_features.rb +43 -0
- data/lib/mongo/event.rb +40 -0
- data/lib/mongo/event/listeners.rb +63 -0
- data/lib/mongo/event/primary_elected.rb +53 -0
- data/lib/mongo/event/publisher.rb +42 -0
- data/lib/mongo/event/server_added.rb +53 -0
- data/lib/mongo/event/server_removed.rb +53 -0
- data/lib/mongo/event/subscriber.rb +41 -0
- data/lib/mongo/grid.rb +16 -0
- data/lib/mongo/grid/file.rb +94 -0
- data/lib/mongo/grid/file/chunk.rb +184 -0
- data/lib/mongo/grid/file/metadata.rb +223 -0
- data/lib/mongo/grid/fs.rb +149 -0
- data/lib/mongo/index.rb +64 -0
- data/lib/mongo/index/view.rb +205 -0
- data/lib/mongo/loggable.rb +126 -0
- data/lib/mongo/logger.rb +132 -0
- data/lib/mongo/operation.rb +26 -0
- data/lib/mongo/operation/aggregate.rb +100 -0
- data/lib/mongo/operation/aggregate/result.rb +84 -0
- data/lib/mongo/operation/batchable.rb +103 -0
- data/lib/mongo/operation/bulk_delete/result.rb +197 -0
- data/lib/mongo/operation/bulk_insert/result.rb +195 -0
- data/lib/mongo/operation/bulk_update/result.rb +295 -0
- data/lib/mongo/operation/command.rb +62 -0
- data/lib/mongo/operation/executable.rb +105 -0
- data/lib/mongo/operation/kill_cursors.rb +39 -0
- data/lib/mongo/operation/limited.rb +37 -0
- data/lib/mongo/operation/list_collections/result.rb +116 -0
- data/lib/mongo/operation/list_indexes/result.rb +118 -0
- data/lib/mongo/operation/map_reduce.rb +96 -0
- data/lib/mongo/operation/map_reduce/result.rb +122 -0
- data/lib/mongo/{functional.rb → operation/read.rb} +7 -7
- data/lib/mongo/operation/read/collections_info.rb +67 -0
- data/lib/mongo/operation/read/get_more.rb +71 -0
- data/lib/mongo/operation/read/indexes.rb +68 -0
- data/lib/mongo/operation/read/list_collections.rb +75 -0
- data/lib/mongo/operation/read/list_indexes.rb +77 -0
- data/lib/mongo/operation/read/query.rb +71 -0
- data/lib/mongo/operation/read_preferrable.rb +34 -0
- data/lib/mongo/operation/result.rb +259 -0
- data/lib/mongo/operation/specifiable.rb +380 -0
- data/lib/mongo/operation/write.rb +25 -0
- data/lib/mongo/operation/write/bulk_delete.rb +158 -0
- data/lib/mongo/operation/write/bulk_insert.rb +160 -0
- data/lib/mongo/operation/write/bulk_update.rb +167 -0
- data/lib/mongo/{connection/socket/socket_util.rb → operation/write/command.rb} +9 -24
- data/lib/mongo/operation/write/command/create_user.rb +43 -0
- data/lib/mongo/operation/write/command/delete.rb +56 -0
- data/lib/mongo/operation/write/command/drop_index.rb +51 -0
- data/lib/mongo/operation/write/command/ensure_index.rb +55 -0
- data/lib/mongo/operation/write/command/insert.rb +55 -0
- data/lib/mongo/operation/write/command/remove_user.rb +42 -0
- data/lib/mongo/operation/write/command/update.rb +60 -0
- data/lib/mongo/operation/write/command/writable.rb +61 -0
- data/lib/mongo/operation/write/create_index.rb +84 -0
- data/lib/mongo/operation/write/create_user.rb +75 -0
- data/lib/mongo/operation/write/delete.rb +91 -0
- data/lib/mongo/operation/write/drop_index.rb +62 -0
- data/lib/mongo/operation/write/insert.rb +88 -0
- data/lib/mongo/operation/write/remove_user.rb +70 -0
- data/lib/mongo/operation/write/update.rb +98 -0
- data/lib/mongo/protocol.rb +15 -0
- data/lib/mongo/protocol/bit_vector.rb +61 -0
- data/lib/mongo/protocol/delete.rb +94 -0
- data/lib/mongo/protocol/get_more.rb +99 -0
- data/lib/mongo/protocol/insert.rb +99 -0
- data/lib/mongo/protocol/kill_cursors.rb +74 -0
- data/lib/mongo/protocol/message.rb +252 -0
- data/lib/mongo/protocol/query.rb +147 -0
- data/lib/mongo/protocol/reply.rb +72 -0
- data/lib/mongo/protocol/serializers.rb +180 -0
- data/lib/mongo/protocol/update.rb +111 -0
- data/lib/mongo/server.rb +163 -0
- data/lib/mongo/server/connectable.rb +99 -0
- data/lib/mongo/server/connection.rb +133 -0
- data/lib/mongo/server/connection_pool.rb +141 -0
- data/lib/mongo/server/connection_pool/queue.rb +182 -0
- data/lib/mongo/server/context.rb +66 -0
- data/lib/mongo/server/description.rb +450 -0
- data/lib/mongo/server/description/features.rb +85 -0
- data/lib/mongo/server/description/inspector.rb +79 -0
- data/lib/mongo/server/description/inspector/primary_elected.rb +58 -0
- data/lib/mongo/server/description/inspector/server_added.rb +59 -0
- data/lib/mongo/server/description/inspector/server_removed.rb +59 -0
- data/lib/mongo/server/monitor.rb +160 -0
- data/lib/mongo/server/monitor/connection.rb +88 -0
- data/lib/mongo/server_selector.rb +81 -0
- data/lib/mongo/server_selector/nearest.rb +94 -0
- data/lib/mongo/server_selector/primary.rb +88 -0
- data/lib/mongo/server_selector/primary_preferred.rb +94 -0
- data/lib/mongo/server_selector/secondary.rb +91 -0
- data/lib/mongo/server_selector/secondary_preferred.rb +96 -0
- data/lib/mongo/server_selector/selectable.rb +209 -0
- data/lib/mongo/socket.rb +179 -0
- data/lib/mongo/socket/ssl.rb +108 -0
- data/lib/mongo/socket/tcp.rb +69 -0
- data/lib/mongo/socket/unix.rb +66 -0
- data/lib/mongo/uri.rb +504 -0
- data/lib/mongo/version.rb +21 -0
- data/lib/mongo/write_concern.rb +99 -0
- data/lib/mongo/write_concern/acknowledged.rb +38 -0
- data/lib/mongo/write_concern/normalizable.rb +73 -0
- data/lib/mongo/write_concern/unacknowledged.rb +43 -0
- data/mongo.gemspec +17 -14
- data/spec/mongo/address/ipv4_spec.rb +74 -0
- data/spec/mongo/address/ipv6_spec.rb +74 -0
- data/spec/mongo/address/unix_spec.rb +30 -0
- data/spec/mongo/address_spec.rb +206 -0
- data/spec/mongo/auth/cr_spec.rb +59 -0
- data/spec/mongo/auth/ldap_spec.rb +40 -0
- data/spec/mongo/auth/scram/conversation_spec.rb +197 -0
- data/spec/mongo/auth/scram_spec.rb +55 -0
- data/spec/mongo/auth/user/view_spec.rb +76 -0
- data/spec/mongo/auth/user_spec.rb +190 -0
- data/spec/mongo/auth/x509_spec.rb +40 -0
- data/spec/mongo/auth_spec.rb +65 -0
- data/spec/mongo/bulk/bulk_write_spec.rb +175 -0
- data/spec/mongo/client_spec.rb +564 -0
- data/spec/mongo/cluster/topology/replica_set_spec.rb +101 -0
- data/spec/mongo/cluster/topology/sharded_spec.rb +74 -0
- data/spec/mongo/cluster/topology/standalone_spec.rb +79 -0
- data/spec/mongo/cluster/topology_spec.rb +65 -0
- data/spec/mongo/cluster_spec.rb +129 -0
- data/spec/mongo/collection/view/aggregation_spec.rb +135 -0
- data/spec/mongo/collection/view/explainable_spec.rb +32 -0
- data/spec/mongo/collection/view/map_reduce_spec.rb +242 -0
- data/spec/mongo/collection/view/readable_spec.rb +603 -0
- data/spec/mongo/collection/view/writable_spec.rb +504 -0
- data/spec/mongo/collection/view_spec.rb +521 -0
- data/spec/mongo/collection_spec.rb +362 -0
- data/spec/mongo/cursor_spec.rb +295 -0
- data/spec/mongo/database_spec.rb +306 -0
- data/spec/mongo/error/parser_spec.rb +119 -0
- data/spec/mongo/event/publisher_spec.rb +50 -0
- data/spec/mongo/event/subscriber_spec.rb +34 -0
- data/spec/mongo/grid/file/chunk_spec.rb +226 -0
- data/spec/mongo/grid/file/metadata_spec.rb +69 -0
- data/spec/mongo/grid/file_spec.rb +138 -0
- data/spec/mongo/grid/fs_spec.rb +129 -0
- data/spec/mongo/index/view_spec.rb +226 -0
- data/spec/mongo/loggable_spec.rb +62 -0
- data/spec/mongo/logger_spec.rb +97 -0
- data/spec/mongo/operation/aggregate/result_spec.rb +80 -0
- data/spec/mongo/operation/aggregate_spec.rb +135 -0
- data/spec/mongo/operation/command_spec.rb +106 -0
- data/spec/mongo/operation/kill_cursors_spec.rb +66 -0
- data/spec/mongo/operation/limited_spec.rb +50 -0
- data/spec/mongo/operation/map_reduce_spec.rb +143 -0
- data/spec/mongo/operation/read/collections_info_spec.rb +40 -0
- data/spec/mongo/operation/read/get_more_spec.rb +81 -0
- data/spec/mongo/operation/read/indexes_spec.rb +31 -0
- data/spec/mongo/operation/read/query_spec.rb +84 -0
- data/spec/mongo/operation/result_spec.rb +275 -0
- data/spec/mongo/operation/specifiable_spec.rb +53 -0
- data/spec/mongo/operation/write/bulk_delete_spec.rb +473 -0
- data/spec/mongo/operation/write/bulk_insert_spec.rb +466 -0
- data/spec/mongo/operation/write/bulk_update_spec.rb +524 -0
- data/spec/mongo/operation/write/command/delete_spec.rb +116 -0
- data/spec/mongo/operation/write/command/insert_spec.rb +117 -0
- data/spec/mongo/operation/write/command/update_spec.rb +123 -0
- data/spec/mongo/operation/write/create_user_spec.rb +44 -0
- data/spec/mongo/operation/write/delete_spec.rb +178 -0
- data/spec/mongo/operation/write/drop_index_spec.rb +51 -0
- data/spec/mongo/operation/write/ensure_index_spec.rb +81 -0
- data/spec/mongo/operation/write/insert_spec.rb +231 -0
- data/spec/mongo/operation/write/remove_user_spec.rb +46 -0
- data/spec/mongo/operation/write/response_spec.rb +85 -0
- data/spec/mongo/operation/write/update_spec.rb +177 -0
- data/spec/mongo/protocol/delete_spec.rb +167 -0
- data/spec/mongo/protocol/get_more_spec.rb +146 -0
- data/spec/mongo/protocol/insert_spec.rb +161 -0
- data/spec/mongo/protocol/kill_cursors_spec.rb +101 -0
- data/spec/mongo/protocol/query_spec.rb +285 -0
- data/spec/mongo/protocol/reply_spec.rb +157 -0
- data/spec/mongo/protocol/update_spec.rb +186 -0
- data/spec/mongo/server/connection_pool/queue_spec.rb +170 -0
- data/spec/mongo/server/connection_pool_spec.rb +120 -0
- data/spec/mongo/server/connection_spec.rb +289 -0
- data/spec/mongo/server/description/features_spec.rb +138 -0
- data/spec/mongo/server/description/inspector/primary_elected_spec.rb +94 -0
- data/spec/mongo/server/description/inspector/server_added_spec.rb +92 -0
- data/spec/mongo/server/description/inspector/server_removed_spec.rb +95 -0
- data/spec/mongo/server/description_spec.rb +510 -0
- data/spec/mongo/server/monitor_spec.rb +130 -0
- data/spec/mongo/server_discovery_and_monitoring_spec.rb +103 -0
- data/spec/mongo/server_selection_rtt_spec.rb +104 -0
- data/spec/mongo/server_selection_spec.rb +89 -0
- data/spec/mongo/server_selector/nearest_spec.rb +250 -0
- data/spec/mongo/server_selector/primary_preferred_spec.rb +290 -0
- data/spec/mongo/server_selector/primary_spec.rb +114 -0
- data/spec/mongo/server_selector/secondary_preferred_spec.rb +252 -0
- data/spec/mongo/server_selector/secondary_spec.rb +196 -0
- data/spec/mongo/server_selector_spec.rb +101 -0
- data/spec/mongo/server_spec.rb +131 -0
- data/spec/mongo/uri_spec.rb +517 -0
- data/spec/mongo/write_concern/acknowledged_spec.rb +44 -0
- data/spec/mongo/write_concern/unacknowledged_spec.rb +15 -0
- data/spec/mongo_orchestration_spec.rb +70 -0
- data/spec/spec_helper.rb +148 -0
- data/spec/support/authorization.rb +245 -0
- data/spec/support/helpers.rb +140 -0
- data/spec/support/matchers.rb +37 -0
- data/spec/support/mongo_orchestration.rb +61 -0
- data/spec/support/mongo_orchestration/requestable.rb +109 -0
- data/spec/support/mongo_orchestration/standalone.rb +57 -0
- data/spec/support/sdam/rs/discover_arbiters.yml +41 -0
- data/spec/support/sdam/rs/discover_passives.yml +41 -0
- data/spec/support/sdam/rs/discover_primary.yml +40 -0
- data/spec/support/sdam/rs/discover_secondary.yml +41 -0
- data/spec/support/sdam/rs/discovery.yml +195 -0
- data/spec/support/sdam/rs/ghost_discovered.yml +39 -0
- data/spec/support/sdam/rs/hosts_differ_from_seeds.yml +34 -0
- data/spec/support/sdam/rs/member_reconfig.yml +68 -0
- data/spec/support/sdam/rs/member_standalone.yml +60 -0
- data/spec/support/sdam/rs/new_primary.yml +74 -0
- data/spec/support/sdam/rs/new_primary_wrong_set_name.yml +71 -0
- data/spec/support/sdam/rs/non_rs_member.yml +31 -0
- data/spec/support/sdam/rs/normalize_case.yml +49 -0
- data/spec/support/sdam/rs/primary_becomes_standalone.yml +52 -0
- data/spec/support/sdam/rs/primary_changes_set_name.yml +57 -0
- data/spec/support/sdam/rs/primary_disconnect.yml +56 -0
- data/spec/support/sdam/rs/primary_wrong_set_name.yml +27 -0
- data/spec/support/sdam/rs/response_from_removed.yml +63 -0
- data/spec/support/sdam/rs/rsother_discovered.yml +41 -0
- data/spec/support/sdam/rs/sec_not_auth.yml +49 -0
- data/spec/support/sdam/rs/secondary_wrong_set_name.yml +28 -0
- data/spec/support/sdam/rs/secondary_wrong_set_name_with_primary.yml +69 -0
- data/spec/support/sdam/rs/unexpected_mongos.yml +26 -0
- data/spec/support/sdam/rs/wrong_set_name.yml +35 -0
- data/spec/support/sdam/sharded/multiple_mongoses.yml +46 -0
- data/spec/support/sdam/sharded/non_mongos_removed.yml +41 -0
- data/spec/support/sdam/sharded/normalize_uri_case.yml +32 -0
- data/spec/support/sdam/single/direct_connection_external_ip.yml +34 -0
- data/spec/support/sdam/single/direct_connection_mongos.yml +33 -0
- data/spec/support/sdam/single/direct_connection_rsarbiter.yml +35 -0
- data/spec/support/sdam/single/direct_connection_rsprimary.yml +34 -0
- data/spec/support/sdam/single/direct_connection_rssecondary.yml +35 -0
- data/spec/support/sdam/single/direct_connection_slave.yml +32 -0
- data/spec/support/sdam/single/direct_connection_standalone.yml +32 -0
- data/spec/support/sdam/single/not_ok_response.yml +39 -0
- data/spec/support/sdam/single/standalone_removed.yml +32 -0
- data/spec/support/sdam/single/unavailable_seed.yml +28 -0
- data/spec/support/server_discovery_and_monitoring.rb +167 -0
- data/spec/support/server_selection.rb +140 -0
- data/spec/support/server_selection/rtt/first_value.yml +4 -0
- data/spec/support/server_selection/rtt/first_value_zero.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_1.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_2.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_3.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_4.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_5.yml +4 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Primary.yml +23 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Nearest.yml +41 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Nearest_non_matching.yml +34 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Primary.yml +33 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/PrimaryPreferred.yml +39 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/PrimaryPreferred_non_matching.yml +36 -0
- data/spec/support/server_selection/selection/Sharded/read/SecondaryPreferred.yml +32 -0
- data/spec/support/server_selection/selection/Single/read/SecondaryPreferred.yml +23 -0
- data/spec/support/server_selection/selection/Unknown/read/SecondaryPreferred.yml +13 -0
- data/spec/support/server_selection_rtt.rb +41 -0
- data/spec/support/shared/bulk_write.rb +498 -0
- data/spec/support/shared/cursor.rb +38 -0
- data/spec/support/shared/operation.rb +77 -0
- data/spec/support/shared/protocol.rb +31 -0
- data/spec/support/shared/server_selector.rb +111 -0
- data/spec/support/shared/socket.rb +82 -0
- data/spec/support/travis.rb +14 -0
- metadata +523 -189
- metadata.gz.sig +0 -0
- data/VERSION +0 -1
- data/lib/mongo/bulk_write_collection_view.rb +0 -387
- data/lib/mongo/collection_writer.rb +0 -364
- data/lib/mongo/connection/node.rb +0 -249
- data/lib/mongo/connection/pool.rb +0 -340
- data/lib/mongo/connection/pool_manager.rb +0 -320
- data/lib/mongo/connection/sharding_pool_manager.rb +0 -67
- data/lib/mongo/connection/socket/ssl_socket.rb +0 -95
- data/lib/mongo/connection/socket/tcp_socket.rb +0 -87
- data/lib/mongo/connection/socket/unix_socket.rb +0 -39
- data/lib/mongo/db.rb +0 -808
- data/lib/mongo/exception.rb +0 -145
- data/lib/mongo/functional/authentication.rb +0 -455
- data/lib/mongo/functional/logging.rb +0 -85
- data/lib/mongo/functional/read_preference.rb +0 -183
- data/lib/mongo/functional/scram.rb +0 -556
- data/lib/mongo/functional/uri_parser.rb +0 -409
- data/lib/mongo/functional/write_concern.rb +0 -66
- data/lib/mongo/gridfs/grid.rb +0 -112
- data/lib/mongo/gridfs/grid_ext.rb +0 -53
- data/lib/mongo/gridfs/grid_file_system.rb +0 -163
- data/lib/mongo/gridfs/grid_io.rb +0 -484
- data/lib/mongo/legacy.rb +0 -140
- data/lib/mongo/mongo_client.rb +0 -697
- data/lib/mongo/mongo_replica_set_client.rb +0 -535
- data/lib/mongo/mongo_sharded_client.rb +0 -159
- data/lib/mongo/networking.rb +0 -372
- data/lib/mongo/utils/conversions.rb +0 -110
- data/lib/mongo/utils/core_ext.rb +0 -70
- data/lib/mongo/utils/server_version.rb +0 -69
- data/lib/mongo/utils/support.rb +0 -80
- data/test/functional/authentication_test.rb +0 -39
- data/test/functional/bulk_api_stress_test.rb +0 -133
- data/test/functional/bulk_write_collection_view_test.rb +0 -1198
- data/test/functional/client_test.rb +0 -627
- data/test/functional/collection_test.rb +0 -2175
- data/test/functional/collection_writer_test.rb +0 -83
- data/test/functional/conversions_test.rb +0 -163
- data/test/functional/cursor_fail_test.rb +0 -57
- data/test/functional/cursor_message_test.rb +0 -56
- data/test/functional/cursor_test.rb +0 -683
- data/test/functional/db_api_test.rb +0 -835
- data/test/functional/db_test.rb +0 -348
- data/test/functional/grid_file_system_test.rb +0 -285
- data/test/functional/grid_io_test.rb +0 -252
- data/test/functional/grid_test.rb +0 -273
- data/test/functional/pool_test.rb +0 -136
- data/test/functional/safe_test.rb +0 -98
- data/test/functional/support_test.rb +0 -62
- data/test/functional/timeout_test.rb +0 -60
- data/test/functional/uri_test.rb +0 -446
- data/test/functional/write_concern_test.rb +0 -118
- data/test/helpers/general.rb +0 -50
- data/test/helpers/test_unit.rb +0 -476
- data/test/replica_set/authentication_test.rb +0 -37
- data/test/replica_set/basic_test.rb +0 -189
- data/test/replica_set/client_test.rb +0 -393
- data/test/replica_set/connection_test.rb +0 -138
- data/test/replica_set/count_test.rb +0 -66
- data/test/replica_set/cursor_test.rb +0 -220
- data/test/replica_set/insert_test.rb +0 -157
- data/test/replica_set/max_values_test.rb +0 -151
- data/test/replica_set/pinning_test.rb +0 -105
- data/test/replica_set/query_test.rb +0 -73
- data/test/replica_set/read_preference_test.rb +0 -219
- data/test/replica_set/refresh_test.rb +0 -211
- data/test/replica_set/replication_ack_test.rb +0 -95
- data/test/sharded_cluster/basic_test.rb +0 -203
- data/test/shared/authentication/basic_auth_shared.rb +0 -260
- data/test/shared/authentication/bulk_api_auth_shared.rb +0 -249
- data/test/shared/authentication/gssapi_shared.rb +0 -176
- data/test/shared/authentication/sasl_plain_shared.rb +0 -96
- data/test/shared/authentication/scram_shared.rb +0 -92
- data/test/shared/ssl_shared.rb +0 -235
- data/test/test_helper.rb +0 -61
- data/test/threading/basic_test.rb +0 -120
- data/test/tools/mongo_config.rb +0 -708
- data/test/tools/mongo_config_test.rb +0 -160
- data/test/unit/client_test.rb +0 -381
- data/test/unit/collection_test.rb +0 -166
- data/test/unit/connection_test.rb +0 -335
- data/test/unit/cursor_test.rb +0 -307
- data/test/unit/db_test.rb +0 -136
- data/test/unit/grid_test.rb +0 -76
- data/test/unit/mongo_sharded_client_test.rb +0 -48
- data/test/unit/node_test.rb +0 -93
- data/test/unit/pool_manager_test.rb +0 -111
- data/test/unit/read_pref_test.rb +0 -406
- data/test/unit/read_test.rb +0 -159
- data/test/unit/safe_test.rb +0 -158
- data/test/unit/sharding_pool_manager_test.rb +0 -84
- data/test/unit/write_concern_test.rb +0 -175
metadata.gz.sig
CHANGED
Binary file
|
data/VERSION
DELETED
@@ -1 +0,0 @@
|
|
1
|
-
1.12.5
|
@@ -1,387 +0,0 @@
|
|
1
|
-
# Copyright (C) 2009-2013 MongoDB, Inc.
|
2
|
-
#
|
3
|
-
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
-
# you may not use this file except in compliance with the License.
|
5
|
-
# You may obtain a copy of the License at
|
6
|
-
#
|
7
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
-
#
|
9
|
-
# Unless required by applicable law or agreed to in writing, software
|
10
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
-
# See the License for the specific language governing permissions and
|
13
|
-
# limitations under the License.
|
14
|
-
|
15
|
-
module Mongo
|
16
|
-
|
17
|
-
# A bulk write view to a collection of documents in a database.
|
18
|
-
class BulkWriteCollectionView
|
19
|
-
include Mongo::WriteConcern
|
20
|
-
|
21
|
-
DEFAULT_OP_ARGS = {:q => nil}
|
22
|
-
MULTIPLE_ERRORS_MSG = "batch item errors occurred"
|
23
|
-
EMPTY_BATCH_MSG = "batch is empty"
|
24
|
-
|
25
|
-
attr_reader :collection, :options, :ops, :op_args
|
26
|
-
|
27
|
-
# Initialize a bulk-write-view object to a collection with default query selector {}.
|
28
|
-
#
|
29
|
-
# A bulk write operation is initialized from a collection object.
|
30
|
-
# For example, for an ordered bulk write view:
|
31
|
-
#
|
32
|
-
# bulk = collection.initialize_ordered_bulk_op
|
33
|
-
#
|
34
|
-
# or for an unordered bulk write view:
|
35
|
-
#
|
36
|
-
# bulk = collection.initialize_unordered_bulk_op
|
37
|
-
#
|
38
|
-
# The bulk write view collects individual write operations together so that they can be
|
39
|
-
# executed as a batch for significant performance gains.
|
40
|
-
# The ordered bulk operation will execute each operation serially in order.
|
41
|
-
# Execution will stop at the first occurrence of an error for an ordered bulk operation.
|
42
|
-
# The unordered bulk operation will be executed and may take advantage of parallelism.
|
43
|
-
# There are no guarantees for the order of execution of the operations on the server.
|
44
|
-
# Execution will continue even if there are errors for an unordered bulk operation.
|
45
|
-
#
|
46
|
-
# A bulk operation is programmed as a sequence of individual operations.
|
47
|
-
# An individual operation is composed of a method chain of modifiers or setters terminated by a write method.
|
48
|
-
# A modify method sets a value on the current object.
|
49
|
-
# A set methods returns a duplicate of the current object with a value set.
|
50
|
-
# A terminator write method appends a write operation to the bulk batch collected in the view.
|
51
|
-
#
|
52
|
-
# The API supports mixing of write operation types in a bulk operation.
|
53
|
-
# However, server support affects the implementation and performance of bulk operations.
|
54
|
-
#
|
55
|
-
# MongoDB version 2.6 servers currently support only bulk commands of the same type.
|
56
|
-
# With an ordered bulk operation,
|
57
|
-
# contiguous individual ops of the same type can be batched into the same db request,
|
58
|
-
# and the next op of a different type must be sent separately in the next request.
|
59
|
-
# Performance will improve if you can arrange your ops to reduce the number of db requests.
|
60
|
-
# With an unordered bulk operation,
|
61
|
-
# individual ops can be grouped by type and sent in at most three requests,
|
62
|
-
# one each per insert, update, or delete.
|
63
|
-
#
|
64
|
-
# MongoDB pre-version 2.6 servers do not support bulk write commands.
|
65
|
-
# The bulk operation must be sent one request per individual op.
|
66
|
-
# This also applies to inserts in order to have accurate counts and error reporting.
|
67
|
-
#
|
68
|
-
# Important note on pre-2.6 performance:
|
69
|
-
# Performance is very poor compared to version 2.6.
|
70
|
-
# We recommend bulk operation with pre-2.6 only for compatibility or
|
71
|
-
# for development in preparation for version 2.6.
|
72
|
-
# For better performance with pre-version 2.6, use bulk insertion with Collection#insert.
|
73
|
-
#
|
74
|
-
# @param [Collection] collection the parent collection object
|
75
|
-
#
|
76
|
-
# @option opts [Boolean] :ordered (true) Set bulk execution for ordered or unordered
|
77
|
-
#
|
78
|
-
# @return [BulkWriteCollectionView]
|
79
|
-
def initialize(collection, options = {})
|
80
|
-
@collection = collection
|
81
|
-
@options = options
|
82
|
-
@ops = []
|
83
|
-
@op_args = DEFAULT_OP_ARGS.dup
|
84
|
-
end
|
85
|
-
|
86
|
-
def inspect
|
87
|
-
vars = [:@options, :@ops, :@op_args]
|
88
|
-
vars_inspect = vars.collect{|var| "#{var}=#{instance_variable_get(var).inspect}"}
|
89
|
-
"#<Mongo::BulkWriteCollectionView:0x#{self.object_id} " <<
|
90
|
-
"@collection=#<Mongo::Collection:0x#{@collection.object_id}>, #{vars_inspect.join(', ')}>"
|
91
|
-
end
|
92
|
-
|
93
|
-
# Modify the query selector for subsequent bulk write operations.
|
94
|
-
# The default query selector on creation of the bulk write view is {}.
|
95
|
-
# For operations that require a query selector, find() must be set
|
96
|
-
# per operation, or set once for all operations on the bulk object.
|
97
|
-
# For example, these operations:
|
98
|
-
#
|
99
|
-
# bulk.find({"a" => 2}).update({"$inc" => {"x" => 2}})
|
100
|
-
# bulk.find({"a" => 2}).update({"$set" => {"b" => 3}})
|
101
|
-
#
|
102
|
-
# may be rewritten as:
|
103
|
-
#
|
104
|
-
# bulk = find({"a" => 2})
|
105
|
-
# bulk.update({"$inc" => {"x" => 2}})
|
106
|
-
# bulk.update({"$set" => {"b" => 3}})
|
107
|
-
#
|
108
|
-
# Note that modifying the query selector in this way will not affect
|
109
|
-
# operations that do not use a query selector, like insert().
|
110
|
-
#
|
111
|
-
# @param [Hash] q the query selector
|
112
|
-
#
|
113
|
-
# @return [BulkWriteCollectionView]
|
114
|
-
def find(q)
|
115
|
-
op_args_set(:q, q)
|
116
|
-
end
|
117
|
-
|
118
|
-
# Modify the upsert option argument for subsequent bulk write operations.
|
119
|
-
#
|
120
|
-
# @param [Boolean] value (true) the upsert option value
|
121
|
-
#
|
122
|
-
# @return [BulkWriteCollectionView]
|
123
|
-
def upsert!(value = true)
|
124
|
-
op_args_set(:upsert, value)
|
125
|
-
end
|
126
|
-
|
127
|
-
# Set the upsert option argument for subsequent bulk write operations.
|
128
|
-
#
|
129
|
-
# @param [Boolean] value (true) the upsert option value
|
130
|
-
#
|
131
|
-
# @return [BulkWriteCollectionView] a duplicated object
|
132
|
-
def upsert(value = true)
|
133
|
-
dup.upsert!(value)
|
134
|
-
end
|
135
|
-
|
136
|
-
# Update one document matching the selector.
|
137
|
-
#
|
138
|
-
# bulk.find({"a" => 1}).update_one({"$inc" => {"x" => 1}})
|
139
|
-
#
|
140
|
-
# Use the upsert! or upsert method to specify an upsert. For example:
|
141
|
-
#
|
142
|
-
# bulk.find({"a" => 1}).upsert.updateOne({"$inc" => {"x" => 1}})
|
143
|
-
#
|
144
|
-
# @param [Hash] u the update document
|
145
|
-
#
|
146
|
-
# @return [BulkWriteCollectionView]
|
147
|
-
def update_one(u)
|
148
|
-
raise MongoArgumentError, "document must start with an operator" unless update_doc?(u)
|
149
|
-
op_push([:update, @op_args.merge(:u => u, :multi => false)])
|
150
|
-
end
|
151
|
-
|
152
|
-
# Update all documents matching the selector. For example:
|
153
|
-
#
|
154
|
-
# bulk.find({"a" => 2}).update({"$inc" => {"x" => 2}})
|
155
|
-
#
|
156
|
-
# Use the upsert! or upsert method to specify an upsert. For example:
|
157
|
-
#
|
158
|
-
# bulk.find({"a" => 2}).upsert.update({"$inc" => {"x" => 2}})
|
159
|
-
#
|
160
|
-
# @param [Hash] u the update document
|
161
|
-
#
|
162
|
-
# @return [BulkWriteCollectionView]
|
163
|
-
def update(u)
|
164
|
-
raise MongoArgumentError, "document must start with an operator" unless update_doc?(u)
|
165
|
-
op_push([:update, @op_args.merge(:u => u, :multi => true)])
|
166
|
-
end
|
167
|
-
|
168
|
-
# Replace entire document (update with whole doc replace). For example:
|
169
|
-
#
|
170
|
-
# bulk.find({"a" => 3}).replace_one({"x" => 3})
|
171
|
-
#
|
172
|
-
# @param [Hash] u the replacement document
|
173
|
-
#
|
174
|
-
# @return [BulkWriteCollectionView]
|
175
|
-
def replace_one(u)
|
176
|
-
raise MongoArgumentError, "document must not contain any operators" unless replace_doc?(u)
|
177
|
-
op_push([:update, @op_args.merge(:u => u, :multi => false)])
|
178
|
-
end
|
179
|
-
|
180
|
-
# Remove a single document matching the selector. For example:
|
181
|
-
#
|
182
|
-
# bulk.find({"a" => 4}).remove_one;
|
183
|
-
#
|
184
|
-
# @return [BulkWriteCollectionView]
|
185
|
-
def remove_one
|
186
|
-
op_push([:delete, @op_args.merge(:limit => 1)])
|
187
|
-
end
|
188
|
-
|
189
|
-
# Remove all documents matching the selector. For example:
|
190
|
-
#
|
191
|
-
# bulk.find({"a" => 5}).remove;
|
192
|
-
#
|
193
|
-
# @return [BulkWriteCollectionView]
|
194
|
-
def remove
|
195
|
-
op_push([:delete, @op_args.merge(:limit => 0)])
|
196
|
-
end
|
197
|
-
|
198
|
-
# Insert a document. For example:
|
199
|
-
#
|
200
|
-
# bulk.insert({"x" => 4})
|
201
|
-
#
|
202
|
-
# @return [BulkWriteCollectionView]
|
203
|
-
def insert(document)
|
204
|
-
# TODO - check keys
|
205
|
-
op_push([:insert, {:d => document}])
|
206
|
-
end
|
207
|
-
|
208
|
-
# Execute the bulk operation, with an optional write concern overwriting the default w:1.
|
209
|
-
# For example:
|
210
|
-
#
|
211
|
-
# write_concern = {:w => 1, :j => 1}
|
212
|
-
# bulk.execute({write_concern})
|
213
|
-
#
|
214
|
-
# On return from execute, the bulk operation is cleared,
|
215
|
-
# but the selector and upsert settings are preserved.
|
216
|
-
#
|
217
|
-
# @return [BulkWriteCollectionView]
|
218
|
-
def execute(opts = {})
|
219
|
-
raise MongoArgumentError, EMPTY_BATCH_MSG if @ops.empty?
|
220
|
-
write_concern = get_write_concern(opts, @collection)
|
221
|
-
@ops.each_with_index{|op, index| op.last.merge!(:ord => index)} # infuse ordinal here to avoid issues with upsert
|
222
|
-
if @collection.db.connection.use_write_command?(write_concern)
|
223
|
-
errors, write_concern_errors, exchanges = @collection.command_writer.bulk_execute(@ops, @options, opts)
|
224
|
-
else
|
225
|
-
errors, write_concern_errors, exchanges = @collection.operation_writer.bulk_execute(@ops, @options, opts)
|
226
|
-
end
|
227
|
-
@ops = []
|
228
|
-
return true if errors.empty? && (exchanges.empty? || exchanges.first[:response] == true) # w 0 without GLE
|
229
|
-
result = merge_result(errors + write_concern_errors, exchanges)
|
230
|
-
raise BulkWriteError.new(MULTIPLE_ERRORS_MSG, Mongo::ErrorCode::MULTIPLE_ERRORS_OCCURRED, result) if !errors.empty? || !write_concern_errors.empty?
|
231
|
-
result
|
232
|
-
end
|
233
|
-
|
234
|
-
private
|
235
|
-
|
236
|
-
def hash_except(h, *keys)
|
237
|
-
keys.each { |key| h.delete(key) }
|
238
|
-
h
|
239
|
-
end
|
240
|
-
|
241
|
-
def hash_select(h, *keys)
|
242
|
-
Hash[*keys.zip(h.values_at(*keys)).flatten]
|
243
|
-
end
|
244
|
-
|
245
|
-
def tally(h, key, n)
|
246
|
-
h[key] = h.fetch(key, 0) + n
|
247
|
-
end
|
248
|
-
|
249
|
-
def nil_tally(h, key, n)
|
250
|
-
if !h.has_key?(key)
|
251
|
-
h[key] = n
|
252
|
-
elsif h[key]
|
253
|
-
h[key] = n ? h[key] + n : n
|
254
|
-
end
|
255
|
-
end
|
256
|
-
|
257
|
-
def append(h, key, obj)
|
258
|
-
h[key] = h.fetch(key, []) << obj
|
259
|
-
end
|
260
|
-
|
261
|
-
def concat(h, key, a)
|
262
|
-
h[key] = h.fetch(key, []) + a
|
263
|
-
end
|
264
|
-
|
265
|
-
def merge_index(h, exchange)
|
266
|
-
h.merge("index" => exchange[:batch][h.fetch("index", 0)][:ord])
|
267
|
-
end
|
268
|
-
|
269
|
-
def merge_indexes(a, exchange)
|
270
|
-
a.collect{|h| merge_index(h, exchange)}
|
271
|
-
end
|
272
|
-
|
273
|
-
def merge_result(errors, exchanges)
|
274
|
-
ok = 0
|
275
|
-
result = {"ok" => 0, "n" => 0}
|
276
|
-
unless errors.empty?
|
277
|
-
unless (writeErrors = errors.select { |error| error.class != Mongo::OperationFailure && error.class != WriteConcernError }).empty? # assignment
|
278
|
-
concat(result, "writeErrors",
|
279
|
-
writeErrors.collect { |error|
|
280
|
-
{"index" => error.result[:ord], "code" => error.error_code, "errmsg" => error.result[:error].message}
|
281
|
-
})
|
282
|
-
end
|
283
|
-
result.merge!("code" => Mongo::ErrorCode::MULTIPLE_ERRORS_OCCURRED, "errmsg" => MULTIPLE_ERRORS_MSG)
|
284
|
-
end
|
285
|
-
exchanges.each do |exchange|
|
286
|
-
response = exchange[:response]
|
287
|
-
next unless response
|
288
|
-
ok += response["ok"].to_i
|
289
|
-
n = response["n"] || 0
|
290
|
-
op_type = exchange[:op_type]
|
291
|
-
if op_type == :insert
|
292
|
-
n = 1 if response.key?("err") && (response["err"].nil? || response["err"] == "norepl" || response["err"] == "timeout") # OP_INSERT override n = 0 bug, n = exchange[:batch].size always 1
|
293
|
-
tally(result, "nInserted", n)
|
294
|
-
elsif op_type == :update
|
295
|
-
n_upserted = 0
|
296
|
-
if (upserted = response.fetch("upserted", nil)) # assignment
|
297
|
-
upserted = [{"_id" => upserted}] if upserted.class != Array # OP_UPDATE non-array
|
298
|
-
n_upserted = upserted.size
|
299
|
-
concat(result, "upserted", merge_indexes(upserted, exchange))
|
300
|
-
elsif (response["updatedExisting"] == false && n == 1)
|
301
|
-
# workaround for DRIVERS-151 (non-ObjectID _id fields in pre-2.6 servers)
|
302
|
-
op = exchange[:batch][0]
|
303
|
-
missing_id = op[:u].fetch(:_id, op[:q][:_id]) # _id in update document takes precedence
|
304
|
-
upserted = [ { "_id" => missing_id, "index" => 0 } ]
|
305
|
-
n_upserted = n
|
306
|
-
concat(result, "upserted", merge_indexes(upserted, exchange))
|
307
|
-
end
|
308
|
-
tally(result, "nUpserted", n_upserted) if n_upserted > 0
|
309
|
-
tally(result, "nMatched", n - n_upserted)
|
310
|
-
nil_tally(result, "nModified", response["nModified"])
|
311
|
-
elsif op_type == :delete
|
312
|
-
tally(result, "nRemoved", n)
|
313
|
-
end
|
314
|
-
result["n"] += n
|
315
|
-
write_concern_error = nil
|
316
|
-
errmsg = response["errmsg"] || response["err"] # top level
|
317
|
-
if (writeErrors = response["writeErrors"] || response["errDetails"]) # assignment
|
318
|
-
concat(result, "writeErrors", merge_indexes(writeErrors, exchange))
|
319
|
-
elsif response["err"] == "timeout" # errmsg == "timed out waiting for slaves" # OP_*
|
320
|
-
write_concern_error = {"errmsg" => errmsg, "code" => Mongo::ErrorCode::WRITE_CONCERN_FAILED,
|
321
|
-
"errInfo" => {"wtimeout" => response["wtimeout"]}} # OP_* does not have "code"
|
322
|
-
elsif errmsg == "norepl" # OP_*
|
323
|
-
write_concern_error = {"errmsg" => errmsg, "code" => Mongo::ErrorCode::WRITE_CONCERN_FAILED} # OP_* does not have "code"
|
324
|
-
elsif errmsg # OP_INSERT, OP_UPDATE have "err"
|
325
|
-
append(result, "writeErrors", merge_index({"errmsg" => errmsg, "code" => response["code"]}, exchange))
|
326
|
-
end
|
327
|
-
if response["writeConcernError"]
|
328
|
-
write_concern_error = response["writeConcernError"]
|
329
|
-
elsif (wnote = response["wnote"]) # assignment - OP_*
|
330
|
-
write_concern_error = {"errmsg" => wnote, "code" => Mongo::ErrorCode::WRITE_CONCERN_FAILED} # OP_* does not have "code"
|
331
|
-
elsif (jnote = response["jnote"]) # assignment - OP_*
|
332
|
-
write_concern_error = {"errmsg" => jnote, "code" => Mongo::ErrorCode::BAD_VALUE} # OP_* does not have "code"
|
333
|
-
end
|
334
|
-
append(result, "writeConcernError", merge_index(write_concern_error, exchange)) if write_concern_error
|
335
|
-
end
|
336
|
-
result.delete("nModified") if result.has_key?("nModified") && !result["nModified"]
|
337
|
-
result.merge!("ok" => [ok + result["n"], 1].min)
|
338
|
-
end
|
339
|
-
|
340
|
-
def initialize_copy(other)
|
341
|
-
other.instance_variable_set(:@options, other.options.dup)
|
342
|
-
end
|
343
|
-
|
344
|
-
def op_args_set(op, value)
|
345
|
-
@op_args[op] = value
|
346
|
-
self
|
347
|
-
end
|
348
|
-
|
349
|
-
def op_push(op)
|
350
|
-
raise MongoArgumentError, "non-nil query must be set via find" if op.first != :insert && !op.last[:q]
|
351
|
-
@ops << op
|
352
|
-
self
|
353
|
-
end
|
354
|
-
|
355
|
-
def update_doc?(doc)
|
356
|
-
!doc.empty? && doc.keys.first.to_s =~ /^\$/
|
357
|
-
end
|
358
|
-
|
359
|
-
def replace_doc?(doc)
|
360
|
-
doc.keys.all?{|key| key !~ /^\$/}
|
361
|
-
end
|
362
|
-
|
363
|
-
end
|
364
|
-
|
365
|
-
class Collection
|
366
|
-
|
367
|
-
# Initialize an ordered bulk write view for this collection
|
368
|
-
# Execution will stop at the first occurrence of an error for an ordered bulk operation.
|
369
|
-
#
|
370
|
-
# @return [BulkWriteCollectionView]
|
371
|
-
def initialize_ordered_bulk_op
|
372
|
-
BulkWriteCollectionView.new(self, :ordered => true)
|
373
|
-
end
|
374
|
-
|
375
|
-
# Initialize an unordered bulk write view for this collection
|
376
|
-
# The unordered bulk operation will be executed and may take advantage of parallelism.
|
377
|
-
# There are no guarantees for the order of execution of the operations on the server.
|
378
|
-
# Execution will continue even if there are errors for an unordered bulk operation.
|
379
|
-
#
|
380
|
-
# @return [BulkWriteCollectionView]
|
381
|
-
def initialize_unordered_bulk_op
|
382
|
-
BulkWriteCollectionView.new(self, :ordered => false)
|
383
|
-
end
|
384
|
-
|
385
|
-
end
|
386
|
-
|
387
|
-
end
|
@@ -1,364 +0,0 @@
|
|
1
|
-
# Copyright (C) 2009-2013 MongoDB, Inc.
|
2
|
-
#
|
3
|
-
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
-
# you may not use this file except in compliance with the License.
|
5
|
-
# You may obtain a copy of the License at
|
6
|
-
#
|
7
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
-
#
|
9
|
-
# Unless required by applicable law or agreed to in writing, software
|
10
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
-
# See the License for the specific language governing permissions and
|
13
|
-
# limitations under the License.
|
14
|
-
|
15
|
-
module Mongo
|
16
|
-
|
17
|
-
class CollectionWriter
|
18
|
-
include Mongo::Logging
|
19
|
-
include Mongo::WriteConcern
|
20
|
-
|
21
|
-
OPCODE = {
|
22
|
-
:insert => Mongo::Constants::OP_INSERT,
|
23
|
-
:update => Mongo::Constants::OP_UPDATE,
|
24
|
-
:delete => Mongo::Constants::OP_DELETE
|
25
|
-
}
|
26
|
-
WRITE_COMMAND_ARG_KEY = {
|
27
|
-
:insert => :documents,
|
28
|
-
:update => :updates,
|
29
|
-
:delete => :deletes
|
30
|
-
}
|
31
|
-
|
32
|
-
def initialize(collection)
|
33
|
-
@collection = collection
|
34
|
-
@name = @collection.name
|
35
|
-
@db = @collection.db
|
36
|
-
@connection = @db.connection
|
37
|
-
@logger = @connection.logger
|
38
|
-
@max_write_batch_size = Mongo::MongoClient::DEFAULT_MAX_WRITE_BATCH_SIZE
|
39
|
-
end
|
40
|
-
|
41
|
-
# common implementation only for new batch write commands (insert, update, delete) and old batch insert
|
42
|
-
def batch_write_incremental(op_type, documents, check_keys=true, opts={})
|
43
|
-
raise Mongo::OperationFailure, "Request contains no documents" if documents.empty?
|
44
|
-
write_concern = get_write_concern(opts, @collection)
|
45
|
-
max_message_size, max_append_size, max_serialize_size = batch_write_max_sizes(write_concern)
|
46
|
-
ordered = opts[:ordered]
|
47
|
-
continue_on_error = !!opts[:continue_on_error] || ordered == false
|
48
|
-
collect_on_error = !!opts[:collect_on_error] || ordered == false
|
49
|
-
error_docs = [] # docs with serialization errors
|
50
|
-
errors = []
|
51
|
-
write_concern_errors = []
|
52
|
-
exchanges = []
|
53
|
-
serialized_doc = nil
|
54
|
-
message = BSON::ByteBuffer.new("", max_message_size)
|
55
|
-
@max_write_batch_size = @collection.db.connection.max_write_batch_size
|
56
|
-
docs = documents.dup
|
57
|
-
catch(:error) do
|
58
|
-
until docs.empty? || (!errors.empty? && !collect_on_error && !continue_on_error) # process documents a batch at a time
|
59
|
-
batch_docs = []
|
60
|
-
batch_message_initialize(message, op_type, continue_on_error, write_concern)
|
61
|
-
while !docs.empty? && batch_docs.size < @max_write_batch_size
|
62
|
-
begin
|
63
|
-
doc = docs.first
|
64
|
-
doc = doc[:d] if op_type == :insert && !ordered.nil? #check_keys for :update outside of serialize
|
65
|
-
serialized_doc ||= BSON::BSON_CODER.serialize(doc, check_keys, true, max_serialize_size)
|
66
|
-
rescue BSON::InvalidDocument, BSON::InvalidKeyName, BSON::InvalidStringEncoding => ex
|
67
|
-
bulk_message = "Bulk write error - #{ex.message} - examine result for complete information"
|
68
|
-
ex = BulkWriteError.new(bulk_message, Mongo::ErrorCode::INVALID_BSON,
|
69
|
-
{:op_type => op_type, :serialize => doc, :ord => docs.first[:ord], :error => ex}) unless ordered.nil?
|
70
|
-
error_docs << docs.shift
|
71
|
-
errors << ex
|
72
|
-
next if collect_on_error
|
73
|
-
throw(:error) if batch_docs.empty?
|
74
|
-
break # defer exit and send batch
|
75
|
-
end
|
76
|
-
break if message.size + serialized_doc.size > max_append_size
|
77
|
-
batch_docs << docs.shift
|
78
|
-
batch_message_append(message, serialized_doc, write_concern)
|
79
|
-
serialized_doc = nil
|
80
|
-
end
|
81
|
-
begin
|
82
|
-
response = batch_message_send(message, op_type, batch_docs, write_concern, continue_on_error) if batch_docs.size > 0
|
83
|
-
exchanges << {:op_type => op_type, :batch => batch_docs, :opts => opts, :response => response}
|
84
|
-
rescue Mongo::WriteConcernError => ex
|
85
|
-
write_concern_errors << ex
|
86
|
-
exchanges << {:op_type => op_type, :batch => batch_docs, :opts => opts, :response => ex.result}
|
87
|
-
rescue Mongo::OperationFailure => ex
|
88
|
-
errors << ex
|
89
|
-
exchanges << {:op_type => op_type, :batch => batch_docs, :opts => opts, :response => ex.result}
|
90
|
-
throw(:error) unless continue_on_error
|
91
|
-
end
|
92
|
-
end
|
93
|
-
end
|
94
|
-
[error_docs, errors, write_concern_errors, exchanges]
|
95
|
-
end
|
96
|
-
|
97
|
-
def batch_write_partition(op_type, documents, check_keys, opts)
|
98
|
-
raise Mongo::OperationFailure, "Request contains no documents" if documents.empty?
|
99
|
-
write_concern = get_write_concern(opts, @collection)
|
100
|
-
ordered = opts[:ordered]
|
101
|
-
continue_on_error = !!opts[:continue_on_error] || ordered == false # continue_on_error default false
|
102
|
-
collect_on_error = !!opts[:collect_on_error] # collect_on_error default false
|
103
|
-
error_docs = [] # docs with serialization errors
|
104
|
-
errors = []
|
105
|
-
write_concern_errors = []
|
106
|
-
exchanges = []
|
107
|
-
@max_write_batch_size = @collection.db.connection.max_write_batch_size
|
108
|
-
@write_batch_size = [documents.size, @max_write_batch_size].min
|
109
|
-
docs = documents.dup
|
110
|
-
until docs.empty?
|
111
|
-
batch = docs.take(@write_batch_size)
|
112
|
-
begin
|
113
|
-
batch_to_send = batch #(op_type == :insert && !ordered.nil?) ? batch.collect{|doc|doc[:d]} : batch
|
114
|
-
if @collection.db.connection.use_write_command?(write_concern) # TODO - polymorphic send_write including legacy insert
|
115
|
-
response = send_bulk_write_command(op_type, batch_to_send, check_keys, opts)
|
116
|
-
else
|
117
|
-
response = send_write_operation(op_type, nil, batch_to_send, check_keys, opts, write_concern)
|
118
|
-
end
|
119
|
-
exchanges << {:op_type => op_type, :batch => batch, :opts => opts, :response => response}
|
120
|
-
docs = docs.drop(batch.size)
|
121
|
-
@write_batch_size = [(@write_batch_size*1097) >> 10, @write_batch_size+1].max unless docs.empty? # 2**(1/10) multiplicative increase
|
122
|
-
@write_batch_size = @max_write_batch_size if @write_batch_size > @max_write_batch_size
|
123
|
-
rescue BSON::InvalidDocument, BSON::InvalidKeyName, BSON::InvalidStringEncoding => ex
|
124
|
-
if @write_batch_size > 1 # decrease batch size
|
125
|
-
@write_batch_size = (@write_batch_size+1) >> 1 # 2**(-1) multiplicative decrease
|
126
|
-
next
|
127
|
-
end
|
128
|
-
# error on a single document
|
129
|
-
bulk_message = "Bulk write error - #{ex.message} - examine result for complete information"
|
130
|
-
ex = BulkWriteError.new(bulk_message, Mongo::ErrorCode::INVALID_BSON,
|
131
|
-
{:op_type => op_type, :batch => batch, :ord => batch.first[:ord], :opts => opts, :error => ex}) unless ordered.nil?
|
132
|
-
error_docs << docs.shift
|
133
|
-
next if collect_on_error
|
134
|
-
errors << ex
|
135
|
-
break unless continue_on_error
|
136
|
-
rescue Mongo::WriteConcernError => ex
|
137
|
-
write_concern_errors << ex
|
138
|
-
exchanges << {:op_type => op_type, :batch => batch_docs, :opts => opts, :response => ex.result}
|
139
|
-
docs = docs.drop(batch.size)
|
140
|
-
rescue Mongo::OperationFailure => ex
|
141
|
-
errors << ex
|
142
|
-
exchanges << {:op_type => op_type, :batch => batch, :opts => opts, :response => ex.result}
|
143
|
-
docs = docs.drop(batch.size)
|
144
|
-
break if !continue_on_error && !collect_on_error
|
145
|
-
end
|
146
|
-
end
|
147
|
-
[error_docs, errors, write_concern_errors, exchanges]
|
148
|
-
end
|
149
|
-
|
150
|
-
alias :batch_write :batch_write_incremental
|
151
|
-
|
152
|
-
def send_bulk_write_command(op_type, documents, check_keys, opts, collection_name=@name)
|
153
|
-
if op_type == :insert
|
154
|
-
documents = documents.collect{|doc| doc[:d]} if opts.key?(:ordered)
|
155
|
-
documents.each do |doc|
|
156
|
-
# TODO - @pk_factory.create_pk(doc)
|
157
|
-
if check_keys
|
158
|
-
doc.each_key do |key|
|
159
|
-
key = key.to_s
|
160
|
-
raise BSON::InvalidKeyName.new("key #{key} must not start with '$'") if key[0] == ?$
|
161
|
-
raise BSON::InvalidKeyName.new("key #{key} must not contain '.'") if key.include? ?.
|
162
|
-
end
|
163
|
-
end
|
164
|
-
end
|
165
|
-
#elsif op_type == :update # TODO - check keys
|
166
|
-
#elsif op_type == :delete
|
167
|
-
#else
|
168
|
-
# raise ArgumentError, "Write operation type must be :insert, :update or :delete"
|
169
|
-
end
|
170
|
-
request = BSON::OrderedHash[op_type, collection_name].merge!(
|
171
|
-
Mongo::CollectionWriter::WRITE_COMMAND_ARG_KEY[op_type] => documents,
|
172
|
-
:writeConcern => get_write_concern(opts, @collection),
|
173
|
-
:ordered => opts[:ordered] || !opts[:continue_on_error]
|
174
|
-
)
|
175
|
-
@db.command(request)
|
176
|
-
end
|
177
|
-
|
178
|
-
private
|
179
|
-
|
180
|
-
def sort_by_first_sym(pairs)
|
181
|
-
pairs = pairs.collect{|first, rest| [first.to_s, rest]} #stringify_first
|
182
|
-
pairs = pairs.sort{|x,y| x.first <=> y.first }
|
183
|
-
pairs.collect{|first, rest| [first.to_sym, rest]} #symbolize_first
|
184
|
-
end
|
185
|
-
|
186
|
-
def ordered_group_by_first(pairs)
|
187
|
-
pairs.inject([[], nil]) do |memo, pair|
|
188
|
-
result, previous_value = memo
|
189
|
-
current_value = pair.first
|
190
|
-
result << [current_value, []] if previous_value != current_value
|
191
|
-
result.last.last << pair.last
|
192
|
-
[result, current_value]
|
193
|
-
end.first
|
194
|
-
end
|
195
|
-
|
196
|
-
end
|
197
|
-
|
198
|
-
class CollectionOperationWriter < CollectionWriter
|
199
|
-
def initialize(collection)
|
200
|
-
super(collection)
|
201
|
-
end
|
202
|
-
|
203
|
-
def send_write_operation(op_type, selector, doc_or_docs, check_keys, opts, write_concern, collection_name=@name)
|
204
|
-
message = BSON::ByteBuffer.new("", @connection.max_message_size)
|
205
|
-
message.put_int((op_type == :insert && !!opts[:continue_on_error]) ? 1 : 0)
|
206
|
-
BSON::BSON_RUBY.serialize_cstr(message, "#{@db.name}.#{collection_name}")
|
207
|
-
if op_type == :update
|
208
|
-
update_options = 0
|
209
|
-
update_options += 1 if opts[:upsert]
|
210
|
-
update_options += 2 if opts[:multi]
|
211
|
-
message.put_int(update_options)
|
212
|
-
elsif op_type == :delete
|
213
|
-
delete_options = 0
|
214
|
-
delete_options += 1 if opts[:limit] && opts[:limit] != 0
|
215
|
-
message.put_int(delete_options)
|
216
|
-
end
|
217
|
-
message.put_binary(BSON::BSON_CODER.serialize(selector, false, true, @connection.max_bson_size).to_s) if selector
|
218
|
-
[doc_or_docs].flatten(1).compact.each do |document|
|
219
|
-
message.put_binary(BSON::BSON_CODER.serialize(document, check_keys, true, @connection.max_bson_size).to_s)
|
220
|
-
if message.size > @connection.max_message_size
|
221
|
-
raise BSON::InvalidDocument, "Message is too large. This message is limited to #{@connection.max_message_size} bytes."
|
222
|
-
end
|
223
|
-
end
|
224
|
-
instrument(op_type, :database => @db.name, :collection => collection_name, :selector => selector, :documents => doc_or_docs) do
|
225
|
-
op_code = OPCODE[op_type]
|
226
|
-
if Mongo::WriteConcern.gle?(write_concern)
|
227
|
-
@connection.send_message_with_gle(op_code, message, @db.name, nil, write_concern)
|
228
|
-
else
|
229
|
-
@connection.send_message(op_code, message)
|
230
|
-
end
|
231
|
-
end
|
232
|
-
end
|
233
|
-
|
234
|
-
def bulk_execute(ops, options, opts = {})
|
235
|
-
write_concern = get_write_concern(opts, @collection)
|
236
|
-
errors = []
|
237
|
-
write_concern_errors = []
|
238
|
-
exchanges = []
|
239
|
-
ops.each do |op_type, doc|
|
240
|
-
doc = {:d => @collection.pk_factory.create_pk(doc[:d]), :ord => doc[:ord]} if op_type == :insert
|
241
|
-
doc_opts = doc.merge(opts)
|
242
|
-
d = doc_opts.delete(:d)
|
243
|
-
q = doc_opts.delete(:q)
|
244
|
-
u = doc_opts.delete(:u)
|
245
|
-
begin # use single and NOT batch inserts since there no index for an error
|
246
|
-
response = @collection.operation_writer.send_write_operation(op_type, q, d || u, check_keys = false, doc_opts, write_concern)
|
247
|
-
exchanges << {:op_type => op_type, :batch => [doc], :opts => opts, :response => response}
|
248
|
-
rescue BSON::InvalidDocument, BSON::InvalidKeyName, BSON::InvalidStringEncoding => ex
|
249
|
-
bulk_message = "Bulk write error - #{ex.message} - examine result for complete information"
|
250
|
-
ex = BulkWriteError.new(bulk_message, Mongo::ErrorCode::INVALID_BSON,
|
251
|
-
{:op_type => op_type, :serialize => doc, :ord => doc[:ord], :error => ex})
|
252
|
-
errors << ex
|
253
|
-
break if options[:ordered]
|
254
|
-
rescue Mongo::WriteConcernError => ex
|
255
|
-
write_concern_errors << ex
|
256
|
-
exchanges << {:op_type => op_type, :batch => [doc], :opts => opts, :response => ex.result}
|
257
|
-
rescue Mongo::OperationFailure => ex
|
258
|
-
errors << ex
|
259
|
-
exchanges << {:op_type => op_type, :batch => [doc], :opts => opts, :response => ex.result}
|
260
|
-
break if options[:ordered] && ex.result["err"] != "norepl"
|
261
|
-
end
|
262
|
-
end
|
263
|
-
[errors, write_concern_errors, exchanges]
|
264
|
-
end
|
265
|
-
|
266
|
-
private
|
267
|
-
|
268
|
-
def batch_message_initialize(message, op_type, continue_on_error, write_concern)
|
269
|
-
message.clear!.clear
|
270
|
-
message.put_int(continue_on_error ? 1 : 0)
|
271
|
-
BSON::BSON_RUBY.serialize_cstr(message, "#{@db.name}.#{@name}")
|
272
|
-
end
|
273
|
-
|
274
|
-
def batch_message_append(message, serialized_doc, write_concern)
|
275
|
-
message.put_binary(serialized_doc.to_s)
|
276
|
-
end
|
277
|
-
|
278
|
-
def batch_message_send(message, op_type, batch_docs, write_concern, continue_on_error)
|
279
|
-
instrument(:insert, :database => @db.name, :collection => @name, :documents => batch_docs) do
|
280
|
-
if Mongo::WriteConcern.gle?(write_concern)
|
281
|
-
@connection.send_message_with_gle(Mongo::Constants::OP_INSERT, message, @db.name, nil, write_concern)
|
282
|
-
else
|
283
|
-
@connection.send_message(Mongo::Constants::OP_INSERT, message)
|
284
|
-
end
|
285
|
-
end
|
286
|
-
end
|
287
|
-
|
288
|
-
def batch_write_max_sizes(write_concern)
|
289
|
-
[@connection.max_message_size, @connection.max_message_size, @connection.max_bson_size]
|
290
|
-
end
|
291
|
-
|
292
|
-
end
|
293
|
-
|
294
|
-
class CollectionCommandWriter < CollectionWriter
|
295
|
-
def initialize(collection)
|
296
|
-
super(collection)
|
297
|
-
end
|
298
|
-
|
299
|
-
def send_write_command(op_type, selector, doc_or_docs, check_keys, opts, write_concern, collection_name=@name)
|
300
|
-
if op_type == :insert
|
301
|
-
argument = [doc_or_docs].flatten(1).compact
|
302
|
-
elsif op_type == :update
|
303
|
-
argument = [{:q => selector, :u => doc_or_docs, :multi => !!opts[:multi]}]
|
304
|
-
argument.first.merge!(:upsert => opts[:upsert]) if opts[:upsert]
|
305
|
-
elsif op_type == :delete
|
306
|
-
argument = [{:q => selector, :limit => (opts[:limit] || 0)}]
|
307
|
-
else
|
308
|
-
raise ArgumentError, "Write operation type must be :insert, :update or :delete"
|
309
|
-
end
|
310
|
-
request = BSON::OrderedHash[op_type, collection_name, WRITE_COMMAND_ARG_KEY[op_type], argument]
|
311
|
-
request.merge!(:writeConcern => write_concern, :ordered => !opts[:continue_on_error])
|
312
|
-
request.merge!(opts)
|
313
|
-
instrument(op_type, :database => @db.name, :collection => collection_name, :selector => selector, :documents => doc_or_docs) do
|
314
|
-
@db.command(request)
|
315
|
-
end
|
316
|
-
end
|
317
|
-
|
318
|
-
def bulk_execute(ops, options, opts = {})
|
319
|
-
errors = []
|
320
|
-
write_concern_errors = []
|
321
|
-
exchanges = []
|
322
|
-
ops = (options[:ordered] == false) ? sort_by_first_sym(ops) : ops # sort by write-type
|
323
|
-
ordered_group_by_first(ops).each do |op_type, documents|
|
324
|
-
documents.collect! {|doc| {:d => @collection.pk_factory.create_pk(doc[:d]), :ord => doc[:ord]} } if op_type == :insert
|
325
|
-
error_docs, batch_errors, batch_write_concern_errors, batch_exchanges =
|
326
|
-
batch_write(op_type, documents, check_keys = false, opts.merge(:ordered => options[:ordered]))
|
327
|
-
errors += batch_errors
|
328
|
-
write_concern_errors += batch_write_concern_errors
|
329
|
-
exchanges += batch_exchanges
|
330
|
-
break if options[:ordered] && !batch_errors.empty?
|
331
|
-
end
|
332
|
-
[errors, write_concern_errors, exchanges]
|
333
|
-
end
|
334
|
-
|
335
|
-
private
|
336
|
-
|
337
|
-
def batch_message_initialize(message, op_type, continue_on_error, write_concern)
|
338
|
-
message.clear!.clear
|
339
|
-
@bson_empty ||= BSON::BSON_CODER.serialize({})
|
340
|
-
message.put_binary(@bson_empty.to_s)
|
341
|
-
message.unfinish!.array!(WRITE_COMMAND_ARG_KEY[op_type])
|
342
|
-
end
|
343
|
-
|
344
|
-
def batch_message_append(message, serialized_doc, write_concern)
|
345
|
-
message.push_doc!(serialized_doc)
|
346
|
-
end
|
347
|
-
|
348
|
-
def batch_message_send(message, op_type, batch_docs, write_concern, continue_on_error)
|
349
|
-
message.finish!
|
350
|
-
request = BSON::OrderedHash[op_type, @name, :bson, message]
|
351
|
-
request.merge!(:writeConcern => write_concern, :ordered => !continue_on_error)
|
352
|
-
instrument(:insert, :database => @db.name, :collection => @name, :documents => batch_docs) do
|
353
|
-
@db.command(request)
|
354
|
-
end
|
355
|
-
end
|
356
|
-
|
357
|
-
def batch_write_max_sizes(write_concern)
|
358
|
-
[MongoClient::COMMAND_HEADROOM, MongoClient::APPEND_HEADROOM, MongoClient::SERIALIZE_HEADROOM].collect{|h| @connection.max_bson_size + h}
|
359
|
-
end
|
360
|
-
|
361
|
-
end
|
362
|
-
|
363
|
-
end
|
364
|
-
|