sql_table_name (para Exploraciones)

En esta página, se hace referencia al parámetro sql_table_name que forma parte de una Exploración.

sql_table_name también se puede usar como parte de una vista, como se describe 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, como se describe en la página de documentación del parámetro sql_table_name (para uniones).

Uso

explore: explore_name {
  sql_table_name: table_name ;;
}

Jerarquía Archivo del modelo explore sql_table_name

Valor predeterminado Tabla de la base de datos en la que se basa la vista del Explorar Acepta El nombre de una tabla de base de datos Reglas especiales sql_table_name solo se debe usar cuando la misma vista puede describir varias tablas. Se debe poder acceder a la tabla a la que hace referencia sql_table_name dentro de la conexión de la base de datos de su modelo. Si la tabla se encuentra en una base de datos, un esquema, un proyecto o un conjunto de datos diferentes de la ruta de acceso predeterminada que definiste en la conexión de la base de datos, debes delimitar el nombre de la tabla.

Definición

sql_table_name establece la tabla de tu base de datos que consultará el Explorador. Por lo general, la vista para la que se nombra un Explore define la tabla que se consultará. Sin embargo, en los casos en que varias tablas tienen la misma estructura, se puede usar la misma vista para describirlas todas. sql_table_name te permite especificar cuál de esas tablas se debe usar.

Nombres de tablas de alcance

Cuando haces referencia a una tabla solo con el nombre de la tabla, Looker usará la ruta 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 la base de datos. Consulta la sección Aspectos a 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 se encuentran en la ruta 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 que apunte 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 otra base de datos, usa el <database_name>.<schema_name>.<table_name> completo.

En el caso de 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 más información.

Ejemplos

En este ejemplo, se hace que el Explorar customers dependa de la tabla customer_1 de la base de datos o el esquema predeterminados:

explore: customers {
  sql_table_name: customer_1 ;;
}

En este ejemplo, se hace que el Explore customers dependa de la tabla customer_1 del esquema analytics delimitando el 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 ;;
}

Nota: Para una conexión de Google BigQuery, puedes definir el alcance completo del nombre de la tabla con el formato <project_name>.<dataset_name>.<table_name>. Consulta la página de documentación sobre la conexión de Google BigQuery para obtener más información.

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 el parámetro sql_table_name se usa dentro de un objeto explore, ese objeto explore se incluye, a su vez, en un objeto model. (La jerarquía de esta página muestra esta cadena de relaciones). El objeto del modelo tiene un connection de la base de datos definido 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 del modelo.

El administrador de Looker define la base de datos y el esquema predeterminados (o, en el caso de 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 la conexión de la base de datos.

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

El uso de sql_table_name a nivel de explore, como se describe en esta página, no es muy común. Solo se debe usar cuando el mismo 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 manera diferente al nombre de la tabla subyacente.

En otras palabras, en lugar de esto:

Archivo del modelo

explore: customers {
  sql_table_name: customer_1 ;;
}

Sigue estos pasos:

Archivo del modelo

explore: customers { ... }

Ver archivo

view: customers {
  sql_table_name: customer_1 ;;
}