Skip to main content

Pentaho+ documentation has moved!

The new product documentation portal is here. Check it out now at


Hitachi Vantara Lumada and Pentaho Documentation

Data Source Wizard

Before you can create Pentaho reports and analysis, the Pentaho Server needs to know where to find your data and how to connect to it, what data you want to use, how the data is structured, and what the data is like. The Data Source Wizard helps you define a data source that contains this information and guides you through the creation of your first relational or multidimensional data models for use in creating reports and analysis.

After you define a data source, you can make it available to people who create reports and analysis so they can simply pick the data source they want to use from a list and begin creating their reports or analysis. One data source can be used by any number of reports or analysis.

Before using the Data Source Wizard

The Data Source Wizard is intended for prototyping or as a starting point for Pentaho Analysis and Pentaho Metadata models used with Interactive Reports, Analyzer reports, and dashboards. As a best practice, re-create or edit these models with the Schema Workbench or Metadata Editor to ensure query performance and to leverage enhanced features when used in production environments.
CautionData sources created with the Data Source Wizard are not supported for use in a production environment.
Because of the following reasons, data sources created with the Data Source Wizard are not supported for use in a production environment:
  • Data sources created with the Data Source Wizard cannot be secured using Pentaho roles, as per the security configuration.
  • They are not optimized for performance.
  • They may not conform to design best practices.

Get started with the Data Source Wizard

When you configured your Pentaho Server, you defined the connection information, including where the data is stored and what protocol or driver to use to connect to it. Pentaho configuration shows you how to change or add connection information.

To create a data source, pick one of the connections that you have already defined, then use the wizard's interactive data modeling tool to select tables and columns to drag onto the model canvas. You can then use the Data Source Model Editor to refine the model further.

The Data Source Wizard guides you through setting up CSV files, as well as relational and multidimensional data models, as data sources for building interactive and analysis reports. The initial data models you create with this tool enable you to immediately see how your data looks in Interactive Reports and Analyzer. Your results appear in Interactive Reports and Analyzer as you change model structures, and add tables and columns.

When you want to add more security, localization, or advanced modifications to your model, export the initial model created with the Data Source Wizard, and import it into either the Pentaho Metadata Editor for relational data models or Pentaho Schema Workbench for multidimensional data models.

NoteRelational and multidimensional models that were edited in Metadata Editor and Schema Workbench can no longer be edited in the Data Source Model Editor.
Create New menu in the Pentaho User Console

If you are not logged in with permissions to create, edit, and delete data sources, you are limited to view-only permissions and do not see any icons associated with adding, editing, or deleting data sources.

Manage Data Sources dialog box

There are several ways to access the Data Source Wizard within the User Console, so you do not have to backtrack to create a data source.

If You Are InThen Follow These Steps
Home perspectiveClick Create New Data Source.
Home perspectiveClick Manage Data Sources and then New Data Source.
Home perspectiveClick Create New Analysis Report and then the New icon.
Home perspectiveClick Create New Interactive Report and then the New icon.
Opened perspectiveClick the New icon and then select Data Source Wizard.
Any perspective, from the menu barClick File New Data Source.
Any perspective, from the menu barClick File Manage Data Sources and then click New Data Source.
Dashboard pane, creating a chart or data tableClick the Add icon in the Select Data Source dialog box.
Data Source Wizard dialog box

After accessing the Data Source Wizard, you are ready to begin creating your first data source.

Choose a data source type

The Data Source Wizard supports several data source types for maximum flexibility. Each data source type is defined on where or how you store data. This table helps you decide which data source type is best for you.

Data source type decision table
Explore ConsiderationsChoose Options
CSV FilesSQL QueriesDatabase Table Data Sources

A file with data that is separated by commas or some other specified delimiter character.

You can save an Excel spreadsheet as a CSV file and use this file to stage a database table in the Pentaho Repository.

If the data in the CSV file changes, you have to upload the updated file through the Data Source Wizard again.

CSV files can be uploaded directly to the Pentaho Repository without a data connection.

This option creates a multidimensional model for Analyzer only and a relational model for Interactive Reports, Dashboard Designer, and Analyzer.

An SQL query written against a relational database defines the data you want to use in Interactive Reports or Analyzer.

You can customize how columns are presented to users who are building queries against the new data source; for example, you define column names and select options that indicate how data is aggregated (sum, min., max., etc.), and more.

This option creates a multidimensional model for Analyzer only and a relational model for Interactive Reports, Dashboard reports, and Analyzer.

Database Table data sources allow you to create relational database tables containing the data you want to use in Interactive Reports or Analyzer.

This data source type supports a broad range of use cases including relational reporting directly against an operational data store (ODS) or creating a data source for multidimensional analysis against a star schema.

ExpertiseKnowledge of basic database structures.Knowledge of basic database structures and SQL.Knowledge of relational and/or multidimensional database structures.
TimeApproximately 10 minutesApproximately 20 minutesApproximately 30 minutes to 1 hour
Best PracticesThis data source makes it easier to evaluate or create development prototypes.This data source type works well when you are evaluating or creating development prototypes.To use Database Table data sources for evaluating or creating development prototypes, limit the data in the tables to sample data that is representative of your production data.