Exportar datos de HubSpot a Amazon Redshift

Resumen

Exporta objetos, asociaciones y eventos del CRM de HubSpot a Amazon Redshift mediante la aplicación de Amazon Redshift disponible en el mercado de HubSpot. Desde HubSpot puedes seleccionar los datos que deseas exportar, configurar una programación de sincronización y supervisar la actividad de sincronización.

En este artículo se explica cómo instalar y conectar la aplicación, configurar una sincronización para la exportación de datos y supervisar o gestionar dicha sincronización.

Ten en cuenta que, si eres superadministrador, puedes inscribir tu cuenta en la versión beta de la integración mejorada con Amazon Redshift.

Antes de empezar

Comprender los requisitos

Asegúrate de que dispones de lo siguiente:

• Un rol de AWS Identity and Access Management (IAM) vinculado a tu cuenta de HubSpot y configurado para acceder a tu cuenta de AWS.
• Un clúster de Amazon Redshift aprovisionado o un grupo de trabajo sin servidor al que HubSpot pueda acceder.
• Un depósito de Amazon S3 para almacenar temporalmente archivos Parquet. El bucket debe estar en la misma región de AWS que tu clúster de Redshift o tu grupo de trabajo sin servidor. 
• HubSpot copia los archivos Parquet temporales al bucket de almacenamiento temporal de Amazon S3 configurado y no los elimina. Para eliminar los archivos más antiguos y gestionar los costes de almacenamiento, crea una regla de ciclo de vida de S3 en tu cuenta de AWS.
• Un administrador de Redshift que pueda ejecutar una concesión de permisos SQL de una sola vez en la base de datos de destino.
• Acceso a las consolas de HubSpot y AWS. Se recomienda abrirlas en pestañas distintas.

Comprender las limitaciones y consideraciones

• Cada sincronización genera una instantánea completa de los datos seleccionados.
• Cada sincronización sustituye la tabla de destino. Los permisos o ajustes a nivel de tabla que se añadan en Redshift no se conservan entre sincronizaciones.
• Puedes controlar la cantidad de datos que se exportan seleccionando qué objetos, asociaciones y eventos deseas incluir.
• Si falla una sincronización, la siguiente sincronización programada vuelve a intentar automáticamente la sincronización completa.

Instala y conecta la aplicación Amazon Redshift

1. En el mercado de aplicaciones de HubSpot, abre la ficha de la aplicación Amazon Redshift.
2. Selecciona el rol de AWS vinculado a tu cuenta de HubSpot.
3. Haz clic en Instalar.
4. Haz clic en Siguiente.
5. Crea un rol de IAM de AWS que esté vinculado a tu cuenta de HubSpot y configurado para acceder a tu cuenta de AWS.
6. Introduce el nombre de recurso de Amazon (ARN) del rol.
7. Haz clic en «Conectar a Amazon Redshift».

Configura tu rol de AWS

HubSpot utiliza el rol de AWS conectado para escribir archivos Parquet temporales en tu bucket de S3 de preparación y cargar los archivos en Redshift.

1. En el campo «URL del bucket de S3» , introduce la URL del bucket de S3 que HubSpot utilizará para almacenar temporalmente los archivos Parquet.

Puedes incluir un prefijo en la URL para limitar el acceso a una ruta concreta dentro del depósito. El bucket debe estar en la misma región de AWS que tu clúster de Redshift o tu grupo de trabajo sin servidor.

Nota: Por diseño, HubSpot copia los archivos Parquet al bucket de almacenamiento temporal de S3 configurado y no los elimina. Crea una regla de ciclo de vida de S3 en AWS para eliminar automáticamente los archivos más antiguos.

2. Selecciona tu tipo de implementación de Redshift en el menú desplegable:
   • Redshift Serverless
   • Clúster aprovisionado
3. Actualiza el rol de AWS asociado con la política de permisos correspondiente a tu tipo de implementación:
   • Redshift Serverless: introduce el ARN de tu grupo de trabajo. HubSpot generará una política que contenga el ARN. Copia la política y adjúntala a la función de AWS asociada.
   • Clúster aprovisionado: copia la plantilla de política. Sustituir YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_ID, y YOUR_DATABASE por los valores de tu cuenta de AWS y, a continuación, asigne la política al rol de AWS asociado.
4. En AWS IAM, abre el rol vinculado a HubSpot.
5. Asigna la política de permisos generada al rol o crea una política integrada con el contenido de la política.

6. En el mismo rol de AWS IAM, actualiza la política de confianza con la declaración generada por HubSpot.

HubSpot genera una declaración de política de confianza diferente en función del tipo de implementación de Redshift que hayas seleccionado.

Asociar el rol de AWS a Redshift

En Amazon Redshift, asocia el mismo rol de AWS que has actualizado en la sección anterior a tu configuración de Redshift.

• Redshift Serverless: abre la página de configuración del espacio de nombres que utilizas con HubSpot. En la pestaña «Seguridad y cifrado », haz clic en «Gestionar roles de IAM» y, a continuación, selecciona «Asociar roles de IAM».
• Clúster aprovisionado: abre tu clúster, haz clic en «Acciones» y selecciona «Gestionar roles de IAM» > Asociar roles de IAM.

Conceder permisos a Redshift

1. En HubSpot, selecciona la base de datos de destino.
2. Pide a un administrador de Redshift que ejecute el script SQL en la base de datos seleccionada.

HubSpot utiliza este permiso para crear un esquema para el destino durante la sincronización.

3. Haz clic en «Probar conexión».
4. Si la prueba de conexión se realiza correctamente, haz clic en «Siguiente».

Configurar la sincronización de la exportación de datos

1. Selecciona las fuentes de datos que deseas exportar.
2. Selecciona las tablas de objetos, asociaciones y eventos que desees incluir.
3. Configura la frecuencia de sincronización y la hora de inicio.
4. Haz clic en «Iniciar sincronización».

Cada proceso de sincronización exporta una instantánea completa de los datos seleccionados a Amazon Redshift.

Supervisar y gestionar la sincronización

Desde la página de detalles de la sincronización, puedes consultar la siguiente información:

• Estado de la sincronización.
• Hora de la última sincronización.
• Errores.
• Actividad de sincronización.
• Historial de sincronizaciones.

Para abrir la página de detalles de la sincronización:

1. En tu cuenta de HubSpot, ve a «Gestión de datos » > «Integración de datos».
2. En la pestaña «Sincronizaciones de aplicaciones », busca las sincronizaciones de la aplicación Amazon Redshift.
3. Haz clic en la sincronización de Amazon Redshift que quieras revisar.

Desde la página de detalles de la sincronización, también puedes realizar las siguientes acciones:

• Haz clic en «Pausa » para detener la sincronización.
• Haz clic en «Archivar » para archivar la sincronización.
• Haz clic en «Sincronizar ahora » para iniciar manualmente una sincronización.

Estados de sincronización

Resolver los errores de sincronización

Cuando falla una sincronización:

• La sincronización muestra el estado «Fallida » en HubSpot.
• Los detalles por tabla muestran qué tablas se han ejecutado correctamente y cuáles han fallado.
• La próxima sincronización programada volverá a intentar automáticamente la sincronización completa.
• Puedes hacer clic en «Sincronizar ahora » para iniciar manualmente otra sincronización.