ALTER DISTPATH

Utilice ALTER DISTPATH para cambiar los atributos de una ruta de distribución.

Sintaxis

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

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

El número de secuencia del archivo de pista y RBA dentro de ese archivo para comenzar a capturar datos.

begin-datetime

Fecha y hora (registro de hora) en el formato especificado. Para Extract, el valor de registro de hora debe ser mayor que el registro de hora en el que se ha registrado el 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 distribución y la ubicación de los archivos de pista de origen.

TARGET URI target_uri

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.

URI

Especifica el URI de la ruta de distribución de destino.

FORMAT

Especifica el formato del URI de la ruta de distribución de destino.

SIZEMB

Especifica el tamaño de la secuencia de pista.

SEQLEN

Especifica la longitud de secuencia del archivo de pista.

PROXY URI

Especifica el URI del proxy de la ruta de distribución de destino.

TYPE

Especifica el tipo de conexión entre la ruta de distribución de origen y destino. Puede seleccionar SOCKS PROXY o HTTP PROXY.

CSALIAS

Alias del almacén de credenciales utilizado por el perfil de cifrado para la ruta de distribución.

CSDOMAIN

Dominio del almacén de credenciales utilizado por el perfil de cifrado para la ruta de distribución.

COMPRESSION

Especifica si se debe comprimir la secuencia de pista. Si lo define en YES, debe especificar el umbral para la compresión.

RULE

Nota: En el cliente de administración, si crea una regla mientras existe una anterior, se elimina la regla anterior y se agrega la nueva regla. No puede agregar reglas desde el cliente de administración. Si necesita crear reglas complicadas o agregar reglas a reglas existentes, utilice la interfaz web o la llamada a la API de REST directamente.

Se debe especificar al menos una opción RULE. Por ejemplo:

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

Por ejemplo:

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

Consulte Cambio del filtro de ruta para conocer las reglas de configuración de filtro para una ruta existente.

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.

Ejemplos

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

En este ejemplo se excluyen todas las particiones que coincidan con part1* de todas las tablas:

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