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

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

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.

Funcionalidades com suporte

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

① 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.

1. 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

   

2. Procure Zendesk (versão prévia) e selecione o conector do Zendesk (versão prévia).

   

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

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:

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:

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.

Exemplos de script de origem do Zendesk

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

Conteúdo relacionado

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.