Function ExtractConditionGroups

pkg/traceql/lenient_extract.go:24–71

ExtractConditionGroups parses a query string using the lenient parser and returns groups of conditions. Conditions with OpNone (from incomplete matchers) are filtered out. Returns nil if the query is empty or parsing fails completely. Returns nil, ErrMaxConditionGroupsPerTagQueryReached if the numb

(query string, maxGroups int)

// Returns nil if the query is empty or parsing fails completely.
// Returns nil, ErrMaxConditionGroupsPerTagQueryReached if the number of groups exceeds maxGroups.
func ExtractConditionGroups(query string, maxGroups int) ([][]Condition, error) {
	if maxGroups <= 0 {
		maxGroups = DefaultMaxConditionGroupsPerTagQuery
	}
	query = strings.TrimSpace(query)
	if len(query) == 0 {
		return nil, nil
	}

	expr, err := ParseLenient(query)
	if err != nil {
		return nil, nil
	}
	if err := expr.validate(); err != nil {
		return nil, nil
	}

	// Find the first SpansetFilter in the pipeline.
	// Returns nil for structural operators (SpansetOperation) indicating multiple spansets.
	filter := findSpansetFilter(expr.Pipeline)
	if filter == nil {
		return nil, nil
	}

	groups, reachedMaxGroupsInSplitConditions := splitReqConditions(filter.Expression, maxGroups)
	for i := range groups {
		// Filter out OpNone conditions — these are column-fetch hints (bare attributes,
		// structural intrinsics), not filterable conditions.
		conditions := make([]Condition, 0, len(groups[i]))
		for _, cond := range groups[i] {
			if cond.Op != OpNone {
				conditions = append(conditions, cond)
			}
		}

		// if even one group has zero conditions after filtering, treat the whole query as empty (e.g. `{.attr || .foo}`)
		if len(conditions) == 0 {
			return nil, nil
		}
		groups[i] = conditions
	}

	if reachedMaxGroupsInSplitConditions {
		return nil, fmt.Errorf("%w (limit: %d). Reduce the number of OR conditions in the query", ErrMaxConditionGroupsPerTagQueryReached, maxGroups)
	}

	return groups, nil
}

// IsEmptyQuery returns true if the query is empty or a match-all (e.g. "{}", "{ }", "{ true }").
func IsEmptyQuery(query string) bool {