Publicación de looks y exploraciones

En esta página, se proporciona una descripción general de cómo enviar vistas y exploraciones a los destinos de entrega integrados de Looker y a cualquier servicio integrado que esté disponible para tu instancia de Looker. Para obtener información sobre cómo programar paneles, visita la página de documentación Programa y envía paneles.

El Programador de Looker es el nombre de la parte de la interfaz de usuario de Looker en la que configuras los parámetros para la publicación de contenido. En el caso de los Looks, puedes usar el programador para enviar entregas únicas o recurrentes. Las exploraciones solo se pueden enviar como entregas únicas. Para programar el contenido de Explorar para su envío recurrente, primero debes guardarlo como una vista.

Cómo abrir el Programador desde una carpeta

Para abrir el Programador desde una carpeta o subcarpeta, busca la carpeta o subcarpeta que contiene el panel que quieres enviar. Cuando navegas a una carpeta, las vistas y los paneles que contiene se muestran en la vista de lista o en la vista de cuadrícula.

Un ícono de calendario indica que programaste al menos un envío recurrente para ese contenido (en la vista de cuadrícula, debes colocar el cursor sobre la miniatura del contenido para ver el ícono de calendario, si está presente).

En la vista de lista, puedes abrir el Programador de las siguientes maneras:

  • Hacer clic en el ícono de calendario de un elemento, si está presente
  • Hacer clic en el menú de tres puntos de un elemento y elegir Editar programa (si ya hay un programa para el elemento), Agregar programa (si aún no hay un programa para el elemento) o Enviar (para crear un envío único)
  • Abre el contenido, haz clic en el menú de ajustes en la esquina superior derecha y elige Programar (para entregas recurrentes) o Enviar (para entregas únicas).

En la vista de cuadrícula, puedes abrir el Programador de las siguientes maneras:

  • Hacer clic en el ícono de calendario de un elemento, si está presente
  • Abre el contenido, haz clic en el menú de ajustes en la esquina superior derecha y elige Programar (para entregas recurrentes) o Enviar (para entregas únicas).

Crea una entrega

Para crear un envío desde el contenido de Looker, abre el Programador heredado. Para ello, haz clic en el menú de ajustes en la esquina superior derecha del contenido y elige Programar (para envíos recurrentes) o Enviar (para envíos únicos).

En el caso de las entregas recurrentes, el panel izquierdo del Programador heredado muestra todos los programas creados para el contenido y destaca el título del programa que estás creando o editando. En el panel izquierdo, se enumeran las programaciones en orden cronológico inverso desde la última vez que se actualizaron. Para duplicar o borrar programas existentes, haz clic en el ícono Duplicar o Borrar a la derecha del programa, respectivamente.

Si es la primera programación que creas para este contenido, el panel principal mostrará las opciones de programación con sus valores predeterminados. Puedes modificar esos valores según sea necesario. Si ya creaste uno o más programas para este contenido, el panel principal mostrará la configuración de programación guardada para el programa que se encuentra en la parte superior de la lista. Luego:

  • Para editar las opciones de un programa existente, selecciónalo y cambia las opciones según sea necesario. Cuando termines, haz clic en Guardar todo.
  • Para crear programaciones adicionales para el mismo contenido, haz clic en Nuevo y, luego, ingresa la configuración de esa programación adicional.

Cuando termines, haz clic en Guardar todo.

En las siguientes secciones, se explica cada parámetro de configuración de la programación.

Asigna un nombre a la publicación

Asigna un título único a la programación en el campo Asigna un nombre a la programación. El título aparecerá en el panel izquierdo después de que guardes la programación, en la lista de programaciones que creaste y en las páginas de administración de programaciones del panel Administrador.

Según el destino de la publicación, el título también puede aparecer en otros lugares:

  • En el caso de las entregas por correo electrónico, el título se usa para la línea de asunto del correo electrónico y como parte del nombre del archivo si seleccionas un formato que use un archivo adjunto de correo electrónico.
  • En el caso de los webhooks, el título se incluye en la carga útil del webhook en el campo Título.
  • En el caso de los envíos a un bucket de Amazon S3, el título se usa en el nombre de archivo del envío y en los correos electrónicos de error que se envían. El nombre de archivo de la entrega sigue el formato TITLE_TIMESTAMP_HASH, en el que HASH es un identificador aleatorio de seis caracteres y TIMESTAMP sigue el patrón YYYY-MM-DDTHHMM (por ejemplo, la parte de la marca de tiempo se vería como 2019-05-31T0933 para el 31 de mayo de 2019 a las 9:33 a.m.). La zona horaria de la marca de tiempo coincidirá con la zona horaria de entrega de la programación.
  • En el caso de las entregas a servicios integrados que generan un archivo adjunto, el título se incluye en el nombre de archivo de la entrega.
  • En el caso de las entregas por SFTP, el título se incluye en el nombre del archivo de la entrega. El nombre de archivo de la entrega sigue el formato TITLE_TIMESTAMP_TOKEN, en el que TOKEN es un identificador aleatorio de seis caracteres y TIMESTAMP sigue el patrón YYYY-MM-DDTHHMM (por ejemplo, la parte de la marca de tiempo se vería como 2019-05-31T0933 para el 31 de mayo de 2019 a las 9:33 a.m.). La zona horaria de la marca de tiempo coincidirá con la zona horaria de entrega de la programación.

    En el caso de los envíos por SFTP, solo se admiten caracteres alfanuméricos, guiones bajos (_) y guiones (-) en el nombre de archivo del envío. Looker quitará cualquier carácter que no sea A-Z, a-z, 0-9, _ o - de lo que ingreses en el campo Asigna un nombre a tu programa.

Elige el destino de entrega

Es posible que el parámetro de configuración ¿Dónde deben ir estos datos? muestre varias opciones de destino para las entregas de datos. Cada destino ofrece diferentes opciones de entrega.

Los destinos incluyen los siguientes:

Una vez que hayas seleccionado un destino de datos, aparecerá un nuevo campo de configuración para que agregues detalles específicos sobre ese destino, como una dirección de correo electrónico o una URL de webhook.

Opciones de entrega para el correo electrónico

Elige Correo electrónico en la sección ¿Dónde deben ir estos datos?. Tu contenido se entregará a una lista de direcciones de correo electrónico que especifiques.

