xref: /aosp_15_r20/external/perfetto/src/trace_processor/db/column/types.h (revision 6dbdd20afdafa5e3ca9b8809fa73465d530080dc)

/*
 * Copyright (C) 2023 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#ifndef SRC_TRACE_PROCESSOR_DB_COLUMN_TYPES_H_
#define SRC_TRACE_PROCESSOR_DB_COLUMN_TYPES_H_

#include <cstdint>
#include <limits>
#include <optional>
#include <utility>
#include <variant>
#include <vector>

#include "perfetto/base/logging.h"
#include "perfetto/trace_processor/basic_types.h"
#include "src/trace_processor/containers/bit_vector.h"
#include "src/trace_processor/containers/row_map.h"

namespace perfetto::trace_processor {

using Range = RowMap::Range;

// Result of calling Storage::SingleSearch function.
enum class SingleSearchResult {
  kMatch,            // The specified row matches the constraint.
  kNoMatch,          // The specified row does not matches the constraint.
  kNeedsFullSearch,  // SingleSearch was unable to determine if the row meets
                     // the crtiteria, a call to *Search is required.
};

// Result of calling Storage::ValidateSearchResult function.
enum class SearchValidationResult {
  kOk,       // It makes sense to run search
  kAllData,  // Don't run search, all data passes the constraint.
  kNoData    // Don't run search, no data passes the constraint.
};

// Used for result of filtering, which is sometimes (for more optimised
// operations) a Range and BitVector otherwise. Stores a variant of Range and
// BitVector.
class RangeOrBitVector {
 public:
  explicit RangeOrBitVector(Range range) : val(range) {}
  explicit RangeOrBitVector(BitVector bv) : val(std::move(bv)) {}

  bool IsRange() const { return std::holds_alternative<Range>(val); }
  bool IsBitVector() const { return std::holds_alternative<BitVector>(val); }

  BitVector TakeIfBitVector() && {
    PERFETTO_DCHECK(IsBitVector());
    return std::move(*std::get_if<BitVector>(&val));
  }
  Range TakeIfRange() && {
    PERFETTO_DCHECK(IsRange());
    return *std::get_if<Range>(&val);
  }

 private:
  std::variant<Range, BitVector> val;
};

// Represents the possible filter operations on a column.
enum class FilterOp {
  kEq,
  kNe,
  kGt,
  kLt,
  kGe,
  kLe,
  kIsNull,
  kIsNotNull,
  kGlob,
  kRegex,
};

// Represents a constraint on a column.
struct Constraint {
  uint32_t col_idx;
  FilterOp op;
  SqlValue value;
};

// Represents an order by operation on a column.
struct Order {
  uint32_t col_idx;
  bool desc = false;
};

// Structured data used to determine what Trace Processor will query using
// CEngine.
struct Query {
  enum class OrderType {
    // Order should only be used for sorting.
    kSort = 0,
    // Distinct, `orders` signify which columns are supposed to be distinct and
    // used for sorting.
    kDistinctAndSort = 1,
    // Distinct and `orders` signify only columns are supposed to be distinct,
    // don't need additional sorting.
    kDistinct = 2
  };
  OrderType order_type = OrderType::kSort;

  // Query constraints.
  std::vector<Constraint> constraints;

  // Query order bys. Check distinct to know whether they should be used for
  // sorting.
  std::vector<Order> orders;

  // Bitflags indicating whether column is used.
  //
  // If the top bit is set, that indicates that the every column >= 64 is used.
  uint64_t cols_used = std::numeric_limits<uint64_t>::max();

  // LIMIT value.
  std::optional<uint32_t> limit;

  // OFFSET value. Can be "!= 0" only if `limit` has value.
  uint32_t offset = 0;

  // Returns true if query should be used for fetching minimum or maximum value
  // of singular column.
  inline bool IsMinMaxQuery() const {
    // Order needs to specify the sorting.
    return order_type == Query::OrderType::kSort
           // There can be only one column for sorting.
           && orders.size() == 1
           // Limit has value 1
           && limit.has_value() && *limit == 1;
  }

  // Returns true if query should be used for sorting.
  inline bool RequireSort() const {
    return order_type != Query::OrderType::kDistinct && !orders.empty();
  }
};

// The enum type of the column.
// Public only to stop GCC complaining about templates being defined in a
// non-namespace scope (see ColumnTypeHelper below).
enum class ColumnType {
  // Standard primitive types.
  kInt32,
  kUint32,
  kInt64,
  kDouble,
  kString,

  // Types generated on the fly.
  kId,

  // Types which don't have any data backing them.
  kDummy,
};

// Contains an index to an element in the chain and an opaque payload class
// which can be set to whatever the user of the chain requires.
struct Token {
  // An index pointing to an element in this chain. Indicates the element
  // at this index should be filtered.
  uint32_t index;

  // An opaque value which can be set to some value meaningful to the
  // caller. While the exact meaning of |payload| should not be depended
  // upon, implementations are free to make assumptions that |payload| will
  // be strictly monotonic.
  uint32_t payload;

  struct PayloadComparator {
    bool operator()(const Token& a, const Token& b) {
      return a.payload < b.payload;
    }
  };
};

// Indicates the direction of the sort on a single chain.
enum class SortDirection {
  kAscending,
  kDescending,
};

}  // namespace perfetto::trace_processor

#endif  // SRC_TRACE_PROCESSOR_DB_COLUMN_TYPES_H_