Supporto di SharePoint in Autonomous AI Database mediante DBMS_CLOUD

Eseguire i passi riportati di seguito per accedere AI file memorizzati in SharePoint per caricare i dati in Autonomous AI Database per l'analisi.

1. Creare una credenziale SharePoint
   Creare una credenziale con l'ID client e il segreto client di SharePoint e specificare un nome di credenziale.

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'SHAREPOINT_CRED',
       username        => '<client-id>',
       password        => '<client-secret>'
     );
   END;
   /

2. Genera URI SharePoint
   Eseguire DBMS_CLOUD.INIT_SHAREPOINT_URI per generare l'URI di SharePoint per il sito, il sito secondario, l'elenco o l'elemento a cui si desidera accedere.

   DECLARE
     l_location_uri varchar2(4000);
   BEGIN
     l_location_uri := DBMS_CLOUD.INIT_SHAREPOINT_URI(
       tenant_id   => 'Tenant ID',
       site_id     => 'Site ID',
       sub_site_id => 'Sub Site ID',
       list_id     => 'List ID',
       item_id     => 'Item ID'
     );
   END;
   /

   Questa procedura restituisce il formato URI corretto per la posizione di SharePoint a cui si desidera accedere.

3. Elenca gli oggetti e rivedi i metadati

   Eseguire DBMS_CLOUD.LIST_OBJECTS_EXTENDED per identificare i file disponibili in SharePoint e i dettagli degli identificativi di SharePoint nella colonna METADATA.

   SELECT *
   FROM DBMS_CLOUD.LIST_OBJECTS_EXTENDED(
     location_uri    => DBMS_CLOUD.INIT_SHAREPOINT_URI(
                         tenant_id   => 'Tenant ID',
                         site_id     => 'Site ID',
                         sub_site_id => 'Sub Site ID',
                         list_id     => 'List ID',
                         item_id     => 'Item ID'),
     credential_name => 'SHAREPOINT_CRED');

   L'output include una colonna METADATA con attributi JSON specifici di SharePoint quali tenantid, siteid, listid e itemid.

   Per ulteriori informazioni, vedere DBMS_CLOUD.LIST_OBJECTS_EXTENDED.

4. Scarica un singolo file
   Dopo aver identificato l'elemento desiderato, eseguire DBMS_CLOUD.GET_OBJECT per scaricare un singolo file da SharePoint. Per GET_OBJECT, l'URI di SharePoint deve includere itemid.

   DBMS_CLOUD.GET_OBJECT(
     object_uri      => DBMS_CLOUD.INIT_SHAREPOINT_URI(
                         tenant_id   => 'Tenant ID',
                         site_id     => 'Site ID',
                         sub_site_id => 'Sub Site ID',
                         list_id     => 'List ID',
                         item_id     => 'Item ID'),
     credential_name => 'SHAREPOINT_CRED');

   Eseguire l'istruzione precedente quando si desidera che l'oggetto venga restituito direttamente anziché essere scritto in una directory di database.

5. Scaricare un oggetto in una directory
   Eseguire GET_OBJECT e includere directory_name nella procedura.

   DBMS_CLOUD.GET_OBJECT(
     object_uri      => DBMS_CLOUD.INIT_SHAREPOINT_URI(
                         tenant_id   => 'Tenant ID',
                         site_id     => 'Site ID',
                         sub_site_id => 'Sub Site ID',
                         list_id     => 'List ID',
                         item_id     => 'Item ID'),
     credential_name => 'SHAREPOINT_CRED',
     directory_name  => 'STAGING');

   Poiché si specifica il nome della directory, i file vengono scaricati nella directory del database.

   Per ulteriori informazioni, vedere DBMS_CLOUD.GET_OBJECT.

È possibile utilizzare una pipeline quando si desidera che Autonomous AI Database trovi il contenuto e lo scarichi in un workflow.

Il sistema crea pipeline a livello di sito di SharePoint, non a livello di singolo elenco o libreria. Oracle consiglia di utilizzare una pipeline per sito.

Se un sito dispone di un sito secondario, creare una pipeline separata specificando l'identificativo combinato del sito e del sito secondario nel formato <ID_sito>/siti/<ID_sito secondario>.

1. Creare una pipeline di download

   Creare una pipeline DOWNLOAD per caricare i dati da SharePoint.

   BEGIN
     DBMS_CLOUD_PIPELINE.CREATE_PIPELINE(
       pipeline_name => 'MY_PIPE2',
       pipeline_type => 'DOWNLOAD',
       description   => 'Downloads data from SharePoint to Autonomous Database'
     );
   END;
   /

   Questo tipo di pipeline è l'unico tipo di pipeline supportato per SharePoint.

2. Imposta attributi pipeline
   Specificare le credenziali, la posizione di SharePoint, la priorità e i valori di intervallo per la pipeline.

   BEGIN
     DBMS_CLOUD_PIPELINE.SET_ATTRIBUTE(
       pipeline_name => 'MY_PIPE2',
       attributes    => JSON_OBJECT(
         'credential_name' VALUE 'SHAREPOINT_CRED',
         'location'        VALUE DBMS_CLOUD.INIT_SHAREPOINT_URI(
                               tenant_id => 'Tenant ID',
                               site_id   => 'Site ID'),
         'priority'        VALUE 'HIGH',
         'interval'        VALUE '5')
     );
   END;
   /

   Se si specifica anche directory_name, la pipeline scarica i file in tale directory invece di memorizzare i dati dei file nella tabella di stato della pipeline.

   Per ulteriori informazioni, vedere Attributi DBMS_CLOUD_PIPELINE.

3. Avvia pipeline

   Dopo aver impostato gli attributi, è possibile avviare la pipeline:

   EXEC DBMS_CLOUD_PIPELINE.START_PIPELINE('MY_PIPE2');

   Quando la pipeline viene avviata, convalida l'URI e raccoglie le liste di elementi dal sito o dal sito secondario di destinazione. La pipeline scarica i dati nella directory specificata. Se non si specifica una directory, la pipeline la memorizza nella colonna dati della tabella di stato della pipeline.

4. Rivedi risultati pipeline

   Rivedere la tabella dello stato della pipeline per confermare che gli oggetti sono stati elaborati correttamente e per ispezionare lo stato, gli indicatori orari e i dettagli del contenuto scaricato. Se la pipeline scrive i file in una directory, eseguire DBMS_CLOUD.LIST_FILES per verificare i file scaricati.

È possibile creare indici vettoriali direttamente da SharePoint utilizzando DBMS_CLOUD_AI.CREATE_VECTOR_INDEX.