NIMORO Probe

Prev Next

VPC 환경에서 이용 가능합니다.

NIMORO Probe는 사용자가 조건과 상황에 맞게 SQL을 작성하여 서비스의 데이터를 다양하고 깊이 있게 분석할 수 있도록 빠른 조회 속도와 분석 환경을 제공합니다.

참고
  • 프로브 쿼리 결과 파일은 고객 데이터 분석 서비스의 경우 고객이 지정한 Object Storage Bucket에 저장됩니다. 네이버 데이터 분석 서비스의 경우도 프로브 쿼리 결과 파일은 다운로드 가능하며 데이터 박스 내 하둡 클러스터의 HDFS /user/nimoro/probe 경로에 저장됩니다.
  • NIMORO Probe에서 SQL을 수행하기 전에 다음을 점검해야 합니다.
    • Data Catalog에서 스키마 로딩이 진행되었는지 확인
    • 조회하고자 하는 db 및 table에 적절한 권한이 부여되어 있는지 확인

NIMORO Probe 화면

NIMORO Probe의 화면은 다음과 같이 구성되어 있습니다.

nimoro-probe-vpc_screen_query_editor_ko

영역 설명
① 메뉴명 현재 확인 중인 메뉴 이름
② 커넥터 드롭다운에서 조회할 커넥터 선택
  • Trino: Hive 커넥터보다 데이터 처리 결과 빠름
  • Hive: 속도는 상대적으로 느리나 대량의 데이터를 안정적으로 분석 가능
Query Editor 쿼리 입력(Query Editor 참조)
Saved Query 자주 사용하는 쿼리 목록(Saved Query 참조)
Sample Query 샘플 쿼리 목록(Sample Query 참조)
Recent Query 최근 사용한 쿼리 목록(Recent Query 참조)
⑦ 데이터베이스/테이블 영역
  • Table List: 사용자가 접근 권한이 있는 데이터베이스와 테이블/컬럼 목록 조회
  • My Temp: Temp DB 내 생성된 테이블(Temp Table) 목록 조회. 필요한 데이터만 추출하여 작은 사이즈의 분석용 테이블 생성 가능
    • 서비스매니저가 커넥터별로 Temp DB 설정을 한 경우에만 사용 가능
    • Trino 커넥터로 테이블 생성 시 with 문 내 조건을 필수 입력하여 생성
    • 테이블 작성자 외에는 조회 불가. 단, Temp DB를 조회 가능하도록 Data Catalog 서비스에서 권한을 부여한 경우, 테이블 작성자 외에도 조회 가능
  • i-nimoro_refresh: 클릭 시 테이블 및 DB 목록 갱신
⑧ 쿼리 입력창 SQL 쿼리 입력
  • 2개 이상의 쿼리문 동시 실행 불가
  • 일반 서비스 DB: SELECT 권한만 허용
  • My Temp DB: SELECT, CREATE, INSERT, UPDATE, DROP, ALTER 권한 허용
  • 각 클러스터별 쿼리 엔진 설정과 버전에 따라 허용 범위가 다름
RUN 클릭 시 사용자가 설정한 조회 조건으로 쿼리 실행
  • Recent Query에 이력이 자동 저장되어 조회 상태 확인 및 결과 다운로드 가능
Explain 클릭 시 사용자가 작성한 쿼리 실행 계획 확인 가능
Save as 클릭 시 쿼리 새 이름으로 저장
Clear 클릭 시 조회 조건 초기화
⑬ 쿼리 조회 결과 쿼리 실행 후 데이터 조회 결과 표시
  • [Sample Query 둘러보기] 버튼: 클릭 시 Sample Query로 이동
참고

네이버 데이터 분석 서비스의 경우 현재 Trino connector로 Temp 테이블에 insert 쿼리 기능이 제공되지 않습니다.
추후 Trino 버전 업그레이드를 통해 해당 기능 지원 예정입니다.

Query Editor 실행

