Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel2
typeflat

Users with the necessary permissions can upload CSV files to create lookup tables. To upload them, you need to do it in the Lookup Management tab of the Data Search area.

What permissions do I need?

To access this area, you need to have at least view permissions on Lookups. However, you will not be able to upload files to create lookups unless you have the management version of that very same permission.

What type of data can I use?

When creating a new upload lookup, the CSV file you intend to upload may contain data in the formats listed below. Data in other formats will not be recognized and thus not offered as an option to choose in the lookup creation window. Visit Data types in Devo for examples on each data type format.

Name

Data type

Name

Data type

Alphanumeric value

String

Hexadecimal number

Hex4

Integer number

Int4

Long hexadecimal number

Hex8

Long integer number

Int8


IPv4 address


IP4

Floating point number

Float4

Info

Data type translations

As a result of standardization procedures, some of these data types are translated when the lookup in created. Hexadecimal, for example, will be shown as Int.

Creating the new upload lookup

Suppose you have the CSV file below containing printers' information and their corresponding IPs and addresses, which we want to use to create a lookup table to later use for data enrichment. If you want to upload the file as a lookup:

Expand
titleClick here for the CSV file of the example

View file
nameUpload a lookup table.csv

Rw ui steps macro
Rw step

In the Data Search → Lookup Management area, click New Lookup at the top right.

Rw step

Enter a name for the lookup, such as IP_list, and drag the file onto the field (or click Browse and select the CSV file).

Rw step

Check the Contains headers box to specify that the first row must not be considered as values and thus must be skipped when parsed.

Rw step

Give each field the desired name and format, and then choose the desired key field by marking the Is key option at the end of its row.

Info

Repeated values in the key field

The field selected as key upon the lookup definition should not contain repeated values. If so, only the last value in the file will be kept, and the rest of the events with that value repeated will be discarded.

In the example below, if you select user as key field, only the second event for Mike will be considered.

User, Count;

Mike, 23; Lisa, 423; Mike, 54; Lara, 21

Rw step

Click Create Lookup. You will receive a notification when the file is uploaded. Note this may take a few minutes.

Now you can add fields from your lookup to a query in order to enrich it with additional information. See Add lookup values to your query to learn how to do it.

Finding your uploaded lookup

Once uploaded, you can find the lookup in:

  • Data Search → Lookup Management. Here you can manage and edit lookup tables (visit this article to know more). The lookup table will be ready when the indicator in the Status field turns green.

  • Data Search → Explore Your Data. Select the tags in the finder my.lookuplist.<lookupname> to open lookups as data tables and apply operations as you would do with any other data table.