Modell oder Explore eines Looks oder Dashboards ändern

Gelegentlich möchten Sie das Modell oder den Quell-Explore eines Looks oder Dashboards ändern. Angenommen, Sie haben einen Look oder ein Dashboard, das auf der LookML aus Modell A basiert. Sie haben auch ein zweites Modell – Modell B. Sie möchten die Modellreferenz eines Looks oder Dashboards von Modell A in Modell B ändern. Auf dieser Seite erfahren Sie, wie Sie das Quellmodell oder Explore für einen Look oder ein Dashboard ändern.

Je nach Anwendungsfall gibt es mehrere Lösungen:

Erweiterte URL des Designs bearbeiten

Bei einem einmaligen Look können Sie den Modellnamen in der URL über die erweiterte URL des zugrunde liegenden Explores ändern.

  1. Klicken Sie im Look auf den Link Von hier aus analysieren, um die Abfrage des Looks in einer Explore-Ansicht zu öffnen.
  2. Wähle im Zahnradmenü von „Explore“ die Option Teilen aus, um das Menü URLs teilen zu öffnen.
  3. Kopieren Sie die URL aus der Option Erweiterte URL.
  4. Ändern Sie den Modellnamen in der erweiterten URL. Der Modellname folgt direkt auf den Instanznamen und den /explore-Teil der URL. Die URL hat folgendes Format:

    https://instance_name.looker.com/explore/MODEL_NAME/EXPLORE_NAME?fields=...

    In diesem Beispiel lautet der Modellname lauren_ecommerce: Erweiterte URL mit „/explore/lauren_ecommerce/order_items?fields=orders.created_month,orders.count“ nach dem Instanznamen.
  5. Fügen Sie die neue URL des Explores in einen Browser ein, um zu prüfen, ob sie mit dem aktualisierten Modellnamen funktioniert.
  6. Speichern Sie die explorative Datenanalyse als neuen Look oder überschreiben Sie den vorhandenen Look.

LookML-Kopien von Dashboards erstellen

Sie können ein oder mehrere Dashboards in ein LookML-Dashboard konvertieren und das Modell des Dashboards in der LookML aktualisieren:

  1. Erstellen Sie für jedes Dashboard eine LookML-Kopie des Dashboards und speichern Sie sie in Ihrem LookML-Projekt. Wenn Ihre Dashboards bereits LookML-Dashboards sind, können Sie diesen Schritt überspringen.
  2. Verwenden Sie in Ihrem LookML-Projekt die Such- und Ersetzungsfunktion der Looker IDE, um Instanzen von model: zu finden, und aktualisieren Sie den Wert dann nach Bedarf auf einen anderen Modellnamen.
  3. Sie können die aktualisierten Dashboards als LookML-Dashboards belassen oder in benutzerdefinierte Dashboards umwandeln.

Looker API verwenden

Mit der Looker API können Sie das Modell für mehrere Dashboards aktualisieren:

  1. Verwenden Sie den API-Endpunkt dashboard_elements, um alle Dashboard-Elemente abzurufen. Die Antwort enthält die Abfrage-IDs.
  2. Wenn eine der Dashboard-Kacheln mit einem Look verknüpft ist, verwenden Sie den Endpunkt looks, um die Abfrage-ID des zugrunde liegenden Looks zu ermitteln.
  3. Für jede Abfrage-ID:
    1. Rufen Sie den Endpunkt query auf, um den Antworttext der Abfrage abzurufen.
    2. Kopieren Sie den query-Antworttext.
    3. Aktualisieren Sie den Wert des Schlüssels model auf das neue Modell.
    4. Verwenden Sie den Endpunkt create_query, um eine neue Abfrage zu erstellen und den bearbeiteten Textkörper einzugeben.
  4. Ändern Sie für das Dashboard die Abfrage-ID für jedes Element. Verwenden Sie dazu den Endpunkt update_dashboard_element und geben Sie den bearbeiteten Textkörper ein.

Looker-Inhaltsvalidierung verwenden

Mit dem Inhaltsvalidierer können Sie Looks und Dashboards auf Fehler prüfen. Außerdem gibt es die Funktion In allen Inhalten suchen und ersetzen, mit der Sie das zugrunde liegende Modell oder Explore für alle Looks oder Dashboard-Kacheln ändern können.

Mit der Funktion In allen Inhalten suchen und ersetzen werden alle Looks und Dashboards in der Looker-Instanz geändert. Wenn Sie eine Änderung nur auf einige Looks oder Dashboard-Kacheln anwenden möchten, können Sie eine bahnbrechende Änderung vornehmen, wie in den folgenden Schritten beschrieben.

Wenn Sie die Modell- oder Explore-Referenz nicht für alle Inhalte in einer Instanz ändern möchten, aber die Referenz für mehrere Looks oder Dashboard-Kacheln gleichzeitig ändern möchten, können Sie mit dem Inhaltsvalidierer die Referenzen für mehrere Looks oder Dashboard-Kacheln gleichzeitig ersetzen:

  1. Aktivieren Sie den Entwicklungsmodus, damit keine Nutzer von den Änderungen betroffen sind, die Sie in den folgenden Schritten vornehmen.
  2. „Bestätigen“ Sie das vorhandene Modell, indem Sie die Modelldatei in der Looker-IDE in einen anderen Namen umbenennen, der Ihrer Meinung nach nicht existiert, z. B. zzz. Dadurch funktionieren alle Looks und Dashboards, in denen das ursprüngliche Modell verwendet wird, nicht mehr.
  3. Wählen Sie im Menü Entwickeln die Option Inhaltsvalidierer aus, um den Inhaltsvalidierer zu öffnen.
  4. Wähle Validieren aus, um den Inhaltsvalidierer auszuführen.
  5. Wählen Sie in den Ergebnissen des Content Validators die Schaltfläche Inhalt aus, um die Ergebnisse nach Inhalt zu gruppieren.
  6. Suchen Sie die Looks oder Dashboard-Kacheln, für die Sie die Modellreferenz ändern möchten.
  7. Klicken Sie für jeden einzelnen Look oder jedes Dashboard auf die Schaltfläche Ersetzen, um den fehlerhaften Modellnamen durch den gewünschten neuen Modellnamen zu ersetzen.
  8. Prüfen Sie, ob die Looks oder Dashboard-Kacheln jetzt wie erwartet funktionieren, da sie auf das neue Modell verweisen.
  9. Kehren Sie abschließend zu Ihrem Projekt zurück, geben Sie der Modelldatei in der Looker IDE ihren ursprünglichen Namen zurück und führen Sie den Inhaltsvalidierer noch einmal aus, um sicherzustellen, dass alle Validierungsfehler behoben wurden.