Skip to content

Uploading files

You can easily upload your local files to visualize them. The main requirement is Elasticsearch v7.x. Refer to the File Uploads section for requirements and how to enable this feature.

When this feature is enabled you will see the File Upload icon next to your Elasticsearch data provider as shown below.


Let's walk through the file upload process which consists of two easy steps outlined below.

Step 1: Select your file

After selecting the File Upload icon shown above you should see the page below.


Either drag and drop a file to the Drag & Drop area or select the Browse link to browse through your files to select one.

After a small wait, you will see a summary of the contents of the file to be uploaded. See the example below.


Select the Import button located at the top right corner to continue with the Import step.

You can also override settings such as number of lines to sample, data format, delimiter, and others. To do this, select the Override settings button shown below.


With this function you can also change the field names of the imported source.

Step 2: Import your file

After selecting the Import button on the previous step you should see the page below.


Type the name in the input field provided and then select the Import button.

The import process starts and a message appears after the process is complete showing the index name created and the number of documents ingested.

At this point the data is ready and you can visualize it. Just select the Visualize data button to go back to your dashboard. Example shown below.


If an error occurs, the process stops and a notification shows at the top of the page as shown on the example below:


Accessing the generated Python script

Sometimes, you may want to customize your upload process by using your own Python script. Studio allows you to view and download a Python script that you can modify as needed to upload your data. To view the Python script, use the Preview py script button located below the Import button which becomes available right after you select the file to upload. Using function displays a code editor with the python script to create and populate the index. You can download this script and make all customizations needed. See the illustration bellow.


Managing your uploads

You can view all your imported files and remove the ones you don't need. To do this, select the Manage uploads button located on the top right corner of the page header. You will see a page as the example below:


You can sort the contents of the table by selecting its columns. Additionally, you can filter its contents by selecting the hamburger button on each column and typing a filter.

Finally, you can remove the imports you don't need by just selecting the trash icon and confirming the dialog.


Remember if you remove an index there is not a way to recover it, be careful deleting your data indices.