ALTER DISTPATH
Use ALTER DISTPATH para alterar os atributos de um caminho da distribuição.
Sintaxe
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
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 do arquivo de trilha e do RBA dentro desse arquivo no qual começar a capturar dados.
begin-datetime
Uma data e hora (timestamp) no formato em questão. Para o Extract, 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 Distribution Service e a localização dos arquivos de trilha de origem.
TARGET URI target_uri
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.
URI
Especifica o URI do caminho de distribuição de destino.
FORMAT
Especifica o formato do URI do caminho de distribuição de destino.
SIZEMB
Especifica o tamanho da sequência de trilha.
SEQLEN
Especifica o tamanho da sequência do arquivo de trilha.
PROXY URI
Especifica o URI de proxy do caminho de distribuição de destino.
TYPE
Especifica o tipo de conexão entre o caminho de distribuição de origem e destino. Você pode escolher um SOCKS PROXY ou HTTP PROXY.
CSALIAS
Alias do armazenamento de credenciais usado pelo perfil de criptografia para o caminho de distribuição.
CSDOMAIN
Domínio do armazenamento de credenciais usado pelo perfil de criptografia para o caminho de distribuição.
COMPRESSION
Especifica se a sequência de trilha deve ser compactada Se você defini-lo como YES, precisará especificar o limite para a compactação.
RULE
Observação: no Cliente Admin, se você criar uma regra enquanto existir uma anterior, a regra anterior será removida e a nova regra será adicionada. Não é possível anexar regras do Admin Client. Se você precisar criar regras complicadas ou anexar regras a regras existentes, use a interface Web ou a chamada da API REST diretamente.
Pelo menos uma opção RULE deve ser especificada. Por exemplo:
ALTER DISTPATH dpe 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 DISTPATH dpe 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 DISTPATH dpe 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 DISTPATH dpe 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 DISTPATH dpe 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.
Consulte Alterar a Filtragem de Caminho para saber sobre as regras para definições de filtro de um caminho existente.
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.
Exemplos
ALTER DISTPATH dpe BEGIN NOWALTER DISTPATH dpe BEGIN SEQNO 1 RBA 10355ALTER DISTPATH dpn OPTIONS AUTORESTART RETRIES 3ALTER DISTPATH dpe RULE FILTER OBJECTNAMES (hr.*, sales.*) ACTION EXCLUDEALTER 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 EXCLUDEEste exemplo exclui de todas as tabelas todas as partições que correspondem a part1*:
ALTER DISTPATH dpe RULE FILTER PARTITIONNAMES (part_2022*) ACTION EXCLUDE