La API de Looker ahora usa valores de slug de consulta para los IDs de consulta

Nota: El cambio descrito en esta página se lanzará por fases:

• Looker 24.20 (4 de diciembre del 2024): clientes de la versión preliminar de América
• Looker 25.0: clientes de la zona horaria del centro de América
• Looker 25.2: disponibilidad general

Los siguientes métodos de la API de la aplicación Looker no usan un valor numérico query_id o, en el caso de las APIs de Query, un valor numérico id. Los métodos siguientes usan el valor del slug de la consulta.

• APIs de Look:

  • Copiar aspecto
  • Crear look
  • Obtener Look
  • Mover la vista
  • Aspectos de búsqueda
  • Actualizar aspecto
  • Ver todos los looks

• APIs de panel de control:

  • Elementos del panel de control de la Búsqueda
  • Get DashboardElement
  • Update DashboardElement
  • Get All DashboardElements
  • Create DashboardElement

• APIs de tareas de renderizado:

  • Crear tarea de renderizado de aspecto
  • Crear tarea de renderizado de consulta
  • Create Dashboard Render Task
  • Get Render Task
  • Create Dashboard Element Render Task

• APIs de planes programados:

  • Planes programados para el espacio
  • Get Scheduled Plan
  • Actualizar plan programado
  • Get All Scheduled Plans
  • Crear plan programado
  • Planes programados para Look
  • Planes programados para el panel de control
  • Programar planes para un panel de control de LookML

• APIs de consulta:

  • Run Query Async
  • Get Query
  • Get Query for Slug
  • Crear consulta
  • Ejecutar consulta
  • Get Merge Query ("Obtener consulta de combinación")
  • Crear consulta de combinación
  • Get All Running Queries

¿Qué debo hacer?

El campo query_id o, en el caso de las APIs Query, el campo id es un tipo de datos de cadena. Los campos query_id o id ahora devuelven un valor de slug de consulta en la respuesta de la API. Ese valor de slug de consulta se puede usar en cualquier solicitud de API.

Por ejemplo, si creara una consulta con la API Create Query, id sería el slug de la consulta en la respuesta. Después, puedes usar ese id para hacer una solicitud posterior.

Si has codificado de forma rígida valores numéricos de ID de consulta para alguno de los métodos de la API que se indican, debes actualizar tus secuencias de comandos para usar valores de slug de consulta.

¿Cómo puedo encontrar el valor de slug de una consulta?

Puedes encontrar el valor del slug de una consulta de las siguientes formas:

• En el caso de un Exploración, puedes encontrar el slug en la URL del Exploración después de la variable qid=.

• Puede encontrar el valor del slug asociado a un ID de consulta numérico mediante Actividad del sistema.

  Nota: Para ver los Exploraciones de actividad del sistema, debes tener un rol que incluya el permiso see_system_activity.

  1. En el menú Explorar de Looker, selecciona la opción Actividad del sistema > Historial Explorar.

  2. En la vista Consulta, seleccione las dimensiones ID y Enlace.

  3. También puede añadir un filtro en la dimensión ID e introducir el ID de consulta numérico de la consulta en el campo de filtro ID de consulta.

  4. Haz clic en Ejecutar.

     

  5. Haga clic en el enlace [Query] situado junto al ID de consulta numérico de los resultados de Explorar para abrir una exploración basada en ese ID de consulta numérico.

  6. Después, puedes usar el slug en la URL de Exploración, que sigue a la variable qid= en la URL.

¿Cómo puedo saber si usamos alguno de los endpoints de la API actualizados?

Puedes ver una lista de las llamadas a la API que se han hecho a tu instancia de Looker con la Exploración de actividad del sistema de uso de la API.

1. En el menú Explorar de Looker, selecciona la exploración Actividad del sistema y, a continuación, la vista Uso de la API.

2. Seleccione las dimensiones Fecha de creación > Fecha y Endpoint, así como la métrica Uso total.

3. Añada un filtro en la dimensión Endpoint (Endpoint) e incluya en el campo de filtro cualquiera de los endpoints actualizados que se indican al principio de este documento y que quiera buscar.

4. Haz clic en Ejecutar. Looker mostrará información sobre el uso de esos endpoints.