PROMPT¶

構文¶

SELECT PROMPT('<template_string>', <expr_1> [ , <expr_2>, ... ] )
    FROM <table>;

引数¶

必須：

template_string

{0} のような番号付きプレースホルダーを含む文字列。番号は0以上、指定した式の数未満。最初の式は {0} に代入され、2番目の式は {1} に代入される、などです。

expr_1 [ , expr_2, ... ]

値が数値で指定されたプレースホルダーに代わって、テンプレート文字列内に最終的に挿入される式。これらは列名や他の式にすることができます。値は文字列と互換性のあるタイプ（例えば、 VARCHAR、 NUMBER など）、または FILE にできます。

戻り値¶

以下のような構造を持つ SQL OBJECT:

{
  'template': '<template_string>',
  'args': ARRAY(<value_1>, <value_2>, ...)
}

args 配列には、 PROMPT 関数呼び出しで指定された式の値が含まれます。

使用上の注意¶

• PROMPT は単独では文字列のフォーマット処理を行いません。これは、Cortex AI 関数で使用されるオブジェクトを構築することを目的としています。

• It is an error to use a placeholder in the template string that does not have a corresponding expression, but it is not an error to provide expressions that are not used in the template string.

例¶

SELECT PROMPT('Hello, {0}! Today is {1}.', 'Alice', 'Monday');

{
    'template': 'Hello, {0}! Today is {1}.',
    'args': ['Alice', 'Monday']
}

WITH reviews AS (
    SELECT 'Wow... Loved this place.' AS review, 5 AS rating
    UNION ALL
    SELECT 'Crust is not good.', 2 AS rating
)
SELECT * FROM reviews
WHERE AI_FILTER(PROMPT('The reviewer enjoyed the restaurant: {0}, Rating: {1}', review, rating));

AI_COMPLETE('claude-4-sonnet',
    PROMPT('Classify the input image {0} in no more than 2 words. Respond in JSON', img_file)) AS image_classification
FROM image_table;