Transformar dados no Zendesk (Preview) usando Azure Data Factory ou Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Data Factory em Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA incorporada e novas funcionalidades. Se és novo na integração de dados, começa pelo Fabric Data Factory. As cargas de trabalho existentes do ADF podem atualizar para o Fabric para aceder a novas capacidades em ciência de dados, análise em tempo real e relatórios.

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

Importante

Este conector está atualmente em versão preliminar. Você pode experimentá-lo e nos dar feedback. Se quiser depender dos conectores de pré-visualização na sua solução, por favor contacte Azure support.

Capacidades suportadas

Este conector Zendesk é suportado para os seguintes recursos:

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

(1) Runtime de integração Azure (2) Runtime 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 os passos seguintes para criar um serviço ligado Zendesk na interface do portal Azure.

  1. Navegue até ao separador Gerir no seu espaço de trabalho Azure Data Factory ou Synapse e selecione Serviços Ligados, depois selecione Novo:

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

    Captura de tela mostrando a seleção do conector Zendesk.

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

    Captura de tela da configuração do serviço vinculado Zendesk.

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 associado Zendesk:

Propriedade Descrição Obrigatório
tipo A propriedade type deve ser definida como Zendesk. Sim
url A URL base do seu serviço Zendesk. Sim
tipoDeAutenticação 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:

Propriedade Descrição Obrigatório
nome de utilizador O nome de usuário usado para fazer login no Zendesk. Sim
palavra-passe Especifique uma palavra-passe para a conta de utilizador correspondente ao nome de utilizador que indicou. Marque este campo como SecureString para armazená-lo com segurança. Ou pode referenciar um segredo armazenado em 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 de token

Defina a propriedade authenticationType como 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 este campo como SecureString para armazená-lo com segurança. Ou pode referenciar um segredo armazenado em Azure Key Vault. 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 em linha 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 destinos pela atividade de cópia, consulte Armazenamentos de dados suportados.

  • Last updated on