Almacenar eventos de Twilio Segment
Información general
Esta solución escucha eventos de Twilio Segment y escribe datos en una instancia de Teradata Vantage. El ejemplo utiliza Google Cloud, pero se puede traducir a cualquier plataforma en la nube.
Arquitectura
En esta solución, Twilio Segment escribe datos de eventos sin procesar en Google Cloud Pub/Sub. Pub/Sub reenvía eventos a una aplicación Cloud Run. La aplicación Cloud Run escribe datos en una base de datos Teradata Vantage. Es una solución sin servidor que no requiere asignación ni administración de ninguna máquina virtual.
Despliegue
Prerrequisitos
- Una cuenta de Google Cloud. Si no tiene una cuenta, puede crear una en https://console.cloud.google.com/.
gcloud
instalado. Consulte https://cloud.google.com/sdk/docs/install.- Una instancia de Teradata Vantage con la que Google Cloud Run pueda comunicarse.
Si necesita una instancia de prueba de Vantage, puede obtener una de forma gratuita en https://clearscape.teradata.com
Construir e implementar
- Clone el repositorio de muestra:
-
El repositorio contiene el archivo
segment.sql
que configura la base de datos, el script en su base de datos Vantage usando su IDE SQL favorito, Estudio Teradata o una herramienta de línea de comandos llamadabteq
(descarga para Windows, Linux, macOS. El script SQL creará una nueva base de datos llamadaSegment
y un conjunto de tablas para almacenar eventos de segmento. -
Establezca el proyecto y la región predeterminados:
- Recupere la identificación del proyecto y el número. Lo necesitaremos en pasos posteriores:
- Habilite los servicios requeridos de Google Cloud:
- Cree la aplicación:
- Defina una clave API que compartirá con Segment. Guarde la clave API en Google Cloud Secret Manager:
- La aplicación que escribe datos de segmento en Vantage utilizará Cloud Run. Primero debemos permitir que Cloud Run acceda a los secretos:
- Implemente la aplicación en Cloud Run (reemplace
<VANTAGE_HOST>
con el nombre de host o IP de su base de datos Teradata Vantage). La segunda declaración de exportación guarda la URL del servicio tal como la necesitamos para comandos posteriores:
- Crea un tema de Pub/Sub que recibirá eventos del segmento:
- Crea una cuenta de servicio que Pub/Sub utilizará para invocar la aplicación Cloud Run:
- Otorgue permiso a la cuenta de servicio para invocar Cloud Run:
- Permita que Pub/Sub cree tokens de autenticación en su proyecto:
- Crea una suscripción Pub/Sub con la cuenta de servicio:
-
Permita que Segment publique en su tema. Para hacerlo, asigne el rol
pubsub@segment-integrations.iam.gserviceaccount.com
Pub/Sub Publisher
en su proyecto en https://console.cloud.google.com/cloudpubsub/topic/list. Consulte el Manual de segmentos para obtener más detalles. -
Configure su Google Cloud Pub/Sub como destino en Segment. Utilice el tema completo
projects/<PROJECT_ID>/topics/segment-events
y asigne todos los tipos de eventos de segmento (usando el carácter*
) al tema.
Pruébalo
- Utilice la funcionalidad Probador de eventos de Segment para enviar una carga útil de muestra al tema. Verifique que los datos de muestra se hayan almacenado en Vantage.
Limitaciones
- El ejemplo muestra cómo implementar la aplicación en una sola región. En muchos casos, esta configuración no garantiza suficiente tiempo de actividad. La aplicación Cloud Run debe implementarse en más de una región detrás de un Global Load Balancer.
Resumen
Este tutorial demuestra cómo enviar eventos de Segment a Teradata Vantage. La configuración reenvía eventos de Segment a Google Cloud Pub/Sub y luego a una aplicación Cloud Run. La aplicación escribe datos en Teradata Vantage.
Lectura adicional
Si tiene alguna pregunta o necesita más ayuda, visite nuestro foro de la comunidad donde podrá obtener ayuda e interactuar con otros miembros de la comunidad.