From 2fca43f3bcf2f3799da66e3075ac91d86faa7901 Mon Sep 17 00:00:00 2001 From: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com> Date: Tue, 21 May 2024 06:41:39 -0700 Subject: [PATCH] DOCSP-39495 v1.12 release (#158) --- config/redirects | 2 +- snooty.toml | 2 +- .../error-handling.txt | 9 ++++++++ .../error-handling-strategies.txt | 21 +++++++++++++++++++ source/whats-new.txt | 10 +++++++++ 5 files changed, 42 insertions(+), 2 deletions(-) diff --git a/config/redirects b/config/redirects index be8369c..b03f41b 100644 --- a/config/redirects +++ b/config/redirects @@ -1,7 +1,7 @@ define: prefix docs/kafka-connector define: base https://www.mongodb.com/${prefix} -define: versions v1.0 v1.1 v1.2 v1.3 v1.4 v1.5 v1.6 v1.7 v1.8 v1.9 v1.10 v1.11 master +define: versions v1.0 v1.1 v1.2 v1.3 v1.4 v1.5 v1.6 v1.7 v1.8 v1.9 v1.10 v1.11 v1.12 master symlink: current -> master diff --git a/snooty.toml b/snooty.toml index efe229a..583f949 100644 --- a/snooty.toml +++ b/snooty.toml @@ -15,7 +15,7 @@ avro = "Avro" avro-converter="Kafka Connect Avro Converter (Avro Converter)" protobuf-converter="Kafka Connect Protobuf Converter" json-schema-converter="Kafka Connect JSON Schema Converter" -connector_version="1.11" +connector_version="1.12" connector_patch_version="2" connector_driver_version="4.7" connector_version_github_tag="master" diff --git a/source/sink-connector/configuration-properties/error-handling.txt b/source/sink-connector/configuration-properties/error-handling.txt index 8e2f040..4fbf2b9 100644 --- a/source/sink-connector/configuration-properties/error-handling.txt +++ b/source/sink-connector/configuration-properties/error-handling.txt @@ -10,6 +10,13 @@ Connector Error Handling Properties :depth: 2 :class: singlecol +.. facet:: + :name: genre + :values: reference + +.. meta:: + :keywords: errors, options, configure + Overview -------- @@ -44,6 +51,8 @@ Settings | When set to ``none``, the connector reports any error and blocks further processing of the rest of the messages. | When set to ``all``, the connector ignores any problematic messages. + | When set to ``data``, the connector tolerates only data errors and + fails on all other errors. | To learn more about error handling strategies, see the :ref:`` page. diff --git a/source/sink-connector/fundamentals/error-handling-strategies.txt b/source/sink-connector/fundamentals/error-handling-strategies.txt index 3c9861c..dd07f66 100644 --- a/source/sink-connector/fundamentals/error-handling-strategies.txt +++ b/source/sink-connector/fundamentals/error-handling-strategies.txt @@ -10,6 +10,13 @@ Error Handling :depth: 2 :class: singlecol +.. facet:: + :name: genre + :values: reference + +.. meta:: + :keywords: sink, processing + Overview -------- @@ -90,6 +97,20 @@ option: you lose less data. To learn more about bulk write operations, see the :ref:`Write Model Strategies page `. +Tolerate Data Errors +~~~~~~~~~~~~~~~~~~~~ + +You can configure your sink connector to tolerate only data errors, and stop +processing for all others. With this setting, the connector sends data errors to the dead +letter queue if one is configured. + +Configure your sink connector to tolerate only data errors by specifying the +following option: + +.. code-block:: properties + + errors.tolerance=data + .. _kafka-sink-errors-dlq: Write Errors and Errant Messages to a Topic diff --git a/source/whats-new.txt b/source/whats-new.txt index 4d2435d..f866743 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -19,6 +19,7 @@ What's New Learn what's new by version: +* :ref:`Version 1.12 ` * :ref:`Version 1.11.2 ` * :ref:`Version 1.11.1 ` * :ref:`Version 1.11 ` @@ -38,6 +39,15 @@ Learn what's new by version: * :ref:`Version 1.1 ` * :ref:`Version 1.0 ` +.. _kafka-connector-whats-new-1.12: + +What's New in 1.12 +------------------ + +- Added support for a ``data`` configuration value in the ``mongo.errors.tolerance`` + configuration setting. With ``mongo.errors.tolerance=data``, the sink + connector tolerates only data errors, and fails for any others. + .. _kafka-connector-whats-new-1.11.2: What's New in 1.11.2