Manutenção e Resolução de Problemas do Cubo de Partição Federada

Suprimir a Partição Federada

Retire a partição federada e a ligação a ela associada (se não for utilizada), conforme descrito em Retirar uma Partição Federada.

Limpar Tabelas de Metadados e Objetos Relacionados da Partição Federada

No schema de utilizador da partição federada no Autonomous Data Warehouse, suprima quaisquer tabelas geradas pelo Essbase e outros objetos que não foram retirados com a partição federada.

1. ssh para o host do Essbase Server como o utilizador opc.

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

2. Altere para o utilizador oracle (e aceda ao respetivo diretório principal).

                     sudo su - oracle
                  

3. Navegue até ao diretório da aplicação.

                     cd /u01/data/essbase/app
                  

4. Ao utilizar a aplicação do Essbase e o nome do cubo, identifique o único prefixo associado aos seus objetos e metadados de partição federada.

   1. Obtenha o nome da aplicação (AppName). O nome é sensível a maiúsculas e minúsculas, pelo que deve capturar as letras exatas. Neste exemplo, AppName = Sample.

      ls
      Sample

   2. Conte o número de caracteres (appx) no nome da aplicação.

      Exemplo: appx = 6.

   3. Navegue até ao diretório do cubo e obtenha o nome do cubo (DbName). O nome é sensível a maiúsculas e minúsculas, pelo que deve capturar as letras exatas. Neste exemplo, DbName = Basic.

      cd /Sample
      ls
      Basic

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

      Exemplo: dby = 5.

   5. Crie o Prefix como:

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

      Exemplo:

      <Prefix> = ESSAV_6Sample_5Basic_

5. Ao utilizar o SQL Developer ou outra ferramenta, ligue à Oracle Database como o utilizador do schema ao qual a Partição Federada está ligada.

6. Execute uma instrução SELECT para criar uma lista de objetos associados à sua aplicação de partição federada. Estes são os objetos que irá limpar no passo seguinte.

   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 procedimento de PL/SQL armazenado que limpa todas as visualizações analíticas, pacotes, hierarquias, tabelas e outros objetos associados ao Prefix.

   Exemplo

   Substitua ESSAV_6Sample_5Basic_ pelo seu 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. Suprima e atualize as tabelas relacionadas com metadados associadas. Primeiro, precisa de obter valores para ESSBASE_INSTANCE_UNIQUE_ID e OTL_ID.

   1. ssh para o host do Essbase Server como o utilizador opc.

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

   2. Altere para o utilizador oracle (e aceda ao respetivo diretório principal).

                              sudo su - oracle
                           

   3. Procure o processo do Agente do Essbase.

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

      O comando acima deverá devolver uma listagem de processos que começa com oracle seguido de duas ID de processo; por exemplo,

      oracle   10769  19563 ...

      Considere a primeira ID de processo como <PID>, que utilizará no passo seguinte.

   4. Utilize 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 deverá devolver o valor de ESSBASE_INSTANCE_UNIQUE_ID; por exemplo,

      ESSBASE_INSTANCE_UNIQUE_ID=EWRnHFlQteCEzWUhF7P3TPKunf3bYs

   5. Ao utilizar o SQL Developer ou outra ferramenta, ligue à Oracle Database como o utilizador do schema ao qual a Partição Federada está ligada.

   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 pelo seu AppName e substitua 'EWRnHFlQteCEzWUhF7P3TPKunf3bYs' pelo 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 deverá devolver o valor de OTL_ID; por exemplo,

      62

   8. Execute um procedimento de PL/SQL armazenado para suprimir tabelas relacionadas com metadados associadas a OTL_ID.

      Exemplo

      Substitua 62 pelo 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 um estado inativo.

      Exemplo

      Substitua ESSAV_6Sample_5Basic pelo seu AppName e substitua EWRnHFlQteCEzWUhF7P3TPKunf3bYs pelo 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;

Recriar a Ligação e a Partição Federada

1. Recrie a ligação ao Autonomous Data Warehouse. Pode ser uma ligação global (abaixo do ícone Origens principal na interface web do Essbase) ou pode estar nas Origens definidas apenas para a aplicação. Siga as instruções em ligação. Certifique-se de que Testa e Grava a ligação.

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

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