| General Information |
| Source |
{ORACLE_HOME}/rdbms/admin/dbmsstr.sql |
| First Available |
9.2 |
Constants |
| Name |
Data Type |
Value |
| Instantiation Constants |
| instantiation_none |
BINARY_INTEGER |
0 |
| instantiation_table |
BINARY_INTEGER |
1 |
| instantiation_table_network |
BINARY_INTEGER |
2 |
| instantiation_schema |
BINARY_INTEGER |
3 |
| instantiation_schema_network |
BINARY_INTEGER |
4 |
| instantiation_full |
BINARY_INTEGER |
5 |
| instantiation_full_network |
BINARY_INTEGER |
6 |
| instantiation_tts |
BINARY_INTEGER |
7 |
| instantiation_tts_network |
BINARY_INTEGER |
8 |
| Prepare_Upgrade API Constants |
| exclude_flags_full |
BINARY_INTEGER |
1 |
| exclude_flags_unsupported |
BINARY_INTEGER |
2 |
| exclude_flags_dml |
BINARY_INTEGER |
4 |
| exclude_flags_ddl |
BINARY_INTEGER |
8 |
| Message Tracing Constants |
| action_trace |
BINARY_INTEGER |
1 |
| action_memory |
BINARY_INTEGER |
2 |
|
Definitions |
| Keyword |
Definition |
|
destination
_queue_name |
|
|
tagged_lcr |
Every redo log
entry has an
associated tag. The datatype of the tag is RAW. By
default, when a user or application generates redo entries, the value of
the tag is NULL.
You can configure how tag values are interpreted. A tag
can be used to determine whether an LCR contains a change that
originated in the local database or at a different database, so that
to avoid change cycling (sending an LCR back to the
database where it originated). Tags can be used for other LCR tracking
purposes as well.
For example to specify the set of destination databases
for each
LCR.
Create tags with DBMS_STREAMS.SET_TAG. |
|
Dependencies |
SELECT name
FROM dba_dependencies
WHERE referenced_name = 'DBMS_STREAMS_ADM'
UNION
SELECT referenced_name
FROM dba_dependencies
WHERE name = 'DBMS_STREAMS_ADM'; |
Exceptions |
| Error Code |
Reason |
|
Can not create process |
|
Process exists |
|
Invalid parameter |
|
Client Rule Set does not exist |
|
Dequeue exists |
|
Process does not exist |
|
Role required |
|
Set user to SYS |
|
Mult trans specified |
|
| Security Model |
Execute is granted to the
EXECUTE_CATALOG_ROLE role |
| |
| ADD_COLUMN |
Either adds or removes a declarative rule-based transformation which adds a column to a
row logical change record (row LCR) that satisfies the specified rule
Overload 1 |
dbms_streams_adm.add_column(
rule_name IN VARCHAR2,
table_name IN VARCHAR2,
column_name IN VARCHAR2,
column_function IN VARCHAR2,
value_type IN VARCHAR2 DEFAULT 'NEW',
step_number IN NUMBER DEFAULT 0,
operation IN VARCHAR2 DEFAULT 'ADD'); |
| TBD |
Overload 2 |
dbms_streams_adm.add_column(
rule_name IN VARCHAR2,
table_name IN VARCHAR2,
column_name IN VARCHAR2,
column_value IN SYS.ANYDATA,
value_type IN VARCHAR2 DEFAULT 'NEW',
step_number IN NUMBER DEFAULT 0,
operation IN VARCHAR2 DEFAULT 'ADD');
|
| TBD |
| |
| ADD_GLOBAL_PROPAGATION_RULES |
Either adds global rules to the positive rule set for a propagation, or adds global rules to the
negative rule set for a propagation, and creates the specified propagation if it does not exist
Overload 1 |
dbms_streams_adm.add_global_propagation_rules(
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_global_propagation_rules(
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
dml_rule_name OUT VARCHAR2,
ddl_rule_name OUT VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| See Streams Demo 1 |
| |
| ADD_GLOBAL_RULES |
Adds rules to a RULE SET of one
a Streams clients
Overload 1 |
dbms_streams_adm.add_global_rules(
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT null,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_global_rules(
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
dml_rule_name OUT VARCHAR2,
ddl_rule_name OUT VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL); |
| TBD |
| |
| ADD_MESSAGE_PROPAGATION_RULE |
Adds a message rule to the positive RULE SET for a
propagation, or adds a message rule to the negative RULE SET for a propagation, and creates the specified
propagation if it does not exist
Overload 1 |
dbms_streams_adm.add_message_propagation_rule (
message_type IN VARCHAR2,
rule_condition IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_message_propagation_rule (
message_type IN
VARCHAR2,
rule_condition IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
rule_name
OUT VARCHAR2,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
| |
| ADD_MESSAGE_RULE |
Adds a message rule to a RULE
SET of
a Streams clients
Overload 1 |
dbms_streams_adm.add_message_rule (
message_type IN VARCHAR2,
rule_condition IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
inclusion_rule IN BOOLEAN DEFAULT TRUE); |
| TBD |
Overload 2 |
dbms_streams_adm.add_message_rule (
message_type IN VARCHAR2,
rule_condition IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
inclusion_rule IN BOOLEAN DEFAULT TRUE,
rule_name OUT VARCHAR2); |
| TBD |
| |
| ADD_SCHEMA_PROPAGATION_RULES |
Either adds schema rules to the positive rule set for a propagation, or adds schema rules to the negative
RULE SET for a propagation, and creates the specified propagation if it does not
exist
Overload 1 |
dbms_streams_adm.add_message_propagation_rules(
message_type IN VARCHAR2,
rule_condition IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_message_propagation_rules(
message_type IN VARCHAR2,
rule_condition IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
rule_name OUT VARCHAR2,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
| |
| ADD_SCHEMA_RULES |
Adds rules to a rule set of one of
a Streams clients
Overload 1 |
dbms_streams_adm.add_schema_rules(
schema_name IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_schema_rules(
schema_name IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
dml_rule_name OUT VARCHAR2,
ddl_rule_name OUT VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL); |
| See Streams Demo 1 |
| |
| ADD_SUBSET_PROPAGATION_RULES |
Adds
propagation rules that propagate the logical change records
(LCRs) related to a subset of the rows in the specified table in a
source queue to a destination queue, and creates the specified
propagation if it does not
exist
Overload 1 |
dbms_streams_adm.add_subset_propagation_rules(
table_name IN VARCHAR2,
dml_condition IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_subset_propagation_rules(
table_name IN
VARCHAR2,
dml_condition IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
insert_rule_name OUT VARCHAR2,
update_rule_name OUT VARCHAR2,
delete_rule_name OUT VARCHAR2,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
| |
| ADD_SUBSET_RULES |
Adds rules to a rule set of a Streams clients
Overload 1 |
dbms_streams_adm.add_subset_rules(
table_name IN VARCHAR2,
dml_condition IN VARCHAR2,
streams_type IN VARCHAR2 DEFAULT 'APPLY',
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL); |
| TBD |
| Overload 2 |
dbms_streams_adm.add_subset_rules(
table_name IN VARCHAR2,
dml_condition IN VARCHAR2,
streams_type IN VARCHAR2 DEFAULT 'APPLY',
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
insert_rule_name OUT VARCHAR2,
update_rule_name OUT VARCHAR2,
delete_rule_name OUT VARCHAR2); |
| TBD |
| |
| ADD_TABLE_PROPAGATION_RULES |
Adds table
rules to the positive rule set for a propagation, or adds table rules to
the negative rule set for a propagation, and creates the specified
propagation if it does not
exist
Overload 1 |
dbms_streams_adm.add_table_propagation_rules(
table_name IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_table_propagation_rules(
table_name IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
source_queue_name IN VARCHAR2,
destination_queue_name IN VARCHAR2,
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
dml_rule_name OUT VARCHAR2,
ddl_rule_name OUT VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL,
queue_to_queue IN BOOLEAN DEFAULT NULL); |
| TBD |
| |
| ADD_TABLE_RULES |
Adds rules to a rule set of
a Streams clients
Overload 1 |
dbms_streams_adm.add_table_rules(
table_name IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL); |
| TBD |
Overload 2 |
dbms_streams_adm.add_table_rules(
table_name IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
include_dml IN BOOLEAN DEFAULT TRUE,
include_ddl IN BOOLEAN DEFAULT FALSE,
include_tagged_lcr IN BOOLEAN DEFAULT FALSE,
source_database IN VARCHAR2 DEFAULT NULL,
dml_rule_name OUT VARCHAR2,
ddl_rule_name OUT VARCHAR2,
inclusion_rule IN BOOLEAN DEFAULT TRUE,
and_condition IN VARCHAR2 DEFAULT NULL); |
DECLARE
dml_rule VARCHAR2(50);
ddl_rule VARCHAR2(50);
BEGIN
dbms_streams_adm.add_table_rules(
table_name => ''SCOTT.EMP'',
streams_type => 'CAPTURE',
streams_name => 'SCOTT_CAPTURE',
queue_name => 'SCOTT_CAPTURE_Q',
dml_rule_name => dml_rule,
ddl_rule_name => ddl_rule,
and_condition => ':lcr.get_command_type() != ''DELETE''');
dbms_output.put_line(v_dml_rule);
dbms_output.put_line(v_ddl_rule);
END;
/ |
| |
| CLEANUP_INSTANTIATION_SETUP |
Removes a Streams replication configuration set up by the
PRE_INSTANTIATION_SETUP and POST_INSTANTIATION_SETUP |
dbms_streams_adm.cleanup_instantiation_setup(
maintain_mode IN VARCHAR2,
tablespace_names IN dbms_streams_tablespace_adm.tablespace_set,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
capture_name IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name IN VARCHAR2 DEFAULT NULL,
apply_name IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name IN VARCHAR2 DEFAULT NULL,
apply_queue_user IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN DEFAULT FALSE,
change_global_name IN BOOLEAN DEFAULT FALSE); |
| TBD |
| |
| DELETE_COLUMN |
Either adds or removes a declarative rule-based transformation
which deletes a column from a row logical change record (LCR) that
satisfies the specified
rule |
dbms_streams_adm.delete_column(
rule_name IN VARCHAR2,
table_name IN VARCHAR2,
column_name IN VARCHAR2,
value_type IN VARCHAR2 DEFAULT '*',
step_number IN NUMBER DEFAULT 0,
operation IN VARCHAR2 DEFAULT 'ADD'); |
DECLARE
v_dml_rule VARCHAR2(50);
BEGIN
dbms_streams_adm.delete_column(
rule_name => v_dml_rule,
table_name => 'EMP',
column_name => 'SAL',
value_type => '*',
step_number => 0,
operation => 'ADD');
dbms_output.put_line(v_dml_rule);
END;
/ |
| |
| GET_MESSAGE_TRACKING
(new in 11g) |
Undocumented |
dbms_streams_adm.get_message_tracking
RETURN VARCHAR2; |
| See
SET_MESSAGE_TRACKING Demo |
| |
| GET_SCN_MAPPING |
For point in time recovery, given the SCN at the source, returns
the instantiation SCN and start SCN from the destination |
dbms_streams_adm.get_scn_mapping(
apply_name IN
VARCHAR2,
src_pit_scn IN
NUMBER,
dest_instantiation_scn OUT NUMBER,
dest_start_scn OUT NUMBER,
dest_skip_txn_ids OUT dbms_utility.name_array); |
| TBD |
| |
| MAINTAIN_GLOBAL |
Configures a Streams environment that replicates changes at the database level between two databases |
dbms_streams_adm.maintain_global(
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
dump_file_name IN VARCHAR2 DEFAULT NULL,
capture_name IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name IN VARCHAR2 DEFAULT NULL,
apply_name IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name IN VARCHAR2 DEFAULT NULL,
apply_queue_user IN VARCHAR2 DEFAULT NULL,
log_file IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN DEFAULT FALSE,
include_ddl IN BOOLEAN DEFAULT FALSE,
instantiation IN BINARY_INTEGER DEFAULT
dbms_streams_adm.instantiation_full); |
| TBD |
| |
| MAINTAIN_SCHEMAS |
Configures a Streams environment that replicates changes to specified schemas between two databases
Overload 1 |
dbms_streams_adm.maintain_schemas(
schema_names IN
dbms_utility.uncl_array,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
dump_file_name IN VARCHAR2 DEFAULT NULL,
capture_name IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name IN VARCHAR2 DEFAULT NULL,
apply_name IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name IN VARCHAR2 DEFAULT NULL,
apply_queue_user IN VARCHAR2 DEFAULT NULL,
log_file IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN DEFAULT FALSE,
include_ddl IN BOOLEAN DEFAULT FALSE,
instantiation IN BINARY_INTEGER DEFAULT
dbms_streams_adm.instantiation_schema); |
| TBD |
Overload 2 |
dbms_streams_adm.maintain_schemas(
schema_names IN
VARCHAR2,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
dump_file_name IN VARCHAR2 DEFAULT NULL,
capture_name IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name IN VARCHAR2 DEFAULT NULL,
apply_name IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name IN VARCHAR2 DEFAULT NULL,
apply_queue_user IN VARCHAR2 DEFAULT NULL,
log_file IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN DEFAULT FALSE,
include_ddl IN BOOLEAN DEFAULT FALSE,
instantiation IN BINARY_INTEGER DEFAULT
dbms_streams_adm.instantiation_schema); |
| TBD |
| |
| MAINTAIN_SIMPLE_TABLESPACE |
| Clones a
simple tablespace from a source database at a destination database and
uses Streams to maintain this tablespace at both databases |
dbms_streams_adm.maintain_simple_tablespace(
tablespace_name IN VARCHAR2,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
destination_database IN VARCHAR2,
setup_streams IN BOOLEAN DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN DEFAULT FALSE); |
| TBD |
| |
| MAINTAIN_SIMPLE_TTS |
| Clones a
simple tablespace from a source database at a destination database and
uses Streams to maintain this tablespace at both databases. This
procedure can either perform these actions directly, or it can generate a
script that performs these
actions |
dbms_streams_adm.maintain_simple_tts(
tablespace_name IN VARCHAR2,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN DEFAULT FALSE); |
| TBD |
| |
| MAINTAIN_TABLES |
Configures a Streams environment that replicates changes to
specified tables between two databases. This procedure can either
configure the environment directly, or it can generate a script that
configures the environment.
Overload 1 |
dbms_streams_adm.maintain_tables(
table_names IN VARCHAR2,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
dump_file_name IN VARCHAR2 DEFAULT NULL,
capture_name IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name IN VARCHAR2 DEFAULT NULL,
apply_name IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name IN VARCHAR2 DEFAULT NULL,
apply_queue_user IN VARCHAR2 DEFAULT NULL,
log_file IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN
DEFAULT FALSE,
include_ddl IN BOOLEAN
DEFAULT FALSE,
instantiation IN BINARY_INTEGER DEFAULT
dbms_streams_adm.instantiation_table); |
| TBD |
Overload 2 |
dbms_streams_adm.maintain_tables(
table_names
IN dbms_utility.uncl_array,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
source_database
IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions
IN BOOLEAN DEFAULT TRUE,
script_name
IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
dump_file_name
IN VARCHAR2 DEFAULT NULL,
capture_name
IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name
IN VARCHAR2 DEFAULT NULL,
apply_name
IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name
IN VARCHAR2 DEFAULT NULL,
apply_queue_user
IN VARCHAR2 DEFAULT NULL,
log_file
IN VARCHAR2 DEFAULT NULL,
bi_directional
IN BOOLEAN DEFAULT FALSE,
include_ddl
IN BOOLEAN DEFAULT FALSE,
instantiation
IN BINARY_INTEGER DEFAULT
dbms_streams_adm.instantiation_table); |
| TBD |
| |
| MAINTAIN_TABLESPACES |
Clones a set of tablespaces from a source database at a
destination database and uses Streams to maintain these tablespaces at
both databases |
dbms_streams_adm.maintain_tablespaces(
tablespace_names IN dbms_streams_tablespace_adm.tablespace_set,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
destination_database IN VARCHAR2,
setup_streams
IN BOOLEAN DEFAULT TRUE,
script_name
IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
dump_file_name
IN VARCHAR2 DEFAULT NULL,
source_queue_table
IN VARCHAR2 DEFAULT 'streams_queue_table',
source_queue_name
IN VARCHAR2 DEFAULT 'streams_queue',
source_queue_user IN VARCHAR2 DEFAULT NULL,
destination_queue_table IN VARCHAR2 DEFAULT 'streams_queue_table',
destination_queue_name IN VARCHAR2 DEFAULT 'streams_queue',
destination_queue_user IN VARCHAR2 DEFAULT NULL,
capture_name
IN VARCHAR2 DEFAULT 'capture',
propagation_name
IN VARCHAR2 DEFAULT NULL,
apply_name
IN VARCHAR2 DEFAULT NULL,
log_file
IN VARCHAR2 DEFAULT NULL,
bi_directional
IN BOOLEAN DEFAULT FALSE,
include_ddl
IN BOOLEAN DEFAULT FALSE); |
| TBD |
| |
| MAINTAIN_TTS |
Clones a set of tablespaces from a source database at a
destination database and uses Streams to maintain these tablespaces at
both databases |
dbms_streams_adm.maintain_tts(
tablespace_names IN dbms_streams_tablespace_adm.tablespace_set,
source_directory_object IN VARCHAR2,
destination_directory_object IN VARCHAR2,
source_database
IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions
IN BOOLEAN DEFAULT TRUE,
script_name
IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
dump_file_name
IN VARCHAR2 DEFAULT NULL,
capture_name
IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name
IN VARCHAR2 DEFAULT NULL,
apply_name
IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name
IN VARCHAR2 DEFAULT NULL,
apply_queue_user
IN VARCHAR2 DEFAULT NULL,
log_file
IN VARCHAR2 DEFAULT NULL,
bi_directional
IN BOOLEAN DEFAULT FALSE,
include_ddl
IN BOOLEAN DEFAULT FALSE); |
| TBD |
| |
| MERGE_STREAMS (new in
11g) |
Undocumented |
dbms_streams_adm.merge_streams(
cloned_propagation_name IN VARCHAR2,
propagation_name IN VARCHAR2,
queue_name IN
VARCHAR2 DEFAULT NULL,
perform_actions IN BOOLEAN DEFAULT TRUE,
script_name IN
VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL); |
| TBD |
| |
| MERGE_STREAMS_JOB (new
in 11g) |
Undocumented |
dbms_streams_adm.merge_streams_job(
capture_name IN VARCHAR2,
cloned_capture_name IN VARCHAR2,
merge_threshold IN NUMBER,
schedule_name IN VARCHAR2 DEFAULT NULL,
merge_job_name IN VARCHAR2 DEFAULT NULL); |
| TBD |
| |
| POST_INSTANTIATION_SETUP |
Performs the actions required after instantiation to configure a Streams replication environment |
dbms_streams_adm.post_instantiation_setup(
maintain_mode IN VARCHAR2,
tablespace_names IN dbms_streams_tablespace_adm.tablespace_set,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN
DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
capture_name IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name IN VARCHAR2 DEFAULT NULL,
apply_name
IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name IN VARCHAR2 DEFAULT NULL,
apply_queue_user IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN
DEFAULT FALSE,
include_ddl IN BOOLEAN
DEFAULT FALSE,
start_processes IN BOOLEAN
DEFAULT FALSE,
instantiation_scn IN NUMBER DEFAULT NULL,
exclude_schemas IN VARCHAR2 DEFAULT NULL,
exclude_flags IN BINARY_INTEGER DEFAULT NULL); |
| TBD |
| |
| PRE_INSTANTIATION_SETUP |
Performs the actions required before instantiation to configure a Streams replication environment. |
dbms_streams_adm.pre_instantiation_setup(
maintain_mode IN VARCHAR2,
tablespace_names IN dbms_streams_tablespace_adm.tablespace_set,
source_database IN VARCHAR2,
destination_database IN VARCHAR2,
perform_actions IN BOOLEAN
DEFAULT TRUE,
script_name IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
capture_name IN VARCHAR2 DEFAULT NULL,
capture_queue_table IN VARCHAR2 DEFAULT NULL,
capture_queue_name IN VARCHAR2 DEFAULT NULL,
capture_queue_user IN VARCHAR2 DEFAULT NULL,
propagation_name IN VARCHAR2 DEFAULT NULL,
apply_name
IN VARCHAR2 DEFAULT NULL,
apply_queue_table IN VARCHAR2 DEFAULT NULL,
apply_queue_name IN VARCHAR2 DEFAULT NULL,
apply_queue_user IN VARCHAR2 DEFAULT NULL,
bi_directional IN BOOLEAN
DEFAULT FALSE,
include_ddl IN BOOLEAN
DEFAULT FALSE,
start_processes IN BOOLEAN
DEFAULT FALSE,
exclude_schemas IN VARCHAR2 DEFAULT NULL,
exclude_flags IN BINARY_INTEGER DEFAULT NULL); |
| TBD |
| |
| PURGE_SOURCE_CATALOG |
| Removes all Streams data dictionary information at the local database for the specified object |
dbms_streams_adm.purge_source_catalog(
source_database IN VARCHAR2,
source_object_name IN VARCHAR2,
source_object_type IN VARCHAR2); |
| exec
dbms_streams_adm.purge_source_catalog('UKOUG', 'HR.CDC_DEMO', 'TABLE'); |
| |
| RECOVER_OPERATION |
| Provides options for a Streams replication configuration operation that stopped because it encountered an
error either the operation forward or backward, or purges all of the metadata about the operation |
dbms_streams_adm.recover_operation(
script_id IN RAW,
operation_mode IN VARCHAR2 DEFAULT 'FORWARD'); |
| TBD |
| |
| REMOVE_QUEUE |
Removes a queue from use in Streams. Specifically, the queue will be
stopped, and no further enqueue or dequeues will be allowed on the queue. |
dbms_streams_adm.remove_queue(
queue_name
IN VARCHAR2,
cascade
IN BOOLEAN DEFAULT FALSE,
drop_unused_queue_table IN BOOLEAN DEFAULT TRUE); |
desc user_queues
SELECT name, queue_table
FROM user_queues;
exec dbms_streams_adm.remove_queue('myafsc_envoy_q', TRUE, TRUE); |
| |
| REMOVE_RULE |
| Removes the
specified rule or all rules from the rule set associated with the
specified capture process, apply process, propagation, or messaging
client |
dbms_streams_adm.remove_rule(
rule_name IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2,
drop_unused_rule IN BOOLEAN DEFAULT TRUE,
inclusion_rule IN BOOLEAN DEFAULT TRUE); |
| TBD |
| |
| REMOVE_STREAMS_CONFIGURATION |
Removes the local Streams configuration
|
dbms_streams_adm.remove_streams_configuration; |
--
the following provided by Michael M. Brennan from RSA Security who
-- reports that REMOVE_STREAMS_CONFIGURATION does not work unless the
-- propagation has been dropped first.
SELECT propagation_name FROM dba_propagation;
exec dbms_propagation_adm.drop_propagation('PROPAGATION$_143');
exec dbms_streams_adm.remove_streams_configuration; |
| |
| RENAME_COLUMN |
Either adds or removes a declarative rule-based transformation
which renames a column in a row logical change record (LCR) that
satisfies the specified
rule |
dbms_streams_adm.rename_column(
rule_name IN VARCHAR2,
table_name IN VARCHAR2,
from_column_name IN VARCHAR2,
to_column_name IN VARCHAR2,
value_type IN VARCHAR2 DEFAULT '*',
step_number IN NUMBER DEFAULT 0,
operation IN VARCHAR2 DEFAULT 'ADD'); |
| TBD |
| |
| RENAME_SCHEMA |
Either adds or removes a declarative rule-based transformation
which renames a schema in a row logical change record (LCR) that
satisfies the specified
rule |
dbms_streams_adm.rename_schema(
rule_name IN VARCHAR2,
from_schema_name IN VARCHAR2,
to_schema_name IN VARCHAR2,
step_number IN NUMBER DEFAULT 0,
operation IN VARCHAR2 DEFAULT 'ADD'); |
DECLARE
v_dml_rule VARCHAR2(50);
BEGIN
dbms_streams_adm.rename_schema(
rule_name => v_dml_rule,
from_schema_name => 'ENGINE',
to_schema_name => 'ENGINE_WEST',
step_number => 0,
operation => 'ADD');
dbms_output.put_line(v_dml_rule);
END;
/ |
| |
| RENAME_TABLE |
| Either adds
or removes a declarative rule-based transformation which renames a table
in a row logical change record (row LCR) that satisfies the specified
rule |
dbms_streams_adm.rename_table(
rule_name IN VARCHAR2,
from_table_name IN VARCHAR2,
to_table_name IN VARCHAR2,
step_number IN NUMBER DEFAULT 0,
operation IN VARCHAR2 DEFAULT 'ADD'); |
| TBD |
| |
| REMOVE_RULE |
| Removes the specified rule or removes all rules from the rule set
associated with the specified capture process, apply process, propagation or message consumer rule set. |
dbms_streams_adm.remove_rule(
rule_name IN VARCHAR2,
streams_type IN VARCHAR2,
streams_name IN VARCHAR2,
drop_unused_rule IN BOOLEAN DEFAULT TRUE,
inclusion_rule IN BOOLEAN DEFAULT TRUE); |
| TBD |
| |
| SET_MESSAGE_NOTIFICATION |
| Sets a notification for messages that can be dequeued by a specified Streams messaging client from a specified queue |
dbms_streams_adm.set_message_notification(
streams_name IN VARCHAR2,
notification_action IN VARCHAR2,
notification_type IN VARCHAR2 DEFAULT 'PROCEDURE',
notification_context IN SYS.ANYDATA DEFAULT NULL,
include_notification IN BOOLEAN DEFAULT TRUE,
queue_name IN VARCHAR2 DEFAULT 'streams_queue'); |
| TBD |
| |
| SET_MESSAGE_TRACKING
(new in 11g) |
Undocumented |
dbms_streams_adm.set_message_tracking(
tracking_label IN VARCHAR2 DEFAULT 'Streams_tracking',
actions IN NUMBER DEFAULT action_memory); |
set serveroutput on
DECLARE
str VARCHAR2(100);
BEGIN
dbms_streams_adm.set_message_tracking;
str := dbms_streams_adm.get_message_tracking;
dbms_output.put_line(str);
END;
/ |
| |
| SET_RULE_TRANSFORM_FUNCTION |
|
Sets or removes the transformation function name for a custom rule-based transformation |
dbms_streams_adm.set_rule_transform_function(
rule_name IN VARCHAR2,
transform_function IN VARCHAR2); |
| TBD |
| |
| SET_UP_QUEUE |
Sets up a queue table and a queue for use with the capture,
propagate, and apply functionality of Streams. The queue functions as a Streams queue. |
dbms_streams_adm.set_up_queue(
queue_table IN VARCHAR2 DEFAULT 'streams_queue_table',
storage_clause IN VARCHAR2 DEFAULT NULL,
queue_name IN VARCHAR2 DEFAULT 'streams_queue',
queue_user IN VARCHAR2 DEFAULT NULL,
comment IN VARCHAR2 DEFAULT NULL); |
| See Streams Demo 1 |
| |
| SPLIT_STREAMS (new in
11g) |
Undocumented |
dbms_streams_adm.split_streams(
propagation_name IN
VARCHAR2,
cloned_propagation_name IN VARCHAR2 DEFAULT NULL,
cloned_queue_name IN
VARCHAR2 DEFAULT NULL,
cloned_capture_name IN VARCHAR2 DEFAULT NULL,
perform_actions IN
BOOLEAN DEFAULT TRUE,
script_name
IN VARCHAR2 DEFAULT NULL,
script_directory_object IN VARCHAR2 DEFAULT NULL,
auto_merge_threshold IN NUMBER
DEFAULT NULL,
schedule_name IN OUT VARCHAR2,
merge_job_name IN OUT VARCHAR2); |
| TBD |
|
