Chargement de données de partition fédérée

A partir d'un cube Essbase de partition fédérée, vous pouvez charger des données vers la table de faits dans Autonomous Data Warehouse. Pour pouvoir effectuer cette opération, vous devez intégrer Essbase à OCI Object Storage et configurer les informations d'identification DBMS_CLOUD à l'aide du script configure-dbms-writeback.

Intégration d'Essbase à OCI Object Storage

Pour charger des données à partir d'un cube de partition fédérée vers la table de faits dans Autonomous Data Warehouse, Essbase utilise le package DBMS_CLOUD, disponible avec Autonomous Database.

Afin d'accéder au package DBMS_CLOUD, vous devez avoir sélectionné l'option d'intégration d'Essbase à OCI Object Storage lors du déploiement de la pile Oracle Essbase à partir d'Oracle Cloud Marketplace.

Pour plus d'informations, reportez-vous à Déploiement d'Essbase à partir de Marketplace pour les partitions fédérées.

Configuration d'informations d'identification pour le chargement de données

Pour pouvoir effectuer des opérations de chargement de données via Essbase vers Autonomous Data Warehouse, un workflow d'étapes doit être suivi afin d'activer les informations d'identification cloud et de pouvoir les utiliser avec les partitions fédérées.

Types d'utilisateur dans le workflow d'informations d'identification de chargement de données

Les utilisateurs disposant des types d'accès ci-après sont impliqués dans le workflow requis, ou peuvent l'être, dans le cadre de la configuration d'un cube de partition fédérée pour le chargement de données. Dans votre organisation, ces rôles peuvent être distincts (la configuration est alors un workflow collaboratif) ou combinés (une personne dispose de tous les accès requis).

Type d'utilisateur	Rôle dans le workflow
Utilisateur SSH	Peut utiliser la ligne de commande du système d'exploitation pour accéder, en tant qu'utilisateur opc, à l'instance Essbase déployée sur Oracle Cloud Infrastructure. (Peut être la personne qui a déployé Essbase en tant que pile sur OCI.)
Utilisateur de base de données	Connaît le mot de passe et le nom de schéma Autonomous Data Warehouse, les mêmes schéma et mot de passe que ceux utilisés pour créer la connexion Essbase à Oracle Database (un prérequis pour la création de la partition fédérée).
Utilisateur OCI	Peut accéder à la console OCI, y compris au bucket de stockage d'objet pour le catalogue Essbase.
Administrateur de base de données	Connaît le mot de passe et le nom de schéma de l'administrateur Oracle Database.
Administrateur Essbase	Administrateur système Essbase. Peut être l'administrateur Essbase initial créé par l'administrateur de domaine d'identité (qui peut également être l'utilisateur OCI) ou peut être un autre administrateur système Essbase créé après la fin du déploiement Essbase.
Gestionnaire d'applications Essbase	Gestionnaire/propriétaire d'une application Essbase, créé après la fin du déploiement Essbase.

Workflow d'informations d'identification de chargement de données

Le workflow d'étapes suivant doit être effectué pour chaque schéma de base de données utilisé avec une partition fédérée.

Utilisateur OCI : suivez les instructions de Déploiement d'Essbase à partir de Marketplace pour les partitions fédérées afin de déployer Essbase dans la location OCI avec les sélections appropriées pour les partitions fédérées.
Utilisateur de base de données, administrateur Essbase ou gestionnaire d'applications Essbase : connectez-vous à l'interface Web Essbase et créez une connexion à Autonomous Data Warehouse, comme décrit dans Création d'une connexion pour les partitions fédérées.
Utilisateur de base de données, administrateur Essbase ou gestionnaire d'applications Essbase : créez la partition fédérée, comme décrit dans Création d'une partition fédérée.
Utilisateur OCI : à partir de votre profil utilisateur dans la console OCI, générez et copiez un jeton d'authentification. Fournissez ce jeton et votre nom d'utilisateur à l'utilisateur SSH.

Reportez-vous à Obtention d'un jeton d'authentification.
Utilisateur SSH : exécutez le script de préparation de chargement de données, disponible sur l'instance Essbase sur OCI. Vous n'avez besoin d'exécuter le script qu'une seule fois par schéma de base de données dans Autonomous Data Warehouse.

Exemple :
1. Passez à l'utilisateur oracle.
```
sudo su oracle
```
2. Accédez à l'emplacement du script.
```
cd /u01/vmtools/config/adwwb_dbms
```
3. Exécutez le script.
```
./configure-dbms-writeback.sh
```
  Remarque :
  Pour consulter les options du script, exécutez le script avec l'argument -h ou --help. Syntaxe : ./configure-dbms-writeback.sh [--help | -h]
  
  Remarque :
  Vous pouvez éventuellement exécuter le script avec l'option de coffre. Cette option définit le script de sorte à prendre les informations d'identification d'administrateur de base de données dans le coffre, accessibles à l'aide de l'OCID, au lieu de vous demander le mot de passe. Syntaxe : ./configure-dbms-writeback.sh [--vault | -V]
