콘텐츠로 이동

QueryHub 데이터 소스 구성 및 쿼리 예시

이 문서에서는 다양한 데이터 소스의 연결 구성, 네이티브 쿼리 및 DQL Like 쿼리 예시와 쿼리 가능한 테이블, 메트릭, 인덱스, 컬렉션 및 필드를 확인하는 방법을 소개합니다.

  • MySQL · PostgreSQL · Prometheus · Elasticsearch · MongoDB
  • 데이터 소스 ID, 이름, 설명과 연결 테스트, 권한 및 저장에 대한 공통 단계는 개요 및 구성을 참조하세요. 데이터 소스 ID는 직접 입력해야 합니다.
  • 실제 쿼리 진입점과 결과 새로 고침 단계는 쿼리 및 활용을 참조하세요. QueryHub는 네이티브 쿼리와 DQL Like를 지원하며, 두 방식 모두 직접 입력해야 하고, 선택한 인스턴스에서 실제로 제공하는 쿼리 모드를 기준으로 합니다.

각 표의 인증 필드에는 구체적인 필수 조건이 표시되어 있으며, 해당 인증 방식을 선택한 후 대응하는 자격 증명을 입력해야 합니다. 인증서 필드는 TLS 요구 사항에 따라 입력합니다. 주소, 계정, 비밀번호, 토큰 및 인증서는 데이터 소스 관리자 또는 운영 담당자가 제공합니다.

DQL Like 표현식의 datasource는 현재 선택한 인스턴스의 ID와 일치해야 하고, source는 데이터 소스 유형과 일치해야 합니다. 쿼리 대상과 필드는 실제 데이터에 맞게 입력합니다. 아래 예시는 모두 읽기 전용이며, 계정에도 대상 데이터에 대한 읽기 권한이 있어야 합니다.

공통 TLS 구성

다섯 가지 데이터 소스 모두 TLS 설정을 제공합니다. 새 연결 생성 시 기본값은 disable이며 인증서 등 하위 필드는 숨겨집니다. disable이 아닌 모드를 선택한 후 서버 요구 사항에 따라 해당 필드를 입력합니다. 각 유형의 전용 필드는 뒤의 해당 장에서 확인하세요.

구성 항목 필수 의미 및 입력 방법
TLS 모드 아니요 기본값은 disable입니다. TLS가 필요하면 서버 요구 사항에 따라 해당 모드를 선택하며, 데이터 소스 관리자가 확인합니다
CA 인증서 아니요 서버 인증서를 검증하는 데 사용하는 CA 인증서 내용입니다. 필요 시 관리자가 제공하며, 인증서 텍스트를 붙여 넣습니다
클라이언트 인증서 인증 방식에 따라 필수 서버에서 클라이언트 인증서 인증을 요구할 때 입력하며, 관리자가 발급합니다. 반드시 클라이언트 개인 키와 쌍으로 입력해야 합니다
클라이언트 개인 키 인증 방식에 따라 필수 클라이언트 인증서와 일치하는 개인 키 내용입니다. 관리자가 제공하며, 반드시 클라이언트 인증서와 쌍으로 입력해야 합니다
서버 이름 아니요 TLS 검증에 사용하는 서버 이름입니다. 일반적으로 인증서의 도메인에 해당하며, 관리자가 확인합니다
인증서 검증 건너뛰기 아니요 선택하면 서버 인증서 검증을 건너뜁니다. CA 인증서를 동시에 구성할 수 없고, verify, verify-full 모드와도 함께 사용할 수 없습니다. 일반적으로 선택하지 않은 상태로 유지합니다

MySQL

연결 필드