En la sección ¿A quién se debe enviar el correo electrónico?, ingresa las direcciones de correo electrónico de los destinatarios. Ingresa una sola dirección de correo electrónico o varias separadas por comas y haz clic en Agregar. No hay límite para la cantidad de destinatarios que puedes agregar.

Según la configuración de tu instancia de Looker y los permisos asignados, es posible que puedas enviar correos electrónicos a direcciones de correo electrónico que no estén asociadas con ninguna cuenta de usuario en tu instancia de Looker. Estos se clasifican como correos electrónicos externos. Para enviar contenido a usuarios externos, tu administrador de Looker debe haberte otorgado permisos para enviar contenido a usuarios externos o haber agregado los dominios de correo electrónico de esos destinatarios a la lista de dominios de correo electrónico permitidos para el contenido programado.

Si un destinatario es otro usuario de Looker, esa persona verá la opción para volver al panel desde el correo electrónico, a menos que tu administrador de Looker haya configurado la política de datos enviados por correo electrónico de tu instancia de Looker como Solo enviar datos o que se haya deseleccionado la opción Incluir vínculos.

Si todos los destinatarios cancelan la suscripción a un envío de correo electrónico programado, ese programa se borra de Looker, incluso de las páginas de administración de programas para usuarios y administradores. Si un destinatario cancela la suscripción en nombre de un grupo de correo electrónico, ningún miembro del grupo recibirá los envíos de correos electrónicos programados.

Consulta la sección Aplica opciones de entrega avanzadas de esta página para obtener más información sobre las entregas de correos electrónicos.

Marca Incluir un mensaje personalizado para agregar un mensaje personalizado en el cuerpo del correo electrónico. Looker limita la cantidad de caracteres de un mensaje personalizado a 1,500.

Los envíos por correo electrónico no pueden superar los 20 MB (para los formatos que se envían en el cuerpo del correo electrónico) ni los 15 MB (para los formatos que se envían como archivo adjunto).

Opciones de entrega para webhooks

Los webhooks son una forma cada vez más común de activar intercambios entre servicios basados en Internet. Con un servicio web como Zapier, los webhooks pueden permitir que los datos de Looker se entreguen a una amplia variedad de aplicaciones. Por ejemplo, puedes programar la entrega periódica de un diseño o un panel a un webhook. Cuando configures una entrega, Looker te solicitará la dirección del webhook.

En la sección ¿Dónde deben ir estos datos?, elige Webhook. En la sección URL de webhook, ingresa la URL a la que Looker debe enviar una solicitud HTTPS para esta entrega. Puedes obtener esta URL del servicio web que usas para controlar tu webhook. Para configurar un webhook, ve a tu servicio web y haz lo siguiente:

  1. Obtén una URL a la que Looker deba enviar una solicitud HTTPS.
  2. Especifica una aplicación de destino para la entrega de datos de Looker. Es posible que la aplicación de destino requiera una configuración adicional para recibir datos de Looker.

El procedimiento exacto varía según el servicio web y la aplicación de destino que uses para entregar el panel. Consulta esta publicación de Comunidad de Looker sobre cómo programar vistas y paneles con webhooks (3.46 o versiones posteriores) para obtener lineamientos sobre cómo configurar otra aplicación para recibir los datos de webhook de Looker.

Looker intentará realizar la entrega a un webhook durante un máximo de 30 minutos. Asegúrate de que el destino pueda responder en un plazo de 30 minutos al intento de entrega del webhook.

Opciones de entrega para buckets de Amazon S3

Los buckets de Amazon S3 son una forma común de almacenar grandes cantidades de datos. Tú o tu empresa deberán haber creado un bucket de S3 con Amazon antes de que Looker pueda usarlo.

Si eliges la opción de destino de Amazon S3, Looker te solicitará parámetros de configuración adicionales sobre el formato y el bucket de Amazon S3, como se describe en esta página. Consulta esta publicación de Comunidad de Looker sobre cómo programar resultados (ilimitados) en S3 para obtener más detalles sobre cómo enviar datos con un bucket de Amazon S3.

En la sección ¿Dónde deben ir estos datos?, elige Amazon S3. Aparecerá la sección S3 Details y se te solicitará información sobre tu bucket de Amazon S3:

  • Bucket: Es el nombre de tu bucket de Amazon S3.
  • Ruta de acceso opcional: Es la carpeta en la que deseas guardar tus datos, si la hay.
  • Clave de acceso: Es el ID de la clave de acceso a tu bucket de S3, proporcionado por Amazon.
  • Clave secreta: Es la clave de acceso secreta a tu bucket de S3, proporcionada por Amazon.
  • Región: Es la región de servicios de Amazon en la que se aloja tu bucket de S3.

Opciones de entrega para servidores SFTP

Elige SFTP en la sección ¿A dónde deben ir estos datos? para enviar tu contenido a un servidor SFTP. Enviar resultados a un servidor SFTP es un buen método para usar cuando tus datos o visualizaciones son demasiado grandes para enviarlos por correo electrónico. Si eliges esta opción de entrega, Looker te solicitará la dirección, el nombre de usuario y la contraseña del servidor SFTP, como se describe a continuación.

Ten en cuenta lo siguiente sobre los envíos por SFTP:

  • Para recibir entregas de SFTP de Looker, asegúrate de que el administrador de red haya agregado las direcciones IP de Looker a la lista de IP permitidas o a las reglas de tráfico entrante del servidor SFTP.
  • Cuando se realiza el envío a un servidor SFTP, solo se admiten caracteres alfanuméricos, guiones bajos (_) y guiones (-) en el nombre de archivo del envío. Looker quitará cualquier carácter que no sea A-Z, a-z, 0-9, _ o - de lo que ingreses en el campo Asigna un nombre a tu programa.

