Copiar dados do Zoho usando Azure Data Factory (versão prévia)Copy data from Zoho using Azure Data Factory (Preview)

• 08/03/2020
• 4 minutos para o fim da leitura
• • l
  • o
  • c

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como usar a atividade de cópia no Azure Data Factory para copiar dados de e para o Zoho.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from Zoho. Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.It builds on the copy activity overview article that presents a general overview of copy activity.

Funcionalidades com suporteSupported capabilities

Este conector do Zoho tem suporte para as seguintes atividades:This Zoho connector is supported for the following activities:

• Atividade de cópia com matriz de fonte/coletor com suporteCopy activity with supported source/sink matrix
• Atividade de pesquisaLookup activity

Você pode copiar dados do Zoho para qualquer armazenamento de dados de coletor com suporte.You can copy data from Zoho to any supported sink data store. Para obter uma lista de armazenamentos de dados com suporte como origens/coletores da atividade de cópia, confira a tabela Armazenamentos de dados com suporte.For a list of data stores that are supported as sources/sinks by the copy activity, see the Supported data stores table.

Este conector dá suporte à autenticação de token de acesso Xero e à autenticação OAuth 2,0.This connector supports Xero access token authentication and OAuth 2.0 authentication.

Azure Data Factory fornece um driver interno para habilitar a conectividade, portanto, não é necessário instalar manualmente qualquer driver usando esse conector.Azure Data Factory provides a built-in driver to enable connectivity, therefore you don't need to manually install any driver using this connector.

IntroduçãoGetting started

Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:To perform the Copy activity with a pipeline, you can use one of the following tools or SDKs:

• A ferramenta Copiar DadosThe Copy Data tool
• O portal do AzureThe Azure portal
• O SDK do .NETThe .NET SDK
• O SDK do PythonThe Python SDK
• PowerShell do AzureAzure PowerShell
• A API RESTThe REST API
• O modelo do Azure Resource ManagerThe Azure Resource Manager template

As seções a seguir fornecem detalhes sobre as propriedades usadas para definir entidades do Data Factory específicas ao conector do Zoho.The following sections provide details about properties that are used to define Data Factory entities specific to Zoho connector.

Propriedades do serviço vinculadoLinked service properties

As propriedades a seguir têm suporte para o serviço vinculado do Zoho:The following properties are supported for Zoho linked service:

Exemplo: Autenticação OAuth 2,0Example: OAuth 2.0 authentication

{
    "name": "ZohoLinkedService",
    "properties": {
        "type": "Zoho",
        "typeProperties": {
            "connectionProperties": { 
                "authenticationType":"OAuth_2.0", 
                "endpoint": "crm.zoho.com/crm/private", 
                "clientId": "<client ID>", 
                "clientSecrect": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh token>"
                }, 
                "useEncryptedEndpoints": true,
                "useHostVerification": true, 
                "usePeerVerification": true
            }
        }
    }
}

Exemplo: autenticação de token de acessoExample: access token authentication

{
    "name": "ZohoLinkedService",
    "properties": {
        "type": "Zoho",
        "typeProperties": {
            "connectionProperties": { 
                "authenticationType":"Access Token", 
                "endpoint": "crm.zoho.com/crm/private", 
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "useEncryptedEndpoints": true, 
                "useHostVerification": true, 
                "usePeerVerification": true
            }
        }
    }
}

Propriedades do conjunto de dadosDataset properties

Para obter uma lista completa das seções e propriedades disponíveis para definir os conjuntos de dados, confira o artigo sobre conjuntos de dados.For a full list of sections and properties available for defining datasets, see the datasets article. Esta seção fornece uma lista das propriedades com suporte pelo conjunto de dados do Zoho.This section provides a list of properties supported by Zoho dataset.

Para copiar dados do Zoho, defina a propriedade type do conjunto de dados como ZohoObject.To copy data from Zoho, set the type property of the dataset to ZohoObject. Há suporte para as seguintes propriedades:The following properties are supported:

ExemploExample

{
    "name": "ZohoDataset",
    "properties": {
        "type": "ZohoObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Zoho linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Propriedades da atividade de cópiaCopy activity properties

Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines.For a full list of sections and properties available for defining activities, see the Pipelines article. Esta seção fornece uma lista das propriedades com suporte pela origem do Zoho.This section provides a list of properties supported by Zoho source.

Zoho como origemZoho as source

Para copiar dados de Zoho, defina o tipo de fonte na atividade de cópia como ZohoSource.To copy data from Zoho, set the source type in the copy activity to ZohoSource. As propriedades a seguir têm suporte na seção source da atividade de cópia:The following properties are supported in the copy activity source section:

Exemplo:Example:

"activities":[
    {
        "name": "CopyFromZoho",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Zoho input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ZohoSource",
                "query": "SELECT * FROM Accounts"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Pesquisar propriedades de atividadeLookup activity properties

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.To learn details about the properties, check Lookup activity.

Próximas etapasNext steps

Para obter uma lista de armazenamentos de dados com suporte como origens e coletores pela atividade de cópia no Azure Data Factory, consulte Armazenamentos de dados com suporte.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.