Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

The data loader can be extended with data loader plugins. Those plugins are used to create custom data connectors, to sources that are not yet included in Squirro.

Squirro also distributes some connectors as data loader plugins for maximum flexibility. Please see the section /wiki/spaces/DOWN/pages/54624262 in the downloads section (license required).

Table of Contents

Table of Contents
outlinetrue

Introduction

Data loader plugins are created as a Python class (see the DataSource Class reference for how exactly).

That plugin is then loaded into the data loader using the --script-file parameter. For example:

Code Block
squirro_data_load ^
    -v ^
    --cluster %CLUSTER% ^
    --project-id %PROJECT_ID% ^
    --token %TOKEN% ^
    --source-script medline.py ^
    --map-id PMID ^
    --map-title TI

Tutorial

The Data Loader Tutorial section Custom Data Source shows how to create a custom data loader plugin.

Class Reference

See the DataSource Class.

Custom Packages

Data loader plugins sometimes need custom Python packages. These can be provided in the pkg folder, relative to where the data loader is invoked.

The recommendation is to include a requirements.txt file in the folder where the data loader plugin is located. That file lists all the required packages, with one package dependency per line. For example:

Code Block
languagetext
titlerequirements.txt
dateutils
requests

To download these packages into the pkg folder, execute the following command (the pkg folder must exist before calling this command):

Code Block
pip install -r requirements.txt --root pkg

Earlier data loaders need the following download command instead. Unfortunately that may not work in all cases, specifically if files of the type .whl are downloaded. Please contact support, if you encounter any issues in this regard.

...

This page can now be found atData Loader Plugins on the Squirro Docs site.