You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by po...@apache.org on 2023/09/05 16:01:51 UTC
[airflow] branch main updated: Improve documentation for AzureDataExplorerHook DefaultAzureCredential support (#34095)
This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new a3da008250 Improve documentation for AzureDataExplorerHook DefaultAzureCredential support (#34095)
a3da008250 is described below
commit a3da0082500f05b396ef069a5f401433f5539992
Author: Wei Lee <we...@gmail.com>
AuthorDate: Wed Sep 6 00:01:40 2023 +0800
Improve documentation for AzureDataExplorerHook DefaultAzureCredential support (#34095)
---
.../apache-airflow-providers-microsoft-azure/connections/adx.rst | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/docs/apache-airflow-providers-microsoft-azure/connections/adx.rst b/docs/apache-airflow-providers-microsoft-azure/connections/adx.rst
index b6ed71d482..230c3eff42 100644
--- a/docs/apache-airflow-providers-microsoft-azure/connections/adx.rst
+++ b/docs/apache-airflow-providers-microsoft-azure/connections/adx.rst
@@ -27,7 +27,7 @@ The ``Azure Data Explorer`` connection type enables Azure Data Explorer (ADX) in
Authenticating to Azure Data Explorer
---------------------------------------
-There are three ways to connect to Azure Data Explorer using Airflow.
+There are four ways to connect to Azure Data Explorer using Airflow.
1. Use `AAD application certificate
<https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-certificate-credentials>`_
@@ -38,6 +38,8 @@ There are three ways to connect to Azure Data Explorer using Airflow.
3. Use a `AAD device code
<https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-device-code>`_
(i.e. use "AAD_DEVICE" as the Authentication Method in the Airflow connection).
+4. Fallback on DefaultAzureCredential_.
+ This includes a mechanism to try different options to authenticate: Managed System Identity, environment variables, authentication through Azure CLI and etc.
Only one authorization method can be used at a time. If you need to manage multiple credentials or keys then you should
configure multiple connections.
@@ -64,6 +66,8 @@ Authentication Method
* AAD_DEVICE: Authenticate with AAD device code. Please note that if you choose this option, you'll need to authenticate for every new instance that is initialized. It is highly recommended to create one instance and use it for all queries.
+ * AZURE_TOKEN_CRED: Authentication with DefaultAzureCredential_. This includes a mechanism to try different options to authenticate: Managed System Identity, environment variables, authentication through Azure CLI and etc. Only the "Data Explorer Cluster URL" is required when using this method.
+
Username (optional)
Specify the username used for data explorer. Needed for with AAD_APP, AAD_APP_CERT, and AAD_CREDS authentication methods.
@@ -89,3 +93,6 @@ For example:
.. code-block:: bash
export AIRFLOW_CONN_AZURE_DATA_EXPLORER_DEFAULT='azure-data-explorer://add%20username:add%20password@mycluster.com?auth_method=AAD_APP&tenant=tenant+id'
+
+
+.. _DefaultAzureCredential: https://docs.microsoft.com/en-us/python/api/overview/azure/identity-readme?view=azure-python#defaultazurecredential