GroupDocs.Redaction を使用した .NET の検索インデックス作成: エイリアスのインデックス作成と管理による安全な文書管理

大量の文書を管理しながら機密情報を保護することは困難です。GroupDocs.Redaction for .NET を使用すると、create search index .NET プロジェクトで文書コレクションを効率的に赤字化および検索できます。このチュートリアルでは、Aspose.Search.NET を使用したインデックスの作成またはオープン、インデックスへの文書追加、エイリアス辞書の管理、赤字化機能の統合について説明します—すべてデータセキュリティを厳守しながら行います。

クイック回答

  • このガイドの主な目的は何ですか？ create search index .NET プロジェクトの作成方法、インデックスへの文書追加方法、GroupDocs.Redaction を使用したエイリアスの管理方法を示します。
  • 必要なライブラリはどれですか？ GroupDocs.Redaction と Aspose.Search.NET、どちらも NuGet で入手可能です。
  • ライセンスは必要ですか？ 無料トライアルで評価できますが、本番環境ではフルライセンスが必要です。
  • 大量の文書セットを扱えますか？ はい。両ライブラリは、ファイル全体をメモリに読み込まずに数百ページのファイルを処理できます。
  • このソリューションは .NET‑Core と互換性がありますか？ もちろんです。 .NET 5、.NET 6、以降のバージョンで動作します。

はじめに

本題に入る前に、creating a search index .NET ソリューションが重要な理由を明確にしましょう。インデックスを使用すると、数千のファイルから正確なフレーズ、パターン、または赤字化されたコンテンツをミリ秒単位で検索でき、コンプライアンスレビュー、法的ディスカバリー、内部監査を劇的に高速化します。Aspose.Search.NET の強力なインデックスエンジンと GroupDocs.Redaction の堅牢な赤字化ツールを組み合わせることで、データを保護しながら瞬時に検索できる単一パイプラインが得られます。

GroupDocs.Redaction for .NET とは？

GroupDocs.Redaction for .NET は、PDF、DOCX、PPTX、HTML など 30 以上の文書形式に対して、テキスト、画像、メタデータのプログラムによる赤字化を可能にするライブラリです。ファイル全体を RAM に読み込まずに最大 2 GB のファイルを処理でき、エンタープライズワークロードでの高性能な操作を実現します。

なぜ Aspose.Search.NET を使用して .NET の検索インデックスを作成するのか？

Aspose.Search.NET は 50+ のファイルタイプをインデックス化でき、インクリメンタル更新をサポートします。つまり、既存のインデックスに新しいファイルを追加でき、ゼロから再構築する必要がありません。これにより、フル再インデックスに比べて CPU 使用率が最大 70 % 削減され、500 k+ 文書を含むインデックスでもクエリ応答時間は 200 ms 未満に保たれます。

前提条件

必要なライブラリ、バージョン、依存関係

  • GroupDocs.Redaction – 最新の NuGet リリース、.NET 5/6/7 と互換性あり。
  • Aspose.Search.NET – 最新の NuGet リリース、.NET Standard 2.0+ と .NET Core をサポート。

両ライブラリはバインディングの競合を防ぐため、同じ .NET ランタイムバージョンを対象にする必要があります。

環境設定要件

  • Visual Studio 2022（または .NET 6+ をサポートする任意の IDE）。
  • インデックス作成および赤字化したい文書が入っているフォルダーへのアクセス。

知識の前提条件

  • C# の構文と .NET プロジェクト構造に慣れていること。
  • インデックス作成、検索、文書赤字化の基本概念。

検索インデックス .NET を作成する方法は？

Index オブジェクトをロードまたはインスタンス化し、フォルダーを指し示して CreateOrOpen を呼び出します。この単一の手順でディスク上の検索可能ストアが作成または再オープンされます。操作はデフォルトでバックグラウンドスレッドで実行されるため、数千ファイルのインデックス作成中でも UI が応答し続けます。

Index はディスク上に保存された検索可能なコレクションを表します。

定義アンカー

Index クラスは Aspose.Search.NET のコアコンポーネントで、ディスク上の文書検索可能コレクションを表します。すべてのインデックス作成およびクエリ操作はこのオブジェクトを通じて行われます。

dotnet add package GroupDocs.Redaction

インデックスに文書を追加する方法は？

AddDocument はファイルをインデックスに追加し、検索可能なコンテンツを抽出します。

各ファイルパスに対して Index.AddDocument を呼び出すことで文書を追加します。このメソッドはテキスト、メタデータ、オプションの OCR コンテンツを自動的に抽出します。foreach ループでファイルをバッチ追加でき、インデックスは既存エントリを再構築せずにインクリメンタルに更新されます。プロセスは成功またはエラーを示すステータスオブジェクトを返すため、プログラムで失敗を処理できます。

Install-Package GroupDocs.Redaction

ライセンス取得手順

  • Free Trial – 30 日間無料で全機能を試せます。
  • Temporary License – 期間限定キーを使用して拡張テストが可能です。
  • Full License – 本番導入に必要で、評価制限がすべて解除されます。

インストール後、以下のように GroupDocs.Redaction を初期化します：

using GroupDocs.Redaction;
RedactorSettings settings = new RedactorSettings();
// Set up additional configuration as needed

実装ガイド

実装を機能別に分割して、管理しやすいセクションに分けて説明します。

インデックスの作成またはオープン

概要

検索インデックスの作成またはオープンは、効率的な文書管理と検索の基礎です。これにより、インデックス化されたデータを迅速に操作できます。

手順別ガイド