Cuando eliges SFTP, Looker te solicita la URL y la información de acceso del servidor:

  • Dirección: Es la URL o la dirección IP del servidor SFTP al que deseas enviar tus datos. Por ejemplo:

    • sftp://files.looker.com/Marketing/In/
    • sftp://192.168.0.10/Marketing/In/

    Esta URL de ejemplo termina con el carácter /. Esto indica que el archivo se guardará en una carpeta llamada In. Si omites la / final, el archivo se guardará en la carpeta Marketing y se antepondrá "In" al nombre del archivo. Debes tener acceso de escritura a la carpeta en la que deseas crear el archivo.

  • Nombre de usuario y Contraseña: Son las credenciales de acceso para el servidor SFTP.

  • Algoritmo de intercambio de claves preferido: Este campo es opcional. Para configurarlo, elige el algoritmo de intercambio de claves SSH preferido para establecer la conexión. Las opciones compatibles son las siguientes:

    • ecdh-sha2-nistp521
    • ecdh-sha2-nistp384
    • ecdh-sha2-nistp256
    • diffie-hellman-group-exchange-sha256
    • diffie-hellman-group14-sha256
    • diffie-hellman-group14-sha1

    Si la conexión no se establece en un plazo de cinco minutos, elige un algoritmo diferente. Algunos algoritmos tardan mucho tiempo en generar una clave SSH. Esta opción te permite usar un algoritmo que podría tardar menos tiempo. Si eliges uno de los algoritmos, se convertirá en el preferido para establecer la conexión SSH. Si el servidor no admite el algoritmo, se usarán todos los demás algoritmos en los intentos posteriores. Cuando este campo se establece en Predeterminado, se usa el orden original de los algoritmos en la biblioteca de conexiones.

La compatibilidad con SFTP se limita a las credenciales de nombre de usuario y contraseña. No se admiten las credenciales de clave privada SSH.

Los algoritmos de clave de host que admiten las entregas de SFTP de Looker son los siguientes:

  • ssh-ed25519-cert-v01@openssh.com
  • ssh-ed25519
  • ecdsa-sha2-nistp521-cert-v01@openssh.com
  • ecdsa-sha2-nistp384-cert-v01@openssh.com
  • ecdsa-sha2-nistp256-cert-v01@openssh.com
  • ecdsa-sha2-nistp521
  • ecdsa-sha2-nistp384
  • ecdsa-sha2-nistp256
  • ssh-rsa-cert-v01@openssh.com
  • ssh-rsa-cert-v00@openssh.com
  • ssh-rsa
  • rsa-sha2-256
  • rsa-sha2-512

Los algoritmos de encriptación (algoritmos de cifrado) que admiten las entregas de SFTP de Looker son los siguientes:

  • aes256-ctr
  • aes192-ctr
  • aes128-ctr
  • aes256-gcm@openssh.com
  • aes128-gcm@openssh.com

Los algoritmos de código de autenticación de mensajes que admiten las entregas de SFTP de Looker son los siguientes:

  • hmac-sha2-512-etm@openssh.com
  • hmac-sha2-256-etm@openssh.com
  • hmac-sha2-512
  • hmac-sha2-256
  • hmac-sha1

Looker sube el archivo al directorio especificado en tu servidor SFTP con la siguiente convención para el nombre de archivo:

<name>_<timestamp>_<token>.<file extension>
  • <name> es el nombre que proporcionaste en el campo Asigna un nombre a tu programa, después de que Looker quite todos los caracteres que no sean A-Z, a-z, 0-9, _ o -.
  • <timestamp> es la marca de tiempo en la que se envió el programa, en el formato %Y-%m-%dT%H%M.
  • <token> es un token que consiste en una cadena aleatoria de seis caracteres.
  • <file extension> es la extensión de archivo.

Por ejemplo: Test_Schedule_2019-04-11T1130_HWkvys.csv.

Opciones de entrega para integraciones de terceros

Puedes programar o enviar una vista o los resultados de una exploración a un servicio que esté integrado en Looker, como Slack, Dropbox, Google Drive y otros. Tu administrador de Looker debe habilitar las integraciones. Los administradores de Looker deben otorgar permisos específicos para que los usuarios y los usuarios incorporados envíen y programen datos a integraciones de terceros.

Cuando se selecciona un servicio integrado en el campo Destino del Programador, pueden aparecer varios campos nuevos y solicitarte más información.

En la siguiente lista, se muestran los servicios del Action Hub de Looker a los que puedes enviar un Look o los resultados de una exploración.

A continuación, se indica cómo usar la lista:

  • Las URLs que se muestran en la columna Vínculo al archivo README proporcionan instrucciones para habilitar y configurar el servicio integrado para que funcione con Looker.
  • Las URLs que se muestran en la columna Cómo usar esta integración proporcionan instrucciones para enviar datos de Looker al servicio integrado. Algunos de estos artículos también contienen instrucciones de habilitación.
  • En Etiquetas de LookML obligatorias, se enumeran las etiquetas obligatorias que se deben usar con el parámetro tags en el modelo subyacente del contenido.
  • El tipo de acción indica qué nivel de datos envía el servicio integrado: campo, consulta o panel. Una acción a nivel del campo envía el valor de una sola celda especificada en una tabla de datos. Una acción a nivel de la consulta envía los resultados de una consulta completa, como todas las filas de una exploración o un diseño. Una acción a nivel del panel envía una imagen de un panel.
  • Usa la autenticación de OAuth de Google indica si el servicio integrado usa credenciales de OAuth de Google para la autenticación.
  • Usa la transmisión de datos indica si el servicio integrado admite resultados de consultas transmitidos.
