Usando Curingas em Nomes de Objetos de Banco de Dados

Você pode usar curingas para qualquer parte de um nome de objeto totalmente qualificado, se houver suporte para o banco de dados específico. Essas partes do nome podem ser as seguintes: o nome do contêiner, do banco de dados ou do catálogo, o proprietário (esquema ou nome do banco de dados) e o nome da tabela ou sequência. Para obter detalhes sobre como nomes de objetos e curingas são suportados, consulte o guia de instalação e configuração do Oracle GoldenGate para esse banco de dados.

Quando apropriado, os parâmetros do Oracle GoldenGate permitem o uso de dois tipos de curinga para especificar vários objetos em uma instrução:

Um ponto de interrogação (?) substitui um caractere. Por exemplo, em um esquema que contém tabelas denominadas TABn, em que n é de 0 a 9, uma especificação curinga de HQ.TAB? retorna HQ.TAB0, HQ.TAB1, HQ.TAB2 e assim por diante, até HQ.TAB9, mas nenhuma outra. Este curinga não é suportado para o banco de dados DB2 LUW nem para DEFGEN. Esse caractere curinga só pode ser usado para especificar objetos de origem em um parâmetro TABLE ou MAP. Não pode ser usado para especificar objetos de destino na cláusula TARGET de TABLE ou MAP.
Um asterisco (*) representa qualquer número de caracteres (incluindo sequência zero). Por exemplo, a especificação de HQ.T* poderia retornar objetos como HQ.TOTAL, HQ.T123 e HQ.T. Esse curinga é válido para todos os tipos de banco de dados em todos os comandos e parâmetros do Oracle GoldenGate nos quais um curinga é permitido.
Nas instruções TABLE e MAP, você pode combinar os caracteres curinga asterisco e ponto de interrogação apenas em nomes de objetos de origem.

Regras para Usar Curingas para Objetos de Origem

Para objetos de origem, você pode usar o asterisco sozinho ou com um nome parcial. Por exemplo, as seguintes especificações de origem são válidas:

TABLE HQ.*;
TABLE PDB*.HQ.*;
MAP HQ.T_*;
MAP HQ.T_*, TARGET HQ.*;

Os parâmetros TABLE, MAP e SEQUENCE levam em consideração a diferenciação entre maiúsculas e minúsculas e o local do banco de dados para a resolução de curingas. Para bancos de dados que são criados com distinção entre maiúsculas e minúsculas ou sem distinção entre maiúsculas e minúsculas, o curinga corresponde ao nome e à maiúsculas e minúsculas exatos. Por exemplo, se o banco de dados diferenciar maiúsculas de minúsculas, SCHEMA.TABLE corresponderá a SCHEMA.TABLE, Schema.Table corresponderá a Schema.Table e assim por diante. Se o banco de dados não fizer distinção entre maiúsculas e minúsculas, a correspondência não fará distinção entre maiúsculas e minúsculas.

Para bancos de dados que podem ter nomes de objetos com distinção entre maiúsculas e minúsculas e sem distinção entre maiúsculas e minúsculas na mesma instância do banco de dados, com o uso de aspas para impor a distinção entre maiúsculas e minúsculas, a curinga funciona de forma diferente. Quando usado sozinho para um nome de origem em uma instrução TABLE, um caractere curinga de asterisco corresponde a qualquer caractere, quer o asterisco esteja entre aspas ou não. As instruções a seguir produzem os mesmos resultados:

TABLE hr.*;
TABLE hr."*";

Da mesma forma, um curinga de ponto de interrogação usado sozinho corresponde a qualquer caractere, esteja ou não entre aspas. Os itens a seguir produzem os mesmos resultados:

TABLE hr.?;
TABLE hr."?";

Se um curinga de ponto de interrogação ou asterisco for usado com outros caracteres, a distinção entre maiúsculas e minúsculas será aplicada aos caracteres não curinga, mas o curinga corresponderá a nomes com distinção entre maiúsculas e minúsculas e sem distinção entre maiúsculas e minúsculas.

