본문 바로가기
문서 목차
AkashiQ v0.1.0 · 참고자료

자주 묻는 질문

접속, 데이터 탐색, 수집, 품질, 보안에 대해 자주 나오는 질문

QUANTUM C&S

접속과 권한

로그인은 되는데 일부 메뉴가 보이지 않습니다. 메뉴는 그룹(팀) 권한에 따라 필터링됩니다. 권한이 없는 메뉴는 표시되지 않습니다. 거버넌스 담당자에게 필요한 메뉴 권한을 요청하세요. → 거버넌스 개요

비밀번호를 잊었습니다. AkashiQ는 사내 인증 계정을 그대로 사용하므로 포털에 별도 비밀번호가 없습니다. 사내 계정 담당자에게 초기화를 요청하세요.

자동 로그아웃이 자주 됩니다. 사내 인증 세션 정책에 따릅니다. 운영 담당자에게 세션 만료 정책을 확인하세요.

데이터 탐색

검색해도 데이터가 나오지 않습니다. 다음을 순서대로 확인하세요.

  1. 필터가 좁게 걸려 있는지
  2. 본인 권한이 그 데이터의 보안 등급에 도달하는지
  3. 애초에 등록되지 않은 데이터인지 — Data Catalogs에서 원본을 찾아보고, 있다면 데이터셋으로 등록

권한이 없는 데이터는 목록에 아예 나타나지 않으므로 "없는 것"과 구분되지 않습니다.

데이터셋과 테이블의 차이가 무엇입니까? 테이블은 쿼리 엔진이 인식하는 원본 단위이고, 데이터셋은 그 위에 사람이 이해할 수 있는 정보(설명, 보안 등급, 문서, 태그)를 붙인 것입니다.

프리뷰와 SQL 실행 결과가 다릅니다. 프리뷰는 앞부분 표본이며 정렬 · 필터가 적용되지 않습니다. 정확한 분석은 Compute에서 SQL로 수행하세요.

수집

수집 작업이 실패했습니다. 무엇을 봐야 합니까? 작업의 실행 이력에서 오류 메시지를 확인하세요. 가장 흔한 원인은 권한 부족, 쿼리 오류, 외부 시스템 응답 지연입니다. → 소스별 수집 설정

같은 데이터를 매일 자동으로 가져오려면? 수집 작업을 만든 뒤 파이프라인으로 실행하도록 등록합니다. 수집 화면에서 직접 스케줄을 등록하지는 않습니다. → Data Factory

증분 수집이 가능합니까? DB 수집은 조회 조건을 직접 작성해 증분을 구현합니다. 문서 수집은 커넥터가 증분 기준점을 관리합니다. 실시간 변경 반영이 필요하면 CDC 경로를 사용합니다.

수집 결과가 Data Hub에 보이지 않습니다. 적재만으로는 검색되지 않습니다. DataHub 등록에서 데이터셋으로 등록해야 합니다.

데이터 품질

데이터가 최신이 아닙니다. Pipeline Ops의 Data Quality 패널에서 신선도 판정을 확인하고, Spark 작업과 스트리밍 커넥터 상태를 함께 봅니다. 커넥터가 Running 이어도 적재가 멈출 수 있습니다.

잘못 적재된 데이터를 되돌릴 수 있습니까? 가능합니다. 계층에 따라 재구축(replay) 또는 스냅샷 롤백을 사용합니다. → 데이터 복구

등록되지 않은 설비의 데이터가 들어옵니다. 버려지지 않고 원본 계층에 적재됩니다. 자산을 등록하면 과거 데이터까지 소급 노출됩니다. 현황은 Pipeline Ops의 미등록 장비 패널에서 확인합니다.

분석

권한이 있는데도 접근이 거부됩니다. 접근 정책의 거부 목록이 허용보다 우선합니다. 감사 로그에서 거부 기록을 확인해 어떤 정책 때문인지 파악한 뒤 권한을 신청하세요.

쿼리가 너무 느립니다. 컬럼을 좁히고, 파티션 조건을 조회 조건에 넣고, 반복 조회는 데이터셋으로 저장하세요. 워커 증설보다 쿼리 개선이 효과가 큰 경우가 많습니다. → Compute

결과를 다른 사람과 공유하려면? 반복 사용할 결과는 파생 데이터셋으로 등록해 공유하는 것을 권장합니다. 외부 시스템에 공급할 경우 외부 Data API를 사용합니다.

보안과 규제

컬럼 값이 가려져 보입니다. 마스킹 규칙이 적용된 것입니다. 정상 동작이며, 분석에 원본 값이 꼭 필요하면 데이터 소유팀과 거버넌스 담당자에게 요청하세요. → 분류와 마스킹

누가 내 데이터를 조회했는지 알 수 있습니까? 감사 로그에서 대상으로 필터링해 확인합니다.

AI가 권한 없는 데이터를 보여줄 수 있습니까? 없습니다. AI는 질문한 사용자의 권한으로 조회하며, 모든 호출이 사용자 명의로 기록됩니다. → SAMANDA 소개

여기서 말하는 CSV가 무엇입니까? Computer System Validation, 즉 컴퓨터 시스템 검증입니다. 쉼표로 구분된 파일 형식이 아닙니다. → CSV 대응

AI

AI 응답이 사실과 다릅니다. 응답 위의 도구 호출을 펼쳐 실제로 조회된 원본 결과를 확인하세요. 요약 과정의 오해인지, 데이터 자체의 문제인지 구분됩니다.

AI가 예측을 해줍니까? 예측은 모델 서빙 기능이 담당하며, 연동된 환경에서 해당 패널로 표시됩니다. → KosmosAI 연계

기타

외부 인터넷 없이 운영됩니까? 예. 폐쇄망 운영을 전제로 설계했습니다. 이미지는 사내 레지스트리로 반입하고, 원천 데이터는 내부에 머무릅니다. → 아키텍처

모바일에서 사용할 수 있습니까? 탐색과 조회는 동작하지만, 쿼리 작성이나 표가 넓은 화면은 데스크톱이 적합합니다.

기능 요청은 어디로 하면 됩니까? 운영 담당자에게 전달하세요. 어떤 화면에서 무엇을 하려 했고 어떤 결과를 기대했는지 함께 적어 주시면 검토가 빠릅니다.