Servicio integrado Descripción Vínculo al archivo README Cómo usar esta integración Etiquetas de LookML obligatorias Tipo de acción Usa la autenticación de OAuth de Google (sí/no) Usa la transmisión de datos (sí/no)
Airtable Agrega registros a una tabla en Airtable. Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No No
Amazon SageMaker Infer Realiza una inferencia con Amazon SageMaker. No hay un archivo README disponible No hay artículos disponibles Ninguno Consulta No Sí
Amazon SageMaker Train: Linear Learner Inicia un trabajo de entrenamiento en Amazon SageMaker con el algoritmo de aprendizaje lineal. No hay un archivo README disponible No hay artículos disponibles Ninguno Consulta No Sí
Amazon SageMaker Train: Xgboost Inicia un trabajo de entrenamiento en Amazon SageMaker con el algoritmo XGBoost. No hay un archivo README disponible No hay artículos disponibles Ninguno Consulta No Sí
Detención de instancias de EC2 de Amazon Web Services Detener una instancia de EC2 con la API de Amazon EC2 Ver el archivo README en GitHub Ver artículo de la comunidad aws_resource_id Campo, consulta No No
Barreno Usa el resultado de la consulta para crear un modelo predictivo. Ver el archivo README en GitHub Consulta el archivo README Ninguno Consulta No Sí
Azure Storage Envía y almacena un archivo de datos en Azure Storage. Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No Sí
Braze La acción de Braze te permite marcar usuarios en Braze con el extremo de la API de REST desde una vista. Asegúrate de que haya un campo braze_id etiquetado en los resultados. MAX EXPORT: 10000. Ver el archivo README en GitHub Consulta el archivo README braze_id Consulta No Sí
DigitalOcean: Detener droplet Detén el proceso de DigitalOcean con la API de DigitalOcean. Ver el archivo README en GitHub Ver artículo de la comunidad digitalocean_droplet_id Campo, consulta No No
DigitalOcean Spaces Enviar un archivo de datos al almacenamiento de DigitalOcean y guardarlo allí Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No Sí
Dropbox Envía y almacena un archivo de datos en Dropbox. No hay un archivo README disponible Ver la documentación Ninguno Consulta Sí No
Públicos personalizados de Facebook Sube datos a los públicos personalizados de Facebook Ads desde la lista de clientes. Ver el archivo README en GitHub Consulta el archivo README Ninguno Consulta Sí Sí
Firebase Usa Firebase para enviar notificaciones push a dispositivos móviles. No hay un archivo README disponible No hay artículos disponibles Ninguno Consulta No No
Segmentación por clientes de Google Ads Sube datos a la Segmentación por clientes de Google Ads. Ver el archivo README en GitHub Ver la documentación Ninguno Consulta Sí Sí
Importación de datos de Google Analytics Sube datos a un conjunto de datos de Google Analytics. Ver el archivo README en GitHub Consulta el archivo README Ninguno Consulta Sí Sí
Google Cloud Storage Escribir archivos de datos en un bucket de Google Cloud Storage Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No Sí
Google Drive Envía datos a Google Drive. No hay un archivo README disponible Ver la documentación Ninguno Consulta Sí Sí
Hojas de cálculo de Google Enviar datos de un archivo CSV a una hoja de cálculo de Google No hay un archivo README disponible Ver la documentación Ninguno Consulta Sí Sí
Empresas de HubSpot Agrega propiedades a tus empresas con la API de Hubspot V3. Ver el archivo README en GitHub Consulta el archivo README hubspot_company_id Consulta No Sí
Contactos de HubSpot Agrega propiedades a tus contactos con la API de HubSpot V3. Ver el archivo README en GitHub Consulta el archivo README hubspot_contact_id Consulta No Sí
Kloudio Agregar datos a una hoja de cálculo de Google Ver el archivo README en GitHub Consulta el archivo README Ninguno Consulta No No
mParticle Exporta de forma masiva tus datos de usuarios o eventos de Looker a mParticle. Ver el archivo README en GitHub Consulta el archivo README Consulta el archivo README Consulta No Sí
Campañas de Salesforce Agregar contactos o clientes potenciales a la campaña de Salesforce Ver el archivo README en GitHub Consulta el archivo README sfdc_contact_id o sfdc_lead_id Consulta Sí No
Grupo de segmentos Agrega rasgos o usuarios a tus grupos de segmentos. Ver el archivo README en GitHub Ver la documentación segment_group_id y user_id, o segment_group_id y segment_anonymous_id Consulta No Sí
Segment Identify Agrega atributos a tus usuarios de Segment con Identify. Ver el archivo README en GitHub Ver la documentación email o user_id o segment_anonymous_id o segment_group_id Consulta No Sí
Segment Track Conéctate a una serie de integraciones proporcionadas por Segment para identificar y segmentar usuarios para los flujos de trabajo de marketing. Ver el archivo README en GitHub Ver la documentación email o user_id o segment_anonymous_id o segment_group_id Consulta No Sí
SendGrid Envía datos y programa los resultados para que se envíen a una dirección de correo electrónico con la API de SendGrid. Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No No
Slack Envía contenido de Looker en mensajes directos, canales públicos y canales privados en Slack con OAuth. Está disponible para implementaciones alojadas en Looker en la versión 6.24 y posteriores con la función Lista de IPs permitidas inhabilitada. No hay un archivo README disponible Ver la documentación Ninguno Consulta Sí Sí
Adjunto de Slack (token de API) Enviar datos directamente a un canal de Slack junto con las credenciales del usuario También puedes consultar la documentación de Lookerbot para obtener más información sobre la funcionalidad de Slack. Ver el archivo README en GitHub Ver la documentación Ninguno Consulta No No
Teams: Webhook entrante Envía datos a Microsoft Teams con un webhook entrante. Ver el archivo README en GitHub Consulta el archivo README Ninguno Consulta No No
Bandeja Conéctate a una serie de integraciones proporcionadas por Tray.io para automatizar los flujos de trabajo. Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No Sí
Twilio: Envía datos Envía datos desde una vista o programa los resultados para enviarlos a un número de teléfono con la API de Twilio. Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No No
Twilio: Envía un mensaje Envía un mensaje a una serie de números de teléfono (columnas de datos etiquetadas como números de teléfono) en una vista. Ver el archivo README en GitHub Consulta el archivo README teléfono Campo, consulta No No
Zapier Conéctate a una serie de integraciones que proporciona Zapier para automatizar los flujos de trabajo. Ver el archivo README en GitHub Ver artículo de la comunidad Ninguno Consulta No Sí

Elige el formato de datos

Las vistas y las exploraciones presentan diferentes opciones de formato según el destino de entrega. Para elegir el formato de tu publicación, selecciona el ícono correspondiente en la sección Dar formato a los datos como del Programador.

Consulta la siguiente tabla para obtener una explicación de cómo se entrega cada formato a cada destino.

