Terminologie

Export

S výrazem "export" se můžete setkat v různých kontextech.

Exportovaný soubor: Především, "export" je data vyextrahovaná ze zdroje dat (typicky databáze). Říkejme mu "exportovaný soubor".
Export v uživatelském rozhraní: Export v LogMan.io Web Application je záznam informující o stavu exportu a poskytuje dodatečné informace. Nabízí také rozhraní pro stažení obsahu - "exportovaný soubor".
Deklarace exportu: Export v kontextu knihovny (YAML soubory v sekci Exports knihovny) je "deklarace exportu" - plán říkající, jak vytvořit nový export.
Exportní objekt: A v neposlední řadě je "Export" objekt v aplikaci BS-Query a jeho reprezentace na disku. BS-Query Exportní objekt ukládá minimální informace v paměti. Místo toho slouží jako spojení k datovému úložišti.

Datové úložiště

Datové úložiště je organizováno následovně:

.
└── data
    └── <export_id>.exp
        ├── content
        │   └── <export_id>.json
        ├── declaration.yaml
        └── export.json
        └── schedule.json

Adresář content ukládá exportovaná data. Tento adresář může obsahovat žádný nebo pouze jeden soubor.
Soubor declaration.yaml ukládá všechny proměnné potřebné pro tento export. Kompletní strukturu deklarace najdete v této kapitole.

Soubor export.json ukládá metadata tohoto konkrétního exportu. Mohl by vypadat takto:

{"state": "finished", "_c": 1692975120.0054746, "_m": 1692975120.0054772, "export_size": 181610228, "_f": 1692975170.0347197}

Soubor schedule.json je zde pouze pro naplánované exporty. Ukládá časové razítko dalšího spuštění.

Zdroj dat

Se "zdrojem dat" nebo i "datasource" se můžete setkat v různých kontextech.

Zdroj dat: Zdroj dat. Toto je originální databáze nebo jiná technologie, ze které extrahujeme data.
Deklarace zdroje dat: Toto je YAML soubor v sekci DataSources knihovny. Je to plán/příručka specifikující připojení k externímu zdroji dat.
Objekt datasource: Objekt v aplikaci BS-Query zodpovědný za připojení ke zdroji dat/databázi a extrakci dat.

Deklarace

Deklarace je manuál nebo plán pro systém, který předepisuje, jak vykonat. Deklarace exportu jednoduše předepisuje, co by mělo být v výsledném exportovaném souboru. Tyto deklarace najdete ve formátu YAML v knihovně. Naučte se, jak číst nebo psát export a deklarace zdrojů dat v této kapitole.