쿼리 실행 및 관리

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

쿼리를 입력하고 실행하는 방법과 입력한 쿼리를 저장하고 활용하는 방법을 설명합니다.

쿼리 모의 실행

쿼리 모의 실행을 시작하면 입력된 쿼리문은 정식으로 처리되지 않고, 해당 쿼리문을 처리할 때 스캔되는 데이터양이 얼만큼인지 측정하여 결과 창에 표시합니다. 스캔될 데이터양을 미리 측정하여 부과될 요금을 예측할 수 있습니다.
쿼리를 모의 실행하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 > Services > Big Data & Analytics > Data Query 메뉴를 차례대로 클릭해 주십시오.
2. Query Editor 메뉴를 클릭해 주십시오.
3. 데이터 소스를 선택한 후 쿼리 입력 창에 쿼리문을 입력해 주십시오.
   • 템플릿 쿼리를 이용할 경우 쿼리문에 데이터 소스가 정의되어 있으므로 직접 선택하지 않아도 됩니다. [쿼리] 탭 > [템플릿 쿼리] 버튼을 클릭한 후 원하는 쿼리를 선택하면 해당 쿼리문이 자동으로 입력됩니다.
4. [모의 실행] 버튼을 클릭해 주십시오.
5. 화면 하단의 모의 실행 결과를 확인해 주십시오.

쿼리 실행

쿼리를 실행하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 > Services > Big Data & Analytics > Data Query 메뉴를 차례대로 클릭해 주십시오.
2. Query Editor 메뉴를 클릭해 주십시오.
3. 데이터 소스를 선택한 후 쿼리 입력 창에 쿼리문을 입력해 주십시오.
   • 데이터베이스 드롭다운 메뉴에서 데이터베이스명을 선택하면 소스 경로를 전부 입력하지 않고 테이블명만 간단히 입력할 수 있습니다.
     
   • 템플릿 쿼리의 경우 데이터 소스는 'public_data' 소속 데이터베이스로 이미 정의되어 있습니다. [쿼리] 탭 > [템플릿 쿼리] 버튼을 클릭한 후 원하는 쿼리를 선택하면 바로 실행 가능한 쿼리문이 자동으로 입력됩니다.
   • 동일 쿼리를 재실행할 경우 효율적인 처리를 위해 결과 재사용 기능을 켤 수 있습니다. 자세한 내용은 쿼리 결과 재사용 설정을 참고해 주십시오.
4. [실행] 버튼을 클릭해 주십시오.
   • 쿼리 처리 시 스캔될 데이터양을 미리 측정하고 싶다면 [모의 실행] 버튼을 먼저 클릭하여 측정 결과를 확인한 후 [실행] 버튼을 클릭해 주십시오.
5. 화면 하단의 실행 결과를 확인해 주십시오.
   • 결과 영역에서 쿼리 결과 외에 다양한 정보를 확인할 수 있습니다. 결과 확인에 대한 자세한 내용은 쿼리 결과 조회를 참고해 주십시오.
   • 입력한 쿼리문은 페이지를 이동하면 사라지므로 필요시 쿼리문을 저장해 두십시오. 저장에 대한 자세한 내용은 쿼리문 저장을 참고해 주십시오.

Iceberg 테이블

Iceberg 테이블에 대한 쿼리를 수행할 수 있습니다. Apache Iceberg는 방대한 데이터를 분석하기 위한 고성능 테이블 포맷 입니다. Apache Iceberg 테이블 버전 1 과 2를 지원합니다.

Iceberg 테이블을 생성하려면 해당 페이지에서 설명하는 CREATE TABLE USING ICEBERG 문을 사용해 주십시오.

CREATE TABLE 테이블명 (col_name data_type) USING ICEBERG

Iceberg 테이블에 대해 다음 작업을 지원합니다.

• SELECT, DESCRIBE, SHOW STATS, SHOW CREATE TABLE
• INSERT, UPDATE, MERGE, DELETE
• ALTER TABLE, DROP TABLE, COMMENT

CREATE TABLE 테이블명 (col_name data_type)
with (
  "object_store_layout_enabled" = true, 
  "data_location" = 'data 저장 경로', 
  extra_properties = MAP(ARRAY['gc.enabled'], ARRAY['false'])
) 
USING ICEBERG;

쿼리 결과 재사용 설정

쿼리 결과 재사용이란 특정 시간 전에 처리된 쿼리에 의해 존재하는 결과를 다시 사용하는 것입니다. 동일 내용의 쿼리를 반복적으로 실행할 때 활용하면 쿼리 처리 시간을 절약할 수 있습니다.
결과 재사용은 쿼리문을 입력한 상태에서 실행 전에 설정해야 합니다. 결과 재사용을 설정하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 > Services > Big Data & Analytics > Data Query 메뉴를 차례대로 클릭해 주십시오.
2. Query Editor 메뉴를 클릭해 주십시오.
3. 쿼리 입력 창에 원하는 쿼리문을 입력해 주십시오.
4. 쿼리 창 상단 오른쪽에 있는 결과 재사용 항목의 재사용 안함을 클릭해 주십시오.
   
5. 드롭다운 메뉴에서 결과 재사용을 허용하는 시간을 선택해 주십시오.
   • 1시간 전, 12시간 전, 1일 전 중에 선택하거나 직접입력을 클릭해 최소 1분에서 최대 7일 이내로 설정할 수 있습니다.
   • 설정 후 쿼리 [실행] 버튼을 클릭하면 유효한 결과 존재 시 재사용됩니다.

