DBMS_CLOUD per la gestione di massa dei file

I sottoprogrammi per le operazioni dei file in blocco all'interno del pacchetto DBMS_CLOUD.

Sottoprogramma Descrizione
BULK_COPY Procedura

Questa procedura copia i file da un bucket dello storage degli oggetti cloud a un altro.

BULK_DELETE Procedura

La procedura elimina i file dal bucket o dalla cartella di storage degli oggetti cloud.

BULK_DOWNLOAD Procedura

Questa procedura scarica i file dal bucket dell'area di memorizzazione degli oggetti cloud in una directory in Autonomous Database.

BULK_MOVE Procedura

Questa procedura sposta i file da un bucket di storage degli oggetti cloud a un altro.

BULK_UPLOAD Procedura

Questa procedura carica i file da una directory in Autonomous Database nello storage degli oggetti cloud.

Prerequisiti

Come sviluppatore, puoi utilizzare le procedure DBMS_CLOUD con Autonomous Database distribuite su Oracle Public Cloud, Multicloud o Exadata Cloud@Customer.

A seconda della scelta di distribuzione, è necessario soddisfare i seguenti prerequisiti per utilizzare le procedure DBMS_CLOUD con i provider di servizi Amazon S3, Azure Blob Storage e Google Cloud Storage.

Una connettività in uscita deve essere stata configurata mediante un gateway NAT dall'amministratore della flotta, come descritto di seguito.
  • Crea un gateway NAT nella rete cloud virtuale (VCN) in cui risiedono le tue risorse di Autonomous Database seguendo le istruzioni riportate in Crea un gateway NAT nella documentazione di Oracle Cloud Infrastructure.
  • Dopo aver creato il gateway NAT, aggiungere una regola di instradamento e una regola di sicurezza di uscita a ogni subnet (nella VCN) in cui risiedono le risorse di Autonomous Database in modo che queste risorse possano utilizzare il gateway per ottenere una chiave pubblica dall'istanza di Azure AD:
    1. Andare alla pagina Dettagli subnet per la subnet.
    2. Nella scheda Informazioni subnet, fare clic sul nome della tabella di instradamento della subnet per visualizzare la relativa pagina Dettagli tabella di instradamento.
    3. Nella tabella delle regole di instradamento esistenti, verificare se esiste già una regola con le seguenti caratteristiche:
      • Data: 0.0.0.0/0
      • Tipo di destinazione: gateway NAT
      • Destinazione: il nome del gateway NAT appena creato nella VCN

      Se la regola non esiste, fare clic su Aggiungi regole di instradamento e aggiungere una regola di instradamento con queste caratteristiche.

    4. Tornare alla pagina Dettagli subnet per la subnet.
    5. Nella tabella Elenchi di sicurezza della subnet, fare clic sul nome della lista di sicurezza della subnet per visualizzare la relativa pagina Dettagli lista di sicurezza.
    6. Nel menu laterale, in Risorse, fare clic su Regole di uscita.
    7. Nella tabella delle regole di uscita esistenti, verificare se esiste già una regola con le seguenti caratteristiche:
      • Tipo di destinazione: CIDR
      • Data: 0.0.0.0/0
      • Protocollo IP: TCP
      • Intervallo porte di origine: 443
      • Intervallo di porte di destinazione: tutte

      Se una regola di questo tipo non esiste, fare clic su Aggiungi regole di uscita e aggiungere una regola di uscita con queste caratteristiche.

Le impostazioni del proxy HTTP nell'ambiente devono consentire al database di accedere al provider di servizi cloud.

Queste impostazioni vengono definite dall'amministratore della flotta durante la creazione dell'infrastruttura Exadata Cloud@Customer, come descritto in Uso della console per eseguire il provisioning di Exadata Database Service su Cloud@Customer.

Nota

La configurazione di rete, incluso il proxy HTTP, può essere modificata solo fino a quando lo stato dell'infrastruttura Exadata non è Richiede attivazione. Una volta attivato, non è possibile modificare tali impostazioni.

L'impostazione di un proxy HTTP per un'infrastruttura Exadata già fornita richiede una richiesta di servizio (SR) in My Oracle Support. Per informazioni dettagliate, vedere Create a Service Request in My Oracle Support.

