Snowflake: insertar fila

Usa Snowflake: insertar fila para escribir una fila en una tabla de Snowflake desde un paso de un journey, a través de la API de SQL, utilizando un token de acceso programático. Los valores de las columnas viajan como parámetros enlazados, no dentro del texto de la declaración SQL, por lo que un valor no puede salirse de su columna y cambiar lo que hace la declaración. Este punto se autentica con su propio token de acceso programático. No utiliza ninguna integración a nivel de cuenta configurada en otra parte en Ajustes.

Usos típicos:

• Alimentar una tabla de informes: inserta una fila por cada paso del journey alcanzado, para un panel de control o una consulta programada posterior.
• Registrar eventos a medida que ocurren: escribe datos brutos del journey directamente en el almacén de datos en lugar de esperar un proceso por lotes.
• Unir con datos existentes: inserta un valor de dispositivo o de Tag que tus tablas de Snowflake puedan unir con tus propios conjuntos de datos.

Precaución

Un token de acceso programático tiene una vida útil de 15 días por defecto. El punto comienza a fallar el día que expira, sin previo aviso. Pon un recordatorio en tu propio calendario para rotarlo, o las solicitudes dejarán de funcionar silenciosamente dos semanas después de que lo configures.

Configurar el punto

1. Arrastra Snowflake: insertar fila desde la sección Integraciones del panel izquierdo hacia el lienzo.
2. Haz doble clic en el punto e introduce un Nombre del paso.
3. En Host de la cuenta, introduce el host de tu cuenta de Snowflake desde su URL, por ejemplo ab12345.eu-central-1.snowflakecomputing.com. No incluyas https:// ni una barra inclinada al final. Pushwoosh añade https:// y la ruta de la API por sí mismo.

4. En Token de acceso programático, introduce un token de Snowsight > tu usuario > Ajustes > Autenticación > Tokens de acceso programáticos. Se almacena enmascarado, como una cabecera secreta de webhook.

5. En Tabla, introduce la tabla de destino como TABLE, SCHEMA.TABLE, o DATABASE.SCHEMA.TABLE, usando solo letras, dígitos y guiones bajos. Este punto no solicita un almacén, base de datos o esquema por separado: un TABLE simple se resuelve contra la base de datos y el esquema que el usuario del token tenga por defecto, y un valor DATABASE.SCHEMA.TABLE los anula.

6. En Columnas, añade una fila por cada columna de la tabla en la que escribir. Introduce el nombre de la columna y el valor. Los nombres no deben estar vacíos y deben ser únicos, y siguen la misma regla de letras/dígitos/guion bajo que Tabla. Un valor puede ser texto fijo o una macro de viajero como {{tag:Name}}, las mismas macros que en el cuerpo de un Webhook. O haz clic en Insertar valor dinámico para elegir un atributo que un paso anterior en este journey haya producido, por ejemplo, una respuesta de un LLM o un valor de Webhook mapeado.

Ejemplo

Con Tabla configurada como PW.PUBLIC.TRAVELERS, configurar Columnas con DEVICE_ID y el ID de dispositivo del viajero ({{device:hwid}}) inserta una fila en la columna DEVICE_ID de esa tabla.

7. Haz clic en Guardar.

Respuesta

El viajero continúa hacia cualquier paso que conectes a continuación en el lienzo.

Atributos después de que el paso se ejecute

Atributo	Qué contiene
snowflake_statement_handle	El manejador (handle) de la declaración enviada

Cómo usarlo en pasos posteriores

El viajero ya ha continuado al siguiente paso independientemente de este atributo. Guárdalo en una Tag con Actualizar perfil de usuario si necesitas comprobar el estado de esa declaración más tarde a través de la propia API de Snowflake.

Fallos y respuestas inesperadas

Una solicitud fallida elimina al viajero del journey. Consulta Errores y solicitudes fallidas.

Escenario de ejemplo: Transmitir la actividad del journey a Snowflake

Un equipo quiere la actividad del journey en la misma tabla de Snowflake que sus propios informes ya consultan.

1. Añade Snowflake: insertar fila justo después del paso que quieres registrar. Configura Tabla como PW.PUBLIC.TRAVELERS. En Columnas, establece DEVICE_ID en {{device:hwid}}.
2. Haz clic en Guardar.

Una vez que esto se ejecute, la fila se insertará en la misma tabla de la que ya leen los informes de Snowflake del equipo.