Oracle® Database Utilities 10g Release (10.2) B14215-01 June 2005 Oracle Database Utilities, 10g Release (10.2) B14215-01 Copyright © 1996, 2005, Oracle 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; 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 This document is not warranted to be 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 If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable: U.S GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth 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 we disclaim liability for any damages caused by such use of the Programs Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its affiliates Other names may be trademarks of their respective owners The Programs may provide links to Web sites and access to content, products, and services from third parties Oracle is not responsible for the availability of, or any content provided on, third-party Web sites You bear all risks associated with the use of such content If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party Contents Preface xxxi Audience xxxi Documentation Accessibility xxxi Related Documentation xxxii Conventions xxxiii What's New in Database Utilities? xxxv New Features in Oracle Database 10g Release New Features in Oracle Database 10g Release Part I xxxv xxxvi Oracle Data Pump Overview of Oracle Data Pump Data Pump Components 1-1 What New Features Do Data Pump Export and Import Provide? 1-2 How Does Data Pump Access Data? 1-4 Direct Path Loads and Unloads 1-4 External Tables 1-5 Accessing Data Over a Database Link 1-6 What Happens During Execution of a Data Pump Job? 1-6 Coordination of a Job 1-6 Tracking Progress Within a Job 1-6 Filtering Data and Metadata During a Job 1-7 Transforming Metadata During a Job 1-7 Maximizing Job Performance 1-8 Loading and Unloading of Data 1-8 Monitoring Job Status 1-8 Monitoring the Progress of Executing Jobs 1-9 File Allocation 1-10 Specifying Files and Adding Additional Dump Files 1-10 Default Locations for Dump, Log, and SQL Files 1-10 Using Directory Objects When Automatic Storage Management Is Enabled 1-12 Setting Parallelism 1-12 Using Substitution Variables 1-12 Moving Data Between Different Database Versions 1-13 iii Original Export and Import Versus Data Pump Export and Import 1-14 Data Pump Export What Is Data Pump Export? 2-1 Invoking Data Pump Export 2-2 Data Pump Export Interfaces 2-2 Data Pump Export Modes 2-3 Full Export Mode 2-3 Schema Mode 2-3 Table Mode 2-3 Tablespace Mode 2-3 Transportable Tablespace Mode 2-4 Network Considerations 2-4 Filtering During Export Operations 2-5 Data Filters 2-5 Metadata Filters 2-5 Parameters Available in Export's Command-Line Mode 2-6 ATTACH 2-7 COMPRESSION 2-8 CONTENT 2-8 DIRECTORY 2-9 DUMPFILE 2-9 ENCRYPTION_PASSWORD 2-10 ESTIMATE 2-12 ESTIMATE_ONLY 2-12 EXCLUDE 2-13 FILESIZE 2-14 FLASHBACK_SCN 2-15 FLASHBACK_TIME 2-16 FULL 2-17 HELP 2-17 INCLUDE 2-17 JOB_NAME 2-19 LOGFILE 2-19 NETWORK_LINK 2-20 NOLOGFILE 2-21 PARALLEL 2-21 PARFILE 2-22 QUERY 2-23 SAMPLE 2-24 SCHEMAS 2-24 STATUS 2-25 TABLES 2-25 TABLESPACES 2-26 TRANSPORT_FULL_CHECK 2-27 TRANSPORT_TABLESPACES 2-28 VERSION 2-28 iv 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 FILESIZE HELP KILL_JOB PARALLEL START_JOB STATUS STOP_JOB Examples of Using Data Pump Export Performing a Table-Mode Export Data-Only Unload of Selected Tables and Rows Estimating Disk Space Needed in a Table-Mode Export Performing a Schema-Mode Export Performing a Parallel Full Database Export Using Interactive Mode to Stop and Reattach to a Job Syntax Diagrams for Data Pump Export 2-29 2-31 2-32 2-32 2-32 2-33 2-33 2-33 2-34 2-34 2-35 2-35 2-36 2-36 2-36 2-37 2-37 2-37 2-37 2-38 Data Pump Import What Is Data Pump Import? 3-1 Invoking Data Pump Import 3-2 Data Pump Import Interfaces 3-2 Data Pump Import Modes 3-3 Full Import Mode 3-3 Schema Mode 3-3 Table Mode 3-4 Tablespace Mode 3-4 Transportable Tablespace Mode 3-4 Network Considerations 3-4 Filtering During Import Operations 3-5 Data Filters 3-5 Metadata Filters 3-5 Parameters Available in Import's Command-Line Mode 3-6 ATTACH 3-7 CONTENT 3-7 DIRECTORY 3-8 DUMPFILE 3-9 ENCRYPTION_PASSWORD 3-9 ESTIMATE 3-10 EXCLUDE 3-11 FLASHBACK_SCN 3-13 FLASHBACK_TIME 3-13 FULL 3-14 HELP 3-15 v loading datafiles containing tabs, 9-3 trimming, 9-33 whitespace, 9-33 temporary segments, 11-24 FILE parameter SQL*Loader, 11-25 temporary storage in a direct path load, 11-9 TERMINATED BY clause WHITESPACE SQL*Loader, 9-19 with OPTIONALLY ENCLOSED BY, 9-36 terminated fields specified with a delimiter, 9-36 specified with delimiters and SQL*Loader, 9-19 time SQL*Loader datatypes for, 9-12 TOID_NOVALIDATE parameter Import utility, 19-39 TOUSER parameter Import utility, 19-40 trailing blanks loading with delimiters, 9-22 TRAILING NULLCOLS parameter SQL*Loader utility, 8-3, 8-29 trailing whitespace trimming, 9-38 TRANSFORM parameter Data Pump Import utility, 3-30 transparent data encryption as handled by Data Pump Export, 2-10 as handled by Data Pump Import, 3-9 TRANSPORT_DATAFILES parameter Data Pump Import utility, 3-32 TRANSPORT_FULL_CHECK parameter Data Pump Export utility, 2-27 Data Pump Import utility, 3-32 TRANSPORT_TABLESPACE parameter Export utility, 19-28 Import utility, 19-40 TRANSPORT_TABLESPACES parameter Data Pump Export utility, 2-28 Data Pump Import utility, 3-33 transportable tablespaces, 19-58 transportable-tablespace mode Export Data Pump Export utility, 2-4 triggers database insert, 11-20 logon effect in SQL*Loader, 8-25 permanently disabled, 11-22 replacing with integrity constraints, 11-20 system testing, 19-11 update SQL*Loader, 11-21 TRIGGERS parameter Export utility, 19-28 trimming summary, 9-34 trailing whitespace SQL*Loader, 9-38 TTS_FULL_CHECK parameter Export utility, 19-28 TTS_OWNERS parameter Import utility, 19-40 U undo tablespace consumption by Data Pump, 1-15 UNIQUE KEY constraints effect on direct path load, 11-25 unique values generating with SQL*Loader, 9-46 unloading entire database Data Pump Export utility, 2-3 UNRECOVERABLE clause SQL*Loader, 11-15 unsorted data direct path load SQL*Loader, 11-13 updating rows in a table SQL*Loader, 8-26 user mode export specifying, 19-23 USER_SEGMENTS view Export and, 19-3 user-defined constructors, 10-6 loading column objects with, 10-6 USERID parameter Export utility, 19-28 Import utility, 19-41 SQL*Loader command line, 7-12 V V$DATABASE view, 17-29 V$LOGMNR_CONTENTS view, 17-12 formatting information returned to, 17-14 impact of querying, 17-12 information within, 17-10 limiting information returned to, 17-14 LogMiner utility, 17-4 requirements for querying, 17-9, 17-12 V$LOGMNR_DICTIONARY view, 17-29 V$LOGMNR_LOGS view, 17-9, 17-29 querying, 17-29 V$LOGMNR_PARAMETERS view, 17-28, 17-29 V$SESSION_LONGOPS view monitoring Data Pump jobs with, 1-9 value datatypes, 9-6 VARCHAR datatype SQL*Loader, 9-10 VARCHAR2 datatype SQL*Loader, 9-18 VARCHARC datatype SQL*Loader, 9-16 VARGRAPHIC datatype SQL*Loader, 9-9 Index-19 variable records, 6-4 format, 10-2 variable-length records external tables, 13-4 VARRAW datatype, 9-11 VARRAWC datatype, 9-17 VARRAY columns memory issues when loading, 10-26 VERSION parameter Data Pump Export utility, 2-28 Data Pump Import utility, 3-34 VOLSIZE parameter Export utility, 19-29 Import utility, 19-41 W warning messages Export, 19-54 Import, 19-54 WHEN clause SQL*Loader, 8-27, 9-23 SQL*Loader discards resulting from, 8-12 whitespace included in a field, 9-37 leading, 9-35 preserving, 9-39 terminating a field, 9-19, 9-37 trimming, 9-33 X XML columns loading, 10-13 treatment by SQL*Loader, 10-13 XML type tables identifying in SQL*Loader, 8-5 XMLTYPE clause in SQL*Loader control file, 8-5 Z ZONED datatype, 9-8 EXTERNAL format SQL*Loader, 9-15 Index-20 ... Syntax Diagrams for Data Pump Export 2- 29 2- 31 2- 32 2- 32 2- 32 2-33 2- 33 2- 33 2- 34 2- 34 2- 35 2- 35 2- 36 2- 36 2- 36 2- 37 2- 37 2- 37 2- 37 2- 38 Data Pump Import What Is Data Pump Import?... 2- 22 QUERY 2- 23 SAMPLE 2- 24 SCHEMAS 2- 24 STATUS 2- 25 TABLES 2- 25 TABLESPACES 2- 26 TRANSPORT_FULL_CHECK... 2- 17 JOB_NAME 2- 19 LOGFILE 2- 19 NETWORK_LINK 2- 20 NOLOGFILE 2- 21 PARALLEL 2- 21 PARFILE 2- 22