CREATE FULLTEXT INDEX (Transact-SQL)

[アーティクル]
07/28/2023

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance

SQL Server のデータベース内のテーブルまたはインデックス付きビューで、フルテキストインデックスを作成します。テーブルまたはインデックス付きビューごとに 1 つのフルテキストインデックスのみ使用でき、各フルテキストインデックスは 1 つのテーブルまたはインデックス付きビューに適用されます。フルテキストインデックスには、1,024 列まで格納できます。

Transact-SQL 構文表記規則

構文

CREATE FULLTEXT INDEX ON table_name
   [ ( { column_name
             [ TYPE COLUMN type_column_name ]
             [ LANGUAGE language_term ]
             [ STATISTICAL_SEMANTICS ]
        } [ , ...n ]
      ) ]
    KEY INDEX index_name
    [ ON <catalog_filegroup_option> ]
    [ WITH ( <with_option> [ , ...n ] ) ]
[;]

<catalog_filegroup_option>::=
 {
    fulltext_catalog_name
 | ( fulltext_catalog_name , FILEGROUP filegroup_name )
 | ( FILEGROUP filegroup_name , fulltext_catalog_name )
 | ( FILEGROUP filegroup_name )
 }

<with_option>::=
 {
   CHANGE_TRACKING [ = ] { MANUAL | AUTO | OFF [ , NO POPULATION ] }
 | STOPLIST [ = ] { OFF | SYSTEM | stoplist_name }
 | SEARCH PROPERTY LIST [ = ] property_list_name
 }

引数

table_name

フルテキストインデックスに含まれている列を格納するテーブルまたはインデックス付きビューの名前。

column_name

フルテキストインデックスに含める列の名前。フルテキスト検索用にインデックスを作成できるのは、型が char、varchar、nchar、nvarchar、text、ntext、image、xml、varbinary(max) の列だけです。複数の列を指定するには、次のように column_name 句を繰り返します。

CREATE FULLTEXT INDEX ON table_name (column_name1 [...], column_name2 [...]) ...

TYPE COLUMN type_column_name

varbinary(max) または image ドキュメントのドキュメント型を保持するために使用されているテーブル列 type_column_name の名前を指定します。型列と呼ばれるこの列には、ユーザー指定のファイル拡張子 (.doc、.pdf、.xls など) が格納されます。型列は、 char型、 nchar型、 varchar型、 nvarchar型にする必要があります。

TYPE COLUMN type_column_name を指定できるのは、column_name で、データがバイナリデータとして格納される varbinary(max) または image 列を指定した場合のみです。それ以外の場合、SQL Server ではエラーが返されます。

注意

Full-Text Engine は、インデックスを作成する際に、各テーブル行の型列の省略形を使用して、column_name でドキュメントに使用するフルテキスト検索フィルターを特定します。フィルターはドキュメントをバイナリストリームとして読み込み、書式設定情報を削除し、ドキュメントからワードブレーカーコンポーネントへテキストを送信します。詳細については、「検索用フィルターの構成と管理」を参照してください。

LANGUAGE language_term

column_name に格納されているデータの言語。

language_term は省略可能で、言語のロケール識別子 (LCID) に対応する文字列、整数、または 16 進数の値を指定できます。値を指定しなかった場合は、SQL Server インスタンスの既定の言語が使用されます。

language_term を指定すると、それが表す言語が、char、nchar、varchar、nvarchar、text、ntext 列のデータのインデックス付けに使われます。クエリ実行時に、列に対するフルテキスト述語の一部として language_term を指定しない場合は、ここで指定した言語がクエリでの既定の言語になります。

