Skip to main content
Last updated on Jan 16, 2026

DataFuse AI Documentation - Frequently Asked Questions (FAQs)

1. Tenant, User & Group Management​

General FAQs​

  • Q1: What is a tenant in DataFuse AI?

    • A1: A tenant is a dedicated, isolated workspace for each organization in DataFuse AI, ensuring data privacy and security.

  • Q2: What is the role of the SuperAdmin?

    • A2: The SuperAdmin manages the tenant, including user creation, role assignments, system configurations, and data access control.

  • Q3: Can I modify user roles and permissions?

    • A3: Yes, users with SuperAdmin privileges can assign roles and permissions to other users via the User Management interface.
Learn More

For detailed information about tenant, user, and group management, visit Core Modules - Tenant, User & Groups.

User Profiles​

  • Q4: How can I edit my user profile?

    • A4: Go to the User Profile section, select the user profile you wish to edit, and modify the details as required.

  • Q5: Can I delete my user profile?

    • A5: User profiles can be deleted by SuperAdmins. If necessary, the SuperAdmin can deactivate or delete a user profile from the system.

Group Management​

  • Q6: What is the purpose of a group?

    • A6: Groups are used to manage and share access to data and system modules. Permissions can be set at the group level to control access.

  • Q7: How do I create a new group?

    • A7: SuperAdmins can create new groups from the Group Management section and assign specific users and roles to them.

2. Engine Management​

General Engine Management​

  • Q1: What is an engine in DataFuse AI?

    • A1: An engine is a computational unit responsible for executing queries and running pipelines. It connects to external data providers like Databricks and Livy.

  • Q2: How do I configure a new engine?

    • A2: To configure a new engine, go to the Engine Management section, select your desired engine provider, and enter the required credentials and settings.

  • Q3: Can I edit or delete an engine configuration?

    • A3: Yes, engines can be edited or deleted from the Engine Management section by selecting the engine you want to modify.
Learn More

For detailed information about engines and troubleshooting, visit Core Modules - Engine and Quick Start Guide - Setup Your First Engine.

Troubleshooting Engine Issues​

  • Q4: Why is my engine not responding?

    • A4: Check the engine’s connection settings, ensure the provider is active, and verify that the engine's computational resources are available.

  • Q5: How can I resolve an engine timeout or performance lag?

    • A5: Review the engine’s workload. If the engine is overloaded, reduce the number of concurrent tasks or optimize the pipelines to lower the computational demand.

3. Driver Management​

General Driver Management​

  • Q1: What is a driver in DataFuse AI?

    • A1: A driver enables DataFuse AI to connect to external data sources like relational databases or cloud storage services.

  • Q2: How can I add a new driver?

    • A2: To add a new driver, navigate to the Driver Management section, upload the appropriate driver file, and configure it for the necessary data source.

  • Q3: Can I update or remove a driver?

    • A3: Yes, drivers can be updated or removed from the Driver Management section by selecting the driver you want to modify.
Learn More

For detailed information about drivers, visit Core Modules - Driver and Quick Start Guide - Download Your First Driver.

4. Connection Profile Module​

Creating and Managing Connection Profiles​

  • Q1: What is a connection profile?

    • A1: A connection profile stores the details (credentials, IP, port) required to connect to a specific data source, such as a database or cloud storage.

  • Q2: How do I create a connection profile?

    • A2: Navigate to the Connection Profiles section, click "Add Profile," and provide the required connection details such as source type, credentials, and connection settings.

  • Q3: How can I test the connection before saving it?

    • A3: After entering the connection details, click the "Test Connection" button to verify that DataFuse AI can successfully connect to the data source.
Learn More

For detailed information about connection profiles, visit Core Modules - Connection Profile and Quick Start Guide - Create Your First Connection Profile.

Managing Profiles​

  • Q4: How can I delete a connection profile?

    • A4: To delete a profile, select the "Delete" option from the Actions dropdown next to the profile. Confirm the deletion if the profile is not in use.

  • Q5: Can I update my connection profile?

    • A5: Yes, you can edit an existing connection profile by selecting the "Edit" option from the Actions dropdown and making the necessary changes.

