topic Re: Autoloader - File Notification Mode in Data Engineering

Autoloader - File Notification Mode

saurabh18cs — Fri, 26 Sep 2025 15:21:00 GMT

Hello All,

We have started to consume source messages/files via autoloader directory listing mode at the moment and want to convert this to file notification mode instead so consumption can be faster with no more entire directories/folder scanning. I am looking for following clarifications:

1) when we have multiple jobs processing files at the same time where we also have to consider latency and throughput in mind for these jobs, what could be the ideal solution to use a shared queue on storage account or multiple queues?

2) do we forsee any limitations on how many files can get process with this setup every second/minute?

thank you

Re: Autoloader - File Notification Mode

K_Anudeep — Sat, 27 Sep 2025 08:55:55 GMT

Hello @saurabh18cs !

You don’t need to choose queues and simply use the “File events” path. When enabled, Databricks uses one managed queue per external location (Unity Catalogue), and all your streams that read from that location share it. This avoids cloud queue limits, and Databricks auto-tunes the notification plumbing.

Doc: https://docs.databricks.com/aws/en/ingestion/cloud-object-storage/auto-loader/file-notification-mode#-use-file-notification-mode-with-file-events

If you stay in the current file notification mode, the default pattern is one queue per stream, and Databricks recommends fan-out only when you’re constrained by provider limits

I think throughput has no fixed per-second cap. By default, it processes up to 1,000 files per micro-batch; tune with cloudFiles.maxFilesPerTrigger

Please let me know if you have any further questions.

Re: Autoloader - File Notification Mode

szymon_dybczak — Sat, 27 Sep 2025 09:05:05 GMT

Hi @saurabh18cs ,

You are making a very good decision by moving from directory listing to file notification mode. Regarding your questions:

Databricks recommends using one shared queue instead of creating one per autoloader stream. In fact, this is reflected in new file notification mode with file events. Because when we're talking about file notification mode it comes with 2 flavours:

Legacy file notification mode - no longer recommended. In this mode you manage file notification queues for each Auto Loader stream separately. Auto Loader automatically sets up a notification service and queue service that subscribes to file events from the input directory.
File notification mode with file events - you use a single Azure Databricks-managed file notification queue for all streams that process files from any given external location defined in Unity Catalog.
It has the following advantages over the legacy approach:
- Azure Databricks can set up subscriptions and file events in your cloud storage account for you without requiring that you supply additional credentials to Auto Loader using a service credential or other cloud-specific authentication options.
- You have fewer Azure managed identity policies to create in your cloud storage account.
- Because you no longer need to create a queue for each Auto Loader stream, it's easier to avoid hitting the cloud provider notification limits listed in Cloud resources used in legacy Auto Loader file notification mode.
- Azure Databricks automatically manages the tuning of resource requirements, so you don't need to tune parameters such as cloudFiles.fetchParallelism.
- Cleanup functionality means that you don't need to worry as much about the lifecycle of notifications that are created in the cloud, such as when a stream is deleted or fully refreshed.

2) Regarding limitations, in legacy file notification mode the main one limitations - you can have only 500 queues per storage account can be easily overcome using recommend file notfication mode with file events.
Also from maintenance perspective is way worse because you need to take care of so many queues.

Configure Auto Loader streams in file notification mode - Azure Databricks | Microsoft Learn

In case of Auto Loader with file events mode - list of limitations is available at below links:

Configure Auto Loader streams in file notification mode - Azure Databricks | Microsoft Learn

Manage external locations - Azure Databricks | Microsoft Learn

Re: Autoloader - File Notification Mode

saurabh18cs — Mon, 29 Sep 2025 08:32:33 GMT

Hi @K_Anudeep @szymon_dybczak how do i understand a situation when 100 jobs are running in parallel with minimal latency needed. does autoloader directly connect to the cloud queue service ? or databricks stores and manages detected files somewhere? any azure cloud limit in this design?

Re: Autoloader - File Notification Mode

szymon_dybczak — Mon, 29 Sep 2025 08:41:45 GMT

Hi @saurabh18cs ,

Since Auto Loader with file notification mode uses Azure Storage Queue hence it is subject to the limitations related to Storage Queue. Below you can find them:

Scalability and performance targets for Queue Storage - Azure Storage | Microsoft Learn

From my experiance queues scale really well, but you need to test it on your environment