テーブルおよび列に対するセマンティック検索の有効化

[アーティクル]
08/10/2023

適用対象:SQL Server

ドキュメントまたはテキストが格納されている選択した列に対して統計的セマンティックインデックス作成を有効または無効にする方法について説明します。

統計的セマンティック検索では、フルテキスト検索によって作成されたインデックスを使用し、追加のインデックスを作成します。このフルテキスト検索に対する依存関係があるため、新しいフルテキストインデックスの定義や既存のフルテキストインデックスの変更の際には、新しいセマンティックインデックスを作成します。新しいセマンティックインデックスは、この記事で説明されているように、Transact-SQL ステートメントを使用するか、SQL Server Management Studio のフルテキストインデックス作成ウィザードやその他のダイアログボックスを使用して作成できます。

セマンティックインデックスを作成する

セマンティックインデックスの作成の要件と制限

インデックスは、フルテキストインデックス作成でサポートされる、テーブルおよびインデックス付きビューを含むいずれかのデータベースオブジェクトに作成できます。
特定の列のセマンティックインデックス作成を有効にするには、次の前提条件が満たされている必要があります。
- データベースのフルテキストカタログが存在する。
- テーブルにフルテキストインデックスがある。
- 選択された列がフルテキストインデックスに含まれている。
これらのすべての要件は、同時に作成および有効化することができます。
セマンティックインデックスは、フルテキストインデックス作成でサポートされるいずれかのデータ型の列に作成できます。詳細については、「フルテキストインデックスの作成と管理」をご覧ください。
varbinary(max) 列のフルテキストインデックス作成でサポートされるいずれかのドキュメントの種類を指定できます。詳細については、この記事の「方法: どのドキュメントの種類でインデックス作成ができるかを判断する」を参照してください。
セマンティックインデックス作成では、選択した列に対し、キーフレーズのインデックスとドキュメントの類似性のインデックスの 2 種類のインデックスが作成されます。セマンティックインデックス作成を有効にするときに 1 種類のインデックスだけを選択することはできません。ただし、これらの 2 つのインデックスに対するクエリは別々に実行できます。詳細については、「セマンティック検索を使用したドキュメント内のキーフレーズの検索」および「セマンティック検索による類似および関連したドキュメントの検索」をご覧ください。
セマンティックインデックスの LCID を明示的に指定しない場合、セマンティックインデックス作成には主言語とそれに関連する言語統計のみが使用されます。
言語モデルを使用できない列に対して言語を指定した場合、インデックスの作成は失敗し、エラーメッセージが返されます。

フルテキストインデックスがない場合のセマンティックインデックスの作成

CREATE FULLTEXT INDEX ステートメントを使用して新しいフルテキストインデックスを作成する場合、列定義の一部としてキーワード STATISTICAL_SEMANTICS を指定することで、列レベルでセマンティックインデックス作成を有効にすることができます。また、フルテキストインデックス作成ウィザードを使用して新しいフルテキストインデックスを作成するときにセマンティックインデックス作成を有効にすることもできます。

Transact-SQL を使用して新しいセマンティックインデックスを作成する

CREATE FULLTEXT INDEX ステートメントを呼び出し、セマンティックインデックスを作成する列ごとに STATISTICAL_SEMANTICS を指定します。このステートメントのすべてのオプションの詳細については、「CREATE FULLTEXT INDEX (Transact-SQL)」をご覧ください。

例 1: 一意のインデックス、フルテキストインデックス、およびセマンティックインデックスを作成する

次の例では、既定のフルテキストカタログ、ft を作成します。例では、AdventureWorks2022 サンプルデータベースの HumanResources.JobCandidate テーブルの JobCandidateID 列に一意のインデックスを作成します。この一意のインデックスは、フルテキストインデックスのキー列として必要です。次に、Resume 列にフルテキストインデックスとセマンティックインデックスを作成します。

CREATE FULLTEXT CATALOG ft AS DEFAULT
GO

CREATE UNIQUE INDEX ui_ukJobCand
    ON HumanResources.JobCandidate(JobCandidateID)
GO