Formato Correo electrónico Webhook Amazon S3 SFTP
Tabla de datos La tabla de datos en el cuerpo del correo electrónico en formato HTML No está disponible para este destino No está disponible para este destino No está disponible para este destino
Visualización La visualización en el cuerpo del correo electrónico como una imagen PNG No está disponible para este destino No está disponible para este destino No está disponible para este destino
CSV La tabla de datos como un archivo de texto adjunto separado por comas La tabla de datos como un archivo de texto adjunto separado por comas La tabla de datos como un archivo de texto adjunto separado por comas La tabla de datos como un archivo de texto adjunto separado por comas
XLSX La tabla de datos como un archivo adjunto de Excel La tabla de datos como un archivo adjunto de Excel La tabla de datos como un archivo adjunto de Excel La tabla de datos como un archivo adjunto de Excel
JSON: simple La tabla de datos como un archivo JSON adjunto. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo. La tabla de datos como un archivo JSON adjunto. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo. La tabla de datos como un archivo JSON adjunto. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo. La tabla de datos como un archivo JSON adjunto. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo.
JSON: etiqueta No está disponible para este destino Es la tabla de datos en formato JSON. En este formato, Looker usa las etiquetas de campo como su valor renderizado en su resultado JSON. No está disponible para este destino No está disponible para este destino
JSON: intercalado y simple No está disponible para este destino Es la tabla de datos enviada directamente en formato JSON. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo. No está disponible para este destino No está disponible para este destino
JSON: intercalado y detallado No está disponible para este destino La tabla de datos enviada directamente en formato JSON, con detalles adicionales, como metadatos de campo, información de caché, la hora en que se completó la consulta y cuánto tiempo tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo. La tabla de datos enviada directamente en formato JSON, con detalles adicionales, como metadatos de campo, información de caché, la hora en que se completó la consulta y cuánto tiempo tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo. La tabla de datos enviada directamente en formato JSON, con detalles adicionales, como metadatos de campo, información de caché, la hora en que se completó la consulta y cuánto tiempo tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado, en lugar de la etiqueta del campo.
Texto La tabla de datos como un archivo de texto adjunto delimitado por tabulaciones La tabla de datos como un archivo de texto adjunto delimitado por tabulaciones La tabla de datos como un archivo de texto adjunto delimitado por tabulaciones La tabla de datos como un archivo de texto adjunto delimitado por tabulaciones
HTML La tabla de datos como un archivo HTML adjunto La tabla de datos como un archivo HTML adjunto La tabla de datos como un archivo HTML adjunto La tabla de datos como un archivo HTML adjunto

Activación de la publicación

Cuando programas entregas recurrentes, tienes dos opciones para activarlas:

Especifica el activador del grupo de datos

Para usar un activador de grupo de datos, selecciona Actualización del grupo de datos en la sección Activador del programador. Luego, elige el grupo de datos de origen en el menú desplegable Seleccionar grupo de datos.

Para programar contenido con un activador de grupo de datos, el archivo de modelo en el que se basa el contenido debe incluir un grupo de datos. Looker enumera todos los grupos de datos definidos en los modelos que se incluyen en la tarjeta de Look o del panel determinada, incluso si los grupos de datos no se usan para controlar el almacenamiento en caché de las consultas o las PDT.

Los programas basados en grupos de datos solo se activan para entregarse una vez que se completa el proceso de regeneración de todas las PDT que se conservan con ese grupo de datos, lo que garantiza que la entrega incluya los datos más actualizados.

Especifica la recurrencia de la entrega

En el caso de los envíos que usan un intervalo de repetición, puedes personalizar el horario de tu programa en la sección Entregar este programa. Selecciona Intervalo de repetición en la sección Activador del programador. Las opciones de tiempo cambian según si eliges Diariamente, Semanalmente, Mensualmente, Cada hora o Por minuto. Puedes ajustar la zona horaria de la programación en la sección Opciones avanzadas.

La hora de finalización de los intervalos Por hora y Por minuto no es inclusiva. La última entrega se enviará en el último intervalo seleccionado antes de la hora de finalización especificada. Por ejemplo, si el contenido se programa Cada hora entre las 12:00 a.m. y las 11:00 p.m., se enviará cada hora, de 12:00 a.m. a 10:00 p.m. Si el contenido se programa Por minuto cada 30 minutos entre las 12:00 a.m. y las 11:00 p.m., la última entrega en ese período se enviará a las 10:30 p.m.

Aplicar filtros a la publicación

Si envías una vista o un panel que tiene filtros, puedes modificar las condiciones de filtro para filtrar aún más los resultados que se envían.

Haz clic en Filtros para ver y modificar los filtros asociados con esta vista o panel para tu entrega. Cambiar estas opciones de filtro en el programador no cambia los filtros en tu Look o panel. Si un filtro del panel requiere un valor de filtro y el filtro de programación está en blanco, la programación no mostrará resultados cuando se entregue.

Si cambias los nombres de los campos que funcionan como filtros en tus vistas o paneles, asegúrate de revisar la sección Filtros de tus vistas y paneles programados, y actualiza los filtros según sea necesario para reflejar los cambios. Si una publicación de contenido programada incluye filtros que ya no funcionan (por ejemplo, si cambió el campo al que se hace referencia), la publicación programada podría exponer datos sin filtrar.

Para personalizar aún más las entregas, puedes usar la opción de filtro coincide con un atributo de usuario (si tus administradores de Looker configuraron valores específicos del usuario llamados atributos de usuario). Si configuras un filtro para uno de estos atributos, los resultados se personalizarán automáticamente para cada usuario, lo que significa que puedes enviar resultados personalizados a muchos usuarios, incluso si envías una entrega única. Puedes obtener más información al respecto en la página de documentación Atributos de usuario.

Cómo aplicar opciones de publicación avanzadas

La sección Opciones avanzadas proporciona personalización adicional para tu publicación. Haz clic en la flecha junto a Opciones avanzadas para expandir este menú. Las opciones disponibles dependen del destino y el formato seleccionados para el envío, y de si envías un panel, un diseño o una exploración. Los vínculos de la siguiente tabla dirigen a una descripción de cada opción disponible para los envíos de vistas o exploraciones a los destinos integrados de Looker. Es posible que las entregas a integraciones de terceros tengan opciones avanzadas únicas disponibles.

Formato Correo electrónico Webhook Amazon S3 SFTP
Tabla de datos
Enviar este programa si No disponible para este destino No disponible para este destino No disponible para este destino
Límite
Opciones de correo electrónico Ejecutar programación como destinatario
Incluir vínculos
Opciones de formato Aplica opciones de visualización
Valores de datos con formato
Zona horaria
Visualización
Límite No disponible para este destino No disponible para este destino No disponible para este destino
Opciones de correo electrónico Ejecutar programación como destinatario
Incluir vínculos
Resolución de la tabla
Zona horaria
CSV
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
XLSX
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
JSON: simple; JSON: etiqueta; JSON: intercalado y simple
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
JSON: intercalado y detallado No disponible para este destino Límite Límite Límite
No disponible para este destino Zona horaria Zona horaria Zona horaria
Texto
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
HTML
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización Opciones de formato Aplica opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria

