Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Unclear documentation for the delegate_to parameter

See original GitHub issue

Hello,

Most GCP operators accept the delegate_to parameter. It is not super well documented and it can be confusing to users exactly when they would use this as opposed to another conn id.

A little more documentation on the following page would be helpful. https://airflow.readthedocs.io/en/latest/howto/connection/gcp.html

You can get extra points for adding information about Impersonated credentials . This feature is not supported by Airflow, but it is related (ticket).

Are you wondering how to start contributing to this project? Start by reading our contributor guide

Best regards, Kamil

CC: @jaketf

Issue Analytics

State:
Created 3 years ago
Reactions:1
Comments:12 (11 by maintainers)

Top GitHub Comments

1reaction

turbaszekcommented, Aug 7, 2020

@olchas I’m in favour of 2nd approach. Regarding the deprecation - first I would check if current implementation works. If it does not then I see no reason for deprecation - let us just remove it.

1reaction

olchascommented, Aug 7, 2020

@jaketf, @amithmathew so it would seem that the approach could be to:

disallow simultaneous use of delegate_to and impersonation_chain (new argument used for direct impersonation) in GoogleBaseHook by raising an exception if both arguments are provided
remove delegate_to from most Google operators and hooks, leaving it only in G Suite operators and hooks

WDYT? CC: @turbaszek

Top Results From Across the Web

Delegates | Unreal Engine Documentation

Data types that reference and execute member functions on C++ Objects.

c# - How do you provide xml comments/documentation for ...

I want to hover over the delegate or have intellisense popup when I type and tell me the descriptions for the the delegate...

Spring Data JPA - Reference Documentation

Spring Data repository documentation and your module ... To handle parameters in your query, define method parameters as already seen in the ...

Groovy Language Documentation

Simple delegation; Delegation strategy; Delegate to parameter ... Using such words as method names is potentially confusing and is often best to avoid, ......

Action<T> Delegate (System) - Microsoft Learn

The parameter of the method that this delegate encapsulates. Examples. The following example demonstrates the use of the Action<T> delegate to print the ......