CREATE FULLTEXT INDEX ON HumanResources.JobCandidate
    (Resume
        Language 1033
        Statistical_Semantics
    )
    KEY INDEX JobCandidateID
    WITH STOPLIST = SYSTEM
GO

例 2: インデックスの作成を遅延させて、いくつかの列でフルテキストインデックスとセマンティックインデックスを作成する

次の例では、documents_catalog サンプルデータベースにフルテキストカタログ、AdventureWorks2022 を作成します。その後、この新しいカタログを使用するフルテキストインデックスを作成します。フルテキストインデックスはテーブル Production.Document の Title、DocumentSummary、Document 列に作成されますが、セマンティックインデックスは Document 列にのみ作成されます。このフルテキストインデックスは、新たに作成されたフルテキストカタログおよび既存の一意なキーインデックス、PK_Document_DocumentID を使用します。推奨されているように、このインデックスキーは整数列、DocumentID で作成されます。この例では、列のデータの言語である英語の LCID、1033 を指定します。

さらに、この例では、変更の追跡が OFF で、NO POPULATION を指定しています。代わりに、ALTER FULLTEXT INDEX ステートメントを指定して、後のピークタイム以外の時間に新しいインデックスの完全作成を開始し、自動変更追跡を有効にしています。

CREATE FULLTEXT CATALOG documents_catalog
GO

CREATE FULLTEXT INDEX ON Production.Document
    (
    Title
        Language 1033,
    DocumentSummary
        Language 1033,
    Document
        TYPE COLUMN FileExtension
        Language 1033
        Statistical_Semantics
    )
    KEY INDEX PK_Document_DocumentID
        ON documents_catalog
        WITH CHANGE_TRACKING OFF, NO POPULATION
GO

後のピークタイム以外の時間にインデックスを作成

ALTER FULLTEXT INDEX ON Production.Document SET CHANGE_TRACKING AUTO
GO

SQL Server Management Studio を使用して新しいセマンティックインデックスを作成する

フルテキストインデックス作成ウィザードを実行し、セマンティックインデックスを作成するそれぞれの列に対し [テーブル列の選択] ページで [統計的セマンティクス] を有効にします。フルテキストインデックス作成ウィザードの起動方法などの詳細については、「フルテキストインデックス作成ウィザードの使用」をご覧ください。

既存のフルテキストインデックスがある場合のセマンティックインデックスの作成

ALTER FULLTEXT INDEX ステートメントを使用して既存のフルテキストインデックスを変更するとき、セマンティックインデックス作成を追加できます。 SQL Server Management Studio のさまざまなダイアログボックスを使用して、セマンティックインデックス作成を追加することもできます。

Transact-SQL を使用してセマンティックインデックスを追加する

セマンティックインデックスを追加する列ごとに、次のセクションで説明するオプションを使用して ALTER FULLTEXT INDEX ステートメントを呼び出します。このステートメントのすべてのオプションの詳細については、「ALTER FULLTEXT INDEX (Transact-SQL)」をご覧ください。

特に指定しない限り、フルテキストインデックスとセマンティックインデックスのどちらも ALTER 呼び出しの後に再作成されます。

フルテキストインデックス作成のみを列に追加するには、ADD 構文を使用します。
フルテキストインデックスとセマンティックインデックスの両方を列に追加するには、STATISTICAL_SEMANTICS オプションを指定した ADD 構文を使用します。
フルテキストインデックス作成が既に有効になっている列にセマンティックインデックス作成を追加するには、ADD STATISTICAL_SEMANTICS オプションを使用します。 1 つの ALTER ステートメントでは 1 つの列にのみセマンティックインデックス作成を追加できます。

例: フルテキストインデックス作成が既に存在する列にセマンティックインデックス作成を追加する

次の例では、AdventureWorks2022 サンプルデータベースの Production.Document テーブルの既存のフルテキストインデックスを変更します。この例では、既にフルテキストインデックスがある Production.Document テーブルの Document 列にセマンティックインデックスを追加します。この例では、インデックスが自動的に再作成されないように指定します。

ALTER FULLTEXT INDEX ON Production.Document
    ALTER COLUMN Document
        ADD Statistical_Semantics
    WITH NO POPULATION
GO

SQL Server Management Studio を使用してセマンティックインデックスを追加する

