EXPORT comando

Autorizzazione

Connessione obbligatorio

Database. Se la connessione implicita è abilitata, viene stabilita una connessione al database predefinito. L'accesso al programma di utilità per i server di database Linux®, UNIX o Windows da client Linux, UNIX o Windows deve essere una connessione diretta tramite il motore. L'accesso non deve essere una connessione diretta tramite un gateway Db2 Connect o un ambiente di loop back.

Sintassi del comando

traversal-order-list

Parametri dei comandi

TO filename

Specifica il nome del file in cui devono essere esportati i dati. Se non viene specificato il percorso completo del file, il programma di utilità di esportazione utilizza la directory corrente e l'unità predefinita come destinazione. La lunghezza massima del parametro filename è 255 byte.

Se viene specificato il nome di un file esistente, il programma di utilità di esportazione sovrascrive il contenuto del file; non accoda le informazioni.

OF filetype

Specifica il formato dei dati nel file di output:

• DEL (formato ASCII delimitato), utilizzato da vari programmi di gestione file e gestore database .
• IXF (Integration Exchange Format, versione PC) è un formato binario proprietario.

LOBS TO lob-path

Specifica uno o più percorsi per le directory in cui devono essere memorizzati i file LOB. Ci deve essere almeno un file per percorso LOB e ogni file deve contenere almeno un LOB. Il numero massimo di percorsi che è possibile specificare è 999. Questa impostazione attiva implicitamente il comportamento LOBSINFILE .

LOBFILE filename

Specifica uno o più nomi file di base per i file LOB. Quando si esaurisce lo spazio nome per il nome, viene utilizzato il secondo nome e così via. Questa impostazione attiva implicitamente il comportamento LOBSINFILE .

Quando si creano file LOB durante un'operazione di esportazione, i nomi file vengono creati accodando il nome di base corrente da questo elenco al percorso corrente (da lob - path). Quindi, è necessario aggiungere un numero di sequenza di 3 cifre per iniziare e l'identificativo di tre caratteri lob. Ad esempio, se il percorso LOB corrente è la directory /u/foo/lob/path/e il nome file LOB corrente è bar, i file LOB creati sono /u/foo/lob/path/bar.001.lob, /u/foo/lob/path/bar.002.lobe così via. Il numero di sequenza a 3 cifre nel nome file LOB cresce fino a 4 cifre una volta utilizzato 999, 4 cifre crescono fino a 5 cifre una volta utilizzato 9999 e così via.

XML TO xml-path

Specifica uno o più percorsi per le directory in cui devono essere memorizzati i file XML. Esiste almeno un file per percorso XML e ogni file contiene almeno un'istanza XDM (XQuery Data Model). Se viene specificato più di un percorso, le istanze XDM vengono distribuite in modo uniforme tra i percorsi.

XMLFILE filename

Specifica uno o più nomi file di base per i file XML. Quando si esaurisce lo spazio nome per il nome, viene utilizzato il secondo nome e così via.

Quando si creano file XML durante un'esportazione, i nomi file vengono creati aggiungendo il nome base corrente da questo elenco al percorso corrente (da xml - path). Quindi, è necessario aggiungere un numero di sequenza di 3 cifre e l'identificativo di tre caratteri xml. Ad esempio, se il percorso XML corrente è la directory /u/foo/xml/path/e il nome file XML corrente è bar, i file XML creati sono /u/foo/xml/path/bar.001.xml, /u/foo/xml/path/bar.002.xmle così via.

MODIFIED BY filetype-mod

Specifica le opzioni del modificatore del tipo di file. Consultare Modificatori del tipo di file per il programma di utilità di esportazione.

XMLSAVESCHEMA

Specifica che le informazioni sullo schema XML devono essere salvate per tutte le colonne XML. Per ogni documento XML esportato convalidato rispetto ad un schema XML quando è stato inserito, l'identificativo SQL completo di tale schema viene archiviato come attributo (SCH) all'interno del corrispondente XDS (XML Data Specifier). Se il documento esportato non è stato convalidato rispetto a uno schema XML o se l'oggetto schema non esiste più nel database, un attributo SCH non verrà incluso nell'XDS corrispondente.

Le parti schema e nome dell'identificativo SQL sono memorizzate come valori "OBJECTSCHEMA" e "OBJECTNAME" nella riga di SYSCAT.XSROBJECTS corrispondente allo schema XML.

L'opzione XMLSAVESCHEMA non è compatibile con le sequenze XQuery che non producono documenti XML con formato corretto.

METHOD N column-name

Specifica uno o più nomi colonna da utilizzare nel file di emissione. Se questo parametro non viene specificato, vengono utilizzati i nomi delle colonne nella tabella. Questo parametro è valido solo per file IXF, ma non è valido quando si esportano dati gerarchici.

MESSAGES message-file