Enviar este programa si

En el caso de los envíos recurrentes de vistas, puedes personalizar el programa para que se envíe el contenido de la vista solo cuando se cumplan ciertas condiciones. Las alertas proporcionan una función similar para las tarjetas del panel.

En el menú desplegable Enviar esta programación si, especifica si quieres que se entregue el contenido de Look solo si hay resultados, solo si no hay resultados o si hay resultados o no. Por ejemplo, puedes usar filtros para crear condiciones para situaciones que deseas supervisar, como artículos que están por debajo de una determinada cantidad de inventario, gastos que están por encima de un valor determinado, etcétera, y, luego, entregar el contenido solo si se alcanzó esa condición.

También puedes especificar que se realice un envío solo si los resultados de la consulta cambiaron desde que se envió la última entrega de datos. Para ello, marca la casilla junto a y los resultados cambiaron desde la última ejecución. Esta opción no está disponible si quieres usar la opción de límite de Todos los resultados.

Límite

Puedes limitar el tamaño de tu entrega seleccionando una de las siguientes opciones de límite para tus datos:

  • Resultados en la tabla: Los datos se envían como una sola entrega.
  • Todos los resultados: Los datos se transmiten a medida que se devuelven, y se envían todas las filas de datos de los resultados de la consulta. La opción Todos los resultados solo es visible para los usuarios que tienen un rol que contiene el permiso schedule_without_limit.

Si eliges Resultados en la tabla, Looker respetará las limitaciones de filas que hayas configurado en la vista guardada o en la exploración. Si eliges Todos los resultados, Looker devolverá todas las filas de la consulta, independientemente de la configuración de la vista guardada y del límite típico de 5,000 filas de Looker. Habilitar este parámetro de configuración puede ser conveniente para recuperar conjuntos de datos muy grandes, pero debes tener cuidado para asegurarte de que la consulta no sea demasiado grande para tu base de datos.

Opciones de límite para el correo electrónico

Cuando envías vistas y exploraciones, puedes limitar el tamaño de tus correos electrónicos para que se mantengan dentro de las limitaciones de tamaño de los mensajes del servidor de correo electrónico. Selecciona una de las siguientes opciones de límite para tus datos:

  • Resultados en la tabla: Los datos se envían con un límite de 5,000 filas. Esta es la única opción disponible para los correos electrónicos que usan las opciones de formato Tabla de datos o Visualización. Looker no enviará correos electrónicos con más de 5,000 filas de datos.
  • Todos los resultados: Si usas las opciones de formato de texto, CSV, JSON (simple), XLSX o HTML, puedes enviar todas las filas de los resultados de una vista guardada. Esta opción ignora los límites establecidos en una vista guardada o el límite típico de 5,000 filas de Looker. Sin embargo, hay un límite de datos total que se impone a las aplicaciones de correo electrónico. Looker no entregará correos electrónicos con cuerpos que contengan más de 20 MB de datos o archivos adjuntos que contengan más de 15 MB de datos. Si especificas un formato de tabla de datos o de visualización y, luego, seleccionas Todos los resultados, Looker cambia automáticamente el formato para usar un archivo de texto adjunto que admita el envío de todos los resultados. La opción Todos los resultados solo es visible para los usuarios que tienen un rol que contiene el permiso schedule_without_limit.

Para verificar que no superas el límite de filas o datos de los correos electrónicos programados, puedes ingresar tu propia dirección de correo electrónico como destinatario y hacer clic en Enviar prueba para enviarte los datos de inmediato. Si no recibes el correo electrónico, es probable que hayas alcanzado el límite de filas o de datos para los correos electrónicos.

Opciones de correo electrónico

Los envíos por correo electrónico tienen opciones de entrega adicionales, que son Ejecutar programa como destinatario e Incluir vínculos.

Ejecutar programación como destinatario

Esta opción solo está disponible para el destino de correo electrónico.

La opción Ejecutar programa como destinatario permite que los administradores especifiquen una lista de usuarios que recibirán la publicación de contenido como si hubieran ejecutado la consulta, según sus permisos. Los usuarios que no son administradores también pueden ingresar su propia dirección de correo electrónico para recibir una entrega como si hubieran consultado el contenido, según sus permisos. Esto significa que los filtros de acceso y los atributos de usuario de cada usuario se aplicarán a los datos incluidos en cada correo electrónico.

Por ejemplo, un administrador de Looker necesita programar una consulta que cuente los usuarios agrupados por estado para una serie de usuarios, y cada usuario tiene diferentes valores de filtro de acceso.

El usuario A tiene un filtro de acceso establecido como users.state = 'California'. Cuando se selecciona Ejecutar programa como destinatario, la consulta programada aplicará el filtro de acceso users.state = 'California' y enviará los resultados filtrados al usuario A. Los resultados mostrarán una fila solo para California.

Esta opción tiene en cuenta los permisos del usuario que crea la programación, así como los tipos de direcciones de correo electrónico que se agregan al campo de texto ¿A quién se debe enviar el correo electrónico?.

En algunos casos, la opción Ejecutar programación como destinatario no está disponible:

  1. Cuando un usuario que no es administrador agrega una dirección de correo electrónico que no es la suya
  2. Cuando un administrador de Looker agrega el correo electrónico de un usuario inhabilitado
  3. Cuando un administrador de Looker agrega un correo electrónico que no pertenece a un usuario de Looker (una cuenta de Looker se indica con un ícono de Looker junto al destinatario)
  • Si el correo electrónico se agregó antes de que se seleccionara la opción Ejecutar programa como destinatario, la opción se inhabilitará automáticamente. Volverá a estar disponible si se borra esa dirección de correo electrónico de la lista de destinatarios.
  • Si la dirección de correo electrónico se agregó después de que se seleccionó la opción Ejecutar programa como destinatario, se producirá un error y la dirección de correo electrónico se quitará automáticamente del campo ¿A quién se debe enviar por correo electrónico?. La opción Ejecutar programación como destinatario permanecerá habilitada.

