Parameter mit Metrikansichten verwenden

Mithilfe von Parametern können Sie Werte beim Abfragen in eine Metrikansicht übergeben. Verwenden Sie Parameter, um eine einzelne Metrikansichtsdefinition für verschiedene Eingaben wiederzuverwenden, z. B. einen Rabattsatz oder ein Datumsfenster. Verwenden Sie einen Parameter überall dort, wo ein konstanter SQL-Ausdruck gültig ist, z. B. in Filtern, Feld- und Kennzahlausdrücken, der Datenquelle und Joins. Übergeben Sie einen Wert als Argument, wenn Sie die Ansicht abfragen.

Parameter verringern die Duplizierung. Anstatt eine separate Metrikansicht für jede Variante beizubehalten, definieren Sie die Logik einmal und lassen jedem Aufrufer eigene Werte bereitstellen. Ein Parameter kann einen Standardwert enthalten, sodass Aufrufer, die kein Argument übergeben, auf den Standardwert zurückfallen.

Note

Die Materialisierung wird derzeit für Metrikansichten, die Parameter definieren, nicht unterstützt.

Anforderungen

Das Abfragen einer Metrikansicht, die Parameter definiert, erfordert eine Computeressource, die die Mindestversionsanforderungen erfüllt. Siehe Verfügbarkeit der Funktion „Metrikansicht“ für Mindestanforderungen an die Compute-Version.

Definieren von Parametern

Sie können Parameter im Katalog-Explorer-Editor mit geringem Code oder direkt in YAML definieren. Nachdem Sie einen Parameter erstellt haben, verweisen Sie auf ihn anhand des Namens an einer beliebigen Stelle, an der ein konstanter SQL-Ausdruck gültig ist, z. B. in Filtern, Feld- und Measureausdrücken, der Quelle und Verknüpfungen.

So fügen Sie einen Parameter im Low-Code-Editor hinzu:

  1. Klicken Sie in der Editorüberschrift auf "Parameter hinzufügen".
  2. Geben Sie einen Parameternamen ein, z. B start_date . oder offset_int.
  3. Geben Sie einen Standardwert und einen Datentyp ein.
  4. Klicke auf Speichern.

Der Parameter wird nach dem Erstellen in der Editorüberschrift angezeigt.

Um Parameter in YAML zu definieren, fügen Sie der Definition der Metrikansicht einen Block der obersten Ebene parameters hinzu. Die vollständige Feldreferenz und ein YAML-Beispiel finden Sie unter Parameters.

Eine Metrikansicht mit Parametern abfragen

Um eine Metrikansicht abzufragen, die Parameter definiert, rufen Sie die Metrikansicht als Tabellenwertfunktion auf und übergeben Parameter als Argumente. Sie können Argumente nach Name oder Position übergeben oder auslassen, um die Standardwerte zu verwenden.

Argumente per Namen übergeben

Um ein Argument nach Namen zu übergeben, verwenden Sie den =>-Operator. Im folgenden Beispiel wird ein Wert von discount an 0.15 übergeben:

SELECT product, MEASURE(discountedSales)
FROM catalog.schema.metric_view(discount => 0.15)
GROUP BY product;

Argumente nach Position übergeben

Um Argumente nach Position zu übergeben, listen Sie die Werte in der Reihenfolge auf, in der die Parameter definiert sind. Im folgenden Beispiel wird derselbe Wert von discount an 0.15 übergeben:

SELECT product, MEASURE(discountedSales)
FROM catalog.schema.metric_view(0.15)
GROUP BY product;

Verwenden von Standardparameterwerten

Wenn Sie beim Aufrufen der Metrikansicht die Standardparameterwerte verwenden möchten, lassen Sie Argumente aus. Die folgenden Abfragen sind gleichwertig und verwenden alle Standardwerte:

SELECT product, MEASURE(discountedSales) FROM catalog.schema.metric_view() GROUP BY product;
SELECT product, MEASURE(discountedSales) FROM catalog.schema.metric_view GROUP BY product;

Anzeigen der Parameter, die eine Metrikansicht definiert

Um die Parameter anzuzeigen, die eine Metrikansicht definiert, zeigen Sie die YAML-Definition an, die den parameters Block enthält. Siehe Definition und Metadaten der Metrikansicht anzeigen.

Weitere Ressourcen

  • Last updated on