ALTER RECVPATH
Mit ALTER RECVPATH können Sie die Attribute eines von dem Ziel initiierten Verteilungspfads im Empfangsservice ändern.
Syntax
ALTER RECVPATH path-name
| ( BEGIN ( NOW
| | SEQNO trail-sequence-number RBA relative-byte-address
| | begin-datetime )
| | SOURCE ( URI source-uri
| | PROXY URI proxy-uri )
| | TARGET ( FORMAT ( CANONICAL | TEXT | SQL | XML )
| | SIZEMB megabytes-number
| | SEQLEN sequence-length
| TYPE ( SOCKS | HTTP )
| [ CSALIAS credential-store-alias
| [ CSDOMAIN credential-store-domain ] ]
| | ENCRYPTIONPROFILE encryptionprofile_name
| | COMPRESSION ( ON | OFF | THRESHOLD compression-threshold ) )
| | RULE ( PASSTHRU
| | FILTER [ CHUNKIDS chunk-ids ]
| [ OBJECTNAMES object-names-wildcard ]
| [ OBJECTTYPES [ DML ] [ DDL ] [ PROCEDURE ] ]
| [ TAGS binary-tags ]
| [ PROCEDUREFEATURENAMES feature-names-wildcard ]
| [ COLUMNVALUES column-values ]
| [ PARTITIONNAMES partition-names-wildcard ] )
| [ RELATION ( AND | OR ) ]
| [ ACTION ( INCLUDE | EXCLUDE ) ]
| | OPTIONS [ AUTORESTART RETRIES retries [ DELAY delay ] ]
| [ CRITICAL ( YES | NO ) ]
| [ EOFDELAY eofdelay ]
| | AUTHENTICATION ( OAUTH
| ( CERTIFICATE certificate-name )
| ( USERIDALIAS alias [DOMAIN domain
| (ENCRYPTIONPROFILE encryption-profile-name] ) ) )path_name
Der Name des Verteilungspfads, den Sie ändern möchten.
BEGIN {NOW |
SEQNO sequence_number RBA relative_byte_address |
begin_datetime} |
Gibt einen Zeitstempel in der Datenquelle an, bei dem die Verarbeitung beginnen soll.
NOW
Gibt die Zeit an, zu der der Befehl ADD EXTRACT ausgegeben wird.
sequence_number relative_byte_address
Die Sequenznummer eines Oracle-Redo-Logs und die RBA in diesem Log, bei der mit der Datenerfassung begonnen werden soll.
begin_datetime
Datum und Uhrzeit (Zeitstempel) im angegebenen Format. Bei einem Extract im integrierten Modus muss der Zeitstempelwert größer als der Zeitstempel sein, zu dem der Extract bei der Datenbank registriert wurde.
SOURCE URI source_uri
Gibt die Quell-URI nach dem Quellschlüsselwort an, um den Ort anzugeben, von dem die Daten stammen. Das Format dieser URI enthält das Protokoll (unterstützt nur "trail"), den Hostnamen, die Portnummer des Empfangsservice und den Speicherort der Quelltraildateien.
PROXY URI proxy_uri
Gibt die Proxy-URI nach dem Proxyschlüsselwort an, um den Ort anzugeben, von dem die Daten stammen. Das Format dieser URI enthält das Protokoll (unterstützt nur "trail"), den Hostnamen, die Portnummer des Empfangsservice und den Speicherort der Quelltraildateien.
TARGET
Mindestens eine TARGET-Option muss angegeben werden. Diese wird als vollständiges Objekt behandelt. Wenn Sie eine komplizierte Angabe machen müssen, verwenden Sie die REST-API. Admin Client unterstützt nur begrenzte Zieleinstellungen und führt keine Zieleinstellung mit dem vorherigen Aufruf zusammen.
CANONICAL
Definiert eine Einzelbytereihenfolge, eine Darstellung von Daten als einzelne Gleitkommazahl.
TEXT
Textdaten.
SQL
Gültige SQL-Anweisungen.
XML
XML-formatierte Daten.
FORMAT
Gibt das Format der URI des Zielverteilungspfads an.
SIZEMB megabytes_number
Legt die Größe des Verteilungspfads in Megabyte fest.
SEQLEN sequence_length
Legt die Sequenzlänge des Verteilungspfads fest.
TYPE
Legt den Proxytyp für den Verteilungspfad fest: HTTP oder SOCKS.
CSALIAS credential_store_alias
Gibt den Aliasnamen des Zugangsdatenspeichers an.
CSALIAS credential_store_domain
Gibt den Domainnamen des Zugangsdatenspeichers an.
AUTHENTICATION OAUTH
Verwenden Sie diese Option, wenn Sie das Autorisierungsprofil eines externen Identitätsproviders (IDCS) verwenden. Dadurch wird der Fluss vom Verteilungsservice zum Empfangsservice eingerichtet.
Hinweis: Wenn Ihr Deployment für IDCS aktiviert ist, können Sie dennoch die Authentifizierung mit anderen Authentifizierungsoptionen auswählen.
AUTHENTICATION CERTIFICATE certificate-name
ID des verteilungspfadspezifischen Clientzertifikats, das in den Administrationsservice hochgeladen und dort verwaltet wird.
AUTHENTICATION USERIDALIAS
Alternativ zur Zertifikatsauthentifizierung können Sie jeden Verteilungspfad mit einem Ziel-DBLOGIN USERIDALIAS verknüpfen.
ENCRYPTIONPROFILE
Gibt den Namen des Verschlüsselungsprofils für den Verteilungspfad an.
COMPRESSION {ON |
OFF |
THRESHOLD compression_threshold} |
Gibt an, ob die Daten komprimiert sind oder nicht. Wenn dieser Wert auf ON gesetzt ist, können Sie die Schwellenwertebene angeben.
RULE
Mindestens eine RULE-Option muss angegeben werden. Beispiel:
ALTER RECVPATH rcvp RULE FILTER CHUNKIDS (1, 2, 3)PASSTHRU
Siehe PASSTHRU \| NOPASSTHRU in der Referenz zu Parametern und Funktionen für Oracle GoldenGate.
FILTER
Mindestens eine FILTER-Option muss angegeben werden. Der Wert für RELATION zwischen den Filtern lautet standardmäßig OR und die Aktion KEEP.
CHUNKIDS chunk_ids
Geben Sie eine Regel zum Filtern von Datensätzen nach Chunk-ID an (Sharding). Die Liste der Chunk-IDs muss in Klammern gesetzt und durch Komma getrennt werden.
OBJECTNAMES object_names
Geben Sie eine Regel zum Filtern von Datensätzen nach Objektname an. Die Liste der Objektnamen muss in Klammern gesetzt und durch Komma getrennt werden. Ein Objektname muss der folgenden Grammatik entsprechen:
[cdb_name.]schema_name.table_nameBeispiel:
ALTER RECVPATH rcvp RULE FILTER OBJECTNAMES (hr.emp, pdbnorth.hr.department)OBJECTTYPES [ DML | DDL | PROCEDURE]
Geben Sie eine Regel zum Filtern von Datensätzen nach Objekttyp an. Mindestens ein Objekttyp muss angegeben werden.
TAGS binary_tags
Geben Sie eine Regel zum Filtern von Datensätzen nach Tag an. Die Liste der Tags muss in Klammern gesetzt und durch Komma getrennt werden. Ein Tag muss eine hexadezimale oder binäre Wertzeichenfolge sein und durch die Schlüsselwörter HEXVALUE, HEXMASK, BINVALUE und BINMASK als Präfix vorangestellt sein. Falls das Tag eine BITMASK ist, führt der Filter einen bitweisen AND-Vorgang zwischen der Maske und dem Tagwert eines LCR-Datensatzes aus. Wenn das Ergebnis MASK entspricht, wird die Aktion angewendet. Beispiel:
ALTER RECVPATH rcvp RULE FILTER TAGS (hexvalue A4, hexvalue 18, hexmask F0, hexvalue F8F, binvalue 01001100, binmask 0110)PROCEDUREFEATURENAMES feature_names
Geben Sie eine Regel zum Filtern von Datensätzen nach Prozedurfeaturename an. Die Liste der Prozedurfeaturenamen muss in Klammern gesetzt und durch Komma getrennt werden. Beispiel:
ALTER RECVPATH rcvp RULE FILTER PROCEDUREFEATURENAMES (RAS, AUTOCDR, AQ)COLUMNVALUES column_values
Geben Sie eine Regel zum Filtern von Datensätzen nach Spaltenwert an. Die Filterregeln müssen dieser Grammatik entsprechen und durch Komma getrennt sein:
[cdb_name.]schema_name.table_name.column_name ( EQ | NE | LT | GT | LE | GE ) column_value [ BEFORE | AFTER ]EQ = gleich
NE = ungleich
LT = kleiner/gleich
GT = größer als
LE = kleiner/gleich
GE = Reibe oder gleich
Beispiel:
ALTER RECVPATH rcvp RULE FILTER COLUMNVALUES (pdbnorth.ggadmin.hr.emp.emp_id EQ 0 BEFORE, cdbsouth.c##ggadmin.hr.emp.emp_id GT 100)OPTIONS
Mindestens eine Option muss angegeben werden:
AUTORESTART {RETRIES retries |
DELAY delay} |
Gibt an, dass der Verteilungspfad automatisch neu gestartet wird und wie oft der Startversuch wiederholt werden soll. Außerdem wird eine eventuelle Verzögerung angegeben.
CRTICAL [YES | NO]
Gibt an, ob der Verteilungspfad für das Deployment kritisch ist. Der Standardwert ist NO.
EOFDELAY eofdelay
Gibt an, wie oft Extract, ein Data Pump oder Replicat prüft, ob neue Daten vorhanden sind, nachdem das Ende der aktuellen Daten in der Datenquelle erreicht wurde.
ENCRYPTIONPROFILE
Gibt den Namen des Verschlüsselungsprofils für den Empfangspfad an.
Beispiele
ALTER RECVPATH rcvp BEGIN NOWALTER RECVPATH rcvp BEGIN SEQNO 1 RBA 10355ALTER RECVPATH rcvp OPTIONS AUTORESTART RETRIES 3ALTER RECVPATH rcvp RULE FILTER OBJECTNAMES (hr.*, sales.*) ACTION EXCLUDEALTER RECVPATH rcvp RULE FILTER TAGS (AE00, MASK AB00, FF)ALTER RECVPATH rcvp RULE FILTER COLUMNVALUES (c##ggadmin.hr.employees NE nope, c##ggadmin.hr.employees
EQ 3 AFTER, c##ggadmin.hr.employees GE 5, c##ggadmin.hr.employees GT 5 BEFORE)ALTER RECVPATH rcvp RULE FILTER OBJECTNAMES(hr.*,sales.*) RELATION AND ACTION EXCLUDE