SPLIT_TEXT_RECURSIVE_CHARACTER (SNOWFLAKE.CORTEX)

SPLIT_TEXT_RECURSIVE_CHARACTER 関数は文字列をより短い文字列に再帰的に分割し、テキスト埋め込み関数や検索インデックス関数で使用するためにテキストを前処理します。この関数は、与えられた入力パラメーターに基づいて元のテキストからチャンクを生成し、テキストチャンクの配列を返します。

分割アルゴリズムは、形式に基づいてデフォルトで暗黙的に、または separators 引数で明示的に、提供される順序に基づいて区切り文字でテキストを分割しようとします。そして、指定された chunk_size より長いチャンクには、再帰的に、すべてのチャンクが指定された chunk_size より長くなくなるまで、分割が適用されます。

たとえば、形式を 'none' に設定した場合、アルゴリズムはまず、ほとんどの形式で段落区切りを表す「\n\n」シーケンスで分割します。結果のチャンクがまだ chunk_size 文字より長い場合、関数は改行を表す「\n」文字で分割します。各チャンクが chunk_size 文字未満になるまで、このプロセスを繰り返します。

構文

SNOWFLAKE.CORTEX.SPLIT_TEXT_RECURSIVE_CHARACTER (
  '<text_to_split>',
  '<format>',
  <chunk_size>,
  [ <overlap> ],
  [ <separators> ]
)
Copy

引数

必須：

'text_to_split'

分割するテキスト。

'format'

入力テキストの形式。分割アルゴリズムにおけるデフォルトの区切り文字を決定します。以下のいずれかにする必要があります。

  • none: 形式固有の区切り文字はありません。 separators フィールド内の区切り文字のみが分割に使用されます。

  • markdown: 区切り文字フィールド内の区切り文字に加えて、ヘッダー、コードブロック、テーブルで分割します。

chunk_size

各チャンクの最大文字数を指定する整数。値はゼロよりも大きくする必要があります。

オプション：

overlap

連続するチャンク間で重なる文字数を指定する整数。デフォルトでは、チャンクは重複しません。 overlap が指定された場合は、 chunk_size 引数よりも小さくする必要があります。

重複は、各チャンクが前のチャンクについて何らかのコンテキストを持っていることを保証するのに便利です。これにより、検索結果やその他の処理の質を向上させることができます。

separators

format パラメーターで指定する区切り文字に加えて、テキストを分割する際に境界として用いる文字シーケンスの順序リスト。このリストの最後のアイテムは、アルゴリズムがテキストを希望するサイズのチャンクに分割できることが保証されるように、空文字列（任意の2文字間で分割できる）などの一般的な区切り文字にする必要があります。

デフォルト: ["\n\n", "\n", " ", ""]。段落区切り、改行、スペース、任意の2文字間（空文字列）を意味します。

戻り値

入力文字列から抽出したテキストチャンクを含む文字列の配列を返します。

既知の制限

このプレビューでは、エラーメッセージが不可解な場合があります。ほとんどのエラーメッセージは、引数の検証の失敗に関するものです。デバッグの第一歩として、引数がすべて有効な値であることを確認してください。

例

簡単な使用法

以下の例では、入力テキスト hello world are you here で SPLIT_TEXT_RECURSIVE_CHARACTER 関数を直接呼び出しています。この関数は、テキストを15文字ずつのチャンクに分割し、チャンク間は10文字ずつ重なります。

SELECT SNOWFLAKE.CORTEX.SPLIT_TEXT_RECURSIVE_CHARACTER (
   'hello world are you here',
   'none',
   15,
   10
);
Copy
['hello world are', 'world are you', 'are you here']

Markdown形式とチャンク配列の行へのフラット化の例

次の例では、各行に短いMarkdownドキュメントを含むテーブル sample_documents を作成し、 SPLIT_TEXT_RECURSIVE_CHARACTER 関数を呼び出して各ドキュメントを分割しています。この関数は、テキストを25文字ずつのチャンクに分割し、チャンク間は10文字ずつ重なります。

-- Create sample markdown data table
CREATE OR REPLACE TABLE sample_documents (
   doc_id INT AUTOINCREMENT, -- Monotonically increasing integer
   document STRING
);

-- Insert sample data
INSERT INTO sample_documents (document)
VALUES
   ('### Heading 1\\nThis is a sample markdown document. It contains a list:\\n- Item 1\\n- Item 2\\n- Item 3\\n'),
   ('## Subheading\\nThis markdown contains a link [example](http://example.com) and some \**bold*\* text.'),
   ('### Heading 2\\nHere is a code snippet:\\n```\\ncode_block_here()\\n```\\nAnd some more regular text.'),
   ('## Another Subheading\\nMarkdown example with \_italic\_ text and a [second link](http://example.com).'),
   ('### Heading 3\\nText with an ordered list:\\n1. First item\\n2. Second item\\n3. Third item\\nMore text follows here.');

-- split text
SELECT
   doc_id,
   c.value
FROM
   sample_documents,
   LATERAL FLATTEN( input => SNOWFLAKE.CORTEX.SPLIT_TEXT_RECURSIVE_CHARACTER (
      document,
      'markdown',
      25,
      10
   )) c;
Copy
言語: 日本語