Copiar dados do Concur usando o Azure Data Factory (visualização)Copy data from Concur using Azure Data Factory (Preview)

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 Concur.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from Concur. 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.

Importante

Atualmente, esse conector está em versão prévia.This connector is currently in preview. Você pode experimentá-lo e oferecer comentários.You can try it out and give us feedback. Se você quiser uma dependência de conectores em versão prévia em sua solução, entre em contato com suporte do Azure.If you want to take a dependency on preview connectors in your solution, please contact Azure support.

Funcionalidades com suporteSupported capabilities

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

Você pode copiar dados de um Concur para qualquer armazenamento de dados de coletor com suporte.You can copy data from Concur 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.

Observação

No momento, não há suporte para conta do parceiro.Partner account is currently not supported.

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:

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

Propriedades do serviço vinculadoLinked service properties

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

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade type deve ser definida como: ConcurThe type property must be set to: Concur YesYes
connectionPropertiesconnectionProperties Um grupo de propriedades que define como se conectar ao concur.A group of properties that defines how to connect to Concur. YesYes
*Em connectionProperties : _*Under connectionProperties: _
authenticationTypeauthenticationType Os valores permitidos são OAuth_2.0_Bearer e OAuth_2.0 (Herdado).Allowed values are OAuth_2.0_Bearer and OAuth_2.0 (legacy). A opção de autenticação OAuth 2,0 funciona com a antiga API concur, que foi preterida desde 2017 de fevereiro.The OAuth 2.0 authentication option works with the old Concur API which was deprecated since Feb 2017. SimYes
hosthost O ponto de extremidade do servidor concur, por exemplo, implementation.concursolutions.com .The endpoint of the Concur server, e.g. implementation.concursolutions.com. YesYes
baseUrlbaseUrl A URL base da URL de autorização do seu concur.The base URL of your Concur's authorization URL. Sim para OAuth_2.0_Bearer autenticaçãoYes for OAuth_2.0_Bearer authentication
clientIdclientId ID do cliente do aplicativo fornecida pelo gerenciamento de aplicativo concur.Application client ID supplied by Concur App Management. YesYes
clientSecretclientSecret O segredo do cliente correspondente à ID do cliente.The client secret corresponding to the client ID. Marque este campo como uma SecureString para armazená-la com segurança no Data Factory ou faça referência a um segredo armazenado no Azure Key Vault.Mark this field as a SecureString to store it securely in Data Factory, or reference a secret stored in Azure Key Vault. Sim para OAuth_2.0_Bearer autenticaçãoYes for OAuth_2.0_Bearer authentication
Nome de Usuáriousername O nome de usuário que você usa para acessar o serviço concur.The user name that you use to access Concur service. SimYes
passwordpassword A senha correspondente ao nome de usuário fornecido no campo de nome de usuário.The password corresponding to the user name that you provided in the username field. Marque este campo como uma SecureString para armazená-la com segurança no Data Factory ou faça referência a um segredo armazenado no Azure Key Vault.Mark this field as a SecureString to store it securely in Data Factory, or reference a secret stored in Azure Key Vault. SimYes
useEncryptedEndpointsuseEncryptedEndpoints Especifica se os endpoints de fonte de dados são criptografados usando HTTPS.Specifies whether the data source endpoints are encrypted using HTTPS. O valor padrão é true.The default value is true. NoNo
useHostVerificationuseHostVerification Especifica se deve ser necessário o nome do host no certificado do servidor para corresponder ao nome do host do servidor ao se conectar via TLS.Specifies whether to require the host name in the server's certificate to match the host name of the server when connecting over TLS. O valor padrão é true.The default value is true. NoNo
usePeerVerificationusePeerVerification Especifica se a identidade do servidor deve ser verificada ao se conectar via TLS.Specifies whether to verify the identity of the server when connecting over TLS. O valor padrão é true.The default value is true. NoNo

_ Exemplo:*_ Example:*

{ 
    "name": "ConcurLinkedService", 
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "connectionProperties": {
                "host":"<host e.g. implementation.concursolutions.com>",
                "baseUrl": "<base URL for authorization e.g. us-impl.api.concursolutions.com>",
                "authenticationType": "OAuth_2.0_Bearer",
                "clientId": "<client id>",
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "username": "fakeUserName",
                "password": {
                    "type": "SecureString",
                    "value": "<password>"
                },
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
} 

Exemplo (Herdado):Example (legacy):

Observe que este é um modelo de serviço vinculado herdado sem connectionProperties e usando a OAuth_2.0 autenticação do.Note the following is a legacy linked service model without connectionProperties and using OAuth_2.0 authentication.

{
    "name": "ConcurLinkedService",
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "clientId" : "<clientId>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

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 Concur.This section provides a list of properties supported by Concur dataset.

Para copiar dados do Concur, defina a propriedade type do conjunto de dados como ConcurObject.To copy data from Concur, set the type property of the dataset to ConcurObject. Não há nenhuma propriedade adicional específica do type nesse tipo de conjunto de dados.There is no additional type-specific property in this type of dataset. Há suporte para as seguintes propriedades:The following properties are supported:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade Type do conjunto de conjuntos deve ser definida como: ConcurObjectThe type property of the dataset must be set to: ConcurObject SimYes
tableNametableName Nome da tabela.Name of the table. Não (se "query" na fonte da atividade for especificada)No (if "query" in activity source is specified)

ExemploExample

{
    "name": "ConcurDataset",
    "properties": {
        "type": "ConcurObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Concur 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 fonte do Concur.This section provides a list of properties supported by Concur source.

ConcurSource como fonteConcurSource as source

Para copiar dados do Concur, defina o tipo de origem na atividade de cópia como ConcurSource.To copy data from Concur, set the source type in the copy activity to ConcurSource. 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:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade type da fonte da atividade de cópia deve ser definida como: ConcurSourceThe type property of the copy activity source must be set to: ConcurSource SimYes
Consultaquery Utiliza a consulta SQL personalizada para ler os dados.Use the custom SQL query to read data. Por exemplo: "SELECT * FROM Opportunities where Id = xxx ".For example: "SELECT * FROM Opportunities where Id = xxx ". Não (se "tableName" no conjunto de dados for especificado)No (if "tableName" in dataset is specified)

Exemplo:Example:

"activities":[
    {
        "name": "CopyFromConcur",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Concur input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ConcurSource",
                "query": "SELECT * FROM Opportunities where Id = xxx"
            },
            "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.