BULK_COPY Procedura

Questa procedura copia in blocco i file da un bucket di storage degli oggetti cloud a un altro. Il form sovraccarico consente di utilizzare il parametro operation_id.

È possibile filtrare la lista di file da eliminare utilizzando un pattern di espressione regolare compatibile con l'operatore REGEXP_LIKE.

Il bucket o la cartella di origine e destinazione possono trovarsi nello stesso provider dell'area di memorizzazione degli oggetti cloud o in un altro provider.

Quando l'origine e la destinazione si trovano in aree di memorizzazione degli oggetti distinte o hanno account diversi con lo stesso provider cloud, è possibile assegnare nomi di credenziali separati per le posizioni di origine e destinazione.

Il nome della credenziale di origine viene utilizzato per impostazione predefinita anche dalla posizione di destinazione.

Sintassi

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

Parametri

Parametro Descrizione

source_credential_name

Il nome della credenziale per accedere allo storage degli oggetti cloud.

Se non si specifica un valore source_credential_name, credential_name viene impostato su NULL.

source_location_uri

Specifica l'URI che punta al bucket di storage degli oggetti o alla posizione della cartella di origine.

Questo parametro è obbligatorio.

Il formato degli URI dipende dal servizio di storage degli oggetti cloud. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI di storage degli oggetti Package File Cloud.

target_location_uri

Specifica l'URI per il bucket o la cartella di storage degli oggetti di destinazione, in cui è necessario copiare i file.

Questo parametro è obbligatorio.

Il formato degli URI dipende dal servizio di storage degli oggetti cloud. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI di storage degli oggetti Package File Cloud.

target_credential_name

Nome della credenziale per accedere alla posizione di storage degli oggetti cloud di destinazione.

Se non si specifica un valore target_credential_name, il valore target_location_uri viene impostato sul valore source_credential_name.

regex_filter

Specifica l'espressione REGEX per filtrare i file. Il pattern di espressione REGEX deve essere compatibile con l'operatore REGEXP_LIKE.

Se non si specifica un valore regex_filter, regex_filter viene impostato su NULL.

Per ulteriori informazioni, vedere REGEXP_LIKE Condizione.

format

Specifica le opzioni di configurazione aggiuntive per l'operazione sul file. Queste opzioni sono specificate come stringa JSON.

Le opzioni di formato supportate sono:
  • logretention: accetta un valore intero che determina la durata in giorni per la quale la tabella di stato viene conservata per un'operazione di massa.

    Il valore predefinito è 2 giorni.

  • logprefix: accetta un valore stringa che determina la stringa del prefisso del nome della tabella di stato dell'operazione in blocco.

    Il tipo di operazione è il valore predefinito. Per BULK_COPY, il valore predefinito logprefix è COPYOBJ.

  • priority: accetta un valore stringa che determina il numero di operazioni file eseguite contemporaneamente.

    Un'operazione con una priorità più elevata consuma più risorse del database e dovrebbe essere eseguita più velocemente.

    Accetta i seguenti valori:

    • HIGH: determina il numero di file paralleli gestiti utilizzando il conteggio ECPU del database (conteggio OCPU se il database utilizza OCPU)

    • MEDIUM: determina il numero di processi simultanei utilizzando il limite di concorrenza per il servizio di medie dimensioni. Il valore predefinito è 4.

    • LOW: elabora i file in ordine seriale.

    Il valore predefinito è MEDIUM.

    Il numero massimo di operazioni file concorrenti è limitato a 64.

Se non si specifica un valore format, format viene impostato su NULL.

operation_id

Utilizzare questo parametro per tenere traccia dell'avanzamento e dello stato finale dell'operazione di caricamento come ID corrispondente nella vista USER_LOAD_OPERATIONS.

Note sull'uso

  • Viene restituito un errore quando l'URI di origine e destinazione punta allo stesso bucket o cartella di storage degli oggetti.

Esempio

BEGIN 
DBMS_CLOUD.BULK_COPY (
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format       => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
);
END;
/

BULK_DELETE Procedura

Questa procedura elimina in blocco i file dallo storage degli oggetti cloud. Il form sovraccarico consente di utilizzare il parametro operation_id. È possibile filtrare la lista di file da eliminare utilizzando un pattern di espressione regolare compatibile con l'operatore REGEXP_LIKE.

