Oracle7 Server Distributed Systems Volume II: Replicated Data

DBMS_RECTIFIER_DIFF.RECTIFY

Purpose

To resolve the differences between two tables. For additional information, refer to

Syntax

The parameters for the RECTIFY procedure are described in Table 12 - 54, and the exceptions are listed in Table 12 - 55. The syntax for this procedure is shown below.

DBMS_RECTIFIER_DIFF.RECTIFY(
            sname1               IN  VARCHAR2,
            oname1               IN  VARCHAR2,
            reference_site       IN  VARCHAR2 := '',
            sname2               IN  VARCHAR2,
            oname2               IN  VARCHAR2,
            comparison_site      IN  VARCHAR2 := '',
            column_list          IN  VARCHAR2 := '', |
            array_columns        IN  dbms_utility.name_array
            missing_rows_sname   IN  VARCHAR2,
            missing_rows_oname1  IN  VARCHAR2,
            missing_rows_oname2  IN  VARCHAR2,
            missing_rows_site    IN  VARCHAR2 := '',
            commit_rows          IN  INTEGER := 500)

Parameter Description
sname1 The name of the schema at REFERENCE_SITE.
oname1 The name of the table at REFERENCE_SITE.
reference_site The name of the reference database site. The default, NULL, indicates the current site.
sname2 The name of the schema at COMPARISON_SITE.
oname2 The name of the table at COMPARISON_SITE.
comparison_site The name of the comparison database site. The default, NULL, indicates the current site.
column_list A comma-separated list of one or more column names being compared for the two tables. You must not have any white space before or after the comma. The default, NULL, indicates that all columns be compared.
array_columns A PL/SQL table of column names being compared for the two tables. Indexing begins at 1, and the final element of the array must be NULL. If position 1 is NULL, all columns are used.
missing_rows_sname The name of the schema in which the missing rows tables are located.
missing_rows_oname1 The name of the table at MISSING_ROWS_SITE that stores information about the rows in the table at REFERENCE site missing from the table at COMPARISON site and the rows at COMPARISON site missing from the table at REFERENCE site.
missing_rows_oname2 The name of the table at MISSING_ROWS_SITE that stores about the missing rows. This table has three columns: the rowid of the row in the MISSING_ROWS_ONAME1 table, the name of the site at which the row is present, and the name of the site from which the row is absent.
missing_rows_site The name of the site where the MISSING_ROWS_ONAME1 and MISSING_ROWS_ONAME2 tables are located. The default, NULL, indicates that the tables are located at the current site.
commit_rows The maximum number of rows to insert to or delete from the reference or comparison table before a COMMIT occurs. By default, a COMMIT occurs after 500 inserts or 500 deletes. An empty string ('') or NULL indicates that a COMMIT should only be issued after all rows for a single table have been inserted or deleted.

Table 12 - 54. Parameters for DBMS_RECTIFIER_DIFF.RECTIFY

Exception Description
23365 nosuchsite Database site could not be found.
23366 badnumber COMMIT_ROWS parameter less than 1.
23368 badname NULL or empty string for table or schema name.
commfailure Remote site is inaccessible.
missingobject Table does not exist.

Table 12 - 55. Exceptions for DBMS_RECTIFIER_DIFF.RECTIFY

Parameter	Description
`sname1`	The name of the schema at REFERENCE_SITE.
`oname1`	The name of the table at REFERENCE_SITE.
`reference_site`	The name of the reference database site. The default, NULL, indicates the current site.
`sname2`	The name of the schema at COMPARISON_SITE.
`oname2`	The name of the table at COMPARISON_SITE.
`comparison_site`	The name of the comparison database site. The default, NULL, indicates the current site.
`column_list`	A comma-separated list of one or more column names being compared for the two tables. You must not have any white space before or after the comma. The default, NULL, indicates that all columns be compared.
`array_columns`	A PL/SQL table of column names being compared for the two tables. Indexing begins at 1, and the final element of the array must be NULL. If position 1 is NULL, all columns are used.
`missing_rows_sname`	The name of the schema in which the missing rows tables are located.
`missing_rows_oname1`	The name of the table at MISSING_ROWS_SITE that stores information about the rows in the table at REFERENCE site missing from the table at COMPARISON site and the rows at COMPARISON site missing from the table at REFERENCE site.
`missing_rows_oname2`	The name of the table at MISSING_ROWS_SITE that stores about the missing rows. This table has three columns: the rowid of the row in the MISSING_ROWS_ONAME1 table, the name of the site at which the row is present, and the name of the site from which the row is absent.
`missing_rows_site`	The name of the site where the MISSING_ROWS_ONAME1 and MISSING_ROWS_ONAME2 tables are located. The default, NULL, indicates that the tables are located at the current site.
`commit_rows`	The maximum number of rows to insert to or delete from the reference or comparison table before a COMMIT occurs. By default, a COMMIT occurs after 500 inserts or 500 deletes. An empty string ('') or NULL indicates that a COMMIT should only be issued after all rows for a single table have been inserted or deleted.

Exception	Description
23365 nosuchsite	Database site could not be found.
23366 badnumber	COMMIT_ROWS parameter less than 1.
23368 badname	NULL or empty string for table or schema name.
commfailure	Remote site is inaccessible.
missingobject	Table does not exist.