Deprecation of Legacy State

[nataliekwong]

As of Airbyte Platform version v0.62.4, we have deprecated support of the Legacy state in favor of our Stream and Global states, which were introduced to enable stream-level configuration and replication. This decision was made in order to ensure a consistent experience across all Airbyte connectors.

What does this mean for you?
Any custom connector that is running on a Legacy version of our state through an old version of the Airbyte CDK will no longer successfully sync, and will send an error message saying “Legacy states are no longer supported”. You will need to migrate the connector to a newer version of the CDK (1.3.1 or higher) that supports per-stream or global states to keep syncing with this connector.

Migration steps
To learn more about our principles around state messages, read more in our documentation. To migrate your custom connector to a new version of the Airbyte CDK, follow these steps:

• Step 1: For Python connectors, we highly recommend using Poetry (a python library) to manage these dependencies (example here).
• Step 2: To migrate to a new version of the Airbyte CDK, you’ll need to update the row in this file noting the CDK version. As an example, airbyte-cdk = "0.10.0" would change to airbyte-cdk = "0.8.0" or a more recent version of the CDK. We recommend migrating to at least CDK 1.0 or higher. The current version of the CDK at the time of this writing is 1.3.1.
• Step 3: Run poetry lock to update the dependencies and build the new version of the connector