brimdata / zed

A novel data lake based on super-structured data
https://zed.brimdata.io/
BSD 3-Clause "New" or "Revised" License
1.38k stars 67 forks source link

Add a uniq docs example showing record values #5271

Closed philrz closed 2 weeks ago

philrz commented 3 weeks ago

What's Changing

Another example is being added to the docs for the uniq operator showing record values.

Why

An recent inquiry from a user on community Slack showed a lack of understanding about how uniq works. I got the sense that they thought things like differing timestamp values in adjacent records would not result in "uniqueness". While I can't say with certainty the docs update here would have made the difference, looking at what we've got through the eyes of a new user, the way all the current examples show only primitive values could be improved upon.

Details

FWIW, here was was in the community Slack thread I was reacting to:

I want to know why I can't use uniq filtering on column data

image

i.e., they seemed to think that the named fields in the sort would somehow carry over to what fields are considered by uniq. That's a leap far enough that I'm not inclined to add text speaking to that precise misunderstanding. But considering how many of our users still process logs with Zed/Zui, I figure having at least one example showing records may help a future user self-service via the docs before coming to Slack.