AI 関数を使用すると、データベースから直接 AI サービスを呼び出すことができます。例として、テキスト生成、条件判断、感情分析、分類などが挙げられます。本トピックでは、AnalyticDB for MySQL における AI 関数の使用方法について説明し、使用例を示します。
重要
AI モデルは本質的に確率的であるため、同一の入力であっても、AI 関数によって処理された結果は異なる出力を返す場合があります。
テキスト関数
ai_filter：入力テキストの事実性または準拠性を評価します。
ai_translate：入力テキストを指定した言語に翻訳します。
ai_classify：入力テキストに対して意味解析を行い、あらかじめ定義されたカテゴリまたはラベルに分類します。
ai_extract：非構造化テキストから、名前、日付、住所、キーワードなど、指定された種類の構造化情報を抽出します。
ai_sentiment：入力テキストのセンチメントを分析し、ポジティブ、ネガティブ、またはニュートラルなどの判断を返します。
ai_similarity：2 つのテキスト間の意味的類似度を計算します。
ai_mask：入力テキスト内の ID 番号、電話番号、メールアドレスなどの機密情報をマスクします。
ai_summarize：長文を意味的に圧縮し、簡潔かつ正確なまとめを生成します。
音声関数
ai_audio_transcribe：音声を対応するテキストに変換（文字起こし）します。セグメンテーションモード、対象言語などのオプションを必要に応じて指定できます。
ai_audio_embed：音声を対応する埋め込みベクターに変換し、埋め込みベクターの配列を返します。
前提条件
AnalyticDB for MySQL の Enterprise Edition、Basic Edition、Data Lakehouse Edition、または 弾性モードの Data Warehouse Edition で、ENI アクセスが有効になっているもの。
重要AnalyticDB for MySQL コンソール にログインします。左側のナビゲーションウィンドウで、 を選択します。ネットワーク情報 セクションで、ENI アクセスのスイッチをオンにします。
ENI アクセスの有効化または無効化により、約 2 分間データベース接続が切断されます。この期間中は、データの読み取りおよび書き込みができません。この操作を行う前に、潜在的な影響を十分に検討することを推奨します。
本機能はパブリックプレビュー段階です。ご利用には、技術サポートへの連絡用チケットを送信して、有効化を依頼してください。
事前準備
AI 関数を利用するには、AnalyticDB for MySQL から Alibaba Cloud Model Studio へのネットワーク接続を設定し、モデルを作成する必要があります。
パブリックネットワーク経由での接続
インターネット NAT ゲートウェイを設定します。
ご利用の AnalyticDB for MySQL クラスターと同じリージョンにインターネット NAT ゲートウェイを作成し、EIP（Elastic IP Address）と関連付けます。その後、SNAT エントリを作成します（vSwitch 単位での SNAT エントリ作成を推奨し、任意の vSwitch を指定してください）。詳細については、「インターネット NAT ゲートウェイ」をご参照ください。
モデルを作成します。構文の詳細については、「CREATE MODEL」をご参照ください。
例：
CREATE MODEL qwen_plus_external OPTIONS ( type='external', provider='bailian', name='qwen-plus', interface='TEXT_TO_TEXT', api_key='sk-xxx' -- Alibaba Cloud Model Studio で有効化したモデルサービスの API キーに置き換えてください。 )
PrivateLink 経由での接続
エンドポイントを設定し、プライベートドメイン名を取得します。詳細については、「プライベートネットワーク経由での Alibaba Cloud Model Studio モデルまたはアプリケーション API へのアクセス」をご参照ください。
重要Alibaba Cloud Model Studio は、以下のリージョンでご利用いただけます：シンガポール、中国 (北京)。
エンドポイントは、Model Studio サービスと同じリージョンに設定する必要があります。他のリージョンの VPC を使用する場合は、「クロスリージョンのプライベートアクセス」をご参照ください。
モデルを作成します。構文の詳細については、「CREATE MODEL」をご参照ください。
例：
CREATE MODEL qwen_plus_external OPTIONS ( type='external', provider='bailian', name='qwen-plus', interface='TEXT_TO_TEXT', api_key='sk-xxx', -- Alibaba Cloud Model Studio で有効化したモデルサービスの API キーに置き換えてください。 endpoint='ep-xxx.com' -- プライベートエンドポイントのドメイン名に置き換えてください。 )
テキスト関数
ai_filter
ai_filter(text)
ai_filter(model_name, text)説明：入力テキストの事実性または準拠性を評価します。内容が信頼できる、合理的である、または事前に定義されたルールを満たす場合に true を返します。それ以外の場合は false を返します。
入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
戻り値の型：BOOLEAN 型。
例 1
SELECT ai_filter("浙江省は中国にありますか？")結果
+---------------------------------+
| ai_filter("浙江省は中国にありますか？") |
+---------------------------------+
| 1 | 例 2
SELECT ai_filter("qwen_plus_external", "浙江省は中国にありますか？")結果
+----------------------------------------------+
| ai_filter("qwen_plus_external", "浙江省は中国にありますか？") |
+----------------------------------------------+
| 1 | ai_translate
ai_translate(text, targetLang)
ai_translate(model_name, text, targetLang)説明：入力テキストを指定した言語に翻訳します。
入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
targetLang：翻訳先言語、VARCHAR 型。
重要対象言語は、使用するモデルがサポートしている必要があります。
戻り値の型：VARCHAR 型。
例
SELECT ai_translate("AnalyticDB for MySQL は、レイクハウスアーキテクチャに基づくデータ分析プラットフォームです。", "cn") as translate_text結果
+-------------------------------------------------------------------------------------------+
| translate_text |
+-------------------------------------------------------------------------------------------+
| AnalyticDB for MySQL は、データレイクハウスアーキテクチャに基づくデータ分析プラットフォームです。 | ai_classify
ai_classify(text, labels)
ai_classify(model_name, text, labels)説明：入力テキストに対して意味解析を行い、あらかじめ定義されたカテゴリまたはラベルに分類します。
入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
labels：事前に定義されたカテゴリラベルのリスト。VARCHAR 型または Array<VARCHAR> 型をサポートします。
戻り値の型：VARCHAR 型。
例 1
SELECT ai_classify('昨夜、私はキッチンで新しいパスタレシピを試しました。ソースは濃厚で、家族にも大好評でした！', "['旅行', '料理', '読書', '運転']")
AS predicted_label;結果
+----------------------------------------------+
| predicted_label |
+----------------------------------------------+
| 料理 | 例 2
SELECT ai_classify('昨夜、私はキッチンで新しいパスタレシピを試しました。ソースは濃厚で、家族にも大好評でした！', ARRAY['旅行', '料理', '読書', '運転'])
AS predicted_label;結果
+----------------------------------------------+
| predicted_label |
+----------------------------------------------+
| 料理 | ai_extract
ai_extract(text, labels)
ai_extract(model_name, text, labels)説明：非構造化テキストから、名前、日付、住所、キーワードなど、指定された種類の構造化情報を抽出します。
入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
labels：事前に定義されたカテゴリラベルのリスト。VARCHAR 型または Array<VARCHAR> 型をサポートします。
戻り値の型：VARCHAR 型。
例
select ai_extract('昨日（2024 年 6 月 15 日）、私はタオバオで iPhone 15 Pro を購入しました。チタン製ボディと A17 チップは本当に素晴らしいです！', "['product_name', 'date', 'key_feature']") as result結果
+----------------------------------------------------------------------------------------------------+
| result |
+----------------------------------------------------------------------------------------------------+
| product_name=iPhone 15 Pro, date=2024 年 6 月 15 日, key_feature=チタン製ボディと A17 チップ | ai_generate
ai_generate(text)
ai_generate(model_name, text)説明：非構造化テキストから、名前、日付、住所、キーワードなどの構造化情報を抽出します。
入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
戻り値の型：VARCHAR 型。
例
select ai_generate('TPC-H テストセットについて簡単に紹介してください') as result結果
+----------------------------------------------------------------------------------------------------+
| result |
+----------------------------------------------------------------------------------------------------+
| TPC-H は、データベースの意思決定支援機能を評価するための標準ベンチマークテストセットです。 | ai_sentiment
ai_sentiment(text)
ai_sentiment(model_name, text)説明：入力テキストの感情を分析し、「
positive」「negative」「neutral」「mixed」の 4 つの固定ラベルのいずれかを返します。入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
戻り値の型：VARCHAR 型。
例
SELECT ai_sentiment('このヘッドホンは優れた音質を持ち、装着感も快適です。ぜひおすすめします！') AS sentiment;結果
+----------------------------------------------+
| sentiment |
+----------------------------------------------+
| positive | ai_similarity
ai_similarity(text1, text2)
ai_similarity(model_name, text1, text2)説明：2 つのテキスト間の意味的類似度を計算します。類似度スコアは 0 ～ 10 の範囲で返され、数値が大きいほど類似度が高いことを示します。
入力型：
model_name：モデル名、VARCHAR 型。
text1 および text2：入力テキスト、VARCHAR 型。
戻り値の型：VARCHAR 型。
例
SELECT ai_similarity(
'アカウントのパスワードを再設定する方法を教えてください。',
'ログインパスワードを忘れました。どうすれば復旧できますか？'
) AS result;結果
+----------------------------------------------+
| result |
+----------------------------------------------+
| 9.3 | ai_mask
ai_mask(text, labels)
ai_mask(model_name, text, labels)説明：入力テキスト内の ID 番号、電話番号、メールアドレスなどの機密情報をマスクします。
入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
labels：事前に定義されたカテゴリラベルのリスト。VARCHAR 型または Array<VARCHAR> 型をサポートします。
戻り値の型：VARCHAR 型。
例
SELECT ai_mask(
'ご連絡先：13812345678、メールアドレスは user@example.com、身分証明書番号は 110101199003072316',
"['phone', 'email', 'id_card']"
) AS result;結果
+----------------------------------------------+
| result |
+----------------------------------------------+
| ご連絡先：[MSKED]、メールアドレスは [MSKED]、身分証明書番号は [MSKED] | ai_summarize
ai_summarize(text)
ai_summarize(model_name, text)説明：長文を意味的に圧縮し、簡潔かつ正確なまとめを生成します。
入力型：
model_name：モデル名、VARCHAR 型。
text：入力テキスト、VARCHAR 型。
戻り値の型: VARCHAR。
例
SELECT ai_summarize('うねる蓮の池の上には、葉の層が視界を埋め尽くしています。葉は水面から高く立ち上がり、優雅な踊り子のスカートのようです。葉の層の間には白い花が点在しています。中には優雅に咲いているものもあれば、恥ずかしげに蕾んでいるものもあります。それらは真珠のようで、澄んだ空の星のようで、あるいは入浴後の美女のようです。そっと吹く風が微かな香りを運び、それは高台からの遠い歌声のようです。この瞬間、葉と花はわずかに震え、稲妻のように、たちまち池の向こう側へと駆け抜けていきます。葉はもともとびっしりと並んでおり、深緑のさざ波を生み出しています。葉の下では、静かな水が流れ、その姿は見えません。しかし、これによって葉はさらに魅力的になります。月光は流れる水のように、静かに葉と花に注ぎます。池からは薄い青い霧が立ち昇ります。葉と花は、まるで牛乳で洗われたようであり、あるいは薄いガーゼで包まれた夢のようです。満月ではありますが、空には薄い雲の層があり、それを明るく照らすことはできません。しかし、私はこれがちょうどよいと思っています——深い眠りは不可欠ですが、浅い居眠りにも独自の魅力があります。月光は木々を通して差し込みます。高台の茂みは、斑模様の濃い影を落とし、はっきりとして幽霊のようです。一方、まばらで優雅な柳の影は、蓮の葉に描かれたようでもあります。池の月光は均一ではありません。しかし、明暗が調和したメロディーを奏でており、それはヴァイオリンで演奏される名曲のようです。') AS result;結果
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| result -
| 月明かりに照らされた蓮の池は静かで美しい：重なる蓮の葉は踊り子のスカートのようで、真珠や星、あるいは入浴後の美女を思わせる白い花が点在しています。そっと吹く風が香りを運び、葉や花が震えて緑色のさざ波を作ります。水は葉の下でひっそりと流れており、その魅力を一層引き立てています。月光は水のようで、淡い青色の霧が景色を包み、葉や花は洗われたように見え、夢のように朧げです。雲が満月を覆い、斑模様の光と影を作り出します。低木のはっきりとした黒い影と、柳の優雅なシルエットはまるで絵画のようです。光と影は、名曲のような調和を奏でています。 | テキスト関数
ai_audio_transcribe
組み込みモデルのみがサポートされています。
ai_audio_transcribe(url)
ai_audio_transcribe(model_name, url)
ai_audio_transcribe(model_name, url, options)説明： 音声を対応するテキストに文字起こしします。必要に応じて、セグメンテーションモード、ターゲット言語、およびその他のオプションを指定できます。文字起こしされたテキスト、または出力ファイルへの URL を返します。
入力タイプ：
model_name： モデル名。データ型は VARCHAR です。
url： 入力音声ファイルの URL。データ型は VARCHAR です。
options： JSON フォーマットのオプションパラメーター。サポートされているパラメーターを以下に示します。
パラメーター名
説明
オプション
デフォルト
language
文字起こしのターゲット言語
cn (中国語)
en (英語)
ja (日本語)
yue (広東語)
fspk (中国語と英語の混合音声)
cn
diarization_mode
セグメンテーションモード
word (単語ごと)
sentence (文ごと)
speaker (話者ごと)
word (単語単位で分割)
output_type
出力フォーマット
json (文字起こしされた JSON テキストを直接返します)
url (OSS に保存し、テキストファイルの URL を返します)
json
戻り値の型： VARCHAR
例 1
SELECT ai_audio_transcribe("https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav") as result結果
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| 結果 -
| {"TaskId": "xxxx", "Transcription": {"AudioInfo": {"Size": 128480, "Duration": 3834, "SampleRate": 16000, "Language": "cn"}, "Paragraphs": [{"ParagraphId": "1768447804076500000", "SpeakerId": "1", "Words": [{"Id": 10, "SentenceId": 1, "Start": 100, "End": 595, "Text": "Hello, "}, {"Id": 20, "SentenceId": 1, "Start": 596, "End": 841, "Text": "world, "}, {"Id": 30, "SentenceId": 1, "Start": 844, "End": 1588, "Text": "this is "}, {"Id": 40, "SentenceId": 1, "Start": 1588, "End": 2580, "Text": "Alibaba "}, {"Id": 50, "SentenceId": 1, "Start": 2580, "End": 3076, "Text": "Speech "}, {"Id": 60, "SentenceId": 1, "Start": 3076, "End": 3820, "Text": "Lab."}]}], "AudioSegments": [[100, 3820]]}} | 例 2
SELECT ai_audio_transcribe("tingwu", "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav", "{'diarization_mode':'sentence'}") as result結果
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| result -
| {"タスクID": "xxxx", "文字起こし": {"音声情報": {"サイズ": 128480, "再生時間": 3834, "サンプルレート": 16000, "言語": "cn"}, "話者": [{"話者ID": "1", "文": [{"文ID": 1, "開始時刻": 100, "終了時刻": 3820, "テキスト": "Hello, world, this is Alibaba Speech Lab."}]}]}}| ai_audio_embed
音声ベクター埋め込みは、組み込みモデルのみをサポートします。
ai_audio_embed(text)
ai_audio_embed(model_name, text)
ai_audio_embed(model_name, text, options)説明：音声を対応する埋め込みベクターに変換し、埋め込みベクターの配列を返します。 パラメーターを使用して、埋め込みを生成する前に開始時間と終了時間で音声をセグメント化するかどうかをコントロールできます。
入力タイプ：
model_name：モデル名、VARCHAR。
text：入力テキスト、VARCHAR。
options：JSON フォーマットのオプションパラメーター。 サポートされているパラメーターを以下に示します。
パラメーター名
説明
注意事項
access_id
OSS AccessKey ID
role_arn を使用する場合、access_id、access_secret、または token を指定する必要はありません。
access_secret
OSS AccessKey Secret
token
OSS セキュリティトークン
role_arn
ロールの引き受け資格情報
start_time
オーディオセグメントの開始時間
指定しない場合、最初から開始されます。
end_time
オーディオセグメントの終了時間
指定しない場合、最後まで処理されます。
戻り値の型： Array<FLOAT>。
例
SELECT ai_audio_embed("https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav")結果
[0.4234241,0.3575562,0.022631245,-0.09829298,-0.40605977,-0.72465694,-1.8039973,2.4773192,0.91702485,0.15146817,0.7209677,0.78260005,0.8019302,2.7577147,-0.86063147,-0.8249354,0.28732437,0.9009849,0.8899265,-1.5320694,-2.0866642,0.5051579,1.3553369,2.0348034,-0.74032015,-0.66065377,0.2756823,0.15714298,-2.8250875,0.8162984,0.20878711,0.8285897,1.4863579,1.0645012,-1.2933203,0.6919463,0.87850314,1.2212433,-0.44420764,-1.0146322,-1.8209833,0.16996253,-1.534067,-0.10253409,0.07611574,2.4005992,-1.2903963,0.6613166,-0.2554945,0.97570425,-0.108424075,0.82061934,-0.18102498,-0.27137256,-1.2723781,-0.9188018,-0.027503261,-0.15346082,-0.9564006,-0.4618776,-1.077228,-0.27756396,0.28749034,0.2570488,-0.39753774,0.5270934,0.6970718,-1.2984067,2.4312186,1.485573,1.6031872,-0.6158852,-1.1512791,0.49305362,-1.1939837,0.72933173,0.2659372,2.5559616,-0.41886744,0.6304756,-0.6171451,-0.5282561,0.78426796,-0.57570314,-0.91166306,-0.531768,0.96598166,0.17423655,-0.9133532,-0.09258405,-0.26951456,-0.34667063,-0.21612991,-0.054430377,0.052798696,0.5198285,1.9431844,-0.5638291,-2.1043544,-0.47198293,0.21959576,0.5975169,0.3951007,0.28112686,1.792782,-0.15896009,-0.71152246,1.1540072,0.37563428,0.0016163457,0.6544563,0.043974634,-1.6375796,-0.3698572,1.5310435,-0.20282944,0.73641545,2.1867669,1.4115202,-0.8114418,-0.36265984,0.2191038,-0.8933491,0.6616433,1.545423,0.10970531,-0.109743424,0.44605017,-0.087265715,0.29077715,-2.4435875,-1.1484046,0.078253455,0.02283861,-0.29482847,2.0237377,-0.6009212,-1.2377249,0.05194488,-0.16573223,0.8370868,-0.43602425,-0.4706988,0.17996503,0.88799554,0.6562157,-0.7520023,0.64789253,0.36865348,-1.4820247,0.5299587,1.1884397,1.4351603,0.21073115,-0.1712549,2.9410155,1.7485802,-0.6828801,-0.4833641,-0.4477328,2.3307724,-0.35595444,-0.61682695,-0.5370858,-0.8068234,1.2195143,-1.0834758,0.45275012,1.6243625,-1.3629726,-0.2959109,0.05071621,-0.7280639,-0.1713935,-0.43650395,-0.2131698,0.25380868,-0.16288652,2.0921175,0.3555297,-0.10752705,0.5716714,-0.09943808,-1.9066161,0.12683412,0.8566219,-0.20323975,1.4260024,-0.28789783,0.32412016,0.88897985,0.86555415,0.5940666,0.6645551,0.046334613,-1.5640875,-0.3510718,0.55363727,-0.13503519,0.67008746,-0.9184686,0.025278697,1.0128921,-0.61241907,-0.01107134,-0.8309523,-0.51025873,1.1141272,0.28813183,-0.10634196,-0.9954202,-0.07171043,-0.5856978,-1.2660285,2.1327019,-0.60268104,-0.6227884,-0.42101067,0.059599742,-0.09640202,-1.258711,0.5054924,-1.1847625,-0.044398762,-0.98595804,0.8883682,0.6221085,-2.5484293,0.7249505,0.69930685,0.7739025,-0.8139478,-1.1988907,-1.0416493,2.0153732,-1.7091763,-0.5611238,-1.2147603,0.9113469,1.5113174,0.23810485,-1.702736,-0.3295935,-0.41867778,-1.0378691,-0.45600057,-0.43525052,-0.1078409,-1.2993969,0.12842774,0.026097976,-0.7705405,-1.0907317,0.28274077,1.236289,1.6190177,2.1874366,0.16072829,-0.33150536,2.218483,-1.1703843,0.10300327,1.1994884,0.48275462,-0.40795812,0.5020531,1.1787555,-0.082187966,0.6315653,0.36654752,-0.24940589,-0.8652801,1.6283739,0.41405886,0.6377814,0.08396838,-1.0169003,1.2100558,1.4457762,-0.07999261,-0.012102162,0.85055244,-0.09711141,-1.0452846,0.13768612,-2.0506873,-1.6474499,0.043265514,-1.0009454,-0.0111249415,-1.2523409,-0.080719866,-0.6187693,-1.398226,0.6425289,-0.4808641,-0.06030046,-0.10275636,-0.31625932,-1.5993032,-0.20966552,-1.4618409,0.34925935,-0.5034448,0.100028045,0.25327235,-1.078896,-0.23394233,1.2247928,-2.6050038,-0.71609926,-0.77765155,-1.2089496,0.8526703,-0.1358416,1.1074059,1.1545771,-0.94525933,0.41012967,0.9361201,-0.14788401,-0.29333082,1.5782444,1.1100405,-0.4074414,-0.3862537,-0.5779069,-0.88644946,0.2233385,1.3612705,1.2413827,-1.3625424,-1.3623037,0.3056319,-1.4446377,0.64613384,0.15064861,-0.61473364,-1.3611295,-0.1975697,-1.0701923,0.7591377,-1.2106745,-2.067824,0.45041704,-0.71582735,-1.743847,1.169414,2.0158787,0.4734838,-0.3133036,-1.9916989,1.1441987,0.9155275,-1.3003027,0.82898057,-0.7439868,1.2072865,0.46877453,0.6648313,0.80477613,1.6927507,0.5842916,0.36608973,2.259473,-1.1628797,-0.3311869,0.36989415,-0.25035658,-0.28012496,1.092324,-0.40238732,0.0046352614,-2.0625768,1.161326,0.92277956,-0.20316431,-0.15164377,1.1715052,-0.7067665,-0.8608931,0.079684004,-0.89916384,0.02488108,-0.57668805,-0.879138,-1.7274998,0.824049,1.5638052,0.28415555,-0.17347385,-2.085917,0.4987632,-0.031601395,-1.0190377,-0.7815816,0.69643223,-0.33574122,2.1242745,0.19785832,0.55690974,-1.3932099,-0.44952002,-0.7719798,1.1326215,0.43839702,0.996999,-0.55692834,1.4014084,-2.3939395,-1.0112343,-1.4143248,1.1514114,1.1233637,-0.3385779,-0.23665123,-0.100857966,0.4633971,1.6215613,-0.0692888,-0.031505972,1.0472811,0.57112235,0.6015763,0.07582237,0.52702487,-1.3809607,-1.7482765,0.38386008,0.99316126,0.95603,0.40644804,-1.5072054,-0.34419048,0.63205683,-1.0854999,-0.92245156,-0.2712947,-0.75696105,0.996232,-0.10738732,-0.4674776,-1.2149413,-1.5094053,1.6796608,0.21961057,-0.35295358,-1.2609407,-0.040009048,-0.38785484,0.7788784,-0.65823495,2.0559616,-1.0074826,1.2282485,1.2540467,0.4914942,-0.47057188,-0.47061247,-0.16255763,-0.6718562,-0.53630847,0.4804698,-0.3134068,0.6407026,-0.727981,0.0481851,0.06927338,0.8321921,-0.6639807,0.74932885,0.23291564,0.76362675,-1.2966217,0.8806557,-1.2141875,0.6996881,-0.8293652,0.9085288,1.8878758,0.11363957,0.148718,0.5030497,-1.0422761,0.08673843,-0.80342984,-0.8046266,-0.18026677,0.28900644,0.76534355,-1.3163859,-0.72775376,0.36529016,-0.3660175,0.31056792,0.052575216,-1.11831,0.7895246,1.1172394,-0.31374845,0.17143561,-0.42633826,0.16579832,-0.012790448,-1.4290546,-0.47322562,0.7557427,1.0487514,-0.14331971,0.30455515,0.6938429,0.5565799]AI 関数のデフォルトモデルの設定
AI 関数を呼び出す際にモデル名を指定しない場合、システムはデフォルトモデルを使用します。以下の設定項目を使用してデフォルトモデルを変更できます。設定の変更方法については、「Config および Hint パラメーター」をご参照ください。
モデルタイプ | デフォルトモデル | 設定項目 |
TEXT_TO_TEXT (テキストモデル) | qwen-plus | AI_FUNCTION_TEXT_TO_TEXT_MODEL |
TEXT_TO_EMBEDDING (テキスト埋め込みモデル) | text-embedding-v2 | AI_FUNCTION_TEXT_TO_EMBEDDING_MODEL |
AUDIO_TO_TEXT (音声テキスト変換モデル) | tingwu | AI_FUNCTION_AUDIO_TO_TEXT_MODEL |
AUDIO_TO_EMBEDDING (音声埋め込みモデル) | qwen2.5-vl-embedding | AI_FUNCTION_AUDIO_TO_EMBEDDING_MODEL |
典型的なシナリオ例
シナリオ 1：テキスト取得
適用シナリオ：RAG、カスタマーサービスシステム、および類似のユースケースにおいて、ユーザーのクエリのセマンティクスに基づいてコーパスから最も関連性の高いテキストセグメントを取得します。
クエリテキストとコーパステキストは、ai_embedd エンコーディングを使用してベクターに変換されます。その後、コサイン類似度が最も高い 10 個のテキストがソートによって特定されます。
SELECT cosine_similarity(ai_embedd("query text"), ai_embedd(text)) AS cos
FROM text_table
ORDER BY cos
LIMIT 10より良いベクトル検索パフォーマンスについては、「ベクトル検索」をご参照ください。
シナリオ 2：声紋取得
適用シナリオ：会議や日常会話において、顧客は録音をテキストに文字起こしし、話者ごとに会話を区別したいと考えています。
話者情報をさらに分析するには、音声を話者ごとにセグメント化し、埋め込みを音声データセットと比較します。完全なソリューションについては、「声紋取得」をご参照ください。
文字起こしとセグメンテーション：
ai_audio_transcribe関数を使用して、音声をテキストに文字起こしし、話者ごとにセグメント化します。SELECT AI_AUDIO_TRANSCRIBE("oss://xxx", "{'diarization_mode':'speaker'}")声紋取得：
ai_audio_embed関数を使用して、入力音声と元の音声ライブラリの両方について埋め込みベクターを計算します。l2_distanceを計算し、最も近い 10 件を返します。SELECT l2_distance(input_embedding, origin_embedding) AS ld FROM( SELECT ai_audio_embed("oss://xxx") AS input_embedding JOIN SELECT ai_audio_embed(url) AS origin_embedding FROM audio_table) ORDER BY ld LIMIT 10
シナリオ 3：不満のある顧客レビューの抽出
適用シナリオ：ユーザーレビューから否定的なフィードバックをフィルタリングします。
customer_comment テーブルには、日々の顧客レビューが保存されています。センチメント分析関数 ai_sentiment を使用して顧客のセンチメントを特定し、2026 年 1 月 1 日以降のすべての不満のあるレビューをフィルタリングします。
-- qwen_plus_external モデルは作成済みで、Model Studio が提供する qwen-plus モデルに対応しています。
SELECT name, comment
FROM customer_comment
WHERE ai_sentiment("qwen_plus_external", comment)='negative'
AND dt='20260101'