Manutenção e Solução de Problemas de Cubo de Partição Federada

Eliminar a Partição Federada

Remova a partição federada e a conexão associada a ela (se, de outra forma, não for utilizada), conforme descrito em Remover uma Partição Federada.

Remover Objetos Relacionados à Partição Federada e Tabelas de Metadados

No esquema de usuário partição federada no Autonomous Data Warehouse, elimine quaisquer tabelas geradas pelo Essbase e outros objetos que não foram removidos com a partição federada.

1. ssh para o host do Servidor do Essbase como o usuário opc.

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

2. Altere para o usuário oracle (e vá para o respectivo diretório home).

                     sudo su - oracle
                  

3. Navegue até o diretório de aplicativos.

                     cd /u01/data/essbase/app
                  

4. Usando o aplicativo Essbase e o nome do cubo, identifique o prefixo exclusivo associado aos seus objetos e metadados da partição federada.

   1. Obtenha o nome do aplicativo (AppName). O nome faz distinção entre maiúsculas e minúsculas; portanto, capture o tipo de letra exato. Neste exemplo, AppName = Amostra.

      ls
      Sample

   2. Conte o número de caracteres (appx) no nome do aplicativo.

      Exemplo: appx = 6.

   3. Navegue até o diretório do cubo e obtenha o nome do cubo (DbName). O nome faz distinção entre maiúsculas e minúsculas; portanto, capture o tipo de letra exato. Neste exemplo, DbName = Básico.

      cd /Sample
      ls
      Basic

   4. Conte o número de caracteres (dby) no nome do cubo.

      Exemplo: dby = 5.

   5. Crie o Prefixo como:

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

      Exemplo:

      <Prefix> = ESSAV_6Sample_5Basic_

5. Usando o SQL Developer ou outra ferramenta, estabeleça conexão com o Oracle Database como o usuário do esquema ao qual a Partição Federada está conectada.

6. Execute uma instrução SELECT para criar uma lista de objetos associados ao seu aplicativo de partição federada. Esses são objetos que você vai remover na próxima etapa.

   O formato da instrução SELECT é:

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

   Exemplo:

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

7. Execute um procedure PL/SQL armazenado que remova todas as views analíticas, pacotes, hierarquias, tabelas e outros objetos associados ao Prefixo.

   Exemplo

   Substitua ESSAV_6Sample_5Basic_ pelo seu Prefixo.

   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. Elimine e atualize tabelas associadas relativas a metadados. Primeiro, você precisa obter valores para ESSBASE_INSTANCE_UNIQUE_ID e OTL_ID.

   1. ssh para o host do Servidor do Essbase como o usuário opc.

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

   2. Altere para o usuário oracle (e vá para o respectivo diretório home).

                              sudo su - oracle
                           

   3. Procure o processo Agente do Essbase.

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

      O comando acima deve retornar uma listagem de processos que começa com oracle seguido de dois IDs de processo; por exemplo,

      oracle   10769  19563 ...

      Considere o primeiro ID do processo como sendo <PID>, o qual você vai usar na próxima etapa.

   4. Use o comando strings para capturar o valor de ESSBASE_INSTANCE_UNIQUE_ID.

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

      Exemplo:

                              strings /proc/10769/environ | grep ESSBASE_INSTANCE_UNIQUE_ID
                           

      O comando acima deve retornar o valor de ESSBASE_INSTANCE_UNIQUE_ID; por exemplo,

      ESSBASE_INSTANCE_UNIQUE_ID=EWRnHFlQteCEzWUhF7P3TPKunf3bYs

   5. Usando o SQL Developer ou outra ferramenta, estabeleça conexão com o Oracle Database como o usuário do esquema ao qual a Partição Federada está conectada.

   6. Execute uma instrução SELECT para obter o valor de OTL_ID.

      O formato da instrução SELECT é:

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

      Exemplo

      Substitua ESSAV_6Sample_5Basic por seu AppName e substitua 'EWRnHFlQteCEzWUhF7P3TPKunf3bYs' por seu ESSBASE_INSTANCE_UNIQUE_ID.

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

   7. A consulta acima deve retornar o valor de OTL_ID; por exemplo,

      62

   8. Execute um procedure PL/SQL armazenado para eliminar tabelas relativas a metadados associadas a OTL_ID.

      Exemplo

      Substitua 62 por seu 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. Execute uma instrução UPDATE para definir a tabela ESSAV_OTL_MTD_VERSION para o status inativo.

      Exemplo

      Substitua ESSAV_6Sample_5Basic por seu AppName e substitua EWRnHFlQteCEzWUhF7P3TPKunf3bYs por seu ESSBASE_INSTANCE_UNIQUE_ID.

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

Recrie a Conexão e a Partição Federada

1. Recrie a conexão com o Autonomous Data Warehouse. Essa pode ser uma conexão global (abaixo do ícone Origens principal na interface Web do Essbase) ou pode estar nas Origens definidas apenas para o aplicativo. Siga as instruções em conexão. Certifique-se de Testar e Salvar a conexão.

2. Recrie a partição federada, conforme descrito em Criar uma Partição Federada.

3. Se você continuar a ver um erro de conexão, como Essbase Error(1350012): Attempt to connect to OCI failed, verifique https://support.oracle.com/rs?type=doc&id=2925030.1.