sql_analytic_model_name (für Explores)

Auf dieser Seite wird auf den Parameter sql_analytic_model_name verwiesen, der Teil einer Exploration ist.

sql_analytic_model_name kann auch als Teil einer Ansicht verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter sql_analytic_model_name (für Ansichten) beschrieben.

Nutzung

explore: explore_name {
  sql_analytic_model_name: analytic_model_name ;;
}
Hierarchie
explore
sql_analytic_model_name
Standardwert
Keine

Akzeptiert
Name eines In-Database-Analysemodells

Besondere Regeln
  • Analytische Modelle werden nur für BigQuery- und Snowflake-Verbindungen unterstützt.
  • sql_analytic_model_name für Explores sollten nur verwendet werden, wenn dieselbe Ansicht mehrere Analysemodelle in Ihrer Datenbank beschreiben kann.
  • Das von sql_analytic_model_name referenzierte Analysemodell muss über die Datenbankverbindung des Modells zugänglich sein.
  • Wenn sich das Analysemodell in einer anderen Datenbank, einem anderen Schema, Projekt oder Dataset als dem Standardpfad befindet, den Sie in Ihrer Datenbankverbindung definiert haben, müssen Sie den Namen des Analysemodells eingrenzen.

Definition

Bei BigQuery- und Snowflake-Verbindungen wird mit dem Parameter sql_analytic_model_name der Name eines vorhandenen In-Database-Analysemodells (ein BigQuery-Diagramm oder eine semantische Ansicht in Snowflake) angegeben, das als Grundlage für einen LookML-Explore verwendet werden soll.

In den meisten Fällen verwenden Sie den Parameter sql_analytic_model_name (für Ansichten), um ein Analysemodell in Ihrer Ansichtsdatei anzugeben. Anschließend definieren Sie in dieser Ansichtsdatei LookML-Dimensionen und -Messwerte, die auf dem Analysemodell in Ihrer Datenbank basieren. Wenn Ihre Datenbank jedoch mehrere Analysemodelle enthält, die durch dieselben LookML-Felder definiert werden können, können Sie den Parameter sql_analytic_model_name unter einem explore-Parameter verwenden.

Wenn Sie einen sql_analytic_model_name unter einem explore-Parameter angeben, wird das im Explore angegebene Analysemodell durch das in der Ansichtsdatei angegebene Analysemodell überschrieben. Stattdessen wird das Analysemodell abgefragt, das Sie im sql_analytic_model_name unter dem explore-Parameter angegeben haben. In diesem Fall werden für das Explore die LookML-Measures und -Dimensionen verwendet, die in der Ansichtsdatei definiert sind. Sie werden jedoch auf das Analysemodell angewendet, das im Parameter sql_analytic_model_name des Parameters explore angegeben ist.

Namen von Analysemodellen eingrenzen

Wenn Sie mit dem Namen allein auf ein Analysemodell verweisen, verwendet Looker den Standardsuchpfad (die Datenbank und das Schema), den Ihr Looker-Administrator in den Einstellungen für die Datenbankverbindung konfiguriert hat.

Wenn Sie in einer anderen Datenbank und einem anderen Schema auf ein Analysemodell verweisen müssen, das sich nicht im Standardsuchpfad des Datenbanknutzers befindet, können Sie den Namen des Analysemodells mit dem Format <database_name>.<schema_name>.<analytic_model_name> eingrenzen, um auf eine andere Datenbank oder ein anderes Schema zu verweisen:

  • Wenn Sie in einem anderen Schema auf ein Analysemodell verweisen möchten, verwenden Sie <schema_name>.<analytic_model_name>.
  • Wenn Sie in einer anderen Datenbank auf ein Analysemodell verweisen möchten, verwenden Sie den vollständigen <database_name>.<schema_name>.<analytic_model_name>.

Bei einer Google BigQuery-Verbindung können Sie auf ein Analysemodell in einem anderen Projekt und Dataset verweisen, indem Sie den Namen des Analysemodells mit dem Format <project_name>.<dataset_name>.<analytic_model_name> eingrenzen. Weitere Informationen finden Sie auf der Dokumentationsseite Google BigQuery-Verbindung.

Beispiel

