Copiar dados do SAP ECC utilizando o Azure Data Factory ou Synapse Analytics
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!
Este artigo descreve como usar a Atividade de Cópia no Azure Data Factory para copiar dados do SAP ECC (Enterprise Central Component). Para obter mais informações, confira Visão geral da atividade de cópia.
Dica
Para saber mais sobre o suporte geral no cenário de integração de dados do SAP, confira o artigo técnico Integração de dados do SAP usando o Azure Data Factory com introdução detalhada sobre cada conector SAP, comparações e orientações.
Funcionalidades com suporte
Há suporte para este conector do SAP ECC 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 ou coletores, confira a tabela Armazenamentos de dados com suporte.
Especificamente, este conector do SAP ECC dá suporte à:
Copiar dados do SAP ECC no SAP NetWeaver versão 7.0 e posterior.
Copiar dados de qualquer objeto exposto pelos serviços OData do SAP ECC, como:
- Tabelas ou exibições do SAP.
- Objetos de BAPI [interface de programação de aplicativo de negócios].
- Extratores de dados.
- Dados ou documentos intermediários (IDOCs) enviados ao SAP PI (Process Integration) que podem ser recebidos como OData por meio de adaptadores relativos.
Cópia de dados por meio da autenticação básica.
A versão 7.0 ou posterior refere-se à versão do SAP NetWeaver em vez da versão do SAP ECC. Por exemplo, o SAP ECC 6.0 EHP 7 em geral tem a versão do NetWeaver >= 7.4. Caso você não tenha certeza sobre o seu ambiente, aqui estão as etapas para confirmar a versão do seu sistema SAP:
- Use a GUI do SAP para se conectar ao sistema SAP.
- Acesse Sistema ->Status.
- Verifique o lançamento do SAP_BASIS, confira se ele é igual ou maior que 701.
Dica
Para copiar dados do SAP ECC por meio de uma tabela ou uma exibição do SAP, use o conector de tabela do SAP, que é mais rápido e mais escalonável.
Pré-requisitos
Para usar esse conector SAP ECC, você precisa expor as entidades do SAP ECC por meio de serviços OData por meio do gateway do SAP. Mais especificamente:
Configurar o Gateway do SAP. Para os servidores com versões do SAP NetWeaver posteriores a 7.4, o SAP Gateway já está instalado. Para obter as versões anteriores, você precisará instalar o SAP Gateway inserido ou o sistema de hub do SAP Gateway antes de expor os dados do SAP ECC por meio de serviços OData. Para configurar o SAP Gateway, confira o guia de instalação.
Ativar e configurar o serviço OData do SAP. Ative o serviço OData por meio do TCODE SICF em poucos segundos. Configure também quais objetos precisam ser expostos. Para obter mais informações, confira as diretrizes passo a passo.
Se o armazenamento de dados estiver localizado dentro de uma rede local, em uma rede virtual do Azure ou na Amazon Virtual Private Cloud, você precisará configurar um runtime de integração auto-hospedada para se conectar a ele.
Se o armazenamento de dados for um serviço de dados de nuvem gerenciado, você poderá usar o Azure Integration Runtime. Se o acesso for restrito aos IPs que estão aprovados nas regras de firewall, você poderá adicionar IPs do Azure Integration Runtime à lista de permissões.
Você também pode usar o recurso de runtime de integração da rede virtual gerenciada no Azure Data Factory para acessar a rede local sem instalar e configurar um runtime de integração auto-hospedada.
Para obter mais informações sobre os mecanismos de segurança de rede e as opções compatíveis com o Data Factory, consulte Estratégias de acesso a dados.
Introdução
Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:
- A ferramenta Copiar Dados
- O portal do Azure
- O SDK do .NET
- O SDK do Python
- PowerShell do Azure
- A API REST
- O modelo do Azure Resource Manager
Criar um serviço vinculado para o SAP ECC usando a interface do usuário
Use as etapas a seguir para criar um serviço vinculado para o SAP ECC 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 SAP ECC e selecione o conector do SAP ECC.
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 usadas para definir as entidades específicas ao conector do SAP ECC.
Propriedades do serviço vinculado
Há suporte para as seguintes propriedades no serviço vinculado do SAP ECC:
Propriedade | Descrição | Obrigatório |
---|---|---|
type |
A propriedade type precisa ser definida como SapEcc . |
Sim |
url |
A URL do serviço OData do SAP ECC. | Sim |
username |
O nome de usuário usado para se conectar ao SAP ECC. | Não |
password |
A senha de texto não criptografado usada para se conectar ao SAP ECC. | Não |
connectVia |
O runtime de integração a ser usado para se conectar ao armazenamento de dados. Saiba mais na seção Pré-requisitos. Se você não especificar um runtime, o Azure Integration Runtime padrão será usado. | Não |
Exemplo
{
"name": "SapECCLinkedService",
"properties": {
"type": "SapEcc",
"typeProperties": {
"url": "<SAP ECC OData URL, e.g., http://eccsvrname:8000/sap/opu/odata/sap/zgw100_dd02l_so_srv/>",
"username": "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
},
"connectVia": {
"referenceName": "<name of integration runtime>",
"type": "IntegrationRuntimeReference"
}
}
Propriedades do conjunto de dados
Para obter uma lista completa das seções e das propriedades disponíveis para definir os conjuntos de dados, confira Conjuntos de dados. A seção a seguir fornece uma lista das propriedades compatíveis com o conjunto de dados do SAP ECC.
Para copiar dados do SAP ECC, defina a propriedade type
do conjunto de dados como SapEccResource
.
Há suporte para as seguintes propriedades:
Propriedade | Descrição | Obrigatório |
---|---|---|
path |
Caminho da entidade OData do SAP ECC. | Sim |
Exemplo
{
"name": "SapEccDataset",
"properties": {
"type": "SapEccResource",
"typeProperties": {
"path": "<entity path, e.g., dd04tentitySet>"
},
"schema": [],
"linkedServiceName": {
"referenceName": "<SAP ECC linked service name>",
"type": "LinkedServiceReference"
}
}
}
Propriedades da atividade de cópia
Para obter uma lista completa das seções e das propriedades disponíveis para definir as atividades, confira Pipelines. A seção a seguir fornece uma lista das propriedades compatíveis com a fonte do SAP ECC.
SAP ECC como fonte
Para copiar dados do SAP ECC, defina a propriedade type
na seção source
da atividade de cópia como SapEccSource
.
Há suporte para as seguintes propriedades na seção source
da atividade de cópia:
Propriedade | Descrição | Obrigatório |
---|---|---|
type |
A propriedade type da seção source da atividade de cópia precisa ser definida como SapEccSource . |
Sim |
query |
As opções de consulta OData para filtrar os dados. Por exemplo:"$select=Name,Description&$top=10" o conector do SAP ECC copia os dados da URL combinada: <URL specified in the linked service>/<path specified in the dataset>?<query specified in the copy activity's source section> Para saber mais, confira as Componentes da URL do OData. |
Não |
sapDataColumnDelimiter |
O caractere único que é utilizado como delimitador passado para o SAP RFC para dividir os dados de saída. | Não |
httpRequestTimeout |
O tempo limite (o valor TimeSpan) para a solicitação HTTP para obter uma resposta. Esse valor é o tempo limite para obter uma resposta, não o tempo limite para ler os dados da resposta. Se não for especificado, o valor padrão será 00:30:00 (30 minutos). | Não |
Exemplo
"activities":[
{
"name": "CopyFromSAPECC",
"type": "Copy",
"inputs": [
{
"referenceName": "<SAP ECC input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "SapEccSource",
"query": "$top=10"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Mapeamentos de tipo de dados do SAP ECC
Quando você copia dados do SAP ECC, os mapeamentos a seguir são usados dos tipos de dados OData para os dados do SAP ECC para os tipos de dados provisórios do serviço interno. Para saber mais sobre como a atividade de cópia mapeia o tipo de dados e esquema de origem para o coletor, consulte Mapeamentos de tipo de dados e esquema.
Tipo de dados OData | Tipo de dados provisório do serviço |
---|---|
Edm.Binary |
String |
Edm.Boolean |
Bool |
Edm.Byte |
String |
Edm.DateTime |
DateTime |
Edm.Decimal |
Decimal |
Edm.Double |
Double |
Edm.Single |
Single |
Edm.Guid |
String |
Edm.Int16 |
Int16 |
Edm.Int32 |
Int32 |
Edm.Int64 |
Int64 |
Edm.SByte |
Int16 |
Edm.String |
String |
Edm.Time |
TimeSpan |
Edm.DateTimeOffset |
DateTimeOffset |
Observação
Atualmente, não há suporte para tipos de dados complexos.
Pesquisar propriedades de atividade
Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.
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.