1. インデックスの作成/オープン

using GroupDocs.Search;

// Specify the directory where your index will be stored
string indexPath = "YOUR_INDEX_DIRECTORY";

// Initialize or open an existing index
Index index = new Index(indexPath);

// Explanation: The Index object is initialized with a directory path,
// which serves as a storage location for all indexed data.

2. インデックスに文書を追加

using GroupDocs.Search;

// Specify your document directory
string docPath = "YOUR_DOCUMENT_DIRECTORY";

// Add documents from the specified directory to the index
index.Add(docPath);

// Explanation: The Add method indexes all documents within the provided path,
// making them searchable.

エイリアス辞書の管理

概要

エイリアス辞書のエイリアスは、複雑な検索クエリの短縮語を定義でき、検索効率と可読性を向上させます。

手順別ガイド

1. 既存のエイリアスをクリア

using GroupDocs.Search.Dictionaries;

// Check if there are existing aliases and clear them
if (index.Dictionaries.AliasDictionary.Count > 0)
{
    index.Dictionaries.AliasDictionary.Clear();
}

// Explanation: This ensures you start with a clean slate when managing aliases.

2. 単一エイリアスエントリを追加

index.Dictionaries.AliasDictionary.Add("t", "(gravida OR promotion)");
index.Dictionaries.AliasDictionary.Add("e", "(viverra OR farther)");

// Explanation: Each alias is mapped to an expression that defines its search scope.

3. 配列を使用して複数エイリアスを追加

AliasReplacementPair[] pairs = new AliasReplacementPair[]
{
    new AliasReplacementPair("d", "daterange(2017-01-01 ~~ 2019-12-31)"),
    new AliasReplacementPair("n", "(400 ~~ 4000)")
};

index.Dictionaries.AliasDictionary.AddRange(pairs);

// Explanation: AddRange allows bulk addition of aliases, streamlining the setup process.

エイリアスの取得とエクスポート

概要

エイリアス辞書をファイルにエクスポートすると、チームや環境間で検索語彙を共有できます。また、特定エントリを取得することでクエリロジックの検証が可能です。

エイリアスの取得

if (index.Dictionaries.AliasDictionary.Contains("e"))
{
    string replacement = index.Dictionaries.AliasDictionary.GetText("e");
}

// Explanation: Use Contains to check existence before retrieval.

エイリアスのエクスポート

string exportPath = "YOUR_OUTPUT_DIRECTORY/Aliases.dat";
index.Dictionaries.AliasDictionary.ExportDictionary(exportPath);

// Explanation: ExportDictionary saves the alias dictionary for future use or sharing.

エイリアスのインポートとエイリアス辞書での検索

概要

ファイルからエイリアスをインポートして、事前定義された短縮語を使用した検索操作を効率化し、エイリアスを参照するクエリを実行します。

1. エイリアスのインポート

string importPath = "YOUR_OUTPUT_DIRECTORY/Aliases.dat";
index.Dictionaries.AliasDictionary.ImportDictionary(importPath);

// Explanation: This method loads existing alias definitions into the dictionary.

2. エイリアスを使用した検索

string query = "@t OR @e"; // Use aliases in your search query
SearchResult result = index.Search(query);

// Explanation: Leverage aliases to perform complex searches with simple queries.

よくある問題と解決策

  • インデックスパスエラー – フォルダー パスが絶対パスであり、アプリケーションに読み書き権限があることを確認してください。
  • メモリリーク – 特に長時間実行するサービスでは、使用後に必ず Index オブジェクトの Dispose() を呼び出してください。
  • エイリアスが認識されない – エイリアスファイルが UTF‑8 エンコードであること、各行が key=value 形式になっていることを確認してください。

よくある質問

Q: このソリューションは .NET Core で使用できますか？
A: はい、GroupDocs.Redaction と Aspose.Search.NET はすべて .NET Core 3.1、.NET 5、.NET 6、以降を完全にサポートしています。

Q: インデックスは何件の文書を扱えますか？
A: エンジンは 100 万件以上の文書を含むインデックスでテストされており、標準サーバーハードウェア上でサブ秒レベルのクエリ時間を維持します。

Q: エイリアスは正規表現をサポートしていますか？
A: エイリアスはワイルドカード文字（* と ?）を含められますが、完全な正規表現パターンはサポートしていません。複雑なパターンはプログラムでクエリを構築してください。

Q: 検索後に赤字化することは可能ですか？
A: もちろん可能です。検索結果から文書 ID を取得し、GroupDocs.Redaction でロードして赤字化ルールを適用し、保護されたバージョンとして保存します。

Q: 大規模企業向けのライセンスモデルは何ですか？
A: GroupDocs は無制限の開発者とデプロイサイトを含むボリュームベースのライセンスを提供しています。カスタム見積もりは営業にお問い合わせください。

結論

GroupDocs.Redaction と Aspose.Search.NET を統合して create search index .NET ソリューションを構築することで、文書のセキュリティ、コンプライアンス、検索性を劇的に向上させられます。インデックスの構築、インデックスへの文書追加、エイリアス辞書の管理、赤字化ルールの適用が、すべて単一の高性能 .NET アプリケーション内で行えるようになりました。

次のステップは？ コードスニペットをテストプロジェクトに実装し、カスタムエイリアスパターンを試し、実運用データセットでインデックス作成速度をベンチマークしてください。

最終更新日: 2026-07-02
テスト環境: GroupDocs.Redaction 23.10 for .NET, Aspose.Search.NET 24.5
著者: GroupDocs

関連チュートリアル