Copiar dados do HubSpot usando o Azure Data Factory ou o Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como usar a Atividade de Cópia em um pipeline do Azure Data Factory ou do Synapse Analytics para copiar dados do HubSpot. Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.

Funcionalidades com suporte

Este conector HubSpot é suportado para as seguintes capacidades:

① Runtime de integração do Azure ② Runtime de integração auto-hospedado

Para obter uma lista de armazenamentos de dados com suporte como fontes/coletores, consulte a tabela armazenamentos de dados com suporte.

O serviço fornece um driver interno para habilitar a conectividade, portanto, não é necessário instalar manualmente qualquer driver usando esse conector.

O conector dá suporte para as versões do Windows neste artigo.

Introdução

Para executar a atividade de cópia com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:

• Ferramenta Copiar Dados
• Portal do Azure
• .NET SDK
• SDK Python
• Azure PowerShell
• REST API
• modelo Azure Resource Manager

Criar um serviço vinculado ao HubsPot usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado ao HubSpot na interface do usuário do portal Azure.

1. Navegue até a guia Gerenciar no workspace do Azure Data Factory ou do Synapse e selecione Serviços Vinculados e clique em Novo:

   • Fábrica de dados do Azure
   • Azure Synapse

   

2. Pesquise por HubSpot e selecione o conector do HubSpot.

   

3. Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

   

Detalhes da configuração do conector

As seções a seguir fornecem detalhes sobre as propriedades usadas para definir entidades do Data Factory específicas ao conector de HubSpot.

Propriedades do serviço vinculado

O conector HubSpot agora dá suporte à versão 2.0. Consulte esta seção para atualizar a versão do conector HubSpot da versão 1.0. Para obter detalhes sobre as propriedades, consulte as seções correspondentes.

• Versão 2.0
• versão 1.0

Versão 2.0

O serviço vinculado do HubSpot dá suporte às seguintes propriedades ao aplicar a versão 2.0:

Exemplo:

{
    "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>"
            }
        }
    }
}

Versão 1.0

O serviço vinculado do HubSpot dá suporte às seguintes propriedades ao aplicar a versão 1.0:

Exemplo:

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

Propriedades do conjunto de dados

Para obter uma lista completa das seções e propriedades disponíveis para definir os conjuntos de dados, confira o artigo sobre conjuntos de dados. Esta seção fornece uma lista das propriedades com suporte pelo conjunto de dados de HubSpot.

Para copiar dados de HubSpot, defina a propriedade type do conjunto de dados como HubspotObject. Há suporte para as seguintes propriedades:

Exemplo

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

O conector versão 2.0 dá suporte às seguintes tabelas HubSpot:

• Marketing.Campanhas
• Marketing.Emails.Marketing_Emails
• Marketing.Assinaturas
• Conversas.Caixa de Entrada___Mensagens
• CMS.Autores
• CMS.Blog_Settings
• CMS.Content_Audit
• CMS.Domínios
• CMS. Hubdb
• CMS.Páginas
• CMS.Posts
• CMS.Site_Search
• CMS.Tags
• CMS.Url_Redirects
• CRM.Commerce.Carts
• CRM.Commerce.Discounts
• CRM.Commerce.Fees
• CRM.Commerce.Invoices
• CRM.Commerce.Orders
• CRM.Commerce.Quotes
• CRM.Commerce.Subscriptions
• CRM.Comércio.Impostos
• CRM.Engagements.Calls
• CRM.Engagements.Communications
• CRM.Engajamentos.Emails
• CRM.Interações.Reuniões
• CRM.Engagements.Notes
• CRM.Engagements.Postal_Mail
• CRM.Engagements.Tasks
• CRM.Objects.Companies
• CRM.Objects.Contacts
• CRM.Objects.Deals
• CRM.Objects.Feedback_Submissions
• CRM.Objects.Goal_Targets
• CRM.Objects.Leads
• CRM.Objetos.Itens_de_Linha
• CRM.Objects.Products
• CRM.Objects.Tickets
• CRM.Proprietários

Propriedades da atividade de cópia

Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines. Esta seção fornece uma lista das propriedades com suporte pela fonte de HubSpot.

HubspotSource como fonte

Para copiar dados de HubSpot, defina o tipo de fonte na atividade de cópia como HubspotSource. As propriedades a seguir têm suporte na seção source da atividade de cópia:

Exemplo:

"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>"
            }
        }
    }
]

Mapeamento de tipo de dados para HubSpot

Ao copiar dados do HubSpot, os seguintes mapeamentos se aplicam entre os tipos de dados do HubSpot e os tipos de dados internos usados pelo serviço. Para saber mais sobre como a atividade Copy mapeia o tipo de dados e esquema de origem para o coletor, consulte Mapeamentos de tipo de dados e esquema.

Pesquisar propriedades de atividade

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.

Ciclo de vida e atualização do conector HubSpot

A tabela a seguir mostra o estágio de lançamento e os logs de alteração para versões diferentes do conector HubSpot:

Atualizar o conector hubSpot da versão 1.0 para a versão 2.0

1. Na página Editar serviço vinculado , selecione a versão 2.0 e configure o serviço vinculado referindo-se às propriedades do serviço vinculado versão 2.0.

2. O mapeamento de tipo de dados para o serviço vinculado HubSpot versão 2.0 é diferente do da versão 1.0. Para saber mais sobre o mapeamento de tipo de dados mais recente, confira Mapeamento de tipo de dados para HubSpot.

3. query só tem suporte na versão 1.0. Você deve usar o tableName em vez de query na versão 2.0.

4. Observe que a versão 2.0 dá suporte a tabelas HubSpot específicas. Para a lista de tabelas com suporte, acesse as propriedades do conjunto de dados.

Conteúdo relacionado

Para obter uma lista de armazenamentos de dados com suporte como coletores e fontes da atividade de cópia, confira os armazenamentos de dados com suporte.