Export de métadonnées à partir d'une application Planning vers une source de données relationnelle

L'utilitaire Chargement d'outline permet d'exporter des métadonnées vers une source de données relationnelle.

Remarque :

Vous ne pouvez pas exporter de données vers une source de données relationnelle via l'utilitaire Chargement d'outline.

Oracle recommande aux utilisateurs qui adoptent cette fonctionnalité de se familiariser avec les bases de données relationnelles, le langage de requête SQL et les propriétés de connexion JDBC. Pour les applications Oracle Hyperion Planning, vous trouverez des exemples de ces propriétés dans la table HSPSYS_DATASOURCE de la base de données système. Celle-ci est située par défaut dans la base de données relationnelle créée lors de la sélection de la tâche Configurer la base de données sous Planning, dans le configurateur EPM System.

Ces paramètres de ligne de commande sont disponibles dans l'utilitaire Chargement de l'outline afin d'exporter des données vers une source relationnelle.

  • /ER[:RDBConnectionPropertiesFileName]

  • /ERA

  • /REQ:exportQueryOrKey

  • /REC:catalog

  • /RED:driver

  • /RER:url

  • /REU:userName

  • /REP:password

Remarque :

Les paramètres /ER et /REQ s'excluent mutuellement.

Pour obtenir une description de ces paramètres, reportez-vous à la section Paramètres de ligne de commande pour l'utilitaire Chargement de l'outline.

Le format de la requête d'export est le suivant : INSERT INTO<tableName>[ (column1, column2, ...)] VALUES (property1, property2,...).

Remarques :

  • <tableName> est le nom de la table dans laquelle les valeurs exportées seront insérées.

  • (column1, column2, ...) est une liste facultative de noms de colonne. Les valeurs (propriétés) seront insérées dans la table.

  • (property1, property2, ...) ne sont pas des valeurs au sens strict, mais plutôt des noms de propriété de membre (comme dans les en-têtes de colonne).

    Remarque :

    Contrairement aux enregistrements d'en-tête, le nom est indiqué par "Member", pas par le nom de la dimension.

Par exemple :

Supposons que Planning dispose de deux membres dans la dimension Entity : e1 avec la description "e1's description" et e11 avec la description "e11's description". e1 réside sous Entity, et e11 réside sous e1. La dimension de planification se présente donc de la façon suivante :

Entité

   e1
      e11

Supposons que la table de destination my_table comporte trois colonnes : column1, column2, column3.

Insert into my_table values (Member, Parent, Description) déclenche l'ajout des lignes suivantes dans my_table :

E1     e1's description     Entity
E11    e2's description     e1

Qui est identique à :

Insert into my_table (column1, column2, column3) values (Member, Parent, Description)

Remarque :

La table doit contenir au moins autant de colonnes que de propriétés spécifiées.

Vous disposez de deux opérateurs spéciaux à préciser dans la requête : <columns> et <properties>. <columns> développe tous les noms de colonne de la table. <properties> développe toutes les propriétés de la dimension exportée, comme affiché avec le commutateur /M.

Insert into my_table values (<properties>)

Qui charge toutes les propriétés d'entité dans my_table.

Qui est identique à :

Insert into my_table (column1, column2, ….. column23) values (<properties>)

Si my_table contenait exactement le même nombre de colonnes et de propriétés, la requête suivante produirait un résultat identique :

Insert into my_table (<columns>) values (<properties>)

Vous pouvez également utiliser le nom des colonnes de table pour extraire les propriétés de membre. Par exemple, sample_table, avec les colonnes : Member, Parent et Description. Les requêtes suivantes produiraient le même résultat que le premier exemple :

Insert into sample_table values (<columns>)
Insert into sample_table (<columns>) values (<columns>)

Exemple 5-6 Exemple : fichier de propriétés pour l'export de métadonnées vers une source de données relationnelle

/A:App1
/U:admin

/ERA

/D:Entity

/REQ:ENTITY_EXPORT_QUERY1

ENTITY_EXPORT_QUERY1=INSERT INTO DataTable_Entity1 VALUES (Member, Parent, Description, Color) 

#ENTITY_EXPORT_QUERY1=Insert into PS3ORA.DataTable_Entity1 (Member, Parent, Description, Color) values (Member, Parent, Description, Color)

Exemple 5-7 Exemple : fichier de propriétés pour l'export avec un alias à partir d'une outline et vers une source de données relationnelle

/A:expe
/U:admin
/ERA
/D:Entity
/REQ:ENTITY_EXPORT_QUERY1
/C2A:AliasLabel
AliasLabel:(AliasTableName, Alias: reallyLongAliasTableName30Char)

ENTITY_EXPORT_QUERY1=Insert into Test(Member, Parent, AliasTableName) values (Member,
Parent, Alias: reallyLongAliasTableName30Char)

Par rapport à l'exemple précédent, prenons les hypothèses suivantes :

  • La table Test comporte trois colonnes (Member, Parent et AliasTableName) et elle est vide.

  • La dimension Entity possède un membre, e1, sous la racine (Entity).

Après l'exécution de la requête précédente, la table Test comporte une seule entrée :


Cette image illustre la sortie de la table Test après l'exécution la requête précédente.

Remarque :

Les commutateurs /C2A et/ou Label permettent de contourner la restriction de 30 caractères sur les noms de colonne dans les tables relationnelles Oracle (par exemple, Alias: reallyLongAliasTableName30Char comporte plus de 30 caractères et n'est pas autorisé comme nom de colonne dans les tables relationnelles Oracle).