sql_table_name (für Joins)

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

Nutzung

explore: view_name {
  join: view_name {
    sql_table_name: table_name ;;
  }
}

Hierarchie Modelldatei explore join sql_table_name

Standardwert Keine Akzeptiert Ein Tabellenname in Ihrer Datenbank Sonderregeln Auf die Tabelle, auf die mit sql_table_name verwiesen wird, muss über die Datenbankverbindung des 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

In der Regel wird die abzufragende Tabelle durch die Ansicht definiert, auf der ein join basiert.

Mit sql_table_name können Sie die Tabelle in Ihrer Datenbank festlegen, die von einem join abgefragt werden soll. Das ist ungewöhnlich, kann aber nützlich sein, wenn mehrere Tabellen dasselbe Schema haben. So kann dieselbe Ansicht verwendet werden, um alle zu beschreiben. Mit sql_table_name können Sie angeben, welche Tabellen von der Ansicht verwendet werden sollen, die Sie verknüpfen. In solchen Fällen sollten Sie extends oder Verfeinerungen verwenden.

Tabellennamen eingrenzen

Wenn Sie nur den Tabellennamen verwenden, um auf eine Tabelle zu 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 sich nicht im Standardsuchpfad des Datenbanknutzers befindet, können Sie den Tabellennamen mit dem <database_name>.<schema_name>.<table_name> Format 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.

Hinweise:

• Für Joins über Datenbanken hinweg müssen sich die beiden Datenbanken im selben SQL-Dialekt befinden und beide Datenbanken müssen über dieselbe Verbindung in Looker zugänglich sein (siehe Abschnitt Wichtige Punkte auf dieser Seite).
• Je nach Datenbankkonfiguration und Dialekt müssen sich die über Datenbanken hinweg verknüpften Tabellen möglicherweise auch auf demselben physischen Computer befinden. Weitere Informationen finden Sie im Abschnitt Föderierte Joins auf der Dokumentationsseite sql_table_name (für Ansichten).

Beispiele

In diesem Beispiel basiert der customers-Join auf der Tabelle customer_1 aus dem Standardschema:

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

In diesem Beispiel basiert der customers-Join auf der Tabelle customer_1 aus dem Schema analytics. Dazu wird der Tabellenname eingegrenzt, um den Schemanamen einzuschließen (mit dem Format <schema_name>.<table_name>):

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

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 join Objekt verwendet wird, wird dieses join Objekt in einem explore Objekt definiert, das wiederum in einem Modell Objekt enthalten ist. Die Hierarchie auf dieser Seite zeigt diese Beziehungskette. Das Modellobjekt enthält eine 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 einen 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 join-Ebene, wie auf dieser Seite beschrieben, ist unüblich. Sie sollte nur verwendet werden, wenn dieselbe Ansicht mehrere Tabellen beschreiben kann.

Die typischere Methode ist, sql_table_name auf der Ansicht-Ebene zu verwenden, um eine Ansicht anders als die zugrunde liegende Tabelle zu benennen.

Anstelle von

Modelldatei

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

verwenden Sie

Modelldatei

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

Ansichtsdatei

view: customers {
  sql_table_name: customer_1 ;;
}