mongo 2.5.3 → 2.6.0

data/spec/support/transactions_tests/insert.yml

@@ -0,0 +1,264 @@
+database_name: &database_name "ruby-driver"
+collection_name: &collection_name "transactions-tests"
+
+data: []
+
+tests:
+  - description: insert
+
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: insertMany
+        object: collection
+        arguments:
+          documents:
+            - _id: 2
+            - _id: 3
+          session: session0
+        result:
+          insertedIds: {0: 2, 1: 3}
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 4
+        result:
+          insertedId: 4
+      - name: commitTransaction
+        object: session0
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 5
+        result:
+          insertedId: 5
+      - name: commitTransaction
+        object: session0
+
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+              - _id: 3
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 4
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 5
+            ordered: true
+            readConcern:
+              afterClusterTime: 42
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+
+    outcome:
+      collection:
+        data:
+          - _id: 1
+          - _id: 2
+          - _id: 3
+          - _id: 4
+          - _id: 5
+
+  # This test proves that the driver parses the collectionOptions writeConcern.
+  - description: collection writeConcern without transaction
+    operations:
+      - name: insertOne
+        object: collection
+        collectionOptions:
+          writeConcern:
+            w: majority
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+            startTransaction:
+            autocommit:
+            writeConcern:
+              w: majority
+          command_name: insert
+          database_name: *database_name
+
+    outcome:
+      collection:
+        data:
+          - _id: 1
+
+  - description: collection writeConcern ignored for insert
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            writeConcern:
+              w: majority
+      - name: insertOne
+        object: collection
+        collectionOptions:
+          writeConcern:
+            w: majority
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: insertMany
+        object: collection
+        collectionOptions:
+          writeConcern:
+            w: majority
+        arguments:
+          documents:
+            - _id: 2
+            - _id: 3
+          session: session0
+        result:
+          insertedIds: {0: 2, 1: 3}
+      - name: commitTransaction
+        object: session0
+
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+              - _id: 3
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+              w: majority
+          command_name: commitTransaction
+          database_name: admin
+
+    outcome:
+      collection:
+        data:
+          - _id: 1
+          - _id: 2
+          - _id: 3

data/spec/support/transactions_tests/isolation.yml

@@ -0,0 +1,125 @@
+# Test snapshot isolation.
+# This test doesn't check contents of command-started events.
+database_name: &database_name "ruby-driver"
+collection_name: &collection_name "transactions-tests"
+
+data: []
+
+tests:
+  - description: one transaction
+
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: find
+        object: collection
+        arguments:
+          session: session0
+          filter:
+            _id: 1
+        result:
+          - {_id: 1}
+      - name: find
+        object: collection
+        arguments:
+          session: session1
+          filter:
+            _id: 1
+        result: []
+      - name: find
+        object: collection
+        arguments:
+          filter:
+            _id: 1
+        result: []
+      - name: commitTransaction
+        object: session0
+      - name: find
+        object: collection
+        arguments:
+          session: session1
+          filter:
+            _id: 1
+        result:
+          - {_id: 1}
+      - name: find
+        object: collection
+        arguments:
+          filter:
+            _id: 1
+        result:
+          - {_id: 1}
+
+    outcome:
+      collection:
+        data:
+          - _id: 1
+
+  - description: two transactions
+
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: startTransaction
+        object: session1
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: find
+        object: collection
+        arguments:
+          session: session0
+          filter:
+            _id: 1
+        result:
+          - {_id: 1}
+      - name: find
+        object: collection
+        arguments:
+          session: session1
+          filter:
+            _id: 1
+        result: []
+      - name: find
+        object: collection
+        arguments:
+          filter:
+            _id: 1
+        result: []
+      - name: commitTransaction
+        object: session0
+      # Snapshot isolation in session1, not read-committed.
+      - name: find
+        object: collection
+        arguments:
+          session: session1
+          filter:
+            _id: 1
+        result: []
+      - name: find
+        object: collection
+        arguments:
+          filter:
+            _id: 1
+        result:
+          - {_id: 1}
+      - name: commitTransaction
+        object: session1
+
+    outcome:
+      collection:
+        data:
+          - {_id: 1}

data/spec/support/transactions_tests/read-pref.yml

