ALTER DISTPATH

Utilizzare ALTER DISTPATH per modificare gli attributi di un percorso della distribuzione.

Sintassi

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

Nome del percorso di distribuzione che si desidera modificare.

BEGIN {NOW SEQNO sequence-number RBA relative-byte-address begin-datetime}

Specifica l'indicatore orario di inizio dell'elaborazione nell'origine dati.

NOW

Specifica l'ora di esecuzione del comando ADD EXTRACT.

sequence-number relative-byte-address

Il numero di sequenza del file trail e dell'RBA all'interno del file in cui iniziare l'acquisizione dei dati.

begin-datetime

Data e ora (indicatore orario) nel formato specificato. Per Extract, il valore dell'indicatore orario deve essere successivo al valore dell'indicatore orario di registrazione di Extract con il database.

SOURCE URI source_uri

Specifica l'URI di origine dopo la parola chiave di origine per indicare la provenienza dei dati. Il formato dell'URI contiene il protocollo (sono supportati solo i trail), il nome host, il numero di porta del servizio di distribuzione e la posizione dei file di trail di origine.

TARGET URI target_uri

È necessario specificare almeno un'opzione TARGET. Viene considerata come un oggetto completo. Se è necessario specificare un valore complicato, utilizzare l'API REST. Il client di amministrazione supporta solo un set limitato di impostazioni di destinazione e non unisce le impostazioni di destinazione con la chiamata precedente.

CANONICAL

Definisce un ordine di byte singolo, una rappresentazione a virgola mobile singola dei dati.

TEXT

Dati di testo.

SQL

Istruzioni SQL valide.

XML

Dati con formattazione XML.

URI

Specifica l'URI del percorso di distribuzione di destinazione.

FORMAT

Specifica il formato della URI del percorso di distribuzione di destinazione.

SIZEMB

Specifica la dimensione della sequenza trail.

SEQLEN

Specifica la lunghezza della sequenza del file di trail.

PROXY URI

Specifica l'URI proxy del percorso di distribuzione di destinazione.

TYPE

Specifica il tipo di connessione tra il percorso di distribuzione di origine e il percorso di distribuzione di destinazione. È possibile scegliere un proxy SOCKS o un proxy HTTP.

CSALIAS

Alias dell'area di memorizzazione delle credenziali utilizzato dal profilo di cifratura per il percorso di distribuzione.

CSDOMAIN

Dominio dell'area di memorizzazione delle credenziali utilizzato dal profilo di cifratura per il percorso di distribuzione.

COMPRESSION

Specifica se la sequenza trail deve essere compressa. Se l'impostazione è YES, è necessario specificare la soglia per la compressione.

RULE

Nota: dal client di amministrazione, se si crea una regola mentre esiste una regola precedente, la regola precedente viene rimossa e la nuova regola viene aggiunta. Impossibile aggiungere regole dal client di amministrazione. Se è necessario creare regole complesse o aggiungere regole a regole esistenti, utilizzare direttamente l'interfaccia Web o la chiamata API REST.

È necessario specificare almeno un'opzione RULE. Ad esempio:

ALTER DISTPATH dpe RULE FILTER CHUNKIDS (1, 2, 3)

PASSTHRU

Consulta PASSTHRU \| NOPASSTHRU in Riferimento su parametri e funzioni per Oracle GoldenGate.

FILTER

È necessario specificare almeno un'opzione FILTER. Per impostazione predefinita, RELATION tra i filtri è OR e l'azione è KEEP.

CHUNKIDS chunk_ids

Specificare una regola per filtrare i record in base agli ID chunk rispettivi (partizionamento orizzontale). La lista degli ID chunk deve essere racchiusa tra parentesi e separata da virgole.

OBJECTNAMES object_names

Specificare una regola per filtrare i record in base al nome di oggetto. La lista dei nomi degli oggetti deve essere racchiusa tra parentesi e separate da virgole. Per i nomi degli oggetti rispettare la grammatica seguente:

[cdb_name.]schema_name.table_name

Ad esempio:

ALTER DISTPATH dpe RULE FILTER OBJECTNAMES (hr.emp, pdbnorth.hr.department)

OBJECTTYPES [ DML | DDL | PROCEDURE]

Specificare una regola per filtrare i record in base al tipo di oggetto. È necessario specificare almeno un tipo di oggetto.

TAGS binary_tags

Specificare una regola per filtrare i record in base alla tag. La lista di tag deve essere racchiusa tra parentesi e separata da virgole. La tag deve essere una stringa di valore esadecimali o binari con le parole chiave HEXVALUE, HEXMASK, BINVALUE e BINMASK come prefisso. Se la tag è un BITMASK, il filtro esegue un'operazione bitwise AND bit tra la maschera e il valore della tag di un record LCR. Se il risultato è uguale al valore MASK, l'azione verrà applicata. Ad esempio:

ALTER DISTPATH dpe RULE FILTER TAGS (hexvalue A4, hexvalue 18, hexmask F0, hexvalue F8F, binvalue 01001100, binmask 0110)

PROCEDUREFEATURENAMES feature_names

Specificare una regola per filtrare i record in base al nome della funzione di procedura. La lista dei nomi delle funzioni di procedura deve essere racchiusa tra parentesi e separate da virgole. Ad esempio:

ALTER DISTPATH dpe RULE FILTER PROCEDUREFEATURENAMES (RAS, AUTOCDR, AQ)

COLUMNVALUES column_values

Specificare una regola per filtrare i record in base al rispettivo valore di colonna. Le regole di filtro devono rispettare questa grammatica ed essere separate da virgole:

[cdb_name.]schema_name.table_name.column_name ( EQ | NE | LT | GT | LE | GE ) column_value [ BEFORE | AFTER ]

EQ = uguale

NE = diverso

LT = inferiore a

GT = maggiore di

LE = minore o uguale a

GE = maggiore o uguale a

Ad esempio:

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

È necessario specificare almeno un'opzione.

AUTORESTART {RETRIES retries DELAY delay}

Specifica che il percorso di distribuzione viene riavviato in modo automatico, il numero di nuovi tentativi di avvio e l'eventuale ritardo.

CRTICAL [YES | NO]

Indica se il percorso di distribuzione è di importanza critica per la distribuzione. L'impostazione predefinita è NO.

EOFDELAY eofdelay

Specifica la frequenza alla quale Extract, Data Pump o Replicat verifica la presenza di nuovi dati dopo aver raggiunto la fine dei dati correnti nella propria origine dati.

Per informazioni sulle regole per filtrare le impostazioni per un percorso esistente, vedere Modifica filtro percorso.

AUTHENTICATION OAUTH

Utilizzare questa opzione se si utilizza il profilo di autorizzazione del provider di identità esterno (IDCS). In questo modo il flusso verrà impostato dal servizio di distribuzione al servizio di ricezione.

Nota: se la distribuzione è abilitata per IDCS, è comunque possibile scegliere di eseguire l'autenticazione utilizzando altre opzioni.

AUTHENTICATION CERTIFICATE certificate-name

Certificato client specifico dell'identificativo o del percorso di distribuzione caricato e gestito nel servizio di amministrazione.

AUTHENTICATION USERIDALIAS

In alternativa all'autenticazione del certificato, è possibile associare ciascun percorso a un valore DBLOGIN USERIDALIAS di destinazione.

ENCRYPTIONPROFILE

Specifica il nome del profilo di cifratura per il percorso di distribuzione.

Esempi

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

In questo esempio tutte le partizioni corrispondenti part1* vengono escluse da tutte le tabelle:

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