mongo-python-driver/test/asynchronous/test_client_bulk_write.py

# Copyright 2024-present MongoDB, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Test the client bulk write API."""
from __future__ import annotations

import sys

sys.path[0:0] = [""]

from test.asynchronous import AsyncIntegrationTest, async_client_context, unittest
from test.utils import (
    OvertCommandListener,
    async_rs_or_single_client,
)

from pymongo.encryption_options import _HAVE_PYMONGOCRYPT, AutoEncryptionOpts
from pymongo.errors import (
    ClientBulkWriteException,
    DocumentTooLarge,
    InvalidOperation,
    NetworkTimeout,
)
from pymongo.monitoring import *
from pymongo.operations import *
from pymongo.write_concern import WriteConcern

_IS_SYNC = False


class TestClientBulkWrite(AsyncIntegrationTest):
    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_returns_error_if_no_namespace_provided(self):
        client = await async_rs_or_single_client()
        self.addAsyncCleanup(client.aclose)

        models = [InsertOne(document={"a": "b"})]
        with self.assertRaises(InvalidOperation) as context:
            await client.bulk_write(models=models)
        self.assertIn(
            "MongoClient.bulk_write requires a namespace to be provided for each write operation",
            context.exception._message,
        )


# https://github.com/mongodb/specifications/tree/master/source/crud/tests
class TestClientBulkWriteCRUD(AsyncIntegrationTest):
    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_batch_splits_if_num_operations_too_large(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        max_write_batch_size = (await async_client_context.hello)["maxWriteBatchSize"]
        models = []
        for _ in range(max_write_batch_size + 1):
            models.append(InsertOne(namespace="db.coll", document={"a": "b"}))
        self.addAsyncCleanup(client.db["coll"].drop)

        result = await client.bulk_write(models=models)
        self.assertEqual(result.inserted_count, max_write_batch_size + 1)

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)
        self.assertEqual(len(bulk_write_events), 2)

        first_event, second_event = bulk_write_events
        self.assertEqual(len(first_event.command["ops"]), max_write_batch_size)
        self.assertEqual(len(second_event.command["ops"]), 1)
        self.assertEqual(first_event.operation_id, second_event.operation_id)

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_batch_splits_if_ops_payload_too_large(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        max_message_size_bytes = (await async_client_context.hello)["maxMessageSizeBytes"]
        max_bson_object_size = (await async_client_context.hello)["maxBsonObjectSize"]

        models = []
        num_models = int(max_message_size_bytes / max_bson_object_size + 1)
        b_repeated = "b" * (max_bson_object_size - 500)
        for _ in range(num_models):
            models.append(
                InsertOne(
                    namespace="db.coll",
                    document={"a": b_repeated},
                )
            )
        self.addAsyncCleanup(client.db["coll"].drop)

        result = await client.bulk_write(models=models)
        self.assertEqual(result.inserted_count, num_models)

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)
        self.assertEqual(len(bulk_write_events), 2)

        first_event, second_event = bulk_write_events
        self.assertEqual(len(first_event.command["ops"]), num_models - 1)
        self.assertEqual(len(second_event.command["ops"]), 1)
        self.assertEqual(first_event.operation_id, second_event.operation_id)

    @async_client_context.require_version_min(8, 0, 0, -24)
    @async_client_context.require_failCommand_fail_point
    async def test_collects_write_concern_errors_across_batches(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(
            event_listeners=[listener],
            retryWrites=False,
        )
        self.addAsyncCleanup(client.aclose)
        max_write_batch_size = (await async_client_context.hello)["maxWriteBatchSize"]

        fail_command = {
            "configureFailPoint": "failCommand",
            "mode": {"times": 2},
            "data": {
                "failCommands": ["bulkWrite"],
                "writeConcernError": {"code": 91, "errmsg": "Replication is being shut down"},
            },
        }
        async with self.fail_point(fail_command):
            models = []
            for _ in range(max_write_batch_size + 1):
                models.append(
                    InsertOne(
                        namespace="db.coll",
                        document={"a": "b"},
                    )
                )
            self.addAsyncCleanup(client.db["coll"].drop)

            with self.assertRaises(ClientBulkWriteException) as context:
                await client.bulk_write(models=models)
            self.assertEqual(len(context.exception.write_concern_errors), 2)  # type: ignore[arg-type]
            self.assertIsNotNone(context.exception.partial_result)
            self.assertEqual(
                context.exception.partial_result.inserted_count, max_write_batch_size + 1
            )

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)
        self.assertEqual(len(bulk_write_events), 2)

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_collects_write_errors_across_batches_unordered(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        collection = client.db["coll"]
        self.addAsyncCleanup(collection.drop)
        await collection.drop()
        await collection.insert_one(document={"_id": 1})

        max_write_batch_size = (await async_client_context.hello)["maxWriteBatchSize"]
        models = []
        for _ in range(max_write_batch_size + 1):
            models.append(
                InsertOne(
                    namespace="db.coll",
                    document={"_id": 1},
                )
            )

        with self.assertRaises(ClientBulkWriteException) as context:
            await client.bulk_write(models=models, ordered=False)
        self.assertEqual(len(context.exception.write_errors), max_write_batch_size + 1)  # type: ignore[arg-type]

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)
        self.assertEqual(len(bulk_write_events), 2)

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_collects_write_errors_across_batches_ordered(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        collection = client.db["coll"]
        self.addAsyncCleanup(collection.drop)
        await collection.drop()
        await collection.insert_one(document={"_id": 1})

        max_write_batch_size = (await async_client_context.hello)["maxWriteBatchSize"]
        models = []
        for _ in range(max_write_batch_size + 1):
            models.append(
                InsertOne(
                    namespace="db.coll",
                    document={"_id": 1},
                )
            )

        with self.assertRaises(ClientBulkWriteException) as context:
            await client.bulk_write(models=models, ordered=True)
        self.assertEqual(len(context.exception.write_errors), 1)  # type: ignore[arg-type]

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)
        self.assertEqual(len(bulk_write_events), 1)

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_handles_cursor_requiring_getMore(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        collection = client.db["coll"]
        self.addAsyncCleanup(collection.drop)
        await collection.drop()

        max_bson_object_size = (await async_client_context.hello)["maxBsonObjectSize"]
        models = []
        a_repeated = "a" * (max_bson_object_size // 2)
        b_repeated = "b" * (max_bson_object_size // 2)
        models.append(
            UpdateOne(
                namespace="db.coll",
                filter={"_id": a_repeated},
                update={"$set": {"x": 1}},
                upsert=True,
            )
        )
        models.append(
            UpdateOne(
                namespace="db.coll",
                filter={"_id": b_repeated},
                update={"$set": {"x": 1}},
                upsert=True,
            )
        )

        result = await client.bulk_write(models=models, verbose_results=True)
        self.assertEqual(result.upserted_count, 2)
        self.assertEqual(len(result.update_results), 2)

        get_more_event = False
        for event in listener.started_events:
            if event.command_name == "getMore":
                get_more_event = True
        self.assertTrue(get_more_event)

    @async_client_context.require_version_min(8, 0, 0, -24)
    @async_client_context.require_no_standalone
    async def test_handles_cursor_requiring_getMore_within_transaction(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        collection = client.db["coll"]
        self.addAsyncCleanup(collection.drop)
        await collection.drop()

        max_bson_object_size = (await async_client_context.hello)["maxBsonObjectSize"]
        async with client.start_session() as session:
            await session.start_transaction()
            models = []
            a_repeated = "a" * (max_bson_object_size // 2)
            b_repeated = "b" * (max_bson_object_size // 2)
            models.append(
                UpdateOne(
                    namespace="db.coll",
                    filter={"_id": a_repeated},
                    update={"$set": {"x": 1}},
                    upsert=True,
                )
            )
            models.append(
                UpdateOne(
                    namespace="db.coll",
                    filter={"_id": b_repeated},
                    update={"$set": {"x": 1}},
                    upsert=True,
                )
            )
            result = await client.bulk_write(models=models, session=session, verbose_results=True)

        self.assertEqual(result.upserted_count, 2)
        self.assertEqual(len(result.update_results), 2)

        get_more_event = False
        for event in listener.started_events:
            if event.command_name == "getMore":
                get_more_event = True
        self.assertTrue(get_more_event)

    @async_client_context.require_version_min(8, 0, 0, -24)
    @async_client_context.require_failCommand_fail_point
    async def test_handles_getMore_error(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        collection = client.db["coll"]
        self.addAsyncCleanup(collection.drop)
        await collection.drop()

        max_bson_object_size = (await async_client_context.hello)["maxBsonObjectSize"]
        fail_command = {
            "configureFailPoint": "failCommand",
            "mode": {"times": 1},
            "data": {"failCommands": ["getMore"], "errorCode": 8},
        }
        async with self.fail_point(fail_command):
            models = []
            a_repeated = "a" * (max_bson_object_size // 2)
            b_repeated = "b" * (max_bson_object_size // 2)
            models.append(
                UpdateOne(
                    namespace="db.coll",
                    filter={"_id": a_repeated},
                    update={"$set": {"x": 1}},
                    upsert=True,
                )
            )
            models.append(
                UpdateOne(
                    namespace="db.coll",
                    filter={"_id": b_repeated},
                    update={"$set": {"x": 1}},
                    upsert=True,
                )
            )

            with self.assertRaises(ClientBulkWriteException) as context:
                await client.bulk_write(models=models, verbose_results=True)
            self.assertIsNotNone(context.exception.error)
            self.assertEqual(context.exception.error["code"], 8)
            self.assertIsNotNone(context.exception.partial_result)
            self.assertEqual(context.exception.partial_result.upserted_count, 2)
            self.assertEqual(len(context.exception.partial_result.update_results), 1)

        get_more_event = False
        kill_cursors_event = False
        for event in listener.started_events:
            if event.command_name == "getMore":
                get_more_event = True
            if event.command_name == "killCursors":
                kill_cursors_event = True
        self.assertTrue(get_more_event)
        self.assertTrue(kill_cursors_event)

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_returns_error_if_unacknowledged_too_large_insert(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        max_bson_object_size = (await async_client_context.hello)["maxBsonObjectSize"]
        b_repeated = "b" * max_bson_object_size

        # Insert document.
        models_insert = [InsertOne(namespace="db.coll", document={"a": b_repeated})]
        with self.assertRaises(DocumentTooLarge):
            await client.bulk_write(models=models_insert, write_concern=WriteConcern(w=0))

        # Replace document.
        models_replace = [ReplaceOne(namespace="db.coll", filter={}, replacement={"a": b_repeated})]
        with self.assertRaises(DocumentTooLarge):
            await client.bulk_write(models=models_replace, write_concern=WriteConcern(w=0))

    async def _setup_namespace_test_models(self):
        max_message_size_bytes = (await async_client_context.hello)["maxMessageSizeBytes"]
        max_bson_object_size = (await async_client_context.hello)["maxBsonObjectSize"]

        ops_bytes = max_message_size_bytes - 1122
        num_models = ops_bytes // max_bson_object_size
        remainder_bytes = ops_bytes % max_bson_object_size

        models = []
        b_repeated = "b" * (max_bson_object_size - 57)
        for _ in range(num_models):
            models.append(
                InsertOne(
                    namespace="db.coll",
                    document={"a": b_repeated},
                )
            )
        if remainder_bytes >= 217:
            num_models += 1
            b_repeated = "b" * (remainder_bytes - 57)
            models.append(
                InsertOne(
                    namespace="db.coll",
                    document={"a": b_repeated},
                )
            )
        return num_models, models

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_no_batch_splits_if_new_namespace_is_not_too_large(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        num_models, models = await self._setup_namespace_test_models()
        models.append(
            InsertOne(
                namespace="db.coll",
                document={"a": "b"},
            )
        )
        self.addAsyncCleanup(client.db["coll"].drop)

        # No batch splitting required.
        result = await client.bulk_write(models=models)
        self.assertEqual(result.inserted_count, num_models + 1)

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)

        self.assertEqual(len(bulk_write_events), 1)
        event = bulk_write_events[0]

        self.assertEqual(len(event.command["ops"]), num_models + 1)
        self.assertEqual(len(event.command["nsInfo"]), 1)
        self.assertEqual(event.command["nsInfo"][0]["ns"], "db.coll")

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_batch_splits_if_new_namespace_is_too_large(self):
        listener = OvertCommandListener()
        client = await async_rs_or_single_client(event_listeners=[listener])
        self.addAsyncCleanup(client.aclose)

        num_models, models = await self._setup_namespace_test_models()
        c_repeated = "c" * 200
        namespace = f"db.{c_repeated}"
        models.append(
            InsertOne(
                namespace=namespace,
                document={"a": "b"},
            )
        )
        self.addAsyncCleanup(client.db["coll"].drop)
        self.addAsyncCleanup(client.db[c_repeated].drop)

        # Batch splitting required.
        result = await client.bulk_write(models=models)
        self.assertEqual(result.inserted_count, num_models + 1)

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)

        self.assertEqual(len(bulk_write_events), 2)
        first_event, second_event = bulk_write_events

        self.assertEqual(len(first_event.command["ops"]), num_models)
        self.assertEqual(len(first_event.command["nsInfo"]), 1)
        self.assertEqual(first_event.command["nsInfo"][0]["ns"], "db.coll")

        self.assertEqual(len(second_event.command["ops"]), 1)
        self.assertEqual(len(second_event.command["nsInfo"]), 1)
        self.assertEqual(second_event.command["nsInfo"][0]["ns"], namespace)

    @async_client_context.require_version_min(8, 0, 0, -24)
    async def test_returns_error_if_no_writes_can_be_added_to_ops(self):
        client = await async_rs_or_single_client()
        self.addAsyncCleanup(client.aclose)

        max_message_size_bytes = (await async_client_context.hello)["maxMessageSizeBytes"]

        # Document too large.
        b_repeated = "b" * max_message_size_bytes
        models = [InsertOne(namespace="db.coll", document={"a": b_repeated})]
        with self.assertRaises(InvalidOperation) as context:
            await client.bulk_write(models=models)
        self.assertIn("cannot do an empty bulk write", context.exception._message)

        # Namespace too large.
        c_repeated = "c" * max_message_size_bytes
        namespace = f"db.{c_repeated}"
        models = [InsertOne(namespace=namespace, document={"a": "b"})]
        with self.assertRaises(InvalidOperation) as context:
            await client.bulk_write(models=models)
        self.assertIn("cannot do an empty bulk write", context.exception._message)

    @async_client_context.require_version_min(8, 0, 0, -24)
    @unittest.skipUnless(_HAVE_PYMONGOCRYPT, "pymongocrypt is not installed")
    async def test_returns_error_if_auto_encryption_configured(self):
        opts = AutoEncryptionOpts(
            key_vault_namespace="db.coll",
            kms_providers={"aws": {"accessKeyId": "foo", "secretAccessKey": "bar"}},
        )
        client = await async_rs_or_single_client(auto_encryption_opts=opts)
        self.addAsyncCleanup(client.aclose)

        models = [InsertOne(namespace="db.coll", document={"a": "b"})]
        with self.assertRaises(InvalidOperation) as context:
            await client.bulk_write(models=models)
        self.assertIn(
            "bulk_write does not currently support automatic encryption", context.exception._message
        )


# https://github.com/mongodb/specifications/blob/master/source/client-side-operations-timeout/tests/README.md#11-multi-batch-bulkwrites
class TestClientBulkWriteTimeout(AsyncIntegrationTest):
    @async_client_context.require_version_min(8, 0, 0, -24)
    @async_client_context.require_failCommand_fail_point
    async def test_timeout_in_multi_batch_bulk_write(self):
        internal_client = await async_rs_or_single_client(timeoutMS=None)
        self.addAsyncCleanup(internal_client.aclose)

        collection = internal_client.db["coll"]
        self.addAsyncCleanup(collection.drop)
        await collection.drop()

        max_bson_object_size = (await async_client_context.hello)["maxBsonObjectSize"]
        max_message_size_bytes = (await async_client_context.hello)["maxMessageSizeBytes"]
        fail_command = {
            "configureFailPoint": "failCommand",
            "mode": {"times": 2},
            "data": {"failCommands": ["bulkWrite"], "blockConnection": True, "blockTimeMS": 1010},
        }
        async with self.fail_point(fail_command):
            models = []
            num_models = int(max_message_size_bytes / max_bson_object_size + 1)
            b_repeated = "b" * (max_bson_object_size - 500)
            for _ in range(num_models):
                models.append(
                    InsertOne(
                        namespace="db.coll",
                        document={"a": b_repeated},
                    )
                )

            listener = OvertCommandListener()
            client = await async_rs_or_single_client(
                event_listeners=[listener],
                readConcernLevel="majority",
                readPreference="primary",
                timeoutMS=2000,
                w="majority",
            )
            self.addAsyncCleanup(client.aclose)
            with self.assertRaises(ClientBulkWriteException) as context:
                await client.bulk_write(models=models)
            self.assertIsInstance(context.exception.error, NetworkTimeout)

        bulk_write_events = []
        for event in listener.started_events:
            if event.command_name == "bulkWrite":
                bulk_write_events.append(event)
        self.assertEqual(len(bulk_write_events), 2)