列出向量

注意

Amazon S3 Vectors 為 Amazon Simple Storage Service 的預覽版本，可能會有所變更。

您可以使用 ListVectors API 操作列出向量索引中的向量。如需每個頁面可傳回之向量數量上限的詳細資訊，請參閱 限制。當結果被截斷時，回應會包含分頁字符。如需 回應元素的詳細資訊ListVectors，請參閱《Amazon S3 API 參考》中的 ListVectors。您也可以使用 從指定的向量索引ListVectors匯出向量資料。 ListVectors 非常一致。WRITE 操作之後，您可以立即列出反映所有變更的向量。

使用 AWS CLI

若要列出向量，請使用下列範例命令。將使用者輸入預留位置取代為您自己的資訊。

segment-count 和 segment-index 參數可讓您將清單操作分割為多個平行請求。當您指定segment-count值 （例如 2) 時，您可以將索引分割成多個區段。segment-index 參數 （從 0 開始） 決定要列出的區段。此方法可透過啟用平行處理，協助改善列出大型向量索引時的效能。如需 segment-count和 的詳細資訊segment-index，請參閱《Amazon S3 API 參考》中的 ListVectors。

列出索引中的所有向量

請求範例：

aws s3vectors list-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --segment-count 2 \
  --segment-index 0 \
  --return-data \
  --return-metadata

回應範例：

{
    "vectors": [
        {
            "key": "vec3",
            "data": {
                "float32": [0.4000000059604645]
            },
            "metadata": {
                "nonFilterableKey": "val4",
                "filterableKey": "val2"
            }
        }
    ]
}

列出具有分頁的向量

請求範例：

aws s3vectors list-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --segment-count 2 \
  --segment-index 0 \
  --return-data \
  --return-metadata \
  --next-token "zWfh7e57H2jBfBtRRmC7OfMwl209G9dg3j2qM6kM4t0rps6ClYzJykgMOil9eGqU5nhf_gTq53IfoUdTnsg"

回應範例：

{
    "vectors": [
        {
            "key": "vec1",
            "data": {
                "float32": [0.5]
            },
            "metadata": {
                "nonFilterableKey": "val2",
                "filterableKey": "val1"
            }
        }
    ]
}