4. A l'invite, entrez les informations requises :
  - Mot de passe de l'administrateur de base de données, si vous n'avez pas exécuté le script avec l'option de coffre. Le mot de passe est une information protégée : le texte que vous saisissez dans l'invite de commande n'est donc pas visible.
  - Nom et mot de passe de l'utilisateur de base de données. Le mot de passe est une information protégée : le texte que vous saisissez dans l'invite de commande n'est donc pas visible.
  - Jeton d'authentification et nom d'utilisateur de l'utilisateur OCI. Saisissez la chaîne d'identification d'utilisateur complète. Pour obtenir cette chaîne, accédez à la console OCI et cliquez sur l'icône de profil dans l'angle supérieur droit afin d'afficher l'aperçu du profil utilisateur. Copiez la chaîne complète affichée en dessous de Profil et au-dessus de Location.
Le script crée les informations d'identification cloud nécessaires et les stocke dans le schéma de base de données. Il n'est pas nécessaire de réexécuter le script lorsque vous redémarrez OCI, Essbase ou les applications Essbase.

Vous pouvez maintenant charger des données via Essbase pour mettre à jour la table de faits Autonomous Data Warehouse.

Remarque :

Pour l'utilisateur SSH : si le jeton d'authentification de l'utilisateur OCI employé dans le script de préparation de chargement de données ne permet plus d'accéder au bucket de stockage d'objet pour le catalogue Essbase, vous devez trouver un autre utilisateur OCI satisfaisant les exigences répertoriées dans Types d'utilisateur dans le workflow de préparation de chargement de données et réeffectuer les étapes du workflow.

Autres remarques concernant le chargement de données de partition fédérée

Emplacement du fichier de données source

Avant d'effectuer un chargement de données via Essbase vers la table de faits, Oracle vous recommande de télécharger le fichier de données vers le serveur Essbase. Le chargement de données côté client est pris en charge mais il prend plus de temps.

Outils de chargement de données autres qu'Essbase

Si vous n'avez pas besoin de charger des données via Essbase vers Autonomous Data Warehouse, vous pouvez utiliser Outils de données dans Autonomous Database pour charger des données vers la table de faits et effectuer d'autres tâches de gestion. Toutefois, assurez-vous que la table de faits et l'outline de cube restent synchronisés. Reportez-vous à Précautions relatives aux métadonnées pour les cubes de partition fédérée.

Fichiers de données au format SGBD

Le chargement de fichiers d'export de données à un format adapté à Essbase vers des cubes de partition fédérée peut être très long. Pour optimiser les chargements de données, employez un fichier source au format SGBD. Vous pouvez effectuer un chargement en utilisant la commande de calcul DATAEXPORT avec l'option DataExportCSVFormat. Les fichiers au format CSV peuvent être chargés plus rapidement car ils sont conformes aux options de format de package DBMS_CLOUD pour les fichiers source.

Dimension de pivot dans la table de faits et source d'entrée de chargement de données

La dimension de pivot employée dans les fichiers d'entrée de chargement de données doit être identique à celle de la table de faits.

Par exemple, dans la table de faits suivante, la dimension de pivot est la dimension Measures (Sales, COGS, Margin, etc).

Table de faits de données et de métadonnées dénormalisées dans SQL Developer, avec les en-têtes de colonne "Year", "Product", "Market", "Scenario", "Sales", "COGS", "Margin", "Marketing", "Payroll", "Misc", "Total Expenses", "Profit", "Opening Inventory", "Additions" et "Ending Inventory".

Un fichier d'entrée de chargement de données acceptable pour cette table de faits présente une forme similaire car il a la même dimension de pivot. Exemple (tronqué) :

"Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions","Ending Inventory"
"Jan","100-10","New York","Actual",678,271,407,94,51,0,145,262,2101,644,2067
"Feb","100-10","New York","Actual",645,258,387,90,51,1,142,245,2067,619,2041
"Mar","100-10","New York","Actual",675,270,405,94,51,1,146,259,2041,742,2108

Si la dimension de pivot du fichier d'entrée est différente de celle de la table de faits, une erreur est renvoyée et le job de chargement de données prend fin.

Non-prise en charge de plusieurs fichiers d'import MaxL

L'import de données à partir de plusieurs fichiers en parallèle à l'aide d'une instruction MaxL import contenant des caractères génériques n'est pas pris en charge pour les cubes de partition fédérée.