Sintassi

 DBMS_CLOUD.BULK_DELETE(
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DELETE (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Parametri

Parametro Descrizione

credential_name

Il nome della credenziale per accedere allo storage degli oggetti cloud.

Se non si specifica un valore credential_name, credential_name viene impostato su NULL.

location_uri

Specifica l'URI che punta a una posizione di storage degli oggetti in Autonomous Database.

Questo parametro è obbligatorio.

Il formato degli URI dipende dal servizio di storage degli oggetti cloud. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI di storage degli oggetti Package File Cloud.

regex_filter

Specifica l'espressione REGEX per filtrare i file. Il pattern di espressione REGEX deve essere compatibile con l'operatore REGEXP_LIKE.

Se non si specifica un valore regex_filter, regex_filter viene impostato su NULL.

Per ulteriori informazioni, vedere REGEXP_LIKE Condizione.

format

Specifica le opzioni di configurazione aggiuntive per l'operazione sul file. Queste opzioni sono specificate come stringa JSON.

Le opzioni di formato supportate sono:
  • logretention: accetta un valore intero che determina la durata in giorni per la quale la tabella di stato viene conservata per un'operazione di massa.

    Il valore predefinito è 2 giorni.

  • logprefix: accetta un valore stringa che determina la stringa del prefisso del nome della tabella di stato dell'operazione in blocco.

    Il tipo di operazione è il valore predefinito. Per BULK_DELETE, il valore predefinito logprefix è DELETE.

  • priority: accetta un valore stringa che determina il numero di operazioni file eseguite contemporaneamente.

    Un'operazione con una priorità più alta consuma più risorse di database e viene completata prima.

    Accetta i seguenti valori:

    • HIGH: determina il numero di file paralleli gestiti utilizzando il conteggio ECPU del database (conteggio OCPU se il database utilizza OCPU).

    • MEDIUM: determina il numero di processi simultanei utilizzando il limite di concorrenza per il servizio di medie dimensioni. Il valore predefinito è 4.

    • LOW: elabora i file in ordine seriale.

    Il valore predefinito è MEDIUM.

    Il numero massimo di operazioni file concorrenti è limitato a 64.

Se non si specifica un valore format, format viene impostato su NULL.

operation_id

Utilizzare questo parametro per tenere traccia dell'avanzamento e dello stato finale dell'operazione di caricamento come ID corrispondente nella vista USER_LOAD_OPERATIONS.

Esempio

BEGIN
DBMS_CLOUD.BULK_DELETE (    
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKDEL')
);
END;
/

BULK_DOWNLOAD Procedura

Questa procedura scarica i file in una directory di Autonomous Database dallo storage degli oggetti cloud. Il form sovraccarico consente di utilizzare il parametro operation_id. È possibile filtrare la lista dei file da scaricare utilizzando un pattern di espressione regolare compatibile con l'operatore REGEXP_LIKE.

Sintassi

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Parametri

Parametro Descrizione

credential_name

Il nome della credenziale per accedere allo storage degli oggetti cloud.

Se non si specifica un valore credential_name, credential_name viene impostato su NULL.

location_uri

Specifica l'URI che punta a una posizione di storage degli oggetti in Autonomous Database.

Questo parametro è obbligatorio.

Il formato degli URI dipende dal servizio di storage degli oggetti cloud. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI di storage degli oggetti Package File Cloud.

directory_name

Il nome della directory in Autonomous Database da cui si desidera scaricare i file.

Questo parametro è obbligatorio.

regex_filter

Specifica l'espressione REGEX per filtrare i file. Il pattern di espressione REGEX deve essere compatibile con l'operatore REGEXP_LIKE.

Se non si specifica un valore regex_filter, regex_filter viene impostato su NULL.

Per ulteriori informazioni, vedere REGEXP_LIKE Condizione.

format

Specifica le opzioni di configurazione aggiuntive per l'operazione sul file. Queste opzioni sono specificate come stringa JSON.

Le opzioni di formato supportate sono:
  • logretention: accetta un valore intero che determina la durata in giorni per la quale la tabella di stato viene conservata per un'operazione di massa.

    Il valore predefinito è 2 giorni.

  • logprefix: accetta un valore stringa che determina la stringa del prefisso del nome della tabella di stato dell'operazione in blocco. Per BULK_DOWNLOAD, il valore predefinito logprefix è DOWNLOAD.

    Il tipo di operazione è il valore predefinito.

  • priority: accetta un valore stringa che determina il numero di operazioni file eseguite contemporaneamente.

    Un'operazione con una priorità più alta consuma più risorse di database e viene completata prima.

    Accetta i seguenti valori:

    • HIGH: determina il numero di file paralleli gestiti utilizzando il conteggio ECPU del database (conteggio OCPU se il database utilizza OCPU).

    • MEDIUM: determina il numero di processi simultanei utilizzando il limite di concorrenza per il servizio di medie dimensioni. Il valore predefinito è 4.

    • LOW: elabora i file in ordine seriale.

    Il valore predefinito è MEDIUM.

    Il numero massimo di operazioni file concorrenti è limitato a 64.

Se non si specifica un valore format, format viene impostato su NULL.

operation_id

Utilizzare questo parametro per tenere traccia dell'avanzamento e dello stato finale dell'operazione di caricamento come ID corrispondente nella vista USER_LOAD_OPERATIONS.

Esempio

BEGIN
DBMS_CLOUD.BULK_DOWNLOAD (    
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
 );
END;
/

BULK_MOVE Procedura

Questa procedura sposta in blocco i file da un bucket o una cartella dello storage degli oggetti cloud a un altro. Il form sovraccarico consente di utilizzare il parametro operation_id.

È possibile filtrare la lista di file da eliminare utilizzando un pattern di espressione regolare compatibile con l'operatore REGEXP_LIKE.

Il bucket o la cartella di origine e destinazione possono trovarsi nello stesso provider dell'area di memorizzazione degli oggetti cloud o in un altro provider.

Quando l'origine e la destinazione si trovano in aree di memorizzazione degli oggetti distinte o hanno account diversi con lo stesso provider cloud, è possibile assegnare nomi di credenziali separati per le posizioni di origine e destinazione.

Il nome della credenziale di origine viene utilizzato per impostazione predefinita anche dalla posizione di destinazione quando non viene fornito il nome della credenziale di destinazione.

Il primo passo per spostare i file è copiarli nella posizione di destinazione, quindi eliminare i file di origine, una volta copiati correttamente.

L'oggetto viene rinominato anziché spostato se l'area di memorizzazione degli oggetti consente di rinominare le operazioni tra le posizioni di origine e di destinazione.

Sintassi

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

Parametri

Parametro Descrizione

source_credential_name

Nome della credenziale per accedere allo storage degli oggetti cloud di origine.

Se non si specifica un valore source_credential_name, credential_name viene impostato su NULL.

source_location_uri

Specifica l'URI che punta al bucket di storage degli oggetti o alla posizione della cartella di origine.

Questo parametro è obbligatorio.

Il formato degli URI dipende dal servizio di storage degli oggetti cloud. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI di storage degli oggetti Package File Cloud.

target_location_uri

Specifica l'URI per il bucket o la cartella di storage degli oggetti di destinazione, in cui è necessario spostare i file.

Questo parametro è obbligatorio.

Il formato degli URI dipende dal servizio di storage degli oggetti cloud. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI di storage degli oggetti Package File Cloud.

target_credential_name

Nome della credenziale per accedere alla posizione di storage degli oggetti cloud di destinazione.

Se non si specifica un valore target_credential_name, il valore target_location_uri viene impostato sul valore source_credential_name.

regex_filter

Specifica l'espressione REGEX per filtrare i file. Il pattern di espressione REGEX deve essere compatibile con l'operatore REGEXP_LIKE.

Se non si specifica un valore regex_filter, regex_filter viene impostato su NULL.

Per ulteriori informazioni, vedere REGEXP_LIKE Condizione.

format

Specifica le opzioni di configurazione aggiuntive per l'operazione sul file. Queste opzioni sono specificate come stringa JSON.

Le opzioni di formato supportate sono:
  • logretention: accetta un valore intero che determina la durata in giorni per la quale la tabella di stato viene conservata per un'operazione di massa.

    Il valore predefinito è 2 giorni.

  • logprefix: accetta un valore stringa che determina la stringa del prefisso del nome della tabella di stato dell'operazione in blocco.

    Il tipo di operazione è il valore predefinito. Per BULK_MOVE, il valore predefinito logprefix è MOVE.

  • priority: accetta un valore stringa che determina il numero di operazioni file eseguite contemporaneamente.

    Un'operazione con una priorità più alta consuma più risorse di database e viene completata prima.

    Accetta i seguenti valori:

    • HIGH: determina il numero di file paralleli gestiti utilizzando il conteggio ECPU del database (conteggio OCPU se il database utilizza OCPU).

    • MEDIUM: determina il numero di processi simultanei utilizzando il limite di concorrenza per il servizio di medie dimensioni. Il valore predefinito è 4.

    • LOW: elabora i file in ordine seriale.

    Il valore predefinito è MEDIUM.

    Il numero massimo di operazioni file concorrenti è limitato a 64.

Se non si specifica un valore format, format viene impostato su NULL.

operation_id

Utilizzare questo parametro per tenere traccia dell'avanzamento e dello stato finale dell'operazione di caricamento come ID corrispondente nella vista USER_LOAD_OPERATIONS.

Esempio

BEGIN 
DBMS_CLOUD.BULK_MOVE (    
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format                 => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKMOVE')
);
END;
/

Nota

Viene restituito un errore quando l'URI di origine e destinazione punta allo stesso bucket o cartella di storage degli oggetti.

BULK_UPLOAD Procedura

Questa procedura copia i file nello storage degli oggetti cloud da una directory di Autonomous Database. Il form sovraccarico consente di utilizzare il parametro operation_id.

Sintassi

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Parametri

Parametro Descrizione

credential_name

Il nome della credenziale per accedere allo storage degli oggetti cloud.

Se non si specifica un valore credential_name, credential_name viene impostato su NULL.

location_uri

Specifica l'URI che punta a una posizione di storage degli oggetti per caricare i file.

Questo parametro è obbligatorio.

Il formato degli URI dipende dal servizio di storage degli oggetti cloud. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI di storage degli oggetti Package File Cloud.

directory_name

Nome della directory in Autonomous Database da cui si caricano i file.

Questo parametro è obbligatorio.

regex_filter

Specifica l'espressione REGEX per filtrare i file. Il pattern di espressione REGEX deve essere compatibile con l'operatore REGEXP_LIKE.

Se non si specifica un valore regex_filter, regex_filter viene impostato su NULL.

Per ulteriori informazioni, vedere REGEXP_LIKE Condizione.

format

Specifica le opzioni di configurazione aggiuntive per l'operazione sul file. Queste opzioni sono specificate come stringa JSON.

Le opzioni di formato supportate sono:
  • logretention: accetta un valore intero che determina la durata in giorni per la quale la tabella di stato viene conservata per un'operazione di massa.

    Il valore predefinito è 2 giorni.

  • logprefix: accetta un valore stringa che determina la stringa del prefisso del nome della tabella di stato dell'operazione in blocco.

    Il tipo di operazione è il valore predefinito. Per BULK_UPLOAD, il valore predefinito logprefix è UPLOAD.

  • priority: accetta un valore stringa che determina il numero di operazioni file eseguite contemporaneamente.

    Un'operazione con una priorità più alta consuma più risorse di database e viene completata prima.

    Accetta i seguenti valori:

    • HIGH: determina il numero di file paralleli gestiti utilizzando il conteggio ECPU del database (conteggio OCPU se il database utilizza OCPU).

    • MEDIUM: determina il numero di processi simultanei utilizzando il limite di concorrenza per il servizio di medie dimensioni. Il valore predefinito è 4.

    • LOW: elabora i file in ordine seriale.

    Il valore predefinito è MEDIUM.

    Il numero massimo di operazioni file concorrenti è limitato a 64.

Se non si specifica un valore format, format viene impostato su NULL.

operation_id

Utilizzare questo parametro per tenere traccia dell'avanzamento e dello stato finale dell'operazione di caricamento come ID corrispondente nella vista USER_LOAD_OPERATIONS.

Esempio

BEGIN
DBMS_CLOUD.BULK_UPLOAD ( 
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKUPLOAD')
 );
END;
/