Allgemeine Konfiguration für alle Backends

Dieses Kapitel enthält die gemeinsamen Einstellungen für die Datenbanken PostgreSQL® und MS SQL®. Diese Liste von Werten sind Schlüssel-Wert-Paare für die Konfiguration dieser Einstellungen. Die Namen (Schlüssel) werden vom Backend im Backendprofil vordefiniert - siehe Konfiguration des Backendprofils. Die weiteren Kapitel sind datenbankspezifisch für die drei verschiedenen Datenbanken InfluxDB®, PostgreSQL® und MS SQL®.

Figure 1. "Datenbankspezifische Einstellungen" - PostgreSQL®

Logger für PostgreSQL® und MS SQL®

  • logger.level - die Stufe der Lognachrichten, die das Backend produzieren. Mögliche Werte sind: "trace", "debug", and "info", "warn" und "error". Der Defaultwert ist: "info".
  • logger.logProtobufMessages – Setzen Sie dieses Flag auf 1, um protobuf-Nachrichten vom/zum Frontend zu loggen. Der Defaultwert ist: 0.
  • logger.logToStdOut - Setzen Sie dieses Flag auf 1, um Parameter der DB-Abfragen zu loggen. Der Defaultwert ist: 0.
  • logger.logSql - Setzen Sie dieses Flag auf 1, um SQL-Nachrichten in die Datenbank zu loggen. Der Defaultwert ist: 0.
  • logger.logSqlBindedParameters - Setzen Sie dieses Flag auf 1, um Parameter der DB-Abfragen zu loggen. Der Defaultwert ist: 0

Backendkonfiguration für PostgreSQL® und MS SQL®

  • backend.readThreadsNumber - Größe der Threadpools für Lesethreads.

    Die Standardeinstellung ist die Anzahl der CPU-Kerne, die auf dem Computer verfügbar sind.. Das Backend teilt die Read Requests gemäß der Archivgruppen der angeforderten Elemente.

    Jede Anforderung für die vorgegebene Archivgruppe arbeitet in einem separaten Thread. Die Größe des Threadpools definiert die maximalen Threads, die gleichzeitig verwendet werden können, um Read Requests zu bearbeiten.

    Wenn ein Wert kleiner als eins angegeben wird, wird der Defaultwert verwendet.

    Für neue PostgreSQL®-Datenbanken, die über ein neues Projekt erstellt werden, wird der Eintrag max_parallel_workers in der Datei postgresql.conf auf die Anzahl der auf dem Computer laufenden Kerne gesetzt.

    Anschließend wird die Anzahl der Lesethreads im PostgreSQL®-Backend (backend.readThreadsNumber) an diese Zahl angepasst. Dies geschieht nur für das Standard-Backend _NGA_B_PostgreSQLBackend und wird weder für andere Backends noch für bestehende Projekte angepasst.

    Mit diesen Einstellungen wird die Performance für viele parallele Requests verbessert. Beispielsweise in Projekten mit vielen Datenpunktfunktionen.

  • backend.writeThreadsNumber - Größe der Threadpools für Schreibthreads.

    Der Defaultwert ist: 50. Wenn ein Wert kleiner als eins angegeben wird, wird der Defaultwert verwendet.

  • db.timeoutToConnect – Gibt den Zeitraum in Sekunden an, der für die Verbindung zur Datenbank zur Verfügung steht. Der Standardwert beträgt 5 Sekunden. Wenn der Verbindungsaufbau länger als diese Zeit dauert, gilt die Datenbank als nicht verfügbar und der Verbindungsversuch wird abgebrochen.
  • db.timeoutForQuery – Gibt an, wie viele Sekunden auf eine Antwort von der Datenbank gewartet wird, bevor die Abfrage mit einem Timeout-Fehler abgebrochen wird. Der Standardwert ist 0, was bedeutet, dass kein Zeitlimit besteht (unbegrenztes Warten).