COLLECT( )

Aggregates occurrences of metadata, including timestamps. Returns a separate item for each occurrence.

Syntax

COLLECT( [metadata key ] [ operator ] [value ] )

Parameters

Parameters are those for INCLUDE(), though only one key/operator/value group is accepted. To collect multiple outputs, use multiple COLLECT() calls. Note that COLLECT() collects metadata only from nodes that are included in the INCLUDE() call(s).

  • key name operator value
    • key name may be:
      • any key name in the project, including system keys
      • * matches “any key”
    • operator may be one of:
      • = “equals / is”
      • ? “contains”
      • before “is before” (for comparing Timestamps)
      • after “is after” (for comparing Timestamps)
    • value may be:
      • any metadata value in — or not in — the project. Values not in the project will return empty results
      • * matches “any value”