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.

• Oracle Public Cloud o multicloud
• Exadata Cloud@Customer

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 o alla posizione della cartella di storage degli oggetti di origine. Questo parametro è obbligatorio. URI file di origine cloud È possibile utilizzare i caratteri jolly e le espressioni regolari nei nomi file negli URI dei file di origine cloud. Le espressioni regolari possono essere utilizzate solo se il parametro regexuri format è impostato su TRUE. I caratteri "*" e "?" sono considerati caratteri jolly quando il parametro regexuri è impostato su FALSE. Se il parametro regexuri è impostato su TRUE, i caratteri "*" e "?" fanno parte del pattern di espressione regolare specificato. I pattern di espressione regolari sono supportati solo per il nome file o il percorso della sottocartella negli URI e la corrispondenza dei pattern è identica a quella eseguita dalla funzione REGEXP_LIKE. Esempio di utilizzo di espressioni regolari: source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv' Esempio con caratteri jolly: source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o/year=????/month=??/*.csv Il formato degli URI dipende dal servizio di storage degli oggetti cloud in uso. Per i dettagli, vedere Formati URI di storage degli oggetti cloud. Per ulteriori informazioni sulla condizione REGEXP_LIKE, vedere REGEXP_LIKE Condition in Oracle Database 19c SQL Language Reference o Oracle Database 23ai SQL Language Reference.
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. 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_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. URI file di origine cloud È possibile utilizzare i caratteri jolly e le espressioni regolari nei nomi file negli URI dei file di origine cloud. Le espressioni regolari possono essere utilizzate solo se il parametro regexuri format è impostato su TRUE. I caratteri "*" e "?" sono considerati caratteri jolly quando il parametro regexuri è impostato su FALSE. Se il parametro regexuri è impostato su TRUE, i caratteri "*" e "?" fanno parte del pattern di espressione regolare specificato. I pattern di espressione regolari sono supportati solo per il nome file o il percorso della sottocartella negli URI e la corrispondenza dei pattern è identica a quella eseguita dalla funzione REGEXP_LIKE. Ad esempio: location_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv' Il formato degli URI dipende dal servizio di storage degli oggetti cloud in uso. Per i dettagli, vedere Formati URI di storage degli oggetti cloud. Per ulteriori informazioni sulla condizione REGEXP_LIKE, vedere REGEXP_LIKE Condition in Oracle Database 19c SQL Language Reference o Oracle Database 23ai SQL Language Reference. 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. URI file di origine cloud È possibile utilizzare i caratteri jolly e le espressioni regolari nei nomi file negli URI dei file di origine cloud. Le espressioni regolari possono essere utilizzate solo se il parametro regexuri format è impostato su TRUE. I caratteri "*" e "?" sono considerati caratteri jolly quando il parametro regexuri è impostato su FALSE. Se il parametro regexuri è impostato su TRUE, i caratteri "*" e "?" fanno parte del pattern di espressione regolare specificato. I pattern di espressione regolari sono supportati solo per il nome file o il percorso della sottocartella negli URI e la corrispondenza dei pattern è identica a quella eseguita dalla funzione REGEXP_LIKE. Ad esempio: location_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv' Il formato degli URI dipende dal servizio di storage degli oggetti cloud in uso. Per i dettagli, vedere Formati URI di storage degli oggetti cloud. Per ulteriori informazioni sulla condizione REGEXP_LIKE, vedere REGEXP_LIKE Condition in Oracle Database 19c SQL Language Reference o Oracle Database 23ai SQL Language Reference.
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 o alla posizione della cartella di storage degli oggetti di origine. Questo parametro è obbligatorio. URI file di origine cloud È possibile utilizzare i caratteri jolly e le espressioni regolari nei nomi file negli URI dei file di origine cloud. Le espressioni regolari possono essere utilizzate solo se il parametro regexuri format è impostato su TRUE. I caratteri "*" e "?" sono considerati caratteri jolly quando il parametro regexuri è impostato su FALSE. Se il parametro regexuri è impostato su TRUE, i caratteri "*" e "?" fanno parte del pattern di espressione regolare specificato. I pattern di espressione regolari sono supportati solo per il nome file o il percorso della sottocartella negli URI e la corrispondenza dei pattern è identica a quella eseguita dalla funzione REGEXP_LIKE. Esempio di utilizzo di espressioni regolari: source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv' Esempio con caratteri jolly: source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o/year=????/month=??/*.csv Il formato degli URI dipende dal servizio di storage degli oggetti cloud in uso. Per i dettagli, vedere Formati URI di storage degli oggetti cloud. Per ulteriori informazioni sulla condizione REGEXP_LIKE, vedere REGEXP_LIKE Condition in Oracle Database 19c SQL Language Reference o Oracle Database 23ai SQL Language Reference.
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 in uso. Per i dettagli, vedere Formati URI di storage degli oggetti 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. Directory È possibile specificare una directory e uno o più nomi di file oppure utilizzare un elenco separato da virgole di directory e nomi di file. Il formato per specificare una directory è:'MY_DIR:filename.ext'. Per impostazione predefinita, il nome della directory MY_DIR è un oggetto di database e non fa distinzione tra maiuscole e minuscole. Nel nome del file viene fatta distinzione tra maiuscole e minuscole. Le espressioni regolari non sono supportate quando si specificano i nomi dei file in una directory. È possibile utilizzare solo caratteri jolly per specificare i nomi dei file in una directory. Il carattere "*" può essere utilizzato come caratteri jolly per più caratteri, mentre il carattere "?" può essere utilizzato come caratteri jolly per un singolo carattere. Ad esempio:'MY_DIR:*" o 'MY_DIR:test?' Per specificare più directory, utilizzare un elenco separato da virgole: ad esempio:'MY_DIR1:*, MY_DIR2:test?' Usare le virgolette doppie per specificare un nome di directory con distinzione tra maiuscole e minuscole. Ad esempio:'"my_dir1":*, "my_dir2":Test?' Per includere una virgoletta, utilizzare due virgolette. Ad esempio:'MY_DIR:''filename.ext'. Specifica che filename inizia con un' virgoletta (').
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;
/

---

Titolo e informazioni sul copyright

Copyright ©2024,2025,

Oracle e/o relative consociate.