Transformar dados no Zendesk (Visualização) usando o Azure Data Factory ou o Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

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

Este artigo descreve como usar o Data Flow para transformar dados no Zendesk (Visualização). Para saber mais, leia o artigo introdutório do Azure Data Factory ou do Azure Synapse Analytics.

Importante

Este conector está atualmente em pré-visualização. Você pode experimentá-lo e nos dar 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 Zendesk é suportado para os seguintes recursos:

Capacidades suportadas	IR
Mapeando o fluxo de dados (fonte/-)	(1)

(1) Tempo de execução de integração do Azure (2) Tempo de execução de integração auto-hospedado

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

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.

1. Navegue até a guia Gerenciar em seu espaço de trabalho do Azure Data Factory ou Synapse e selecione Serviços Vinculados e, em seguida, selecione Novo:

   Fábrica de Dados do Azure

   

   Azure Synapse

   

2. Procure Zendesk (Preview) e selecione o conector Zendesk (Preview).

   

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

   

Detalhes de configuração do conector

As seções a seguir fornecem informações sobre propriedades usadas para definir entidades de pipeline do Data Factory e do Synapse específicas do Zendesk.

Propriedades do serviço vinculado

As seguintes propriedades são suportadas para o serviço vinculado Zendesk:

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

Autenticação básica

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

Property	Descrição	Obrigatório
nome de utilizador	O nome de usuário usado para fazer login no Zendesk.	Sim
password	Especifique uma senha para a conta de usuário especificada para o nome de usuário. Marque este campo como SecureString para armazená-lo com segurança. Ou, você pode fazer referência a um segredo armazenado no Cofre da Chave do Azure.	Sim

Exemplo:

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

Autenticação de token

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

Property	Descrição	Obrigatório
apiToken	Especifique um token de API para o Zendesk. Marque este campo como SecureString para armazená-lo com segurança. Ou, você pode fazer referência a um segredo armazenado no Cofre da Chave do Azure.	Sim

Exemplo:

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

Mapeando propriedades de fluxo de dados

Ao transformar dados em mapeamento de fluxo de dados, você pode ler tabelas do Zendesk. Para obter mais informações, consulte a transformação de origem no mapeamento de fluxos de dados. Você só pode usar um conjunto de dados embutido como tipo de origem.

Transformação da fonte

A tabela abaixo lista as propriedades suportadas pelo Zendesk source. Você pode editar essas propriedades na guia Opções de origem .

Nome	Descrição	Obrigatório	Valores permitidos	Propriedade do script de fluxo de dados
Entidade	O nome lógico da entidade no Zendesk.	Sim ao 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

Conteúdos relacionados

Para obter uma lista de armazenamentos de dados suportados como fontes e coletores pela atividade de cópia, consulte Armazenamentos de dados suportados.