Oracle® Database
Utilities
10g Release 1 (10.1)
Part No. B10825-01
December 2003
Oracle Database Utilities, 10g Release 1 (10.1)
Part No. B10825-01
Copyright © 1996, 2003 Oracle Corporation. All rights reserved.
Primary Author:
Kathy Rich
Contributors:
Lee Barton, Ellen Batbouta, Janet Blowney, George Claborn, Jay Davison, Steve DiPirro,
Bill Fisher, Dean Gagne, John Galanes, John Kalogeropoulos, Jonathan Klein, Cindy Lim, Eric Magrath,
Brian McCarthy, Rod Payne, Ray Pfau, Rich Phillips, Paul Reilly, Mike Sakayeda, Francisco Sanchez,
Marilyn Saunders, Jim Stenoish, Carol Tagliaferri
The Programs (which include both the software and documentation) contain proprietary information of
Oracle Corporation; they are provided under a license agreement containing restrictions on use and
disclosure and are also protected by copyright, patent and other intellectual and industrial property
laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required
to obtain interoperability with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems
in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this
document is error-free. Except as may be expressly permitted in your license agreement for these
Programs, no part of these Programs may be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation.
If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on
behalf of the U.S. Government, the following notice is applicable:
Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial
computer software" and use, duplication, and disclosure of the Programs, including documentation,
shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement.
Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer
software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR
52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500
Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently
dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,
redundancy, and other measures to ensure the safe use of such applications if the Programs are used for
such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the
Programs.
Oracle is a registered trademark, and Oracle Store, Oracle8, Oracle8i, Oracle9i, PL/SQL, SQL*Net, and
SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Other names may be
trademarks of their respective owners.
Contents
Send Us Your Comments ................................................................................................................. xli
Preface.......................................................................................................................................................... xliii
Audience ...............................................................................................................................................
Documentation Accessibility ............................................................................................................
Organization........................................................................................................................................
Related Documentation ....................................................................................................................
Conventions........................................................................................................................................
xliii
xliv
xliv
xlvii
xlviii
What's New in Database Utilities? ................................................................................................ liii
New Features in Oracle Database 10g ................................................................................................
liii
Volume 1
Part I
1
Oracle Data Pump
Overview of Oracle Data Pump
Data Pump Components ...................................................................................................................
What New Features Do Data Pump Export and Import Provide?.............................................
How Does Data Pump Access Data?...............................................................................................
Direct Path Loads and Unloads..................................................................................................
External Tables..............................................................................................................................
Accessing Data Over a Network ......................................................................................................
What Happens During Execution of a Data Pump Job? .............................................................
1-1
1-2
1-4
1-5
1-6
1-6
1-7
iii
Coordination of a Job ...................................................................................................................
Tracking Progress Within a Job ..................................................................................................
Filtering Data During a Job .........................................................................................................
Transforming Metadata During a Job........................................................................................
Maximizing Job Performance......................................................................................................
Loading and Unloading of Data.................................................................................................
Monitoring Job Status........................................................................................................................
The DBA_DATAPUMP_JOBS and USER_DATAPUMP_JOBS Views...............................
The DBA_DATAPUMP_SESSIONS View ..............................................................................
Monitoring the Progress of Executing Jobs.............................................................................
File Allocation....................................................................................................................................
Specifying Files and Adding Additional Dump Files ...........................................................
Default Locations for Dump, Log, and SQL Files ..................................................................
Using Directory Objects When Automatic Storage Management Is Enabled ............
Setting Parallelism ......................................................................................................................
Using Substitution Variables.....................................................................................................
Original Export and Import Versus Data Pump Export and Import .......................................
2
Data Pump Export
What Is Data Pump Export? ..............................................................................................................
Invoking Data Pump Export .............................................................................................................
Data Pump Export Interfaces ......................................................................................................
Data Pump Export Modes ...........................................................................................................
Full Export Mode...................................................................................................................
Schema Mode .........................................................................................................................
Table Mode .............................................................................................................................
Tablespace Mode ...................................................................................................................
Transportable Tablespace Mode .........................................................................................
Network Considerations..............................................................................................................
Filtering During Export Operations ................................................................................................
Data Filters.....................................................................................................................................
Metadata Filters.............................................................................................................................
Parameters Available in Export's Command-Line Mode ............................................................
ATTACH ........................................................................................................................................
CONTENT ...................................................................................................................................
iv
1-7
1-7
1-8
1-8
1-8
1-9
1-9
1-10
1-11
1-11
1-12
1-12
1-13
1-14
1-15
1-16
1-16
2-1
2-2
2-3
2-3
2-4
2-4
2-4
2-4
2-5
2-5
2-6
2-6
2-6
2-8
2-9
2-10
DIRECTORY................................................................................................................................
DUMPFILE ..................................................................................................................................
ESTIMATE ...................................................................................................................................
ESTIMATE_ONLY .....................................................................................................................
EXCLUDE ....................................................................................................................................
FILESIZE ......................................................................................................................................
FLASHBACK_SCN ....................................................................................................................
FLASHBACK_TIME...................................................................................................................
FULL.............................................................................................................................................
HELP ............................................................................................................................................
INCLUDE ....................................................................................................................................
JOB_NAME..................................................................................................................................
LOGFILE ......................................................................................................................................
NETWORK_LINK ......................................................................................................................
NOLOGFILE................................................................................................................................
PARALLEL ..................................................................................................................................
PARFILE ......................................................................................................................................
QUERY .........................................................................................................................................
SCHEMAS ...................................................................................................................................
STATUS........................................................................................................................................
TABLES ........................................................................................................................................
TABLESPACES ...........................................................................................................................
TRANSPORT_FULL_CHECK ..................................................................................................
TRANSPORT_TABLESPACES.................................................................................................
VERSION .....................................................................................................................................
How Data Pump Export Parameters Map to Those of the Original Export Utility .............
Commands Available in Export's Interactive-Command Mode..............................................
ADD_FILE ...................................................................................................................................
CONTINUE_CLIENT ................................................................................................................
EXIT_CLIENT .............................................................................................................................
HELP ............................................................................................................................................
KILL_JOB .....................................................................................................................................
PARALLEL ..................................................................................................................................
START_JOB .................................................................................................................................
STATUS........................................................................................................................................
2-10
2-12
2-14
2-14
2-15
2-17
2-18
2-18
2-19
2-20
2-20
2-22
2-22
2-23
2-24
2-25
2-27
2-27
2-29
2-29
2-30
2-31
2-32
2-33
2-34
2-35
2-37
2-38
2-39
2-39
2-39
2-40
2-40
2-41
2-41
v
whitespace
included in a field, 9-49
leading, 9-47
preserving, 9-51
terminating a field, 9-25, 9-50
trimming, 9-44
X
XML columns
loading, 10-18
treatment by SQL*Loader, 10-18
XML type tables
identifying in SQL*Loader, 8-7
XMLTYPE clause
in SQL*Loader control file, 8-7
Z
ZONED datatype, 9-11
EXTERNAL format
SQL*Loader, 9-21
Index-27
Index-28