apache / druid

Apache Druid: a high performance real-time analytics database.
https://druid.apache.org/
Apache License 2.0
13.46k stars 3.7k forks source link

Missing doc for RegisteredLookup DimensionSpecs? #5895

Closed QubitPi closed 4 years ago

QubitPi commented 6 years ago

I found doc for Lookup DimensionSpecs in drui.io/docs/latest/querying/dimensionspecs.html, but not for RegisteredLookup

josephglanville commented 6 years ago

It's documented but poorly. Basically instead of using lookup with the lookup extraction definition you specify name as the name of a registered lookup. The 2 options are mutually exclusive, if name is specified then the LookupReferencesManager will be called to build the extraction function, otherwise lookup is used. The language on that page isn't great, if I have some time I might try make it clearer. It should also be more clear how to use them on this page too: http://druid.io/docs/latest/querying/lookups.html

gianm commented 6 years ago

Good point. @QubitPi, @josephglanville, are either of you interested in updating the docs to be clearer?

QubitPi commented 6 years ago

@josephglanville , @gianm Thank you for the update. My team uses registered lookup and I have experience developing Druid extensions on top of it. I can find some time as soon as possible to update the doc.

stale[bot] commented 5 years ago

This issue has been marked as stale due to 280 days of inactivity. It will be closed in 2 weeks if no further activity occurs. If this issue is still relevant, please simply write any comment. Even if closed, you can still revive the issue at any time or discuss it on the dev@druid.apache.org list. Thank you for your contributions.

stale[bot] commented 4 years ago

This issue has been marked as stale due to 280 days of inactivity. It will be closed in 4 weeks if no further activity occurs. If this issue is still relevant, please simply write any comment. Even if closed, you can still revive the issue at any time or discuss it on the dev@druid.apache.org list. Thank you for your contributions.

stale[bot] commented 4 years ago

This issue has been closed due to lack of activity. If you think that is incorrect, or the issue requires additional review, you can revive the issue at any time.