CREATE MODEL 文は、AI モデルを AnalyticDB for MySQL に登録し、SQL クエリで直接呼び出せるようにします。この文を使用して、組み込みの推論プラットフォームまたは Alibaba Cloud Model Studio などの外部モデルサービスに接続します。
構文
CREATE MODEL model_name
OPTIONS(
type = 'internal|external',
name = 'connected_model_name',
provider = 'provider_name'
[, interface = 'interface_str'] -- オプション、デフォルト：TEXT_TO_TEXT
[, api_key = 'sk-xxx'] -- type = 'external' の場合に必須
[, endpoint = 'endpoint_url'] -- type = 'external' の場合に必須
[, model_properties = ...] -- オプション、Qwen シリーズのみ
)パラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
model_name | はい | AnalyticDB for MySQL でモデルに割り当てる名前です。 |
name | はい | モデルサービス側のモデル名です。例えば、Alibaba Cloud Model Studio の qwen-max や qwen-plus などです。 |
type | はい | モデルサービスのタイプです。AnalyticDB for MySQL の組み込み推論プラットフォームを使用する場合は internal に、外部モデルサービスに接続する場合は external に設定します。 |
provider | はい | モデルサービスのプロバイダーです。組み込みの推論プラットフォームの場合は ADB_MODEL_SERVER、Alibaba Cloud Model Studio の場合は BAILIAN |
interface | いいえ | モダリティタイプです。このパラメーターは、マルチモーダルモデルサービスを区別するのに役立ちます。このパラメーターを省略すると、デフォルトの TEXT_TO_TEXT が使用されます。複数の値はカンマで区切ります。 |
api_key | いいえ | 外部モデルサービスの API キーです。type = 'external' の場合に必須です。 |
endpoint | いいえ | 外部モデルサービスのエンドポイント URL です。type = 'external' の場合に必須です。 |
model_properties | いいえ | モデルの出力を制御するハイパーパラメーターです。現在は Alibaba Cloud Model Studio の Qwen シリーズモデルに限定されています。 |
インターフェイスタイプ
interface パラメーターは、次の値を受け入れます：
| 値 | 説明 |
|---|---|
TEXT_TO_TEXT | テキスト生成モデル (デフォルト) |
TEXT_TO_EMBEDDING | テキスト埋め込みモデル |
IMAGE_TO_TEXT | 画像からテキストへのモデル |
IMAGE_TO_EMBEDDING | 画像埋め込みモデル |
AUDIO_TO_TEXT | 音声からテキストへのモデル |
AUDIO_TO_EMBEDDING | 音声埋め込みモデル |
モデルパラメーター
model_properties パラメーターは、次のハイパーパラメーターを受け入れます。現在は Alibaba Cloud Model Studio の Qwen シリーズモデルに限定されています。
| パラメーター | タイプ | 説明 |
|---|---|---|
top_k | int | 最も確率の高い上位 K 個のトークンからサンプリングします。値を小さくすると、トークンのプールが狭まり、出力がより決定論的になります。 |
top_p | double | ニュークリアスサンプリングのしきい値です。累積確率が top_p に達するトークンの最小セットを選択します。値を小さくすると、出力がより絞り込まれます。 |
enable_search | boolean | Web 検索を有効にして、最新情報や外部情報を取得します。 |
seed | int | 生成用のランダムシードです。他のすべてのパラメーターが変更されない場合、同じシードは同じ出力を生成します。 |
temperature | float | 出力のランダム性を制御します。値を大きくすると多様性が増し、値を小さくすると出力がより決定論的になります。範囲：0.0–2.0。 |
max_tokens | int | 生成するトークンの最大数です。入力ではなく、出力の長さにのみ適用されます。 |
例
外部モデルの登録
Alibaba Cloud Model Studio から Qwen モデルを接続します。この文を実行する前に、ネットワークを設定して、外部サービスへのアウトバウンドアクセスを許可してください。
CREATE MODEL my_qwen_model
OPTIONS(
type = 'external',
name = 'qwen-plus',
provider = 'BAILIAN',
api_key = '<your-api-key>',
endpoint = '<your-endpoint-url>'
)プレースホルダーを実際の値に置き換えてください：
| プレースホルダー | 説明 |
|---|---|
<your-api-key> | Alibaba Cloud Model Studio から取得したモデルアクセスキー |
<your-endpoint-url> | 選択したモデルのモデルサービスエンドポイント |