En el caso especial en el que un usuario aparece como destinatario en un programa que tiene habilitada la opción Ejecutar programa como destinatario y, luego, se inhabilita la cuenta de ese usuario, el programa no se entregará al usuario inhabilitado a partir de la próxima vez que se ejecute. Si se borra la cuenta de ese usuario, no se enviará la programación completa a ningún destinatario. Un administrador o usuario de Looker con el permiso see_schedules podrá diagnosticar este error en la página Historial del programador del panel Administrador.

Si el administrador de Looker configuró la política de datos enviados por correo electrónico de tu instancia de Looker como Enviar vínculos y datos, el programador mostrará una opción para Incluir vínculos. Cuando se marca esta opción, las entregas de datos por correo electrónico incluyen un vínculo de regreso a Looker que dice "Ver informe completo" para las vistas y exploraciones entregadas, y "Ver panel completo" para los paneles entregados.

Este vínculo permite que los destinatarios del correo electrónico exploren con mayor detalle los datos de la instancia de Looker. Los destinatarios deben acceder a Looker y tener permisos para acceder al modelo en el que se basa el contenido enviado para verlo en Looker. Si quieres quitar este vínculo de tus correos electrónicos de entrega de datos, desmarca la casilla de verificación Incluir vínculos.

Opciones de formato

Las entregas que no usan el formato de visualización tienen opciones de entrega adicionales, que son Aplicar opciones de visualización y Valores de datos con formato.

Aplicar opciones de visualización

Esta opción no está disponible para los envíos de vistas o exploraciones en formato de visualización.

  • Selecciona Aplicar opciones de visualización para que la entrega de datos se vea similar a un gráfico de tabla. Se aplicará cualquiera de los siguientes parámetros de configuración de los menús Gráfico, Series y Formato que se hayan establecido para la visualización:

  • Anula la selección de Aplicar opciones de visualización para que Looker envíe los datos tal como aparecen en la sección Datos de la vista o en la ventana Explorar desde aquí de una tarjeta del panel. JSON: Etiqueta usa el campo label, incluso si no se selecciona Aplicar opciones de visualización.

Valores de datos con formato

Puedes configurar el formato de los datos:

  • Selecciona Valores de datos con formato si quieres que los datos se parezcan más a la experiencia de Exploración en Looker, aunque algunos tipos de archivos no admiten algunas funciones (como la vinculación).
  • Anula la selección de Formatted data values si no quieres aplicar ningún formato especial de tus resultados de consulta, como redondear los números largos o agregar caracteres especiales que los desarrolladores de Looker podrían haber establecido. Por lo general, esto es lo que se prefiere cuando los datos se ingresan a otra herramienta para su procesamiento.

Resolución de la tabla

Cuando envías contenido por correo electrónico en formato de visualización, puedes personalizar el ancho de la visualización con el menú desplegable Resolución de la tabla. Las opciones de ancho son las siguientes:

  • Normal: 800 píxeles
  • Ancho: 1,680 píxeles

Si eliges Ancho y el ancho de la visualización supera el límite establecido por tu cliente de correo electrónico, es posible que los destinatarios de la entrega por correo electrónico deban desplazarse de forma horizontal para ver toda la visualización.

Zona horaria

De forma predeterminada, Looker usa la zona horaria asociada con tu cuenta para determinar cuándo enviar la entrega de datos. Si no tienes una zona horaria asociada a tu cuenta, Looker usará la zona horaria de la aplicación. Si quieres especificar una zona horaria diferente, selecciona Usar zona horaria personalizada. La zona horaria que selecciones no afectará los datos de tu vista o panel, solo el momento de la entrega.

Prueba la publicación

Haz clic en el botón Enviar prueba para enviar una entrega de prueba única al destino especificado. La opción Probar ahora no tiene en cuenta algunos parámetros de configuración de las Opciones avanzadas, pero sí respeta los filtros seleccionados.

Guardando la publicación

En la parte inferior del Programador, se muestra un resumen de la configuración de publicación.

En el caso de las entregas únicas, cuando termines de configurar las opciones de entrega, haz clic en el botón Enviar para entregar el contenido de inmediato al destino especificado.

En el caso de las entregas recurrentes, cuando termines de configurar las opciones de entrega, haz clic en el botón Guardar todo para guardar tu programa y cerrar la ventana. El contenido se publicará según tu configuración de publicación. Si vuelves a abrir el Programador, la programación guardada aparecerá en el panel izquierdo. Puedes duplicar o borrar la programación haciendo clic en el ícono Duplicar o Borrar, respectivamente.

La programación guardada también aparecerá en la página Programaciones que creaste de tu perfil de usuario y en las páginas Programaciones e Historial de programaciones del panel Administrador. Consulta la sección Visualiza las entregas de esta página para obtener más información.

Cómo consultar entregas

Puedes ver los programas que creaste y, si tienes los permisos adecuados, todos los programas de la instancia de Looker.

Cómo ver las entregas que creaste

Puedes ver una lista de todas las programaciones que creaste en la página Programaciones que creaste, a la que puedes acceder haciendo clic en el ícono de tu perfil de usuario y seleccionando Programaciones. Consulta la página Visualiza tus entregas de datos programadas para obtener más información sobre cómo ver y administrar los programas que creaste.

Cómo ver las entregas creadas por otros usuarios

Si tu administrador de Looker te otorgó permisos para ver las páginas de administrador Programas e Historial de programas, puedes ver la lista de todos los programas de toda la instancia de Looker. Sin embargo, no podrás editar ni borrar esas programaciones.

Información importante

En ocasiones, es posible que un envío de correo electrónico programado no llegue a uno o más de sus destinatarios. Esto podría suceder si el modelo subyacente tiene un error, si el destinatario no tiene acceso a los datos o si hay problemas de renderización o errores de página.

