Copiar dados do SAP ECC usando o Azure Data Factory ou o Synapse Analytics

Artigo
11/16/2023

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/-)	① ②
Atividade de Pesquisa	① ②

(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.

Introdução

Para executar a atividade Copiar com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:

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:
- Fábrica de Dados do Azure
- Azure Synapse
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:

Propriedade	Descrição	Necessá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:

Propriedade	Descrição	Necessá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 typesource 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:

Propriedade	Descrição	Necessá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.

Para obter uma lista dos armazenamentos de dados suportados como fontes e coletores pela atividade de cópia, consulte Armazenamentos de dados suportados.

Copiar dados do SAP ECC usando o Azure Data Factory ou o Synapse Analytics

Capacidades suportadas

Pré-requisitos

Introdução

Criar um serviço vinculado ao SAP ECC usando a interface do usuário

Detalhes de configuração do conector

Propriedades do serviço vinculado

Exemplo

Propriedades do conjunto de dados

Exemplo

Propriedades da atividade Copy

SAP ECC como fonte

Exemplo

Mapeamentos de tipo de dados para SAP ECC

Propriedades da atividade de pesquisa

Conteúdos relacionados

Recursos adicionais