|
1 | 1 | ---
|
2 |
| -title: Handle large messages by using chunking |
3 |
| -description: Learn how to handle large message sizes by using chunking in automated tasks and workflows that you create with Azure Logic Apps |
| 2 | +title: Handle large messages in workflows using chunking |
| 3 | +description: Handle large messages using chunking in Azure Logic Apps. |
4 | 4 | services: logic-apps
|
5 | 5 | ms.suite: integration
|
6 |
| -ms.topic: article |
| 6 | +ms.topic: how-to |
7 | 7 | ms.date: 12/18/2020
|
8 | 8 | ---
|
9 | 9 |
|
10 |
| -# Handle large messages with chunking in Azure Logic Apps |
| 10 | +# Handle large messages in workflows using chunking in Azure Logic Apps |
11 | 11 |
|
12 |
| -When handling messages, Logic Apps limits message content to a maximum size. |
13 |
| -This limit helps reduce overhead created by storing and processing large messages. |
14 |
| -To handle messages larger than this limit, Logic Apps can *chunk* a large |
15 |
| -message into smaller messages. That way, you can still transfer large |
16 |
| -files using Logic Apps under specific conditions. |
17 |
| -When communicating with other services through connectors or HTTP, |
18 |
| -Logic Apps can consume large messages but *only* in chunks. |
19 |
| -This condition means connectors must also support chunking, or the underlying |
20 |
| -HTTP message exchange between Logic Apps and these services must use chunking. |
| 12 | +Azure Logic Apps has different maximum limits on the message content size that triggers and actions can handle in logic app workflows, based on the logic app resource type and the environment where that logic app workflow runs. These limits help reduce any overhead that results from storing and processing [large messages](#what-is-large-message). For more information about message size limits, review [Message limits in Azure Logic Apps](logic-apps-limits-and-config.md#messages). |
21 | 13 |
|
22 |
| -This article shows how you can set up chunking for actions handling messages that are |
23 |
| -larger than the limit. Logic App triggers don't |
24 |
| -support chunking because of the increased overhead of exchanging multiple messages. |
| 14 | +If you're using built-in HTTP actions or specific managed connector actions, and you need Azure Logic Apps to work with messages larger than the default limits, you can enable *chunking*, which splits a large message into smaller messages. That way, you can still transfer large files under specific conditions. In fact, when you use these built-in HTTP actions or specific managed connector actions, chunking is the only way that Azure Logic Apps can consume large messages. This requirement means that either the underlying HTTP message exchange between Azure Logic Apps and other services must use chunking, or that the connections created by the managed connectors that you want to use must also support chunking. |
| 15 | + |
| 16 | +> [!NOTE] |
| 17 | +> Azure Logic Apps doesn't support chunking on triggers due to the increased overhead from exchanging multiple messages. |
| 18 | +> Also, Azure Logic Apps implements chunking for HTTP actions using its own protocol as described in this article. |
| 19 | +> So, even if your web site or web service supports chunking, they won't work with HTTP action chunking. |
| 20 | +> To use HTTP action chunking with your web site or web service, you have to implement the same protocol |
| 21 | +> that's used by Azure Logic Apps. Otherwise, don't enable chunking on the HTTP action. |
| 22 | +
|
| 23 | +This article provides an overview about how chunking works in Azure Logic Apps and how to set up chunking on supported actions. |
| 24 | + |
| 25 | +<a name="what-is-large-message"></a> |
25 | 26 |
|
26 | 27 | ## What makes messages "large"?
|
27 | 28 |
|
@@ -58,7 +59,6 @@ For connectors that support chunking, the underlying chunking protocol is invisi
|
58 | 59 | However, not all connectors support chunking, so these connectors generate runtime
|
59 | 60 | errors when incoming messages exceed the connectors' size limits.
|
60 | 61 |
|
61 |
| - |
62 | 62 | For actions that support and are enabled for chunking, you can't use trigger bodies, variables, and expressions such as `@triggerBody()?['Content']` because using any of these inputs prevents the chunking operation from happening. Instead, use the [**Compose** action](../logic-apps/logic-apps-perform-data-operations.md#compose-action). Specifically, you must create a `body` field by using the **Compose** action to store the data output from the trigger body, variable, expression, and so on, for example:
|
63 | 63 |
|
64 | 64 | ```json
|
|
0 commit comments