구성 항목 필수 의미 및 입력 방법
호스트 주소 예 MySQL 서비스의 도메인 또는 IP로, 데이터베이스 관리자 또는 클라우드 데이터베이스 연결 정보에서 가져옵니다. 관리 콘솔 웹사이트 주소는 입력하지 않습니다
포트 아니요 페이지에 3306이 미리 입력되어 있습니다. 사용자 지정 포트를 사용하는 경우 실제 값을 입력합니다
기본 데이터베이스 아니요 연결 시 기본으로 사용하는 데이터베이스 이름이며 테이블 이름이 아닙니다. 쿼리에서 데이터베이스 이름 접두사 없이 사용하는 테이블 이름은 이 기본 데이터베이스를 기준으로 하며, 데이터베이스 관리자가 확인합니다
사용자 이름 아니요 서비스 인증 요구 사항에 따라 대상 데이터베이스 및 테이블에 대한 읽기 권한이 있는 데이터베이스 계정을 입력합니다
비밀번호 아니요 위 데이터베이스 계정의 비밀번호로, 계정 관리자가 제공합니다
문자 집합 아니요 연결에 사용하는 문자 인코딩입니다. 드롭다운에서 데이터베이스 요구 사항과 일치하는 문자 집합을 선택하며, 데이터베이스 관리자가 확인합니다
날짜/시간 파싱 아니요 데이터베이스의 날짜/시간 값을 시간 유형으로 파싱할지 여부를 제어합니다. 페이지에서 기본적으로 선택되어 있으며, 쿼리 시간 범위를 설정하지는 않습니다

쿼리 예시

예시는 orders 테이블의 id, total 및 status 필드를 사용합니다. 실제 테이블 이름과 필드로 바꾸세요.

네이티브 쿼리

최대 10건의 결제 완료 주문을 조회하고 주문 ID로 정렬합니다:

SELECT id, total FROM orders WHERE status = 'paid' ORDER BY id LIMIT 10

DQL Like

queryhub(source="mysql", datasource="mysql-orders")::orders:(id,total) {status = "paid"} ORDER BY id LIMIT 10

테이블 및 필드 확인

다음은 모두 네이티브 쿼리에서 수동으로 실행하며, 한 번에 하나씩 실행합니다.

현재 데이터베이스에서 계정에 조회 권한이 있는 테이블을 확인합니다:

SHOW TABLES

orders의 컬럼 이름, 유형 등 정의를 확인합니다:

SHOW COLUMNS FROM orders

이러한 쿼리는 메타데이터 테이블을 반환하며, 페이지가 모든 필드를 자동으로 스캔하거나 생성한다는 의미는 아닙니다. 조회 가능 범위는 데이터베이스 계정 권한의 영향을 받습니다.

집계 쿼리 예시

네이티브 쿼리에 다음 SQL을 입력하고 주문 상태별로 금액을 집계한 뒤, 오른쪽 위의 새로 고침을 클릭하여 결과를 확인합니다:

SELECT status, SUM(total) AS total_amount
FROM orders
GROUP BY status
ORDER BY total_amount DESC
LIMIT 10

시간을 제한해야 하는 경우 SQL에서 실제로 존재하는 시간 필드를 사용해 조건을 작성하세요. 페이지의 시간 범위를 조정해도 임의의 SQL에 시간 필터가 자동으로 추가되지는 않습니다.

PostgreSQL

연결 필드

구성 항목 필수 의미 및 입력 방법
호스트 예 PostgreSQL 서비스의 도메인 또는 IP로, 데이터베이스 관리자 또는 클라우드 데이터베이스 연결 정보에서 제공합니다
포트 아니요 페이지에 5432가 미리 입력되어 있습니다. 사용자 지정 포트를 사용하는 경우 실제 값을 입력합니다
데이터베이스 예 이 연결에서 액세스할 데이터베이스 이름이며, 스키마 또는 테이블 이름이 아닙니다
사용자 이름 예 대상 스키마와 테이블에 대한 읽기 권한이 있는 데이터베이스 계정으로, 데이터베이스 관리자가 제공합니다
비밀번호 인증 방식에 따라 필수 비밀번호 인증을 사용할 때 필수입니다. 서버에서 클라이언트 인증서 인증을 허용하고, 쌍을 이루는 클라이언트 인증서와 개인 키를 이미 입력한 경우 비워 둘 수 있습니다
스키마 아니요 테이블이 있는 네임스페이스로, 페이지에 public이 미리 입력되어 있습니다. 데이터베이스 관리자가 확인하며, 쿼리 시 동일한 범위를 사용합니다