SQL을 작성하여 데이터를 분석하는 방법은 다음과 같습니다.

  1. NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
  2. 좌측 메뉴에서 i-nimoro_probe(NIMORO Probe)을 클릭해 주십시오.
    • 기본적으로 [Query Editor] 화면이 표시됩니다.
    • NIMORO Probe 메뉴의 다른 페이지를 열고 있다면 [Query Editor] 버튼을 클릭해 주십시오.
  3. 분석할 커넥터를 드롭다운 메뉴에서 선택해 주십시오.
  4. Query Editor의 입력창에 분석에 필요한 SQL문을 작성해 주십시오.
    • 필요에 따라 [Explain], [Save as], [Clear] 버튼을 클릭해 정보 확인, 저장, 초기화해 주십시오. 각 버튼에 대한 설명은 Query Editor 화면을 참조해 주십시오.
  5. [RUN] 버튼을 클릭해 주십시오.
    • 조회 결과가 화면 하단에 표시됩니다.
    • 필요에 따라 [Explain], [Save as], [Clear] 버튼을 클릭해 정보 확인, 저장, 초기화해 주십시오. 각 버튼에 대한 설명은 Query Editor 화면을 참조해 주십시오.
    • 실행 후 화면 및 각 버튼에 대한 설명은 Query Editor 실행 후 화면을 참조해 주십시오.

Query Editor 실행 후 화면

쿼리 실행 후 Query Editor 화면은 다음과 같이 구성되어 있습니다.

nimoro-probe-vpc_screen_query_editor_after_ko

영역 설명
① 쿼리 조회 결과
  • Query Result: 쿼리 실행 후 데이터 조회 결과 표시
  • Query: 입력한 쿼리 내용 표시
  • 최대 1,000건까지 조회 가능하며, 모든 결과 값은 파일을 다운로드하여 확인
  • 조회 결과는 Recent Query에서 72시간 내 다운로드 및 확인 가능하며, 조회 이력은 30일간 제공됨
  • 고객 데이터 분석 서비스의 경우 고객이 지정한 Object Storage에 저장
  • 네이버 데이터 분석 서비스의 경우도 프로브 쿼리 결과 파일은 다운로드 가능하며 데이터 박스 내 HDFS 경로에 저장
Download 클릭 시 데이터 결과 파일 다운로드
  • 파일은 CSV, TSV 형식을 지원하며, 최대 100 MB까지 다운로드 가능
  • 일부 데이터 조회 건수나 파일 사이즈가 대용량인 경우 파일 생성까지 시간 소요, 파일 크기가 100 MB를 초과할 경우 파일 다운로드 불가할 수 있음
  • 고객 데이터 분석 서비스의 경우 고객이 지정한 Object Storage에 저장
  • 네이버 데이터 분석 서비스의 경우도 프로브 쿼리 결과 파일은 다운로드 가능하며 데이터 박스 내 HDFS 경로에 저장
참고

csv 파일로 다운로드 시 필드 값에 콤마(,)가 포함되어 있을 경우, 엑셀과 같은 스프레드시트 툴에서 컬럼이 분리되어 보일 수 있으므로 엑셀 형식의 파일로 다운로드하는 것을 권장합니다.

Saved Query

저장된 쿼리를 이용하여 데이터를 조회할 수 있습니다.

Saved Query 화면

Saved Query 화면은 다음과 같이 구성되어 있습니다.

nimoro-probe-vpc_screen_saved_query_ko

영역 설명
① 메뉴명 현재 확인 중인 메뉴 이름
② 검색창 쿼리 이름 또는 내용으로 검색하여 필터링
③ 카테고리 영역 저장한 쿼리 카테고리 목록
④ 쿼리 목록 저장한 쿼리 목록 조회
  • Sort by 클릭 시 최근 수정 순 또는 이름 오름차순으로 정렬 가능
RUN 클릭 시 쿼리 조회 페이지로 이동
⑥ 추가 기능 i-nimoro_more: 클릭하여 쿼리 수정 또는 쿼리 삭제

카테고리 추가

Saved Query에서 카테고리를 추가하는 방법은 다음과 같습니다.

  1. NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
  2. 좌측 메뉴에서 i-nimoro_probe(NIMORO Probe)을 클릭해 주십시오.
  3. Saved Query > 카테고리 추가를 차례대로 클릭해 주십시오.
  4. 추가할 카테고리 이름을 입력해 주십시오.
  5. [SAVE] 버튼을 클릭해 주십시오.

카테고리 이름 수정

Saved Query에서 카테고리 이름을 수정하는 방법은 다음과 같습니다.

  1. NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
  2. 좌측 메뉴에서 i-nimoro_probe(NIMORO Probe)을 클릭해 주십시오.
  3. i-nimoro_edit1을 클릭해 주십시오.
  4. 수정할 카테고리 이름을 입력해 주십시오.
  5. [SAVE] 버튼을 클릭해 주십시오.

