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

Artigo
09/26/2024

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:

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:
- Azure Data Factory
- Azure Synapse
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.

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.

Compartilhar via

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

Funcionalidades com suporte

Pré-requisitos

Introdução

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

Detalhes da configuração do conector

Propriedades do serviço vinculado

Exemplo

Propriedades do conjunto de dados

Exemplo

Propriedades da atividade de cópia

SAP ECC como fonte

Exemplo

Mapeamentos de tipo de dados do SAP ECC

Pesquisar propriedades de atividade

Comentários

Recursos adicionais

Compartilhar via

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

Funcionalidades com suporte

Pré-requisitos

Introdução

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

Detalhes da configuração do conector

Propriedades do serviço vinculado

Exemplo

Propriedades do conjunto de dados

Exemplo

Propriedades da atividade de cópia

SAP ECC como fonte

Exemplo

Mapeamentos de tipo de dados do SAP ECC

Pesquisar propriedades de atividade

Conteúdo relacionado

Comentários

Recursos adicionais