Specifica la destinazione per i messaggi di avvertenza e di errore che si verificano durante un'esportazione. Se il file esiste, il programma di utilità di esportazione accoda le informazioni. Se file - messaggi viene omesso, i messaggi vengono scritti nell'output standard.

select-statement

Specifica l'istruzione SELECT o XQUERY che restituisce i dati da esportare. Se l'istruzione causa un errore, un messaggio viene scritto nel file di messaggi (o nell'emissione standard). Se il codice di errore è uno tra SQL0012W, SQL0347W, SQL0360W, SQL0437Wo SQL1824W, l'operazione di esportazione continua; in caso contrario, viene arrestata.

Se l'istruzione SELECT è nel formato SELECT * FROM nometabella e la tabella contiene colonne implicitamente nascoste, è necessario specificare esplicitamente se i dati per le colonne nascoste sono inclusi nell'operazione di esportazione. Utilizzare uno dei seguenti metodi per indicare se i dati per le colonne nascoste sono inclusi:

• Utilizzare uno dei modificatori del tipo di file di colonne nascoste: specificare implicitlyhiddeninclude quando l'esportazione contiene dati per le colonne nascoste oppure implicitlyhiddenmissing quando l'esportazione non contiene dati.

  db2 export to t.del of del modified by implicitlyhiddeninclude
     select * from t

• Utilizzare la variabile di registro DB2_DMU_DEFAULT sul lato client per impostare il comportamento predefinito quando i programmi di utilità di spostamento dati rilevano tabelle con colonne nascoste implicitamente.

  db2set DB2_DMU_DEFAULT=IMPLICITLYHIDDENINCLUDE
  db2 export to t.del of del select * from t 

HIERARCHY STARTING sub-table-name

Utilizzando l'ordine di attraversamento predefinito (ordine esterno per i file ASC o DEL o l'ordine memorizzato nei file di dati PC/IXF), esportare una gerarchia secondaria a partire da nome - tabella - secondaria.

HIERARCHY traversal-order-list

Esporta una gerarchia secondaria utilizzando l'ordine trasversale specificato. Tutte le tabelle secondarie devono essere elencate in modo PRE - ORDER. Il nome della prima tabella secondaria viene utilizzato come nome della tabella di destinazione per l'istruzione SELECT.

Esempi

db2 export to myfile.ixf of ixf messages msgs.txt select * from staff

db2 export to awards.ixf of ixf messages msgs.txt select * from staff
      where dept = 20

   db2 export to myfile.del of del lobs to mylobs/
      lobfile lobs1, lobs2 modified by lobsinfile
      select * from emp_photo

   db2 export to myfile.del of del
      lobs to /db2exp1/, /db2exp2/ modified by lobsinfile
      select * from emp_photo

   db2 export to myfile.del of del
      modified by chardel'' coldel; decpt,
      select * from staff

Note sull'utilizzo

