- カテゴリ：
/sql-reference/functions-string`（AI 関数）、:doc:/sql-reference/functions-file`（AI 関数）
AI_COMPLETE¶
注釈
AI_COMPLETE は COMPLETE （SNOWFLAKE.CORTEX） の更新されたバージョンです。最新の関数については、 AI_COMPLETE を使用してください。
サポートされている言語モデルを使用して、テキストまたは画像から応答（完了）を生成します。次の対象を指定できます。
モデルからの応答を生成するためのテキストプロンプト。詳細については、 AI_COMPLETE （単一文字列） をご参照ください。
画像とプロンプトに基づいて応答を生成するための単一の画像とテキストプロンプト。詳細については、 AI_COMPLETE （シングル画像） をご参照ください。
複数の画像とテキストをサポートするプロンプトオブジェクト。詳細については、 AI_COMPLETE （プロンプトオブジェクト） をご参照ください。
構文¶
関数の構文は、入力のタイプによって異なります。構文の情報については、以下のセクションをご参照ください。
すべての構文バリエーションは、最後のパラメーターとしてオプションの``return_error_details`` BOOLEAN引数を受け入れます。TRUE に設定した場合、関数は値とエラーメッセージを含む OBJECT を返します。そのうちの1つは関数が成功したか失敗したかに応じて NULL になります。詳細については、`エラー動作`_を参照してください。
エラー動作¶
デフォルトでは、AI_COMPLETEが入力を処理できない場合、関数はNULLを返します。クエリが複数の行を処理する場合、エラーのある行はNULLを返し、クエリの完了を妨げません。
エラー時の戻り値は``return_error_details``引数によって異なります。次の表は、``return_error_details``引数に基づいて、どのような戻り値が返されるかを示しています。
return_error_details戻り値
説明
NULL
TRUE
``value``と``error``のフィールドを持つOBJECT
value:完了応答（通常の戻り値と同じ型）、またはエラーが発生した場合はNULL。error:エラーが発生した場合はエラーメッセージを含む VARCHAR 値、または関数が成功した場合は NULL。
AI関数のエラー処理について詳しくは、:doc:`/release-notes/bcr-bundles/2026_02/bcr-2184`を参照してください。
アクセス制御の要件¶
ユーザーは、 SNOWFLAKE.CORTEX_USER データベースロール が付与されているロールを使用する必要があります。この権限の詳細については、 Cortex LLM 権限 をご参照ください。
法的通知¶
法的通知については、 Snowflake AI と ML をご参照ください。