DiDo programma's

[[TOC]]

DiDo programma's

DiDo kent de volgende programma's.

• dido_init.py - initialiseert een lege projekt folder en plaatst in de config folder een generieke config.yaml file.
• dido_create_tables.py - leest een schema file in en genereert de datadefinities voor de wiki en in SQL voor de database. Gebruik psql om de SQL uit te voeren.
• dido_import.py - prepreert en importeert de data en genereert datakwaliteitsdokumentatie en de SQL om de data in te lezen in de database. Gebruik psql om de data daadwerkelijk in de database in te lezen.
• dido_list.py - geeft een overzicht van de leveranciers en leveranties van het projekt.
• dido_remove_delivery.py - verwijdert een specifieke leverantie.
• dido_kill_project.py - verwijdert een projekt van een leverancier met al zijn tabellen uit de database. Is het tegenovergestelde van dido_create_tables.
• dido_compare.py - wordt gebruikt voor testdoeleinden, voor de gebruiker niet relevant.

Een DiDo programma wordt als volgt uitgevoerd:

python3.9 dido_create_tables.py --project \<projectfolder>

Elk programma kent een of meer opties. Hiermee kan de gebruiker een aantal zaken aan het programma meegeven of het verloop van de uitvoering veranderen.

Projekt folder

Alle acties van DiDo vinden plaats vanuit een projekt, in elk DiDo programma geef je die aan met -p/--project.

Opties

Optie	Korte optie	Betekenis	Programma's
--project <folder>	-p	Geeft de projectfolder aan. Specificeer als een absoluut pad, bijv. /data/<user>/projects/odl/leverancier/projekt	alle
--compare compare / dump	-c	- dump: er wordt een dump gemaakt van de database op een specifieke data (zie --date optie) - compare: vergelijkt de toestand van de database met een eerder gedumpte file	dido_compare
--delivery <filenaam>	-d	Naam van de delivery file die moet worden ingelezen	dido_import
--date YYYY-MM-DD		datum waarop een dump moet worden gemaakt of een table moet worden vergeleken	dido_compare
--reset	-r	Normaal wordt logging informatie aan de logfile toegevoegd. --reset wist eerst de bestaande logfile voordat deze beschreven wordt.	alle
--supplier <supplier name>	-s	naam van de leverancier waarmee iets moet gebeuren	dido_remove_delivery, dido_kill_project
--target <filename>	-t	Naam van de file waarin de dump plaatsvindt	dido_compare
--view	-v	Laat de tabel zien die vergeleken wordt met een eerdere dump	dido_compare
--yes	-y	Geef Ja op alle 'Weet u het zeker (Ja/nee)?' vragen. Nuttig voor shell scripts	dido_remove_delivery, dido_kill_project

Voorbeelden

Initialiseer een project directory:

python3.9 dido_init.py -p /data/gebruikersnaam/projekten/odl/leverancier/projekt

Genereer de tabellen en lees ze in met psql en gebruik hiervoor de ontwikkelserver (10.10.12.12).

python3.9 dido_create_tables.py --project /data/gebruikersnaam/projekten/odl/leverancier/projekt
psql -h 10.10.12.12 -U gebruikersnaam -f work/sql/create-tables.sql vervoer