카테고리 삭제

Saved Query에서 카테고리를 삭제하는 방법은 다음과 같습니다.

참고

카테고리에 쿼리가 1개 이상 포함된 경우 카테고리를 삭제할 수 없습니다. 삭제 전 반드시 카테고리를 비워주십시오.

  1. NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
  2. 좌측 메뉴에서 i-nimoro_probe(NIMORO Probe)을 클릭해 주십시오.
  3. i-nimoro_edit > i-nimoro_delete Delete Category를 클릭해 주십시오.

쿼리 수정

Saved Query에서 저장된 쿼리를 수정하는 방법은 다음과 같습니다.

  1. NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
  2. 좌측 메뉴에서 i-nimoro_probe(NIMORO Probe)을 클릭해 주십시오.
  3. 수정하려는 쿼리 우측 i-nimoro_more > i-nimoro_edit Edit를 클릭해 주십시오.
  4. 저장된 쿼리 수정 화면이 나타나면 정보를 수정해 주십시오.
    • Category: 카테고리 변경
    • Title: 수정할 쿼리 이름 입력
    • Query 작성: 수정할 쿼리 내용 입력
    • Descriptions: 수정할 쿼리 설명 입력
  5. [SAVE AS] 또는 [SAVE] 버튼을 클릭해 주십시오.
    • [SAVE AS] 버튼: 내용 수정 후 새로운 쿼리로 저장
    • [SAVE] 버튼: 내용 수정 후 기존 쿼리에 저장

쿼리 삭제

Saved Query에서 쿼리를 삭제하는 방법은 다음과 같습니다.

  1. NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
  2. 좌측 메뉴에서 i-nimoro_probe(NIMORO Probe)을 클릭해 주십시오.
  3. 수정하려는 쿼리 우측 i-nimoro_more > i-nimoro_delete Delete를 클릭해 주십시오.
  4. [삭제] 버튼을 클릭해 주십시오.

쿼리 새 이름으로 저장

쿼리를 새 이름으로 저장하는 방법은 다음과 같습니다.

  1. NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
  2. 좌측 메뉴에서 i-nimoro_probe(NIMORO Probe)을 클릭해 주십시오.
  3. Query Editor, Sample Query, Recent Query 메뉴에서 [Save as] 버튼을 클릭해 주십시오.
  4. 쿼리 저장 팝업 창이 나타나면 정보를 입력 및 선택해 주십시오.
    • 저장할 Query 타이틀: 저장할 쿼리 제목 입력
    • Category 선택: 쿼리를 저장할 카테고리 선택
      • 필요한 경우 [새 카테고리에 저장] 버튼을 클릭하여 카테고리 생성
  5. [SAVE] 버튼을 클릭해 주십시오.

Sample Query 화면

Sample Query 화면은 다음과 같이 구성되어 있습니다.

참고

Sample Query는 NIMORO Studio 메뉴에서 작성한 샘플 쿼리가 사용자에게 제공되는 기능입니다. 자세한 내용은 NIMORO Studio의 Probe Manage > Sample Query를 참조해 주십시오.

nimoro-probe-vpc_screen_sample_query_ko

영역 설명
① 메뉴 영역 현재 확인 중인 메뉴 이름 및 설명
② 검색창 쿼리 이름 또는 내용으로 검색하여 필터링
③ 카테고리 샘플 쿼리 카테고리 목록
④ 샘플 쿼리 정보 샘플 쿼리 제목 및 내용
Share 클릭하여 샘플 쿼리 URL 복사
Save as 클릭하여 쿼리 새 이름으로 저장
RUN 클릭하여 쿼리 조회 페이지로 이동

Recent Query 화면

Recent Query 화면은 다음과 같이 구성되어 있습니다.

nimoro-probe-vpc_screen_recent_query_ko

영역 설명
① 메뉴명 현재 확인 중인 메뉴 이름
② 검색창 쿼리 이름 또는 내용으로 검색하여 필터링
③ 최근 사용한 위저드 목록 최근 사용한 위저드 목록 조회
Save as 클릭하여 쿼리 새 이름으로 저장
RUN 클릭하여 쿼리 조회 페이지로 이동