You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/event-hubs/geo-replication.md
+35-4Lines changed: 35 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -155,7 +155,7 @@ Consuming applications can consume data using the namespace hostname of a namesp
155
155
156
156
### Checkpointing/Offset Management
157
157
158
-
Event consuming applications can continue to maintain offset management as they would do it with a single namespace.
158
+
Event consuming applications can continue to maintain offset management as they would do it with a non-geo replicated namespace. No special consideration is needed for offset management for geo-replication enabled namespaces.
159
159
160
160
> [!WARNING]
161
161
> In the event of forced failover (i.e. non graceful failover), some of the data that hasn't been copied over may be lost. This may cause the offsets of that specific data to be different across the primary and secondary regions for the namespace, however it would still be within the bounds of the maximum replication lag configured for the namespace.
@@ -164,13 +164,44 @@ Event consuming applications can continue to maintain offset management as they
164
164
165
165
#### Kafka
166
166
167
-
Offsets are committed to Event Hubs directly and offsets are replicated across regions. Therefore, consumers can start consuming from where it left off in the primary region.
167
+
Offsets are committed to Event Hubs directly and offsets are replicated across regions. Therefore, consumers can start consuming from where it left off in the primary region.
168
+
169
+
Here are the list of Apache Kafka clients that are supported -
170
+
171
+
TBD add versions.
172
+
| Client name | Version |
173
+
| ----------- | ------- |
174
+
| Apache Kafka ||
175
+
| Librdkafka and derived libraries ||
176
+
177
+
In the case of other libraries, these are supported based on the versioning of the specific definitions -
178
+
179
+
TBD add protocol versions.
180
+
| Operation name | Version supported |
181
+
| -------------- | ----------------- |
182
+
|||
183
+
|||
184
+
|||
185
+
168
186
169
187
#### Event Hubs SDK/AMQP
170
188
171
-
TBD - call out that Track 0 SDKs will have trouble. Track 1 and later are fine.
189
+
In the case of AMQP, the checkpoint is managed by users with a checkpoint store such as Azure Blob storage or a custom storage solution. If there's a failover, the checkpoint store must be available from the secondary region so that clients can retrieve checkpoint data and avoid loss of messages.
190
+
191
+
The latest version of the Event Hubs SDK has made some changes to checkpoint representation to supports failovers. We recommend using the [latest versions of the SDKs](sdks.md), but prior versions of the below SDKs are supported as well.
172
192
173
-
Clients that use the Event Hubs SDK need to upgrade to the April 2024 version of the SDK. The latest version of the Event Hubs SDK supports failover with an update to the checkpoint. The checkpoint is managed by users with a checkpoint store such as Azure Blob storage, or a custom storage solution. If there's a failover, the checkpoint store must be available from the secondary region so that clients can retrieve checkpoint data and avoid loss of messages.
> If you use the legacy SDK, [Windows.Azure.ServiceBus](https://www.nuget.org/packages/WindowsAzure.ServiceBus/) you may encounter issues consuming from a geo-replication namespace after promotion of the secondary to primary.
202
+
>
203
+
> It is recommended to upgrade to the [latest versions of the SDKs](sdks.md)
0 commit comments