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

Artigo
10/20/2023

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 nos pipelines do Azure Data Factory e do Azure Synapse Analytics para copiar dados do SAP Business Warehouse (BW). Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.

Dica

Para saber mais sobre o suporte geral do serviço 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

O conector do SAP Business Warehouse é compatível com as seguintes funcionalidades:

Funcionalidades com suporte	IR
Atividade de cópia (origem/-)	2
Atividade de pesquisa	2

① Runtime de integração do Azure ② Runtime de integração auto-hospedada

Para obter uma lista de armazenamentos de dados com suporte como origens/coletores da atividade de cópia, confira a tabela Armazenamentos de dados com suporte.

Especificamente, este conector do SAP Business Warehouse dá suporte:

Ao SAP Business Warehouse versão 7.x.
À cópia de dados do InfoCubes e QueryCubes (incluindo consultas BEx) usando consultas MDX.
À cópia de dados usando a autenticação Básica.

Observação

O conector do SAP Business Warehouse não dá suporte a parâmetros com MDX no momento. Se a filtragem com parâmetros MDX for necessária, considere usar a alternativa do conector do SAP Open Hub.

Pré-requisitos

Para usar esse conector do SAP Business Warehouse, você precisa:

Configurar um Integration Runtime auto-hospedado. Consulte o artigo Self-hosted integration runtime (Integration Runtime auto-hospedado) para obter detalhes.
Instalar a biblioteca SAP NetWeaver no computador do Integration Runtime. Você pode obter a biblioteca do SAP Netweaver com seu administrador do SAP, ou diretamente do Centro de Download de Software SAP. Pesquise pela Nota SAP Nº 1025361 para obter o local de download da versão mais recente. Escolha a biblioteca SAP NetWeaver de 64 bits que corresponde à sua instalação do Integration Runtime. Em seguida, instale todos os arquivos incluídos no SDK RFC do SAP NetWeaver, de acordo com a Nota SAP. A biblioteca do SAP NetWeaver também está incluída na instalação das Ferramentas de Cliente SAP.

Dica

Para solucionar o problema de conectividade para SAP BW, certifique-se:

Todas as bibliotecas de dependência extraídas do SDK do RFC NetWeaver estão em vigor na pasta %windir%\system32. Normalmente,cudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
As portas necessárias usadas para se conectar ao servidor SAP estão habilitadas no computador do IR auto-hospedado, que geralmente são portas 3300 e 3201.

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 BW usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado para o SAP BW 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 e selecione o SAP BW por meio do conector MDX.
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 que se seguem fornecem detalhes sobre as propriedades que são usadas para definir entidades do Data Factory específicas ao conector do SAP Business Warehouse.

Propriedades do serviço vinculado

As propriedades a seguir têm suporte no serviço vinculado do SAP BW (Business Warehouse):

Propriedade	Descrição	Obrigatório
type	A propriedade type deve ser definida como: SapBw	Sim
Servidor	Nome do servidor no qual reside a instância do SAP BW.	Yes
systemNumber	Número de sistema do sistema SAP BW. Valor permitido: número decimal de dois dígitos representado como uma cadeia de caracteres.	Sim
clientId	ID de Cliente do cliente no sistema SAP W. Valor permitido: número decimal de três dígitos representado como uma cadeia de caracteres.	Sim
userName	Nome do usuário que tem acesso ao servidor SAP.	Sim
password	Senha do usuário. Marque este campo como um SecureString para armazená-lo com segurança ou referencie um segredo armazenado no Azure Key Vault.	Sim
connectVia	O Integration Runtime a ser usado para se conectar ao armazenamento de dados. É necessário um Integration Runtime auto-hospedado, conforme mencionado nos Pré-requisitos.	Sim

Exemplo:

{
    "name": "SapBwLinkedService",
    "properties": {
        "type": "SapBw",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client id>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "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 os conjuntos de dados, confira o artigo sobre conjuntos de dados. Esta seção fornece uma lista das propriedades com suporte pelo conjunto de dados do SAP BW.

Para copiar dados do SAP BW, defina a propriedade type do conjunto de dados como SapBwCube. Enquanto não há propriedades específicas ao tipo com suporte para o conjunto de dados do SAP BW do tipo RelationalTable.

Exemplo:

{
    "name": "SAPBWDataset",
    "properties": {
        "type": "SapBwCube",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP BW linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Se você estava usando o conjunto de dados com tipos RelationalTable, ele ainda tem suporte como está, mas é recomendável usar o novo de agora em diante.

Propriedades da atividade de cópia

Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines. Esta seção fornece uma lista das propriedades com suporte pela fonte do SAP BW.

SAP BW como fonte

Para copiar dados do SAP BW, as seguintes propriedades têm suporte na seção origem da atividade Copy:

Propriedade	Descrição	Obrigatório
type	A propriedade type da fonte da atividade de cópia deve ser definida como: SapBwSource	Sim
Consulta	Especifica a consulta MDX para ler dados da instância do SAP BW.	Sim

Exemplo:

"activities":[
    {
        "name": "CopyFromSAPBW",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP BW input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapBwSource",
                "query": "<MDX query for SAP BW>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Se você estava usando a fonte com tipos RelationalSource, ela ainda tem suporte como está, mas é recomendável usar a nova no futuro.

Mapeamento de tipo de dados para SAP BW

Ao copiar dados do SAP BW, os seguintes mapeamentos são usados de tipos de dados do SAP BW para tipos de dados provisórios usados internamente no serviço. Consulte Mapeamentos de tipo de dados e esquema para saber mais sobre como a atividade de cópia mapeia o tipo de dados e esquema de origem para o coletor.

Tipo de dados do SAP BW	Tipo de dados provisório do serviço
ACCP	int
CHAR	String
CLNT	String
CURR	Decimal
CUKY	String
DEC	Decimal
FLTP	Double
INT1	Byte
INT2	Int16
INT4	int
LANG	String
LCHR	String
LRAW	Byte[]
PREC	Int16
QUAN	Decimal
RAW	Byte[]
RAWSTRING	Byte[]
STRING	String
UNIDADE	String
DATS	String
NUMC	String
TIMS	String

Pesquisar propriedades de atividade

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.

Para obter uma lista de armazenamentos de dados com suporte como coletores e fontes da atividade de cópia, confira os armazenamentos de dados com suporte.

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

Funcionalidades com suporte

Pré-requisitos

Introdução

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

Detalhes da configuração do conector

Propriedades do serviço vinculado

Propriedades do conjunto de dados

Propriedades da atividade de cópia

SAP BW como fonte

Mapeamento de tipo de dados para SAP BW

Pesquisar propriedades de atividade

Conteúdo relacionado

Recursos adicionais