쿼리 예시

예시는 public 스키마의 orders 테이블을 사용합니다. 실제 구성에 맞게 스키마, 테이블 이름 및 필드를 바꾸세요. 데이터베이스와 스키마는 서로 다른 두 계층의 범위입니다.

네이티브 쿼리

SELECT id, total FROM public.orders WHERE id = 1 ORDER BY id LIMIT 10

DQL Like

queryhub(source="postgres", datasource="pg-orders")::public.orders:(id,total) {id = 1} LIMIT 10

테이블 및 필드 확인

네이티브 쿼리에서 한 번에 하나씩 실행하고, public을 구성된 스키마로 바꾸세요. 결과는 데이터베이스 계정의 조회 가능 범위에 영향을 받습니다.

테이블 이름을 확인합니다:

SELECT table_name FROM information_schema.tables
WHERE table_schema = 'public'
LIMIT 20

orders의 필드 이름과 유형을 확인합니다:

SELECT column_name, data_type FROM information_schema.columns
WHERE table_schema = 'public' AND table_name = 'orders'
ORDER BY ordinal_position LIMIT 50

테이블 이름이 같지만 스키마가 다른 경우 쿼리에서 전체 schema.table을 사용해야 하며, 선택한 인스턴스에서 허용하는 범위와 일치해야 합니다.

Prometheus

연결 필드

구성 항목 필수 의미 및 입력 방법
서비스 주소 예 Prometheus 쿼리 서비스의 기본 주소입니다. 예: http://prometheus.example.com:9090. 이 HTTP 예시는 TLS 모드 disable에 해당합니다. HTTPS 주소를 사용하는 경우 disable이 아닌 TLS 모드를 선택해야 합니다. 서비스 관리자가 제공하며, 관리 페이지 주소나 전체 /api/v1/query 경로는 입력하지 않습니다
인증 방식 아니요 기본값은 인증 없음이며, Basic 또는 Bearer를 선택할 수 있습니다. 두 인증 방식은 상호 배타적입니다
사용자 이름 인증 방식에 따라 필수 Basic 인증을 선택할 때 필수입니다. 서비스 또는 게이트웨이 관리자가 제공하며, 워크스페이스 로그인 계정이 아닙니다
비밀번호 인증 방식에 따라 필수 Basic 인증을 선택할 때 필수이며, 위 사용자 이름에 대응합니다
Bearer 토큰 인증 방식에 따라 필수 Bearer 인증을 선택할 때 필수입니다. 관리자가 발급하며, Bearer 접두사를 붙이지 않습니다. 워크스페이스 API Key가 아닙니다

쿼리 예시

쿼리 대상은 메트릭이며, job, instance 등은 샘플 태그입니다. 예시의 메트릭과 태그를 실제 값으로 바꾸세요.

네이티브 쿼리

네이티브 쿼리 입력 상자에 전체 JSON을 입력하고, operation으로 쿼리 작업을 지정하며, PromQL은 statement에 작성합니다.

즉시 쿼리:

{"operation":"query","statement":"up{job=\"fixture\"}"}

범위 쿼리:

{"operation":"query_range","statement":"up{job=\"fixture\"}","arguments":{"start":"#{startTime}","end":"#{endTime}","step":15}}

#{startTime} 및 #{endTime}은 차트의 시간 범위를 참조하며, 프런트엔드에서 시간을 자동으로 초 단위로 변환합니다. step의 단위도 초이며 예시에서는 15초입니다. 이러한 매개변수는 JSON의 arguments에 입력합니다.

DQL Like

queryhub(source="prometheus", datasource="metrics")::up:(*) {job = "fixture"}

쿼리 결과

Studio 테이블에서 "이름"과 "태그"는 각각 시계열의 name과 tags에서 가져옵니다. 시간 열은 time이며, 인터페이스는 Unix 밀리초 타임스탬프를 사용하고 페이지에서 형식을 지정해 표시합니다. 값 열 이름은 메트릭 이름 또는 표현식에 따라 달라집니다.

메트릭 및 태그 확인

