En esta página, se hace referencia al parámetro
sql_table_nameque forma parte de una exploración.
sql_table_nametambién se puede usar como parte de una vista, que se describe en la página de documentación del parámetrosql_table_name(para vistas).
sql_table_nametambién se puede usar como parte de una unión, que se describe en la página de documentación del parámetrosql_table_name(para uniones).
Uso
explore: explore_name {
sql_table_name: table_name ;;
}
sql_table_name |
Valor predeterminado
La tabla de la base de datos en la que se basa la vista de la exploración
Acepta
El nombre de una tabla de la base de datos
Reglas especiales
|
Definición
El parámetro sql_table_name especifica la tabla de tu base de datos que consultará la exploración. Por lo general, la vista para la que se nombra una exploración define la tabla que se consultará. Sin embargo, en los casos en que varias tablas tienen la misma estructura, puedes usar el parámetro sql_table_name en el parámetro explore para anular la tabla base que se especifica en el archivo de vista. De esta manera, puedes tomar las dimensiones y las medidas que definiste en el archivo de vista y aplicarlas a tablas de bases de datos que no sean la que se especifica en el archivo de vista.
Cómo definir el alcance de los nombres de las tablas
Cuando haces referencia a una tabla usando solo el nombre de la tabla, Looker usará la ruta de acceso de búsqueda predeterminada (la base de datos y el esquema) que tu administrador de Looker configuró en los parámetros de configuración de la conexión de base de datos. Consulta la sección Aspectos para tener en cuenta de esta página para obtener más información.
Si necesitas hacer referencia a una tabla en una base de datos y un esquema diferentes que no están en la ruta de acceso de búsqueda predeterminada del usuario de la base de datos, puedes definir el alcance del nombre de la tabla con el formato <database_name>.<schema_name>.<table_name> para dirigir a otra base de datos o esquema:
- Para hacer referencia a una tabla de un esquema diferente, usa
<schema_name>.<table_name>, como se muestra en el ejemplo de esta página. - Para hacer referencia a una tabla de una base de datos diferente, usa el formato completo
<database_name>.<schema_name>.<table_name>.
Para una conexión de Google BigQuery, puedes hacer referencia a una tabla en un proyecto y un conjunto de datos diferentes si defines el alcance del nombre de la tabla con el formato <project_name>.<dataset_name>.<table_name>. Consulta la página de documentación de la conexión de Google BigQuery para obtener información adicional.
Ejemplos
En este ejemplo, la exploración customers depende de la tabla customer_1 de la base de datos o el esquema predeterminados:
explore: customers {
sql_table_name: customer_1 ;;
}
En este ejemplo, la exploración customers depende de la tabla customer_1 del esquema analytics si se define el alcance del nombre de la tabla para incluir el nombre del esquema (con el formato <schema_name>.<table_name>):
explore: customers {
sql_table_name: analytics.customer_1 ;;
}
Aspectos para tener en cuenta
Se debe poder acceder a las tablas a las que hace referencia sql_table_name desde la conexión actual
Cuando se usa el parámetro sql_table_name dentro de un objeto explore, ese objeto explore se incluye a su vez en un objeto de modelo. (La jerarquía de esta página muestra esta cadena de relaciones). El objeto de modelo tiene una base de datos connection definida en él. Cuando haces referencia a una tabla de la base de datos en el parámetro sql_table_name, se debe poder acceder a la tabla dentro de la conexión asociada especificada en el archivo de modelo.
Tu administrador de Looker define la base de datos y el esquema predeterminados (o, para Google BigQuery, el proyecto de facturación y el conjunto de datos) cuando crea la conexión de Looker a tu base de datos.
Para nombrar una view de forma diferente a la tabla subyacente, aplica sql_table_name en el nivel view
El uso de sql_table_name en el nivel explore, como se describe en esta página, no es muy común. Solo se debe usar cuando la misma view puede describir varias tablas.
El método más habitual es usar sql_table_name en el nivel view cuando deseas nombrar una vista de forma diferente al nombre de la tabla subyacente.
En otras palabras, en lugar de hacer esto:
Archivo de modelo
explore: customers {
sql_table_name: customer_1 ;;
}
Haz lo siguiente:
Archivo de modelo
explore: customers { ... }
Archivo de vista
view: customers {
sql_table_name: customer_1 ;;
}