Copier des données de SAP Business Warehouse à l'aide d'Azure Data Factory ou Synapse Analytics

Article
10/20/2023

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !

Cet article explique comment utiliser l'activité de copie dans des pipelines Azure Data Factory et Synapse Analytics pour copier des données à partir d'un SAP Business Warehouse (BW). Il s’appuie sur l’article Vue d’ensemble de l’activité de copie.

Conseil

Pour en savoir plus sur la prise en charge générale du service pour l'intégration de données SAP, consultez le livre blanc Intégration de données SAP à l'aide d'Azure Data Factory offrant une présentation détaillée sur chaque connecteur SAP, une comparaison et des conseils.

Fonctionnalités prises en charge

Ce connecteur SAP Business Warehouse est pris en charge pour les fonctionnalités suivantes :

Fonctionnalités prises en charge	IR
Activité de copie (source/-)	0
Activité de recherche	0

① Runtime d’intégration Azure ② Runtime d’intégration auto-hébergé

Pour obtenir la liste des banques de données prises en charge en tant que sources ou récepteurs par l’activité de copie, consultez le tableau Banques de données prises en charge.

Plus précisément, ce connecteur SAP Business Warehouse prend en charge ce qui suit :

SAP Business Warehouse version 7.x.
Copie de données d’InfoCubes et de QueryCubes (y compris des requêtes BEx) à l’aide de requêtes MDX.
Copie de données en utilisant une authentification de base.

Notes

Le connecteur SAP Business Warehouse ne prend actuellement pas en charge les paramètres avec MDX. Si le filtrage avec des paramètres MDX est requis, vous pouvez envisager d’utiliser l’autre connecteur SAP Open Hub à la place.

Prérequis

Pour utiliser ce connecteur SAP Business Warehouse, vous devez :

Configurer un Runtime d’intégration autohébergé. Pour plus d’informations, consultez l’article Runtime d’intégration autohébergé.
Installer la bibliothèque SAP NetWeaver sur l’ordinateur exécutant le runtime d’intégration. Vous pouvez obtenir la bibliothèque SAP Netweaver auprès de votre administrateur SAP, ou directement depuis le Centre de téléchargement de logiciel SAP. Recherchez la Note SAP 1025361 pour obtenir l’emplacement de téléchargement de la version la plus récente. Veillez à choisir la bibliothèque SAP NetWeaver 64 bits qui correspond à votre installation du runtime d’intégration. Ensuite, installez tous les fichiers inclus dans le Kit de développement logiciel (SDK) RFC de SAP NetWeaver en fonction de la note SAP. La bibliothèque de SAP NetWeaver est également incluse dans l’installation des outils clients SAP.

Conseil

Pour résoudre le problème de connectivité à SAP BW, vérifiez que :

Toutes les bibliothèques de dépendance extraites du SDK NetWeaver RFC sont en place dans le dossier %windir%\system32. Il s’agit généralement des fichiers icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
Les ports nécessaires pour se connecter au serveur SAP sont activés sur l’ordinateur IR autohébergé (en général les ports 3300 et 3201).

Prise en main

Pour effectuer l’activité Copie avec un pipeline, vous pouvez vous servir de l’un des outils ou kits SDK suivants :

Créer un service lié à SAP BW à l’aide de l’interface utilisateur

Utilisez les étapes suivantes pour créer un service lié à SAP BW dans l’interface utilisateur du portail Azure.

Accédez à l’onglet Gérer dans votre espace de travail Azure Data Factory ou Synapse et sélectionnez Services liés, puis cliquez sur Nouveau :
- Azure Data Factory.
- Azure Synapse
Recherchez SAP et sélectionnez le SAP BW via le connecteur MDX.
Configurez les informations du service, testez la connexion et créez le nouveau service lié.

Informations de configuration des connecteurs

Les sections suivantes fournissent des informations détaillées sur les propriétés utilisées pour définir les entités Data Factory spécifiques du connecteur SAP Business Warehouse.

Propriétés du service lié

Les propriétés prises en charge pour le service lié SAP Business Warehouse sont les suivantes :

Propriété	Description	Obligatoire
type	La propriété type doit être définie sur : SapBw	Oui
server	Nom du serveur sur lequel réside l’instance SAP BW.	Oui
systemNumber	Numéro de système du système SAP BW. Valeur autorisée : nombre décimal à deux chiffres représenté sous forme de chaîne.	Oui
clientId	ID client du client dans le système SAP W. Valeur autorisée : nombre décimal à trois chiffres représenté sous forme de chaîne.	Oui
userName	Nom de l’utilisateur ayant accès au serveur SAP.	Oui
mot de passe	Mot de passe pour l’utilisateur. Marquez ce champ en tant que SecureString afin de le stocker en toute sécurité, ou référencez un secret stocké dans Azure Key Vault.	Oui
connectVia	Runtime d’intégration à utiliser pour la connexion à la banque de données. Un Runtime d’intégration autohébergé est nécessaire comme indiqué dans Prérequis.	Oui

Exemple :

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

Propriétés du jeu de données

Pour obtenir la liste complète des sections et propriétés disponibles pour la définition de jeux de données, consultez l’article sur les jeux de données. Cette section fournit la liste des propriétés prises en charge par le jeu de données SAP BW.

Pour copier des données de SAP BW, affectez la valeur SapBwCube à la propriété type du jeu de données. Tandis qu’aucune propriété spécifique d’un type n’est prise en charge pour le jeu de données SAP BW du type RelationalTable.

Exemple :

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

Si vous utilisiez un dataset typé RelationalTable, il reste pris en charge tel quel, mais nous vous suggérons d’utiliser désormais le nouveau dataset.

Propriétés de l’activité de copie

Pour obtenir la liste complète des sections et des propriétés disponibles pour la définition des activités, consultez l’article Pipelines. Cette section fournit la liste des propriétés prises en charge par la source SAP BW.

SAP BW en tant que source

Pour copier des données à partir de SAP BW, les propriétés prises en charge dans la section source de l’activité de copie sont les suivantes :

Propriété	Description	Obligatoire
type	La propriété type de la source d’activité de copie doit être définie sur : SapBwSource	Oui
query	Spécifie la requête MDX pour lire les données de l’instance SAP BW.	Oui

Exemple :

"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 vous utilisiez une source de données typée RelationalSource, elle reste prise en charge telle quelle, mais nous vous suggérons d’utiliser désormais la nouvelle source.

Mappage de type de données pour SAP BW

Lors de la copie de données à partir de SAP BW, les mappages suivants sont utilisés entre les types de données SAP BW et les types de données intermédiaires utilisés en interne dans le service. Pour découvrir comment l’activité de copie mappe le schéma et le type de données la source au récepteur, voir Mappages de schémas et de types de données.

Type de données SAP BW	Type de données de service intermédiaire
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
UNITÉ	String
DATS	String
NUMC	String
TIMS	String

Propriétés de l’activité Lookup

Pour en savoir plus sur les propriétés, consultez Activité Lookup.

Pour obtenir une liste des magasins de données pris en charge comme sources et récepteurs par l’activité de copie, consultez la section sur les magasins de données pris en charge.

Copier des données de SAP Business Warehouse à l'aide d'Azure Data Factory ou Synapse Analytics

Fonctionnalités prises en charge

Prérequis

Prise en main

Créer un service lié à SAP BW à l’aide de l’interface utilisateur

Informations de configuration des connecteurs

Propriétés du service lié

Propriétés du jeu de données

Propriétés de l’activité de copie

SAP BW en tant que source

Mappage de type de données pour SAP BW

Propriétés de l’activité Lookup

Contenu connexe

Ressources supplémentaires