The updateFile() GraphQL mutation may be used to change files in LogScale.

For information on loading and using files, see the Lookup Files documentation page.

Syntax

Below is the syntax for the updateFile() mutation field:

graphql
updateFile(
     fileName: string!
     name: string!
     changedRows: [[string!]!]!
     headers: [string!]!
     columnChanges: [ColumnChange!]!
     limit: integer
     offset: integer
   ): UploadedFileSnapshot!

Given Datatypes

For the given datatype, ColumnChange, there are several parameters that may be given. Below is a list of them along with their datatypes and a description of each:

Table: ColumnChange

ParameterTypeRequiredDefaultDescription
Some arguments may be required, as indicated in the Required column. For some fields, this column indicates that a result will always be returned for this column.
Table last updated: Sep 17, 2024
changeKindColumnChangeKindyes The kind of column change. See ColumnChangeKind.
indexintegeryes The index of the column to change.

Returned Datatypes

The returned datatype UploadedFileSnapshot has its own parameters. Below is a list of them along with their datatypes and a description of each:

Table: UploadedFileSnapshot

ParameterTypeRequiredDefaultDescription
Some arguments may be required, as indicated in the Required column. For some fields, this column indicates that a result will always be returned for this column.
Table last updated: Oct 4, 2024
filterStringstring  Any string on which to filter the data.
headers[string]yes The headers for the uploaded snapshot file.
limitintegeryes The file upload limit.
lines[string]yes The contents of the file in the form of a list of lines, with each line being itself a list of column values. When the file is empty or nothing matches filterString, then [] is returned.
nameAndPathFileNameAndPathyes The name and path of the uploaded snapshot file. See FileNameAndPath.
offsetintegeryes This is the offset supplied to a file query. For a new or updated file, this is always 0.
totalLinesCountlongyes The total number of lines in the uploaded snapshot file.