A custom scan provider will typically add paths for a base relation by setting the following hook, which is called after the core code has generated all the access paths it can for the relation (except for Gather and Gather Merge paths, which are made after this call so that they can use partial paths added by the hook): 《マッチ度[90.062112]》カスタムスキャンプロバイダは、典型的には、以下のフックを設定することでベースリレーションのためのパスを追加します。 このフックはコアのコードがそのリレーションへのすべてのアクセスパスを生成した後で呼び出されます。 （フックの呼び出しの後に作成されるギャザーパス(Gather path)を除きます。フックが追加した部分パスをギャザーパスが利用できるようにするためです。）

typedef void (*set_rel_pathlist_hook_type) (PlannerInfo *root,
                                            RelOptInfo *rel,
                                            Index rti,
                                            RangeTblEntry *rte);
extern PGDLLIMPORT set_rel_pathlist_hook_type set_rel_pathlist_hook;

Although this hook function can be used to examine, modify, or remove paths generated by the core system, a custom scan provider will typically confine itself to generating <structname>CustomPath</structname> objects and adding them to <literal>rel</literal> using <function>add_path</function>, or <function>add_partial_path</function> if they are partial paths. The custom scan provider is responsible for initializing the <structname>CustomPath</structname> object, which is declared like this: 《マッチ度[81.488934]》このフックはコアシステムが生成したパスを検査し、修正し、あるいは削除するために使うことができますが、カスタムスキャンプロバイダは、典型的にはCustomPathオブジェクトを生成し、add_pathを使ってそれをrelに追加することのみを行います。 カスタムスキャンプロバイダはCustomPathオブジェクトの初期化を担当します。 このオブジェクトは以下のように宣言されています。 《機械翻訳》このフック関数は、経路によって生成されたコアシステムを検査、変更、または削除するために使用できますが、カスタムスキャンプロバイダは通常、自分自身を生成するCustomPathオブジェクトに限定し、add_pathを使用して、またはadd_partial_pathを使用してrelに追加します。 カスタムスキャンプロバイダは、CustomPathオブジェクトを初期化する責任があります。 これは、次のように宣言されます。

typedef struct CustomPath
{
    Path      path;
    uint32    flags;
    List     *custom_paths;
    List     *custom_restrictinfo;
    List     *custom_private;
    const CustomPathMethods *methods;
} CustomPath;

<structfield>path</structfield> must be initialized as for any other path, including the row-count estimate, start and total cost, and sort ordering provided by this path. <structfield>flags</structfield> is a bit mask, which specifies whether the scan provider can support certain optional capabilities. <structfield>flags</structfield> should include <literal>CUSTOMPATH_SUPPORT_BACKWARD_SCAN</literal> if the custom path can support a backward scan, <literal>CUSTOMPATH_SUPPORT_MARK_RESTORE</literal> if it can support mark and restore, and <literal>CUSTOMPATH_SUPPORT_PROJECTION</literal> if it can perform projections. (If <literal>CUSTOMPATH_SUPPORT_PROJECTION</literal> is not set, the scan node will only be asked to produce Vars of the scanned relation; while if that flag is set, the scan node must be able to evaluate scalar expressions over these Vars.) An optional <structfield>custom_paths</structfield> is a list of <structname>Path</structname> nodes used by this custom-path node; these will be transformed into <structname>Plan</structname> nodes by planner. As described below, custom paths can be created for join relations as well. In such a case, <structfield>custom_restrictinfo</structfield> should be used to store the set of join clauses to apply to the join the custom path replaces. Otherwise it should be NIL. <structfield>custom_private</structfield> can be used to store the custom path's private data. Private data should be stored in a form that can be handled by <literal>nodeToString</literal>, so that debugging routines that attempt to print the custom path will work as designed. <structfield>methods</structfield> must point to a (usually statically allocated) object implementing the required custom path methods, which are further detailed below. 《マッチ度[80.526021]》pathは、他のすべてのパスと同じく、行数の推定値、開始とトータルのコスト、このパスで提供されるソート順を含めて初期化される必要があります。 flagsはビットマスクで、スキャンプロバイダが特定のオプションをサポートできるかどうかを指定します。 カスタムパスが逆向きスキャンをサポートできるならCUSTOMPATH_SUPPORT_BACKWARD_SCANを、マークとリストアをサポートできるならCUSTOMPATH_SUPPORT_MARK_RESTOREを、プロジェクションを実行できるならCUSTOMPATH_SUPPORT_PROJECTIONをflagsに含めます。 (CUSTOMPATH_SUPPORT_PROJECTIONが設定されていなければ、スキャンノードはスキャンされるリレーションのVarを生成するよう依頼されるだけです。一方、そのフラグが設定されていれば、スキャンノードはこのVarのスカラ式を評価できないといけません。) オプションのcustom_pathsはこのカスタムパスのノードで使用されるPathのノードのリストです。 プランナがこれをPlanのノードに変換します。 custom_privateはカスタムパスのプライベートデータを格納するために使うことができます。 プライベートデータはnodeToStringが処理できるような形式で格納してください。 そうすることで、カスタムパスを出力するデバッグルーチンが設計通りに動作します。 methodsは要求されるカスタムパスのメソッドのオブジェクト（通常は静的に割り当てられる）を指している必要があり、以下でさらに詳しく説明します。 《機械翻訳》pathは、このパスによって提供される行-カウントの推定値、スタートおよび総コスト、ソート順序付けを含む他のパスと同様に初期化する必要があります。 flagsはビットマスクで、スキャンプロバイダが特定のオプショナル機能をサポートできるかどうかを指定します。 flagsは、カスタムパスが後方スキャンをincludeできる場合はCUSTOMPATH_SUPPORT_BACKWARD_SCAN、サポートマークとリストアをサポートできる場合はCUSTOMPATH_SUPPORT_MARK_RESTORE、投影を実行できる場合はCUSTOMPATH_SUPPORT_PROJECTIONになります。 CUSTOMPATH_SUPPORT_PROJECTIONが設定されていない場合、スキャンノードはスキャンされたリレーションの変数を生成するように要求されるだけです。 一方、そのフラグが設定されている場合、スキャンノードはこれらの変数に対してスカラ式を評価できる必要があります。 オプショナルcustom_pathsは、このカスタム-パスノードによって使用されるPathノードのリストであり、これらはプランナによってPlanノードに変換される。 後述するように、結合経路に対してもカスタムリレーションを作成することができる。 このようなケースでは、カスタム_restrictinfoを使用して、結合パスが置き換える結合に適用する一連のカスタム句を保存する必要があります。 それ以外の場合はNILです。 custom_privateは、カスタムパスのプライベートデータを格納するために使用できます。 プライベートデータは、nodeToStringで処理できるフォームに格納する必要があります。 これにより、カスタムパスをプリントしようとするデバッグルーチンが設計どおりに動作します。 methodsは、必要なポイントオブジェクトメソッドを実装する（通常は静的に割り当てられた）カスタムにパスする必要があります。 詳細については、以下を参照してください。

