ALTER DISTPATH

Mit ALTER DISTPATH können Sie die Attribute eines Verteilungspfads ändern.

Syntax

ALTER DISTPATH path-name
        ( BEGIN ( NOW
                  | SEQNO trail-sequence-number RBA relative-byte-address
                  | begin-datetime ),
                  | SOURCE (source-uri),
                  | TARGET (target-uri),
                  | FORMAT ( CANONICAL | TEXT | SQL | XML))
                  | SIZEMB megabytes-number
                  | SEQLEN sequence-length
                  | PROXY URI proxy-uri
                          TYPE ( SOCKS | HTTP
                          (CSALIAS credential-store-alias)
                            [ CSDOMAIN credential-store-domain ]
                  | 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 Folgenummer der Traildatei und der RBA in dieser Datei, mit der die Datenerfassung beginnen soll.

begin-datetime

Datum und Uhrzeit (Zeitstempel) im angegebenen Format. Bei einem Extract muss der Zeitstempelwert größer als der Zeitstempel sein, an 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 Verteilungsservice und den Speicherort der Quelltraildateien.

TARGET URI target_uri

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.

URI

Gibt die URI des Zielverteilungspfads an.

FORMAT

Gibt das Format der URI des Zielverteilungspfads an.

SIZEMB

Gibt die Größe der Trailsequenz an.

SEQLEN

Gibt die Sequenzlänge der Traildatei an.

PROXY URI

Gibt die Proxy-URI des Zielverteilungspfads an.

TYPE

Gibt den Typ der Verbindung zwischen dem Quell- und dem Zielverteilungspfad an. Sie können SOCKS PROXY oder HTTP PROXY auswählen.

CSALIAS

Zugangsdatenspeicheralias, der vom Verschlüsselungsprofil für den Verteilungspfad verwendet wird.

CSDOMAIN

Domain des Zugangsdatenspeichers, der vom Verschlüsselungsprofil für den Verteilungspfad verwendet wird.

COMPRESSION

Gibt an, ob die Trailsequenz komprimiert werden soll. Wenn Sie die Option auf YES setzen, müssen Sie den Schwellenwert für die Komprimierung angeben.

RULE

Hinweis: Wenn Sie aus dem Admin-Client eine Regel erstellen, während eine vorherige Regel vorhanden ist, wird die vorherige Regel entfernt, und die neue Regel wird hinzugefügt. Sie können keine Regeln vom Admin-Client anhängen. Wenn Sie komplizierte Regeln erstellen oder Regeln an vorhandene Regeln anhängen müssen, verwenden Sie die Weboberfläche oder den REST-API-Aufruf direkt.

Mindestens eine RULE-Option muss angegeben werden. Beispiel:

ALTER DISTPATH dpe 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. Standardmäßig lautet der RELATION zwischen den Filtern 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_name

Beispiel:

ALTER DISTPATH dpe 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 DISTPATH dpe 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 DISTPATH dpe 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 DISTPATH dpe 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.

Informationen zu den Regeln für Filtereinstellungen für einen vorhandenen Pfad finden sie unter Pfadfilter ändern.

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.

Beispiele

ALTER DISTPATH dpe BEGIN NOW
ALTER DISTPATH dpe BEGIN SEQNO 1 RBA 10355
ALTER DISTPATH dpn OPTIONS AUTORESTART RETRIES 3
ALTER DISTPATH dpe RULE FILTER OBJECTNAMES (hr.*, sales.*) ACTION EXCLUDE
ALTER DISTPATH dpe RULE FILTER TAGS (AE00, MASK AB00, FF)
ALTER DISTPATH dpe RULE FILTER COLUMNVALUES (hr.employess.deptno NE nope, hr.employees.employee_id
    EQ 3 AFTER, hr.employees.deptno GE 5, hr.employees.employee_id GT 5 BEFORE)
ALTER DISTPATH dpe RULE FILTER OBJECTNAMES(hr.*,sales.*) RELATION AND ACTION EXCLUDE

Mit diesem Beispiel werden alle Partitionen, die part1* entsprechen, aus allen Tabellen ausgenommen:

ALTER DISTPATH dpe RULE FILTER PARTITIONNAMES (part_2022*) ACTION EXCLUDE