- Time required: 10 minutes
You must have ready:
- Your meltano project(s) and report(s) available on your local system.
Matatika has made a custom converter to turn Meltano reports into Matatika datasets. In this example, we shall go though all the steps needed to complete the conversion, so you can customise your datasets even further using the Matatika dataset format.
First open the terminal and navigate to the directory above the Meltano project you have chosen to convert reports for.
matatika-meltano-report-converterrepository, found at: https://github.com/Matatika/matatika-meltano-report-converter.
cdinto your meltano project.
- Run the command
meltano add --custom utility matatika-meltano-report-converter. You will then be prompted to fill in some details about the custom utility:
(namespace): Press Enter (empty = default value)
-e ../matatika-meltano-report-converteror your local directory of the cloned converter repo
(executable): Press Enter (empty = default value)
Meltano will then add and install the
matatika-meltano-report-converter. This may take up to 30 seconds.
Upon completion of the installation you can run the command
meltano invoke matatika-meltano-report-converter.
- Any meltano report you have saved in the default location
.meltano/analyze/reportswill be found and converted into Matatika dataset YAMLs. These new datasets can be found in a directory called
converted_meltano_reportsin the root of your Meltano project.
You can see what an example meltano project with converted datasets looks like on our github here: Example Meltano Project
Now you have your Matatika datasets, you can easily change, customize and publish them.