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: includes/functions-bindings-event-hubs.md
+44-35Lines changed: 44 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,11 +11,11 @@ ms.author: wujia
11
11
12
12
The extension NuGet package you install depends on the C# mode you're using in your function app:
13
13
14
-
# [Isolated worker model](#tab/isolated-process)
14
+
###[Isolated worker model](#tab/isolated-process)
15
15
16
16
Functions execute in an isolated C# worker process. To learn more, see [Guide for running C# Azure Functions in an isolated worker process](../articles/azure-functions/dotnet-isolated-process-guide.md).
@@ -27,43 +27,61 @@ In a variation of this model, Functions can be run using [C# scripting], which i
27
27
28
28
The functionality of the extension varies depending on the extension version:
29
29
30
-
# [Extension v5.x+](#tab/extensionv5/in-process)
30
+
###[Extension v6.x+](#tab/extensionv6/in-process)
31
31
32
32
_This section describes using a [class library](../articles/azure-functions/functions-dotnet-class-library.md). For [C# scripting], you would need to instead [install the extension bundle][Update your extensions], version 4.x._
This version uses the newer Event Hubs binding type [Azure.Messaging.EventHubs.EventData](/dotnet/api/azure.messaging.eventhubs.eventdata).
37
37
38
+
This extension version is available by installing the [NuGet package], version 6.x.
39
+
40
+
### [Extension v5.x](#tab/extensionv5/in-process)
41
+
42
+
_This section describes using a [class library](../articles/azure-functions/functions-dotnet-class-library.md). For [C# scripting], you would need to instead [install the extension bundle][Update your extensions], version 3.x or later._
This version uses the newer Event Hubs binding type [Azure.Messaging.EventHubs.EventData](/dotnet/api/azure.messaging.eventhubs.eventdata).
47
+
38
48
This extension version is available by installing the [NuGet package], version 5.x.
39
49
40
-
# [Extension v3.x+](#tab/extensionv3/in-process)
50
+
###[Extension v3.x+](#tab/extensionv3/in-process)
41
51
42
52
_This section describes using a [class library](../articles/azure-functions/functions-dotnet-class-library.md). For [C# scripting], you would need to instead [install the extension bundle][Update your extensions], version 2.x._
43
53
44
54
Supports the original Event Hubs binding parameter type of [Microsoft.Azure.EventHubs.EventData](/dotnet/api/microsoft.azure.eventhubs.eventdata).
45
55
46
56
Add the extension to your project by installing the [NuGet package], version 3.x or 4.x.
This version supports configuration of triggers and bindings through [.NET Aspire integration](../articles/azure-functions/dotnet-aspire-integration.md#connection-configuration-with-aspire).
69
+
70
+
Add the extension to your project by installing the [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventHubs), version 6.x.
This version supports configuration of triggers and bindings through [.NET Aspire integration](../articles/azure-functions/dotnet-aspire-integration.md#connection-configuration-with-aspire).
59
77
60
78
Add the extension to your project by installing the [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventHubs), version 5.x.
Add the extension to your project by installing the [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.EventHubs), version 4.x.
Version 1.x of the Functions runtime doesn't support running in an isolated worker process.
69
87
@@ -77,7 +95,7 @@ Version 1.x of the Functions runtime doesn't support running in an isolated work
77
95
78
96
The Event Hubs extension is part of an [extension bundle], which is specified in your host.json project file. You may need to modify this bundle to change the version of the binding, or if bundles aren't already installed. To learn more, see [extension bundle].
Earlier versions of the extension exposed types from the now deprecated [Microsoft.Azure.EventHubs] namespace. Newer types from [Azure.Messaging.EventHubs] are exclusive to **Extension v5.x+**.
147
160
148
161
This version of the extension supports parameter types according to the table below.
<sup>1</sup> Events containing JSON data can be deserialized into known plain-old CLR object (POCO) types.
157
170
158
-
# [Functions v1.x](#tab/functionsv1/in-process)
171
+
###[Functions v1.x](#tab/functionsv1/in-process)
159
172
160
173
Earlier versions of the extension exposed types from the now deprecated [Microsoft.Azure.EventHubs] namespace. Newer types from [Azure.Messaging.EventHubs] are exclusive to **Extension v5.x+**.
161
174
@@ -169,23 +182,19 @@ This version of the extension supports parameter types according to the table be
169
182
170
183
<sup>1</sup> Events containing JSON data can be deserialized into known plain-old CLR object (POCO) types.
The isolated worker process supports parameter types according to the tables below. Support for binding to types from [Azure.Messaging.EventHubs] is in preview.
Earlier versions of the extension in the isolated worker process only support binding to strings and JSON serializable types. More options are available to **Extension v5.x+**.
Functions version 1.x doesn't support the isolated worker process. To use the isolated worker model, [upgrade your application to Functions 4.x].
191
200
@@ -203,7 +212,7 @@ Functions version 1.x doesn't support the isolated worker process. To use the is
203
212
204
213
The [host.json](../articles/azure-functions/functions-host-json.md#eventhub) file contains settings that control behavior for the Event Hubs trigger. The configuration is different depending on the extension version.
@@ -262,7 +271,7 @@ The `clientRetryOptions` are used to retry operations between the Functions host
262
271
263
272
For a reference of host.json in Azure Functions 2.x and beyond, see [host.json reference for Azure Functions](../articles/azure-functions/functions-host-json.md).
264
273
265
-
# [Extension v3.x+](#tab/extensionv3)
274
+
###[Extension v3.x+](#tab/extensionv3)
266
275
267
276
```json
268
277
{
@@ -295,7 +304,7 @@ For a reference of host.json in Azure Functions 2.x and beyond, see [host.json r
295
304
296
305
For a reference of host.json in Azure Functions 2.x and beyond, see [host.json reference for Azure Functions](../articles/azure-functions/functions-host-json.md).
The isolated worker process supports parameter types according to the tables below. Support for binding to types from [Azure.Messaging.EventHubs] is in preview.
0 commit comments