Ten en cuenta las siguientes limitaciones de la publicación de contenido:

  • Si tu empresa configuró sus propios parámetros de correo electrónico en la sección Administrador de Looker, tus administradores de Looker deberán asegurarse de que los parámetros de configuración sean correctos y de que tu proveedor de correo electrónico funcione correctamente. Un servidor SMTP externo puede tener sus propios límites diarios o por mensaje para los destinatarios.
  • Según el parámetro de configuración Límite, la entrega de datos se limitará a 5,000 filas o a un tamaño de archivo máximo de 15 MB para correos electrónicos con archivos adjuntos y 20 MB para correos electrónicos con contenido intercalado. No se enviarán los correos electrónicos que tengan más filas o datos que estos límites.
  • Aunque Looker no codifica un límite para la cantidad de destinatarios que puedes especificar en un envío por correo electrónico, si configuras el envío para que se "ejecute como destinatario", el envío activa una consulta independiente para cada persona. Esta carga puede afectar gravemente el rendimiento de la base de datos y no se recomienda para listas de destinatarios grandes. Te recomendamos que uses grupos o alias de correo electrónico siempre que sea posible.
  • Si un correo electrónico no se envía en el momento previsto, pero llega con retraso, es probable que se deba a que compite con otras tareas de Looker. Estas tareas pueden incluir otros correos electrónicos programados, muchas personas que exploran datos al mismo tiempo o tablas derivadas persistentes que se están creando. Si esto sucede, consulta con tus administradores de Looker sobre las tareas que compiten.
  • Si un correo electrónico específico sigue desapareciendo de tu lista de distribución, es probable que se deba a que un usuario canceló la suscripción a ese correo electrónico programado. Esto puede ser un desafío particular si usas un alias de correo electrónico de grupo para enviar mensajes a varias personas, ya que cualquier destinatario individual puede cancelar la suscripción de todo ese alias de correo electrónico. Para obtener más información sobre las cancelaciones de suscripciones, consulta esta publicación de Comunidad de Looker sobre la supervisión de los eventos de cancelación de suscripción del programador.

Si falla el envío a un servidor SFTP, considera las siguientes posibilidades:

  • Cuando Looker intenta realizar un envío a un servidor SFTP, es posible que el envío se marque como completado en el panel de programación y en los registros, incluso si no llega debido a problemas de configuración de red, como una lista de IPs permitidas incorrecta en el servidor de destino o un puerto de salida cerrado en la instancia de Looker. Debido a que el historial de programación puede mostrar un estado Success a pesar de estos errores, siempre verifica los registros del servidor SFTP de destino si sospechas que falta una entrega.

  • Looker almacena las huellas digitales de SFTP de tu servidor SFTP. Si encuentras errores con la publicación por SFTP, es posible que las huellas digitales de SFTP no sean válidas. En este caso, comunícate con tu administrador de Looker.

  • El error Net::SSH::Exception. message: could not settle on host_key algorithm se produce por una incompatibilidad entre los algoritmos de clave de host que ofrecen las versiones anteriores de Looker (anteriores a Looker 26.2) y los algoritmos de seguridad modernos que aplica estrictamente el servidor SFTP de destino (como Red Hat 9 o Azure Blob Storage SFTP). Si recibes este error, puedes resolverlo actualizando Looker a la versión 26.2 o una posterior para que admita algoritmos SHA-2 modernos (como ecdsa-sha2-nistp256, rsa-sha2-256 y rsa-sha2-512). Como alternativa, configura el servidor SFTP de destino para que permita al menos una clave de host o un algoritmo de encriptación que admita tu versión actual de Looker.

  • El error OpenSSL::Cipher::CipherError. Error: authentication tag already generated by cipher puede ocurrir cuando se entregan datos con SFTP después de que Looker se actualizó a la versión 26.2.14 o posterior, o cuando tu instancia se conecta a servicios de host como Azure Blob Storage SFTP o a través de un proxy. Este error se debe a un problema conocido de JRuby durante la negociación de cifrado. Para resolver este error, restringe los algoritmos de encriptación (algoritmos de cifrado) que se permiten en el servidor SFTP de destino a aes256-ctr. Por ejemplo, edita el archivo sshd_config del servidor SFTP para agregar o restringir la directiva Ciphers: Ciphers aes256-ctr.

  • Si recibes el error Java::JavaLang::NullPointerExceptions cuando entregas datos a un servidor SFTP, es posible que se deba a un error en JRuby que impide el uso de algoritmos de curva elíptica (EC) o claves de host para conexiones SSH de Looker a destinos de SFTP. Para evitar problemas con el envío de datos a destinos de SFTP, no uses algoritmos de EC en los archivos ~/.ssh/config o /etc/ssh_config ni almacenes claves de host de EC en ~/.ssh en tu host de Looker.

  • El error Net::SFTP::StatusException (2, 'no such file') se produce si Looker no puede construir correctamente la ruta de destino en el servidor SFTP. Entre las causas comunes, se incluyen que el campo Dirección use una ruta de acceso relativa en lugar de una ruta de acceso absoluta, que al campo Dirección le falte una barra diagonal final (/) o que el nombre de la vista, el panel o la programación contenga espacios o caracteres especiales (como /) que causen fallas en la construcción de la ruta de acceso. Para resolver este error, sigue estos pasos:

    • Usa rutas de acceso absolutas: Accede al servidor SFTP, ejecuta pwd para recuperar la ruta de acceso absoluta completa y, luego, ingresa este valor en el campo Dirección de tu programa, asegurándote de que termine con una barra diagonal (/).
    • Quita los caracteres especiales: Quita las barras diagonales (/) de los nombres de las vistas, los paneles y los programas.
    • Usa nombres compatibles con máquinas: Cambia el nombre del programa para usar guiones bajos en lugar de espacios (por ejemplo, Report_Name).
  • El error Net::SSH::Exception. Error: could not settle on kex algorithm se produce cuando Looker y el servidor SFTP remoto no pueden acordar un algoritmo de intercambio de claves (KEX) compatible con ambos, por lo general, porque se usan algoritmos obsoletos en un lado. Para resolver este error, revisa los algoritmos de intercambio de claves que admite tu servidor SFTP y asegúrate de que se alineen con los algoritmos de KEX compatibles con Looker (como ecdh-sha2-nistp256, ecdh-sha2-nistp384 o ecdh-sha2-nistp521).

  • Si la entrega programada de SFTP falla con el error Net::SSH::Exception: could not settle on encryption_client algorithm, significa que tu servidor SFTP y Looker no pudieron acordar un algoritmo de encriptación compartido. Looker quitó la compatibilidad con algoritmos de cifrado más antiguos y menos seguros, como CBC (por ejemplo, aes256-cbc y 3des-cbc). Para resolver este error, proporciona este mensaje de error al administrador del servidor SFTP y pídele que actualice el archivo sshd_config del servidor para habilitar la compatibilidad con al menos uno de los algoritmos de encriptación y de intercambio de claves que son compatibles con Looker.