ALTER DISTPATH

Utilisez ALTER DISTPATH pour modifier les attributs d'un chemin de distribution.

Syntaxe

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

Nom du chemin de distribution à modifier.

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

Indique dans la source de données un horodatage à partir duquel commencer le processus.

NOW

Indique l'heure à laquelle la commande ADD EXTRACT est émise.

sequence-number relative-byte-address

Numéro de séquence du fichier trace et de l'adresse RBA dans ce fichier pour commencer à capturer les données.

begin-datetime

Date et heure (horodatage) au format indiqué. Pour une extraction, la valeur d'horodatage doit être supérieure à l'horodatage de l'inscription de l'extraction auprès de la base de données.

SOURCE URI source_uri

Indique l'URI source après le mot-clé source afin de préciser d'où proviennent les données. Le format de l'URI contient le protocole (prise en charge de la trace uniquement), le nom d'hôte, le numéro de port du service de distribution et l'emplacement des fichiers trace source.

TARGET URI target_uri

Vous devez indiquer au moins une option TARGET. Elle est traitée comme un objet complet. Si vous devez indiquer des paramètres complexes, utilisez l'API REST. Le client d'administration ne prend en charge qu'un ensemble limité de paramètres cible et ne fusionne pas le paramètre cible avec l'appel précédent.

CANONICAL

Définit un ordre d'octets unique, une représentation à virgule flottante des données unique.

TEXT

Données textuelles.

SQL

Instructions SQL valides.

XML

Données au format XML.

URI

Indique l'URI du chemin de distribution cible.

FORMAT

Indique le format de l'URI du chemin de distribution cible.

SIZEMB

Indique la taille de la séquence de trace.

SEQLEN

Indique la longueur de la séquence du fichier trace.

PROXY URI

Indique l'URI proxy du chemin de distribution cible.

TYPE

Indique le type de connexion entre le chemin de distribution source et le chemin de distribution cible. Vous pouvez choisir SOCKS PROXY ou HTTP PROXY.

CSALIAS

Alias de banque d'informations d'identification employé par le profil de cryptage du chemin de distribution.

CSDOMAIN

Domaine de banque d'informations d'identification utilisé par le profil de cryptage du chemin de distribution.

COMPRESSION

Indique si la séquence de trace a été compressée. Si cette option est définie sur YES, vous devez indiquer le seuil de compression.

RULE

Remarque : si vous créez une règle alors qu'une règle précédente existe, la règle précédente est enlevée et la nouvelle règle est ajoutée. Vous ne pouvez pas ajouter de règles à partir du client d'administration. Si vous devez créer des règles complexes ou ajouter des règles à des règles existantes, utilisez directement l'interface Web ou l'appel d'API REST.

Vous devez indiquer au moins une option RULE. Exemple :

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

PASSTHRU

Reportez-vous à PASSTHRU \| NOPASSTHRU dans Référence des paramètres et des fonctions pour Oracle GoldenGate.

FILTER

Vous devez indiquer au moins une option FILTER. Par défaut, l'option RELATION entre les filtres est OR et l'action sur KEEP.

CHUNKIDS chunk_ids

Indiquez une règle pour filtrer les enregistrements par leur ID de bloc (sharding). La liste des ID de bloc doit être entre parenthèses et chaque ID doit être séparé par une virgule.

OBJECTNAMES object_names

Indiquez une règle pour filtrer les enregistrements par leur nom d'objet. La liste des noms d'objet doit être entre parenthèses et chaque nom doit être séparé par une virgule. Les noms d'objet doivent respecter la grammaire suivante :

[cdb_name.]schema_name.table_name

Exemple :

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

OBJECTTYPES [ DML | DDL | PROCEDURE]

Indiquez une règle pour filtrer les enregistrements par leur type d'objet. Au moins un type d'objet doit être précisé.

TAGS binary_tags

Indiquez une règle pour filtrer les enregistrements par leur balise. La liste des balises doit être entre parenthèses et chaque balise doit être séparée par une virgule. Une balise doit être une chaîne d'une valeur hexadécimale ou binaire, et être précédée des mots-clés HEXVALUE, HEXMASK, BINVALUE et BINMASK. Dans le cas d'une balise BITMASK, le filtre effectue une opération AND au niveau bit entre le masque et la valeurs de balise d'un enregistrement d'enregistrement de modification logique. Si le résultat est égal à MASK, l'action est appliquée. Exemple :

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

PROCEDUREFEATURENAMES feature_names

Indiquez une règle pour filtrer les enregistrements par nom de fonctionnalité de procédure. La liste des noms de fonctionnalité de procédure doit être entre parenthèses et chaque nom doit être séparé par une virgule. Exemple :

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

COLUMNVALUES column_values

Indiquez une règle pour filtrer les enregistrements par leur valeur de colonne. Les règles de filtrage doivent suivre la grammaire suivante et être séparées par une virgule :

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

EQ = égal

NE = différent de

LT = inférieur au

GT = supérieur à

LE = inférieur ou égal

GE = râpe ou égal

Exemple :

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

Vous devez indiquer au moins une option :

AUTORESTART {RETRIES retries DELAY delay}

Indique que le chemin de distribution est automatiquement redémarré, le nombre de tentatives de redémarrage et un éventuel délai.

CRTICAL [YES | NO]

Indique que le chemin de distribution est critique pour le déploiement. La valeur par défaut est NO.

EOFDELAY eofdelay

Indique la fréquence à laquelle l'extraction, Data Pump ou la réplication doit rechercher de nouvelles données après avoir atteint la fin des données actuelles dans la source de données.

Pour en savoir plus sur la règle des paramètres de filtre d'un chemin existant, reportez-vous à Modification du filtrage de chemin.

AUTHENTICATION OAUTH

Utilisez cette option si vous employez un profil d'autorisation de fournisseur d'identités externe (IDCS). Vous configurerez ainsi le flux du service de distribution vers le service de destinataire.

Remarque : si le déploiement est activé pour IDCS, vous pouvez toujours choisir de procéder au processus d'authentification à l'aide d'autres options.

AUTHENTICATION CERTIFICATE certificate-name

Identificateur du certificat client propre au chemin de distribution téléchargé et géré dans le service d'administration.

AUTHENTICATION USERIDALIAS

Alternative à l'authentification par certificat, vous pouvez associer chaque chemin de distribution avec une valeur de DBLOGIN USERIDALIAS cible.

ENCRYPTIONPROFILE

Indique le nom du profil de cryptage du chemin de distribution.

Exemples

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

Cet exemple exclut toutes les partitions correspondant à la valeur part1* dans toutes les tables :

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