5. Query Module​

Running Queries​

  • Q1: How do I run a query in DataFuse AI?

    • A1: Navigate to the Query Module, write your SQL query in the editor, and click the "Run" button to execute the query.

  • Q2: How can I view the query results?

    • A2: Once a query is executed, the results will be displayed in the Results Panel below the SQL editor.
Learn More

For detailed information about queries, visit Core Modules - Query and Quick Start Guide - Run Your First Query.

Saving and Exporting Queries​

  • Q3: How can I save a query for future use?

    • A3: After running your query, click the "Save" button, provide a query name and description, and save it in your Saved Queries library.

  • Q4: How do I export query results?

    • A4: To export the results, click the "Export" button in the Results Panel and choose the desired format (e.g., CSV, Excel).

6. Pipeline Module​

Creating and Managing Pipelines​

  • Q1: How do I create a new pipeline?

    • A1: Navigate to the Pipeline Module, click "Add New Pipeline," and drag-and-drop components like sources, transformations, and sinks to design your pipeline.

  • Q2: Can I schedule a pipeline to run automatically?

    • A2: Yes, you can schedule pipelines using the Job Management Module, which allows you to define when the pipeline will run automatically based on cron expressions.
Learn More

For detailed information about pipelines, visit Core Modules - Pipeline and Quick Start Guide - Build Your First Pipeline.

Monitoring Pipelines​

  • Q3: How can I monitor the execution of a pipeline?

    • A3: The Pipeline Monitoring section shows real-time execution logs, task statuses, and results. You can also check the history of previous executions.

7. Job Management Module​

Job Creation and Execution​

  • Q1: How do I create a new job?

    • A1: Navigate to the Job Management Module, click "Create Job," and configure job details such as the pipeline to run and the schedule.

  • Q2: Can I manually trigger a job?

    • A2: Yes, you can manually trigger jobs by clicking the "Run" icon next to the job in the Job Management interface.
Learn More

For detailed information about jobs, visit Core Modules - Job and Quick Start Guide - Create Your First Job.

Job Monitoring​

  • Q3: How can I track the status of a job?

    • A3: Jobs that are in progress or have failed are highlighted in the Dashboard and the Job Management interface. You can view detailed logs for each job run.

  • Q4: What should I do if my job fails?

    • A4: Check the task logs to identify the issue. Review the pipeline configurations or any system resource limitations that may have caused the failure.

8. File Explorer Module​

File Management​

  • Q1: How do I upload files to the File Explorer?

    • A1: Click the "Create New" button in the File Explorer, select "Upload File," and choose a file (CSV, Excel, JSON) from your local machine.

  • Q2: Can I move or delete files in the File Explorer?

    • A2: Yes, you can move files between folders and delete them. Deleted files are moved to the Trash folder, where they can be restored or permanently deleted.
Learn More

For detailed information about file explorer, visit Core Modules - File Explorer.

Sharing and Permissions​

  • Q3: How can I share files with other users?

    • A3: Right-click on the file or folder you want to share, select "Share," and specify the user and permissions (read, write, or manage).

9. Dashboard Module​

System Monitoring​

  • Q1: What does the Dashboard show?

    • A1: The Dashboard provides an overview of system health, including the status of connection profiles, jobs, pipelines, and system resource usage (CPU, memory, disk space).

  • Q2: How do I track system resource usage?

    • A2: The Dashboard displays real-time data on CPU, memory, and disk usage, helping you monitor system performance.
Learn More

For detailed information about the dashboard, visit Core Modules - Dashboard.

Troubleshooting with Dashboard​

  • Q3: How do I address recurring pipeline failures?

    • A3: Use the Dashboard to identify pipelines that are failing repeatedly, then check their logs and job history for patterns that might indicate the cause.

  • Q4: How can I monitor recent activities?

    • A4: The "Recent Activities" section of the Dashboard shows a log of user actions, such as creating or editing queries, pipelines, and jobs.
Last updated on