1.125 PARTITION | PARTITIONEXCLUDE

適用対象

Extract、データ・ポンプ、分散サーバーおよびReplicat。Oracleのみ。

説明

これらのパラメータは、TABLEおよびTABLEEXCLUDEパラメータと連携して機能します。表が含まれている場合のみ、パーティション・ルールが評価されます。

一貫性を保つために、これらのパラメータは対応するTABLEおよびTABLEEXCLUDEとほぼ同じように動作します。

• ワイルドカードは、すべての名前部分で使用できます。

• GLOBALSパラメータEXCLUDEWILDCARDOBJECTSONLYがサポートされています。

• コンテナ部分はCDB環境でのみ有効です。

• SOURCECATALOGパラメータは、カタログ部分が指定されていない場合に有効になります。

• SOURCECATALOGを指定しない場合は、コンテナ部分を指定する必要があります。

• コンテナ部分が指定されている場合は、SOURCECATALOGより優先されます。

PARTITIONまたはPARTITIONEXCLUDEルールの[container.]schema.table部分が表と一致する場合にのみ、追加のパーティション・フィルタリングが実行されます。

パーティション・フィルタリング・ルールは、次の順序で評価されます。

• パーティション名がどのPARTITIONパラメータとも一致しない場合は、除外されます。

• PARTITIONパラメータに含まれる場合、ワイルドカード以外の包含ルールに含まれ、EXCLUDEWILDCARDOBJECTSONLYが指定されていないかぎり、除外ルールが評価されます。

ノート:

PARTITIONまたはPARTITIONEXCLUDEパラメータに無効な数のパートがある場合は、エラーが発生します。

構文

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

非CDBの場合は、3つの部分(schema.table.partition)を指定する必要があります。CDBでは、4つの部分(pdb.schema.table.partition)または前のSOURCECATALOGパラメータを持つ3つの部分を指定する必要があります。

例

次の例では、表がTABLEパラメータで参照されていないため、パーティションは除外されます。

schema.tab2.partに対するDML

TABLE schema.tab1;
PARTITION schema.tab2.part;

次の例では、パーティション・ルールにschema.tab1と一致する表部分がないため、パーティションが含まれています。したがって、パーティション・ルールは評価されません。

schema.tab1.partに対するDML

TABLE schema.tab1;
PARTITION schema.tab2.part;

次の例では、表ルールとパーティション・ルールの両方にパーティションが含まれているため、パーティションが含まれます。

schema.tab1.partに対するDML

TABLE schema.tab1;
PARTITION schema.tab*.part;

次の例では、パーティションはschema.tab1のpart1専用であるため除外されます。

schema.tab1.part2に対するDML

TABLE schema.tab1;
PARTITION schema.tab*.part1;

次の例では、明示的なパーティション除外ルールのためにパーティションが除外されます。

schema.tab1.part1に対するDML

TABLE schema.tab1
PARTITION schema.tab*.part1;
PARTITIONEXCLUDE schema.tab1.part*;

この例では、複数のパーティション・ルールを指定する方法を示します。パーティションは、いずれかのパーティション包含ルールによって照合されるため、含められます。

schema.tab1.part1に対するDML

TABLE schema.tab1;
PARTITION schema.tab1.part2;
PARTITION schema.tab1.part1;