

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Daftar vektor
<a name="s3-vectors-list"></a>

Anda dapat mencantumkan vektor dalam indeks vektor dengan operasi [ListVectors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListVectors.html)API. Untuk informasi lebih lanjut tentang jumlah maksimum vektor yang dapat dikembalikan per halaman, lihat[Keterbatasan dan pembatasan](s3-vectors-limitations.md). Responsnya mencakup token pagination saat hasilnya terpotong. Untuk informasi selengkapnya tentang elemen respons`ListVectors`, lihat [ListVectors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListVectors)di Referensi *API Amazon S3*. Anda juga dapat menggunakan `ListVectors` untuk mengekspor data vektor dari indeks vektor tertentu. `ListVectors`sangat konsisten. Setelah operasi WRITE, Anda dapat segera membuat daftar vektor dengan semua perubahan yang tercermin. 

## Menggunakan AWS CLI
<a name="list-vectors-index-cli"></a>

Untuk daftar vektor, gunakan contoh perintah berikut. Ganti *user input placeholders* dengan informasi Anda sendiri.

`segment-index`Parameter `segment-count` dan memungkinkan Anda untuk mempartisi operasi listing Anda di beberapa permintaan paralel. Ketika Anda menentukan `segment-count` nilai (seperti`2`), Anda membagi indeks menjadi banyak segmen. `segment-index`Parameter (mulai dari 0) menentukan segmen mana yang akan dicantumkan. Pendekatan ini membantu meningkatkan kinerja saat mencantumkan indeks vektor besar dengan mengaktifkan pemrosesan paralel. Untuk informasi selengkapnya tentang `segment-count` dan`segment-index`, lihat [ListVectors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListVectors)di Referensi *API Amazon S3*.

**Untuk daftar semua vektor dalam indeks**

Contoh permintaan:

```
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
```

Contoh respons:

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

**Untuk daftar vektor dengan pagination**

Contoh permintaan:

```
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"
```

Contoh respons:

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

## Menggunakan AWS SDKs
<a name="list-vectors-index-sdk"></a>

------
#### [ SDK for Python ]

Contoh: Daftar vektor dalam indeks vektor

```
import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#List vectors in your vector index 

response = s3vectors.list_vectors( 
    vectorBucketName="media-embeddings",
    indexName="movies",
    maxResults = 600,
    returnData = True,
    returnMetadata = True
)

vectors = response["vectors"]

print(vectors)
```

Contoh: Daftar semua vektor dalam indeks vektor secara paralel

```
import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#List vectors in the 1st half of vectors in the index.
response = s3vectors.list_vectors( 
    vectorBucketName="media-embeddings",
    indexName="movies",
    segmentCount=2,
    segmentIndex=1,
    maxResults = 600,
    returnData = True,
    returnMetadata = True
)

vectors = response["vectors"]

#List vectors starting from the 2nd half of vectors in the index.
# This can be ran in parallel with the first `list_vectors` call.
response = s3vectors.list_vectors( 
    vectorBucketName="media-embeddings",
    indexName="movies",
    segmentCount=2,
    segmentIndex=1,
    maxResults = 600,
    returnData = True,
    returnMetadata = True
)

vectors = response["vectors"]

print(vectors)
```

------