https://wiki.folio.org/display/RPT/Build+a+directory+of+extracted+and+derived+tables
Type | Description |
---|---|
Extracted tables | Tables that LDP creates. |
Derived tables | Tables created by the community and located in the folio-analytics repository. |
Python 3 is required.
Install required modules through pip:
python -m pip install -r requirements.txt
/data
/csv
: Contains CSV files related to the different documentation processes:derived_tables_columns_doc.csv
: a file that can used to create additional data for each derived table for enrichment.RAMLdirectory.csv
: a listing of the URLs needed for the extracted table documentation.
/mermaid
: Here you can create text files for each derived table. In these text files you can type in mermaid syntax. The content is used to generate an er diagram in the output.
/docs
: Contains the output files that drive the public website./python
data_pipeline.py
: The main script for creating derived table documentation.extracted_table_docs.py
: The main script for creating extracted table documentation. It combines CSV data with public RAML files and generates public documentation of extracted tables.key_generator.py
: Script to create a KEY-FILE and an encrypted file with login credentials./pkg_output
: Contains local modules to create different outputs.
/sql
/derived_tables
: Contains the query for querying information about derived tables from the PostgresSQL database catalog.
- The Python script is written for Python 3 and tested for metadb.
- It can be necessary to install additional modules (see Dependencies).
- It assumes that derived tables exist in metadb.
1. Download the repository.
2. Database login credentials: You need login credentials for your database.
- The login credentials can be directly entered in the script
/python/data_pipeline.py
. - Optional: You can create an KEY-FILE to connect with the database with the script
/python/key_generator.py
. At first create a csv file with the namecredentials.csv
. In this file enter your login credentials. Schema: hostname,database,username,pwd,port_id . Save this file in the subdirectory/python
. After that run the script/python/key_generator.py
. The script creates a file with the nameenc_credentials.csv
and a file with the nameconfig.key
. Now you can delete the filecredentials.csv
. The login credentials are now encrypted in the fileenc_credentials.csv
and can only decrypted with the KEY-FILEconfig.key
.
3. Optional: Fill out the CSV file in the subdirectory /data/csv
. The data to be added to the data from the database is stored in the CSV file. In the CSV file, the "table" and "attributeName" columns must be filled out as they are stored in the database. A matching takes place later via these attributes. You can check the information beforehand using the SQL query in the /sql/derived_tables
subdirectory.
4. Optional: You can create a text file in the subdirectory /data/mermaid
if you would like create an er diagram for a derived table. Inside the text file you only have to enter the mermaid syntax. The text file name must match the name of the derived table.
You can run the program by using the file /python/data_pipeline.py
.
The generated output files with the documentation have been created in the /Output
directory.