sql_table_name (für Explores)

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

sql_table_name kann auch als Teil einer Ansicht verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter sql_table_name (für Ansichten).

sql_table_name kann auch als Teil eines Joins verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter sql_table_name (für Joins) beschrieben.

Nutzung

explore: explore_name {
  sql_table_name: table_name ;;
}
Hierarchie
explore
sql_table_name
Standardwert
Die Datenbanktabelle, auf der die Ansicht des Explores basiert

Akzeptiert
Der Name einer Datenbanktabelle

Besondere Regeln
  • sql_table_name sollte nur verwendet werden, wenn dieselbe Ansicht mehrere Tabellen beschreiben kann.
  • Die Tabelle, auf die in sql_table_name verwiesen wird, muss über die Datenbankverbindung des zugehörigen Modells zugänglich sein.
  • Wenn sich die Tabelle 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 Tabellennamen eingrenzen.

Definition

Mit sql_table_name wird die Tabelle in Ihrer Datenbank festgelegt, die vom Explore abgefragt wird. Normalerweise wird mit der Ansicht, nach der ein Explore benannt ist, die Tabelle definiert, die abgefragt wird. Wenn jedoch mehrere Tabellen dieselbe Struktur haben, kann dieselbe Ansicht verwendet werden, um alle zu beschreiben. Mit sql_table_name können Sie angeben, welche dieser Tabellen verwendet werden sollen.

Tabellennamen eingrenzen

Wenn Sie nur den Tabellennamen angeben, verwendet Looker den Standardsuchpfad (die Datenbank und das Schema), den Ihr Looker-Administrator in den Einstellungen für die Datenbankverbindung konfiguriert hat. Weitere Informationen finden Sie im Abschnitt Wichtige Hinweise auf dieser Seite.

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

  • Wenn Sie auf eine Tabelle aus einem anderen Schema verweisen möchten, verwenden Sie <schema_name>.<table_name>, wie im Beispiel auf dieser Seite gezeigt.
  • Wenn Sie auf eine Tabelle aus einer anderen Datenbank verweisen möchten, verwenden Sie den vollständigen <database_name>.<schema_name>.<table_name>.

Bei einer Google BigQuery-Verbindung können Sie auf eine Tabelle in einem anderen Projekt und Dataset verweisen, indem Sie den Tabellennamen im Format <project_name>.<dataset_name>.<table_name> angeben. Weitere Informationen finden Sie auf der Dokumentationsseite Google BigQuery-Verbindung.

Beispiele

In diesem Beispiel wird das Explore customers auf die Tabelle customer_1 aus der Standarddatenbank bzw. dem Standardschema gestützt:

explore: customers {
  sql_table_name: customer_1 ;;
}

In diesem Beispiel wird die customers-Exploration auf die Tabelle customer_1 aus dem Schema analytics gestützt, indem der Tabellenname bereichsbezogen ist und den Schemanamen enthält (im Format <schema_name>.<table_name>):

explore: customers {
  sql_table_name: analytics.customer_1 ;;
}

Wichtige Punkte

Auf Tabellen, auf die von sql_table_name verwiesen wird, muss über die aktuelle Verbindung zugegriffen werden können.

Wenn der Parameter sql_table_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_table_name auf eine Datenbanktabelle verweisen, muss die Tabelle ü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 für die Datenbankverbindung erstellt.

Wenn Sie ein view anders als die zugrunde liegende Tabelle benennen möchten, wenden Sie sql_table_name auf view-Ebene an.

Die Verwendung von sql_table_name auf der Ebene explore, wie auf dieser Seite beschrieben, ist nicht sehr verbreitet. Sie sollte nur verwendet werden, wenn dasselbe view mehrere Tabellen beschreiben kann.

Die üblichere Methode ist die Verwendung von sql_table_name auf der Ebene view, wenn Sie eine Ansicht anders als den zugrunde liegenden Tabellennamen benennen möchten.

Mit anderen Worten: Anstelle von

Model File

explore: customers {
  sql_table_name: customer_1 ;;
}

Vorgehensweise

Model File

explore: customers { ... }

Datei ansehen

view: customers {
  sql_table_name: customer_1 ;;
}