バージョン: 26.x

概要

説明

AI Functionは、人工知能（AI）機能に基づいてDorisが提供する組み込み関数です。ユーザーはSQLクエリでAIを直接呼び出して、様々なインテリジェントなテキストタスクを実行できます。AI FunctionはDorisのリソースメカニズムを通じて、複数の主要なAIプロバイダー（OpenAI、Anthropic、DeepSeek、Gemini、Ollama、MoonShotなど）に接続します。

使用するAIはDorisから外部で提供され、テキスト分析をサポートしている必要があります。

AIリソースの設定

AI Functionを使用する前に、AI APIのアクセス情報を一元管理するためにAI型のResourceを作成する必要があります。

例：AIリソースの作成

CREATE RESOURCE "ai_resource_name"
PROPERTIES (
    'type' = 'ai',
    'ai.provider_type' = 'openai',
    'ai.endpoint' = 'https://endpoint_example',
    'ai.model_name' = 'model_example',
    'ai.api_key' = 'sk-xxx',
    'ai.temperature' = '0.7',
    'ai.max_token' = '1024',
    'ai.max_retries' = '3',
    'ai.retry_delay_second' = '1',
    'ai.dimensions' = '1024'
);

パラメータ説明

type: 必須。aiである必要があり、aiのタイプ識別子として使用されます。

ai.provider_type: 必須。外部AIプロバイダータイプ。現在サポートされているプロバイダーには以下が含まれます：OpenAI、Anthropic、Gemini、DeepSeek、Local、MoonShot、MiniMax、Zhipu、QWen、Baichuan。上記にリストされていないプロバイダーでも、そのAPIフォーマットがOpenAI/Anthropic/Geminiと同じ場合は、対応するプロバイダーを直接入力できます。

ai.endpoint: 必須。AI APIエンドポイント。

ai.model_name: 必須。モデル名。

ai_api_key: ai.provider_type = localの場合を除き必須。APIキー。

ai.temperature: オプション。生成されるコンテンツのランダム性を制御します。0から1の間のfloat値を受け入れます。デフォルト値は-1で、このパラメータが設定されていないことを意味します。

ai.max_tokens: オプション。生成されるコンテンツの最大トークン数を制限します。デフォルト値は-1で、このパラメータが設定されていないことを意味します。Anthropicのデフォルト値は2048です。

ai.max_retries: オプション。単一リクエストの最大再試行回数。デフォルト値は3です。

ai.retry_delay_second: オプション。再試行前の遅延時間（秒単位）。デフォルト値は0です。

ai.dimensions: オプション。EMBED出力のベクトル次元を制御します。 設定前に、ai.model_nameに入力されたモデルがカスタムベクトル次元をサポートしていることを確認してください。そうでなければ、モデル呼び出しの失敗を引き起こす可能性があります。

リソース選択とSessionの変数

ユーザーがAI関連機能を呼び出す際、リソースは以下の2つの方法で指定できます：

明示的にリソースを指定：関数呼び出し時にリソース名を直接渡す。
暗黙的にリソースを指定：事前にSessionの変数を設定し、関数が自動的に対応するリソースを使用する。

Sessionの変数設定フォーマット：

SET default_ai_resource='resource_name';

関数呼び出し形式：

SELECT AI_FUNCTION([<resource_name>], <args...>);

リソース選択優先度

AI_Functionを呼び出す際、使用するリソースは以下の順序で決定されます：

呼び出し時にユーザーが明示的に指定したリソース
グローバルデフォルトリソース（default_ai_resource）

例：

SET default_ai_resource='global_default_resource';
SELECT AI_SENTIMENT('this is a test'); -- Uses resource named 'global_default_resource'
SELECT AI_SENTIMENT('invoke_resource', 'this is a test'); --Uses resource named 'invoke_resource'

AI Functions

現在Dorisでサポートされているアプリケーション関数は以下の通りです：

AI_CLASSIFY: 情報分類
AI_EXTRACT: 情報抽出
AI_FILTER：情報フィルタリング
AI_FIXGRAMMAR: 文法修正
AI_GENERATE: テキスト生成
AI_MASK: 機密情報のマスキング
AI_SENTIMENT: 感情分析
AI_SIMILARITY: テキストの意味的類似度比較
AI_SUMMARIZE: テキスト要約
AI_TRANSLATE: 翻訳
AI_AGG: 複数のテキストに対してクロスライン集計分析を実行

例

AI_TRANSLATE

SELECT AI_TRANSLATE('resource_name', 'this is a test', 'Chinese');
-- 这是一个测试

AI_SENTIMENT

SET default_ai_resource = 'resource_name';
SELECT AI_SENTIMENT('Apache Doris is a great DBMS.');

詳細な機能と使用方法については、各関数の具体的なドキュメントを参照してください。

説明​

AIリソースの設定​

例：AIリソースの作成​

パラメータ説明​

リソース選択とSessionの変数​

リソース選択優先度​

AI Functions​

例​

説明