As instruções TABLE a seguir capturam qualquer nome de tabela que comece com abc em letras minúsculas. O nome com aspas é preservado e uma correspondência que distingue maiúsculas de minúsculas é aplicada. Ele captura nomes de tabela que incluem "abcA" e "abca" porque o curinga corresponde a caracteres com distinção entre maiúsculas e minúsculas e sem distinção entre maiúsculas e minúsculas.

TABLE hr."abc*";
TABLE hr."abc?";

As instruções TABLE a seguir capturam qualquer nome de tabela que comece com ABC em letras maiúsculas, porque o nome parcial não faz distinção entre maiúsculas e minúsculas (sem aspas) e é armazenado em letras maiúsculas por este banco de dados. No entanto, como o curinga corresponde a caracteres com distinção entre maiúsculas e minúsculas e sem distinção entre maiúsculas e minúsculas, este exemplo captura nomes de tabela que incluem ABCA e "ABCa".

TABLE hr.abc*;
TABLE hr.abc?;

Regras para Usar Curingas para Objetos de Destino

Ao usar curingas na cláusula TARGET de uma instrução MAP, os objetos de destino devem existir no banco de dados de destino. (A exceção ocorre quando a replicação DDL está sendo usada, o que permite que novos esquemas e seus objetos sejam replicados à medida que são criados.)

Para objetos de destino, somente um asterisco pode ser usado. Se um curinga de asterisco for usado com um nome parcial, o Replicat substituirá o curinga pelo nome inteiro do objeto de origem correspondente. Portanto, especificações como as seguintes são incorretas:

HQ.T

Os mapeamentos anteriores produzem resultados incorretos, porque o curinga na especificação de destino é substituído por T_TEST (o nome de um objeto de origem), tornando todo o nome de destino T_T_TESTn. O seguinte ilustra os resultados incorretos:

HQ.T_TEST1 mapeia para RPT.T_T_TEST1
HQ.T_TEST2 mapeia para RPT.T_T_TEST2
(O mesmo padrão se aplica a todos os outros mapeamentos HQ.T_TESTn.)

Os exemplos a seguir mostram o uso correto de curingas de asterisco.

MAP HQ.T_*, TARGET RPT.*;

O exemplo anterior produz os seguintes resultados corretos:

HQ.T_TEST1 mapeia para RPT.T_TEST1
HQ.T_TEST2 mapeia para RPT.T_TEST2
(O mesmo padrão se aplica a todos os outros mapeamentos HQ.T_TESTn.)

Mapeamento de nomes de fallback

O Oracle GoldenGate tem um mecanismo de mapeamento de fallback no caso de um nome de origem não poder ser mapeado para um nome de destino. Se não for possível encontrar uma correspondência exata no destino para um objeto de origem com distinção entre maiúsculas e minúsculas, o Replicat tentará mapear o nome de origem para o mesmo nome em letras maiúsculas ou minúsculas (dependendo do tipo de banco de dados) no destino. O mapeamento de nomes de fallback é controlado pelos parâmetros NAMEMATCH. Para obter mais informações, consulte Referência de Parâmetros e Funções do Oracle GoldenGate.

Asteriscos ou Marcas de Pergunta como Literais em Nomes de Objetos

Se o nome de um objeto em si incluir um asterisco ou um ponto de interrogação, o nome inteiro deverá ter escape e ser colocado entre aspas duplas, como no exemplo a seguir:

TABLE HT."\?ABC";

Como os curingas são resolvidos

Por padrão, quando um nome de objeto é curinga, a resolução desse objeto ocorre quando a primeira linha do objeto de origem é processada. (Por outro lado, quando o nome de um objeto é declarado explicitamente, sua resolução ocorre na inicialização do processo.) Para alterar as regras de resolução de curingas, use o parâmetro WILDCARDRESOLVE. O padrão é DYNAMIC.

Excluindo Objetos de uma Especificação Curinga

Você pode combinar o uso de seleção de objeto curinga com exclusão de objeto explícito usando os parâmetros EXCLUDEWILDCARDOBJECTSONLY, CATALOGEXCLUDE, SCHEMAEXCLUDE, MAPEXCLUDE e TABLEEXCLUDE.