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_data_prep.py - prepareert een datalevering van een leverancier voor import.
• dido_import.py - importeert de geprepareerde 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_supplier.py - verwijdert 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. Zie snelstart hoe een DiDo projekt aan te maken.

Opties

Optie	Korte optie	Betekenis	Programma's
--project	-p	Geeft de projectfolder aan. Specificeer als een absoluut pad, bijv. /data//projekten/voorbeeld	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
--date YYY-MM-DD	-d	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	-s	naam van de leverancier waarmee iets moet gebeuren	dido_remove_delivery, dido_kill_supplier
--target	-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_supplier

Voorbeelden

Initialiseer een project directory:

python3.9 dido_init.py -p /data/gebruikersnaam/projekten/vervoer/shuttle

Genereer de tabellen en lees ze in met psql en gebruik hiervoor de ontwikkelserver (10.10.12.12). Voorts wordt aangenomen dat in die server de database vervoer bestaat.

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