feat: Search within date range in pipeline run API

[yuechao-qin]

TL;DR

Implemented search within date range in Pipeline Runs.

What changed?

Functional

• API GET /api/pipeline_runs/
  • Search by date range in filter_query. Example query (not URL encoded for example):

      /api?filter_query={
        "and": [{
          "time_range": {
            "key": "system/pipeline_run.date.created_at",
            "start_time": "2024-01-01T00:00:00Z",
            "end_time": "2024-02-01T00:00:00Z"
          }
        }]
      }
    

Other

• Added timezone handling to convert aware datetimes to naive UTC for database compatibility (i.e. date range search will convert API timezone to UTC because DB datetime is only UTC)

How to test?

uv run pytest tests/test_api_server_sql.py tests/test_filter_query_sql.py

The implementation includes comprehensive tests covering:

• Basic time range filtering with start and end times
• Start-only time ranges (no end time)
• Boundary conditions (inclusive start, exclusive end)
• Timezone offset handling (e.g., +05:30 converted to UTC)
• Negation with NOT operator
• Combination with annotation-based filters
• Nested logical operations (AND/OR)
• Multiple time ranges in the same query

Why make this change?

• This change enables users to filter pipeline runs by creation date range.
• The implementation properly handles timezone conversions to ensure consistent behavior across different client timezones while maintaining compatibility with the database's naive UTC storage format.

[yuechao-qin]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat: Add include_sql to Search Pipeline Run API #135
• feat: Search pipeline run API uses pagination cursor #131
• feat: Search within date range in pipeline run API #130 👈 (View in Graphite)
• feat: Search pipeline name in pipeline run API #129
• refactor: Convert legacy filter to be filter_query #128
• feat: Search created by user in pipeline run API #108
• feat: Search annotations in pipeline run API #107
• feat: Create Pydantic models for Search Pipeline Run API #106
• refactor: Search pipeline run refactoring and baseline unit tests #105
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.