Continuous Integration Assert Validator

Der CI-Assert-Validator führt die LookML-Datentests aus, die von Looker-Entwicklern in Ihrem LookML-Projekt erstellt wurden, und zeigt die Ergebnisse für jeden Datentest an. Bei fehlgeschlagenen Datentests wird der Fehler im Assert Validator angezeigt.

Mit LookML-Datentests können Sie die Logik Ihres Looker-Modells validieren. Mit Datentests lassen sich komplexe Annahmen testen, z. B.:

  • Der Umsatz im Mai des letzten Jahres sollte 204.259 $betragen.
  • Die Conversion-Rate muss größer als null sein.
  • Der Bestellstatus darf nicht null sein.

Ein LookML-Datentest besteht aus einer kleinen explore_source-Abfrage und einem yesno-Assert-Ausdruck, wie im folgenden Beispiel:

test: historic_revenue_is_accurate {
  explore_source: orders {
    column: total_revenue { field: orders.total_revenue }
    filters: [orders.created_date: "2024"]
  }
  assert: revenue_is_expected_value {
    expression: ${orders.total_revenue} = 626000 ;;
  }
}

Details zu den Optionen, die Sie beim Erstellen oder Bearbeiten einer CI-Suite konfigurieren können, finden Sie auf dieser Seite im Abschnitt Assert Validator-Optionen. Informationen zum Ausführen des Assert-Validators finden Sie auf der Dokumentationsseite Continuous Integration-Suites ausführen.

Auf der Seite mit den Ausführungsergebnissen werden mit dem Assert Validator die Ergebnisse für jeden Datentest angezeigt. Bei fehlgeschlagenen Datentests zeigt der Assert-Validator den oder die Fehler so an:

Ergebnisseite für Continuous Integration mit Ergebnissen des Assert-Validators

Optionen für den Assert-Validator

Wenn Sie eine Suite für die kontinuierliche Integration erstellen oder bearbeiten, können Sie verschiedene Optionen angeben, um zu konfigurieren, wie der Assert Validator ausgeführt wird. Die Optionen werden in den folgenden Abschnitten dieser Seite beschrieben:

Abzufragende Explores

Standardmäßig führt der Assert Validator jeden Datentest in Ihrem LookML-Projekt aus.

Datentests werden mit dem Parameter explore_source definiert, der auf ein Explore in Ihrem Projekt verweist. Mit dem Feld Explores to query (Abzufragende Explores) können Sie die Assert-Validierung auf bestimmte Explores beschränken, auf denen Ihre Datentests basieren.

Sie können Explores im folgenden Format angeben: model_name/explore_name

Wenn Sie beispielsweise die Explores mit den Namen users und orders in der Datei thelook.model.lkml angeben möchten, geben Sie Folgendes ein: thelook/users, thelook/orders

Weitere Informationen und Beispiele zum Angeben von Explores und Modellen in diesem Feld finden Sie auf der Dokumentationsseite SQL-Validator.

Auszuschließende Explores

Standardmäßig führt der Assert Validator jeden Datentest in Ihrem LookML-Projekt aus. Mit dem Feld Explores to exclude (Auszuschließende Explores) können Sie bestimmte Explores ausschließen, auf denen Ihre Datentests basieren. Der Assert Validator führt keine Datentests aus, die auf diesen ausgeschlossenen Explores basieren.

Sie können Explores im folgenden Format angeben: model_name/explore_name

Weitere Informationen und Beispiele zum Angeben von Explores und Modellen in diesem Feld finden Sie auf der Dokumentationsseite SQL-Validator.

Nebenläufigkeit von Abfragen

Standardmäßig führt der Assert Validator nicht mehr als 10 Abfragen gleichzeitig aus, um Ihre Looker-Instanz nicht zu überlasten. Mit dem Feld Nebenläufigkeit von Abfragen können Sie eine andere maximale Anzahl von Abfragen angeben, die vom Assert-Validator gleichzeitig ausgeführt werden können.

Der Maximalwert für das Feld Nebenläufigkeit von Abfragen ist auf die Einstellung Maximale Anzahl gleichzeitiger Abfragen für diese Verbindung für Ihre Datenbankverbindung begrenzt.

Wenn Sie feststellen, dass Ihre Looker-Instanz während der Ausführung der Assert-Validierung langsamer wird, können Sie diesen Wert verringern.