ALTER RECVPATH
Utilisez ALTER RECVPATH pour modifier les attributs d'un chemin de distribution lancé à la cible dans le service de destinataire.
Syntaxe
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
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 d'un fichier de journalisation Oracle et adresse d'octet relative dans ce fichier à partir desquels démarrer la capture des données.
begin_datetime
Date et heure (horodatage) au format indiqué. Pour une extraction en mode intégré, 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 destinataire et l'emplacement des fichiers trace source.
PROXY URI proxy_uri
Indique l'URI de proxy après le mot-clé de proxy 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 destinataire et l'emplacement des fichiers trace source.
TARGET
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.
FORMAT
Indique le format de l'URI du chemin de distribution cible.
SIZEMB megabytes_number
Définit la taille du chemin de distribution en méga-octets.
SEQLEN sequence_length
Définit la longueur de séquence du chemin de distribution.
TYPE
Définit le type de proxy utilisé par le chemin de distribution, HTTP ou SOCKS.
CSALIAS credential_store_alias
Indique le nom de l'alias de banque d'informations d'identification.
CSALIAS credential_store_domain
Indique le nom du domaine de banque d'informations d'identification.
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.
COMPRESSION {ON |
OFF |
THRESHOLD compression_threshold} |
Indique si les données sont compressées. Si cette option est définie sur ON, vous pouvez préciser le niveau de seuil.
RULE
Vous devez indiquer au moins une option RULE. Exemple :
ALTER RECVPATH rcvp 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_nameExemple :
ALTER RECVPATH rcvp 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 RECVPATH rcvp 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 RECVPATH rcvp 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 RECVPATH rcvp 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.
ENCRYPTIONPROFILE
Indique le nom du profil de cryptage du chemin de destinataire.
Exemples
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