Copia de datos de HubSpot con Azure Data Factory o Synapse Analytics

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis integral para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y la creación de informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

En este artículo se explica cómo usar la actividad de copia en una canalización de Azure Data Factory o Synapse Analytics para copiar datos de HubSpot. El documento se basa en el artículo de introducción a la actividad de copia que describe información general de la actividad de copia.

Importante

La versión 2.0 del conector de HubSpot proporciona compatibilidad nativa mejorada con HubSpot. Si usa la versión 1.0 del conector de HubSpot en su solución, actualice el conector de HubSpot ya que la versión 1.0 está en la etapa de Fin de Soporte. La tubería fallará después del 22 de noviembre de 2025 si no se actualiza. Consulte esta sección para obtener más información sobre la diferencia entre la versión 2.0 y la versión 1.0.

Funcionalidades admitidas

Este conector HubSpot es compatible con las siguientes funcionalidades:

Funcionalidades admitidas	IR
Actividad de copia (origen/-)	1 2
Actividad de búsqueda	1 2

① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado

Para obtener una lista de los almacenes de datos que se admiten como orígenes y receptores, consulte la tabla de almacenes de datos admitidos.

El servicio proporciona un controlador integrado para habilitar la conectividad. Por lo tanto, no es necesario instalar manualmente ningún controlador mediante este conector.

El conector admite las versiones de Windows de este artículo.

Introducción

Para realizar la actividad de copia con una canalización, puede usar una de las siguientes herramientas o SDK:

Creación de un servicio vinculado en HubSpot mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado en HubSpot en la interfaz de usuario de Azure Portal.

Vaya a la pestaña "Administrar" de su área de trabajo de Azure Data Factory o Synapse y seleccione "Servicios vinculados"; a continuación, haga clic en "Nuevo":
- Azure Data Factory
- Azure Synapse
Busque HubSpot y seleccione el conector de HubSpot.
Configure los detalles del servicio, pruebe la conexión y cree el servicio vinculado.

Detalles de configuración del conector

En las secciones siguientes se proporcionan detalles sobre las propiedades que se usan para definir entidades de Data Factory específicas del conector de HubSpot.

Propiedades del servicio vinculado

El conector de HubSpot ahora admite la versión 2.0. Consulte esta sección para actualizar la versión del conector de HubSpot desde la versión 1.0. Para obtener los detalles de la propiedad, consulte las secciones correspondientes.

Versión 2.0
Versión 1.0

Versión 2.0

El servicio vinculado de HubSpot admite las siguientes propiedades cuando se aplica la versión 2.0:

Propiedad	Descripción	Obligatorio
type	La propiedad type debe establecerse en: HubSpot	Sí
version	Versión que especifique. El valor es `2.0`.	Sí
clientId	Identificador de cliente asociado a la aplicación Hubspot. Obtenga información sobre cómo crear una aplicación en HubSpot desde aquí.	Sí
clientSecret	Secreto de cliente asociado a la aplicación Hubspot. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault.	Sí
accessToken	Token de acceso que se obtiene al autenticar inicialmente la integración de OAuth. Obtenga información sobre cómo obtener el token de acceso con el identificador y el secreto de cliente desde aquí. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault.	Sí
refreshToken	Token de actualización que se obtiene al autenticar inicialmente la integración de OAuth. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault.	Sí
connectVia	El entorno de ejecución de integración que se usará para conectarse al almacén de datos. Si no se especifica ningún valor, la propiedad usa el entorno de ejecución de integración de Azure predeterminado.	No

Ejemplo:

{
    "name": "HubSpotLinkedService",
    "properties": {
        "type": "Hubspot",
        "version": "2.0",
        "typeProperties": {
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            },
            "accessToken": {
                "type": "SecureString",
                "value": "<accessToken>"
            },
            "refreshToken": {
                "type": "SecureString",
                "value": "<refreshToken>"
            }
        }
    }
}

Versión 1.0

El servicio vinculado HubSpot admite las siguientes propiedades cuando se aplica la versión 1.0:

