Copiar dados do Oracle Responsys usando o Azure Data Factory (Visualização)Copy data from Oracle Responsys 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 da Oracle Responsys.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from Oracle Responsys. 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 Oracle Responsys tem suporte para as seguintes atividades:This Oracle Responsys connector is supported for the following activities:

Você pode copiar dados de Oracle Responsys em qualquer armazenamento de dados do coletor com suporte.You can copy data from Oracle Responsys 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.

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

Você pode criar um pipeline com atividade de cópia usando o SDK do .NET, o SDK do Python, o Azure PowerShell, a API REST ou o modelo do Azure Resource Manager.You can create a pipeline with copy activity using .NET SDK, Python SDK, Azure PowerShell, REST API, or Azure Resource Manager template. Confira o tutorial de atividade de cópia para obter instruções detalhadas para criar um pipeline com uma atividade de cópia.See Copy activity tutorial for step-by-step instructions to create a pipeline with a copy activity.

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

Propriedades do serviço vinculadoLinked service properties

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

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade type deve ser definida como: ResponsysThe type property must be set to: Responsys SimYes
endpointendpoint O ponto de extremidade do servidor RespopnsysThe endpoint of the Respopnsys server SimYes
clientIdclientId A ID do cliente associada ao aplicativo Responsys.The client ID associated with the Responsys application. SimYes
clientSecretclientSecret O segredo do cliente associado ao aplicativo Responsys.The client secret associated with the Responsys application. Você pode optar por marcar este campo como uma SecureString para armazená-la com segurança no ADF ou então armazenar a senha no Azure Key Vault e permitir que o ADF copie o pull de atividade desse local ao executar a cópia de dados – saiba mais sobre como Armazenar credenciais no Key Vault.You can choose to mark this field as a SecureString to store it securely in ADF, or store password in Azure Key Vault and let ADF copy activity pull from there when performing data copy - learn more from Store credentials in 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. NãoNo
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. NãoNo
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. NãoNo

Exemplo:Example:

{
    "name": "OracleResponsysLinkedService",
    "properties": {
        "type": "Responsys",
        "typeProperties": {
            "endpoint" : "<endpoint>",
            "clientId" : "<clientId>",
            "clientSecret": {
                 "type": "SecureString",
                 "value": "<clientSecret>"
            },
            "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 de propriedades com suporte do conjunto de dados Oracle Responsys.This section provides a list of properties supported by Oracle Responsys dataset.

Para copiar dados de Oracle Responsys, defina a propriedade type do conjunto de dados para ResponsysObject.To copy data from Oracle Responsys, set the type property of the dataset to ResponsysObject. 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: ResponsysObjectThe type property of the dataset must be set to: ResponsysObject 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": "OracleResponsysDataset",
    "properties": {
        "type": "ResponsysObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Oracle Responsys 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 de propriedades com suporte pela fonte Oracle Responsys.This section provides a list of properties supported by Oracle Responsys source.

Oracle Responsys como fonteOracle Responsys as source

Para copiar dados de Oracle Responsys, defina o tipo de fonte na atividade de cópia para ResponsysSource.To copy data from Oracle Responsys, set the source type in the copy activity to ResponsysSource. 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 de atividade de cópia deve ser definida como: ResponsysSourceThe type property of the copy activity source must be set to: ResponsysSource SimYes
Consultaquery Utiliza a consulta SQL personalizada para ler os dados.Use the custom SQL query to read data. Por exemplo: "SELECT * FROM MyTable".For example: "SELECT * FROM MyTable". Não (se "tableName" no conjunto de dados for especificado)No (if "tableName" in dataset is specified)

Exemplo:Example:

"activities":[
    {
        "name": "CopyFromOracleResponsys",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Oracle Responsys input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ResponsysSource",
                "query": "SELECT * FROM MyTable"
            },
            "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.