Creates an Oracle Rdb database from an interchange .rbr file. You use the IMPORT statement with the EXPORT statement to make changes to Oracle Rdb databases that cannot be made any other way. The EXPORT statement unloads a database to an .rbr file. The IMPORT statement re-creates the database with changes that may not be allowed by an ALTER DATABASE statement. The IMPORT statement lets you: o Convert from a single-file to a multifile database, and vice versa. o Change database root file parameters that you cannot change with the ALTER DATABASE statement: - COLLATING SEQUENCE - SEGMENTED STRING STORAGE AREA - PROTECTION IS ANSI/ACLS - DEFAULT STORAGE AREA o Change storage area parameters that you cannot change with the ALTER DATABASE statement: - PAGE SIZE - PAGE FORMAT - THRESHOLDS - INTERVAL - FILENAME, SNAPSHOT FILENAME o Reload tables with existing rows to take advantage of newly created hashed indexes. o Reload tables to take advantage of new or changed storage maps. o Move a database to another directory or disk structure. However, if moving a database is the only change you need to make, it is more efficient to use the RMU Backup and RMU Restore commands. o Create an empty target database that uses the same data definitions as a source database by copying the metadata, but not the data, to the target. If you use the NO DATA option, the IMPORT statement creates an Oracle Rdb database whose metadata is identical to that found in the source database used by the EXPORT statement, but the duplicate database contains no data. The NO DATA option is not compatible with the repository databases. See the description in the Arguments section under the NO DATA option.
1 – Environment
You can use the IMPORT statement in interactive SQL only.
2 – Format
(B)0[m[1;4mIMPORT[m[1m [1;4mDATABASE[m[1m qq> [1;4mFROM[m[1m <file-spec> qk [m [1mlqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1mmqwq> [1;4mFILENAME[m[1m <file-spec> qqwqqqqqqqqqqqqqqqqqqqqqqwqk [m [1m x mq> literal-user-auth qj x [m [1m mq> [1;4mWITH[m[1m [1;4mALIAS[m[1m <alias> qqqqqqqqqqqqqqqqqqqqqqqqqqqqqu [m [1mlqqqqqqqqqqqqqqqqqqqqqqqqqqqq<qqqqqqqqqqqqqqqqqqqqqqqqj [m [1mmwqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqwqqqqqqqqqqq>[m [1mx[m [1mtq> import-options qqqqqqqqqqqqqqqqqqqqu[m [1mx[m [1mx[m [1mtq>[m [1mcharacter-sets qqqqqqqqqqqqqqqqqqqqu[m [1mx[m [1m x tq> import-root-file-params-1 qqqqqqqqqu x [m [1m x tq> import-root-file-params-2 qqqqqqqqqu x [m [1m x tq> import-root-file-params-3 qqqqqqqqqu x [m [1m x tq> import-root-file-params-4 qqqqqqqqqu x [m [1m x tq> storage-area-params-1 qqqqqqqqqqqqqu x [m [1m x tq> storage-area-params-2 qqqqqqqqqqqqqu x [m [1m x tq> create-clause/statement qqqqqqqqqqqu x [m [1m x mq> drop-statement qqqqqqqqqqqqqqqqqqqqj x [m [1m mqqqqqqqqqqqqqqqqq<qqqqqqqqqqqqqqqqqqqqqqqqj [m [1m [m (B)0[m[1mliteral-user-auth = [m [1m [m [1mqqq> [1;4mUSER[m[1m '<username>' qwqqqqqqqqqqqqqqqqqqqqqqqqwqq> [m [1m mq> [1;4mUSING[m[1m '<password>' qj [m [1m [m (B)0[m[1mimport-options=[m [1m [m [1mqwqwqqqqqqqwqwq> [1;4mACL[m[1m qqqqqqqqqqqqqqqqwqwqqq> [m [1m x mq> [1;4mNO[m[1m qj tq> [1;4mBANNER[m[1m qqqqqqqqqqqqqu x [m [1m x tq> [1;4mBATCH[m[1m [1;4mUPDATE[m[1m qqqqqqqu x [m [1mx[m [1mtq> [1;4mCDD[m[1m [1;4mLINKS[m[1m qqqqqqqqqqu[m [1mx[m [1m x tq> [1;4mDATA[m[1m qqqqqqqqqqqqqqqu x [m [1m x tq> [1;4mFORWARD[m[1m_[1;4mREFERENCES[m[1m qu[m [1mx[m [1m x mq> [1;4mTRACE[m[1m qqqqqqqqqqqqqqj x [m [1mtq>[m [1;4mCOMMIT[m [1;4mEVERY[m [1;4mTABLE[m[1m qqqqqqqqqqqqqqu[m [1mmq> [1;4mCOMMIT[m[1m [1;4mEVERY[m[1m [1;4mn[m[1m [1;4mROWS[m[1m qqqqqqqqqqqqqqj[m (B)0[m[1mcharacter-sets = [m [1m [m [1m [m [1mqwqwqq> [1;4mDEFAULT[m[1m [1;4mCHARACTER[m[1m [1;4mSET[m[1m <support-char-set> qqwqwq>[m [1m x[m [1mtqq> [1;4mNATIONAL[m[1m [1;4mCHARACTER[m[1m [1;4mSET[m[1m <support-char-set> qu x [m [1m x[m [1mtqq> [1;4mIDENTIFIER[m[1m [1;4mCHARACTER[m[1m [1;4mSET[m[1m <names-char-set> qj x [m [1mx[m [1mmqq> [1;4mDISPLAY[m[1m [1;4mCHARACTER[m[1m [1;4mSET[m[1m <support-char-set> qqqqu[m [1mmqqqqqqqqqqqqqqqqqqqqqq <qqqqqqqqqqqqqqqqqqqqqqqqqqqj[m (B)0[m[1mimport-root-file-params-1 = [m [1m [m [1m [m [1m [m [1mqwq> [1;4mPATHNAME[m[1m <path-name> qqqqqqqqqqqqqqqqqqqqqqqqqqqqqwq>[m [1m tq> attach-options qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqu [m [1m tq> [1;4mCOLLATING[m[1m [1;4mSEQUENCE[m[1m <sequence-name> qqqqqqk [m [1mx [m [1m x lqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1mx [m [1m x mwqqqqqqqqqqqqqqqwqqqqwqqqqqqqqqqqqqqqqwqqk [m [1mx [m [1m x mq> [1;4mCOMMENT[m[1m [1;4mIS[m[1m qj mq> '<string> ' qj x [m [1mx [m [1m x lqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1mx [m [1m x mqq> <ncs-name> qwqqqqqqqqqqqqqqqqqqqqqqqwqqqqqqqqqu [m [1m x mq> [1;4mFROM[m[1m <library-name> j [m [1mx [m [1m tq> [1;4mNUMBER[m[1m OF [1;4mUSERS[m[1m qq> <number-users> qqqqqqqqqqqqqqqu [m [1m tq> [1;4mNUMBER[m[1m OF [1;4mBUFFERS[m[1m qqqqq> <number-buffers> qqqqqqqqu [m [1m tq> [1;4mNUMBER[m[1m OF [1;4mCLUSTER[m[1m [1;4mNODES[m[1m qqqq> <number-nodes> qqk[m [1mx [m [1mx[m [1mlqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj[m [1mx[m [1mx[m [1mmqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqqqqu[m [1mx[m [1mmq> ( qwq>[m [1;4mSINGLE[m [1mqqqwq> [1;4mINSTANCE[m[1m qq> ) qqj[m [1mx[m [1mx[m [1mmq>[m [1;4mMULTIPLE[m[1m qj[m [1mx[m [1m tq> [1;4mNUMBER[m[1m OF [1;4mRECOVERY[m[1m [1;4mBUFFERS[m[1m q> <number-buffers> [m [1mx [m [1m tq> [1;4mBUFFER[m[1m [1;4mSIZE[m[1m IS q> <buffer-blocks> q> [1;4mBLOCKS[m[1m qqqqqqu [m [1m mq> global-buffer-params qqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m (B)0[m[1mattach-options = [m [1m [m [1mqwq> [1;4mDBKEY[m[1m qwq> SCOPE IS qwq> [1;4mATTACH[m[1m qqqqqqqwqqqqqqqqqqqqqqqqqqqqqqqwq>[m [1m tq> [1;4mROWID[m[1m qj mq> [1;4mTRANSACTION[m[1m qqj x [m [1m tq> [1;4mMULTISCHEMA[m[1m IS qwq> [1;4mON[m[1m qqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqu [m [1m x mq> [1;4mOFF[m[1m qj x [m [1m tq> [1;4mPRESTARTED[m[1m [1;4mTRANSACTIONS[m[1m [1;4mARE[m[1m qwq> [1;4mON[m[1m qqwqqqqqqqqqqqqqqqqqqqqqqqqu [m [1m x mq> [1;4mOFF[m[1m qj x [m [1m mqwqqqqqqqwq> [1;4mRESTRICTED[m[1m [1;4mACCESS[m[1m qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1m mq> [1;4mNO[m[1m qj [m (B)0[m[1mglobal-buffer-params= [m [1m [m [1mqq> [1;4mGLOBAL[m[1m [1;4mBUFFERS[m[1m ARE qwq> [1;4mENABLED[m[1m qqwqqqqqqqqqqqqqqk [m [1m mq> [1;4mDISABLED[m[1m qj x [m [1mlqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1mtqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqqq> [m [1mm> ( qwwq> [1;4mNUMBER[m[1m IS <number-glo-buffers> qqqqww> ) j [m [1m xtq> [1;4mUSER[m[1m [1;4mLIMIT[m[1m IS <max-glo-buffers> qqqux [m [1m xtq> [1;4mPAGE[m[1m [1;4mTRANSFER[m[1m [1;4mVIA[m[1m qqwq> [1;4mDISK[m[1m qqqwqqjx [m [1m xx mq> [1;4mMEMORY[m[1m qj x [m [1mxmq> [1;4mLARGE[m[1m [1;4mMEMORY[m[1m IS qqwqq> [1;4mENABLED[m [1mqqwqqu[m [1mx[m [1mmqq>[m [1;4mDISABLED[m [1mqj[m [1mx[m [1mmqqqqqqqqqqqqqqqqqqq , <qqqqqqqqqqqqqqqqj[m [1m [m [1m [m (B)0[m[1mimport-root-file-params-2 = [m [1m [m [1mqwq> [1;4mSNAPSHOT[m[1m IS qw> [1;4mENABLED[m[1m qwq> [1;4mIMMEDIATE[m[1m qqwqwqqqqqqqqqqqqqqqqqqwq>[m [1m x x mq> [1;4mDEFERRED[m[1m qqqj x x [m [1m x m> [1;4mDISABLED[m[1m qqqqqqqqqqqqqqqqqqj x [m [1m tq> [1;4mDICTIONARY[m[1m IS qqqwqqq> [1;4mREQUIRED[m[1m qqqqqqqwqqqqqqqqqqqqqqqqqqqqqqu [m [1m x mqqq> [1;4mNOT[m[1m [1;4mREQUIRED[m[1m qqqj x [m [1m tq> [1;4mADJUSTABLE[m[1m [1;4mLOCK[m[1m [1;4mGRANULARITY[m[1m IS qwq> [1;4mENABLED[m[1m q> alg-options qwqu [m [1m x mq> [1;4mDISABLED[m[1m qqqqqqqqqqqqqqqj x [m [1m tq> [1;4mLOCK[m[1m [1;4mTIMEOUT[m[1m [1;4mINTERVAL[m[1m IS <number-seconds> SECONDS qqqqqqqqqqqqu [m [1m tq> [1;4mSEGMENTED[m[1m [1;4mSTRING[m[1m qwq> [1;4mSTORAGE[m[1m [1;4mAREA[m[1m IS <area-name> qqqqqqqqqqqqu [m [1m tq> [1;4mLIST[m[1m qqqqqqqqqqqqqu x [m [1m tq> [1;4mDEFAULT[m[1m qqqqqqqqqqj x [m [1m tq> [1;4mPROTECTION[m[1m IS qqqwqqq> [1;4mANSI[m[1m qqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqu [m [1m x mqqq> [1;4mACLS[m[1m qqj x [m [1m mq> [1;4mRESERVE[m[1m <n> qqwq> [1;4mCACHE[m[1m [1;4mSLOTS[m[1m qqqqqwqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1m tq> [1;4mJOURNALS[m[1m qqqqqqqqu [m [1m tq> [1;4mSTORAGE[m[1m [1;4mAREAS[m[1m qqqu [m [1m mq> [1;4mSEQUENCES[m[1m qqqqqqqj [m (B)0[m[1malg-options = [m [1m [m [1mqqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqq> [m [1m mq> ( qq> [1;4mCOUNT[m[1m IS <n> qq> ) qqj [m [1m [m (B)0[m[1mimport-root-file-params-3 = [m [1m [m [1mqw> [1;4mCARDINALITY[m[1m [1;4mCOLLECTION[m[1m IS qqqqqqqqqqqqqqwqqwq> [1;4mENABLED[m[1m qqwqqqqqqqqw>[m [1m t> [1;4mCARRY[m[1m [1;4mOVER[m[1m [1;4mLOCKS[m[1m ARE qqqqqqqqqqqqqqqqqqqu mq> [1;4mDISABLED[m[1m qj x[m [1mt>[m [1;4mGALAXY[m [1;4mSUPPORT[m[1m IS qqqqqqqqqqqqqqqqqqqqqqu[m [1m [m [1mx[m [1m t> [1;4mLOCK[m[1m [1;4mPARTITIONING[m[1m [1;4mIS[m[1m qqqqqqqqqqqqqqqqqqqu x[m [1mt> [1;4mLOGMINER[m [1;4mSUPPORT[m[1m IS[m [1mqqqqqqqqqqqqqqqqqqqqu[m [1m [m [1mx[m [1m t> [1;4mMETADATA[m[1m [1;4mCHANGES[m[1m ARE qqqqqqqqqqqqqqqqqqqu x[m [1m t> [1;4mSTATISTICS[m[1m [1;4mCOLLECTION[m[1m IS qqqqqqqqqqqqqqqu x[m [1m t> [1;4mWORKLOAD[m[1m [1;4mCOLLECTION[m[1m IS qqqqqqqqqqqqqqqqqj x[m [1m t> [1;4mSYSTEM[m[1m [1;4mINDEX[m[1m qwq> [1;4mCOMPRESSION[m[1m IS qwq> [1;4mENABLED[m[1m qqqwqqqqqwqqqqqqqqqqu[m [1mx[m [1m x[m [1mmq>[m [1;4mDISABLED[m [1mqqj[m [1mx[m [1mx[m [1mx[m [1m mq>[m [1m( qwq> system-index-options qwq> ) qqj [m [1mx[m [1mx[m [1mmqqqqqqqqqq , <qqqqqqqqqqqj[m [1m [m [1mx[m [1mt> [1;4mPRESTARTED[m [1;4mTRANSACTIONS[m[1m ARE w> [1;4mENABLED[m[1m q> prestart-trans-options wu [m [1m x m> [1;4mDISABLED[m[1m qqqqqqqqqqqqqqqqqqqqqqqqqjx [m [1m t> [1;4mSECURITY[m[1m [1;4mCHECKING[m[1m IS qqq> security-checking-options qqqqqqqqqqqqqqu [m [1mm> [1;4mSYNONYMS[m[1m ARE [1;4mENABLED[m[1m qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m (B)0[m[1msystem-index-options =[m [1mqwq> [1;4mCOMPRESSION[m[1m IS[m [1mqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwwq[m [1;4mENABLED[m[1m qwwq>[m [1mtq>[m [1;4mPREFIX[m [1;4mCARDINALITY[m [1;4mCOLLECTION[m[1m IS[m [1mqqqqqqqqqqqqqqjm>[m [1;4mDISABLED[m[1m jx[m [1mtq>[m [1;4mPREFIX[m [1;4mCARDINALITY[m [1;4mCOLLECTION[m[1m IS [1;4mENABLED[m [1;4mFULL[m [1mqqqqqqqqqqqqqqqu[m [1mmq>[m [1;4mTYPE[m [1mIS [1;4mSORTED[m [1mqqwqqqqqqqqqqqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj[m [1mmq> [1;4mRANKED[m [1mqj[m (B)0[m[1mprestart-trans-options =[m [1mqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwq>[m [1mtq>[m [1;4mWAIT[m[1m <n> [1;4mSECONDS[m [1;4mFOR[m [1;4mTIMEOUT[m [1mqu[m [1mtq>[m [1;4mWAIT[m[1m <n> [1;4mMINUTES[m [1;4mFOR[m [1;4mTIMEOUT[m [1mqu[m [1mmq>[m [1;4mNO[m [1;4mTIMEOUT[m [1mqqqqqqqqqqqqqqqqqqqj[m (B)0[m[1msecurity-checking-options =[m [1mqwq>[m [1;4mEXTERNAL[m[1m qwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwwq>[m [1mx [m [1mmq>[m [1m( q> [1;4mPERSONA[m [1;4mSUPPORT[m[1m IS qwq>[m [1;4mENABLED[m [1mqqw> ) qjx[m [1mx[m [1mmq>[m [1;4mDISABLED[m [1mqj[m [1mx[m [1mmq> [1;4mINTERNAL[m[1m qwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqj[m [1mmq> ( q> [1;4mACCOUNT[m [1;4mCHECK[m[1m IS qwqqq>[m [1;4mENABLED[m [1mqqw> ) j[m [1mmqqq>[m [1;4mDISABLED[m[1m qj[m (B)0[m[1mimport-root-file-params-4 = [m [1mqwq> [1;4mASYNC[m[1m [1;4mBATCH[m[1m [1;4mWRITES[m[1m ARE qqwq> [1;4mENABLED[m[1m qq> async-bat-wr-options qwqw>[m [1m x mq> [1;4mDISABLED[m[1m qqqqqqqqqqqqqqqqqqqqqqqqqj x[m [1m twqqqqqqqqqqqqwq> [1;4mASYNC[m[1m [1;4mPREFETCH[m[1m IS qqk x[m [1m xm> [1;4mDETECTED[m[1m qj lqqqqqqqqqqqqqqqqqqqj x[m [1m x mqwq> [1;4mENABLED[m[1m qqq> async-prefetch-options wqqqqqqqqu[m [1m x mq> [1;4mDISABLED[m[1m qqqqqqqqqqqqqqqqqqqqqqqqqqqj x[m [1m tq> [1;4mROW[m[1m [1;4mCACHE[m[1m IS qwq> [1;4mENABLED[m[1m qqwqwqqqqqqqqqqqqqqqqqqqqqqwqqqqqqqqqqqu[m [1m x mq> [1;4mDISABLED[m[1m qj mq> row-cache-options qj x[m [1mtwqqqqqqwq> [1;4mINCREMENTAL[m[1m [1;4mBACKUP[m[1m [1;4mSCAN[m[1m [1;4mOPTIMIZATION[m[1m qqqqqqqqqqqqqqqqqqqqu [m [1mxm> [1;4mNO[m[1m qj [m [1mx [m [1m tq> [1;4mMULTITHREAD[m[1m [1;4mAREA[m[1m [1;4mADDITIONS[m[1m qqqq> multithread-options qqqqqqqqqqqqu [m [1m tq> [1;4mRECOVERY[m[1m [1;4mJOURNAL[m[1m q> ( q> ruj-options q> ) qqqqqqqqqqqqqqqqqqqqqqqu [m [1m mq> [1;4mSHARED[m[1m [1;4mMEMORY[m[1m IS qqwq> [1;4mSYSTEM[m[1m qqqqqqqqqqqqqqqqqqqqqwqqqqqqqqqqqqqj [m [1m mq> [1;4mPROCESS[m[1m qqwqqqqqqqqqqqqqwqqqj [m [1mmq> [1;4mRESIDENT[m[1m qj[m (B)0[m[1masynch-bat-wr-options = [m [1m [m [1mqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqq>qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwq> [m [1m m ( wwq> [1;4mCLEAN[m[1m [1;4mBUFFER[m[1m [1;4mCOUNT[m[1m IS <buffer-count> [1;4mBUFFERS[m[1m qqww> ) j [m [1m xmq> [1;4mMAXIMUM[m[1m [1;4mBUFFER[m[1m [1;4mCOUNT[m[1m IS <buffer-count> [1;4mBUFFERS[m[1m jx [m [1m mqqqqqqqqqqqqqqqqqqq , <qqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1m [m (B)0[m[1;7ma[m[1msync-prefetch-options = [m [1m [m [1mqqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqw>[m [1m mq> ( qwqwq> [1;4mDEPTH[m[1m IS <number-buffers> [1;4mBUFFERS[m[1m qqqqqwqqw> )qj [m [1m x mq> [1;4mTHRESHOLD[m[1m IS <number-buffers> [1;4mBUFFERS[m[1m qj x [m [1m mqqqqqqqqqqqqqqqqq , <qqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1m [m (B)0[m[1mrow-cache-options = [m [1m [m [1mq> ( qwwq>[m [1;4mCHECKPOINT[m[1m qwq>[m [1;4mALL[m[1m [1;4mROWS[m[1m [1;4mTO[m[1m [1;4mBACKING[m[1m [1;4mFILE[m[1m qqqqqqqqqqqwqwwq> ) qq> [m [1m [m [1mxx[m [1mtq> [1;4mTIMED[m[1m EVERY <n> SECONDS[m [1mqqqqqqqqqqqqu[m [1mxx[m [1m [m [1mxx[m [1mmq>[m [1;4mUPDATED[m[1m [1;4mROWS[m[1m [1;4mTO[m[1m qwq> [1;4mBACKING[m[1m [1;4mFILE[m [1mqwj[m [1mxx[m [1m xx [m [1m mq> [1;4mDATABASE[m[1m qqqqqj[m [1mxx[m [1mxtq> [1;4mLOCATION[m[1m IS qq> <directory-spec> qqqqqqqqqqqqqqqqqqqqqux[m [1mxtq> [1;4mNO[m[1m qqwqq> [1;4mLOCATION[m[1m qqqqqqqqwqqqqqqqqqqqqqqqqqqqqqqqqqqux[m [1mxx[m [1mmqq>[m [1;4mSWEEP[m[1m [1;4mINTERVAL[m[1m qqj[m [1mxx[m [1mxtq>[m [1;4mNUMBER[m[1m OF [1;4mSWEEP[m[1m [1;4mROWS[m[1m IS <n>[m [1mqqqqqqqqqqqqqqqqqqqqqqqqqqux[m [1mxmq>[m [1;4mSWEEP[m[1m [1;4mINTERVAL[m[1m IS <n> SECONDS[m [1mqqqqqqqqqqqqqqqqqqqqqqqqjx[m [1mmqqqqqqqqqqqqqqqqqqqqqqqqqq , <qqqqqqqqqqqqqqqqqqqqqqqqqqqqqj[m (B)0[m[1mmultithread-options = [m [1m [m [1mqqqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqq> [m [1m mq> ( qqwq> [1;4mALL[m[1m [1;4mAREAS[m[1m qqqqqqqqqqqwqq> ) qqj [m [1m mq> [1;4mLIMIT[m[1m [1;4mTO[m[1m <n> [1;4mAREAS[m[1m qqj [m [1m [m (B)0[m[1mruj-options = [m [1m [m [1mqwq> [1;4mLOCATION[m[1m IS qq> <directory-spec> qwqq> [m [1m tq> [1;4mNO[m[1m [1;4mLOCATION[m[1m qqqqqqqqqqqqqqqqqqqqqqu [m [1m mq> [1;4mBUFFER[m[1m [1;4mMEMORY[m[1m IS qwq> [1;4mLOCAL[m[1m qqqqqqu [m [1mmq> [1;4mGLOBAL[m[1m qqqqqj[m (B)0[m[1mstorage-area-params-1 = [m [1m [m [1mqqwq> [1;4mALLOCATION[m[1m IS qqq> <number-pages> qq> PAGES qqqqqwq>[m [1m tq> [1;4mCACHE[m[1m [1;4mUSING[m[1m <row-cache-name> qqqqqqqqqqqqqqqqqqqqu [m [1m tq> [1;4mNO[m[1m ROW [1;4mCACHE[m[1m qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqu [m [1m tq> extent-params qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqu [m [1m tq> [1;4mINTERVAL[m[1m IS qq> <number-data-pages> qqqqqqqqqqqqqu [m [1m tq> [1;4mLOCKING[m[1m IS qqwq> [1;4mROW[m[1m qqwqq> LEVEL qqqqqqqqqqqqqqqu [m [1m x mq> [1;4mPAGE[m[1m qj x [m [1m tq> [1;4mPAGE[m[1m [1;4mFORMAT[m[1m IS wq> [1;4mUNIFORM[m[1m qwqqqqqqqqqqqqqqqqqqqqu [m [1m x mq> [1;4mMIXED[m[1m qqqj x [m [1m mq> [1;4mPAGE[m[1m [1;4mSIZE[m[1m IS qqqq> <page-blocks> qq> BLOCKS qqqqqj [m [1m [m (B)0[m[1mextent-params = [m [1m [m [1mqqwq> [1;4mEXTENT[m[1m IS qwq> [1;4mENABLED[m[1m qqqqqqqqqqqqqqqqqqqwwqq> [m [1m x tq> [1;4mDISABLED[m[1m qqqqqqqqqqqqqqqqqqux [m [1m x tq> <extent-pages> qq> PAGES qqux [m [1m x mq> (extension-options) qqqqqqqjx [m [1m mqqqqqqqqqqqqqqqqqqqqq<qqqqqqqqqqqqqqqqqqqqqqqqj [m [1m [m (B)0[m[1mextension-options = [m [1m [m [1mqqq> [1;4mMINIMUM[m[1m OF <min-pages> PAGES, qqk [m [1mlqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1mmqq> [1;4mMAXIMUM[m[1m OF <max-pages> PAGES, qqk [m [1mlqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1mmqq> [1;4mPERCENT[m[1m [1;4mGROWTH[m[1m IS <growth> qqqqqqq> [m [1m [m (B)0[m[1mstorage-area-params-2 = [m [1m [m [1mqqwq> [1;4mCHECKSUM[m[1m CALCULATION IS qqqqqqqqqqqwqqwq> [1;4mENABLED[m[1m qqwqwq>[m [1m tq> [1;4mSNAPSHOT[m[1m [1;4mCHECKSUM[m[1m CALCULATION IS qqj mq> [1;4mDISABLED[m[1m qj x [m [1m tq> [1;4mSNAPSHOT[m[1m [1;4mALLOCATION[m[1m IS qq> <snp-pages> qqqq> PAGES qqqu [m [1m tq> [1;4mSNAPSHOT[m[1m [1;4mEXTENT[m[1m IS qwq> <extent-pages> qqqq> PAGES qqwu [m [1m x mq> (extension-options) qqqqqqqqqjx [m [1m tq> [1;4mSNAPSHOT[m[1m [1;4mFILENAME[m[1m qq> <file-spec> qqqqqqqqqqqqqqqqqqqqu [m [1m tq> [1;4mTHRESHOLDS[m[1m ARE ( <val1> wqqqqqqqqqqqqqqqqqqqqqqqw> ) qu [m [1m x m> ,<val2> qwqqqqqqqqqqwj x [m [1m x m> ,<val3> j x [m [1m mq[mqqqqqqqqqqqqqqqqqqqqqqqqqqqqq[1m<qqqqqqqqqqqqqqqqqqqqqqqqqqj [m [1m [m (B)0[m[1mcreate-clause/statement = [m [1m [m [1mqwq> create-cache-clause qqqqqqqqqqqwq> [m [1m tq> create-index-statement qqqqqqqqu [m [1m tq> create-storage-area-clause qqqqu [m [1m mq> create-storage-map-statement qqj [m [1m [m (B)0[m[1mdrop-statement = [m [1m [m [1mqqqwq> [1;4mDROP[m[1m [1;4mCACHE[m[1m <row-cache-name> qqqqqwq> [m [1mtq> [1;4mDROP[m[1m [1;4mINDEX[m[1m <index-name>[m [1mqqqqqqqqqu[m [1mtq> [1;4mDROP[m[1m [1;4mSTORAGE[m[1m [1;4mAREA[m[1m <area-name> qqqu[m [1m mq> [1;4mDROP[m[1m [1;4mSTORAGE[m[1m [1;4mMAP[m[1m <map-name> qqqqqj [m [1m [m
3 – Arguments
3.1 – ACL
Syntax options: ACL | NO ACL Specifies that the IMPORT statement uses the access control lists from the original database when it creates the new database. The ACL option is the default. If you are using the IMPORT statement to restructure a database, you typically want to use the ACL option and preserve the access control lists. The NO ACL option overrides the ACLs from the original database and uses the database system default ACLs. Specify NO ACL if you are using the IMPORT statement to rebuild a database on a different system. The NO ACL option makes you the owner of the new database and creates default access control lists.
3.2 – BANNER
Syntax options: BANNER | NO BANNER This clause requests that IMPORT display informational messages during the import of the database header, such as product identification, and values for some database parameters. The default is NO BANNER which will mean most IMPORT statements generate no output.
3.3 – BATCH_UPDATE
Syntax options: BATCH UPDATE | NO BATCH UPDATE Specifies whether the IMPORT statement stores user data and indexes using batch-update transactions (BATCH UPDATE) or read/write transactions for each table (NO BATCH UPDATE). The NO BATCH UPDATE option is the default. A batch-update transaction is faster but does not perform recovery-unit journaling, which means you cannot recover the database in the event of a failure during the IMPORT operation. With the NO BATCH UPDATE option, you can recover the database. For more information about batch-update transactions, see the SET_TRANSACTION statement.
3.4 – CDD_LINKS
Syntax options: CDD LINKS | NO CDD LINKS Determines whether the IMPORT statement tries to reestablish links between database definitions originally based on repository definitions (domains and tables created with the FROM path name clause) and their sources in the repository. The default depends on whether or not the IMPORT statement specifies the PATHNAME option. If the IMPORT statement does specify PATHNAME, the default is CDD LINKS; if it does not specify PATHNAME, the default is NO CDD LINKS. The CDD LINKS option specifies that the IMPORT statement tries to reestablish repository links even if you do not specify the PATHNAME option. If you specify CDD LINKS and the database repository definition on which a database definition was based does not exist, the IMPORT statement generates a warning message. The NO CDD LINKS option specifies that the IMPORT statement does not establish data repository links even if you specify the PATHNAME option. Specify NO CDD LINKS if you are using the IMPORT statement to rebuild a database on a different system.
3.5 – COMMIT_EVERY
Syntax options: COMMIT EVERY TABLE | COMMIT EVERY n ROWS Specifies whether the IMPORT statement commits entire tables, or commits a certain number of rows at regular intervals. If you use the COMMIT EVERY n ROWS clause, you can supply a value from 1 to 2147483647 for n. The default is COMMIT EVERY TABLE. If you use the COMMIT EVERY n ROWS clause, the table will be left with a partial set of rows if the IMPORT process fails. NOTE If the table being imported includes a storage map with the PLACEMENT VIA INDEX clause, then the COMMIT EVERY clause is ignored for that table. A message is displayed to inform the database administrator of the tables that did not have COMMIT EVERY applied. This condition is shown in Example 6.
3.6 – create-cache-clause
See the CREATE CACHE clause for a complete description.
3.7 – create-index-statement
See the CREATE INDEX statement for a complete description.
3.8 – create-storage-area-clause
See the CREATE STORAGE_AREA statement for a complete description.
3.9 – create-storage-map-statement
See the CREATE STORAGE_MAP statement for a complete description.
3.10 – DATA
Syntax options: DATA | NO DATA Specifies whether the database created by the IMPORT statement includes the data and metadata contained in the source database, or the metadata only. DATA is the default. When you specify the NO DATA option, you import the metadata that defines a database from an .rbr file and exclude the data. Duplicating the metadata of a database while excluding the data offers the following benefits: o You can use established, tested metadata to create a database to store new data. Standardized metadata can be created once but used in multiple databases. o You can use the duplicated metadata to test the database structure. You can experiment with storage areas and storage maps, and by entering sample data, you can test other aspects of database structure. o If a database needs testing by someone outside of your group, you can submit the database metadata without exposing any sensitive data. Also, if the database is very large, you need not submit multiple reels of tape to the tester. NOTE The NO DATA option is not compatible with repository databases (CDD$DATABASE.RDB). An .rbr file, created by an EXPORT statement with the DATA option (the default) and generated from a CDD$DATABASE.RDB file, cannot be used with the NO DATA option for the IMPORT statement. SQL issues an error message stating that the NO DATA option is not valid for repository databases.
3.11 – DROP_CACHE
Syntax options: DROP CACHE row-cache-name Prevents the specified row area from being imported.
3.12 – DROP INDEX index-name
Prevents the specified index from being imported.
3.13 – DROP_STORAGE_AREA
Prevents the specified storage area from being imported.
3.14 – DROP STORAGE MAP map-name
Prevents the specified storage map from being imported.
3.15 – FILENAME file spec
Specifies the file associated with the database. If you omit the FILENAME argument, the file specification takes the following defaults: o Device: the current device for the process o Directory: the current directory for the process o File name: the alias (if you omit the FILENAME argument, you must specify the WITH ALIAS clause) Use either a full file specification or a partial file specification. You can use a logical name for all or part of a file specification. If you use a simple file name, SQL creates the database in the current default directory. Because the IMPORT statement may create more than one file with different file extensions, do not specify a file extension with the file specification.
3.16 – FORWARD_REFERENCES
Syntax options: FORWARD_REFERENCES | NOFORWARD_REFERENCES The EXPORT interchange file contains declarations of all routines that will be referenced by other definitions. The default is to declare the interfaces to those routines prior to creating domains, tables, views, triggers, functions, procedures and modules that may need them. The default is FORWARD_REFERENCES. Use NO FORWARD_REFERENCES to disable these declarations. However, this may result in definition failures during the IMPORT. If you include the FORWARD_REFERENCES option on the IMPORT command line then informational messages will be generated for each declared routine.
3.17 – FROM file spec
Names the interchange .rbr file that the IMPORT statement uses as a source to create a new database.
3.18 – import-root-file-params
Parameters that control the characteristics of the database root file associated with the database, or characteristics stored in the database root file that apply to the entire database. For more information on other "import-root-file-params-1", "import-root-file-params-2", "import-root-file-params-3", and "import-root-file-params-4", see the descriptions of "root- file-params-1", "root-file-params-2", "root-file-params-3", and "root-file-params-4" in the CREATE DATABASE.
3.19 – limit-to-clause
See Select_Expressions in the Oracle Rdb SQL Reference Manual for information about the LIMIT TO clause.
3.20 – literal-user-auth
Specifies the user name and password for access to databases, particularly remote databases. This literal lets you explicitly provide user name and password information in the IMPORT statement.
3.21 – order-by-clause
See Select_Expressions in the Oracle Rdb SQL Reference Manual for information about the ORDER BY clause.
3.22 – PROTECTION_IS
Syntax options: PROTECTION IS ANSI | PROTECTION IS ACLS By default, the IMPORT statement retains the protection style of the database that was exported. However, if you specify PROTECTION IS ANSI or PROTECTION IS ACLS, then the IMPORT statement creates a database with that protection type. If the protection of the database created is different from the protection of the database that was exported, then no protection records are imported and you will receive default protections.
3.23 – select-clause
See Select_Expressions in the Oracle Rdb SQL Reference Manual for information about the SELECT clause.
3.24 – storage-area-params
Specifies parameters that control the characteristics of database storage area files. You can specify most storage area parameters for either single-file or multifile databases, but the effect of the clauses differs. o For single-file databases, the storage area parameters specify the characteristics for the single storage area in the database. o For multifile databases, the storage area parameters specify a set of default values for any storage areas created by the IMPORT statement that do not specify their own values for the same parameters. The attributes of a storage area are supplied by the interchange file unless redefined by the IMPORT statement. The default values apply to the storage area named in CREATE STORAGE AREA database elements. For details about storage area parameters, see the CREATE STORAGE_AREA clause. NOTE The CREATE STORAGE AREA clauses can override these default values. The default values do not apply to any storage areas created later with the ALTER DATABASE statement.
3.25 – TRACE
Syntax options: TRACE | NO TRACE Specifies whether usage statistics are logged by the IMPORT statement. The NO TRACE option is the default. Some actions taken by the IMPORT statement can consume significant amounts of I/O resources and CPU time. These actions include the following operations: o Loading data o Defining indexes o Defining constraints When you specify the TRACE option with the IMPORT statement, SQL writes a message when each operation begins, and writes a summary of DIO (direct input/output operations), CPU, and PAGE FAULT statistics when the operation completes. When the IMPORT statement finishes execution, a summary of all DIO, CPU, and PAGE FAULT statistics is displayed. The display also includes information on access to the .rbr file, database creation, and loading of data. For more information about these statistics, see the Oracle Rdb7 Guide to Database Performance and Tuning.
3.26 – USER username
Syntax option: USER 'username' Defines a character string literal that specifies the operating system user name that the database system uses for privilege checking.
3.27 – USING password
Syntax option: USING 'password' Defines a character string literal that specifies the user's password for the user name specified in the USER clause.
3.28 – WITH ALIAS alias
Specifies the alias for the implicit database attach executed by the IMPORT statement. An alias is a name for a particular attachment to a database. You must specify an alias or a file name. If you omit the WITH ALIAS clause, the default alias for the database created by the IMPORT statement is RDB$DBHANDLE. If you omit the FILENAME argument, the IMPORT statement also uses the alias as the file name for the database root file and creates the root file in the current default directory. If you omit WITH ALIAS, you must specify the FILENAME argument.
4 – Examples
Example 1: Converting to a multifile database This example uses the EXPORT and IMPORT statements to convert the online sample database, personnel, to a multifile database. SQL> export database cont> filename PERSONNEL cont> into PERS; SQL> SQL> import database cont> from PERS cont> filename MF_PERSONNEL cont> default storage area MFP0 cont> create storage area MFP0 cont> filename MFP0_DEFAULT cont> page format is UNIFORM cont> create storage area MFP1 cont> filename MFP1 cont> create storage area MFP2 cont> filename MFP2 cont> create storage map EMPLOYEES_MAP cont> for EMPLOYEES cont> store randomly across (MFP1, MFP2); SQL> SQL> show storage area; Storage Areas in database with filename MF_PERSONNEL MFP0 Default storage area MFP1 MFP2 RDB$SYSTEM List storage area. Note that the storage area RDB$SYSTEM was created implicitly in this example. The database administrator could add a CREATE STORAGE AREA RDB$SYSTEM clause to this IMPORT example so that the name, location and space allocation for the RDB$SYSTEM area can be controlled. Example 2: Importing a database created with ANSI/ISO-style privileges This example imports a database originally created using ACLS style protection to create a new database with ANSI style protections. SQL> import database cont> from PERS cont> alias NEW_PERS cont> filename MF_PERSONNEL cont> protection is ANSI cont> ; SQL> show protection on database NEW_PERS; Protection on Alias NEW_PERS [DEV,SMITH]: With Grant Option: SELECT,INSERT,UPDATE,DELETE,SHOW,CREATE,ALTER,DROP, DBCTRL,OPERATOR,DBADM,SECURITY,DISTRIBTRAN Without Grant Option: NONE [*,*]: With Grant Option: NONE Without Grant Option: NONE SQL> SQL> show protection on table NEW_PERS.EMPLOYEES; Protection on Table NEW_PERS.EMPLOYEES [DEV,SMITH]: With Grant Option: SELECT,INSERT,UPDATE,DELETE,SHOW,CREATE,ALTER,DROP, DBCTRL,REFERENCES Without Grant Option: NONE [*,*]: With Grant Option: NONE Without Grant Option: NONE Example 3: Importing a database and displaying statistics This example imports a database and uses the TRACE option to display DIO, CPU, and PAGE FAULT statistics. SQL> IMPORT DATABASE FROM personnel.rbr cont> FILENAME personnel_new.rdb cont> TRACE cont> CREATE INDEX LOCAL_INDEX ON jobs (job_code); IMPORTing STORAGE AREA: RDB$SYSTEM IMPORTing table COLLEGES Completed COLLEGES. DIO = 103, CPU = 0:00:00.89, FAULTS = 169 Starting INDEX definition COLL_COLLEGE_CODE Completed COLL_COLLEGE_CODE. DIO = 25, CPU = 0:00:00.24, FAULTS = 26 IMPORTing table DEGREES Completed DEGREES. DIO = 96, CPU = 0:00:01.15, FAULTS = 9 Starting INDEX definition DEG_COLLEGE_CODE Completed DEG_COLLEGE_CODE. DIO = 27, CPU = 0:00:00.36, FAULTS = 1 Starting INDEX definition DEG_EMP_ID Completed DEG_EMP_ID. DIO = 39, CPU = 0:00:00.49, FAULTS = 2 IMPORTing table DEPARTMENTS Completed DEPARTMENTS. DIO = 99, CPU = 0:00:00.70, FAULTS = 3 IMPORTing table EMPLOYEES Completed EMPLOYEES. DIO = 182, CPU = 0:00:01.60, FAULTS = 21 . . . Starting CONSTRAINT definition SH_EMPLOYEE_ID_IN_EMP Completed SH_EMPLOYEE_ID_IN_EMP. DIO = 48, CPU = 0:00:00.56, FAULTS = 2 Starting CONSTRAINT definition WS_STATUS_CODE_DOM_NOT_NULL Completed WS_STATUS_CODE_DOM_NOT_NULL. DIO = 36, CPU = 0:00:00.23, FAULTS = 0 Completed import. DIO = 3530, CPU = 0:00:32.97, FAULTS = 2031 SQL> Example 4: Reserving Sequence Slots During an Import Operation SQL> IMPORT DATABASE FROM MF_PERSONNEL.RBR cont> FILENAME 'mf_personnel.rdb' BANNER cont> RESERVE 64 SEQUENCES; . . . Unused Sequences were 32 now are 64 IMPORTing STORAGE AREA: RDB$SYSTEM IMPORTing STORAGE AREA: DEPARTMENTS IMPORTing STORAGE AREA: EMPIDS_LOW Example 5: Specifying the BANNER option SQL> import data from x file mf_personnel BANNER; Exported by Oracle Rdb X7.1-201 Import/Export utility A component of Oracle Rdb SQL X7.1-201 Previous name was mf_personnel It was logically exported on 29-MAY-2003 12:32 Multischema mode is DISABLED Database NUMBER OF USERS is 50 Database NUMBER OF CLUSTER NODES is 16 Database NUMBER OF DBR BUFFERS is 20 Database SNAPSHOT is ENABLED Database SNAPSHOT is IMMEDIATE Database JOURNAL ALLOCATION is 512 Database JOURNAL EXTENSION is 512 Database BUFFER SIZE is 6 blocks Database NUMBER OF BUFFERS is 20 Adjustable Lock Granularity is Enabled Count is 3 Database global buffering is DISABLED Database number of global buffers is 250 Number of global buffers per user is 5 Database global buffer page transfer is via DISK Journal fast commit is DISABLED Journal fast commit checkpoint interval is 0 blocks Journal fast commit checkpoint time is 0 seconds Commit to journal optimization is Disabled Journal fast commit TRANSACTION INTERVAL is 256 LOCK TIMEOUT is 0 seconds Statistics Collection is ENABLED Unused Storage Areas are: 0 System Index Compression is DISABLED Journal was Disabled Unused Journals are: 1 Journal Backup Server was: Manual Journal Log Server was: Manual Journal Overwrite was: Disabled Journal shutdown minutes was 60 Asynchronous Prefetch is ENABLED Async prefetch depth buffers is 5 Asynchronous Batch Write is ENABLED Async batch write clean buffers is 5 Async batch write max buffers is 4 Lock Partitioning is DISABLED Incremental Backup Scan Optim uses SPAM pages Unused Cache Slots are: 1 Workload Collection is DISABLED Cardinality Collection is ENABLED Metadata Changes are ENABLED Row Cache is DISABLED Detected Asynchronous Prefetch is ENABLED Detected Asynchronous Prefetch Depth Buffers is 4 Detected Asynchronous Prefetch Threshold Buffers is 4 Open is Automatic, Wait period is 0 minutes Shared Memory is PROCESS Unused Sequences are: 32 The Transaction Mode(s) Enabled are: ALL IMPORTing STORAGE AREA: RDB$SYSTEM IMPORTing STORAGE AREA: DEPARTMENTS IMPORTing STORAGE AREA: EMPIDS_LOW IMPORTing STORAGE AREA: EMPIDS_MID IMPORTing STORAGE AREA: EMPIDS_OVER IMPORTing STORAGE AREA: EMP_INFO IMPORTing STORAGE AREA: JOBS IMPORTing STORAGE AREA: MF_PERS_SEGSTR IMPORTing STORAGE AREA: SALARY_HISTORY IMPORTing table CANDIDATES IMPORTing table COLLEGES IMPORTing table DEGREES IMPORTing table DEPARTMENTS IMPORTing table EMPLOYEES IMPORTing table JOBS IMPORTing table JOB_HISTORY IMPORTing table RESUMES IMPORTing table SALARY_HISTORY IMPORTing table WORK_STATUS IMPORTing view CURRENT_SALARY IMPORTing view CURRENT_JOB IMPORTing view CURRENT_INFO Example 6: Using the COMMIT EVERY option SQL> import database cont> from 'TEST$DB_SOURCE:MF_PERSONNEL' cont> filename 'MF_PERSONNEL' cont> cont> commit every 10 rows cont> cont> create storage area DEPARTMENTS cont> filename 'DEPARTMENTS' cont> page format is mixed cont> snapshot filename 'DEPARTMENTS' cont> create storage area EMPIDS_LOW cont> filename 'EMPIDS_LOW' cont> page format is mixed cont> snapshot filename 'EMPIDS_LOW' cont> create storage area EMPIDS_MID cont> filename 'EMPIDS_MID' cont> page format is mixed cont> snapshot filename 'EMPIDS_MID' cont> create storage area EMPIDS_OVER cont> filename 'EMPIDS_OVER' cont> page format is mixed cont> snapshot filename 'EMPIDS_OVER' . . . cont> ; ! end of import Definition of STORAGE AREA RDB$SYSTEM overridden Definition of STORAGE AREA MF_PERS_SEGSTR overridden Definition of STORAGE AREA EMPIDS_LOW overridden Definition of STORAGE AREA EMPIDS_MID overridden Definition of STORAGE AREA EMPIDS_OVER overridden Definition of STORAGE AREA DEPARTMENTS overridden Definition of STORAGE AREA SALARY_HISTORY overridden Definition of STORAGE AREA JOBS overridden Definition of STORAGE AREA EMP_INFO overridden COMMIT EVERY ignored for table EMPLOYEES due to PLACEMENT VIA INDEX processing COMMIT EVERY ignored for table JOB_HISTORY due to PLACEMENT VIA INDEX processing SQL>