Copia de datos desde SAP Business Warehouse con Azure Data Factory o Synapse Analytics

Artículo
10/20/2023

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

En este artículo se explica cómo usar la actividad de copia en canalizaciones de Azure Data Factory y Synapse Analytics para copiar datos desde una instancia de SAP Business Warehouse (BW). El documento se basa en el artículo de introducción a la actividad de copia que describe información general de la actividad de copia.

Sugerencia

Para obtener información sobre la compatibilidad general del servicio con el escenario de integración de datos de SAP, consulte el informe técnico sobre la integración de datos de SAP mediante Azure Data Factory, que contiene una introducción detallada con comparaciones y una guía sobre cada conector de SAP.

Funcionalidades admitidas

Este conector de SAP Business Warehouse es compatible con las siguientes funcionalidades:

Funcionalidades admitidas	IR
Actividad de copia (origen/-)	6
Actividad de búsqueda	6

① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado

Consulte la tabla de almacenes de datos compatibles para ver una lista de almacenes de datos que la actividad de copia admite como orígenes o receptores.

Concretamente, este conector SAP Business Warehouse admite:

SAP Business Warehouse versión 7.x.
La copia de datos de InfoCubes y QueryCubes (incluidas las consultas BEx) mediante consultas MDX.
Copiar datos con la autenticación básica.

Nota

El conector SAP Business Warehouse actualmente no admite parámetros con MDX. Si es necesario filtrar con parámetros MDX, puede considerar la posibilidad de usar el conector SAP Open Hub alternativo en su lugar.

Prerrequisitos

Para usar este conector SAP Business Warehouse, necesita hacer lo siguiente:

Configurar un entorno Integration Runtime autohospedado. Consulte el artículo sobre Integration Runtime autohospedado para más información.
Instalar la biblioteca SAP NetWeaver en la máquina de Integration Runtime. Puede obtener la biblioteca SAP Netweaver desde el administrador de SAP o directamente desde el centro de descarga de software de SAP. Busque la nota 1025361 de SAP para obtener la ubicación de descarga de la versión más reciente. Asegúrese de elegir la biblioteca de SAP NetWeaver de 64 bits, que coincida con la instalación de Integration Runtime. A continuación, instale todos los archivos incluidos en SAP NetWeaver RFC SDK según la nota de SAP. La biblioteca SAP NetWeaver también se incluye en la instalación de las herramientas de cliente de SAP.

Sugerencia

Para solucionar problemas de conectividad a SAP BW, asegúrese de lo siguiente:

Todas las bibliotecas de dependencias extraídas de NetWeaver RFC SDK están en la carpeta %windir%\system32. Normalmente contiene icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
Los puertos necesarios usados para conectarse a SAP Server están habilitados en la máquina de IR autohospedado, que normalmente son 3300 y 3201.

Introducción

Para realizar la actividad de copia con una canalización, puede usar una de los siguientes herramientas o SDK:

Creación de un servicio vinculado a SAP BW mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado a SAP BW en la interfaz de usuario de Azure Portal.

Vaya a la pestaña Administrar del área de trabajo de Azure Data Factory o Synapse y seleccione Servicios vinculados; luego haga clic en Nuevo:
- Azure Data Factory
- Azure Synapse
Busque SAP y seleccione SAP BW a través del conector MDX.
Configure los detalles del servicio, pruebe la conexión y cree el nuevo servicio vinculado.

Detalles de configuración del conector

Las secciones siguientes proporcionan detalles sobre las propiedades que se usan para definir entidades de Data Factory específicas del conector SAP Business Warehouse.

Propiedades del servicio vinculado

Las siguientes propiedades son compatibles con el servicio vinculado SAP Business Warehouse (BW):

Propiedad	Descripción	Obligatorio
type	La propiedad type debe establecerse en: SapBw	Sí
server	Nombre del servidor en el que reside la instancia de SAP BW.	Sí
systemNumber	Número del sistema de SAP BW. Valor permitido: número decimal de dos dígitos que se representa en forma de cadena.	Sí
clientId	Identificador del cliente en el sistema SAP W. Valor permitido: número decimal de tres dígitos que se representa en forma de cadena.	Sí
userName	Nombre del usuario que tiene acceso al servidor SAP.	Sí
password	Contraseña del usuario. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault.	Sí
connectVia	El entorno Integration Runtime que se usará para conectarse al almacén de datos. Tal y como se mencionó en los requisitos previos, se requiere un entorno Integration Runtime autohospedado.	Sí

Ejemplo:

{
    "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"
        }
    }
}

Propiedades del conjunto de datos

Si desea ver una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte el artículo sobre conjuntos de datos. En esta sección se proporciona una lista de las propiedades que admite el conjunto de datos de SAP BW.

Para copiar datos desde SAP BW, establezca la propiedad type del conjunto de datos en SapBwCube. No hay ninguna propiedad específica del tipo compatible con el conjunto de datos de SAP BW de tipo RelationalTable.

Ejemplo:

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

Si estaba usando un conjunto de datos de tipo RelationalTable, todavía se admite tal cual, aunque se aconseja usar el nuevo en el futuro.

Propiedades de la actividad de copia

Si desea ver una lista completa de las secciones y propiedades disponibles para definir actividades, consulte el artículo sobre canalizaciones. En esta sección se proporciona una lista de las propiedades que admite el origen de SAP BW.

SAP BW como origen

Para copiar datos desde SAP BW, en la sección source de la actividad de copia se admiten las siguientes propiedades:

Propiedad	Descripción	Obligatorio
type	La propiedad type del origen de la actividad de copia debe establecerse en: SapBwSource	Sí
Query	Especifica la consulta MDX para leer datos de la instancia de SAP BW.	Sí

Ejemplo:

"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>"
            }
        }
    }
]

Si estaba usando un origen de tipo RelationalSource, todavía se admite tal cual, aunque se aconseja usar el nuevo en el futuro.

Asignación de tipos de datos para SAP BW

Al copiar datos desde SAP BW, se utilizan las siguientes asignaciones de tipos de datos de la solución a los tipos de datos provisionales usados internamente dentro del servicio. Consulte el artículo sobre asignaciones de tipos de datos y esquema para información sobre cómo la actividad de copia asigna el tipo de datos y el esquema de origen al receptor.

Tipo de datos de SAP BW	Tipo de datos de servicio provisional
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
UNIDAD	String
DATS	String
NUMC	String
TIMS	String

Propiedades de la actividad de búsqueda

Para obtener información detallada sobre las propiedades, consulte Actividad de búsqueda.

Para obtener una lista de almacenes de datos que la actividad de copia admite como orígenes y receptores, vea Almacenes de datos que se admiten.

Copia de datos desde SAP Business Warehouse con Azure Data Factory o Synapse Analytics

Funcionalidades admitidas

Prerrequisitos

Introducción

Creación de un servicio vinculado a SAP BW mediante la interfaz de usuario

Detalles de configuración del conector

Propiedades del servicio vinculado

Propiedades del conjunto de datos

Propiedades de la actividad de copia

SAP BW como origen

Asignación de tipos de datos para SAP BW

Propiedades de la actividad de búsqueda

Contenido relacionado

Recursos adicionales