PARTIÇÃO | PARTITIONEXCLUDE

Válido Para

Extract, Distribution Service e Replicat. Somente Oracle.

Descrição

Esses parâmetros funcionam em conjunto com os parâmetros TABLE e TABLEEXCLUDE. Somente quando uma tabela é incluída, as regras de partição são avaliadas.

Para consistência, esses parâmetros se comportam muito como suas contrapartes TABLE e TABLEEXCLUDE.

Caracteres curinga serão permitidos em todas as partes do nome.
O parâmetro GLOBALS EXCLUDEWILDCARDOBJECTSONLY é suportado
A parte do contêiner só é válida no ambiente CDB com o nome de três partes.
O parâmetro SOURCECATALOG será afetado quando a parte do catálogo não for especificada.
A parte do contêiner deve ser especificada quando SOURCECATALOG não for especificado.
Se a parte do contêiner for especificada, ela terá precedência sobre SOURCECATALOG.

Se a parte [container.]schema.table de qualquer regra PARTITION ou PARTITIONEXCLUDE corresponder à tabela, somente a filtragem de partição adicional será executada.

As regras de filtragem de partição são avaliadas na seguinte ordem:

Se o nome da partição não corresponder a nenhum parâmetro PARTITION, ele será excluído.
Se incluídas pelo parâmetro PARTITION, as regras de exclusão serão avaliadas, a menos que tenham sido incluídas por uma regra de inclusão que não seja curinga e EXCLUDEWILDCARDOBJECTSONLY tenha sido especificado.

Se você estiver usando PARTITION ou EXCLUDEPARTITION no Replicat, o parâmetro PARTITION deverá ser usado para que o parâmetro Extract TABLE grave os metadados da partição no arquivo de trilha para que o Replicat possa processá-lo.

Observação: Ocorrerá um erro se um parâmetro PARTITION ou PARTITIONEXCLUDE tiver um número inválido de partes.

Sintaxe

PARTITION [<container>.]<schema.table.partition>;
PARTITIONEXCLUDE [<container>.]<schema.table.partition>;

Para não CDB, 3 partes devem ser especificadas (schema.table.partition).

Para o CDB, 4 partes devem ser especificadas (pdb.schema.table.partition) ou 3 partes com um parâmetro SOURCECATALOG anterior.

Exemplos

No exemplo a seguir com operações DML na partição P_Q4 da tabela SH.SALES, a partição é incluída porque as regras de tabela e partição a incluem.

TABLE
  sh.sales;
  PARTITION sh.sales*.p_q4;

No exemplo a seguir com operações DML na partição P_Q4 da tabela SH.SALES, todas as partições são incluídas no lado do Extract usando os parâmetros TABLE/PARTITION. A partição P_Q4 é excluída no lado do Replicat usando os parâmetros MAP/PARTITIONEXCLUDE. Todas as outras alterações nas partições são aplicadas pelo Replicat.

TABLE sh.sales;
  PARTITION sh.sales.p_q*;

MAP sh.sales, TARGET sh.sales;
  PARTITION sh.sales.p_q4;

No exemplo a seguir com operações DML na partição P_Q4 da tabela SH.SALES, a partição P_Q4 é excluída porque só é válida para a partição P_Q3 de SH.SALES:

TABLE
   sh.sales;PARTITION
   sh.sales*.p_q3;

O exemplo a seguir com operações DML na partição P_Q3 de SH.SALES mostra como várias regras de partição podem ser especificadas. A partição será incluída porque ela é correspondida por uma das regras de inclusão de partição.

TABLE
          sh.sales;PARTITION
          sh.sales.p_q3;PARTITION
          sh.sales.p_q4;

No exemplo a seguir com operações DML na partição P_Q4 da tabela SH.SALES_HISTORY, a partição P_Q4 é excluída devido à regra de exclusão de partição explícita.

TABLE
  sh.sales_history
  PARTITION sh.sales*.p_q4;
  PARTITIONEXCLUDE sh.sales_history.p_q*;

No exemplo a seguir com operações DML na partição P_S1 da tabela SH.PRODUCTS, nem a partição PART_S1 nem a tabela completa SH.PRODUCTS são capturadas porque a tabela SH.PRODUCTS não é referenciada.

TABLE
  sh.sales;PARTITION
  sh.products.p_s1;

No exemplo a seguir com operações DML na partição P_Q4 da tabela SH.SALES, a partição PART_S1 é incluída porque nenhuma regra de partição tem uma parte de tabela correspondente a SH.SALES. Portanto, nenhuma regra de partição é avaliada.

TABLE
  sh.sales;
  PARTITION sh.products.p_s1;