@@ -0,0 +1,340 @@
+# This test doesn't check contents of command-started events.
+database_name: &database_name "ruby-driver"
+collection_name: &collection_name "transactions-tests"
+
+data: []
+
+tests:
+  - description: default readPreference
+
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: insertMany
+        object: collection
+        arguments:
+          documents: &insertedDocs
+            - _id: 1
+            - _id: 2
+            - _id: 3
+            - _id: 4
+          session: session0
+        result:
+          insertedIds: {0: 1, 1: 2, 2: 3, 3: 4}
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          # The driver overrides the collection's read pref with the
+          # transaction's so count runs with Primary and succeeds.
+          readPreference:
+            mode: Secondary
+        arguments:
+          session: session0
+          pipeline:
+            - $match:
+                _id: 1
+            - $count: count
+        result:
+          - count: 1
+      - name: find
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Secondary
+        arguments:
+          session: session0
+          batchSize: 3
+        result: *insertedDocs
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Secondary
+        arguments:
+          pipeline:
+            - $project:
+                _id: 1
+          batchSize: 3
+          session: session0
+        result: *insertedDocs
+      - name: commitTransaction
+        object: session0
+
+    outcome:
+      collection:
+        data: *insertedDocs
+
+  - description: primary readPreference
+
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: Primary
+      - name: insertMany
+        object: collection
+        arguments:
+          documents: &insertedDocs
+            - _id: 1
+            - _id: 2
+            - _id: 3
+            - _id: 4
+          session: session0
+        result:
+          insertedIds: {0: 1, 1: 2, 2: 3, 3: 4}
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Secondary
+        arguments:
+          session: session0
+          pipeline:
+            - $match:
+                _id: 1
+            - $count: count
+        result:
+          - count: 1
+      - name: find
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Secondary
+        arguments:
+          session: session0
+          batchSize: 3
+        result: *insertedDocs
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Secondary
+        arguments:
+          pipeline:
+            - $project:
+                _id: 1
+          batchSize: 3
+          session: session0
+        result: *insertedDocs
+      - name: commitTransaction
+        object: session0
+
+    outcome:
+      collection:
+        data: *insertedDocs
+
+  - description: secondary readPreference
+
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: Secondary
+      - name: insertMany
+        object: collection
+        arguments:
+          documents: &insertedDocs
+            - _id: 1
+            - _id: 2
+            - _id: 3
+            - _id: 4
+          session: session0
+        result:
+          insertedIds: {0: 1, 1: 2, 2: 3, 3: 4}
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          session: session0
+          pipeline:
+            - $match:
+                _id: 1
+            - $count: count
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: find
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          session: session0
+          batchSize: 3
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          pipeline:
+            - $project:
+                _id: 1
+          batchSize: 3
+          session: session0
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: abortTransaction
+        object: session0
+
+    outcome:
+      collection:
+        data: []
+
+  - description: primaryPreferred readPreference
+
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: PrimaryPreferred
+      - name: insertMany
+        object: collection
+        arguments:
+          documents: &insertedDocs
+            - _id: 1
+            - _id: 2
+            - _id: 3
+            - _id: 4
+          session: session0
+        result:
+          insertedIds: {0: 1, 1: 2, 2: 3, 3: 4}
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          session: session0
+          pipeline:
+            - $match:
+                _id: 1
+            - $count: count
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: find
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          session: session0
+          batchSize: 3
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          pipeline:
+            - $project:
+                _id: 1
+          batchSize: 3
+          session: session0
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: abortTransaction
+        object: session0
+
+    outcome:
+      collection:
+        data: []
+
+  - description: nearest readPreference
+
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: Nearest
+      - name: insertMany
+        object: collection
+        arguments:
+          documents: &insertedDocs
+            - _id: 1
+            - _id: 2
+            - _id: 3
+            - _id: 4
+          session: session0
+        result:
+          insertedIds: {0: 1, 1: 2, 2: 3, 3: 4}
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          session: session0
+          pipeline:
+            - $match:
+                _id: 1
+            - $count: count
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: find
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          session: session0
+          batchSize: 3
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: aggregate
+        object: collection
+        collectionOptions:
+          readPreference:
+            mode: Primary
+        arguments:
+          pipeline:
+            - $project:
+                _id: 1
+          batchSize: 3
+          session: session0
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: abortTransaction
+        object: session0
+
+    outcome:
+      collection:
+        data: []
+
+  - description: secondary write only
+
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: Secondary
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: commitTransaction
+        object: session0
+
+    outcome:
+      collection:
+        data:
+          - _id: 1