[フルテキストインデックスのプロパティ] ダイアログボックスの [フルテキストインデックスの列] ページで、セマンティックインデックス作成とフルテキストインデックス作成が有効な列を変更できます。詳細については、「フルテキストインデックスの管理」をご覧ください。

セマンティックインデックスを変更する

既存のインデックスを変更するための要件と制限

インデックスの作成の進行中は既存のインデックスを変更できません。インデックスの作成の進行状況を監視する方法の詳細については、「セマンティクス検索の管理および監視」をご覧ください。
インデックス作成を列に追加する操作とこの列のインデックス作成を変更または削除する操作を ALTER FULLTEXT INDEX ステートメントの 1 回の呼び出しで行うことはできません。

セマンティックインデックスを削除する

ALTER FULLTEXT INDEX ステートメントを使用して既存のフルテキストインデックスを変更するとき、セマンティックインデックス作成を削除できます。 SQL Server Management Studio のさまざまなダイアログボックスを使用して、セマンティックインデックス作成を削除することもできます。

Transact-SQL を使用してセマンティックインデックスを削除する

セマンティックインデックス作成を列または列からのみ削除するには、ALTER COLUMN <column_name> DROP STATISTICAL_SEMANTICS オプションを指定して ALTER FULLTEXT INDEX ステートメントを呼び出します。 1 つの ALTER ステートメントを使用して複数の列からインデックス作成を削除できます。

USE database_name;
GO

ALTER FULLTEXT INDEX
    ALTER COLUMN column_name
    DROP STATISTICAL_SEMANTICS;
GO

フルテキストインデックスとセマンティックインデックスの両方を列から削除するには、ALTER COLUMN <column_name> DROP オプションを指定して ALTER FULLTEXT INDEX ステートメントを呼び出します。

USE database_name;
GO

ALTER FULLTEXT INDEX
    ALTER COLUMN column_name
    DROP;
GO

SQL Server Management Studio を使用してセマンティックインデックスを削除する

セマンティックインデックスの削除の要件と制限

セマンティックインデックス作成を保持しているときに列からフルテキストインデックス作成を削除することはできません。セマンティックインデックス作成は、ドキュメントの類似性の結果に関してフルテキストインデックス作成に依存します。
セマンティックインデックス作成が有効になっていたテーブルの最後の列からセマンティックインデックス作成を削除するときは、NO POPULATION オプションを指定できません。以前にインデックスが作成された結果を削除するには、インデックス作成サイクルが必要になります。

データベースオブジェクトでセマンティック検索が有効かどうかの確認

データベースに対してセマンティック検索が有効化されていますか?

DATABASEPROPERTYEX (Transact-SQL) メタデータ関数の IsFullTextEnabled プロパティのクエリを実行します。

1 の戻り値は、データベースで全文検索とセマンティック検索が有効であることを示します。 0 の戻り値が有効になっていないことを示します。

SELECT DATABASEPROPERTYEX('database_name', 'IsFullTextEnabled');
GO

テーブルに対してセマンティック検索が有効化されていますか?

OBJECTPROPERTYEX (Transact-SQL) メタデータ関数の TableFullTextSemanticExtraction プロパティをクエリします。

戻り値 1 は、テーブルに対してセマンティック検索が有効化されていることを示します。戻り値 0 は、セマンティック検索が有効化されていないことを示します。

SELECT OBJECTPROPERTYEX(OBJECT_ID('table_name'), 'TableFullTextSemanticExtraction')
GO

列に対してセマンティック検索が有効化されていますか?

特定の列に対して統計的セマンティック検索が有効化されているかどうかを確認するには、次の操作を実行します。

COLUMNPROPERTY (Transact-SQL) メタデータ関数の StatisticalSemantics プロパティのクエリを実行します。

戻り値 1 は、列に対してセマンティック検索が有効化されていることを示します。戻り値 0 は、セマンティック検索が有効化されていないことを示します。
```
SELECT COLUMNPROPERTY(OBJECT_ID('table_name'), 'column_name', 'StatisticalSemantics');
GO
```
フルテキストインデックスのカタログビュー sys.fulltext_index_columns (Transact-SQL) のクエリを実行します。

