Orbit API

Orbit에 대한 쿼리 실행, 스키마 조회, 클러스터 상태 확인을 위한 REST API.

히스토리 GitLab 18.10에서 knowledge_graph 라는 플래그 와 함께 도입 되었습니다. 이 기능은 실험 단계이며 GitLab 테스팅 계약 대상입니다. Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조하세요. 이 기능은 테스트용으로 사용 가능하지만 프로덕션 환경에는 준비되지 않았습니다. 이 API를 사용하여 Orbit 에 대한 쿼리를 실행하고, 스키마를 조회하며, 클러스터 상태를 확인합니다. 쿼리 생성 # Orbit gRPC 서비스에 대한 쿼리를 생성하고 실행합니다. POST /api/v4/orbit/query 지원되는 속성: 속성 유형 필수 설명 query 객체 예 쿼리 DSL 객체. query_type 문자열 아니요 쿼리 언어. json 만 지원됨. 기본값은 json . response_format 문자열 아니요 raw 또는 llm 중 하나. 기본값은 raw . 성공하면 200 OK 와 다음 응답 속성이 반환됩니다: 속성 유형 설명 result 배열 또는 문자열 쿼리 결과. raw 이면 배열, llm 이면 문자열. query_type 문자열 쿼리 언어(예: json ). raw_query_strings 문자열 배열 실행된 기본 쿼리. row_count 정수 반환된 행 수. 예시 # 사용자명으로 사용자 조회: curl --request POST \ --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Content-Type: application/json" \ --data '{ "query": { "query_type": "search", "node": {"id": "u", "entity": "User", "filters": {"username": "john_smith"}} } }' \ --url "https://gitlab.example.com/api/v4/orbit/query" 응답 예시: { "result" : [ { "u_id" : 1 , "u_username" : "john_smith" , "u_name" : "John Smith" , "u_state" : "active" , "u_type" : "User" } ] , "query_type" : "search" , "row_count" : 1 } 프로젝트에서 병합된 머지 리퀘스트 찾기: curl --request POST \ --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Content-Type: application/json" \ --data '{ "query": { "query_type": "traversal", "nodes": [ {"id": "p", "entity": "Project", "node_ids": [8]}, {"id": "mr", "entity": "MergeRequest", "filters": {"state": "merged"}} ], "relationships":