ALTER RECVPATH
Use ALTER RECVPATH para alterar os atributos do caminho de distribuição iniciado por destino no Receiver Service.
Sintaxe
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
O nome do caminho de distribuição que você deseja alterar.
BEGIN {NOW |
SEQNO sequence_number RBA relative_byte_address |
begin_datetime} |
Especifica um timestamp na origem de dados na qual iniciar o processamento.
NOW
Especifica a hora em que o comando ADD EXTRACT é emitido.
sequence_number relative_byte_address
O número de sequência de um redo log Oracle e RBA nesse log no qual começar a capturar dados.
begin_datetime
Uma data e hora (timestamp) no formato em questão. Para um Extract no modo integrado, o valor do timestamp deve ser maior que o timestamp no qual o Extract foi registrado no banco de dados.
SOURCE URI source_uri
Especifica o URI de origem após a palavra-chave 'source' para indicar onde os dados se originaram. O formato desse URI contém o protocolo (só suporta trilha), o nome do host, o número da porta do Receiver Service e a localização dos arquivos de trilha de origem.
PROXY URI proxy_uri
Especifica o URI do proxy após a palavra-chave 'proxy' para indicar onde os dados se originaram. O formato desse URI contém o protocolo (só suporta trilha), o nome do host, o número da porta do Receiver Service e a localização dos arquivos de trilha de origem.
TARGET
Pelo menos uma opção TARGET deve ser especificada. É tratada como objeto completo. Se você precisar especificar algo complicado, use a API REST. O Admin Client suporta apenas um conjunto limitado de definições de destino e não mescla a definição de destino com a chamada anterior.
CANONICAL
Define uma ordem de bytes simples, uma representação de ponto flutuante simples dos dados.
TEXT
Dados de texto.
SQL
Instruções SQL válidas.
XML
Dados formatados em XML.
FORMAT
Especifica o formato do URI do caminho de distribuição de destino.
SIZEMB megabytes_number
Define o tamanho do caminho de distribuição em megabytes.
SEQLEN sequence_length
Define o tamanho da sequência do caminho de distribuição.
TYPE
Define o tipo de proxy usado pelo caminho de distribuição, HTTP ou SOCKS.
CSALIAS credential_store_alias
Especifica seu nome de alias do armazenamento de credenciais.
CSALIAS credential_store_domain
Especifica seu nome de domínio do armazenamento de credenciais.
AUTHENTICATION OAUTH
Use esta opção se estiver usando o perfil de autorização do Provedor de Identidades (IDCS) externo. Isso configurará o fluxo do Distribution Service para o Receiver Service.
Observação: Se a sua implantação estiver ativada para IDCS, você ainda poderá optar pela autenticação usando outras opções de autenticação.
AUTHENTICATION CERTIFICATE certificate-name
Identificador do certificado cliente específico do caminho de distribuição submetido a upload e gerenciado no Administration Service.
AUTHENTICATION USERIDALIAS
Alternativa à autenticação do certificado, você pode associar cada caminho da distribuição a um DBLOGIN USERIDALIAS de destino.
ENCRYPTIONPROFILE
Especifica o nome do perfil de criptografia para o caminho de distribuição.
COMPRESSION {ON |
OFF |
THRESHOLD compression_threshold} |
Especifica se seus dados estão ou não compactados. Se definido como ON, você poderá especificar o nível de limite.
RULE
Pelo menos uma opção RULE deve ser especificada. Por exemplo:
ALTER RECVPATH rcvp RULE FILTER CHUNKIDS (1, 2, 3)PASSTHRU
Consulte PASSTHRU \| NOPASSTHRU na Referência de Parâmetros e Funções do Oracle GoldenGate.
FILTER
Pelo menos uma opção FILTER deve ser especificada. Por padrão, a RELATION entre os filtros é OR e a ação é KEEP.
CHUNKIDS chunk_ids
Especifique uma regra para filtrar os registros pelo ID do chunk (sharding). A lista de IDs de chunk deve ser colocada entre parênteses e separada por vírgulas.
OBJECTNAMES object_names
Especifique uma regra para filtrar os registros por seus nomes de objeto. A lista de nomes de objeto deve ser colocada entre parênteses e separada por vírgulas. Um nome de objeto deve seguir a seguinte gramática:
[cdb_name.]schema_name.table_namePor exemplo:
ALTER RECVPATH rcvp RULE FILTER OBJECTNAMES (hr.emp, pdbnorth.hr.department)OBJECTTYPES [ DML | DDL | PROCEDURE]
Especifique uma regra para filtrar os registros por seus tipos de objeto. Pelo menos um tipo de objeto deve ser especificado.
TAGS binary_tags
Especifique uma regra para filtrar os registros por suas tags. A lista de tags deve ser colocada entre parênteses e separada por vírgulas. Uma tag deve ser uma string com valor binário ou hexadecimal e prefixada pelas palavras-chave HEXVALUE, HEXMASK, BINVALUE e BINMASK. Caso a tag seja BITMASK, o filtro executará uma operação AND bit a bit entre a máscara e o valor da tag de um registro LCR. Se o resultado for igual à MASK, a ação será aplicada. Por exemplo:
ALTER RECVPATH rcvp RULE FILTER TAGS (hexvalue A4, hexvalue 18, hexmask F0, hexvalue F8F, binvalue 01001100, binmask 0110)PROCEDUREFEATURENAMES feature_names
Especifique uma regra para filtrar os registros por seus nomes de funcionalidade de procedimento. A lista de nomes de funcionalidade de procedimento deve ser colocada entre parênteses e separada por vírgulas. Por exemplo:
ALTER RECVPATH rcvp RULE FILTER PROCEDUREFEATURENAMES (RAS, AUTOCDR, AQ)COLUMNVALUES column_values
Especifique uma regra para filtrar os registros por seus valores de coluna. As regras de filtragem devem seguir esta gramática e ser separadas por vírgulas:
[cdb_name.]schema_name.table_name.column_name ( EQ | NE | LT | GT | LE | GE ) column_value [ BEFORE | AFTER ]EQ = igual
NE = diferente
LT = menor do que
GT = maior que
LE = menor ou igual a
GE = grater ou igual
Por exemplo:
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
Pelo menos uma opção deve ser especificada:
AUTORESTART {RETRIES retries |
DELAY delay} |
Especifica que o caminho de distribuição é reiniciado automaticamente, quantas vezes o início deve ser repetido e os eventuais atrasos.
CRTICAL [YES | NO]
Indica se o caminho de distribuição é crítico para a implantação. O padrão é NO.
EOFDELAY eofdelay
Especifica com que frequência o Extract, um data pump ou o Replicat verifica se há novos dados após ter atingido o fim dos dados atuais nesta origem de dados.
ENCRYPTIONPROFILE
Especifica o nome do perfil de criptografia para o caminho do Receiver.
Exemplos
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