Fixes AzureFileShare connection extras

[potiuk]

The Azure File Share connection has not been creted in #15159 and it
caused an unexpected side effect as the default Azure Connection
passed service_options dictionary to FileService
with key that was unexpected.

This change fixes two things:

1. adds AzureFileShare connection that has separate conn_type
   and handles the extra_options specific for FileService Hook
   available in the Airflow UI.

2. handles the "deprecated" way of passing keys without UI prefix
   but raises a deprecation warning when such key is passed or
   when the Wasb connection is used with an empty extras rather
   than Azure File Share.

Fixes #16254

---

^ Add meaningful description above

Read the Pull Request Guidelines for more information.
In case of fundamental code change, Airflow Improvement Proposal (AIP) is needed.
In case of a new dependency, check compliance with the ASF 3rd Party License Policy.
In case of backwards incompatible changes please leave a note in UPDATING.md.

[potiuk]

cc: @sunkickr @cvsekhar

[github-actions]

The PR is likely OK to be merged with just subset of tests for default Python and Database versions without running the full matrix of tests, because it does not modify the core of Airflow. If the committers decide that the full tests matrix is needed, they will add the label 'full tests needed'. Then you should rebase to the latest main or amend the last commit of the PR, and push it with --force-with-lease.

[potiuk]

I also changed the tests to fix the annoying behaviour of having to fix tests after every new connection (I am now just checking if the returned arrays have reasonable size > x) rather than exact content/list. That should be good enough and avoid the extra hoop of falling CI when you think you've added new connection/provider etc.

[github-actions]

The PR most likely needs to run full matrix of tests because it modifies parts of the core of Airflow. However, committers might decide to merge it quickly and take the risk. If they don't merge it quickly - please rebase it to the latest main at your convenience, or amend the last commit of the PR, and push it with --force-with-lease.

[sunkickr]

@potiuk thanks for fixing this error!

[potiuk]

No problem. I am merging it in soon and that's last thing before releasing the providers (it's been delayed due to my unavailability but I am catching up).

[sunkickr]

@potiuk an Azure Container Volume connection was also not created in #15159. Wondering if this would cause any similar issues with AzureContainerVolumeHook as it also uses the 'wasb_default' connection id?

[potiuk]

Good point. Yeah I think this needs fixing as well:

airflow/airflow/providers/microsoft/azure/hooks/azure_container_volume.py

Line 42 in 86b9d3b

if 'connection_string' in service_options:

It will not crash, but it will not use the extra either

[potiuk]

I also noticed that howtos needs updating

[potiuk]

Added new connection type and updated the howtos in latest fixup @sunkickr - would you mind taking a look ?