すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ベクトル情報の取得 (Python SDK V2)

最終更新日:Nov 09, 2025

Python SDK V2 を使用して GetVectors 操作を呼び出し、指定されたキーのベクトルデータを取得できます。ベクトルデータとそのメタデータの両方を取得できます。

権限

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

API

アクション

説明

GetVectors

oss:GetVectors

ベクトルデータを取得します。

メソッド定義

get_vectors(request: GetVectorsRequest, **kwargs) → GetVectorsResult

リクエストパラメーター

パラメーター

タイプ

説明

request

GetVectorsRequest

バケット名、インデックス名、ベクトルキーのリストなどのリクエストパラメーターを設定します。詳細については、「GetVectorsRequest」をご参照ください。

戻り値

タイプ

説明

GetVectorsResult

クエリされたベクトルデータを含む戻り値。詳細については、「GetVectorsResult」をご参照ください。

get_vectors メソッドの完全な定義については、「get_vectors」をご参照ください。

サンプルコード

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

parser = argparse.ArgumentParser(description="ベクトル取得のサンプル")
parser.add_argument('--region', help='バケットが配置されているリージョン。', required=True)
parser.add_argument('--bucket', help='バケットの名前。', required=True)
parser.add_argument('--endpoint', help='他のサービスが OSS にアクセスするために使用できるドメイン名')
parser.add_argument('--index_name', help='ベクトルインデックスの名前。', required=True)
parser.add_argument('--account_id', help='アカウント ID。', required=True)

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

    # 環境変数から認証情報値を読み込みます
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # 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)

    keys = ['key1', 'key2']

    result = vector_client.get_vectors(oss_vectors.models.GetVectorsRequest(
        bucket=args.bucket,
        index_name=args.index_name,
        keys=keys,
        return_data=True,
        return_metadata=True
    ))

    print(f'状態コード: {result.status_code},'
          f' リクエスト ID: {result.request_id},'
          )

    if result.vectors:
        for vector in result.vectors:
            print(f'ベクトル ID: {vector}')


if __name__ == "__main__":
    main()

関連ドキュメント

ベクトルデータを取得するための完全なサンプルコードについては、「get_vectors.py」をご参照ください。