Zendesk Support Migration Guide
Upgrading to 4.0.0
The pagination strategy has been changed from Offset to Cursor-Based. It is necessary to reset the stream.
For Airbyte Open Source: Update the local connector image
Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
- Select Settings in the main navbar.
- Select Sources.
- Find Zendesk Support in the list of connectors.
You will see two versions listed, the current in-use version and the latest version available.
- Select Change to update your OSS version to the latest available version.
For Airbyte Cloud: Update the connector version
- Select Sources in the main navbar.
- Select the instance of the connector you wish to upgrade.
Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
- Select Upgrade
- Follow the prompt to confirm you are ready to upgrade to the new version.
Refresh affected schemas and data
- Select Connections in the main nav bar.
- Select the connection(s) affected by the update.
- Select the Replication tab.
- Select Refresh source schema.
- Select OK.
Any detected schema changes will be listed for your review.
- Select Save changes at the bottom of the page.
- Ensure the Refresh affected streams option is checked.
Depending on destination type you may not be prompted to refresh your data. See below.
- Select Save connection.
This will refresh the data in your destination and initiate a fresh sync.
For more information on refreshes your data in Airbyte, see this page.
Upgrading to 3.0.0
cursor_field for TicketsMetric stream is changed to generated_timestamp. It is necessary to refresh the data and schema for the affected stream.
Schema Changes - Added Field
| Stream Name | Added Fields |
|---|---|
TicketMetrics | generated_timestamp |
For Airbyte Open Source: Update the local connector image
Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
- Select Settings in the main navbar.
- Select Sources.
- Find Zendesk Support in the list of connectors.
You will see two versions listed, the current in-use version and the latest version available.
- Select Change to update your OSS version to the latest available version.
For Airbyte Cloud: Update the connector version
- Select Sources in the main navbar.
- Select the instance of the connector you wish to upgrade.
Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
- Select Upgrade
- Follow the prompt to confirm you are ready to upgrade to the new version.
Refresh affected schemas and data
- Select Connections in the main nav bar.
- Select the connection(s) affected by the update.
- Select the Replication tab.
- Select Refresh source schema.
- Select OK.
Any detected schema changes will be listed for your review.
- Select Save changes at the bottom of the page.
- Ensure the Refresh affected streams option is checked.
Depending on destination type you may not be prompted to refresh your data. See below.
- Select Save connection.
This will refresh the data in your destination and initiate a fresh sync.
For more information on refreshes your data in Airbyte, see this page.
Upgrading to 2.0.0
Stream Deleted Tickets is removed. You may need to refresh the connection schema (skipping the data clearing), and running a sync. Alternatively, you can clear your data.
Upgrading to 1.0.0
cursor_field for Tickets stream is changed to generated_timestamp.
For a smooth migration, you should refresh your stream. Alternatively, you can clear your data.