> For the complete documentation index, see [llms.txt](https://docs.ovaledge.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ovaledge.com/release8.2/file-manager/file-explorer.md).

# File Explorer

This article provides a step-by-step guide to the File Explorer of File Manager, which allows Authors to manage, organize, and analyze files and folders across various data lake systems, such as HDFS, S3, NFS, and more.

**Getting Started**

* **Connect to Data Lakes:** Use connectors or upload tools to add data lakes like S3, HDFS, Google Drive, NFS, and more.
* **Catalog Data Lakes:** Cataloging allows viewing files and folders within the Data Catalog (optional for some levels).
* **Explore Files and Folders:** The File Explorer displays detailed information about files and folders within a data lake connection.

**Key Features**

* **Manage Files and Folders:** Upload, download, delete, and organize files and folders within data lakes for NFS Connection.
* **Cataloging:** Categorize files and folders for better visibility and data profiling.
* **Supported File Formats:** Upload and manage various file formats, such as CSV, JSON, Parquet, and more.  Configure allowed upload formats as needed.
* **Data Lake OvalSight:** Provides a high-level overview of a data lake's structure, size, and file distribution.
* **Folder OvalSight:** Analyze folder contents, including file types, sizes, and overall structure. Accessible from the File Manager or Data Catalog.
* **List View:** Navigate data folders and subfolders visually and access detailed Folder Analysis information.
* **Data Lake Search:** Search for files and folders across an entire data lake connection using keywords.
* **System Settings:** Administrators and Authors can set the maximum upload file size, define allowed file types for cataloging, and control the number of file entries shown per page.

## Catalog Data Lakes

Catalog data lakes before using File Explorer is essential. This allows Authors to view all files and folders within the lake. Various methods for adding data:

* **Connectors:** OvalEdge integrates with data lake systems like Hadoop, Amazon S3, Google Drive, and more. These connectors are available on the "Connectors" page.
* **Upload Tools:** Authors can also upload files and folders directly using the "Upload File" or "Upload Folder" tools for NFS Connection.

### Crawl with Connectors

1. **Navigate:** Authors navigate to Administration > Crawler.
2. **Add Connection:** Select the file system (NFS/S3/HDFS/Azure/Drive) and enter the database name.
3. **Provide Credentials:** Enter and validate connection details in the "Manage Connection" window. Save.
4. **Crawl Data:** Click "Crawl/Profile" to initiate the process. Upon successful completion, folders and files will appear in the File Explorer.

{% hint style="info" %}

* File Explorer shows all connected files and folders.
* The Data Catalog displays only first-level folders and files.
* Authors must manually catalog additional levels from File Explorer.
  {% endhint %}

**Example:**

* In S3, "Hospital" (Level 1) gets automatically cataloged (visible in Data Catalog).
* To view them, manually catalog "Departments" (Level 2) or "General Medicine" (Level 3) from the File Explorer.

### Upload Files via NFS

Authors can upload files and folders directly to an NFS data lake connection from File Explorer. Uploaded content is cataloged and made available for governance, discovery, and analysis activities.

#### Access the Upload Option

1. In **File Explorer**, select the required NFS data lake connection.
2. Click the **9-Dots** icon.
3. Select **Upload**. The upload page is displayed, allowing users to upload either individual files or entire folders.

#### Upload a File or Folder

1. On the upload page, select one of the following options:
   1. File to upload a single file.
   2. Folder to upload an entire folder and its contents.
2. Click on the “**Select from your computer**” link and browse to the required file or folder on the local system.
3. Select the file or folder to upload.
4. Verify the selected item.
5. Click **Upload** to start the upload process. The system displays the upload progress while the selected content is transferred to the NFS location.

#### Create and Select a Directory (Optional)

If the target directory does not exist, users can create a new directory before uploading content.

1. Select the **Select Your Directory** tab.
2. Click the **9-Dots** icon.
3. Select **Create Directory**.
4. Enter the directory name.
5. Save the directory.
6. Select the newly created directory from the available list.
7. Click **Next**. The **Upload File or Folder** tab is displayed.
8. Select **File** or **Folder**. Click on the “**Select from your computer”** link and browse to the required file or folder on the local system.
9. Click **Upload** to begin the upload process. The uploaded content is stored in the selected directory.

#### Verify the Upload

After the upload completes, users can verify that the file or folder is available in the selected NFS location.

* Successfully uploaded files or folders are highlighted in green.
* Users can review the uploaded content to confirm that all required files are present.
* Click **Finish** to complete the upload process and return to File Explorer.

#### Upload Size Limitation

The maximum file size allowed for upload is controlled by the ovaledge.filesize.limit system setting.

* Supported range: **1 MB** to **100 MB**
* Default value: **5 MB**

Users with administrator privileges can modify this setting in System Settings to accommodate organizational requirements for file uploads.

### Supported File Formats for Upload

File Explorer supports specific file types for upload. Administrators can configure the allowed file types using the **config.file.types.to.be.cataloged** setting in **System Settings** > **OTHERS**.

The supported file formats are grouped as follows:

#### Structured Data Files

These file formats store structured data that can be analyzed, cataloged, and processed.

* **CSV (.csv)** – Stores tabular data in plain text format, with values separated by commas.
* **JSON (.json)** – Stores structured data using key-value pairs and hierarchical objects.
* **Parquet (.parquet)** – A columnar storage format optimized for analytics and large-scale data processing.
* **ORC (.orc)** – A columnar storage format commonly used in Hadoop and big data environments.
* **XLSX (.xlsx)** – Microsoft Excel Open XML spreadsheet format.
* **XLS (.xls)** – Microsoft Excel spreadsheet format used in earlier versions of Microsoft Office.

#### Database Scripts and Query Files

These file formats contain database definitions, queries, and data-processing logic.

* **SQL (.sql)** – Contains Structured Query Language statements for data definition and manipulation.
* **DDL (.ddl)** – Contains database schema definitions such as CREATE, ALTER, and DROP statements.
* **HQL (.hql)** – Contains Apache Hive queries used for querying and managing data in Hive environments.

#### Configuration Files

These file formats store application settings, environment variables, and configuration parameters.

* **CONF (.conf)** – General configuration file used by applications and services.
* **ENV (.env)** – Stores environment variables and runtime configuration values.
* **Properties (.properties)** – Stores application settings as key-value pairs.
* **YAML (.yaml)** – Human-readable configuration and data serialization format.

#### Scripts and Source Code Files

These file formats contain executable scripts or source code.

* **SH (.sh)** – Shell script used to automate tasks in Linux and Unix environments.
* **PY (.py)** – Python source code file used for scripting and application development.

#### Document Files

These file formats contain textual content and documentation.

* **TXT (.txt)** – Plain text file without formatting.
* **PDF (.pdf)** – Portable Document Format file that preserves document formatting across platforms.

#### Image Files

These file formats store graphical content and images.

* **JPG (.jpg, .jpeg)** – JPEG image format commonly used for photographs and compressed images.
* **PNG (.png)** – Image format that supports lossless compression and transparent backgrounds.

#### Supported File Formats for Profiling

After upload and cataloging, File Explorer supports profiling for the following structured data formats:

* CSV (.csv)
* JSON (.json)
* Parquet (.parquet)
* ORC (.orc)
* XLSX (.xlsx)
* XLS (.xls)

***

Copyright © 2026, OvalEdge LLC, Peachtree Corners, GA USA


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ovaledge.com/release8.2/file-manager/file-explorer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
