sql_table_name (für Explores)

Auf dieser Seite wird auf den sql_table_name Parameter verwiesen, der Teil eines Explore 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 einer Verknüpfung verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter sql_table_name (für Verknüpfungen).

Nutzung

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

Akzeptiert
Der Name einer Datenbanktabelle

Sonderregeln
  • sql_table_name für Explores sollte nur verwendet werden, wenn dieselbe Ansicht mehrere Tabellen in Ihrer Datenbank beschreiben kann.
  • Auf die Tabelle, auf die mit sql_table_name verwiesen wird, muss über die Datenbankverbindung des zugehörigen Modells zugegriffen werden können.
  • 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 dem sql_table_name Parameter wird die Tabelle in Ihrer Datenbank angegeben, die vom Explore abgefragt wird. In der Regel definiert die Ansicht, nach der ein Explore benannt ist, die Tabelle, die abgefragt wird. Wenn jedoch mehrere Tabellen dieselbe Struktur haben, können Sie mit dem Parameter sql_table_name unter dem Parameter explore die in der Ansichtsdatei angegebene Basistabelle überschreiben. Auf diese Weise können Sie die in der Ansichtsdatei definierten Dimensionen und Measures auf andere Datenbanktabellen als die in der Ansichtsdatei angegebene Tabelle anwenden.

Tabellennamen eingrenzen

Wenn Sie mit dem Tabellennamen allein auf eine Tabelle verweisen, 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 Punkte auf dieser Seite.

Wenn Sie auf eine Tabelle in einer anderen Datenbank und einem anderen Schema verweisen müssen, die nicht im Standardsuchpfad des Datenbanknutzers enthalten sind, 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:

  • Verwenden Sie <schema_name>.<table_name>, um auf eine Tabelle aus einem anderen Schema zu verweisen, wie im Beispiel auf dieser Seite gezeigt.
  • Verwenden Sie <database_name>.<schema_name>.<table_name>, um auf eine Tabelle aus einer anderen Datenbank zu verweisen.

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 das Explore customers auf der Tabelle customer_1 aus der Standarddatenbank/-dem Standardschema:

explore: customers {
  sql_table_name: customer_1 ;;
}

In diesem Beispiel basiert das Explore customers auf der Tabelle customer_1 aus dem Schema analytics. Dazu wird der Tabellenname so eingegrenzt, dass er den Schemanamen enthält (mit dem Format <schema_name>.<table_name>):

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

Wichtige Punkte

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

Wenn der sql_table_name Parameter in einem explore-Objekt verwendet wird, ist dieses explore-Objekt wiederum in einem Modell-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 auf die Tabelle über die zugehörige Verbindung zugegriffen werden können, die in der Modelldatei angegeben ist.

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

Wenn Sie eine view anders als die zugrunde liegende Tabelle benennen möchten, wenden Sie sql_table_name auf Ansichtsebene anview

Die Verwendung von sql_table_name auf explore-Ebene, wie auf dieser Seite beschrieben, ist nicht sehr üblich. Sie sollte nur verwendet werden, wenn dieselbe view mehrere Tabellen beschreiben kann.

Die typischere Methode ist die Verwendung von sql_table_name auf view-Ebene, wenn Sie eine Ansicht anders als die zugrunde liegende Tabelle benennen möchten.

Mit anderen Worten: Anstatt

Modelldatei

explore: customers {
  sql_table_name: customer_1 ;;
}

gehen Sie so vor:

Modelldatei

explore: customers { ... }

Ansichtsdatei

view: customers {
  sql_table_name: customer_1 ;;
}