Usar Pesquisa de Texto Completo em Arquivos no Serviço Object Storage

O suporte do Autonomous Database para pesquisa baseada em palavras funciona para formatos de dados comumente usados, por exemplo, CSV ou JSON e com documentos formatados (binário), por exemplo, formatos PDF e DOC (MS Word). Você pode configurar uma taxa de atualização que indique a frequência em minutos na qual o índice é atualizado para quaisquer novos uploads ou exclusões.

Uma tabela local com o sufixo padrão INDEX_NAME$TXTIDX é criada quando você cria um índice no armazenamento de objetos e pode utilizar a tabela para executar uma pesquisa usando a palavra-chave CONTAINS.

Consulte Indexando com o Oracle Text para obter mais informações.

Use DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX para criar um índice de texto em arquivos no armazenamento de objetos.

1. Crie um objeto de credencial para acessar o local de origem.

   Consulte CREATE_CREDENTIAL Procedures para obter mais informações.

2. Execute o procedimento DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX para criar um índice de texto nos arquivos de armazenamento de objetos.

   BEGIN 
   DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
           credential_name => 'DEFAULT_CREDENTIAL',
           location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/ts_data/'
           index_name      => 'EMP',
           format          => JSON_OBJECT ('refresh_rate' value 10)
   );
   END;
   /

   Este exemplo cria um índice de texto EMP nos arquivos de armazenamento de objetos localizados no URI especificado no parâmetro location_uri. A opção refresh_rate no parâmetro format especifica que o índice EMP é atualizado em um intervalo de 10 minutos.

   Isso cria uma tabela local INDEX_NAME$TXTIDX. Você pode utilizar a tabela INDEX_NAME$TXTIDX para executar uma pesquisa usando CONTAINS.

   Por exemplo:

   
    SELECT object_name FROM EMP$TXTIDX
         WHERE CONTAINS(object_name,'king') > 0;
   

   Essa consulta retorna o objeto ou os nomes de arquivo que contêm a string king.

   Consulte Tabela de Referência de Índice de Texto para obter mais informações.

   Você pode consultar uma tabela externa usando a cláusula EXTERNAL MODIFY para recuperar os registros reais.

   
   SELECT * FROM EMPEXTTAB EXTERNAL MODIFY ((location_url object_name));
   

   Observação
   
   A tabela externa EMPEXTTAB é uma tabela externa de amostra que é criada na mesma location_url.

   Consulte Consultar Dados Externos com o Autonomous Database para obter mais informações.

   Consulte CREATE_EXTERNAL_TEXT_INDEX Procedures para obter mais informações.

   Consulte Configurar Políticas e Atribuições para Acessar Recursos para obter mais informações.

Use o procedimento DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX para eliminar um índice de texto em arquivos de armazenamento de objetos.

BEGIN 
DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX (
        index_name => 'EMP',
);
END;
/

Uma tabela local é criada no seu banco de dados com um sufixo padrão INDEX_NAME$TXTIDX. Esta tabela é criada internamente quando você executa o DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

Você pode consultar a tabela INDEX_NAME$TXTIDX para procurar uma string usando a palavra-chave CONTAINS. Por exemplo, quando você chama o procedimento DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX do valor INDEX_NAME como EMP, isso cria o EMP$TXTIDX da tabela de referência de texto.

SELECT object_path, object_name FROM EMP$TXTIDX WHERE CONTAINS(OBJECT_NAME, 'king') > 0;
 
OBJECT_PATH                                                                                      OBJECT_NAME
------------------------------------------------------------------------------------------      ------------------------------------
https://objectstorage.us-phoenix-1.oraclecloud.com/n/example1/b/adbs_data_share/o/ts_data/       data_2_20221026T195313585601Z.json

Essa consulta retorna os nomes de arquivo e o URI de local no armazenamento de objetos que contém a string de texto king, em letras maiúsculas ou minúsculas.

SELECT object_name, mtime FROM EMP$TXTIDX;
 
OBJECT_NAME                     MTIME
----------------------------- -------------------------------------
data_1_20220531T165402Z.json    31-MAY-22 04.54.02.979000 PM +00:00
data_1_20220531T165427Z.json    31-MAY-22 04.54.27.997000 PM +00:00

Esta consulta retorna o nome do arquivo e o timestamp da última modificação dos arquivos de objeto nos quais o índice EMP é criado.

Quando você executa o DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX, a operação de criação de índice de texto é registrada na view ALL_SCHEDULER_JOB_RUN_DETAILS.

Você pode consultar a view ALL_SCHEDULER_JOB_RUN_DETAILS para obter o status e qualquer erro reportado pelo job de criação de índice.

O nome do job DBMS_SCHEDULER é derivado do parâmetro INDEX_NAME especificado quando você chama DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

Para consultar a view ALL_SCHEDULER_JOB_RUN_DETAILS, você deve estar conectado como o usuário ADMIN ou ter o privilégio READ na view ALL_SCHEDULER_JOB_RUN_DETAILS.

Por exemplo, a seguinte instrução SELECT com uma cláusula WHERE em job_name mostra os detalhes da execução do job:

SELECT status, additional_info 
   FROM all_scheduler_job_run_details WHERE LOWER(job_name) = LOWER('index_name$JOB');

Você também pode consultar a existência de um job do scheduler de criação de índice.

SELECT status 
    FROM all_scheduler_jobs where LOWER(job_name) = LOWER('index_name$JOB');

Consulte CREATE_EXTERNAL_TEXT_INDEX Procedures para obter mais informações.