Continuous Integration Assert Validator

Der Assert-Validator für Continuous Integration (CI) 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 zeigt der Assert-Validator den Fehler an.

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

  • Der Umsatz im Mai des letzten Jahres sollte 204.259 $betragen.
  • Die Conversion-Rate sollte 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 ;;
  }
}

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

Auf der Seite mit den Ausführungsergebnissen zeigt der Assert-Validator die Ergebnisse für jeden Datentest an. 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

Beim Erstellen oder Bearbeiten einer Continuous Integration-Suite können Sie verschiedene Optionen angeben, um zu konfigurieren, wie der Assert-Validator ausgeführt wird. Die Optionen werden in den folgenden Abschnitten auf dieser Seite beschrieben:

Zu abfragende Explores

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

Datentests werden mit einem explore_source-Parameter definiert, der auf eine Explore in Ihrem Projekt verweist. Mit dem Feld Zu abfragende 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 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.

Ausgeschlossene Explores

Standardmäßig führt der Assert-Validator jeden Datentest in Ihrem LookML-Projekt aus. Mit dem Feld Ausgeschlossene Explores können Sie bestimmte Explores von der Assert-Validierung 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. Im Feld Nebenläufigkeit von Abfragen können Sie eine andere maximale Anzahl von Abfragen angeben, die der Assert-Validator gleichzeitig ausführen kann.

Der Maximalwert für das Feld Nebenläufigkeit von Abfragen ist auf die Einstellung Maximale Anzahl gleichzeitiger Abfragen für diese Verbindung in Ihrer Datenbankverbindung beschränkt.

Wenn Sie bei der Ausführung der Assert-Validierung eine Verlangsamung Ihrer Looker-Instanz feststellen, können Sie diesen Wert verringern.