Hier ist ein Beispiel für eine LookML-Ansicht namens MyStoreGraphView, die auf einem StoreGraph-BigQuery-Diagramm in einer BigQuery-Datenbank basiert. Sie enthält Dimensionen und Messwerte, die dem Diagramm zugeordnet sind:

view: MyStoreGraphView {
  sql_analytic_model_name: StoreGraph ;;

  dimension: location_id {
    type: number
    sql: Stores_location_id ;;
  }

  dimension: population {
    type: number
    sql: Locations_population ;;
  }

  dimension: location_name {
    type: string
    sql: Locations_name ;;
  }

  measure: locations_total_population {
    type: number
    sql: Locations_total_population ;;
  }
}

Angenommen, die Datenbank hat ein weiteres Diagramm namens ShopDetailsGraph mit denselben Elementen wie StoreGraph. Hier ist ein Explore, das den sql_analytic_model_name-Wert in der Ansichtsdatei MyStoreGraphView überschreibt. Das Explore hat dieselben LookML-Dimensionen und ‑Messwerte, die in MyStoreGraphView definiert sind, aber das Explore fragt das Analysemodell ShopDetailsGraph ab:

explore: MyStoreGraphView {
  sql_analytic_model_name: ShopDetailsGraph ;;
}

Wichtige Punkte

Hinweise zu Analysemodellen in Looker

Beachten Sie bei der Verwendung von In-Database-Analysemodellen die folgenden Überlegungen und Einschränkungen:

  • Datentypen:Für Analysemodelle werden nur die folgenden Datentypen für Dimensionen und Messwerte unterstützt:

    • Unterstützt für Dimensionen und Messwerte:
      • string
      • number
      • date
      • yesno
    • Nur für Dimensionen unterstützt:
      • time
      • date_time

  • Messungen:

    • Basismesswerte müssen vordefiniert sein:Basismesswerte müssen im zugrunde liegenden analytischen Datenbankmodell vordefiniert sein. In Looker kann kein neuer Basismesswert definiert werden, indem eine Aggregation (z. B. type: sum oder type: count) für eine Dimension aus einem Analysemodell ausgeführt wird.

    • Messwerte, die auf anderen Messwerten basieren, werden unterstützt:Mit dem Parameter sql eines LookML-Messwerts können Sie Berechnungen ohne Aggregation durchführen, bei denen vordefinierte Basismesswerte aus dem Analysemodell verwendet werden. Wenn Sie ein Measure erstellen, das auf anderen Measures basiert, können Sie das neue Measure nicht als aggregierten Measure-Typ wie sum oder count definieren. Sie müssen den neuen Messwert als nicht aggregierten Messwerttyp definieren, z. B. string, number, date oder yesno. Sehen Sie sich folgendes Beispiel an:

      measure: average_order_amount {
  type: number
  sql: ROUND(${total_order_amount} / NULLIF(${count_orders}, 0), 2) ;;
}

  • Joins:Ein Explore, dessen Basisansicht auf einem Analysemodell basiert, darf keine Joins enthalten. Ebenso kann eine Ansicht, die auf einem Analysemodell basiert, nicht mit einem Explore verknüpft werden, das eine standardmäßige LookML-Basisansicht hat.

  • Implizite Joins:Funktionen, die auf impliziten Joins basieren, werden für Analysemodelle nicht unterstützt. Beispiele für Funktionen, die auf impliziten Joins basieren, sind benutzerdefinierte Kalender und Felder, die mit type: location, type: distance oder type: zipcode definiert sind.

  • Die folgenden Funktionen werden bei Analysemodellen nicht unterstützt:

Das Analysemodell muss über die aktuelle Verbindung zugänglich sein.

Wenn der Parameter sql_analytic_model_name in einem explore-Objekt verwendet wird, ist dieses explore-Objekt wiederum in einem model-Objekt enthalten. Die Hierarchie auf dieser Seite zeigt diese Beziehungskette. Das Modellobjekt enthält eine definierte Datenbank connection. Wenn Sie im Parameter sql_analytic_model_name auf ein Analysemodell verweisen, muss das Analysemodell über die zugehörige Verbindung zugänglich sein, die in der Modelldatei angegeben ist.

Die Standard-Datenbank und das Schema (oder für Google BigQuery das Abrechnungsprojekt und das Dataset) werden von Ihrem Looker-Administrator definiert, wenn er die Looker-Verbindung zu Ihrer Datenbank erstellt.