すべてのプロダクト
Search

このプロダクト

    Object Storage Service:put-vectors

    ドキュメントセンター

    Object Storage Service:put-vectors

    最終更新日:Nov 09, 2025

    put-vectors コマンドを使用して、ベクトルデータをインデックスに書き込みます。

    注意事項

    • 1 つのベクトルインデックスには、最大 5,000 万行のベクトルデータを格納できます。

    • PutVectors 操作では、1 回のバッチで最大 500 個のベクトルを書き込むことができます。

    権限

    Alibaba Cloud アカウントは、デフォルトですべての権限を持っています。ただし、Resource Access Management (RAM) ユーザーまたは RAM ロールは、デフォルトでは何の権限も持っていません。Alibaba Cloud アカウントのオーナーまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。

    API

    アクション

    説明

    PutVectors

    oss:PutVectors

    ベクトルデータを書き込みます。

    コマンドのフォーマット

    ossutil vectors-api put-vectors --bucket value --index-name value --vectors value [flags]

    パラメーター

    パラメーター

    タイプ

    説明

    --bucket

    string

    ベクトルバケットの名前。

    --index-name

    string

    インデックスの名前。

    --vectors

    string

    ベクトルデータ。JSON 文字列または `file://` プレフィックスが付いたファイルパスを指定できます。

    説明

    ベクトルデータ形式

    ベクトルデータは JSON 配列形式である必要があります。配列内の各ベクトルには、次のフィールドが含まれています。

    [ 
    { 
       "data": {
          "float32":[float]
       },
       "key": "string",
       "metadata": {
           "key1": ["value1", "value2"],
           "key2": "value2"
       }
    }
]

    次の表に各フィールドの説明を示します。

    名前

    データの型

    必須

    例

    説明

    key

    String

    はい

    doc-001

    ベクトルのプライマリキー。ベクトルを一意に識別します。次の制限が適用されます。

    • キーが既に存在する場合、ベクトルは上書きされます。同じバッチ内に重複するキーが存在する場合、操作全体が失敗します。

    • キーの長さは 1～1,024 文字である必要があります。

    • キーは UTF-8 形式である必要があります。

    親ノード: vectors

    data

    コンテナ

    はい

    -

    ベクトルの内容。

    親ノード: vectors

    float32

    数値配列

    はい

    [0.1, 0.2, 0.3]

    ベクトルデータ。データの型は float32 です。ベクトルのディメンションは、インデックスで定義されたディメンションと一致する必要があります。余弦距離メジャーを使用する場合、ゼロベクトルは許可されません。

    親ノード: data

    metadata

    コンテナ

    いいえ

    -

    メタデータ。次の制限が適用されます。

    • 合計サイズは 40 KB を超えることはできません。

    • フィルター可能なメタデータの制限: フィルター可能なフィールドの数は 0～10 です。フィルター可能な部分のサイズは 2 KB を超えることはできません。

    • サポートされているデータの型は文字列です。

    • フィルター可能なメタデータを構成する場合:

      • 1 つのフィルター命令におけるフィルター可能なメタデータの合計長は 64 KB を超えることはできません。

      • 1 つのフィルター命令におけるフィルター可能なメタデータ項目の数は 1,024 を超えることはできません。

      • フィルター条件は最大 8 レベルまでネストできます。

      • 空のフィルター条件は許可されます。

    親ノード: vectors

    例

    この例では、`examplebucket` という名前のベクトルバケット内の `index` という名前のベクトルインデックスにベクトルを追加します。ベクトルデータは `[1]`、プライマリキーは `vector1`、メタデータは `{"Key1": "32"}` です。

    • JSON 構成ファイルを使用します。`vectors.json` ファイルには次の内容が含まれています。

      [
  {
    "data": {
      "float32": [1]
    },
    "key": "vector1",
    "metadata": {
      "Key1": "32"
    }
  }
]

      コマンドの例:

      ossutil vectors-api put-vectors --bucket examplebucket --index-name index --vectors file://vectors.json

    • JSON 構成パラメーターを使用します。

      ossutil vectors-api put-vectors --bucket examplebucket --index-name index --vectors "[{\"data\":{\"float32\":[1]},\"key\":\"vector1\",\"metadata\":{\"Key1\":\"32\"}}]"