Maintenance et dépannage des cubes de partition fédérée

Suppression de la partition fédérée

Enlevez la partition fédérée et la connexion qui lui est associée (si elle n'est employée à aucune autre fin), comme décrit dans Suppression d'une partition fédérée.

Nettoyage des tables de métadonnées et objets associés à la partition fédérée

Dans le schéma utilisateur de la partition fédérée dans Autonomous Data Warehouse, supprimez les tables générées par Essbase et les autres objets qui n'ont pas été enlevés avec la partition fédérée.

1. Connectez-vous via SSH à l'hôte du serveur Essbase en tant qu'utilisateur opc.

                     ssh -i MPOCI_KEY.pem opc@100.xxx.xxx.xxx
                  

2. Remplacez-le par l'utilisateur oracle (et accédez à son répertoire de base).

                     sudo su - oracle
                  

3. Accédez au répertoire d'applications.

                     cd /u01/data/essbase/app
                  

4. Servez-vous du nom du cube et de l'application Essbase pour identifier le préfixe unique associé aux objets et métadonnées de partition fédérée.

   1. Récupérez le nom de l'application (AppName). Le nom respecte la casse. Veillez donc à respecter strictement les majuscules et minuscules. Dans cet exemple, AppName = Sample.

      ls
      Sample

   2. Comptez le nombre de caractères (appx) dans le nom de l'application.

      Exemple : appx = 6.

   3. Accédez au répertoire de cube et récupérez le nom du cube (DbName). Le nom respecte la casse. Veillez donc à respecter strictement les majuscules et minuscules. Dans cet exemple, DbName = Basic.

      cd /Sample
      ls
      Basic

   4. Comptez le nombre de caractères (dby) dans le nom du cube.

      Exemple : dby = 5.

   5. Construisez Prefix comme suit :

      ESSAV_<appx><AppName>_<dby><DbName>_

      Exemple :

      <Prefix> = ESSAV_6Sample_5Basic_

5. A l'aide de SQL Developer ou d'un autre outil, connectez-vous à Oracle Database en tant qu'utilisateur du schéma auquel la partition fédérée est connectée.

6. Exécutez une instruction SELECT pour créer la liste des objets associés à votre application de partition fédérée. Ce sont ces objets que vous allez nettoyer lors de la prochaine étape.

   Le format de l'instruction SELECT est le suivant :

   SELECT * FROM user_OBJECTS WHERE OBJECT_NAME like '<Prefix>%';

   Exemple :

   SELECT * FROM user_OBJECTS WHERE OBJECT_NAME like 'ESSAV_6Sample_5Basic_%';

7. Exécutez une procédure PL/SQL stockée qui nettoie l'ensemble des vues analytiques, des packages, des hiérarchies, des tables et des autres objets associés à Prefix.

   Exemple

   Remplacez ESSAV_6Sample_5Basic_ par votre valeur Prefix.

   SET SERVEROUTPUT ON;
   
   declare
     prefix_str varchar2(70) := 'ESSAV_6Sample_5Basic_';
   
   BEGIN
   
     FOR c IN ( SELECT ANALYTIC_VIEW_NAME FROM user_analytic_views WHERE ANALYTIC_VIEW_NAME like prefix_str || '%' )
     LOOP
       EXECUTE IMMEDIATE 'DROP ANALYTIC VIEW "' || c.ANALYTIC_VIEW_NAME || '" ';
       DBMS_OUTPUT.PUT_LINE('ANALYTIC VIEW ' || c.ANALYTIC_VIEW_NAME || ' dropped successfully.');
     END LOOP;
   
     FOR c IN ( SELECT distinct OBJECT_NAME FROM USER_PROCEDURES WHERE OBJECT_TYPE='PACKAGE' and OBJECT_NAME like prefix_str || '%' )
     LOOP
       EXECUTE IMMEDIATE 'DROP PACKAGE "' || c.OBJECT_NAME || '" ';
       DBMS_OUTPUT.PUT_LINE('PACKAGE ' || c.OBJECT_NAME || ' dropped successfully.');
     END LOOP;
   
     FOR c IN ( SELECT distinct HIER_NAME FROM USER_HIERARCHIES WHERE HIER_NAME like prefix_str || '%' )
     LOOP
       EXECUTE IMMEDIATE 'DROP HIERARCHY "' || c.HIER_NAME || '" ';
       DBMS_OUTPUT.PUT_LINE('HIERARCHY ' || c.HIER_NAME || ' dropped successfully.');
     END LOOP;
   
     FOR c IN ( SELECT distinct DIMENSION_NAME FROM USER_ATTRIBUTE_DIM_TABLES_AE WHERE DIMENSION_NAME like prefix_str || '%' )
     LOOP
       EXECUTE IMMEDIATE 'DROP ATTRIBUTE DIMENSION "' || c.DIMENSION_NAME || '" ';
       DBMS_OUTPUT.PUT_LINE('ATTRIBUTE DIMENSION ' || c.DIMENSION_NAME || ' dropped successfully.');
     END LOOP;
   
     FOR c IN ( SELECT distinct TABLE_NAME FROM USER_TABLES WHERE TABLE_NAME like prefix_str || '%' )
     LOOP
       EXECUTE IMMEDIATE 'DROP TABLE "' || c.TABLE_NAME || '" purge';
       DBMS_OUTPUT.PUT_LINE('TABLE ' || c.TABLE_NAME || ' dropped successfully.');
     END LOOP;
   
     FOR c IN ( SELECT distinct VIEW_NAME FROM USER_VIEWS WHERE VIEW_NAME like prefix_str || '%' )
     LOOP
       EXECUTE IMMEDIATE 'DROP VIEW "' || c.VIEW_NAME || '" ';
       DBMS_OUTPUT.PUT_LINE('VIEW ' || c.VIEW_NAME || ' dropped successfully.');
     END LOOP;
   
     FOR c IN ( SELECT distinct TYPE_NAME FROM USER_TYPES WHERE TYPE_NAME like prefix_str || '%' )
     LOOP
       EXECUTE IMMEDIATE 'DROP TYPE "' || c.TYPE_NAME || '" FORCE';
       DBMS_OUTPUT.PUT_LINE('TYPE ' || c.TYPE_NAME || ' dropped successfully.');
     END LOOP;
   
   END;
   /
   

8. Supprimez et mettez à jour les tables liées aux métadonnées associées. Vous devez tout d'abord obtenir les valeurs de ESSBASE_INSTANCE_UNIQUE_ID et OTL_ID.

   1. Connectez-vous via SSH à l'hôte du serveur Essbase en tant qu'utilisateur opc.

                              ssh -i MPOCI_KEY.pem opc@100.xxx.xxx.xxx
                           

   2. Remplacez-le par l'utilisateur oracle (et accédez à son répertoire de base).

                              sudo su - oracle
                           

   3. Recherchez le processus d'agent Essbase.

                              ps -ef | grep ESSS | grep -v "grep"
                           

      La commande ci-dessus doit renvoyer une liste de processus commençant par oracle et suivi de deux ID de processus. Par exemple :

      oracle   10769  19563 ...

      Le premier ID de processus correspond à <PID>, que vous utiliserez dans la prochaine étape.

   4. Utilisez la commande strings pour obtenir la valeur de ESSBASE_INSTANCE_UNIQUE_ID.

      strings /proc/<PID>/environ | grep ESSBASE_INSTANCE_UNIQUE_ID

      Exemple :

                              strings /proc/10769/environ | grep ESSBASE_INSTANCE_UNIQUE_ID
                           

      La commande ci-dessus doit renvoyer la valeur de ESSBASE_INSTANCE_UNIQUE_ID. Par exemple :

      ESSBASE_INSTANCE_UNIQUE_ID=EWRnHFlQteCEzWUhF7P3TPKunf3bYs

   5. A l'aide de SQL Developer ou d'un autre outil, connectez-vous à Oracle Database en tant qu'utilisateur du schéma auquel la partition fédérée est connectée.

   6. Exécutez une instruction SELECT pour obtenir la valeur de OTL_ID.

      Le format de l'instruction SELECT est le suivant :

      SELECT OTL_ID FROM ESSAV_OTL_MTD_VERSION where APPNAME ='<AppName>' and "JAGENT_INSTANCE_ID"='<ESSBASE_INSTANCE_UNIQUE_ID>';

      Exemple

      Remplacez ESSAV_6Sample_5Basic par la valeur de AppName, puis 'EWRnHFlQteCEzWUhF7P3TPKunf3bYs' par la valeur de ESSBASE_INSTANCE_UNIQUE_ID.

      SELECT OTL_ID FROM ESSAV_OTL_MTD_VERSION where APPNAME ='ESSAV_6Sample_5Basic' and "JAGENT_INSTANCE_ID"='EWRnHFlQteCEzWUhF7P3TPKunf3bYs';

   7. La requête ci-dessus doit renvoyer la valeur de OTL_ID. Par exemple :

      62

   8. Exécutez une procédure PL/SQL stockée pour supprimer les tables liées aux métadonnées associées à OTL_ID.

      Exemple

      Remplacez 62 par la valeur de OTL_ID.

      SET SERVEROUTPUT ON;
      BEGIN
        FOR c IN ( SELECT distinct TABLE_NAME FROM USER_TABLES WHERE TABLE_NAME like 'ESSAV_MTD_62_%' )
        LOOP
          EXECUTE IMMEDIATE 'DROP TABLE "' || c.TABLE_NAME || '" purge';
          DBMS_OUTPUT.PUT_LINE('TABLE ' || c.TABLE_NAME || ' dropped successfully.');
        END LOOP;
      END;
      /
      

   9. Exécutez une instruction UPDATE pour définir la table ESSAV_OTL_MTD_VERSION sur le statut inactif.

      Exemple

      Remplacez ESSAV_6Sample_5Basic par la valeur de AppName, puis EWRnHFlQteCEzWUhF7P3TPKunf3bYs par la valeur de ESSBASE_INSTANCE_UNIQUE_ID.

      UPDATE "ESSAV_OTL_MTD_VERSION" SET  "OTL_STATUS" = 'INACTIVE'  where APPNAME ='ESSAV_6Sample_5Basic' and "JAGENT_INSTANCE_ID"='EWRnHFlQteCEzWUhF7P3TPKunf3bYs';
      commit;

Recréation de la connexion et de la partition fédérée

1. Recréez la connexion à Autonomous Data Warehouse. Cette connexion peut être globale (sous l'icône Sources principale dans l'interface Web Essbase) ou elle peut se trouver dans les sources définies uniquement pour l'application. Suivez les instructions décrites dans connexion. Veillez à tester et à enregistrer la connexion.

2. Recréez la partition fédérée, comme décrit dans Création d'une partition fédérée.

3. Si une erreur de connexion telle que Erreur Essbase (1350012) : Echec de la tentative de connexion à OCI continue d'apparaître, reportez-vous à https://support.oracle.com/rs?type=doc&id=2925030.1.