dgraph-io/dgraph-js

해결하는 문제

Dgraph(분산 그래프 데이터베이스)와 통신해야 하는 JavaScript 애플리케이션을 구축하려면 신뢰할 수 있는 클라이언트가 필요합니다. 이 라이브러리는 스키마 관리, 트랜잭션, 쿼리 및 변형을 위한 고수준 API를 제공하여 저수준 gRPC 코드를 직접 작성할 필요를 없애줍니다. 또한 연결 세부 정보, 인증 및 TLS를 처리하므로 그래프 데이터에 집중할 수 있습니다.

작동 방식

클라이언트는 gRPC를 사용하여 Dgraph 클러스터와 통신합니다. dgraph://localhost:9080과 같은 연결 문자열이나 자격 증명, API 키 또는 TLS 설정이 포함된 연결 문자열을 사용하여 연결합니다. 공식 Go 클라이언트의 설계를 밀접하게 따릅니다.

주요 작업은 다음과 같습니다.

• Alter: Operation 객체를 사용하여 스키마를 변경하거나 데이터를 삭제합니다.
• 트랜잭션: 읽기 전용 또는 최선 노력 트랜잭션을 생성하고 명시적으로 커밋하거나 폐기합니다.
• 변형: JSON 또는 RDF N-Quads로 데이터를 삽입하고 선택적으로 즉시 커밋하거나 인덱스 충돌 검사를 건너뜁니다.
• 쿼리: 변수를 사용하여 GraphQL± 쿼리를 실행하고 JSON 응답을 얻습니다.
• Upsert: 하나의 요청에서 쿼리와 변형을 결합하고 선택적으로 조건부 실행을 수행합니다.
• 멀티 테넌시: loginIntoNamespace를 사용하여 특정 네임스페이스에 로그인합니다.
• 디버그 모드: 작업 중에 유용한 디버그 메시지를 출력합니다.
• 헤더: 인증 토큰과 같은 사용자 지정 메타데이터를 gRPC 호출에 전달합니다.

모든 클라이언트 메서드는 Promise를 반환하며 라이브러리는 JavaScript와 TypeScript 모두에서 작동합니다(타입 패키지의 도움으로).

대상 사용자

Dgraph를 그래프 데이터베이스로 사용하는 Node.js 애플리케이션을 개발하는 개발자. JavaScript에서 그래프 쿼리를 수행하거나 스키마를 관리하거나 트랜잭션을 실행해야 하는 모든 사람에게 적합하며, 특히 Dgraph의 쿼리 언어와 개념에 이미 익숙한 사람에게 적합합니다.

주요 특징

• Dgraph가 유지 관리하는 공식 클라이언트로 현재 서버 버전과의 호환성을 보장합니다.
• 효율적이고 지연 시간이 짧은 통신을 위해 gRPC 기반으로 구축되었습니다.
• 여러 Dgraph 버전을 지원하며 버전별 클라이언트 릴리스가 있습니다.
• ACL 자격 증명, API 키, 베어러 토큰 및 TLS 옵션을 포함한 연결 문자열을 지원합니다.
• 특정 네임스페이스에 대한 멀티 테넌트 로그인을 허용합니다.
• 커밋, 폐기 및 재시도 지침이 포함된 트랜잭션 작업을 제공합니다.
• JSON 및 RDF N-Quad 변형을 모두 처리합니다.
• @if 지시문을 사용한 upsert 및 조건부 변형을 지원합니다.
• 디버깅 및 메타데이터 헤더 기능을 포함합니다.
• 빠른 시작 및 TLS 설정을 위한 예제 프로젝트를 포함합니다.