Berichte synchron ausführen

Was ist ein synchroner Bericht?

Ein synchroner Bericht ist ein kleiner Bericht, der sehr schnell ausgeführt werden muss. Wenn die DCM-Berichtsplattform eine Anfrage zum Ausführen eines synchronen Berichts erhält, wird die Ausführung sofort gestartet. Solche Berichte eignen sich am besten für Situationen, in denen Sie schnell einen kleinen Datensatz benötigen, z. B. wenn Sie Messwerte in einer grafischen Benutzeroberfläche anzeigen.

Was ist der Unterschied zwischen synchroner und asynchroner Berichtserstellung?

Die asynchrone Ausführung eines Berichts dauert immer mindestens einige Minuten, auch wenn Sie nur eine kleine Datenmenge anfordern. Synchrone Berichte liefern diese Daten viel schneller, allerdings mit einem kurzen Timeout für die Ausführungsdauer. Sie sollten die asynchrone Berichtserstellung verwenden, wenn der Bericht nicht innerhalb des synchronen Timeout-Zeitraums ausgeführt werden kann oder wenn Sie sich nicht in einer zeitkritischen Umgebung wie einer Benutzeroberfläche befinden.

Was ist der Timeout-Zeitraum für synchrone Berichte?

Wenn der Bericht klein genug ist, um in maximal 10 Sekunden ausgeführt zu werden, gibt das System eine vollständige Berichtsdatei für Ihre ursprüngliche Ausführungsanfrage zurück. Andernfalls wird der Bericht in DCM-Berichten 50 Sekunden lang ausgeführt, bevor ein Timeout auftritt.

Was passiert, wenn die Ausführung eines synchronen Berichts zu lange dauert?

Wenn die Erstellung eines synchronen Berichts nicht innerhalb des Timeout-Zeitraums abgeschlossen wird, wird sie angehalten und der Bericht wird in unsere asynchrone Berichtswarteschlange verschoben. Der Bericht schlägt nicht fehl und gibt keinen Fehler zurück. Wenn er jedoch in die asynchrone Berichtswarteschlange verschoben wird, dauert die Erstellung mindestens einige Minuten.

Sie erhalten keine Benachrichtigung, dass der Timeout-Zeitraum für die synchrone Berichtserstellung überschritten wurde. Die einzige Ausnahme ist die Erstellungszeit des Berichts. Die Erstellung wird entweder innerhalb von 50 Sekunden abgeschlossen oder sie wird asynchron und dauert mehrere Minuten.

Welche Berichtstypen unterstützen die synchrone Ausführung?

Alle Berichtstypen unterstützen die synchrone Ausführung, mit Ausnahme der folgenden:

Die anderen Berichtstypen unterstützen alle die synchrone Ausführung, aber es tritt trotzdem ein Timeout auf, wenn zu viele Daten oder eine ressourcenintensive Kombination aus Messwerten und Dimensionen verwendet werden.

Wie führe ich einen synchronen Bericht aus?

Standardmäßig werden alle Berichte asynchron ausgeführt. Wenn Sie die Erstellung einer neuen Berichtsdatei anfordern, können Sie den optionalen synchronous Parameter auf true setzen, um die synchrone Ausführung des Berichts anzufordern. Beispielcode finden Sie in unserer Dokumentation.

Sollte ich alle meine Berichte mit synchroner Ausführung anfordern?

Nein, Sie sollten die synchrone Ausführung nur anfordern, wenn Sie davon ausgehen, dass der Bericht innerhalb des Timeout-Zeitraums fertig ist. Wenn die Ausführung Ihres Berichts synchron gestartet wird und das Timeout-Limit erreicht wird, wird der Bericht in die asynchrone Warteschlange verschoben. Die Gesamtausführungszeit des Berichts entspricht der Zeit, die für die asynchrone Erstellung des Berichts erforderlich ist, zuzüglich des synchronen Timeout-Zeitraums. Wenn Sie den Bericht asynchron angefordert hätten, wäre die zusätzliche Verzögerung durch den synchronen Timeout-Zeitraum vermieden worden.

Wirken sich die von mir angeforderten Messwerte und Dimensionen auf die Erstellungszeit meiner Berichte aus?

Ja. Bestimmte Messwerte und Dimensionen benötigen mehr Zeit für die Zusammenstellung als andere. Bei einigen kann es sogar dazu kommen, dass bei Ihren synchronen Berichten immer ein Timeout auftritt. Geografische Dimensionen sind ein Beispiel dafür. Sie sind selten oder nie schnell genug, um in synchrone Berichte aufgenommen zu werden.

Wie kann ich die Zeit verkürzen, die für die Erstellung meiner Berichte benötigt wird, um die synchrone Berichterstellung zu ermöglichen?

Viele Faktoren wirken sich auf die Geschwindigkeit aus, z. B. die Größe der enthaltenen Kampagnen und der Zeitraum, auf den sich der Bericht bezieht. Oft ist es am besten, die Berichte manuell so anzupassen, dass sie klein genug sind. Beginnen Sie mit allen Daten, die Sie schnell anzeigen möchten, und reduzieren Sie den Bericht dann so weit, bis er synchron abgeschlossen wird.