トークン化

PostgreSQL Interface に関する注意事項: このトピックの例は、GoogleSQL 言語データベースを対象としています。この機能は PostgreSQL Interface をサポートしていません。

注: この機能は、Spanner Enterprise エディションと Enterprise Plus エディションで利用できます。詳細については、Spanner エディションの概要をご覧ください。

このページでは、テーブルにトークン化を追加する方法について説明します。トークン化は、検索インデックスで使用されるトークンを作成するために必要です。

トークン化とは、値をトークンに変換するプロセスです。ドキュメントのトークン化に使用する方法によって、ユーザーがドキュメントに対して実行できる検索の種類と効率が決まります。

Spanner には、自然言語テキスト、サブストリング、文字列テキスト、数値、ブール値のトークン化ツールが用意されています。データベース スキーマは、列に必要な検索タイプに一致するトークン化ツールを使用します。トークン化ツールには次の特徴があります。

• 各トークン化ツールは、文字列や数値などの入力と、追加オプションの名前付き引数を取得する SQL 関数です。
• トークン化ツールは TOKENLIST を出力します。

たとえば、テキスト文字列 The quick brown fox jumps over the lazy dog は [the,quick,brown,fox,jumps,over,the,lazy,dog] にトークン化されます。HTML 文字列 The <b>apple</b> is <i>red</i> は [the,apple,is,red] にトークン化されます。

トークンには次の特徴があります。

• トークンは、TOKENLIST データ型を使用する列に保存されます。
• 各トークンは、関連する属性のセットをオプションで指定して、バイトのシーケンスとして保存されます。たとえば、全文検索アプリケーションでは、トークンは通常、テキスト ドキュメントの単一の単語です。
• HTML 値をトークン化するときに、Spanner はドキュメント内のトークンの重要度を示す属性を生成します。Spanner は、これらの属性を使用してスコアリングを行い、より目立つ用語（見出しなど）を強調します。

Tokenizers

Spanner は、次のトークン化関数をサポートしています。

• 全文トークン化ツール（TOKENIZE_FULLTEXT）は、自然言語クエリの単語全体のトークンを生成します。

  例

  次の両方の関数

  TOKENIZE_FULLTEXT("Yellow apple")
  TOKENIZE_FULLTEXT("Yellow <b>apple</b>", content_type=>"text/html")
  

  同じトークン（[yellow,apple]）を生成します。

• 部分文字列トークン化ツール（TOKENIZE_SUBSTRING）は、各単語の各 n-gram のトークンを生成します。テキスト内の単語の部分文字列を検索するために使用されます。

  例

  TOKENIZE_SUBSTRING("hello world", ngram_size_min=>4, ngram_size_max=>6)
  

  [ello,hell,hello,orld,worl,world] というトークンを生成します。

• N-gram トークン化ツール（TOKENIZE_NGRAMS）は、入力から n グラムを生成します（個別の単語に分割しません）。正規表現述語を高速化するために使用されます。

  例

  次の関数:

  TOKENIZE_NGRAMS("Big Time", ngram_size_min=>4, ngram_size_max=>4)
  

  ["Big ","ig T","g Ti"," Tim", "Time"] というトークンを生成します。

• 完全一致トークン化ツール（TOKEN と TOKENIZE_BOOL）は、列のいずれかに特定の値を含む行を検索するために使用されます。たとえば、商品カタログにインデックスを付けるアプリでは、特定のブランドと色の商品を検索する場合があります。

  例

  次の関数:

  TOKEN("hello")
  TOKEN(["hello", "world"])
  

  それぞれ [hello] と [hello,world] のトークンを生成します。

  次の関数:

  TOKENIZE_BOOL(true)
  

  [y] というトークンが生成されます。

• 数値トークン化ツール（TOKENIZE_NUMBER）は、数値比較検索を高速化する一連のトークンを生成するために使用されます。等価条件の場合、トークンは数値そのものです。範囲条件（rating >= 3.5 など）の場合、トークンのセットはより複雑になります。

  例

  次の関数ステートメント:

  TOKENIZE_NUMBER(42, comparison_type=>"equality")
  TOKENIZE_NUMBER(42, comparison_type=>"all", granularity=>10, min=>1, max=>100)
  

  "==42"、"==42"、"[1,75]"、"[36, 45]"、"[36,55]"、"[36, 75]" の各トークンを生成します。

トークン化関数は通常、生成された列式で使用されます。これらの列は HIDDEN として定義されているため、SELECT * クエリ結果には含まれません。

次の例では、全文トークンと数値トークンを使用して、音楽アルバムの名前と評価を格納するデータベースを作成します。DDL ステートメントは次の 2 つの処理を行います。

1. データ列 AlbumTitle と Rating を定義します。

2. AlbumTitle_Tokens と AlbumRating_Tokens を定義します。これらの TOKENLIST 列は、Spanner がインデックスを付けられるように、データ列の値をトークン化します。

   CREATE TABLE Albums (
     AlbumId STRING(MAX) NOT NULL,
     AlbumTitle STRING(MAX),
     Rating FLOAT64,
     AlbumTitle_Tokens TOKENLIST AS (TOKENIZE_FULLTEXT(AlbumTitle)) HIDDEN,
     Rating_Tokens TOKENLIST AS (TOKENIZE_NUMBER(Rating)) HIDDEN
   ) PRIMARY KEY(AlbumId);
   

