タダã§ã™.
re:Invent ä¸ã« S3 Vectors ㌠GA ã•ã‚Œã¾ã—ãŸ.æ±äº¬ãƒªãƒ¼ã‚¸ãƒ§ãƒ³ã«ã‚‚ãã¦ãŠã‚Š,Terraform aws provider v6.24.0 㧠S3 Vectors ã®ã‚µãƒãƒ¼ãƒˆãŒå…¥ã£ã¦ã„ã‚‹ãŸã‚試ã—ã¦ã¿ã¾ã™.
aws.amazon.com
リリース概è¦
v6.24.0 ã§ã¯æ¬¡ã® S3 Vectors ã®ãƒªã‚½ãƒ¼ã‚¹ãŒã‚µãƒãƒ¼ãƒˆã•ã‚Œã¾ã—ãŸ.
ã“れらã®ãƒªã‚½ãƒ¼ã‚¹ã‚’æ±äº¬ãƒªãƒ¼ã‚¸ãƒ§ãƒ³ã§å®šç¾©ã—ã¦ä½¿ã£ã¦ã¿ã¾ã—ょã†.
以å‰æ›¸ã„ãŸè¨˜äº‹ã‚’ベースã«ãƒªã‚½ãƒ¼ã‚¹ã‚’作りã¾ã™.
resource "aws_s3vectors_vector_bucket" "blog" {
vector_bucket_name = "blog-s3-vectors"
}
resource "aws_s3vectors_index" "blog" {
index_name = "blog-s3-vectors-index"
vector_bucket_name = aws_s3vectors_vector_bucket.blog.vector_bucket_name
data_type = "float32"
dimension = 1024
distance_metric = "cosine"
}
ã“ã®å®šç¾©ã§ã™ã¨æ¬¡ã®ã‚ˆã†ãªå®Ÿè¡Œè¨ˆç”»ãŒã§ãã‚‹ã®ã§ä½œæˆã—ã¾ã™.
Terraform will perform the following actions:
+ resource "aws_s3vectors_index" "blog" {
+ creation_time = (known after apply)
+ data_type = "float32"
+ dimension = 1024
+ distance_metric = "cosine"
+ encryption_configuration = (known after apply)
+ index_arn = (known after apply)
+ index_name = "blog-s3-vectors-index"
+ region = "ap-northeast-1"
+ tags_all = {}
+ vector_bucket_name = "blog-s3-vectors"
}
+ resource "aws_s3vectors_vector_bucket" "blog" {
+ creation_time = (known after apply)
+ encryption_configuration = (known after apply)
+ force_destroy = false
+ region = "ap-northeast-1"
+ tags_all = {}
+ vector_bucket_arn = (known after apply)
+ vector_bucket_name = "blog-s3-vectors"
}
Plan: 2 to add, 0 to change, 0 to destroy.
Do you want to perform these actions?
Terraform will perform the actions described above.
Only 'yes' will be accepted to approve.
Enter a value: yes
aws_s3vectors_vector_bucket.blog: Creating...
aws_s3vectors_vector_bucket.blog: Creation complete after 0s
aws_s3vectors_index.blog: Creating...
aws_s3vectors_index.blog: Creation complete after 0s
Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
作æˆã•ã‚ŒãŸãƒªã‚½ãƒ¼ã‚¹ãŒä½œæˆã§ããŸã‹ã‚’ AWS CLI を使ã£ã¦ç¢ºèªã—ãŸã¨ã“ã‚æ„図通りæ±äº¬ãƒªãƒ¼ã‚¸ãƒ§ãƒ³ã«ãƒªã‚½ãƒ¼ã‚¹ãŒå˜åœ¨ã—ã¦ã¾ã—ãŸ.
⯠aws s3vectors list-vector-buckets --region ap-northeast-1
{
"vectorBuckets": [
{
"vectorBucketName": "blog-s3-vectors",
"vectorBucketArn": "arn:aws:s3vectors:ap-northeast-1:1234567891011:bucket/blog-s3-vectors",
"creationTime": "2025-12-14T12:34:42+09:00"
}
]
}
⯠aws s3vectors get-index --vector-bucket-name blog-s3-vectors --index-name blog-s3-vectors-index --region ap-northeast-1
{
"index": {
"vectorBucketName": "blog-s3-vectors",
"indexName": "blog-s3-vectors-index",
"indexArn": "arn:aws:s3vectors:ap-northeast-1:1234567891011:bucket/blog-s3-vectors/index/blog-s3-vectors-index",
"creationTime": "2025-12-14T12:34:43+09:00",
"dataType": "float32",
"dimension": 1024,
"distanceMetric": "cosine"
}
}
S3 Vectors ã«ãƒ†ã‚¹ãƒˆãƒ‡ãƒ¼ã‚¿ã‚’投入ã™ã‚‹
テストデータを投入ã—,検索ã—ã¦ã¿ã¾ã™.テストデータã¯ä»¥ä¸‹ã®ã‚ˆã†ã«ç”Ÿæˆã—㦠S3 Vectors ã«ã‚¢ãƒƒãƒ—ãƒãƒ¼ãƒ‰ã—ã¾ã™.
⯠cat input.json
{
"inputText": "This is test vector data."
}
⯠aws bedrock-runtime invoke-model --model-id "amazon.titan-embed-text-v2:0" --body fileb://input.json --content-type application/json --accept application/json --region ap-northeast-1 output.json
{
"contentType": "application/json"
}
⯠jq -c '.embedding' output.json > vector_data.json
⯠cat <<EOF > vector_upload.json
∙ [
{
"key": "doc1",
"data": {
"float32": $(cat vector_data.json)
},
"metadata": {
"source_text": "This is test vector data.",
"category": "test"
}
}
]
∙ EOF
⯠aws s3vectors put-vectors --vector-bucket-name blog-s3-vectors --index-name blog-s3-vectors-index --vectors file://vector_upload.json --region ap-northeast-1
投入ã—ãŸãƒ‡ãƒ¼ã‚¿ã‚’検索ã—ã¾ã™.æ„図通りã«æ¤œç´¢ã§ãã¾ã—ãŸ.
⯠jq '{float32: .embedding}' output.json > embedding.json
⯠aws s3vectors query-vectors --vector-bucket-name blog-s3-vectors --index-name blog-s3-vectors-index --top-k 3 --query-vector file://embedding.json --return-metadata --region ap-northeast-1
{
"vectors": [
{
"key": "doc1",
"metadata": {
"category": "test",
"source_text": "This is test vector data."
}
}
],
"distanceMetric": "cosine"
}
ã¾ã¨ã‚
GA ã•ã‚ŒãŸ S3 Vectors ã‚’ Terraform ã§ãƒªã‚½ãƒ¼ã‚¹ç®¡ç†ã‚’試ã—ã¦ãƒ¡ãƒ¢ã‚’ã¾ã¨ã‚ã¾ã—ãŸ.