네이티브 쿼리 입력 상자에 다음 JSON을 입력하고, 확인할 메트릭의 PromQL을 statement에 작성합니다. 알려진 이름 또는 좁은 범위의 정규식을 사용해 현재 샘플이 있는 메트릭을 확인합니다:

{"operation":"query","statement":"count by (__name__) ({__name__=~\"up|http_requests_total\"})"}

예시는 up 및 http_requests_total만 일치시킵니다. 실행 후 테이블에서 일치한 시계열의 이름과 태그를 확인합니다.

job, instance 등 태그를 확인하려면 위의 즉시 쿼리 JSON을 실행하고 결과 테이블의 "태그"에서 확인합니다. 샘플이 없으면 태그 조건을 확인하거나 쿼리 시간을 조정할 수 있습니다.

이러한 결과는 현재 일치한 샘플만 반영하며, 전체 태그 또는 메트릭 카탈로그를 나타내지 않으므로 이를 근거로 다른 메트릭이 존재하지 않는다고 판단할 수 없습니다.

Elasticsearch

연결 필드

구성 항목 필수 의미 및 입력 방법
서비스 주소 예 Elasticsearch 쿼리 서비스의 기본 주소입니다. 예: https://es.example.com:9200. 이 HTTPS 예시는 disable이 아닌 TLS 모드를 선택해야 합니다. HTTP 주소를 사용하는 경우 disable을 선택해야 합니다. 관리자가 제공하며, Kibana 주소나 전체 _search 경로는 입력하지 않습니다
인증 방식 아니요 기본값은 인증 없음이며, Basic 또는 Bearer를 선택할 수 있습니다. 두 인증 방식은 상호 배타적입니다
사용자 이름 인증 방식에 따라 필수 Basic 인증을 선택할 때 필수이며, 대상 인덱스에 대한 읽기 권한이 있어야 합니다
비밀번호 인증 방식에 따라 필수 Basic 인증을 선택할 때 필수이며, 위 사용자 이름에 대응합니다. 계정 관리자가 제공합니다
Bearer 토큰 인증 방식에 따라 필수 Bearer 인증을 선택할 때 필수입니다. 관리자가 발급하며, Bearer 접두사를 붙이지 않습니다. API Key를 Bearer 토큰으로 입력하지 마세요
인덱스 예 이 인스턴스에서 쿼리할 인덱스입니다. 예: orders. 데이터 관리자가 확인합니다. DQL Like의 대상은 인스턴스 구성 범위와 일치해야 합니다

쿼리 예시

예시에서는 인스턴스에 구성된 인덱스가 orders라고 가정합니다. 문서를 쿼리할 때는 테이블 차트를 사용해 결과를 확인합니다.

네이티브 쿼리

네이티브 쿼리 입력 상자에 전체 JSON을 입력하고, operation에는 search를 사용하며, 요청 본문은 arguments.body에 넣습니다:

{"operation":"search","arguments":{"body":{"query":{"match_all":{}},"size":10}}}

DQL Like

queryhub(source="elasticsearch", datasource="es-orders")::orders:(id,status) LIMIT 10

테이블 차트에서 document JSON을 펼쳐 문서를 확인합니다. 프로젝션 필드는 JSON 내에 유지되며, 자동으로 독립적인 테이블 열로 바뀌지 않습니다.

인덱스 및 필드 확인

쿼리 가능한 인덱스는 현재 인스턴스 구성을 기준으로 합니다. 네이티브 쿼리 입력 상자에 다음 JSON을 입력하고, 실행 후 테이블에서 일치한 결과의 index 열을 읽습니다:

{"operation":"search","arguments":{"body":{"query":{"match_all":{}},"_source":false,"size":1}}}

인덱스에 일치하는 문서가 없을 때는 인스턴스 구성을 기준으로 하며, 빈 결과로 인덱스 존재 여부를 판단하지 않습니다.

문서 샘플과 해당 키를 확인하려면 네이티브 쿼리에 다음을 입력합니다:

{"operation":"search","arguments":{"body":{"query":{"match_all":{}},"size":1}}}