ベース値が変更されるたびに、AlbumTitle_Tokens と Rating_Tokens が自動的に更新されます。

プレーン テキストまたは HTML コンテンツをトークン化する

テキストのトークン化は、プレーン テキストと HTML のコンテンツ タイプをサポートしています。Spanner の TOKENIZE_FULLTEXT 関数を使用してトークンを作成します。次に、CREATE SEARCH INDEX DDL ステートメントを使用して検索インデックスを生成します。

たとえば、次の CREATE TABLE DDL ステートメントでは、TOKENIZE_FULLTEXT 関数を使用して、Albums テーブルの AlbumTitles からトークンを作成します。CREATE SEARCH INDEX DDL ステートメントは、新しい AlbumTitles_Tokens を使用して検索インデックスを作成します。

CREATE TABLE Albums (
  AlbumId STRING(MAX) NOT NULL,
  AlbumTitle STRING(MAX),
  AlbumTitle_Tokens TOKENLIST AS (TOKENIZE_FULLTEXT(AlbumTitle)) HIDDEN
) PRIMARY KEY(AlbumId);

CREATE SEARCH INDEX AlbumsIndex ON Albums(AlbumTitle_Tokens)

トークン化プロセスでは、次のルールが使用されます。

• トークン化には、ステミングやスペルミスの修正は含まれません。たとえば、「猫が猫の群れを見つめていた」という文では、トークン「cat」はトークン「cats」とは別にインデックスに登録されます。書き込み時にトークンを正規化する他の検索エンジンとは異なり、Spanner には、検索クエリを拡張してさまざまな形式の単語を含めるオプションがあります。詳細については、拡張クエリモードをご覧ください。
• 検索インデックスには、一般的な単語（「a」など）が含まれています。
• 全文検索では、大文字と小文字は区別されません。トークン化プロセスでは、すべてのトークンが小文字に変換されます。

トークン化プロセスでは、元のテキスト内の各トークンの位置を追跡します。これらの位置は、後でフレーズを照合するために使用されます。位置は、ドキュメント ID とともに検索インデックスに保存されます。

Google はトークン化アルゴリズムの改善に継続的に取り組んでいます。場合によっては、今後、文字列が現在とは異なる方法でトークン化される可能性があります。このようなケースは非常にまれです。たとえば、中国語、日本語、韓国語（CJK）の言語セグメンテーションが改善された場合です。

content_type 引数には、コンテンツ形式でプレーンテキストと HTML のどちらを使用するかを指定します。次の設定を使用して content_type を設定します。

• テキスト トークン化の場合は、content_type 引数を「text/plain」に設定します。これはデフォルト設定です。
• HTML トークン化の場合は、content_type 引数を "text/html に設定します。この引数を指定しないと、HTML タグは句読点として扱われます。HTML モードでは、Spanner はヒューリスティクスを使用して、ページ上のテキストの視認性を推測します。たとえば、テキストがヘッダーに含まれているかどうか、フォントサイズなどです。HTML でサポートされている属性には、small、medium、large、title、link などがあります。位置情報と同様に、属性は検索インデックス内のトークンとともに保存されます。トークン化では、HTML タグのトークンは作成されません。

トークン属性は、SEARCH 関数または SEARCH_SUBSTRING 関数の一致や結果には影響しません。ランキングにのみ使用されます。

次の例は、テキストをトークン化する方法を示しています。

CREATE TABLE T (
  ...
  Text STRING(MAX),
  Html STRING(MAX),
  Text_Tokens TOKENLIST
    AS (TOKENIZE_FULLTEXT(Text, content_type=>"text/plain")) HIDDEN,
  Html_Tokens TOKENLIST
    AS (TOKENIZE_FULLTEXT(Html, content_type=>"text/html")) HIDDEN
) PRIMARY KEY(...);

language_tag 引数を使用した言語検出の絞り込み

トークン化では、デフォルトで入力言語が自動的に検出されます。入力言語が判明している場合は、language_tag 引数を使用してこの動作を絞り込むことができます。

AlbumTitle_Tokens TOKENLIST
  AS (TOKENIZE_FULLTEXT(AlbumTitle, language_tag=>"en-us")) HIDDEN

ほとんどのアプリでは、language_tag 引数を指定せず、自動言語検出に依存しています。中国語、韓国語、日本語などのアジア言語のセグメンテーションでは、トークン化言語を設定する必要はありません。

次の例は、language_tag がトークン化に影響するケースを示しています。

トークン化関数	生成されたトークン
TOKENIZE_FULLTEXT("A tout pourquoi il y a un parce que")	[a, tout, pourquoi, il, ya, un, parce, que]
TOKENIZE_FULLTEXT("A tout pourquoi il y a un parce que", \ language_tag=>"fr")	[a, tout, pourquoi, il, y, a, un, parce, que]
TOKENIZE_FULLTEXT("旅 行")	2 つのトークン: [旅, 行]
TOKENIZE_FULLTEXT("旅 行", language_tag=>"zh")	1 つのトークン: [旅行]

次のステップ

• 検索インデックスについて学習する。
• 数値インデックスについて学習する。
• インデックスのパーティショニングについて学習する。