Copiar dados do SAP Business Warehouse usando o Azure Data FactoryCopy data from SAP Business Warehouse using Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como usar a atividade de cópia no Azure Data Factory para copiar dados de um banco de dados SAP BW (Business Warehouse).This article outlines how to use the Copy Activity in Azure Data Factory to copy data from an 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.It builds on the copy activity overview article that presents a general overview of copy activity.

Dica

Para aprender o suporte geral do ADF no cenário de integração de dados do SAP, consulte integração de dados SAP usando Azure data Factory White Paper com introdução detalhada sobre cada conector SAP, análise e diretrizes.To learn ADF's overall support on SAP data integration scenario, see SAP data integration using Azure Data Factory whitepaper with detailed introduction on each SAP connector, comparsion and guidance.

Funcionalidades com suporteSupported capabilities

Este conector do SAP Business Warehouse tem suporte para as seguintes atividades:This SAP Business Warehouse connector is supported for the following activities:

Você pode copiar dados do SAP Business Warehouse para qualquer armazenamento de dados de coletor com suporte.You can copy data from SAP Business Warehouse to any supported sink data store. 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.For a list of data stores that are supported as sources/sinks by the copy activity, see the Supported data stores table.

Especificamente, este conector do SAP Business Warehouse dá suporte:Specifically, this SAP Business Warehouse connector supports:

  • Ao SAP Business Warehouse versão 7.x.SAP Business Warehouse version 7.x.
  • À cópia de dados do InfoCubes e QueryCubes (incluindo consultas BEx) usando consultas MDX.Copying data from InfoCubes and QueryCubes (including BEx queries) using MDX queries.
  • À cópia de dados usando a autenticação Básica.Copying data using basic authentication.

Pré-requisitosPrerequisites

Para usar esse conector do SAP Business Warehouse, você precisa:To use this SAP Business Warehouse connector, you need to:

  • Configurar um Integration Runtime auto-hospedado.Set up a Self-hosted Integration Runtime. Confira o artigo de Integration Runtime auto-hospedado para obter detalhes.See Self-hosted Integration Runtime article for details.
  • Instalar a biblioteca SAP NetWeaver no computador do Integration Runtime.Install the SAP NetWeaver library on the Integration Runtime machine. Você pode obter a biblioteca do SAP Netweaver com seu administrador do SAP, ou diretamente do Centro de Download de Software SAP.You can get the SAP Netweaver library from your SAP administrator, or directly from the SAP Software Download Center. Pesquise pela Nota SAP Nº 1025361 para obter o local de download da versão mais recente.Search for the SAP Note #1025361 to get the download location for the most recent version. Verifique se você selecionou a biblioteca do SAP NetWeaver de 64 bits que corresponde à sua instalação do Integration Runtime.Make sure that you pick the 64-bit SAP NetWeaver library which matches your Integration Runtime installation. Em seguida, instale todos os arquivos incluídos no SDK RFC do SAP NetWeaver, de acordo com a Nota SAP.Then install all files included in the SAP NetWeaver RFC SDK according to the SAP Note. A biblioteca do SAP NetWeaver também está incluída na instalação das Ferramentas de Cliente SAP.The SAP NetWeaver library is also included in the SAP Client Tools installation.

Dica

Para solucionar o problema de conectividade para SAP BW, certifique-se:To troubleshoot connectivity issue to SAP BW, make sure:

  • Todas as bibliotecas de dependência extraídas do SDK do RFC NetWeaver estão em vigor na pasta %windir%\system32.All dependency libraries extracted from the NetWeaver RFC SDK are in place in the %windir%\system32 folder. Normalmente,cudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.Usually it has icudt34.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.The needed ports used to connect to SAP Server are enabled on the Self-hosted IR machine, which usually are port 3300 and 3201.

IntroduçãoGetting started

Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:To perform the Copy activity with a pipeline, you can use one of the following tools or SDKs:

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.The following sections provide details about properties that are used to define Data Factory entities specific to SAP Business Warehouse connector.

Propriedades do serviço vinculadoLinked service properties

