Skip to content

Query

A Trails Query.

Fields

  • cancelRequestedbooleanrequired
  • createdAtstringrequired
    format: date-time
  • createdBystringrequired

    The principal who started it.

  • fromstringrequired
    format: date-time
  • idstringrequired
    format: uuid
  • queuePositioninteger | nullrequired

    Its place in the organization's line while it's queued (1 is next), in GetQuery's answer; null otherwise, and in lists.

    format: int64
  • sqlstringrequired
  • statusstringrequired

    queued, running, succeeded, failed or cancelled.

  • tostringrequired
    format: date-time
  • truncatedbooleanrequired
  • createdByIdentityoptionalobject | null
  • erroroptionalQueryErrorornull
    2 variants

    One of the following:

    • QueryError
      2 properties
      • codestringrequired

        timeout, memory_limit, too_much_data, quota_exceeded, query_too_large, cancelled, worker_lost, invalid_query or query_failed.

      • messageoptionalstring | null
    • null
  • finishedAtoptionalstring | null
  • resultRowsoptionalinteger | null
    format: int64
  • startedAtoptionalstring | null
  • statsoptionalQueryStatsornull
    2 variants

    One of the following:

    • QueryStats
      4 properties
      • bytesScannedstringrequired

        Bytes read, as a decimal string: it can exceed 2^53.

        format: int64, pattern: ^(0|[1-9][0-9]{0,18})$
        Example: "5020"
      • elapsedMsintegerrequired
        format: int64, minimum: 0
      • resultRowsintegerrequired
        format: int64, minimum: 0
      • rowsScannedintegerrequired
        format: int64, minimum: 0
    • null
Navigation

Type to search…

↑↓ navigate↵ selectEsc close