Propiedad	Descripción	Obligatorio
type	La propiedad type debe establecerse en: HubSpot	Sí
clientId	Identificador de cliente asociado a la aplicación Hubspot. Obtenga información sobre cómo crear una aplicación en HubSpot desde aquí.	Sí
clientSecret	Secreto de cliente asociado a la aplicación Hubspot. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault.	Sí
accessToken	Token de acceso que se obtiene al autenticar inicialmente la integración de OAuth. Obtenga información sobre cómo obtener el token de acceso con el identificador y el secreto de cliente desde aquí. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault.	Sí
refreshToken	Token de actualización que se obtiene al autenticar inicialmente la integración de OAuth. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault.	Sí
useEncryptedEndpoints	Especifica si los puntos de conexión de origen de datos se cifran mediante HTTPS. El valor predeterminado es true.	No
useHostVerification	Especifica si se requiere que el nombre de host del certificado del servidor coincida con el nombre de host del servidor al conectarse a través de TLS. El valor predeterminado es true.	No
usePeerVerification	Especifica si se debe verificar la identidad del servidor al conectarse a través de TLS. El valor predeterminado es true.	No
connectVia	El entorno de ejecución de integración que se usará para conectarse al almacén de datos. Si no se especifica ningún valor, la propiedad usa el entorno de ejecución de integración de Azure predeterminado.	No

Ejemplo:

{
    "name": "HubSpotLinkedService",
    "properties": {
        "type": "Hubspot",
        "typeProperties": {
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            },
            "accessToken": {
                "type": "SecureString",
                "value": "<accessToken>"
            },
            "refreshToken": {
                "type": "SecureString",
                "value": "<refreshToken>"
            }
        }
    }
}

Propiedades del conjunto de datos

Si desea ver una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte el artículo sobre conjuntos de datos. En esta sección se proporciona una lista de las propiedades compatibles con el conjunto de datos de HubSpot.

Para copiar datos de HubSpot, establezca la propiedad type del conjunto de datos en HubspotObject. Se admiten las siguientes propiedades:

Propiedad	Descripción	Obligatorio
type	La propiedad type del conjunto de datos debe establecerse en: HubspotObject	Sí
tableName	Nombre de la tabla. Para la versión 2.0, el nombre de la tabla es `<HubSpot Category>.<Sub Category>.<Object Name>`, por ejemplo: `CRM.Commerce.Discounts`.	Sí para la versión 2.0. No para la versión 1.0 (si se especifica "query" en el origen de actividad)

Ejemplo

