コンポーネントの論理パス
論理パス は、ライターによって管理されるコンポーネントを適切に定義されたグループに整理するために使用されます。
論理パスは、構造が従来のファイル パスに似ています。パス内の要素を区切るために円記号 "\" を使用します。 ファイル パスとは異なり、論理パスのルートは "\" ではなく NULL です。
論理パスは NULL で終わる文字列として表され、パスに含めることができる文字に他の制限はありません。
論理パスの最も重要な用途は、 コンポーネント セットを定義することです。ここで、1 つの選択可能なコンポーネントのバックアップまたは復元操作に 明示的なコンポーネントを含める 場合は、他のコンポーネント (サブコンポーネント) を多数含める必要があります。 コンポーネント セットの定義コンポーネントの論理パスは、そのサブコンポーネントの論理パスの親であり、次のようになります。
- サブコンポーネントは、コンポーネント セットを定義する選択可能なコンポーネントの論理パスをルート パスとして共有する必要があります。
- NULL のルート パスが有効です。
- 定義する選択可能コンポーネントの名前は、コンポーネント・セットの選択できないサブコンポーネントごとに、ルート・パスの後の最初の論理パス要素でなければなりません。
- コンポーネント セットは入れ子にすることができます。
- 論理パスとコンポーネント名の組み合わせは、 ライター クラスのすべてのインスタンスで一意である必要があります。
以下に定義されている論理パス構造を持つライター MyWriter の架空の例は、論理パスを示しています。
| コンポーネント名 | 論理パス | バックアップ用に選択可能 |
|---|---|---|
| "実行可能ファイル" | "" | × |
| "ConfigFiles" | "実行可能ファイル" | × |
| "LicenseInfo" | "" | Y |
| "Security" | "" | Y |
| "UserInfo" | "Security" | × |
| "証明書" | "Security" | × |
| "writerData" | "" | Y |
| "Set1" | "writerData" | × |
| "Jan" | "writerData\Set1" | × |
| "Dec" | "writerData\Set1" | × |
| "Set2" | "writerData" | × |
| "Jan" | "writerData\Set2" | × |
| "Dec" | "writerData\Set2" | × |
| "クエリ" | "writerData\QueryLogs" | N |
| "使用法" | "writerData" | Y |
| "Jan" | "writerData\Usage" | × |
| "Dec" | "writerData\Usage" | × |
コンポーネント "Executables" と "ConfigFile" には親子関係がありますが、どちらも選択できません。 したがって、コンポーネント セットは形成されません。 ライター MyWriter がバックアップまたは復元されるたびに、これら 2 つのコンポーネントを 操作に明示的に含める 必要があります。
コンポーネント "LicenseInfo" は、先祖も子孫も選択できません。 これは、リクエスターの裁量により、バックアップ操作または復元操作に明示的に含まれるか、含めないようにすることができます。
コンポーネント "Security" は、その下にコンポーネント セットを含まない単純なコンポーネント セットを定義します。
コンポーネント "writerData" はコンポーネント セットを定義します。コンポーネント セットの下には、いくつかの明確に定義された論理パス階層を持つコンポーネントの複雑なコレクションが含まれています。
サブコンポーネント "Usage" の 1 つが選択可能で、コンポーネント セットを定義します。
複数のコンポーネントは同じ名前を持ち、論理パスによって区別されます。 選択できないコンポーネント "Dec" と "Jan" のインスタンスは、選択できないコンポーネント "Set1" と "Set2" の下、および選択可能なサブコンポーネント "Usage" の下に存在します。
コンポーネント "writerData" が明示的にバックアップまたは復元に含まれている場合、"Usage" で定義された入れ子になったコンポーネント セット内のサブコンポーネントであっても、そのサブコンポーネントはすべて暗黙的に操作に含まれます。
"writerData" によって定義されたコンポーネント セットがバックアップまたは復元に明示的に含まれていない場合、コンポーネント "Set1"、"Set2"、および "QueryLogs" (およびサブコンポーネント "Dec" と "Jan" のインスタンス) は、バックアップまたは復元操作に暗黙的に含まれません。
ただし、"writerData" が操作に含まれていない場合でも、コンポーネント "Usage" は選択可能であり、バックアップまたは復元操作に明示的に含めることができます。 その場合、そのサブコンポーネント "Jan" と "Dec" が暗黙的に含まれます。
その他の注意すべき点:
- 選択可能なコンポーネント "LicenseInfo" と "writerData" と選択できないコンポーネント "実行可能ファイル" はすべて 、MyWriter の論理パス階層で同じレベルにあります。すべての論理パスは NULL または ""、ルート論理パスは同じです。
- 選択可能な親 ("writerData") がバックアップまたは復元操作に明示的に含まれている場合は、選択可能なコンポーネント "Usage" をバックアップに明示的に含めてはいけません。
- コンポーネント セットを定義するコンポーネントは、組織上の理由だけで存在する可能性があります。 たとえば、"writerData" コンポーネントまたは "Usage" コンポーネント、またはその両方が空の場合があります。つまり、IVssCreateWriterMetadata::AddFilesToFileGroup、IVssCreateWriterMetadata::AddDatabaseFiles、または IVssCreateWriterMetadata::AddDatabaseLogFiles メソッドを使用してファイル セットが追加されませんでした。 コンポーネントは引き続きコンポーネント セットを定義します。