[Appendix C] C.13 DBMS_SNAPSHOT

C.13 DBMS_SNAPSHOT

The DBMS_SNAPSHOT package provides a programmatic interface through which you can manage snapshots and purge snapshot logs. For detailed information about snapshots (read-only copies of tables), see Chapter 16 in the Oracle7 Server Administrator Guide .

C.13.1 The DROP_SNAPSHOT procedure

This procedures drops the specified snapshot. The specification is:

PROCEDURE DBMS_SNAPSHOT.DROP_SNAPSHOT    (mowner VARCHAR2,     master VARCHAR2,     snapshot DATE);

C.13.2 The GET_LOG_AGE procedure

This procedures gets the oldest date entry in the log. The specification is:

PROCEDURE DBMS_SNAPSHOT.GET_LOG_AGE    (oldest IN OUT date,     mow VARCHAR2,     mas VARCHAR2);

C.13.3 The PURGE_LOG procedure

This procedure purges the specified log of any unnecessary rows. The specifications are:

PROCEDURE DBMS_SNAPSHOT.PURGE_LOG    (master VARCHAR2,     num NUMBER);  PROCEDURE DBMS_SNAPSHOT.PURGE_LOG    (master VARCHAR2,     num NUMBER,     flag VARCHAR2);

C.13.4 The REFRESH procedure

This procedure causes a manual refresh of the snapshot. The procedure is overloaded so that you can specify an optional refresh option. The specifications are:

PROCEDURE DBMS_SNAPSHOT.REFRESH (snapshot VARCHAR2);  PROCEDURE DBMS_SNAPSHOT.REFRESH    (snapshot VARCHAR2,     op VARCHAR2);

C.13.5 The REFRESH_ALL procedure

This procedure causes a refresh of all snapshots waiting to be refreshed automatically. The specification is:

PROCEDURE DBMS_SNAPSHOT.REFRESH_ALL;

C.13.6 The SET_UP procedure

This procedure prepares the specified master site to refresh a snapshot. The specification is:

PROCEDURE DBMS_SNAPSHOT.SET_UP    (mowner VARCHAR2,     master VARCHAR2, 	    log IN OUT VARCHAR2,     snapshot IN OUT date,     snaptime IN OUT date);

C.13.7 The WRAP_UP procedure

The WRAP_UP procedure records a refresh at the master site. The specification is:

PROCEDURE DBMS_SNAPSHOT.WRAP_UP    (mowner VARCHAR2,     master VARCHAR2,     sshot DATE,     stime DATE);


C.12 DBMS_SESSION		C.14 DBMS_SQL