PageInfo

The page info object used for pagination.

startCursor
String

Points to the first item returned in the results. Used when paginating backward.

endCursor
String

Points to the last item returned in the results. Used when paginating forward.

hasNextPage
Boolean
required

A boolean that indicates whether a next page of results exists. Can be used to display a “next page” button in user interfaces, for example.

hasPreviousPage
Boolean
required

A boolean that indicates whether a previous page of results exists. Can be used to display a “previous page” button in user interfaces, for example.

MetricReportConnection

The Metric Report connection object.

It includes headers and rows for a single page of a report. It also allows paging forward and backward to other pages of the report.

pageInfo
PageInfo
required

The report connection’s page info.

edges
[MetricReportEdge!]
required

The report connection’s edges.

nodes
[MetricReportNode!]
required

The report connection’s nodes.

headers
[String]
required

An ordered array of display names for your dimensions and Metrics, as defined in the report input. Use this to display your table’s header.

rows
[[String]!]
required

An ordered array of rows. Each row contains dimension and Metric values, as defined in the report input. Use these to display the rows of your table.

query
QueryInfo
required

The Query statistics and metadata.

MetricReportEdge

The Metric Report edge object.

node
MetricReportNode
required

The edge’s node.

cursor
String
required

The edge’s cursor.

MetricReportNode

The Metric Report node object.

This type represents a single row of a report.

headers
[String]
required

An ordered array of display names for your dimensions and Metrics, as defined in the report input. Use this to display your table’s header.

row
[String]
required

An ordered array of columns. Each column contains the dimension and Metric values for a single row, as defined in the report input. Use this to display a single row within your table.

TimeSeriesResponse

The time series response object. It contains an array of time series labels and an array of Metric values for the given time range and Query Filters.

labels
[String!]
required

The time series labels.

values
[String]
required

The time series values.

groups
[TimeSeriesResponseGroup!]

The time series values for each group in groupBy, if specified.

query
QueryInfo
required

The Query statistics and metadata.

TimeSeriesResponseGroup

The time series response object for a group specified in groupBy. It contains an array of time series labels and an array of Metric values for a particular group.

group
[String]
required

The time series group’s columns.

labels
[String!]
required

The time series group’s labels.

values
[String]
required

The time series group’s values.

CounterResponse

The counter response object. It contains a single Metric value for the given time range and Query Filters.

value
String

The value of the counter.

query
QueryInfo
required

The Query statistics and metadata.

LeaderboardResponse

The leaderboard response object. It contains an array of headers and a table (array of rows) with the selected Dimensions and corresponding Metric values for the given time range and Query Filters.

headers
[String!]
required

The table headers. It contains the Dimension and Metric names.

rows
[[String]!]
required

An ordered array of rows. Each row contains the Dimension values and the corresponding Metric value. A Dimension value can be empty. A Metric value will never be empty.

query
QueryInfo
required

The Query statistics and metadata.

QueryInfo

The Query Info object. It contains metadata and statistics about a Query performed.

id
ID
required

The Query’s unique identifier.

createdAt
DateTime
required

The date and time in UTC when the Query was created.

createdBy
String
required

The unique identifier of the actor that performed the Query.

modifiedAt
DateTime
required

The date and time in UTC when the Query was last modified.

modifiedBy
String
required

The unique identifier of the actor that modified the Query.

bytesProcessed
String
required

The bytes processed by the Query.

durationInMilliseconds
Int
required

The duration of the Query in milliseconds.

recordsProcessed
String
required

The number of records processed by the Query.

resultingBytes
Int
required

The bytes returned by the Query.

resultingRecords
Int
required

The number of records returned by the Query.

propeller
Propeller

The Propeller used for this query.

status
QueryStatus
required

The Query status.

type
QueryType
required

The Query type.

subtype
QuerySubtype

The Query subtype.

sql
String
required

The SQL the query executed.

SqlColumnResponse

columnName
String
required

The name of the returned column.

type
ColumnType
required

The returned column’s type.

isNullable
Boolean
required

Whether the column is nullable, meaning whether it accepts a null value.

SqlResponse

Response from the SQL API.

columns
[SqlColumnResponse!]
required

The column names in the same order as present in the data field.

rows
[[String]!]
required

The data gathered by the SQL query. The data is returned in an N x M matrix format, where the first dimension are the rows retrieved, and the second dimension are the columns. Each cell can be either a string or null, and the string can represent a number, text, date or boolean value.

info
QueryInfo
required

The Query statistics and metadata.

DescribeSqlResponse

Response from the describe SQL API.

columns
[SqlColumnResponse!]
required

The columns that the query would return.

DataGridConnection

The Data Grid connection.

It includes headers and rows for a single page of a Data Grid table. It also allows paging forward and backward to other pages of the Data Grid table.

headers
[String!]
required

The Data Grid table’s headers.

rows
[[String]!]
required

An array of arrays containing the values of the Data Grid table’s rows.

query
QueryInfo
required

The Query statistics and metadata.

pageInfo
PageInfo
required

The Data Grid table’s page info.

edges
[DataGridEdge!]
required

The Data Grid table’s edges.

nodes
[DataGridNode!]
required

The Data Grid table’s nodes.

DataGridEdge

The Data Grid edge object.

node
DataGridNode
required

The edge’s node.

cursor
String
required

The edge’s cursor.

DataGridNode

The Data Grid table’s node.

This type represents a single row of a Data Grid table.

headers
[String!]
required

The Data Grid table’s headers.

row
[String]
required

An array of the values for the row.

RecordsByUniqueIdResponse

columns
[String!]
required

The Data Pool columns for the record.

values
[[String]!]
required

An array of values for the record.

query
QueryInfo
required

The Query statistics and metadata.

TopValuesResponse

values
[String!]
required

An array with the list of values.

metricReport
MetricReportConnection

Build a report, or table, consisting of multiple Metrics broken down by one-or-more dimensions.

The first few columns of the report are the dimensions you choose to break down by. The subsequent columns are the Metrics you choose to query. By default, the report sorts on the first Metric in descending order, but you can configure this with the orderByMetric and sort inputs.

Finally, reports use cursor-based pagination. You can control page size with the first and last inputs.

Arguments

input
MetricReportInput
required
sqlV1
SqlResponse
required

Query Data Pools using SQL.

Arguments

input
SqlV1Input
required
describeSqlV1
DescribeSqlResponse
required

Describe SQL statements Data Pools.

Arguments

input
DescribeSqlV1Input
required
dataGrid
DataGridConnection
required

Returns the individual records of a Data Pool with the convenience of built-in pagination, filtering, and sorting.

Arguments

input
DataGridInput
required
recordsByUniqueId
RecordsByUniqueIdResponse
required

Returns records by the given unique IDs.

Arguments

input
RecordsByUniqueIdInput
required
topValues
TopValuesResponse
required

Returns an array of the most frequent values in a given column. The resulting array is sorted in descending order of approximate frequency of values.

Arguments

input
TopValuesInput
required
counter
CounterResponse

Query a metric in counter format. Returns a single metric value for the given time range and filters.

Arguments

input
CounterInput
required
counters
[CounterResponse]
required

Query metrics in counter format. Returns a metric value for each input in the array of inputs.

Arguments

input
[CounterInput!]
required
timeSeries
TimeSeriesResponse

Query a metric in time series format. Returns arrays of timestamps and metric values for the given time range and filters.

Arguments

input
TimeSeriesInput
required
leaderboard
LeaderboardResponse

Query a metric in leaderboard format. Returns a table (array of rows) with the selected dimensions and the metric’s corresponding values for the given time range and filters.

Arguments

input
LeaderboardInput
required