A custom scan provider can also provide join paths. Just as for base relations, such a path must produce the same output as would normally be produced by the join it replaces. To do this, the join provider should set the following hook, and then within the hook function, create <structname>CustomPath</structname> path(s) for the join relation. カスタムスキャンプロバイダは結合(join)のパスを提供することもできます。 ベースのリレーションの場合と同様、そのようなパスは置換される結合が普通に生成したであろうものと同じ結果を生成しなければなりません。 そのために、結合のプロバイダは以下のフックをセットし、フック関数内で結合リレーション用にCustomPathのパスを作成します。

typedef void (*set_join_pathlist_hook_type) (PlannerInfo *root,
                                             RelOptInfo *joinrel,
                                             RelOptInfo *outerrel,
                                             RelOptInfo *innerrel,
                                             JoinType jointype,
                                             JoinPathExtraData *extra);
extern PGDLLIMPORT set_join_pathlist_hook_type set_join_pathlist_hook;

This hook will be invoked repeatedly for the same join relation, with different combinations of inner and outer relations; it is the responsibility of the hook to minimize duplicated work. このフックは、同じ結合リレーションについて、内側あるいは外側のリレーションとの様々な組み合わせで繰り返し呼び出されます。 繰り返しの作業を最小化するのはフック側の責任です。

Note also that the set of join clauses to apply to the join, which is passed as <literal>extra-&gt;restrictlist</literal>, varies depending on the combination of inner and outer relations. A <structname>CustomPath</structname> path generated for the <literal>joinrel</literal> must contain the set of join clauses it uses, which will be used by the planner to convert the <structname>CustomPath</structname> path into a plan, if it is selected by the planner as the best path for the <literal>joinrel</literal>. 《機械翻訳》ノートまた、extra->restrictlistとして渡される結合に適用される結合条項のセットは、内部リレーションと外部地域の組み合わせによって異なります。 joinrelに対して生成されるCustomPathパスには、使用する結合句のセットが含まれている必要があります。 プランナがjoinrelのベストパスとして選択した場合、CustomPathパスをプランに変換するためにプランナによって使用されます。

Plan *(*PlanCustomPath) (PlannerInfo *root,
                         RelOptInfo *rel,
                         CustomPath *best_path,
                         List *tlist,
                         List *clauses,
                         List *custom_plans);

List *(*ReparameterizeCustomPathByChild) (PlannerInfo *root,
                                          List *custom_private,
                                          RelOptInfo *child_rel);