ALTER RECVPATH
Utilice ALTER RECVPATH para cambiar los atributos de la ruta de distribución iniciada por los destinos en el servicio del receptor.
Sintaxis
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
Nombre de la ruta de distribución que desea cambiar.
BEGIN {NOW |
SEQNO sequence_number RBA relative_byte_address |
begin_datetime} |
Especifica el registro de hora en el origen de datos a la que se va a empezar el procesamiento.
NOW
Especifica la hora a la que se emite la orden ADD EXTRACT.
sequence_number relative_byte_address
Número de secuencia de un redo log de Oracle y del RBA de ese log en el que se van a empezar a capturar los datos.
begin_datetime
Fecha y hora (registro de hora) en el formato especificado. Para un Extract en el modo integrado, el valor de registro de hora debe ser mayor que el registro de hora a la que se ha registrado Extract con la base de datos.
SOURCE URI source_uri
Especifica el URI de origen después de la palabra clave de origen para indicar dónde se originan los datos. El formato de este URI contiene el protocolo (solo soporta la pista), el nombre de host, el número de puerto del servicio de receptor y la ubicación de los archivos de pista de origen.
PROXY URI proxy_uri
Especifica el URI de proxy después de la palabra clave de proxy para indicar dónde se originan los datos. El formato de este URI contiene el protocolo (solo soporta la pista), el nombre de host, el número de puerto del servicio de receptor y la ubicación de los archivos de pista de origen.
TARGET
Se debe especificar al menos una opción TARGET. Se considera como un objeto completo. Para realizar una especificación compleja, debe utilizar la API de REST. El cliente de administración solo soporta un juego limitado de valores de destino y no fusiona el valor de destino con la llamada anterior.
CANONICAL
Define un orden de bytes único, una representación de punto flotante única de los datos.
TEXT
Datos de texto.
SQL
Sentencias SQL válidas.
XML
Datos con formato XML.
FORMAT
Especifica el formato del URI de la ruta de distribución de destino.
SIZEMB megabytes_number
Define el tamaño de la ruta de distribución en megabytes.
SEQLEN sequence_length
Define la longitud de secuencia de la ruta de distribución.
TYPE
Define el tipo de proxy que utiliza la ruta de distribución, HTTP o SOCKS.
CSALIAS credential_store_alias
Especifica el nombre de alias del almacén de credenciales.
CSALIAS credential_store_domain
Especifica el nombre de dominio del almacén de credenciales.
AUTHENTICATION OAUTH
Utilice esta opción si va a utilizar un perfil de autorización de proveedor de identidad (IDCS) externo. Esto configurará el flujo desde el servicio de distribución hasta el servicio de receptor.
Nota: Si el despliegue está activado para IDCS, puede elegir una autenticación utilizando otras opciones de autenticación.
AUTHENTICATION CERTIFICATE certificate-name
Identificador del certificado de cliente específico de la ruta de distribución cargado y gestionado en el servicio de administración.
AUTHENTICATION USERIDALIAS
Como alternativa para certificar la autenticación, puede asociar cada ruta a una DBLOGIN USERIDALIAS de destino.
ENCRYPTIONPROFILE
Especifica el nombre del archivo cifrado para la ruta de distribución.
COMPRESSION {ON |
OFF |
THRESHOLD compression_threshold} |
Especifica si los datos están comprimidos o no. Si se define en ON, puede especificar el nivel de umbral.
RULE
Se debe especificar al menos una opción RULE. Por ejemplo:
ALTER RECVPATH rcvp RULE FILTER CHUNKIDS (1, 2, 3)PASSTHRU
Consulte PASSTHRU \| NOPASSTHRU en Referencia de parámetros y funciones para Oracle GoldenGate.
FILTER
Se debe especificar al menos una opción FILTER. Por defecto, el Valor de RELATION entre los filtros es OR y la acción es KEEP.
CHUNKIDS chunk_ids
Especifique una regla para filtrar registros por su identificador de fragmento (fragmentación). La lista de identificadores de fragmento debe estar entre paréntesis y separada por comas.
OBJECTNAMES object_names
Especifique una regla para filtrar registros por su nombre de objeto. La lista de nombres de objeto debe estar entre paréntesis y separada por comas. Un nombre de objeto debe tener la siguiente gramática:
[cdb_name.]schema_name.table_namePor ejemplo:
ALTER RECVPATH rcvp RULE FILTER OBJECTNAMES (hr.emp, pdbnorth.hr.department)OBJECTTYPES [ DML | DDL | PROCEDURE]
Especifique una regla para filtrar registros por su tipo de objeto. Se debe especificar al menos un tipo de objeto.
TAGS binary_tags
Especifique una regla para filtrar registros por su etiqueta. La lista de nombres de objeto debe estar entre paréntesis y separada por comas. Una etiqueta debe ser una cadena del valor hexadecimal o binario y con las palabras clave HEXVALUE, HEXMASK, BINVALUE y BINMASK como prefijo. En el caso de Que la etiqueta sea una BITMASK, el filtro realiza una operación AND a nivel del bit entre la máscara y el valor de etiqueta de un registro LCR. Si el resultado es igual a MASK, se aplica la acción. Por ejemplo:
ALTER RECVPATH rcvp RULE FILTER TAGS (hexvalue A4, hexvalue 18, hexmask F0, hexvalue F8F, binvalue 01001100, binmask 0110)PROCEDUREFEATURENAMES feature_names
Especifique una regla para filtrar registros por el nombre de función de procedimiento. La lista de nombres de función de procedimiento debe estar entre paréntesis y separada por comas. Por ejemplo:
ALTER RECVPATH rcvp RULE FILTER PROCEDUREFEATURENAMES (RAS, AUTOCDR, AQ)COLUMNVALUES column_values
Especifique una regla para filtrar registros por su nombre de columna. Las reglas de filtrado deben seguir esta gramática y estar separadas por comas:
[cdb_name.]schema_name.table_name.column_name ( EQ | NE | LT | GT | LE | GE ) column_value [ BEFORE | AFTER ]EQ = igual
NE = distinto de
LT = menor que
GT = mayor que
LE = menor o igual que
GE = mayor o igual
Por ejemplo:
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
Debe especificarse como mínimo una opción:
AUTORESTART {RETRIES retries |
DELAY delay} |
Especifica que la ruta de distribución se reinicie de forma automática, el número de veces que se va a reintentar el inicio y las posibles demoras.
CRTICAL [YES | NO]
Indica que la ruta de distribución es crítica para el despliegue. El valor por defecto es NO.
EOFDELAY eofdelay
Especifica con qué frecuencia Extract, un pump de datos o Replicat comprueba los nuevos datos después de haber alcanzado el final de los datos actuales en su origen de datos.
ENCRYPTIONPROFILE
Especifica el nombre del archivo de cifrado para la ruta del receptor.
Ejemplos
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