Copiar dados do Marketo utilizando a Azure Data Factory (Preview)

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como utilizar a Atividade de Cópia na Fábrica de Dados Azure para copiar dados do Marketo. Baseia-se no artigo de visão geral da atividade de cópia que apresenta uma visão geral da atividade da cópia.

Importante

Este conector encontra-se atualmente em pré-visualização. Pode experimentar e dar-nos feedback. Se quiser realizar uma dependência em conectores de pré-visualização na sua solução, contacte o Suporte do Azure.

Capacidades suportadas

Este conector Marketo é suportado para as seguintes atividades:

Pode copiar dados do Marketo para qualquer loja de dados de lavatórios suportados. Para obter uma lista de lojas de dados suportadas como fontes/pias pela atividade de cópia, consulte a tabela de lojas de dados suportadas.

Atualmente, a instância do Marketo que está integrada com CRM externo não é suportada.

Nota

Este conector Marketo é construído em cima da API Marketo REST. Esteja ciente de que o Marketo tem um limite de pedido simultâneo no lado do serviço. Se acertar erros dizendo "Erro ao tentar utilizar a API DE REST: Limite de taxa máxima '100' ultrapassado em '20' segs (606)" ou "Erro enquanto tenta usar a API REST: Limite de acesso simultâneo atingido (615)", considere reduzir a atividade de cópia simultânea para reduzir o número de pedidos ao serviço.

Introdução

Para realizar a atividade Copy com um pipeline, pode utilizar uma das seguintes ferramentas ou SDKs:

As seguintes secções fornecem detalhes sobre propriedades que são usadas para definir entidades da Data Factory específicas do conector Marketo.

Propriedades de serviço ligadas

As seguintes propriedades são suportadas para o serviço ligado ao Marketo:

Propriedade Descrição Obrigatório
tipo O tipo de propriedade deve ser definido para: Marketo Yes
endpoint O ponto final do servidor Marketo. (isto é, 123-ABC-321.mktorest.com) Yes
clientId A identificação do cliente do seu serviço Marketo. Yes
segredo de clientes O segredo do cliente do seu serviço Marketo. Marque este campo como um SecureString para armazená-lo de forma segura na Data Factory, ou fazer referência a um segredo armazenado no Cofre da Chave Azure. Yes
useEncryptedEndpoints Especifica se os pontos finais de origem de dados são encriptados usando HTTPS. O valor predefinido é true. No
useHostVerification Especifica se deve exigir que o nome do anfitrião no certificado do servidor corresponda ao nome de anfitrião do servidor ao ligar o TLS. O valor predefinido é true. No
usePeerVerificação Especifica se deve verificar a identidade do servidor ao ligar o TLS. O valor predefinido é true. No

Exemplo:

{
    "name": "MarketoLinkedService",
    "properties": {
        "type": "Marketo",
        "typeProperties": {
            "endpoint" : "123-ABC-321.mktorest.com",
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            }
        }
    }
}

Dataset properties (Propriedades do conjunto de dados)

Para obter uma lista completa de secções e propriedades disponíveis para definir conjuntos de dados, consulte o artigo conjuntos de dados. Esta secção fornece uma lista de propriedades suportadas pelo conjunto de dados do Marketo.

Para copiar dados do Marketo, defina o tipo de propriedade do conjunto de dados para o MarketoObject. As seguintes propriedades são suportadas:

Propriedade Descrição Obrigatório
tipo A propriedade tipo do conjunto de dados deve ser definida para: MarketoObject Yes
tableName O nome da mesa. Não (se for especificada "consulta" na fonte de atividade)

Exemplo

{
    "name": "MarketoDataset",
    "properties": {
        "type": "MarketoObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Marketo linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Propriedades da atividade Copy

Para obter uma lista completa de secções e propriedades disponíveis para definir atividades, consulte o artigo Pipelines. Esta secção fornece uma lista de imóveis suportados por fonte do Marketo.

Marketo como fonte

Para copiar dados do Marketo, desagrafe o tipo de origem na atividade de cópia ao MarketoSource. As seguintes propriedades são suportadas na secção fonte de origem da atividade de cópia:

Propriedade Descrição Obrigatório
tipo O tipo de propriedade da fonte de atividade de cópia deve ser definido para: MarketoSource Yes
consulta Utilize a consulta SQL personalizada para ler dados. Por exemplo: "SELECT * FROM Activitiy_Types". Não (se for especificado "tableName" no conjunto de dados)

Exemplo:

"activities":[
    {
        "name": "CopyFromMarketo",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Marketo input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "MarketoSource",
                "query": "SELECT top 1000 * FROM Activitiy_Types"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Propriedades de atividade de procura

Para obter detalhes sobre as propriedades, consulte a atividade de Lookup.

Passos seguintes

Para obter uma lista de lojas de dados suportadas como fontes e sumidouros pela atividade de cópia na Azure Data Factory, consulte lojas de dados suportadas.