Creating a CSV data source

Data sources can be created at the organisation level, meaning that the Data sources you create can be shared among the members of your organisation.

To create a data source:

  • Navigate to the Data Sources page.

  • Click on the button, +Create new data source.

  • Choose CSV based from the dropdown and select the CSV file containing your data.

  • Provide a name for your data source.

  • Click save at the bottom of the page.

Editing a CSV data source

Data sources can be updated after creation.

To edit a data source:

  • Navigate to the Data Sources page.
  • Click on the data source you wish to edit, from the list provided.
  • Update your data source.
  • Click on the save at the bottom of the page.

Once in the data source page, you will be able to:

  • Replace the csv file
  • Rename the data source
  • Change the column types

Columns

Column names

When uploading the CSV file, please ensure the following requirements for the column names:

  • Column names must be unique within the CSV file.

  • Column names must be between 1 and 128 characters in length.

  • Column names can only contain letters, digits, the underscore character and spaces, and must not start with an underscore.

  • Column names cannot be any of the following reserved keywords:

    all, and, any, array, as, at, between, both, by, call, case, cast, check, coalesce, constraint, convert, corresponding, create, cross, cube, default, distinct, do, drop, else, every, except, exists, fetch, for, foreign, from, full, grant, group, grouping, having, in, inner, intersect, into, is, join, leading, left, like, natural, not, nullif, on, or, order, outer, primary, references, right, rollup, select, set, some, sum, table, then, to, trailing, trigger, union, unique, using, values, when, where, with

Also notice that column names will be lowered case.

Column types

Before saving the data source (or when editing it), you are able to amend the column data types. You will find a
setting icon below the column name and, when clicking on it, you will be able to select the correct type for the column, as shown in the following figure.

The default data type is STRING, however you can pick any of the following types:

Data source type
BOOLEAN
DECIMAL
INTEGER
STRING
DATE
TIME (time zoned)
TIME (not time zoned)
DATETIME (time zoned)
DATETIME (not time zoned)

Example

username (STRING)age (INTEGER)first_name (STRING)height (DECIMAL)email (STRING)dob (DATETIME, time zoned)premium (BOOLEAN)
admin64Bob1.8bob@example.com1962-12-31T16:50:31+05:00true
bill27Bill1.92bill@example.com1997-05-24T19:18:12Zfalse
jill15Jill1.70jill@example.com2009-11-07T04:34:01+01:00[Europe/Paris]false
jane74Jane1.81jane@example.com1952-01-13T10:10:10-12:00true

Date type

For DATE, TIME and DATETIME types, you can specify your own format string using the elements in the following table:

LetterDate or Time ComponentPresentationExamples
GEra designatorTextAD
yYearYear1996; 96
YWeek yearYear2009; 09
MMonth in yearMonthJuly; Jul; 07
wWeek in yearNumber27
WWeek in monthNumber2
DDay in yearNumber189
dDay in monthNumber10
FDay of week in monthNumber2
EDay name in weekTextTuesday; Tue
uDay number of week (1 = Monday, …, 7 = Sunday)Number1
aAm/pm markerTextPM
HHour in day (0-23)Number0
kHour in day (1-24)Number24
KHour in am/pm (0-11)Number0
hHour in am/pm (1-12)Number12
mMinute in hourNumber30
sSecond in minuteNumber55
SMillisecondNumber978
zTime zoneGeneral time zonePacific Standard Time; PST; GMT-08:00
ZTime zoneRFC 822 time zone-0800
XTime zoneISO 8601 time zone-08; -0800; -08:00