Copiar dados do Oracle Responsys usando o Azure Data Factory ou o Synapse Analytics (versão prévia)
APLICA-SE A:
Azure Data Factory Azure Synapse Analytics
Dica
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!
Importante
Esse conector será descontinuado em 31 de dezembro de 2024. É recomendável migrar para o conector ODBC instalando um driver antes dessa data.
Este artigo descreve como usar a atividade de cópia nos pipelines do Azure Data Factory ou do Azure Synapse Analytics para copiar dados de uma tabela do Orace Responsys. Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.
Funcionalidades com suporte
O conector Oracle Responsys tem suporte para as seguintes funcionalidades:
| Funcionalidades com suporte | IR |
|---|---|
| Atividade de cópia (origem/-) | ① ② |
| Atividade de pesquisa | ① ② |
① Runtime de integração do Azure ② Runtime de integração auto-hospedada
Para obter uma lista de armazenamentos de dados com suporte como origens e coletores, confira a tabela Armazenamentos de dados com suporte.
O serviço fornece um driver interno para habilitar a conectividade, portanto, não é necessário instalar manualmente qualquer driver usando esse conector.
Introdução
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. Confira o Tutorial de atividade de cópia para obter instruções passo a passo sobre a criação de um pipeline com uma atividade de cópia.
Criar um serviço vinculado para o Oracle Responsys usando a interface do usuário
Use as etapas a seguir para criar um serviço vinculado para o Oracle Responsys na interface do usuário do portal do Azure.
Navegue até a guia Gerenciar no workspace do Azure Data Factory ou do Synapse, selecione Serviços Vinculados e clique em Novo:
Procure Oracle e selecione o conector do Oracle Responsys.
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 detalhes sobre as propriedades que são usadas para definir entidades do Data Factory específicas ao conector Oracle Responsys.
Propriedades do serviço vinculado
As propriedades a seguir têm suporte para o serviço Oracle Responsys vinculado:
| Propriedade | Descrição | Obrigatório |
|---|---|---|
| type | A propriedade type deve ser definida como: Responsys | Sim |
| endpoint | O ponto de extremidade do servidor Respopnsys | Sim |
| clientId | A ID do cliente associada ao aplicativo Responsys. | Sim |
| clientSecret | O segredo do cliente associado ao aplicativo Responsys. Você pode optar por marcar este campo como uma SecureString para armazená-la com segurança no serviço ou armazenar a senha no Azure Key Vault e permitir o pull de atividade de cópia do serviço a partir daí, ao executar a cópia de dados. Saiba mais de Armazenar credenciais no Key Vault. | Sim |
| useEncryptedEndpoints | Especifica se os endpoints de fonte de dados são criptografados usando HTTPS. O valor padrão é true. | Não |
| useHostVerification | Especifica se o nome do host no certificado do servidor precisa ser igual ao nome do host do servidor nas conexões por TLS. O valor padrão é true. | Não |
| usePeerVerification | Especifica se a identidade do servidor deve ser verificada nas conexões por TLS. O valor padrão é true. | Não |
Exemplo:
{
"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 dados
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. Esta seção fornece uma lista de propriedades com suporte do conjunto de dados Oracle Responsys.
Para copiar dados de Oracle Responsys, defina a propriedade type do conjunto de dados para ResponsysObject. Há suporte para as seguintes propriedades:
| Propriedade | Descrição | Obrigatório |
|---|---|---|
| type | A propriedade tipo do conjunto de dados deve ser definida como: ResponsysObject | Sim |
| tableName | Nome da tabela. | Não (se "query" na fonte da atividade for especificada) |
Exemplo
{
"name": "OracleResponsysDataset",
"properties": {
"type": "ResponsysObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<Oracle Responsys linked service name>",
"type": "LinkedServiceReference"
}
}
}
Propriedades da atividade de cópia
Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines. Esta seção fornece uma lista de propriedades com suporte pela fonte Oracle Responsys.
Oracle Responsys como fonte
Para copiar dados de Oracle Responsys, defina o tipo de fonte na atividade de cópia para ResponsysSource. As propriedades a seguir têm suporte na seção source da atividade de cópia:
| Propriedade | Descrição | Obrigatório |
|---|---|---|
| type | A propriedade type da fonte de atividade de cópia deve ser definida como: ResponsysSource | Sim |
| Consulta | Utiliza a consulta SQL personalizada para ler os dados. Por exemplo: "SELECT * FROM MyTable". |
Não (se "tableName" no conjunto de dados for especificado) |
Exemplo:
"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 atividade
Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.
Conteúdo relacionado
Para obter uma lista de armazenamentos de dados com suporte como coletores e fontes da atividade de cópia, confira os armazenamentos de dados com suporte.