Copiar dados do SAP ECC usando o Azure Data Factory ou o Synapse Analytics
APLICA-SE A: Azure Data Factory Azure Synapse Analytics
Gorjeta
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!
Este artigo descreve como usar a atividade de cópia no Azure Data Factory para copiar dados do SAP Enterprise Central Component (ECC). Para obter mais informações, consulte Visão geral da atividade de cópia.
Gorjeta
Para saber o suporte geral no cenário de integração de dados SAP, consulte o whitepaper Integração de dados SAP usando o Azure Data Factory com introdução detalhada sobre cada conector, comparação e orientação SAP.
Capacidades suportadas
Este conector SAP ECC é suportado para os seguintes recursos:
Capacidades suportadas | IR |
---|---|
Atividade de cópia (fonte/-) | (1) (2) |
Atividade de Pesquisa | (1) (2) |
(1) Tempo de execução de integração do Azure (2) Tempo de execução de integração auto-hospedado
Para obter uma lista de armazenamentos de dados suportados como fontes ou coletores, consulte a tabela Armazenamentos de dados suportados.
Especificamente, este conector SAP ECC suporta:
Cópia de dados do SAP ECC no SAP NetWeaver versão 7.0 e posterior.
Copiar dados de quaisquer objetos expostos pelos serviços SAP ECC OData, tais como:
- Tabelas ou visualizações SAP.
- Objetos BAPI [Business Application Programming Interface].
- Extratores de dados.
- Dados ou documentos intermediários (IDOCs) enviados para o SAP Process Integration (PI) que podem ser recebidos como OData por meio de adaptadores relativos.
Copiar dados usando 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 NetWeaver versão >=7.4. Caso você não tenha certeza sobre seu ambiente, aqui estão as etapas para confirmar a versão do seu sistema SAP:
- Use SAP GUI para se conectar ao sistema SAP.
- Vá para System ->Status.
- Verifique a liberação do SAP_BASIS, verifique se ele é igual ou maior que 701.
Gorjeta
Para copiar dados do SAP ECC por meio de uma tabela ou visualização SAP, use o conector de tabela SAP, que é mais rápido e escalável.
Pré-requisitos
Para usar esse conector SAP ECC, você precisa expor as entidades SAP ECC por meio de serviços OData por meio do SAP Gateway. Mais especificamente:
Configure o SAP Gateway. Para servidores com versões do SAP NetWeaver posteriores à 7.4, o SAP Gateway já está instalado. Para versões anteriores, você deve instalar o SAP Gateway incorporado ou o sistema de hub SAP Gateway antes de expor dados SAP ECC por meio de serviços OData. Para configurar o SAP Gateway, consulte o guia de instalação.
Ative e configure o serviço SAP OData. Você pode ativar o serviço OData através do TCODE SICF em segundos. Você também pode configurar quais objetos precisam ser expostos. Para obter mais informações, consulte as orientações passo a passo.
Se seu armazenamento de dados estiver localizado dentro de uma rede local, uma rede virtual do Azure ou a Amazon Virtual Private Cloud, você precisará configurar um tempo de execução de integração auto-hospedado para se conectar a ele.
Se o seu armazenamento de dados for um serviço de dados de nuvem gerenciado, você poderá usar o Tempo de Execução de Integração do Azure. Se o acesso for restrito a IPs 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 tempo de execução de integração de rede virtual gerenciada no Azure Data Factory para acessar a rede local sem instalar e configurar um tempo de execução de integração auto-hospedado.
Para obter mais informações sobre os mecanismos de segurança de rede e as opções suportadas pelo Data Factory, consulte Estratégias de acesso a dados.
Começar agora
Para executar a atividade Copiar com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:
- A ferramenta Copiar dados
- O portal do Azure
- O SDK do .NET
- O SDK do Python
- Azure PowerShell
- A API REST
- O modelo do Azure Resource Manager
Criar um serviço vinculado ao SAP ECC usando a interface do usuário
Use as etapas a seguir para criar um serviço vinculado ao SAP ECC na interface do usuário do portal do Azure.
Navegue até a guia Gerenciar em seu espaço de trabalho do Azure Data Factory ou Synapse e selecione Serviços Vinculados e clique em Novo:
Procure SAP e selecione o conector SAP ECC.
Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.
Detalhes de configuração do conector
As seções a seguir fornecem detalhes sobre as propriedades usadas para definir as entidades específicas do conector SAP ECC.
Propriedades do serviço vinculado
As seguintes propriedades são suportadas para o serviço vinculado SAP ECC:
Property | Descrição | Obrigatório |
---|---|---|
type |
A type propriedade deve ser definida como SapEcc . |
Sim |
url |
A URL do serviço SAP ECC OData. | Sim |
username |
O nome de usuário usado para se conectar ao SAP ECC. | Não |
password |
A senha de texto simples usada para se conectar ao SAP ECC. | Não |
connectVia |
O tempo de execução 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 tempo de execução, o tempo de execução de integração padrão do Azure 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 propriedades disponíveis para definir conjuntos de dados, consulte Conjuntos de dados. A seção a seguir fornece uma lista das propriedades suportadas pelo conjunto de dados SAP ECC.
Para copiar dados do SAP ECC, defina a type
propriedade do conjunto de dados como SapEccResource
.
As seguintes propriedades são suportadas:
Property | Descrição | Obrigatório |
---|---|---|
path |
Caminho da entidade SAP ECC OData. | 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 Copy
Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, consulte Pipelines. A seção a seguir fornece uma lista das propriedades suportadas pela origem do SAP ECC.
SAP ECC como fonte
Para copiar dados do SAP ECC, defina a type
source
propriedade na seção da atividade de cópia como SapEccSource
.
As seguintes propriedades são suportadas na seção da atividade de source
cópia:
Property | Descrição | Obrigatório |
---|---|---|
type |
A type propriedade da seção da atividade source de cópia deve 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 SAP ECC copia 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 obter mais informações, consulte Componentes de URL OData. |
Não |
sapDataColumnDelimiter |
O único caractere usado como delimitador passou 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 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 para SAP ECC
Quando você copia dados do SAP ECC, os mapeamentos a seguir são usados de tipos de dados OData para dados SAP ECC para tipos de dados provisórios que o serviço usa internamente. Para saber como a atividade de cópia mapeia o esquema de origem e o tipo de dados para o coletor, consulte Mapeamentos de esquema e tipo de dados.
Tipo de dados OData | Tipo de dados de serviço provisório |
---|---|
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 |
Nota
Atualmente, não há suporte para tipos de dados complexos.
Propriedades da atividade de pesquisa
Para saber detalhes sobre as propriedades, verifique Atividade de pesquisa.
Conteúdos relacionados
Para obter uma lista dos armazenamentos de dados suportados como fontes e coletores pela atividade de cópia, consulte Armazenamentos de dados suportados.