테이블 차트에서 결과의 document JSON을 펼쳐 필드를 확인합니다. 문서에는 희소 필드가 포함될 수 있으며, 제한된 범위에서 더 많은 샘플을 읽을 수 있습니다. 이는 전체 매핑이 아니며, 전체 정의는 Elasticsearch 측에서 확인해야 합니다.

MongoDB

연결 필드

구성 항목 필수 의미 및 입력 방법
호스트 목록 예 실제로는 호스트 이름 또는 IP 1개만 입력할 수 있으며, 데이터베이스 관리자가 제공합니다. 포트는 별도로 입력합니다
포트 아니요 페이지에 27017이 미리 입력되어 있습니다. 사용자 지정 포트를 사용하는 경우 실제 값을 입력합니다
인증 방식 아니요 기본값은 인증 없음입니다. 비밀번호 인증을 선택하면 사용자 이름, 비밀번호 및 인증 데이터베이스 필드가 표시됩니다
사용자 이름 인증 방식에 따라 필수 비밀번호 인증을 선택할 때 필수입니다. 대상 데이터베이스와 컬렉션에 대한 읽기 권한이 있는 MongoDB 계정을 사용합니다
비밀번호 인증 방식에 따라 필수 비밀번호 인증을 선택할 때 필수이며, 위 사용자 이름에 대응합니다. 계정 관리자가 제공합니다
인증 데이터베이스 아니요 비밀번호 인증 시 입력할 수 있으며, 계정 ID 정보가 있는 데이터베이스를 나타냅니다. admin일 수 있으며, 관리자가 확인합니다
쿼리 데이터베이스 예 비즈니스 문서를 읽을 데이터베이스 이름입니다. admin, config 또는 local을 사용할 수 없습니다
컬렉션 예 컬렉션 이름만 입력합니다. 예: items. 데이터베이스 이름 접두사를 붙이지 않습니다. 네이티브 find 쿼리는 이 컬렉션을 사용합니다

쿼리 예시

예시에서는 인스턴스에 items 컬렉션이 구성되어 있고, 문서에 비즈니스 필드 id 및 status가 포함되어 있다고 가정합니다. 쿼리 데이터베이스와 인증 데이터베이스는 다를 수 있으며, 테이블 차트를 사용해 문서 결과를 확인합니다.

네이티브 쿼리

네이티브 쿼리 입력 상자에 전체 JSON을 입력하고, operation에는 find를 사용하며, 필터, 프로젝션 및 반환 개수는 arguments에 작성합니다. 데이터베이스와 컬렉션은 현재 인스턴스 구성을 따릅니다:

{"operation":"find","arguments":{"filter":{"status":"paid"},"projection":{"id":1,"status":1},"limit":10}}

filter는 필터 조건을 정의하고, projection은 읽을 문서 필드를 지정하며, limit은 반환 개수를 제한합니다. 예시의 id는 비즈니스 필드이며 MongoDB 기본 _id와 동일하지 않습니다. 실제 문서 구조에 맞게 조정하세요.

DQL Like

queryhub(source="mongodb", datasource="mongo-orders")::items:(id,status) {status = "paid"} LIMIT 10

테이블 차트에서 document JSON을 펼쳐 문서를 확인합니다. 프로젝션 필드는 JSON에 유지되며, 자동으로 독립적인 열로 펼쳐지지 않습니다.

컬렉션 및 필드 확인

쿼리 가능한 데이터베이스와 컬렉션은 현재 인스턴스 구성을 기준으로 합니다. Studio 진입점에서는 listCollections를 제공하지 않습니다.

네이티브 쿼리 입력 상자에 다음 JSON을 입력하여 샘플 문서 하나를 읽습니다:

{"operation":"find","arguments":{"filter":{},"limit":1}}

테이블 차트에서 document JSON을 펼쳐 문서의 키를 확인합니다. 문서마다 구조가 다를 수 있으므로 필터 조건을 변경하거나 제한된 범위에서 샘플 수를 적절히 늘릴 수 있습니다. 샘플 내용은 전체 스키마를 나타내지 않으며, 계정 권한을 증가시키지도 않습니다.

문서 평가

이 페이지가 도움이 되었나요?