statistical_semantics 列の値 1 は、指定された列に対してフルテキストインデックス作成とセマンティックインデックス作成が有効になっていることを示します。
```
SELECT * FROM sys.fulltext_index_columns
WHERE object_id = OBJECT_ID('table_name');
GO
```
Management Studio のオブジェクトエクスプローラーで、列を右クリックし、[プロパティ] を選びます。 [列のプロパティ] ダイアログボックスの [全般] ページで、 [統計的セマンティクス] プロパティの値を確認します。

値 True は、指定された列に対してフルテキストインデックス作成とセマンティックインデックス作成が有効になっていることを示します。

セマンティック検索用にインデックスを作成できる対象を確認する

セマンティック検索でサポートされている言語を確認する

セマンティックインデックス作成は、フルテキストインデックス作成ほどサポートされている言語が多くありません。このため、フルテキスト検索用にインデックスを作成できる一方でセマンティック検索用にはインデックスを作成できない列が存在する場合があります。

カタログビュー sys.fulltext_semantic_languages (Transact-SQL) のクエリを実行します。

SELECT * FROM sys.fulltext_semantic_languages;
GO

セマンティックインデックス作成でサポートされている言語は以下のとおりです。この一覧は、LCID の順に並べ替えたカタログビュー sys.fulltext_semantic_languages (Transact-SQL) の出力を表します。

言語	LCID
Traditional Chinese	1028
ドイツ語	1031
英語 (米国)	1033
フランス語	1036
イタリア語	1040
Brazilian	1046
ロシア語	1049
スウェーデン語	1053
簡体中国語	2052
英語 (U.K.)	2057
ポルトガル語	2070
中国語 (中華人民共和国香港特別行政区)	2070
スペイン語	3082
中国語 (シンガポール)	4100
中国語 (中華人民共和国マカオ特別行政区)	5124

注意

結果が空の場合は、セマンティック言語統計データベースをダウンロードしてインストールする必要があります。詳細については、「セマンティック言語統計データベースのインストール、アタッチ、および登録」を参照してください。

どのドキュメントの種類でインデックス作成ができるかを判断する

カタログビュー sys.fulltext_document_types (Transact-SQL) のクエリを実行します。

インデックスの対象とするドキュメントの種類が、サポートされている種類の一覧に含まれていない場合は、追加のフィルターを探してダウンロードし、インストールしなければならない場合があります。詳細については、「登録済みのフィルターおよびワードブレーカーの表示または変更」を参照してください。

ベストプラクティス: フルテキストおよびセマンティックインデックスに対して別のファイルグループの作成します。

ディスク領域の割り当てが問題となる場合は、フルテキストインデックスとセマンティックインデックスに対して別個のファイルグループを作成することを検討してください。セマンティックインデックスは、フルテキストインデックスと同じファイルグループに作成されます。完全に作成されたセマンティックインデックスには大量のデータが含まれる可能性があります。

問題点: 特定の列の検索で結果が返されない

Unicode 以外の LCID が Unicode 言語に指定されていませんか。

Unicode の語のみを含む言語の LCID (たとえば、ロシア語の LCID 1049) を持つ非 Unicode 列型に対してセマンティックインデックス作成を有効にすることができます。この場合、この列のセマンティックインデックスから結果が返されることはありません。

テーブルおよび列に対するセマンティック検索の有効化

セマンティックインデックスを作成する

セマンティックインデックスの作成の要件と制限

フルテキストインデックスがない場合のセマンティックインデックスの作成

Transact-SQL を使用して新しいセマンティックインデックスを作成する

例 1: 一意のインデックス、フルテキストインデックス、およびセマンティックインデックスを作成する

例 2: インデックスの作成を遅延させて、いくつかの列でフルテキストインデックスとセマンティックインデックスを作成する

SQL Server Management Studio を使用して新しいセマンティックインデックスを作成する

既存のフルテキストインデックスがある場合のセマンティックインデックスの作成

Transact-SQL を使用してセマンティックインデックスを追加する

例: フルテキストインデックス作成が既に存在する列にセマンティックインデックス作成を追加する

SQL Server Management Studio を使用してセマンティックインデックスを追加する

