sql_table_name (für Joins)

Diese Seite bezieht sich auf den Parameter sql_table_name, der Teil eines Join ist.

sql_table_name kann auch als Teil einer Ansicht verwendet werden, wie auf der Dokumentationsseite zum Parameter sql_table_name (für Ansichten) beschrieben.

sql_table_name kann auch als Teil eines explorativen Analysetools verwendet werden, wie auf der Seite mit der Parameterdokumentation für sql_table_name beschrieben.

Nutzung

Explore: Ansichtsname {
join: view_name {
sql_table_name: table_name ;;
}
}
Hierarchie
sql_table_name
Standardwert
Keine

Akzeptiert
Tabellenname in der Datenbank

Sonderregeln
  • Die Tabelle muss innerhalb der Datenbankverbindung zugänglich sein
  • Wenn sich die Tabelle in einem anderen Schema befindet, muss das Schema angegeben werden
  • Bei einer datenbankübergreifenden Verknüpfung müssen die Datenbank und das Schema angegeben werden und die andere Datenbank muss sich auf demselben Computer und im selben SQL-Dialekt befinden.

Definition

In der Regel definiert die Ansicht, auf der eine join basiert, die abzufragende Tabelle.

Mit sql_table_name können Sie festlegen, dass die Tabelle in Ihrer Datenbank von einem join abgefragt wird. Das ist zwar ungewöhnlich, kann aber nützlich sein, wenn mehrere Tabellen das gleiche Schema haben. So kann dieselbe Ansicht zur Beschreibung aller Tabellen verwendet werden. Mit sql_table_name können Sie angeben, welche Tabellen von der Ansicht verwendet werden sollen, die Sie zusammenführen möchten. In solchen Fällen empfiehlt es sich, extends oder Suchfilter zu verwenden.

Sie können schema_name.table_name verwenden, um auf eine Tabelle aus einem anderen Schema zu verweisen. Sie können database_name.schema_name.table_name verwenden, um auf eine Tabelle aus einer anderen Datenbank zu verweisen. Bei einer datenbankübergreifenden Verknüpfung müssen sich die Datenbanken jedoch auf demselben Computer und im selben SQL-Dialekt befinden.

Wenn Sie das Schema nicht explizit angeben, verwendet Looker die von Ihnen festgelegte Standardeinstellung. Die Standardkonfiguration wird in Looker im Abschnitt Admin unter Verbindungen konfiguriert.

Beispiele

Dafür sorgen, dass der Join customers auf der Tabelle customer_1 aus dem Standardschema basiert:

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Sorgen Sie dafür, dass die Funktion „Erkunden“ customers auf der Tabelle customer_1 aus dem analytics-Schema basiert:

explore: orders {
  join: customers {
    sql_table_name: analytics.customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Häufige Herausforderungen

Tabellen, auf die sql_table_name verweist, müssen von der aktuellen Verbindung aus zugänglich sein

sql_table_name wird mit einem Join verwendet, der wiederum Teil eines Modells ist. Das Modell hat eine Datenbankverbindung definiert. Jede in sql_table_name referenzierte Tabelle muss innerhalb dieser Datenbankverbindung zugänglich sein.

Wichtige Informationen

Wenn Sie join anders als die zugrunde liegende Tabelle benennen möchten, wenden Sie sql_table_name auf Ansichtsebene an

Die Verwendung von sql_table_name auf der Ebene join ist, wie auf dieser Seite beschrieben, ungewöhnlich. Es sollte nur verwendet werden, wenn dieselbe Ansicht mehrere Tabellen beschreiben kann.

In der Regel wird sql_table_name auf Ansichtsebene verwendet, um eine Ansicht anders zu benennen als der zugrunde liegende Tabellenname.

Anstelle von

Modelldatei

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}}

Folgendes tun:

Modelldatei

explore: orders {
  join: customers {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Datei ansehen

view: customers {
  sql_table_name: customer_1 ;;
}