Feature: TABLE_EXPORT

Conquery unterstützt jetzt TABLE_EXPORT Anfragen um Tabellen komplett für die maschinelle Weiterverarbeitung auszugeben.

Beschreibung

TABLE_EXPORT ist eine neue Anfrageart um die internen Tabellenspeicher komplett auszugeben. Die Nutzung dieser Anfragen ist nicht für User gedacht, sondern für Programme die die Ergebnisse maschinell verabeiten um zum Beispiel eine nutzerfreundliche Ansicht der Daten daraus zu erstellen.

TABLE_EXPORT Anfragen erfordern keine Änderungen an irgendwelchen Definitionsdateien

Um einen Export anzufordern muss eine Anfrage der folgenden Form gestellt werden:

{
	"type": "TABLE_EXPORT",
	"tables" : [{ //Liste der Tabellen/Konnektoren und der gewünschten dateColumn zur zeitlichen Einschränkung
		"id" : "${dataset}.number.number_connector",
		"dateColumn": "${dataset}.number.number_connector.datum"
	}, 
	{
		"id" : "${dataset}.number.number_connector2",
		"dateColumn": "${dataset}.number.number_connector2.datum"
	}],
	"dateRange" : { //gewünschter Zeitbereich, kann offen sein
		"min" : "2000-01-01",
		"max" : "2020-12-31"
	},
	//eine Anfrage die die exportierten Entitäten einschränkt
	//kann eine manuell erstellte Liste oder historische Anfrage sein
	"query": {} 
}

Das Ergebnis ist eine Tabelle mit einer Zeile für jedes Ereignis der gegebenen Tabellen, das den Filterkriterien entspricht. Die erste Spalte ist die übliche result Spalte, gefolgt von einer Spalte für jede Spalte der ausgewählten Tabellen. Eine Beispielausgabe findet man hier.

Frontend

Es gibt keine Veränderungen an der Frontend API.

Performance

Die Performance von TABLE_EXPORT Anfragen kann problematisch sein wenn die Anzahl der gewählten Tabellen groß ist, da jede Spalte jeder Tabelle in jeder zeile auftaucht. Deswegen ist es eine klare Empfehlung Client Software zu zu konmzipieren, dass sie pro Tabelle eine Anfrage stellt statt einer einzelnen Anfrage mit allen gewünschten Tabellen.