Continuous Integration Assert Validator

Der CI-Assert-Validator (Continuous Integration) 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 können komplexe Annahmen getestet werden, z. B.:

  • Der Umsatz im Mai des Vorjahres 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-Behauptungsausdruck, 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 Assert Validator-Optionen 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 Suites für die kontinuierliche Integration ausführen.

Auf der Seite Ausführungsergebnisse zeigt der Assert-Validator die Ergebnisse für jeden Datentest an. Bei fehlgeschlagenen Datentests zeigt der Assert-Validator die Fehler folgendermaßen an:

Ergebnisseite der kontinuierlichen Integration mit Ergebnissen des Assert-Validators

Optionen für Assert-Validator

Wenn Sie eine Continuous Integration-Suite erstellen oder bearbeiten, können Sie verschiedene Optionen angeben, um die Ausführung von Assert Validator zu konfigurieren. Die Optionen werden in den folgenden Abschnitten dieser Seite beschrieben:

Explores, die abgefragt werden sollen

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

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

Sie können explorative Datenanalysen 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 Festlegen 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 Auszuschließende Explores können Sie bestimmte Explores, auf denen Ihre Datentests basieren, von der Validierung ausschließen. Der Assert-Validator führt keine Datentests aus, die auf diesen ausgeschlossenen Explores basieren.

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

Weitere Informationen und Beispiele zum Festlegen 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 zehn Abfragen gleichzeitig aus, um eine Überlastung Ihrer Looker-Instanz zu vermeiden. Mit dem Feld Abfrage-Parallelität können Sie eine andere maximale Anzahl von Abfragen angeben, die der Assert-Validator gleichzeitig ausführen kann.

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

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