セマンティックインデックスを変更する

既存のインデックスを変更するための要件と制限

セマンティックインデックスを削除する

Transact-SQL を使用してセマンティックインデックスを削除する

SQL Server Management Studio を使用してセマンティックインデックスを削除する

セマンティックインデックスの削除の要件と制限

データベースオブジェクトでセマンティック検索が有効かどうかの確認

データベースに対してセマンティック検索が有効化されていますか?

テーブルに対してセマンティック検索が有効化されていますか?

列に対してセマンティック検索が有効化されていますか?

セマンティック検索用にインデックスを作成できる対象を確認する

セマンティック検索でサポートされている言語を確認する

どのドキュメントの種類でインデックス作成ができるかを判断する

ベストプラクティス: フルテキストおよびセマンティックインデックスに対して別のファイルグループの作成します。

問題点: 特定の列の検索で結果が返されない

Unicode 以外の LCID が Unicode 言語に指定されていませんか。

フィードバック

フィードバック

その他のリソース

テーブルおよび列に対するセマンティック検索の有効化

セマンティック インデックスを作成する

セマンティック インデックスの作成の要件と制限

フルテキスト インデックスがない場合のセマンティック インデックスの作成

Transact-SQL を使用して新しいセマンティック インデックスを作成する

例 1: 一意のインデックス、フルテキスト インデックス、およびセマンティック インデックスを作成する

例 2: インデックスの作成を遅延させて、いくつかの列でフルテキスト インデックスとセマンティック インデックスを作成する

SQL Server Management Studio を使用して新しいセマンティック インデックスを作成する

既存のフルテキスト インデックスがある場合のセマンティック インデックスの作成

Transact-SQL を使用してセマンティック インデックスを追加する

例: フルテキスト インデックス作成が既に存在する列にセマンティック インデックス作成を追加する

SQL Server Management Studio を使用してセマンティック インデックスを追加する

セマンティック インデックスを変更する

既存のインデックスを変更するための要件と制限

セマンティック インデックスを削除する

Transact-SQL を使用してセマンティック インデックスを削除する

SQL Server Management Studio を使用してセマンティック インデックスを削除する

セマンティック インデックスの削除の要件と制限

データベース オブジェクトでセマンティック検索が有効かどうかの確認

データベースに対してセマンティック検索が有効化されていますか?

テーブルに対してセマンティック検索が有効化されていますか?

列に対してセマンティック検索が有効化されていますか?

セマンティック検索用にインデックスを作成できる対象を確認する

セマンティック検索でサポートされている言語を確認する

どのドキュメントの種類でインデックス作成ができるかを判断する

ベスト プラクティス: フルテキストおよびセマンティック インデックスに対して別のファイル グループの作成します。

問題点: 特定の列の検索で結果が返されない

Unicode 以外の LCID が Unicode 言語に指定されていませんか。

フィードバック

フィードバック

その他のリソース

セマンティックインデックスを作成する

セマンティックインデックスの作成の要件と制限

フルテキストインデックスがない場合のセマンティックインデックスの作成

Transact-SQL を使用して新しいセマンティックインデックスを作成する

例 1: 一意のインデックス、フルテキストインデックス、およびセマンティックインデックスを作成する

例 2: インデックスの作成を遅延させて、いくつかの列でフルテキストインデックスとセマンティックインデックスを作成する

SQL Server Management Studio を使用して新しいセマンティックインデックスを作成する

既存のフルテキストインデックスがある場合のセマンティックインデックスの作成

Transact-SQL を使用してセマンティックインデックスを追加する

例: フルテキストインデックス作成が既に存在する列にセマンティックインデックス作成を追加する

SQL Server Management Studio を使用してセマンティックインデックスを追加する

セマンティックインデックスを変更する

セマンティックインデックスを削除する

Transact-SQL を使用してセマンティックインデックスを削除する

SQL Server Management Studio を使用してセマンティックインデックスを削除する

セマンティックインデックスの削除の要件と制限

データベースオブジェクトでセマンティック検索が有効かどうかの確認

ベストプラクティス: フルテキストおよびセマンティックインデックスに対して別のファイルグループの作成します。