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 para las exploraciones solo se debe usar cuando la misma vista puede describir varias tablas en tu base de datos. 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

El parámetro sql_table_name especifica la tabla de tu base de datos que consultará el Explorar. 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, 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.

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 apuntar 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 sobre 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 predeterminado:

explore: customers {
  sql_table_name: customer_1 ;;
}

En este ejemplo, la función Explorar customers depende de la tabla customer_1 del esquema analytics al limitar 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 base de datos definido en él. Cuando haces referencia a una tabla de 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.

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 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 a nivel de 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 ;;
}