Table

Tables enable you to quickly represent trace data in a tabular format.

Since tables sit on top of trace data, the steps to create a table from scratch are as follows:

1. Create a model.
2. Create a trace with columns or props that references your model.
3. Create a table that references the trace. Within the table.columns block you will need to explicitly state the trace columns and header names that you want to include.

Example

models:
  - name: table-model
    sql: |
        select
            project_name,
            project_created_at,
            cli_version,
            stage_name,
            account_name,
            stage_archived
        FROM visivo_project
traces:
  - name: pre-table-trace
    model: ref(table-model)
    columns:
        project_name: project_name
        project_created_at: project_created_at::varchar
        cli_version: cli_version
        stage_name: stage_name
        account_name: account_name
        stage_archived: stage_archived::varchar
    props:
        type: scatter
        x: column(project_created_at)
        y: column(project_name)
tables:
  - name: latest-projects-table
    traces:
      - ref(pre-table-trace)
    column_defs:
      - trace_name: pre-table-trace
        columns:
        - header: "Project Name"
          key: columns.project_name
        - header: "Project Created At"
          key: columns.project_created_at
        - header: "Project Json"
          key: columns.project_json
        - header: "CLI Version"
          key: columns.cli_version
        - header: "Stage Name"
          key: columns.stage_name
          aggregation: uniqueCount
        - header: "Account Name"
          key: columns.account_name
        - header: "Account Name"
          key: columns.stage_archived

Tables are built on the material react table framework.

Attributes

Field	Type	Default	Description
path	string	None	A unique path to this object
name	string	None	The unique name of the object across the entire project.
file_path	string	None	The path to the file that contains the object definition.
selector	Selector	None	The selector for the choosing which trace data is shown.
traces	Array of Trace	[]	A ref() to a trace or trace defined in line. Data for the table will come from the trace.
column_defs	Any of: TableColumnDefinition, array	None	A list of column definitions. These definitions define the columns for a given trace included in this table.
rows_per_page		50	The number of rows to show per page. Default is 50 rows