athenadb

? athenadb⚡️

CloudFlare Workers, 작업자 AI, D1 및 Vectorize가 작성된 API로서 Serverless, Displicated Vector 데이터베이스.

Athenadb는 API로 사용할 수있는 간단한 서버리스 분산 벡터 데이터베이스입니다. CloudFlare Workers AI, D1, Vectorize와 함께 작성되었습니다.

특징

• 간단한 API 엔드 포인트 : AthenADB는 다양한 데이터베이스 작업을위한 간단한 엔드 포인트를 제공하므로 모든 기술 수준의 개발자가 액세스 할 수 있습니다.
• 분산 특성 : 여러 데이터 센터에서 데이터 복제를 통해 Athenadb는 고 가용성과 탄력성을 보장합니다.
• 내장 데이터 복제 : CloudFlare Workers의 기본 아키텍처로 인해 데이터 센터에서 데이터가 자동으로 복제됩니다.
• 확장 성 : AthenADB는 다량의 벡터 텍스트 데이터를 처리하도록 설계되어 데이터 볼륨이 높은 프로젝트에 적합합니다.
• Serverless Architecture : AthenADB가 서버가 없기 때문에 인프라 관리에 대해 걱정할 필요가 없어 개발에 더 집중할 수 있습니다.

시작하기

• Wrangler를 다운로드하고 설치하십시오.
• wrangler login 으로 Wrangler에 로그인하십시오. Athenadb는 기능을 위해 $ 5/월 직원 가입이 필요합니다 .
• 다음 명령을 실행하십시오.

git clone https://github.com/TimeSurgeLabs/athenadb.git
cd athenadb
npm run create-vector
npm run create-db

출력 데이터베이스 ID를 복사하여 database_id 에서 wrangler.toml 에 붙여 넣습니다. 그런 다음 다음 두 가지 명령을 실행하십시오.

npm run init-db
npm run deploy

API URL로 출력을 가져와야합니다. 이제 API 엔드 포인트를 사용할 수 있습니다.

API 엔드 포인트

POST /:namespace/insert

텍스트 데이터를 데이터베이스에 삽입합니다. 텍스트는 CloudFlare AI를 사용하여 임베딩으로 변환되며 고유 식별자와 함께 저장됩니다.

• 요청 본문 :
  • input : 단일 문자열 (최대 1024 자).
  • inputs : 문자열 배열 (각 최대 1024 자).

POST /:namespace/query

유사한 텍스트 임베드에 대한 데이터베이스를 쿼리합니다. 반환 할 결과 수를 지정하려면 URL의 ?limit=number 지정하십시오. 기본값은 5이고 최대 값은 20입니다.

• 요청 본문 :
  • input : 쿼리를위한 단일 문자열. (최대 1024 자)
  • inputs : 배치 쿼리를위한 문자열 배열. (각 최대 1024 자)

GET /:namespace/:uuid

고유 식별자 (UUID)를 사용하여 데이터베이스에서 특정 항목을 검색합니다. 쿼리 매개 변수를 추가합니까 ?vector=true 쿼리 매개 변수를 추가합니까 ?db_id=true 항목과 함께 SQL 테이블 ID를 검색합니다.

GET /:namespace?limit=10&offset=0

주어진 네임 스페이스에서 모든 항목을 검색합니다. 한도는 최대 100 개의 항목으로 설정할 수 있습니다. 쿼리 매개 변수를 추가 ?vector=true 쿼리 매개 변수를 추가합니까 ?db_id=true 항목과 함께 SQL 테이블 ID를 검색합니다.

DELETE /:namespace/:uuid

고유 식별자 (UUID)를 사용하여 데이터베이스에서 특정 항목을 삭제합니다. 경고 :이 동작은 돌이킬 수 없습니다.

DELETE /:namespace

주어진 네임 스페이스에서 모든 항목을 삭제합니다. 경고 :이 동작은 돌이킬 수 없습니다.

POST /embeddings

데이터베이스에 저장하지 않고 주어진 텍스트에 대한 임베딩을 생성합니다.

• 요청 본문 :
  • text : 임베딩을 생성 해야하는 문자열.

GET /

'Hello World!' 응답으로.

사용 예제

텍스트 삽입

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/insert' , {
  method : 'POST' ,
  headers : { 'Content-Type' : 'application/json' } ,
  body : JSON . stringify ( { input : 'Your text here' } )
} )

데이터베이스 쿼리

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/query' , {
  method : 'POST' ,
  headers : { 'Content-Type' : 'application/json' } ,
  body : JSON . stringify ( { input : 'Query text' } )
} )

항목 검색

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/your-uuid' , {
  method : 'GET'
} )

항목 삭제

 fetch ( 'https://athenadb.yourusername.workers.dev/your-namespace/your-uuid' , {
  method : 'DELETE'
} )

임베딩 생성

 fetch ( 'https://athenadb.yourusername.workers.dev/embeddings' , {
  method : 'POST' ,
  headers : { 'Content-Type' : 'application/json' } ,
  body : JSON . stringify ( { text : 'Your text here' } )
} ) 

클라이언트

• 파이썬 클라이언트