How to achieve atomicity (all or nothing)?

Suppose I have two states. In C, I can mutate them atomically (either all or none are mutated) using locks:

bool atomic_mutation() {
  lock(state1_lock);
  lock(state2_lock);

  bool success = mutate1(state1);
  if (!success) {
    unlock(state1_lock);
    unlock(state2_lock);
    return false;
  }

  success = mutate2(state2);
  if (!success) {
    // revert mutate1(state1)
    unlock(state1_lock);
    unlock(state2_lock);
    return false;
  }

  unlock(state1_lock);
  unlock(state2_lock);
  return true;
}

I’m new to Elixir. What I’ve learned is that I normally use an Agent to manage a state. But how to achieve atomicity shown above in Elixir? Thanks!

Edit: I fixed the bug in the C code above as pointed out by @al2o3cr

Hey welcome! The short answer is that if you need shared state and you need to control changes to that state then yeah you would use an agent or GenServer (more generally) and put the state inside that.

In general though as a functional language much of your program design will be avoiding such shared state at all.

1 Like

I understand that the functional style avoids shared states as much as possible. But shared states can’t be eliminated in many applications, like databases.

Suppose I have two tables in a database. I need to mutate both tables atomically in a transaction. How to achieve this in Elixir using Agent or GenServer?

One solution is to have an Agent manage both tables as one state. However, the downside is poor performance — when processA mutates table1 and processB mutates table2, the two mutations can’t be done in parallel, even if they are independent of each other.

I would simply use the database itself for this, it will provide a ton of dedicated tooling for it.

4 Likes

How do you make sure multiple actors changes are actually independent?

In the end you’ll surely get to the fact that immutability prevents certain optimizations, but generally the question should be how much those matter to the endproduct.

2 Likes

In the end you’ll surely get to the fact that immutability prevents certain optimizations, but generally the question should be how much those matter to the endproduct.

Good point.

How do you make sure multiple actors changes are actually independent?

Mutations of two tables seem surely independent. Can you provide an example?

Maybe someone wants to build a database in Elixir :slight_smile:

Put each table in a separate process and they’re independent.

1 Like
  • Put the state inside a GenServer.
  • Have it receive messages like :modify_twenty_things_inside_the_state.
  • Modify stuff together in the message handler, to your heart’s content.
  • ???
  • Profit.

Or if a database need be involved, they have their own transaction primitives as others said.

1 Like

The BEAM provides the infrastructure, but you need to write the code to glue things together into a consistent distributed system - and to be clear, once you have TWO GenServers you’re trying to make change together you’re in distributed-system territory.

For instance, here’s a very basic “table with a lock” GenServer (see below for notes):

defmodule TableWithLock do
  use GenServer

  defstruct [:data, :owner]

  def unlock(pid), do: GenServer.call(pid, :unlock)
  def lock(pid), do: GenServer.call(pid, :lock)
  def update(pid, fun), do: GenServer.call(pid, {:update, fun})

  @impl true
  def init(data) do
    {:ok, %__MODULE__{data: data, owner: nil}}
  end

  @impl true
  def handle_call(:lock, {pid, _tag}, state) do
    cond do
      is_nil(state.owner) ->
        # unlocked, pid now owns lock
        {:reply, :ok, %{state | owner: pid}}

      state.owner == pid ->
        # already locked by pid
        {:reply, :ok, state}

      true ->
        # locked by another process
        raise "oh no lock contention"
    end
  end

  def handle_call(:unlock, {pid, _tag}, state) do
    cond do
      is_nil(state.owner) ->
        # already not locked
        raise "somebody already unlocked this???"

      state.owner == pid ->
        # locked by the caller
        {:reply, :ok, %{state | owner: nil}}

      true ->
        # locked by somebody else
        raise "unlocking somebody else's lock"
    end
  end

  def handle_call({:update, fun}, {pid, _tag}, state) do
    cond do
      is_nil(state.owner) ->
        # not locked
        raise "not locked"

      state.owner == pid ->
        # locked by the caller
        result = fun.(state.data)
        {:reply, result, %{state | data: result}}

      true ->
        # locked by somebody else
        raise "updater not holding the lock"
    end
  end
end

{:ok, pid1} = GenServer.start_link(TableWithLock, [1,2,3])

:ok = TableWithLock.lock(pid1)

result = TableWithLock.update(pid1, fn data -> Enum.map(data, & &1*2) end)

:ok = TableWithLock.unlock(pid1)

IO.inspect(result)

There are a LOT of places where this could be work better / handle concurrency better:

  • crashing the table when a second process tries to take the lock is not realistic. A better implementation would keep a queue of pids that are currently trying to take the lock in lock and pick the next one to reply to in unlock.
  • crashing the table on bogus unlocks isn’t realistic either. An alternative would be to return something from handle_call that the implementation of unlock/1 could use to crash the calling process, since unlocking a table that you haven’t locked is a logic error
  • if a process dies while holding the lock, it will never be unlocked. Tools like Process.monitor can help with this, at the cost of additional complexity.

Expanding this setup to TWO tables adds some extra complications:

  • if process A takes lock 1 and then tries to take lock 2, while at the same time process B takes lock 2 and tries to take lock 1 the system is in a classic DEADLOCK situation. The default 5s timeout on GenServer.call will eventually pick a winner, but real systems will detect this and complain

  • coordinating changes to ensure that they either all appear or all do not is still just as tricky as always. You’d need a third process to coordinate the TableWithLocks and roll back changes if a future change fails.

    Note that even the code in your example does not produce atomicity - if mutate2 returns false, the changes from mutate1 are still visible.

    Solving this problem correctly is capital-H Hard and the solutions are highly sensitive to exactly what tradeoffs your particular application can tolerate.

4 Likes

Really appreciate your comprehensive answer!

I am not sure OP wanted distributed locks, I think they simply were looking for a way to achieve what other languages achieve with a lot of dancing on their forehead while singing “Hallelujah!” (i.e. mutexes, semaphores, condition variables and all the other horrors).

If there’s no distributed requirement then simply serializing access to certain pieces of data – or external resources – via a GenServer is plenty enough. And even if there are distributed requirements then you can just use Oban Pro with the right uniqueness parameters set. Done.

Normally I don’t pursue after OP accepted an answer but you might be doing disservice to them here by giving them a “lock equivalent”. And I am not sure it’s much of an equivalent with so many disclaimers.

Erlang BEAM VM’s philosophy is to avoid locking and just serialize access to things in a singular process. If there are multiple tables (whatever that means?) involved then why not access them in your GenServer message handler, one after another? A GenServer will never process more than one message at a time anyway. You can connect to 3 different databases and 5 different Amazon S3 buckets and 8 separate message queues with zero consistency and contention problems – integrate the saga pattern in your function (like this library does) and you’re done. Problem solved!

It works flawlessly unless you are stepping in the territory of C, C++, Rust et. al. in which case, well, you know, just code in them.

2 Likes

If you’re using Ecto, it has a built in way of achieving this via Ecto.Multi

Ecto.Multi is a data structure for grouping multiple Repo operations.

Ecto.Multi makes it possible to pack operations that should be performed in a single database transaction…

defmodule PasswordManager do
  alias Ecto.Multi

  def reset(account, params) do
    Multi.new()
    |> Multi.update(:account, Account.password_reset_changeset(account, params))
    |> Multi.insert(:log, Log.password_reset_changeset(account, params))
    |> Multi.delete_all(:sessions, Ecto.assoc(account, :sessions))
  end
end
4 Likes