파라미터를 사용한 쿼리 실행

쿼리에 변수를 포함하여 작성하고 실행 시점에 변수를 바인딩하여 동적인 쿼리 실행이 가능합니다. 다음은 파라미터를 사용한 쿼리 실행 예시입니다.

• 실행 쿼리 텍스트

  select * 
  from public_data.incheon_airport.cargo_flight_schedule_summer_arrival
  where TRY_CAST(year AS INTEGER) >= ?
    and TRY_CAST(year AS INTEGER) <  ?
    and airline = ?
  

• 파라미터
  • 파라미터1 : 2015
  • 파라미터2 : YEAR(NOW())
  • 파라미터3 : KOREAN AIR

스토리지 카탈로그

테이블을 생성하지 않고 Object Storage에 저장된 파일의 경로를 입력하여 직접 쿼리를 실행할 수 있습니다.
다음은 스토리지 카탈로그를 사용하여 Object Storage에 저장된 파일을 쿼리하는 예시입니다.

• 테이블 위치에 TABLE(object_storage.file.read('TYPE', 'PATH')) 구문 사용
  • TYPE : 파일 타입 (지원 가능 형식 : csv, tsv, json, avro, parquet, orc)
  • PATH : Object Storage에 저장된 파일의 경로

select * from TABLE(object_storage.file.read('csv', 's3a://test-bucket/path/file.csv')) ;

제공 Function

Data Query에서 제공하는 Function 목록입니다.

쿼리 관리

입력한 쿼리문을 다시 사용할 수 있도록 내 쿼리로 저장할 수 있으며, 저장한 쿼리문은 필요에 따라 수정, 복사, 삭제할 수 있습니다. 실행 예약 설정을 추가하여 저장한 쿼리문을 원하는 시간에 실행할 수 있습니다.

쿼리문 저장

직접 입력한 쿼리문 또는 템플릿 쿼리를 수정해 만든 쿼리문을 내 쿼리로 저장할 수 있습니다. 쿼리문을 저장하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 > Services > Big Data & Analytics > Data Query 메뉴를 차례대로 클릭해 주십시오.
2. Query Editor 메뉴를 클릭해 주십시오.
3. 쿼리 입력 창에 원하는 쿼리문을 입력해 주십시오.
   • 템플릿 쿼리를 이용할 경우 [쿼리] 탭 > [템플릿 쿼리] 버튼을 클릭한 후 원하는 쿼리를 선택하면 해당 쿼리문이 자동으로 입력됩니다.
4. 쿼리 창 상단에서 쿼리 탭의 오른쪽 옵션 메뉴에 마우스 오버해 주십시오.
   
5. 저장 또는 다른 이름으로 저장을 클릭해 주십시오.
6. 팝업 창에서 쿼리의 이름을 입력하고 [저장] 버튼을 클릭해 주십시오.
   • 쿼리가 내 쿼리 목록에 저장됩니다. 화면 왼쪽의 [쿼리] 탭 > [내 쿼리] 버튼을 클릭하면 저장된 쿼리 목록을 확인할 수 있습니다.
     

저장된 쿼리 편집

저장된 쿼리는 이름 또는 내용을 수정하거나, 다른 이름으로 저장하거나, 삭제할 수 있습니다. 저장된 쿼리를 편집하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 > Services > Big Data & Analytics > Data Query 메뉴를 차례대로 클릭해 주십시오.
2. Query Editor 메뉴를 클릭해 주십시오.
3. 화면 왼쪽의 [쿼리] 탭 > [내 쿼리] 버튼을 클릭해 주십시오.
4. 내 쿼리 목록 중 편집하려는 쿼리를 클릭해 주십시오.
   • 쿼리 창에 해당 쿼리의 내용이 입력됩니다.
5. 쿼리 창 상단에서 쿼리 탭의 오른쪽 옵션 메뉴에 마우스 오버해 주십시오.
   
6. 원하는 메뉴를 선택하여 클릭해 주십시오.
   • 이름 수정: 저장된 쿼리명을 수정하여 저장. 쿼리 창에서 내용을 수정한 상태로 이름 수정 시 내용도 함께 업데이트
   • 저장: 쿼리 창에서 내용을 수정한 후 실행하여 덮어쓰기 저장
   • 다른 이름으로 저장: 쿼리 내용을 복사하여 다른 이름으로 저장
   • 삭제: 해당 쿼리를 내 쿼리 목록에서 삭제

저장된 쿼리 실행 예약

저장한 쿼리문에 실행 예약 설정을 추가하여 원하는 시간에 실행할 수 있습니다. 실행 예약 설정 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 > Services > Big Data & Analytics > Data Query 메뉴를 차례대로 클릭해 주십시오.
2. Query Editor 메뉴를 클릭해 주십시오.
3. 화면 왼쪽의 [쿼리] 탭 > [내 쿼리] 버튼을 클릭해 주십시오.
4. 내 쿼리 목록 중 편집하려는 쿼리 항목의 오른쪽 옵션 메뉴에 마우스 오버해 주십시오.
5. 실행 예약 설정 메뉴를 클릭해 주십시오.
   • 실행 예약 설정: 저장된 쿼리문을 원하는 시간/주기에 실행되도록 실행 예약 정보를 설정합니다.
   • 실행 예약 제거: 설정 되어 있는 실행 예약 정보를 제거합니다.