Azure service bus triggers, func.ServiceBusMessage or servicebus.ServiceBusReceivedMessage and settlements

[TorbjornHoltmon]

Is your question related to a specific version? If so, please specify:

What binding does your question apply to, if any? (e.g. Blob Trigger, Event Hub Binding, etc)

Service Bus

Question

I have been integrating some azure functions with service bus triggers, and I want to point out documentation I think should be updated or clearified.

The docs for function service bus bindings can be found here:

overview:
https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-service-bus?pivots=programming-language-python&tabs=isolated-process%2Cextensionv5

triggers:
https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-service-bus-trigger?tabs=python-v2%2Cisolated-process%2Cnodejs-v4%2Cextensionv5&pivots=programming-language-python

The example of triggers use both func.ServiceBusMessage and servicebus.ServiceBusReceivedMessage

The example points to https://github.com/Azure/azure-functions-python-extensions using https://pypi.org/project/azurefunctions-extensions-bindings-servicebus/

The releases of azurefunctions-extensions-bindings-servicebus are marked as pre-release. The examples in the repo show settlements, which is something we want to use. However, the docs says that

Message settlement is not yet supported.

But the whole package is pre-release, and servicebus.ServiceBusReceivedMessage is used in the in the docs, so are settlements actually supported too?

Also, the package azurefunctions-extensions-bindings-servicebus is dependant on uamqp which has a history of not building and working on arm mac os machines:

Azure/azure-uamqp-python#386
Azure/azure-uamqp-python#379
Azure/azure-uamqp-python#349
Azure/azure-uamqp-python#284
Azure/azure-uamqp-python#278
the list goes on...

And it is no longer activly maintained
Azure/azure-uamqp-python#374

If these are the bindings that azure wants us to use on azure service bus going forward, it should maybe use maintained libraries that mac os users can use.
We have ended up just using the old func.ServiceBusMessage to read messages, and live without manual settlements for now.
But I would love to know when we can use settlements, and if its planned anytime soon

[hallvictoria]

Hi @TorbjornHoltmon, thanks for reporting.

Message settlement requires both a change in the azurefunctions-extensions-bindings-servicebus package and the python worker. Both changes have been completed in azurefunctions-extensions-bindings-servicebus==1.0.0b2 and runtime version 4.1044. The runtime version updates are still rolling out, so once that is completed the documentation will be updated. ETA for that is November.

The team is aware of the uamqp dependency concern and is working on it. Once that is resolved, we'll release a non pre-release package and start looking to GA Service Bus SDK-type bindings. I don't have an ETA for this right now, but it would most likely be sometime in December or early next year.

Transferring this issue to the extensions repo for better tracking.