SQL Studio
SQL Studio는 데이터셋, 테이블과 온톨로지 객체 유형을 조회하는 전용 앱입니다. 표 데이터 읽기 및 쓰기, 대화형 분석과 베타 Ontology SQL 함수 작성을 지원합니다.
접근과 모드
관리자가 Control Panel의 Application access에서 활성화한 뒤 Applications 메뉴, 내장 SQL console의 확장 버튼 또는 Compass의 SQL 워크시트에서 열 수 있습니다.
리소스 탐색기 도구 모음의 모드 선택기는 표시할 리소스와 실행 엔진을 함께 바꿉니다.
| 모드 | 엔진과 작업 |
|---|---|
| Data mode | Furnace가 표 데이터셋, Iceberg 테이블과 가상 테이블을 조회합니다. SELECT와 CREATE TABLE을 지원하며 INSERT, UPDATE, DELETE는 Iceberg에 적용합니다. |
| Object mode | Ontology SQL이 객체 유형과 다대다 링크를 SELECT로 조회합니다. Ontology Manager에 정의한 객체를 대상으로 하는 읽기 전용 모드입니다. |
Furnace 쓰기 출력에는 여러 SQL 정의를 보관하고 그중 Active 정의로 예약 또는 수동 재빌드를 수행할 수 있습니다.
워크시트와 쿼리 실행
일회성 작업은 scratchpad에서 시작하고, 보존할 쿼리는 개인 또는 프로젝트 워크시트로 저장합니다. 저장 워크시트는 버전 이력이 있으며 수동 저장 사이의 미저장 변경도 세션 간 보존됩니다. 자세한 공유 및 복원 조건은 워크시트를 확인합니다.
편집기는 문법 강조, 테이블/객체/열 자동 완성과 인라인 오류를 제공합니다. Run이나 표시된 단축키로 실행하며 일부 SQL만 선택하여 실행할 수도 있습니다.
데이터 모드의 리소스 경로 또는 RID는 백틱으로 감쌉니다. 다음은 브랜치를 지정한 표 데이터 참조 예시이며 이름과 경로는 실제 환경에 맞춥니다.
SELECT * FROM `branch_name`.`/path/to/dataset`;
객체 모드는 객체 유형 RID를 참조합니다.
SELECT * FROM `ri.ontology.main.object-type.<object-type-rid>`;
Iceberg 브랜치와 시간 이동 표기는 SQL 문법의 리소스별 규칙을 따릅니다.
AIP 지원
AIP 사이드 패널은 SQL 생성, 설명과 오류 조사를 지원하며 같은 세션에서 후속 질문을 유지합니다. 현재 편집기 내용, 쿼리가 참조한 데이터셋/테이블/객체 유형 스키마와 현재 모드의 SQL 문법을 사용합니다. 생성 SQL로 편집기 전체를 교체하거나 기존 쿼리 뒤에 추가할 수 있습니다.
사용자에게 AIP 및 core assistant features가 활성화되어야 합니다. 조직과 대상 리소스 프로젝트의 활성 조건은 SQL 권한에서 구분합니다.
결과와 미리보기 한도
기본 결과 미리보기는 1,000행입니다. Query 권한이 있으면 설정에서 최대 10,000행까지 늘릴 수 있습니다. 표와 차트 모두 이 한도를 적용합니다. 100,000행 결과의 기본 차트도 전체가 아니라 처음 1,000행으로 만들어진다는 점을 고려해야 합니다.
함수와 외부 연결
Object mode의 Ontology SQL 함수는 매개변수 있는 객체 조회를 게시하여 Foundry에서 재사용합니다. Furnace 외부 조회는 Arrow Flight SQL 또는 REST API를 사용할 수 있습니다. 객체 조회를 외부 MCP 클라이언트에 제공하려면 Ontology MCP를 사용합니다. 각 경로에는 기반 리소스 권한이 별도로 필요합니다.