2026년 7월 27일 사용자 매뉴얼 내용 업데이트

이번 업데이트에서는 사용자 매뉴얼의 문서 버전을 v1.0.1로 유지하면서, current 개발 문서를 기준으로 한국어·영어 매뉴얼의 내용을 갱신했습니다. 여러 메뉴에 나뉘어 있던 사용 권한 설명을 한곳에 모으고, 외부 시스템에서 D.Hub 데이터를 조회하는 절차와 최신 API 참조를 보강했습니다.

버전 안내

• 문서 버전은 v1.0.1로 유지됩니다. 새 버전 태그나 문서 스냅샷을 만들지 않았습니다.
• v1.0.1의 한국어·영어 문서를 current 개발 문서와 같은 내용으로 갱신했습니다. 기존 v1.0.1 주소와 링크는 그대로 사용할 수 있습니다.
• 이번 변경은 현재 제공 중인 권한 동작과 공개 API 사용법을 더 정확하게 설명하는 문서 업데이트입니다. 새로운 제품 기능이나 API 버전을 배포한 것은 아닙니다.

사용 권한 설명 통합

공유 권한에 사용 권한(use) 전용 섹션을 추가했습니다. 커넥터·시크릿 문서와 서비스 계정 안내에 흩어져 있던 조건을 한곳에서 확인할 수 있습니다.

• 역할과 사용 권한 구분: 소유자·편집자·뷰어는 리소스의 조회·편집 범위를 정합니다. 사용 권한은 저장된 연결 정보나 시크릿 값을 실행 중에 사용하도록 허용합니다. 편집자나 뷰어 역할만으로 사용 권한이 자동 부여되지는 않습니다.
• 허용 범위 명시: 커넥터는 저장된 연결 정보와 자격 증명으로 연결을 실행합니다. 시크릿은 데이터 연결이나 도구가 저장된 값을 참조하게 합니다. 사용 권한만으로 목록을 조회하거나 설정과 비밀 값을 확인할 수는 없습니다.
• 컬렉션 전제 조건: 컬렉션 범위의 커넥터·시크릿을 사용하려면 대상이 상위 컬렉션의 소유자이거나 사용 권한을 가지고 있어야 합니다. 권한을 부여하는 사용자가 컬렉션 권한도 관리할 수 있으면 포털이 상위 컬렉션 사용 권한을 먼저 추가합니다.
• 부여·회수 동작: 리소스 소유자 또는 관리자가 커넥터·시크릿 편집 화면에서 사용자·그룹·서비스 계정을 검색해 사용 권한을 부여하거나 회수합니다. 모든 사용자에는 공개 사용 권한을 부여하지 않습니다.
• 서로 독립적인 권한: 사용 권한을 회수해도 소유자·편집자·뷰어 역할은 바뀌지 않습니다. 일반 역할을 변경해도 직접 부여한 사용 권한은 함께 회수되지 않습니다.

권한을 실제로 부여하는 화면과 절차는 데이터 연결 설정과 시크릿에서 확인할 수 있습니다.

외부 시스템에서 데이터 조회하기

관리자 가이드에 외부 데이터 조회를 추가했습니다. 서비스 계정으로 D.Hub 데이터를 파일이나 외부 데이터베이스에 반영할 때 필요한 준비, API 호출, 증분 처리와 운영 조건을 단계별로 설명합니다.

• 서비스 계정 준비: 외부 연동 전용 서비스 계정을 만들고 액세스 토큰을 발급한 뒤 대상 데이터셋 또는 컬렉션에 뷰어 역할을 부여합니다.
• 조회 API 선택: Get Table로 전체 데이터나 제한된 행을 CSV·JSON·Parquet·Arrow 형식으로 받습니다. Query Table로 필요한 컬럼과 행을 ClickHouse SELECT 문으로 조회합니다.
• 실행 예제: cURL과 Python에서 Bearer 토큰을 사용해 데이터를 내려받거나 SQL 조회 결과를 받는 예제를 제공합니다. 데이터셋 ID와 쿼리 가이드의 데이터베이스·테이블 이름을 일치시키는 방법도 안내합니다.
• 주기적 반영 설계: 수정 시각과 안정적인 ID를 워터마크로 저장하고, 외부 데이터베이스에는 upsert 방식으로 반영합니다. 커밋 성공 뒤 워터마크를 갱신하고, 실패 시 같은 범위를 다시 처리할 수 있도록 재시도·중복 처리 기준을 설명합니다.
• 제한 사항 명시: 조회 API는 D.Hub가 변경 이벤트를 외부로 밀어내는 실시간 복제나 CDC 기능이 아닙니다. 공통 변경 커서와 삭제 이벤트를 제공하지 않으므로 필요하면 삭제 상태 컬럼이나 주기적인 전체 대조를 사용합니다.
• 오류와 토큰 운영: 401, 403, 404, SQL 오류와 응답 지연의 확인 항목을 정리했습니다. 토큰은 소스 코드와 로그에 남기지 않고, 새 토큰의 호출 성공을 확인한 뒤 이전 토큰을 폐기하도록 안내합니다.

서비스 계정의 생성, 토큰 발급·교체·폐기와 리소스 권한 부여는 서비스 계정에서 확인할 수 있습니다.

v1.0.1 한국어·영어 문서 동기화

• 한국어 문서: current의 사용자 매뉴얼 91개, 생성된 API 참조와 사이드바 구성을 v1.0.1에 반영했습니다. 관리자 가이드의 외부 데이터 조회도 같은 탐색 구조에 포함했습니다.
• 영어 문서: 한국어 매뉴얼과 대응하는 영어 사용자 문서 91개를 같은 구조로 맞췄습니다. 사용 권한과 외부 데이터 조회 설명을 영어로 추가하고 관련 링크와 화면 이름을 갱신했습니다.
• API 참조: current에서 생성된 전체 공개 API 문서를 v1.0.1 한국어·영어 문서에 반영했습니다. 영어 문서의 API 분류와 탐색 라벨은 기존 번역을 유지했습니다.
• 주소 유지: 문서 버전을 추가하지 않았으므로 최신 문서 주소와 v1.0.1 링크 구조는 바뀌지 않습니다.

관련 설명 정정

사용 권한을 단순 조회 권한과 혼동하지 않도록 다음 문서의 표현과 연결 경로를 함께 정리했습니다.

• 에이전트: 에이전트 만들기·배포·쿼리 템플릿에서 연결과 시크릿을 실행할 때 필요한 사용 권한을 구분했습니다.
• D.Hub 어시스턴트와 지식: 채팅에서 자산을 조회하는 권한과 실행 중 연결·비밀 값을 사용하는 권한을 나누어 설명했습니다.
• 데이터 연결과 시크릿: 목록에서 메타데이터를 보는 권한, 설정을 편집하는 권한, 저장된 값을 사용하는 권한의 차이를 명확히 했습니다.
• LLM 모델과 서비스 계정: 모델 설정 조회와 실행 권한을 구분하고, 서비스 계정의 리소스 역할과 커넥터·시크릿 사용 권한을 각각 어디에서 부여하는지 안내했습니다.
• 관리자·개발자 가이드 연결: 관리자 개요와 API 인증 문서에서 외부 데이터 조회 절차로 바로 이동할 수 있도록 링크를 추가했습니다.

이번 변경의 핵심은 버전을 올리는 것이 아니라, v1.0.1에서 확인해야 할 현재 동작과 사용 절차를 한국어·영어 문서에 동일하게 제공하는 것입니다.