Documentazione dell'infrastruttura Oracle Cloud

Esportare i dati in una directory come file di Oracle Data Pump

È possibile esportare i dati in una directory come file di dump di Oracle Data Pump specificando una query.

Con questo metodo di esportazione si utilizza la procedura DBMS_CLOUD.EXPORT_DATA per specificare una query per selezionare i dati da esportare come file di dump in una directory.

  1. Connettersi all'istanza di Autonomous Database.
  2. Crea una directory.

    Ad esempio:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Per ulteriori informazioni, vedere Crea directory in Autonomous Database.
  3. Esportare i dati da Autonomous Database nella directory in uso come file di dump di Oracle Data Pump con DBMS_CLOUD.EXPORT_DATA e specificare il parametro format type come datapump. Ad esempio:
    BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    file_uri_list => 'export_dir:sales.dmp',
    format => json_object('type' value 'datapump'),
    query => 'SELECT * FROM sales'
 );
END;
/

    Esempio di esportazione dei dati come più file Data Pump in una directory:

    BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    file_uri_list => 'export_dir:sales1.dmp, export_dir:sales2.dmp',
    format => json_object('type' value 'datapump'),
    query => 'SELECT * FROM sales'
 );
END;
/

    Di seguito sono riportati i parametri disponibili.

    • file_uri_list: è una lista delimitata da virgole dei file di esportazione. L'uso dei caratteri jolly e di sostituzione non è supportato in file_uri_list.

    • format: specifica il parametro type richiesto. I valori validi sono datapump, json, xml, csv e parquet e, facoltativamente, definisce anche le opzioni che è possibile specificare per l'esportazione con il driver di accesso ORACLE_DATAPUMP.

    • query: specifica un'istruzione SELECT in modo che vengano esportati solo i dati richiesti. La query determina il contenuto dei file di dump.

    Nota

    La procedura DBMS_CLOUD.EXPORT_DATA crea i file di dump specificati in file_uri_list.

    Per informazioni dettagliate sui parametri, vedere EXPORT_DATA Procedure.

Note per l'esportazione dei dati con DBMS_CLOUD.EXPORT_DATA:

  • La directory fornita deve esistere ed è necessario eseguire il login come utente ADMIN o disporre dell'accesso WRITE alla directory.

  • La procedura non sovrascrive i file. Se è presente un file di dump in file_uri_list, DBMS_CLOUD.EXPORT_DATA segnala un errore simile al seguente: 

    ORA-31641: unable to create dump file  "/u02/exports/123.dmp"
ORA-27038: created file already exists

  • DBMS_CLOUD.EXPORT_DATA non crea directory.

  • Il nome della directory fa distinzione tra maiuscole e minuscole quando è racchiuso tra virgolette doppie.

  • Il numero di file di dump generati da DBMS_CLOUD.EXPORT_DATA viene determinato durante l'esecuzione della procedura. Il numero di file di dump generati dipende dal numero di nomi file forniti nel parametro file_uri_list, nonché dal numero di ECPU disponibili per l'istanza, il livello di servizio e la dimensione dei dati.

    Ad esempio, se si utilizza un'istanza di Autonomous Database ECPU da 2 ECPU o il servizio low, viene esportato un singolo file di dump senza parallelismo, anche se si forniscono più nomi file. Se si utilizza un'istanza di Autonomous Database con 8 ECPU con il servizio medium o high, i job possono essere eseguiti in parallelo e vengono esportati più file di dump se si forniscono più nomi file.

  • Il valore del parametro query fornito può essere una query avanzata, se necessario, ad esempio una query che include join o subquery.

  • I file di dump creati con DBMS_CLOUD.EXPORT_DATA non possono essere importati utilizzando Oracle Data Pump impdp. A seconda del database, è possibile utilizzare questi file come indicato di seguito.

    • In un'istanza di Autonomous Database è possibile utilizzare i file di dump con le procedure DBMS_CLOUD che supportano il parametro format type con il valore 'datapump'. È possibile importare i file di dump utilizzando DBMS_CLOUD.COPY_DATA oppure chiamare DBMS_CLOUD.CREATE_EXTERNAL_TABLE per creare una tabella esterna.

    • In qualsiasi altro Oracle Database, ad esempio Oracle Database 19c on-premise, è possibile importare i file di dump creati con la procedura DBMS_CLOUD.EXPORT_DATA utilizzando il driver di accesso ORACLE_DATAPUMP. Per ulteriori informazioni, vedere Scaricamento e caricamento dei dati con il driver di accesso ORACLE_DATAPUMP.