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

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

最終更新日:Jun 03, 2026

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

アクセス許可

Alibaba Cloud アカウントには、デフォルトですべてのアクセス許可があります。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="vector get vectors sample")
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
    cfg.use_internal_endpoint = True  # パブリックネットワーク経由でアクセスするには、これを False に設定するか、この行を削除します。
    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'status code: {result.status_code},'
          f' request id: {result.request_id},'
          )

    if result.vectors:
        for vector in result.vectors:
            print(f'vector: {vector}')


if __name__ == "__main__":
    main()

関連ドキュメント

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