태그와 함께 벡터 인덱스 만들기

태그와 함께 벡터 인덱스 만들기

Amazon S3 벡터 인덱스를 만들 때 태그를 함께 붙이는 방법을 설명해요. 벡터 인덱스 태그 사용에는 표준 S3 API 요청 요금 외에 추가 비용이 들지 않아요.

출처: Creating vector indexes with tags

본문

Amazon S3 벡터 인덱스를 만들 때 태그를 붙일 수 있어요. 벡터 인덱스의 태그 사용에는 표준 S3 API 요청 요금 외에 추가 비용이 들지 않아요. 자세한 내용은 Amazon S3 pricing을 참고하고, 벡터 인덱스 태그에 대한 자세한 내용은 Using tags with S3 vector indexes를 참고해 주세요.

권한 (Permissions)

태그와 함께 벡터 인덱스를 만들려면 다음 권한이 있어야 해요.

  • s3vectors:CreateIndex
  • s3vectors:TagResource

오류 문제 해결 (Troubleshooting errors)

태그와 함께 벡터 인덱스를 만들려고 할 때 오류가 발생하면 다음을 확인해 볼 수 있어요.

  • 벡터 인덱스를 만들고 여기에 태그를 추가하는 데 필요한 권한이 있는지 확인해 주세요.
  • IAM 사용자 정책에 속성 기반 접근 제어(ABAC) 조건이 있는지 확인해 주세요. 특정 태그 키·값으로만 벡터 인덱스에 라벨을 붙이라고 요구될 수 있어요. 자세한 내용은 Using tags for attribute-based access control (ABAC) 문서를 참고해 주세요.

절차 (Steps)

태그가 적용된 벡터 인덱스는 Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, 그리고 AWS SDK로 만들 수 있어요.

  1. AWS Management Console에 로그인하고 Amazon S3 콘솔(https://console.aws.amazon.com/s3/)을 엽니다.
  2. 왼쪽 탐색 창에서 vector indexes를 선택합니다.
  3. 새 벡터 인덱스를 만들려면 create vector index를 선택합니다.
  4. 평소처럼 벡터 인덱스를 만듭니다. 자세한 내용은 Creating a vector index in a vector bucket을 참고해 주세요.
  5. Create vector index 페이지에서 새 벡터 인덱스를 만들 때 Tags가 옵션으로 제공됩니다.
  6. 벡터 인덱스 이름을 입력합니다.
  7. Add new Tag를 선택해 태그 편집기를 열고 태그 키-값 쌍을 입력합니다. 태그 키는 필수지만 값은 선택 사항이에요.
  8. 다른 태그를 추가하려면 Add new Tag를 다시 선택합니다. 최대 50개의 태그 키-값 쌍을 입력할 수 있어요.
  9. 새 벡터 인덱스 옵션 지정을 마쳤으면 Create vector index를 선택합니다.

Amazon S3 REST API로 태그와 함께 벡터 인덱스를 만드는 방법은 Amazon S3 Vectors API Reference의 CreateIndex 섹션을 참고해 주세요.

AWS CLI를 설치하는 방법은 AWS Command Line Interface User Guide의 Installing the AWS CLI를 참고해 주세요. 다음 CLI 예시는 AWS CLI로 태그와 함께 벡터 인덱스를 만드는 방법을 보여줘요. 명령을 사용할 때는 사용자 입력 플레이스홀더를 여러분의 정보로 바꿔 넣으세요.

벡터 인덱스를 만들 때는 구성 세부 정보를 제공해야 하며 다음 명명 규칙을 사용해 주세요: example-vector-index

aws s3vectors create-index --vector-bucket-name acc-bucket \
 --data-type "float32" \
 --index-name accounts-index \
 --dimension 1024 --distance-metric euclidean \
 --tags Department=Accounting,Stage=Prod

더 알아보기 (Learn more)