sql_table_name (para Explorar)

En esta página, se hace referencia al parámetro sql_table_name que forma parte de Explorar.

sql_table_name también se puede usar como parte de una vista, descrita en la página de documentación del parámetro sql_table_name (para vistas).

sql_table_name también se puede usar como parte de una unión, que se describe en la página de documentación del parámetro sql_table_name (para combinaciones).

Uso

explore: explore_name {
sql_table_name: table_name ;;
}
Jerarquía
sql_table_name
Valor predeterminado
La tabla de la base de datos en la que se basa la vista de Explorar

Acepta
El nombre de una tabla de base de datos

Reglas especiales
  • sql_table_name solo debe usarse cuando la misma vista puede describir varias tablas.
  • Cualquier tabla a la que haga referencia sql_table_name debe ser accesible dentro de la conexión de base de datos de su modelo

Definición

sql_table_name establece la tabla en tu base de datos que se consultará en Explorar. Por lo general, la vista para la que se llama a Explorar define la tabla que se consultará. Sin embargo, cuando varias tablas tienen la misma estructura, se puede usar la misma vista para describirlas a todas. sql_table_name te permite especificar cuál de esas tablas se debe usar.

Si necesitas hacer referencia a una tabla de una base de datos o esquema diferentes, puedes usar database_or_schema_name.table_name. Si no escribe una base de datos o un esquema de forma explícita, Looker usará el valor predeterminado que estableció. El valor predeterminado se configura en la sección Administrador de Looker en Conexiones.

Ejemplos

Haz que la exploración de customers dependa de la tabla customer_1 de la base de datos o el esquema predeterminado:

explore: customers {
  sql_table_name: customer_1 ;;
}

Haz que la exploración de customers dependa de la tabla customer_1 de la base de datos o el esquema de analytics:

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

Desafíos habituales

Se debe poder acceder a las tablas a las que hace referencia sql_table_name desde la conexión actual

sql_table_name es parte de Explorar, que a su vez forma parte de un modelo. El modelo tendrá una conexión de base de datos definida. Cualquier tabla a la que hagas referencia en sql_table_name debe ser accesible dentro de esa conexión de base de datos.

Qué debes saber

Para nombrar una view de manera diferente a la tabla subyacente, aplica sql_table_name a nivel de view.

No es muy común usar sql_table_name a nivel de explore, como se describe en esta página. Solo se debe usar cuando el mismo view puede describir varias tablas.

El método más común es usar sql_table_name a nivel de view cuando quieres asignar un nombre a una vista diferente al nombre de la tabla subyacente.

En otras palabras, en lugar de esto:

Archivo del modelo

explore: customers {
  sql_table_name: customer_1 ;;
}

Haz lo siguiente:

Archivo del modelo

explore: customers { ... }

Ver archivo

view: customers {
  sql_table_name: customer_1 ;;
}