Transformar dados do Zendesk (versão prévia) usando o Azure Data Factory ou o Synapse Analytics

Artigo
01/05/2024

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!

Este artigo descreve como usar o Fluxo de Dados para transformar dados do Zendesk (versão prévia). Para saber mais, leia o artigo introdutório do Azure Data Factory ou do Azure Synapse Analytics.

Importante

Atualmente, esse conector está em versão prévia. Você pode experimentá-lo e oferecer comentários. Se você quiser uma dependência de conectores em versão prévia em sua solução, entre em contato com suporte do Azure.

Funcionalidades com suporte

Há suporte a este conector do ZenDesk para as seguintes funcionalidades:

Funcionalidades com suporte	IR
Fluxo de dados de mapeamento (origem/-)	2

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

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

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

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

Navegue até a guia Gerenciar no workspace do Azure Data Factory ou do Synapse e selecione Serviços Vinculados. Depois, selecione Novo:
- Azure Data Factory
- Azure Synapse
Procure Zendesk (versão prévia) e selecione o conector do Zendesk (versão prévia).
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 informações sobre as propriedades que são usadas para definir entidades dos pipelines do Data Factory e do Azure Synapse específicas do Zendesk.

Propriedades do serviço vinculado

Há suporte para as seguintes propriedades no serviço vinculado do Zendesk:

Propriedade	Descrição	Obrigatório
type	A propriedade type precisa ser definida como Zendesk.	Sim
url	A URL base do serviço do Zendesk.	Sim
authenticationType	Tipo de autenticação usado para se conectar ao serviço do Zendesk. Os valores permitidos são básica e token. Consulte respectivamente as seções correspondentes abaixo em mais propriedades e exemplos.	Sim

Autenticação Básica

Defina a authenticationType na propriedade Básica. Além das propriedades genéricas descritas na seção anterior, especifique as seguintes propriedades:

Propriedade	Descrição	Obrigatório
userName	O nome de usuário usado para fazer logon no Zendesk.	Sim
password	Especifique uma senha para a conta de usuário que você especificou para o nome de usuário. Marque esse campo como SecureString para armazená-lo com segurança. Você também pode referenciar um segredo armazenado no Azure Key Vault.	Sim

Exemplo:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Autenticação por token

Defina a authenticationType na propriedade token. Além das propriedades genéricas descritas na seção anterior, especifique as seguintes propriedades:

Propriedade	Descrição	Obrigatório
apiToken	Especifique um token de API para o Zendesk. Marque esse campo como SecureString para armazená-lo com segurança. Você também pode referenciar um segredo armazenado no Azure Key Vault.	Sim

Exemplo:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Propriedades do fluxo de dados de mapeamento

Ao transformar dados do fluxo de dados de mapeamento, você pode ler tabelas do Zendesk. Para saber mais, confira a transformação de origem nos fluxos de dados de mapeamento. Você só pode usar um conjunto de dados em linha como o tipo de origem.

Transformação de origem

A tabela abaixo lista as propriedades compatíveis com uma fonte do Zendesk. Você pode editar essas propriedades na guia Opções de origem.

Nome	Descrição	Obrigatório	Valores permitidos	Propriedade do script do Fluxo de Dados
Entidade	O nome lógico da entidade do Zendesk.	Sim quando usar o modo embutido	`activities` `group_memberships` `groups` `organizations` `requests` `satisfaction_ratings` `sessions` `tags` `targets` `ticket_audits` `ticket_fields` `ticket_metrics` `tickets` `triggers` `users` `views`	entidade

Exemplos de script de origem do Zendesk

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'zendesk',
	format: 'rest',
	entity: 'tickets') ~> ZendeskSource

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