• Introction
  • What is cliboa
  • Features
• Manual
• How to Contribute
• Quick Start
  • Install cliboa
  • Configuration of a Simple ETL Processing
  • Directory Tree
  • Install PyPI packages
  • Write a Scenario of ETL Processing
  • Set an environment
  • Execute a scenario of ETL Processing
• YAML Configuration
• Default ETL Modules
• How to Implement Additional ETL Modules

cliboa is an application framework which can implement ETL(ELT) pipeline. It eases the implementation of ETL(ELT) pipeline. In this case, ETL(ELT) pipeline means the processings like fetch, transform and transfer of data between various databases, storages, and other services.

• Python based framework.
• ETL(ELT) processing is executable by YAML based configuration.
• Additional modules for ETL(ELT) pipeline can be implemented by only a few steps if default modules not enough.

See MANUAL.md

See CONTRIBUTING.md

Available on macOS and any Linux distributions, like Debian, Ubuntu, CentOS, REL, or etc.

python version 3.7 or later and poetry are required. In the environemnt which pip can be used, execute as below.

sudo pip3 install poetry
sudo pip3 install cliboa

After installed cliboa, 'cliboadmin' can be used as an administrator command.

Create an executable environment of cliboa by using cliboadmin.

$ cd /usr/local
$ sudo cliboadmin init sample
$ cd sample
$ sudo cliboadmin create simple-etl

Directory tree which was created aforementioned commands is as below.

sample
├── pyproject.toml
├── bin
│   └── clibomanager.py
├── cliboa
│   └── conf
├── common
│   ├── __init__.py
│   ├── environment.py
│   └── scenario
├── conf
│   ├── cliboa.ini
│   └── logging.conf
├── logs
├── project
│   └── simple-etl
│       ├── scenario
│       └── scenario.yml

$ cd sample
$ poetry install

As a simple etl processing, write scenario.yml in simple-etl as below.

The following example is just download a gzip file from the local sftp server, decompress it, and upload it to the local sftp server.

See Examples

To make the above scenario available, set a local machine as a sftp server according to respective environments. Also, put "test.csv.gz" under /usr/local.

After wrote scenario.yml and set the environment, execute a scenario by as below command.

cd sample
poetry run python3 bin/clibomanager.py simple-etl

see yaml_configuration.md

see default_etl_modules.md

see additional_etl_modules.md