Auf dieser Seite wird auf den Parameter
sql_table_nameverwiesen, der Teil einer Exploration ist.
sql_table_namekann auch als Teil einer Ansicht verwendet werden. Dies wird auf der Dokumentationsseite zum Parametersql_table_name(für Ansichten) beschrieben.
sql_table_namekann auch als Teil eines Joins verwendet werden. Dies wird auf der Dokumentationsseite zum Parametersql_table_name(für Joins) beschrieben.
Nutzung
explore: explore_name {
sql_table_name: table_name ;;
}
sql_table_name |
Standardwert
Die Datenbanktabelle, auf der die Ansicht des Explores basiert
Akzeptiert
Der Name einer Datenbanktabelle
Besondere Regeln
|
Definition
Mit dem Parameter sql_table_name wird die Tabelle in Ihrer Datenbank angegeben, die von der Explore abgefragt wird. Normalerweise wird die Tabelle, die abgefragt wird, durch die Ansicht definiert, nach der ein Explore benannt ist. Wenn jedoch mehrere Tabellen dieselbe Struktur haben, können Sie den Parameter sql_table_name unter dem Parameter explore verwenden, um die in der Ansichtsdatei angegebene Basistabelle zu überschreiben. Auf diese Weise können Sie die Dimensionen und Messwerte, die Sie in der Ansichtsdatei definiert haben, auf andere Datenbanktabellen als die in der Ansichtsdatei angegebene Tabelle anwenden.
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 mit dem Format <project_name>.<dataset_name>.<table_name> eingrenzen. Weitere Informationen finden Sie auf der Dokumentationsseite Google BigQuery-Verbindung.
Beispiele
In diesem Beispiel basiert der Explore customers auf der Tabelle customer_1 aus der Standarddatenbank bzw. dem Standardschema:
explore: customers {
sql_table_name: customer_1 ;;
}
In diesem Beispiel wird das Explore customers auf die Tabelle customer_1 aus dem Schema analytics festgelegt, 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 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
Modelldatei
explore: customers {
sql_table_name: customer_1 ;;
}
Vorgehensweise
Modelldatei
explore: customers { ... }
Datei ansehen
view: customers {
sql_table_name: customer_1 ;;
}