• Assicurarsi di completare tutte le operazioni di tabella e rilasciare tutti i blocchi prima di iniziare un'operazione di esportazione. Questo passo può essere eseguito emettendo un COMMIT dopo aver chiuso tutti i cursori aperti WITH HOLD o emettendo un ROLLBACK.
• Gli alias di tabella possono essere utilizzati nell'istruzione SELECT.
• È possibile che venga visualizzato il messaggio SQL27981W quando non sembra applicabile, ad esempio quando la tabella EXPORT non è partizionata. In questo caso, è possibile ignorare questa avvertenza. Questo messaggio di avvertenza potrebbe essere restituito se l'istruzione SELECT del comando EXPORT include la parola ' da ' prima della parola chiave SQL FROM.
• I messaggi inseriti nel file di messaggi includono le informazioni restituite dal servizio di richiamo messaggi. Ogni messaggio inizia su una nuova linea.
• L'importazione PC/IXF deve essere utilizzata per spostare i dati tra i database. Se i dati carattere che contengono i separatori di riga vengono esportati in un file ASCII delimitato (DEL) ed elaborati da un programma di trasferimento testo, i campi che contengono i separatori di riga si riducono o si espandono.
• La fase di copia del file non è necessaria se i database di origine e di destinazione sono entrambi accessibili dallo stesso client.
• Db2 Connect può essere utilizzato per esportare tabelle da server DRDA come Db2® for z/OS®, Db2 per VM e VSE e Db2 per OS/400®. È supportata solo l'esportazione PC/IXF.
• Quando si esporta nel formato IXF, se gli identificativi superano la dimensione massima supportata dal formato IXF, l'esportazione ha esito positivo. Tuttavia, il file di dati risultante non può essere utilizzato da una successiva operazione di importazione utilizzando la modalità CREATE (SQL27984W).
• Quando si esporta in formato IXF, il programma di utilità di esportazione non conserva i metadati di tabella organizzati per colonna necessari per ricreare la tabella organizzata per colonna durante una successiva importazione utilizzando la modalità CREATE.
• Quando si esporta su un minidisco su Windows e la tabella che ha più dati della capacità di un singolo minidisco, il sistema richiede un altro minidisco. I file PC/IXF a più parti (noti anche come file PC/IXF a più volumi o file PC/IXF suddivisi logicamente) vengono generati e memorizzati in minidischi separati. In ogni file, ad eccezione dell'ultimo, è scritto un Db2 CONTINUAZIONE RECORD (o "AC" Record in breve). Questo record indica che i file sono logicamente suddivisi e mostra dove cercare il file successivo. I file possono quindi essere trasferiti su un sistema AIX® per essere letti dai programmi di utilità di importazione e caricamento. Il programma di utilità di esportazione non crea file PC/IXF a più parti quando viene richiamato da un sistema AIX . Per l'utilizzo dettagliato, consultare il comando IMPORT o LOAD .
• Il programma di utilità di esportazione memorizza l'attributo NOT NULL WITH DEFAULT della tabella in un file IXF se l'istruzione SELECT fornita è nel formato SELECT * FROM tablename.
• Quando si esportano le tabelle immesse, le istruzioni subselect possono essere espresse solo specificando il nome della tabella di destinazione e la clausola WHERE . Fullselect e select - statement non possono essere specificati quando si esporta una gerarchia.
• Per formati di file diversi da IXF, si consiglia di specificare l'elenco degli ordini trasversali. L'elenco indica a Db2 come attraversare la gerarchia e quali tabelle secondarie esportare. Se questo elenco non viene specificato, tutte le tabelle nella gerarchia vengono esportate e l'ordine predefinito è l'ordine OUTER. L'alternativa è utilizzare l'ordine predefinito, che è l'ordine fornito dalla funzione OUTER.
• Utilizzare lo stesso ordine trasversale durante un'operazione di importazione. Il programma di utilità di caricamento non supporta il caricamento di gerarchie o sottogerarchie.
• Quando si esportano i dati da una tabella che dispone di righe protette, le credenziali LBAC conservate dall'ID di autorizzazione della sessione potrebbero limitare le righe esportate. Se l'ID di autorizzazione della sessione non dispone dell'accesso in lettura alle righe, non verranno esportate. Non viene fornito alcun errore o avvertenza.
• Se le credenziali LBAC conservate dall'ID di autorizzazione della sessione non consentono la lettura da una o più colonne protette incluse nell'esportazione, l'esportazione ha esito negativo e viene restituito un errore (SQLSTATE 42512).
• Quando si eseguono i programmi di utilità di spostamento dati come export e db2move, il compilatore di query potrebbe stabilire che la query sottostante viene eseguita in modo più efficiente su una MQT rispetto alla tabella o alle tabelle di base. In questo caso, la query viene eseguita rispetto a una MQT differita di aggiornamento e il risultato dei programmi di utilità potrebbe non rappresentare in modo accurato i dati nella tabella sottostante.
• I package di esportazione sono collegati utilizzando il formato DATETIME ISO . Pertanto, tutti i valori data / ora/timestamp vengono convertiti in formato ISO quando vengono convertiti in una rappresentazione di stringa. Poiché i package CLP sono collegati utilizzando il formato DATETIME LOC (formato specifico della locale), è possibile che si verifichi un funzionamento incongruente tra CLP ed esportazione se il formato CLP DATETIME è diverso da ISO. Ad esempio, la seguente istruzione SELECT potrebbe restituire i risultati previsti:

     db2 select col2 from tab1 where char(col2)='05/10/2005';
        COL2
        ----------
        05/10/2005
        05/10/2005
        05/10/2005
        3 record(s) selected.

  Ma un comando di esportazione che utilizza la stessa clausola select non:

     db2 export to test.del of del select col2 from test 
     where char(col2)='05/10/2005';
        Number of rows exported: 0

  Ora, la sostituzione del formato data LOCALE con il formato ISO fornisce i risultati previsti:

     db2 export to test.del of del select col2 from test
     where char(col2)='2005-05-10';
        Number of rows exported: 3

Modificatori del tipo di file per il programma di utilità di esportazione

   modified by chardel""

   modified by chardel''

   db2 "export to temp of del modified by coldel;
      select * from staff where dept = 20"

   db2 create table decimalTable ( c1 decimal( 31, 2 ) )
   db2 insert into decimalTable values ( 1.1 )
   
   db2 export to data of del select * from decimalTable
    
   db2 export to data of del modified by STRIPLZEROS 
      select * from decimalTable

   "YYYY/MM/DD HH:MM:SS.UUUUUU"

   db2 export to delfile2 of del
      modified by timestampformat="yyyy.mm.dd hh:mm tt"
      select * from schedule