E-MapReduce:AI センター

カーネルバージョンの要件

• 3.3.20-2.1.1 以降

• 3.5.16-2.1.1 以降

ネットワークアクセスの設定

StarRocks の BE ノードは、外部のモデルサービスエンドポイントに到達するためにアウトバウンドインターネットアクセスが必要です。ご利用のクラスターが実行されている VPC に NAT Gateway を設定します：

1. NAT Gateway を作成し、それに Elastic IP Address (EIP) をバインドします。

2. BE ノードの CIDR ブロックからのトラフィックを NAT Gateway 経由でルーティングする SNAT ルールを追加します。

3. VPC のルートテーブルとセキュリティグループポリシーがアウトバウンドトラフィックを許可していることを確認します。

設定の詳細については、「インターネット NAT ゲートウェイ」をご参照ください。

ai_sentiment

入力テキストの感情を分類します。

構文

ai_sentiment(text)

パラメーター

戻り値

VARCHAR — 'positive'、'negative'、'neutral'、'mixed'、または 'unknown'。感情を判断できない場合は NULL を返します。

例

単一値のテスト：

SELECT ai_sentiment('I am happy');
-- 戻り値: 'positive'

テーブル列に適用：

SELECT
  review_id,
  review_text,
  ai_sentiment(review_text) AS sentiment
FROM customer_reviews
LIMIT 10;

ai_classify

定義したリストから 1 つのラベルを割り当てます。

構文

ai_classify(text, labels)

パラメーター

戻り値

JSON — 分類結果が含まれます。分類に失敗した場合は NULL を返します。

例

単一値のテスト：

SELECT ai_classify('My password is leaked.', ['urgent', 'not urgent']);
-- 戻り値: {"labels": ["urgent"]}

製品説明を一括でタグ付け：

SELECT
  product_id,
  description,
  ai_classify(description, ['clothing', 'shoes', 'accessories', 'furniture']) AS category
FROM products
LIMIT 10;

ai_extract

テキストから名前付きエンティティを抽出し、JSON オブジェクトとして返します。

構文

ai_extract(text, entity_labels)

パラメーター

戻り値

キーがエンティティの型で、値が抽出されたテキストである JSON オブジェクト。

例

SELECT ai_extract(
  '田中太郎は東京に住んでおり、Acme 株式会社で働いています。',
  ['person', 'location', 'organization']
);
-- 戻り値: {"person":"田中太郎","location":"東京","organization":"Acme 株式会社"}

ai_redact

指定された PII カテゴリを [REDACTED] に置き換えます。

構文

ai_redact(text, categories)

パラメーター

戻り値

一致したエンティティが [REDACTED] に置き換えられた VARCHAR。

例

単一値のテスト：

SELECT ai_redact(
  'John Doe lives in New York. His email is john.doe@example.com.',
  ['person', 'email']
);
-- 返り値: "[REDACTED] lives in New York. His email is [REDACTED]."

エクスポート前にログテーブル全体の PII をマスキング：

SELECT
  log_id,
  ai_redact(log_text, ['person', 'email', 'phone']) AS redacted_log
FROM audit_logs
LIMIT 10;

ai_fix_grammar

テキストの文法とスペルを修正します。

構文

ai_fix_grammar(text)

パラメーター

戻り値

文法とスペルが修正された VARCHAR。

例

SELECT ai_fix_grammar('This sentence have some mistake');
-- 戻り値: "This sentence has some mistakes."

ai_summarize

入力テキストの簡潔な要約を生成します。

構文

ai_summarize(text)

パラメーター

戻り値

VARCHAR の要約。

例

SELECT ai_summarize(
  'Apache Spark is a unified analytics engine for large-scale data processing...',
  10
);
-- 戻り値: "Spark: unified engine for large-scale data processing with APIs and tools."

ai_translate

テキストをある言語から別の言語に翻訳します。

構文

ai_translate(text, source_lang, target_lang)

パラメーター

一般的な言語コード：

戻り値

翻訳された VARCHAR。

例

SELECT ai_translate('Hello, how are you?', 'en', 'es');
-- 戻り値: "Hola, ¿cómo estás?"

ai_similarity

2 つのテキスト間のセマンティック類似性を計算します。

構文

ai_similarity(text1, text2)

パラメーター

戻り値

0 から 1 の間の FLOAT。スコア 1.0 はテキストが同一であることを意味します。このスコアは主にソートに使用されます。

例

SELECT ai_similarity(
  '山でハイキングを楽しむのが好きです。',
  '山道を歩くのが大好きです。'
);
-- 戻り値: 0.82

ai_complete

指定されたモデルを使用してコンテンツを生成します。シンプルな形式とパラメーター付きの形式の 2 つのオーバーロードをサポートします。

構文

-- オーバーロード 1: シンプル
ai_complete(model, prompt)
-- オーバーロード 2: パラメーター付き
ai_complete(model, prompt, params)

パラメーター

戻り値

VARCHAR — 生成されたテキスト。

例

シンプルな形式：

SELECT ai_complete('qwen-plus', '20% 割引の夏の自転車セールのためのキャッチーなメール件名を書いてください');
-- 戻り値: "夏のサイクリングカーニバル：期間限定で 20% オフ！"

パラメーター付き：

SELECT ai_complete('qwen-plus', 'クラウドコンピューティングの利点を要約してください', map{'temperature':'0.7', 'max_tokens':'200'});
-- 戻り値: "クラウドコンピューティングは、スケーラブルなリソース、コスト効率などを提供します..."

ai_filter

テキストに対して自然言語条件を評価し、TRUE または FALSE を返します。WHERE 句で行をフィルタリングするのに便利です。

構文

ai_filter(text, condition)

パラメーター

戻り値

BOOLEAN — テキストが条件を満たす場合は TRUE、それ以外は FALSE。

例

SELECT * FROM reviews WHERE ai_filter(review_text, 'mentions product quality issues');
-- 戻り値: レビューテキストが製品品質の問題について言及している行

ai_custom_query

カスタムリソースまたはナレッジベースに対してクエリを実行します。

構文

ai_custom_query(resource, prompt)

パラメーター

戻り値

VARCHAR。

例

SELECT ai_custom_query('my_knowledge_base', 'What is StarRocks?');
-- 戻り値: "StarRocks is a high-performance analytical data warehouse..."

モデル接続

バッチサイズ

各関数はバッチでモデルにリクエストを送信します。バッチサイズを大きくすると、モデル呼び出しの数が減り、合計応答時間を短縮できます。

プロンプトテンプレート

各関数は設定可能なプロンプトテンプレートを使用します。テンプレートのプレースホルダーは $0、$1 などを使用します。