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

  • Artigo

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/-) 6/6
Atividade de pesquisa 6/6

① 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:

  1. Use a GUI do SAP para se conectar ao sistema SAP.
  2. Acesse Sistema ->Status.
  3. Verifique o lançamento do SAP_BASIS, confira se ele é igual ou maior que 701.
    Check SAP_BASIS

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.

  1. Navegue até a guia Gerenciar no workspace do Azure Data Factory ou do Synapse, selecione Serviços Vinculados e clique em Novo:

  2. Procure SAP ECC e selecione o conector do SAP ECC.

    Screenshot of the SAP ECC connector.

  3. Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

    Screenshot of linked service configuration for SAP ECC.

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.