gtme groups
List groups with their entity type and derived character (members, added/removed/touched tallies), inspect one
What you'll learn
You're about to type gtme groups and want its forms and its flags.
- every form of
gtme groupsand what each does - each flag and what it changes
- where the docs use it
List groups with their entity type and derived character (members, added/removed/touched tallies), inspect one (members, events, and the pipelines that wrote to and sourced from it), or hand-edit membership; snapshots evaluate a segment or SQL into extensional membership with provenance (ADR-021); a group holds one type, set at creation (ADR-054) — --type sets an untyped legacy group's type once, and is required when a key is ambiguous or no key is given; --note records a removal's reason (ADR-032)
Forms
gtme groups [show NAME | add NAME KEY...|--from-segment NAME|--query SQL|--type TYPE | remove NAME KEY... [--note TEXT]]
Flags
| Flag | Takes | What it does |
|---|---|---|
--from-segment | NAME | See the form. |
--type | TYPE | --type sets an untyped legacy group's type once, and is required when a key is ambiguous or no key is given. |
--note | TEXT | --note records a removal's reason (ADR-032) |
It exits with one of the exit codes every verb shares.
Example
From Groups and segments:
gtme groups
Used in
- Groups and segments: Every gtme groups verb and flag
- Guard: Creates and fills a group such as the suppression group plan asked for
- Segment: Every gtme groups verb, including add --from-segment
- Multi-stage campaigns with groups: Every gtme groups verb, including show and remove with --note
- Traverse a relation: Every verb for the typed groups the two runs end in