As propriedades a seguir têm suporte no serviço vinculado do SAP BW (Business Warehouse):The following properties are supported for SAP Business Warehouse (BW) linked service:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade type deve ser definida como: SapBwThe type property must be set to: SapBw SimYes
Servidorserver Nome do servidor no qual reside a instância do SAP BW.Name of the server on which the SAP BW instance resides. SimYes
systemNumbersystemNumber Número de sistema do sistema SAP BW.System number of the SAP BW system.
Valor permitido: número decimal de dois dígitos representado como uma cadeia de caracteres.Allowed value: two-digit decimal number represented as a string.
SimYes
clientIdclientId ID de Cliente do cliente no sistema SAP W.Client ID of the client in the SAP W system.
Valor permitido: número decimal de três dígitos representado como uma cadeia de caracteres.Allowed value: three-digit decimal number represented as a string.
SimYes
userNameuserName Nome do usuário que tem acesso ao servidor SAP.Name of the user who has access to the SAP server. SimYes
passwordpassword Senha do usuário.Password for the user. Marque este campo como uma SecureString para armazená-la com segurança no Data Factory ou faça referência a um segredo armazenado no Azure Key Vault.Mark this field as a SecureString to store it securely in Data Factory, or reference a secret stored in Azure Key Vault. SimYes
connectViaconnectVia O Integration Runtime a ser usado para se conectar ao armazenamento de dados.The Integration Runtime to be used to connect to the data store. É necessário um Integration Runtime auto-hospedado, conforme mencionado nos Pré-requisitos.A Self-hosted Integration Runtime is required as mentioned in Prerequisites. SimYes

Exemplo:Example:

{
    "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 dadosDataset properties

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.For a full list of sections and properties available for defining datasets, see the datasets article. Esta seção fornece uma lista das propriedades com suporte pelo conjunto de dados do SAP BW.This section provides a list of properties supported by SAP BW dataset.

Para copiar dados de SAP BW, defina a propriedade Type do conjunto de dado como SapBwCube.To copy data from SAP BW, set the type property of the dataset to SapBwCube. Enquanto não há propriedades específicas ao tipo com suporte para o conjunto de dados do SAP BW do tipo RelationalTable.While there are no type-specific properties supported for the SAP BW dataset of type RelationalTable.

Exemplo:Example:

{
    "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.If you were using RelationalTable typed dataset, it is still supported as-is, while you are suggested to use the new one going forward.

Propriedades da atividade de cópiaCopy activity properties

Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines.For a full list of sections and properties available for defining activities, see the Pipelines article. Esta seção fornece uma lista das propriedades com suporte pela fonte do SAP BW.This section provides a list of properties supported by SAP BW source.

SAP BW como fonteSAP BW as source

Para copiar dados de SAP BW, as propriedades a seguir têm suporte na seção origem da atividade de cópia:To copy data from SAP BW, the following properties are supported in the copy activity source section:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade Type da fonte da atividade de cópia deve ser definida como: SapBwSourceThe type property of the copy activity source must be set to: SapBwSource SimYes
Consultaquery Especifica a consulta MDX para ler dados da instância do SAP BW.Specifies the MDX query to read data from the SAP BW instance. SimYes

Exemplo:Example:

"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.If you were using RelationalSource typed source, it is still supported as-is, while you are suggested to use the new one going forward.

Mapeamento de tipo de dados para SAP BWData type mapping for 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 do Azure Data Factory.When copying data from SAP BW, the following mappings are used from SAP BW data types to Azure Data Factory interim data types. 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.See Schema and data type mappings to learn about how copy activity maps the source schema and data type to the sink.

Tipo de dados do SAP BWSAP BW data type Tipo de dados provisório do Data FactoryData factory interim data type
ACCPACCP IntInt
CHARCHAR StringString
CLNTCLNT StringString
CURRCURR DecimalDecimal
CUKYCUKY StringString
DECDEC DecimalDecimal
FLTPFLTP DoubleDouble
INT1INT1 ByteByte
INT2INT2 Int16Int16
INT4INT4 IntInt
LANGLANG StringString
LCHRLCHR StringString
LRAWLRAW Byte[]Byte[]
PRECPREC Int16Int16
QUANQUAN DecimalDecimal
RAWRAW Byte[]Byte[]
RAWSTRINGRAWSTRING Byte[]Byte[]
STRINGSTRING StringString
UNIDADEUNIT StringString
DATSDATS StringString
NUMCNUMC StringString
TIMSTIMS StringString

Pesquisar propriedades de atividadeLookup activity properties

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.To learn details about the properties, check Lookup activity.

Próximas etapasNext steps

Para obter uma lista de armazenamentos de dados com suporte como origens e coletores pela atividade de cópia no Azure Data Factory, consulte Armazenamentos de dados com suporte.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.