At least in the Java SDK, they both seem to be a locally executed function whose result becomes part of the event history. Is there any nuance to be aware of when choosing between one or the other?

@Greg_Haskins There are not any major nuances to be aware of when deciding on which to choose. However, as listed here “A Side Effect does not re-execute upon replay, but instead returns the recorded result.” Also, in the document listed above it goes over what can go wrong when using a failed Side…

SideEffect doesn’t support any error handling and non static dependencies. It is also executed inline in the workflow thread, so it should be very fast. So use it only for very simple operations like reading configuration or environment variables that are not ever expected to fail.

hey Maxim, just wanna clarify on this point It is also executed inline in the workflow thread, so in the context of go-sdk, calling local activity might cause the coroutine to yield and context switch to another coroutine?

Calling ExecuteActivity will not cause the switch, but calling Get on the returned Future will.

@maxim hi Maxim, does side effect and local activities also suits for non-io operation like pojo to pojo translation, de/serialization etc.? If so, then how it is operationally different from if we write the same as part of workflow itself, not as any “activity”?

You don’t need to use a local activity or a SideEffect for operations that don’t involve IO or other nondeterminism. Implement them directly as part of the workflow logic. The only exception would be operations that are very CPU intensive as they are reexecuted during workflow recovery (replay).

What is the difference between a Local Activity and a Side Effect?

Community Support

jreynolds23 October 10, 2022, 1:49pm 4

Also, please consider this response when trying to use local activities vs activities.

Topic		Replies	Views
SideEffect support in python SDK? Community Support python-sdk	2	282	November 12, 2024
Local Activity vs Activity Community Support activity , local-activity	23	23995	June 23, 2022
Local Activity restrictions Community Support activity , workflow-implementat	5	1253	May 6, 2021
Execute_local_actiivty use a different worker when some activity timed out Community Support local-activity	2	71	March 4, 2025
A Question about local activity Community Support	5	658	April 21, 2021

What is the difference between a Local Activity and a Side Effect?

Related topics