Gestione e risoluzione dei problemi di un cubo di partizione federata

Eliminare la partizione federata

Rimuovere la partizione federata e la connessione ad essa associata (se non utilizzata), come descritto in Rimuovere una partizione federata.

Eseguire il cleanup degli oggetti e delle tabelle di metadati correlati alla partizione federata

Dallo schema utente della partizione federata in Autonomous Data Warehouse, eliminare tutte le tabelle e gli altri oggetti generati da Essbase che non è stato possibile rimuovere con la partizione federata.

1. Collegarsi tramite SSH all'host del server Essbase come utente opc.

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

2. Passare all'utente oracle e andare alla relativa directory home.

                     sudo su - oracle
                  

3. Andare alla directory delle applicazioni.

                     cd /u01/data/essbase/app
                  

4. Utilizzando il nome dell'applicazione e del cubo Essbase, identificare il prefisso univoco associato agli oggetti e ai metadati della partizione federata.

   1. Recuperare il nome dell'applicazione (AppName). Il nome fa distinzione tra maiuscole e minuscole, pertanto acquisire la forma esatta. In questo esempio, AppName = Sample.

      ls
      Sample

   2. Contare il numero di caratteri (appx) nel nome dell'applicazione.

      Esempio: appx = 6.

   3. Passare alla directory del cubo e recuperare il nome del cubo (DbName). Il nome fa distinzione tra maiuscole e minuscole, pertanto acquisire la forma esatta. In questo esempio, DbName = Basic.

      cd /Sample
      ls
      Basic

   4. Contare il numero di caratteri (dby) nel nome del cubo.

      Esempio: dby = 5.

   5. Creare Prefix come:

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

      Esempio:

      <Prefix> = ESSAV_6Sample_5Basic_

5. Utilizzando SQL Developer o un altro strumento, connettersi a Oracle Database come utente dello schema a cui è connessa la partizione federata.

6. Eseguire un'istruzione SELECT per creare una lista di oggetti associati all'applicazione della partizione federata. Si tratta degli oggetti di cui verrà eseguito il cleanup nel passo successivo.

   Formato dell'istruzione SELECT:

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

   Esempio:

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

7. Eseguire una procedura PL/SQL memorizzata per effettuare il cleanup di tutte le viste analitiche, i package, le gerarchie, le tabelle e gli altri oggetti associati a Prefix.

   Esempio

   Sostituire ESSAV_6Sample_5Basic_ con 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. Eliminare e aggiornare le tabelle associate relative ai metadati. Prima, è necessario recuperare i valori per ESSBASE_INSTANCE_UNIQUE_ID e OTL_ID.

   1. Collegarsi tramite SSH all'host del server Essbase come utente opc.

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

   2. Passare all'utente oracle e andare alla relativa directory home.

                              sudo su - oracle
                           

   3. Cercare il processo dell'agente Essbase.

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

      Il comando precedente dovrebbe restituire una lista di processi che iniziano con oracle seguito da due ID processo, ad esempio:

      oracle   10769  19563 ...

      Prendere in considerazione il primo ID processo che verrà utilizzato come <PID> nel passo successivo.

   4. Utilizzare il comando strings per acquisire il valore di ESSBASE_INSTANCE_UNIQUE_ID.

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

      Esempio:

                              strings /proc/10769/environ | grep ESSBASE_INSTANCE_UNIQUE_ID
                           

      Il comando precedente dovrebbe restituire il valore di ESSBASE_INSTANCE_UNIQUE_ID, ad esempio:

      ESSBASE_INSTANCE_UNIQUE_ID=EWRnHFlQteCEzWUhF7P3TPKunf3bYs

   5. Utilizzando SQL Developer o un altro strumento, connettersi a Oracle Database come utente dello schema a cui è connessa la partizione federata.

   6. Eseguire un'istruzione SELECT per recuperare il valore di OTL_ID.

      Formato dell'istruzione SELECT:

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

      Esempio

      Sostituire ESSAV_6Sample_5Basic con AppName e sostituire 'EWRnHFlQteCEzWUhF7P3TPKunf3bYs' con ESSBASE_INSTANCE_UNIQUE_ID.

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

   7. La query precedente dovrebbe restituire il valore di OTL_ID, ad esempio:

      62

   8. Eseguire una procedura PL/SQL memorizzata per eliminare le tabelle correlate ai metadati associate a OTL_ID.

      Esempio

      Sostituire 62 con 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. Eseguire un'istruzione UPDATE per impostare la tabella ESSAV_OTL_MTD_VERSION sullo stato inattivo.

      Esempio

      Sostituire ESSAV_6Sample_5Basic con AppName e sostituire EWRnHFlQteCEzWUhF7P3TPKunf3bYs con ESSBASE_INSTANCE_UNIQUE_ID.

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

Ricreare la connessione e la partizione federata

1. Ricreare la connessione a Autonomous Data Warehouse. Può trattarsi di una connessione globale (sotto l'icona principale Origini nell'interfaccia Web di Essbase) oppure può trovarsi nelle origini definite solo per l'applicazione. Seguire le istruzioni riportate in connessione. Accertarsi di eseguire il test della connessione e di salvarla.

2. Ricreare la partizione federata, come descritto in Creare una partizione federata.

3. Se continua a essere visualizzato un errore di connessione come, ad esempio, Errore Essbase (1350012): Tentativo di connessione a OCI non riuscito, controllare https://support.oracle.com/rs?type=doc&id=2925030.1.