{
    "name": "HubSpotDataset",
    "properties": {
        "type": "HubspotObject",
        "typeProperties": {},
        "schema": [],        
        "linkedServiceName": {
            "referenceName": "<HubSpot linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

La versión 2.0 del conector admite las siguientes tablas de HubSpot:

Marketing.Campañas
Marketing.Emails.Marketing_Emails
Marketing.Suscripciones
Conversations.Inbox___Messages
CMS.Authores
CMS.Blog_Settings
CMS.Content_Audit
CMS.Dominios
CMS. Hubdb
CMS.Páginas
CMS.Posts
CMS.Site_Search
CMS. Etiquetas
CMS.Url_Redirects
CRM.Commerce.Carts
CRM.Comercio.Descuentos
CRM.Commerce.Fees
CRM.Commerce.Facturas
CRM.Commerce.Orders
CRM.Commerce.Quotes
CRM.Commerce.Subscriptions
CRM.Commerce.Taxes
CRM.Compromisos.Llamadas
CRM.Compromisos.Comunicaciones
CRM. Compromisos.Correos Electrónicos
CRM.Compromisos.Reuniones
CRM.Compromisos.Notas
CRM.Engagements.Postal_Mail
CRM.Engagements.Tasks
CRM.Objetos.Compañías
CRM.Objects.Contacts
CRM.Objects.Deals
CRM.Objects.Feedback_Submissions
CRM.Objects.Goal_Targets
CRM.Objects.Leads
CRM.Objects.Elementos_de_línea
CRM.Objects.Products
CRM.Objects.Tickets
CRM.Owners

Propiedades de la actividad de copia

Si desea ver una lista completa de las secciones y propiedades disponibles para definir actividades, consulte el artículo sobre canalizaciones. En esta sección se proporciona una lista de las propiedades compatibles con el origen de HubSpot.

HubspotSource como origen

Para copiar datos de HubSpot, establezca el tipo de origen de la actividad de copia en HubspotSource. Se admiten las siguientes propiedades en la sección source de la actividad de copia:

Propiedad	Descripción	Obligatorio
type	La propiedad type del origen de la actividad de copia debe establecerse en: HubspotSource.	Sí
Query	Use la consulta SQL personalizada para leer los datos. Por ejemplo: `"SELECT * FROM Companies where Company_Id = xxx"`.	No (si se especifica "tableName" en el conjunto de datos)

Nota:

query no se admite en la versión 2.0.

Ejemplo:

"activities":[
    {
        "name": "CopyFromHubspot",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<HubSpot input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "HubspotSource",
                "query": "SELECT * FROM Companies where Company_Id = xxx"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Asignación de tipos de datos para HubSpot

Al copiar datos de HubSpot, las siguientes asignaciones se aplican de los tipos de datos de HubSpot a los tipos de datos internos utilizados por el servicio. Para más información acerca de la forma en que la actividad de copia asigna el tipo de datos y el esquema de origen al receptor, consulte el artículo sobre asignaciones de tipos de datos y esquema.

Tipo de datos de HubSpot	Tipo de datos de servicio provisional (para la versión 2.0)	Tipo de datos de servicio provisional (para la versión 1.0)
bool	Boolean	Boolean
boolean	Boolean	Boolean
enumeración	String	String
cuerda / cadena	String	String
object_coordinates	String	String
número_de_teléfono	String	String
json	String	String
date	DateTime	No está soportado.
datetime	DateTime	DateTime
number	Decimal	Decimal
entero	Integer	Integer
objeto	String	No está soportado.

Propiedades de la actividad de búsqueda

Para obtener información detallada sobre las propiedades, consulte Actividad de búsqueda.

Ciclo de vida y actualización del conector de HubSpot

En la tabla siguiente se muestran la fase de lanzamiento y los registros de cambios para diferentes versiones del conector de HubSpot:

Versión	Fase de versión	Registro de cambios
Versión 1.0	Finalización del soporte	/
Versión 2.0	Disponibilidad general	• El valor `tableName` es `<HubSpot Category>.<Sub Category>.<Object Name>`, por ejemplo: `CRM.Commerce.Discounts`. • La fecha se lee como un tipo de datos DateTime. • El objeto se lee como un tipo de datos String. •`useEncryptedEndpoints`, `useHostVerification`, `usePeerVerification` no se admiten en el servicio vinculado. • `query` no está permitida. • Admitir tablas específicas de HubSpot. En la lista de tablas admitidas, vaya a Propiedades del conjunto de datos.

Actualización del conector de HubSpot de la versión 1.0 a la versión 2.0

En la página Editar servicio vinculado , seleccione la versión 2.0 y configure el servicio vinculado haciendo referencia a las propiedades del servicio vinculado versión 2.0.
La asignación de tipos de datos para la versión 2.0 del servicio vinculado de HubSpot es diferente de la de la versión 1.0. Para obtener información sobre la asignación de tipos de datos más reciente, consulte Asignación de tipos de datos para HubSpot.
query solo se admite en la versión 1.0. Debe usar tableName en lugar de query en la versión 2.0.
Tenga en cuenta que la versión 2.0 admite tablas específicas de HubSpot. En la lista de tablas admitidas, vaya a Propiedades del conjunto de datos.

Para obtener una lista de los almacenes de datos que admite la actividad de copia como orígenes y receptores, consulte Almacenes de datos compatibles.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-11-05

Compartir a través de

Copia de datos de HubSpot con Azure Data Factory o Synapse Analytics

Funcionalidades admitidas

Introducción

Creación de un servicio vinculado en HubSpot mediante la interfaz de usuario

Detalles de configuración del conector

Propiedades del servicio vinculado

Versión 2.0

Versión 1.0

Propiedades del conjunto de datos

Propiedades de la actividad de copia

HubspotSource como origen

Asignación de tipos de datos para HubSpot

Propiedades de la actividad de búsqueda

Ciclo de vida y actualización del conector de HubSpot

Actualización del conector de HubSpot de la versión 1.0 a la versión 2.0

Contenido relacionado

Comentarios

Recursos adicionales