Document toolboxDocument toolbox

Manage and edit lookup tables

You can manage your lookup tables in Data Search → Lookup Management. 

  • The Status column indicates the current status of your lookup tables. If the indicator is green, it means the lookup is ready to be used. If it is yellow, it means the lookup has been modified and will be ready soon. If it is red, it means the lookup table has some errors.
  • The Type column shows the following depending on the lookup type: UploadStatic Query or Dynamic Query.

Click the ellipsis icon to the right of any lookup table row to access the following options:

Lookup Summary

This offers a quick view of the table's column names, value types, and key column.

Download CSV

Download the lookup table as a CSV file.

Edit Lookup

Edit the content of the selected upload lookup table. You can add new rows or modify the already existing data. Click Save Changes once you finish. Note that this option is only available for lookup tables up to 100MB. In the case of static query lookups, you are taken to the query window, where you can edit the columns and time range of the lookup. Dynamic query lookups cannot be edited.

See the below section to learn more and read this article for guidance on how to edit a query lookup.

Upload a New Version

Upload an updated version of the selected lookup table. Click Choose file, select the file including the updated version and click Upload. This option is only available for uploaded lookups.

Restrictions

This opens the Restrictions to tables screen. Select the required lookup table in the left area and use the toggle buttons to enable or disable them in the different data tables. By default, lookup tables are available for all data tables. To restrict a lookup for use with only a subset of the available data tables, select the lookup on the left, then on the right use the toggles to select the tables in the subset. Click the back button once you're done.

Delete

Delete the lookup table.

Note that if the lookup's status is orange you then you will see the option to refresh when clicking on the ellipsis icon.

Edit an uploaded lookup table

Select Edit lookup to edit the content of the uploaded file. You can perform the following actions:

  • Add new rows to the lookup. You can add several rows at the same time in CSV format, or add individual rows by entering the values of the cells.
  • Select a cell in the table to edit its content.
  • Check a row and select the trash bin icon to delete it.
  • Use the filtering buttons above the table to display only the columns needed.

    AllDisplay all the lookup table rows. Here is where you can add, edit and delete rows.
    ModifiedShow only modified rows. To reset edited columns, select them and click the Restore Rows icon.
    CreatedShow only newly created rows.
    DeletedShow only deleted rows. To restore rows, select them and click the Restore Rows icon.

After performing the required modifications, click Save changes. You can also restore the original lookup version selecting Reset changes.

Edit a static query lookup table

You can edit the query used to feed a static lookup table following these steps:

  1. Go to Data Search → Lookup Management.
  2. Open the ellipsis menu of the required query lookup and click Edit. You will be taken to the query window, which shows the query you used to feed the dynamic lookup.
  3. Perform the necessary query operations to get the new required one.
  4. Now click the gear icon in the query toolbar and select Set query change in lookup.

  5. Make the necessary changes in the Edit Query Lookup window (add or remove columns, or change the key column). You can also set a new query period using the search window toolbar time controls, then clicking Apply Interval.
  6. Click Save settings. The static query lookup is now updated.

It may take several minutes to apply the changes. Go to Data Search → Lookup Management and check the Status column of the dynamic lookup. Changes will be applied once the indicator turns green.

Note that dynamic query lookups cannot be edited.

To add values from a query lookup to a data table, follow the steps explained in Add lookup values to your query.