Mit DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX erstellen Sie einen JSON-Suchindex für Dateien in Object Storage. Sie können eine Aktualisierungsrate konfigurieren, die angibt, wie oft der Index für neue Uploads oder Löschvorgänge in Minuten aktualisiert wird. Weitere Informationen finden Sie unter JSON-Suchindex für JSON-Dokumente in Dateien erstellen.

Die folgenden Objekte werden beim Erstellen eines JSON-Suchindex erstellt:

• Ein JSON-Suchindex index_name in den Object Storage-JSON-Dateien.

• Eine lokale Tabelle INDEX_NAME$TXTIDX. Diese Tabelle ist die Zuordnungstabelle zwischen Ihren Dokumenten in den Dateien in Object Storage und dem JSON-Suchindex, der in der Datenbank erstellt wird. Weitere Informationen finden Sie unter Referenztabelle für JSON-Suchindex.

• Eine Ansicht mit dem Standardnamen INDEX_NAME. Sie können die Ansicht verwenden, um eine Suche mit JSON_TEXTCONTAINS auszuführen. Diese Ansicht wird über der Tabelle INDEX_NAME$TXTIDX erstellt. Weitere Informationen finden Sie unter Referenzansicht für JSON-Suchindex.

• Eine Fehlerlogtabelle mit dem Standardsuffix index_name$txtidx_err. Weitere Informationen finden Sie unter Fehlerlogtabelle.

Der Vorgang zum Erstellen des JSON-Suchindex wird in der Ansicht ALL_SCHEDULER_JOB_RUN_DETAILS protokolliert. Weitere Informationen finden Sie unter Textindexerstellung überwachen.

Autonomous Database unterstützt die Erstellung von JSON-Suchindizes für eine Vielzahl von Textdateien, die JSON-Dokumente enthalten. Beispiel: Sie können JSON-Dateien sowohl im komprimierten als auch im unkomprimierten Format indizieren oder ein anderes JSON-Dokumenttrennzeichen auswählen. Weitere Informationen zu den Optionen für die Dateiverarbeitung finden Sie unter DBMS_CLOUD Package.

Weitere Informationen finden Sie unter Mit Oracle Text indexieren.

Verwenden Sie DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX, um einen JSON-Suchindex für die in Object Storage gespeicherten JSON-Dateien zu erstellen.

1. Erstellen Sie ein Zugangsdatenobjekt, um auf den Quellspeicherort zuzugreifen.

   Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.

2. Führen Sie die Prozedur DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX aus, um einen JSON-Suchindex für die Objektspeicherdateien zu erstellen.

   
   BEGIN 
    DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
           credential_name => 'OBJ_STORE_CRED',
           location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/vcnlogs/',
           index_name      => 'VNCLOGS',
           format          =>  JSON_OBJECT ('json_index' value 'true', 'json_index_doc_len' value 12000, 'file_compression' value 'gzip')
   );
   END;
   /

   In diesem Beispiel wird Folgendes erstellt:

   • Ein JSON-Suchindex VNCLOGS in den Object Storage-Dateien, der sich unter der im Parameter location_uri angegebenen URI befindet.

   • Eine lokale Tabelle VNCLOGS$TXTIDX. Weitere Informationen finden Sie unter Referenztabelle für JSON-Suchindex.

   • Eine View mit dem Namen VNCLOGS. Diese Ansicht wird über der Tabelle VNCLOGS$TXTIDX erstellt. Sie können die Ansicht verwenden, um eine Suche mit JSON_TEXTCONTAINS auszuführen. Weitere Informationen finden Sie unter Referenzansicht für JSON-Suchindex.

   • Eine Fehlerlogtabelle mit dem Namen VNC$TXTIDX_ERR. Die Tabelle enthält eine Liste der ungültigen JSON-Dokumente in Ihren Dateien. Weitere Informationen finden Sie unter Fehlerlogtabelle.

   Nachdem Sie den JSON-Suchindex erstellt haben, können Sie die Ansicht VNCLOGS abfragen. Beispiel:

   SELECT JSON_QUERY (data, '$' returning CLOB pretty) AS RECORD 
    FROM vnclogs WHERE JSON_TEXTCONTAINS(file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}');
   

   Diese Abfrage gibt die Logdetails für die angegebenen IP-Adressen in der JSON_TEXTCONTAINS-Bedingung zurück. Beachten Sie, dass die JSON-Suchindexkriterien in der Spalte file_line_json, der indizierten Spalte in der JSON-Suchindextabelle in der Datenbank angegeben sind, während die JSON-Dokumente direkt aus Object Storage gestreamt werden, dargestellt durch die Spalte data. Die Spalte data enthält den Inhalt der Object Storage-Datei.

   Weitere Informationen finden Sie unter Prozedur CREATE_EXTERNAL_TEXT_INDEX.

Verwenden Sie die Prozedur DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX, um einen JSON-Suchindex für die in Object Storage gespeicherten JSON-Dateien zu löschen.

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

Wenn Sie DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX ausführen, wird der Vorgang zum Erstellen des JSON-Suchindex in der Ansicht ALL_SCHEDULER_JOB_RUN_DETAILS protokolliert.

Sie können die View ALL_SCHEDULER_JOB_RUN_DETAILS abfragen, um den Status und alle vom Job zur Indexerstellung gemeldeten Fehler abzurufen.

Der Name des Jobs DBMS_SCHEDULER wird vom Parameter INDEX_NAME abgeleitet, der beim Aufruf von DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX angegeben wird.

Um die Ansicht ALL_SCHEDULER_JOB_RUN_DETAILS abzufragen, müssen Sie als Benutzer ADMIN angemeldet sein oder über die Berechtigung READ für die Ansicht ALL_SCHEDULER_JOB_RUN_DETAILS verfügen.

Beispiel: Die folgende SELECT-Anweisung mit einer WHERE-Klausel in job_name zeigt die Ausführungsdetails für den Job an:

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

Sie können auch abfragen, ob ein Scheduler-Job für die Indexerstellung vorhanden ist.

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

Weitere Informationen finden Sie unter Prozedur CREATE_EXTERNAL_TEXT_INDEX.

In Ihrer Datenbank wird eine lokale Tabelle mit dem Standardsuffix INDEX_NAME$TXTIDX erstellt. Diese Tabelle wird intern erstellt, wenn Sie DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX ausführen.

Sie können die Tabelle INDEX_NAME$TXTIDX abfragen, um mit dem Schlüsselwort JSON_TEXTCONTAINS nach einer Zeichenfolge zu suchen. Beispiel: Wenn Sie die DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX-Prozedur als INDEX_NAME-Wert als VNCLOGS aufrufen, wird die JSON-Suchindexreferenztabelle VNCLOGS$TXTIDX erstellt.

SELECT * FROM (SELECT object_name, object_path, length, offset 
 FROM vnclogs$txtidx 
 WHERE JSON_TEXTCONTAINS (file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}') 
 ORDER BY mtime DESC) 
 WHERE rownum < 3;
 

Diese Abfrage enthält interne Informationen darüber, wo sich in Ihren Dateien in Object Storage die relevanten Dokumente befinden. Die Abfrage enthält keine tatsächlichen Dokumente.

SELECT * FROM (SELECT object_name, object_path, data
 FROM vnclogs
 WHERE JSON_TEXTCONTAINS (file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}')
 ORDER BY mtime DESC)
 WHERE rownum < 3;
 

Eine Ansicht mit dem Namen INDEX_NAME wird erstellt, wenn Sie DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX ausführen, um einen JSON-Index zu erstellen.