全部产品
Search
文档中心

Object Storage Service:Unggah vektor (Python SDK V2)

更新时间:Nov 09, 2025

Anda dapat menggunakan Python SDK V2 untuk memanggil operasi PutVectors dan mengunggah data vektor ke indeks vektor yang ditentukan.

Izin

Akun Alibaba Cloud memiliki semua izin secara default. Namun, pengguna Resource Access Management (RAM) dan peran RAM tidak memiliki izin secara default. Administrator Akun Alibaba Cloud harus memberikan izin melalui Kebijakan RAM atau Kebijakan bucket.

API

Tindakan

Deskripsi

PutVectors

oss:PutVectors

Menulis data vektor.

Definisi metode

put_vectors(request: PutVectorsRequest, **kwargs) → PutVectorsResult

Parameter permintaan

Parameter

Tipe

Deskripsi

request

PutVectorsRequest

Parameter permintaan. Ini mencakup nama bucket, nama indeks, dan data vektor. Untuk informasi lebih lanjut, lihat PutVectorsRequest.

Nilai kembali

Tipe

Deskripsi

PutVectorsResult

Nilai kembali. Untuk informasi lebih lanjut, lihat PutVectorsResult.

Untuk definisi lengkap metode `put_vectors`, lihat put_vectors.

Contoh

import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.vectors as oss_vectors

parser = argparse.ArgumentParser(description="contoh unggah vektor")
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--bucket', help='Nama bucket.', required=True)
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')
parser.add_argument('--index_name', help='Nama indeks vektor.', required=True)
parser.add_argument('--account_id', help='ID akun.', required=True)

def main():
    args = parser.parse_args()

    # Memuat nilai kredensial dari variabel lingkungan
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Menggunakan konfigurasi default SDK
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region
    cfg.account_id = args.account_id
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    vector_client = oss_vectors.Client(cfg)

    vectors = [
        {
            "data": {"float32":  [0.1] * 128},
            "key": "key1",
            "metadata": {"metadata1": "value1", "metadata2": "value2"}
        },
        {
            "data": {"float32": [0.2] * 128},
            "key": "key2",
            "metadata": {"metadata3": "value3", "metadata4": "value4"}
        }
    ]

    result = vector_client.put_vectors(oss_vectors.models.PutVectorsRequest(
        bucket=args.bucket,
        index_name=args.index_name,
        vectors=vectors,
    ))

    print(f'kode status: {result.status_code},'
          f' ID permintaan: {result.request_id},'
    )

if __name__ == "__main__":
    main()

Referensi

Untuk kode sampel lengkap untuk mengunggah data vektor, lihat put_vectors.py.