Skip to content

Commit

Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
udpate: supported connector list
Browse files Browse the repository at this point in the history
harshini-rangaswamy committed Jan 27, 2025
1 parent e398161 commit f666b36
Showing 2 changed files with 43 additions and 14 deletions.
Original file line number Diff line number Diff line change
@@ -14,9 +14,10 @@ upgrading, or reverting versions to maintain production pipeline stability.
### Key considerations for multi-version connectors

- Deprecated connector versions may be removed during maintenance updates. If you
[pin](#pin-version) a deprecated version, the system alerts you, highlights any
known breaking changes, and recommends an upgrade. Upgrade to a supported version to
avoid compatibility issues, as support is limited to the most recent versions.
[pin](#pin-version) a deprecated version, the system alerts you and recommends an
upgrade. The connector will continue to run, but upgrading to a supported version is
recommended to avoid compatibility issues. Support is limited to the latest connector
versions. Breaking changes, if any, are detailed in maintenance update notifications.
- Pinning a connector version applies to the entire plugin, ensuring that all
connectors provided by the plugin (such as source and sink connectors) use the same
version.
@@ -27,6 +28,29 @@ upgrading, or reverting versions to maintain production pipeline stability.
- Refer to [Check available connector versions](#check-available-connector-versions) to
confirm which versions are supported before pinning a version.

## Supported connectors and versions {#supported-connectors-and-versions}

The following connectors support multi-versioning:

| Connector | Versions |
|---------------------|-----------------------|
| Debezium | `2.5.0` (recommended) <br /> `1.9.7` (deprecated) |
| JDBC | `6.10.0` (recommended) <br /> `6.9.0` (deprecated) |
| Snowflake | `2.3.0` (recommended) <br /> `2.2.0` |


:::tip
This is a partial list of connectors, and it may change as new versions are released. To
view the most up-to-date versions, see
[Check available connector versions](#check-available-connector-versions).
:::

:::note
If you are using version `1.9.7` of the Debezium connector, you can upgrade to
version `2.5.0` without raising a support ticket. To upgrade, pin version `2.5.0` in
your configuration. For details, see [Pin a connector version](#pin-version).
:::

## Prerequisites

- [Aiven for Apache Kafka® service](/docs/products/kafka/kafka-connect/howto/enable-connect)
@@ -43,8 +67,9 @@ that your service is updated to enable this feature.

## Check available connector versions {#check-available-connector-versions}

Before pinning a connector version, confirm which versions are available for your
Apache Kafka Connect service. Use one of the following methods:
Before pinning a connector version, check which versions are available for your
Apache Kafka Connect service. Verify if a connector supports multi-versioning by
reviewing the listed versions. Use one of the following methods:

<Tabs groupId="check-method">

@@ -111,12 +136,11 @@ Apache Kafka Connect service. Use one of the following methods:
</TabItem>
<TabItem value="terraform" label="Terraform">

In Terraform, you can directly specify the desired connector version by using
the `plugin_versions` attribute in your configuration. This ensures that your
Aiven for Apache Kafka Connect service uses the exact version you require.
In Terraform, you can specify the desired connector version using the `plugin_versions`
attribute in your configuration. This ensures that your Apache Kafka Connect service
uses the exact version you need.

Refer to the [Pin a connector version](#pin-version) section for detailed steps and
examples.
For detailed steps and examples, see [Pin a connector version](#pin-version).

</TabItem>
</Tabs>
13 changes: 9 additions & 4 deletions static/includes/debezium-breakingchange.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,14 @@
:::note
**Breaking changes in Debezium 2.5**

Debezium version 2.5 introduces significant changes to the connector's configuration
and behavior. New setups [default to version 2.5](https://debezium.io/releases/2.5/release-notes),
Debezium version 2.5 introduces changes to the connector's configuration and behavior.
New setups [default to version 2.5](https://debezium.io/releases/2.5/release-notes),
while existing setups using version 1.9 remain on that version for stability.
Test configurations with version 2.5 before upgrading.
For help with upgrades or queries, contact [Aiven support](mailto:support@aiven.io).

If you are using version 1.9.7, you can upgrade to version 2.5.0 using
[multi-version support](/docs/products/kafka/kafka-connect/howto/manage-connector-versions)
without raising a support ticket. Ensure compatibility by testing version 2.5
configurations before upgrading.

For further assistance, contact [Aiven support](mailto:support@aiven.io).
:::

0 comments on commit f666b36

Please sign in to comment.