language_term を文字列で指定する場合は、sys.syslanguages システムテーブルの alias 列の値と同じ値を指定します。文字列の場合は、'language_term' のように引用符 (') で囲む必要があります。 language_term を整数で指定する場合は、その言語を表す実際の LCID を指定します。 language_term を 16 進数値で指定する場合は、[0x」の後に LCID の 16 進数値を指定します。 16 進数の値は、先頭の 0 を含め、8 桁以内で指定してください。

値を 2 バイト文字セット (DBCS) の形式で指定すると、SQL Server で Unicode に変換されます。

language_term で指定した言語に対しては、単語区切りや語幹検索などのリソースが有効になっている必要があります。指定した言語でこれらのリソースがサポートされていない場合、SQL Server はエラーを返します。

Microsoft SQL Server インスタンスの既定のフルテキスト言語に関する情報を取得するには、sp_configure ストアドプロシージャを使用します。詳細については、「sp_configure (Transact-SQL)」を参照してください。

列のデータ型が BLOB および XML 以外で、複数の言語のテキストデータが含まれている場合や、列に格納されているテキストの言語が不明な場合は、ニュートラル (0x0) 言語リソースを使用することもできます。ただしその前に、ニュートラル (0x0) 言語リソースを使用した場合にどのような結果が起こりうるのかを理解しておく必要があります。ニュートラル (0x0) 言語リソースの使用について考えられる解決策と起こりうる結果については、「フルテキストインデックス作成時の言語の選択」を参照してください。

データ型が XML または BLOB の列に格納されているドキュメントに対しては、そのドキュメントの言語のエンコードがインデックス作成時に使用されます。たとえば、データ型が XML の列では、XML ドキュメントのxml:lang 属性によって言語が識別されます。クエリ時には、フルテキストクエリ内で language_term を指定しない限り、前回 language_term に指定された値がフルテキストクエリの既定の言語になります。

STATISTICAL_SEMANTICS

適用対象: SQL Server (SQL Server 2012 (11.x) 以降)

キーフレーズを追加で作成し、統計的セマンティックインデックス作成の一部である類似性のインデックスを記録します。詳細については、「セマンティック検索 (SQL Server)」を参照してください。

KEY INDEX index_name

table_name の一意キーインデックスの名前。 KEY INDEX は、一意で、単一のキーを含む、NULL 値を許容しない列であることが必要です。フルテキストの一意キーには、一番小さな一意キーインデックスを選択します。最適なパフォーマンスが得られるように、フルテキストキーには整数データ型を使用することをお勧めします。

fulltext_catalog_name

フルテキストインデックスに使用するフルテキストカタログ。このカタログはデータベース内に存在する必要があります。この句は省略可能です。指定しない場合は、既定のカタログが使用されます。既定のカタログが存在しない場合、SQL Server ではエラーが返されます。

FILEGROUP filegroup_name

指定したファイルグループに、指定したフルテキストインデックスを作成します。ファイルグループは既に存在している必要があります。 FILEGROUP 句を指定しなかった場合、フルテキストインデックスは、非パーティションテーブルの場合にはベーステーブルまたはベースビューと同じファイルグループに、パーティションテーブルの場合にはプライマリファイルグループに配置されます。

CHANGE_TRACKING [ = ] { MANUAL | AUTO | OFF [ , NO POPULATION ] }

フルテキストインデックスの対象となるテーブル列の変更 (更新、削除、または挿入) が、SQL Server によってフルテキストインデックスに反映されるかどうかを指定します。 WRITETEXT および UPDATETEXT によるデータの変更は、フルテキストインデックスには反映されず、変更の監視でも取得されません。

MANUAL

追跡された変更の反映を ALTER FULLTEXT INDEX ... START UPDATE POPULATION Transact-SQL ステートメントの呼び出しによって手動で行う必要があること (手動作成) を指定します。 SQL Server エージェントを使用すると、この Transact-SQL ステートメントを定期的に呼び出すことができます。
AUTO

ベーステーブルでデータが変更されたときに、追跡された変更を自動的に反映すること (自動作成) を指定します。この場合、フルテキストインデックスに対して変更は自動的に反映されますが、反映までに少し時間がかかることがあります。 AUTO は既定値です。

OFF [ , NO POPULATION ]

SQL Server で、インデックスの対象となるデータに対して行われた変更の一覧を保持しません。 NO POPULATION を指定しない場合、SQL Server では、インデックスの作成後にインデックスへの値が完全に設定されます。

NO POPULATION オプションは、CHANGE_TRACKING が OFF の場合にだけ使用できます。 NO POPULATION を指定した場合、SQL Server ではインデックスの作成後、インデックスに対して値は設定されません。この場合、ユーザーが START FULL POPULATION 句または START INCREMENTAL POPULATION 句を指定して ALTER FULLTEXT INDEX コマンドを実行した後でなければ、インデックスは作成されません。

STOPLIST [ = ] { OFF | SYSTEM | stoplist_name }

フルテキストストップリストをインデックスに関連付けます。インデックスには、指定したストップリストの一部であるトークンは設定されません。 STOPLIST を指定しない場合、SQL Server によってシステムフルテキストストップリストがインデックスに関連付けられます。

OFF

フルテキストインデックスにストップリストを関連付けないことを指定します。
SYSTEM

このフルテキストインデックスに対して既定のフルテキストシステムストップリストを使用することを指定します。
stoplist_name

フルテキストインデックスに関連付けるストップリストの名前を指定します。

SEARCH PROPERTY LIST [ = ] property_list_name

適用対象: SQL Server (SQL Server 2012 (11.x) 以降)

検索プロパティリストとインデックスを関連付けます。

OFF

フルテキストインデックスにプロパティリストを関連付けないことを指定します。
property_list_name

フルテキストインデックスに関連付ける検索プロパティリストの名前を指定します。

解説

xml 列にフルテキストインデックスを作成して XML 要素のコンテンツにインデックスを設定できますが、XML マークアップは無視されます。属性値には、数値でない限り、フルテキストインデックスが設定されます。要素タグはトークンの境界として使用されます。複数言語を含む整形式の XML または HTML ドキュメントやフラグメントはサポートされます。詳細については、「 XML 列でのフルテキスト検索の使用」を参照してください。

インデックスキー列は整数データ型にすることをお勧めします。整数データ型にすると、クエリの実行が最適化されます。

CREATE FULLTEXT INDEX をユーザートランザクション内に配置することはできません。このステートメントは、独自の暗黙的なトランザクションで実行する必要があります。

フルテキストインデックスについて詳しくは、「フルテキストインデックスの作成と管理」をご覧ください。

変更の追跡と NO POPULATION パラメーターの相関関係

フルテキストインデックスが作成されるかどうかは、変更の追跡が有効になっているかどうかと、ALTER FULLTEXT INDEX ステートメントで WITH NO POPULATION が指定されているかどうかによって決まります。次の表は、その相関関係の結果をまとめたものです。

変更の追跡	WITH NO POPULATION	結果
有効ではない	指定なし	インデックスで完全作成が実行されます。
有効ではない	指定済み	ALTER FULLTEXT INDEX...START POPULATION ステートメントが実行されるまで、インデックスの作成は行われません。
Enabled	指定済み	エラーが発生し、インデックスは変更されません。
Enabled	指定なし	インデックスで完全作成が実行されます。

フルテキストインデックスの作成について詳しくは、「フルテキストインデックスの作成」をご覧ください。

アクセス許可

フルテキストカタログに対する REFERENCES 権限とテーブルまたはインデックス付きビューに対する ALTER 権限を持っているか、sysadmin 固定サーバーロール、db_owner 固定データベースロール、または db_ddladmin 固定データベースロールのメンバーであることが必要です。

SET STOPLIST を指定した場合は、ユーザーが指定のストップリストに対する REFERENCES 権限を持っている必要があります。ストップリストの所有者がこの権限を許可できます。

注意

一般のユーザーには、SQL Server に含まれる既定のストップリストに対する REFERENCE 権限が許可されています。

例

A. 一意のインデックス、フルテキストカタログ、およびフルテキストインデックスを作成する

次の例では、AdventureWorks2022 サンプルデータベースの HumanResources.JobCandidate テーブルの JobCandidateID 列に一意のインデックスを作成します。その後、既定のフルテキストカタログ、ft を作成します。そして最後に、Resume カタログおよびシステムストップリストを使用して ft 列にフルテキストインデックスを作成します。

CREATE UNIQUE INDEX ui_ukJobCand ON HumanResources.JobCandidate(JobCandidateID);
CREATE FULLTEXT CATALOG ft AS DEFAULT;
CREATE FULLTEXT INDEX ON HumanResources.JobCandidate(Resume)
   KEY INDEX ui_ukJobCand
   WITH STOPLIST = SYSTEM;
GO

B. 複数のテーブル列にフルテキストインデックスを作成する

次の例では、production_catalog サンプルデータベースにフルテキストカタログ、AdventureWorks を作成します。その後、この新しいカタログを使用するフルテキストインデックスを作成します。フルテキストインデックスは、Production.ProductReview の ReviewerName、EmailAddress、および Comments 列にあります。各列に、列のデータの言語である英語の LCID、1033 を指定します。このフルテキストインデックスは、既存の一意なキーインデックス、PK_ProductReview_ProductReviewID を使用します。推奨されているように、このインデックスキーは整数列、ProductReviewID にあります。

CREATE FULLTEXT CATALOG production_catalog;
GO

CREATE FULLTEXT INDEX ON Production.ProductReview (
    ReviewerName LANGUAGE 1033,
    EmailAddress LANGUAGE 1033,
    Comments LANGUAGE 1033
) KEY INDEX PK_ProductReview_ProductReviewID ON production_catalog;
GO

C: インデックスの値を設定せずに、検索プロパティリストのフルテキストインデックスを作成する

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

この例では、ストップリストとして SYSTEM を指定します。また、検索プロパティリストとして DocumentPropertyList も指定します。このプロパティリストを作成する例については、「CREATE SEARCH PROPERTY LIST (Transact-SQL)」を参照してください。

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

CREATE FULLTEXT INDEX ON Production.Document (
    Title LANGUAGE 1033,
    DocumentSummary LANGUAGE 1033,
    Document TYPE COLUMN FileExtension LANGUAGE 1033
) KEY INDEX PK_Document_DocumentID
WITH STOPLIST = SYSTEM,
    SEARCH PROPERTY LIST = DocumentPropertyList,
    CHANGE_TRACKING OFF,
    NO POPULATION;
GO

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

ALTER FULLTEXT INDEX ON Production.Document SET CHANGE_TRACKING AUTO;
GO

次の方法で共有

CREATE FULLTEXT INDEX (Transact-SQL)

構文

引数

table_name

column_name

TYPE COLUMN type_column_name

LANGUAGE language_term

STATISTICAL_SEMANTICS

KEY INDEX index_name

fulltext_catalog_name

FILEGROUP filegroup_name

CHANGE_TRACKING [ = ] { MANUAL | AUTO | OFF [ , NO POPULATION ] }

OFF [ , NO POPULATION ]

STOPLIST [ = ] { OFF | SYSTEM | stoplist_name }

SEARCH PROPERTY LIST [ = ] property_list_name

解説

変更の追跡と NO POPULATION パラメーターの相関関係

アクセス許可

例

A. 一意のインデックス、フルテキストカタログ、およびフルテキストインデックスを作成する

B. 複数のテーブル列にフルテキストインデックスを作成する

C: インデックスの値を設定せずに、検索プロパティリストのフルテキストインデックスを作成する

関連項目

フィードバック

その他のリソース

次の方法で共有

CREATE FULLTEXT INDEX (Transact-SQL)

構文

引数

table_name

column_name

TYPE COLUMN type_column_name

LANGUAGE language_term

STATISTICAL_SEMANTICS

KEY INDEX index_name

fulltext_catalog_name

FILEGROUP filegroup_name

CHANGE_TRACKING [ = ] { MANUAL | AUTO | OFF [ , NO POPULATION ] }

OFF [ , NO POPULATION ]

STOPLIST [ = ] { OFF | SYSTEM | stoplist_name }

SEARCH PROPERTY LIST [ = ] property_list_name

解説

変更の追跡と NO POPULATION パラメーターの相関関係

アクセス許可

例

A. 一意のインデックス、フルテキスト カタログ、およびフルテキスト インデックスを作成する

B. 複数のテーブル列にフルテキスト インデックスを作成する

C: インデックスの値を設定せずに、検索プロパティ リストのフルテキスト インデックスを作成する

関連項目

フィードバック

その他のリソース

A. 一意のインデックス、フルテキストカタログ、およびフルテキストインデックスを作成する

B. 複数のテーブル列にフルテキストインデックスを作成する

C: インデックスの値を設定せずに、検索プロパティリストのフルテキストインデックスを作成する