쿼리 결과 데이터 관리

쿼리 결과 저장 위치

쿼리 결과 데이터를 저장 할 Object Storage 버킷 및 하위 경로를 설정해야 쿼리 실행이 가능합니다. 쿼리 결과 저장 위치는 한 개만 설정 가능합니다.

안내

• 쿼리 결과 저장 위치는 한 개만 설정 가능합니다.
• 버킷 생성 및 권한 관련 자세한 정보는 쿼리 결과 저장소 준비를 참고해 주세요.

1. 카카오클라우드 콘솔 > Analytics > Data Query 메뉴로 이동합니다.

2. 쿼리 편집기 메뉴에서 설정 탭으로 이동합니다.

3. 쿼리 결과 저장 위치 설정을 위해 [관리] 버튼을 클릭합니다.

4. 쿼리 결과 저장 위치 설정 팝업창에서 정보를 입력한 후, [저장] 버튼을 클릭합니다.

   항목	필수	설명
   버킷	필수	쿼리 결과를 저장 할 Object Storage의 버킷을 선택 ⚠️ 사전에 Object Storage에서 버킷이 생성되어어 있어야 합니다.
   상세 경로	선택	하위 상세 경로를 설정 - 새로운 경로를 생성하거나, 기존에 생성된 경로를 설정할 수 있습니다.

5. 저장된 Object Storage 경로를 확인합니다. 경로 클릭 시 Object Storage의 해당 버킷으로 이동합니다.

쿼리 결과 데이터

• 버킷 및 하위 상세 경로를 설정하면, 최종 쿼리 결과 데이터는 아래와 같이 저장됩니다.

안내

• 쿼리 결과 데이터는 사용자가 지정한 경로 하위에 일자 폴더{YYYY}/{MM}/{DD}가 자동으로 생성됩니다.
• 일자 폴터 하위에 쿼리 결과 데이터가 .csv, .metadata 두 가지 형식으로 저장됩니다.
  • 단, EXPlAN 등의 쿼리 실행과 같이 데이터가 아닌 비구조화된 텍스트 결과의 경우 .txt 형식으로 저장됩니다.
• 쿼리 결과 데이터가 클 경우 약 500MB 단위로 분할 저장됩니다.
  • 분할 저장으로 인해 출력 파일 명에 '쿼리 ID_0.csv', '쿼리 ID_1.csv' 과 같이 번호가 부여됩니다.

항목	설명
결과 데이터 최종 경로	{버킷 이름}/{하위 상세 경로}/{YYYY}/{MM}/{DD}/{쿼리 ID}.csv {버킷 이름}/{하위 상세 경로}/{YYYY}/{MM}/{DD}/{쿼리 ID}.metadata 출력 파일 예시 bucket_name/query_result/2024/11/19/20241119-161648-65kIHujbh7_0.csv bucket_name/query_result/2024/11/19/20241119-161648-65kIHujbh7.metadata