디스코urs 사이트에서 데이터를 추출하고 싶지만 어디서 시작해야 할지 모르겠으신가요? 정확히 오셨습니다! 이 글은 Data Explorer를 처음 접하는 초보자를 위한 tutorial 가이드입니다. 이미 SQL과 Data Explorer 사용법에 익숙하시다면 이 주제를 읽을 필요가 없을 것이며, 대신 #data-reporting::category 카테고리를 확인해 보시는 것을 추천합니다.
이 가이드의 목표는 Data Explorer를 사용하여 디스코urs 사이트에서 보고서를 작성하는 기본적인 방법을 이해하는 것을 돕는 것이며, Data Explorer 튜토리얼 시리즈의 첫 번째 부분입니다.
Data Explorer란?
Data Explorer는 데이터베이스에 대해 SQL 쿼리를 실행하고 결과를 내보낼 수 있게 해주는 디스코urs 플러그인입니다. 이는 디스코urs 사이트에서 데이터를 추출하고 분석하는 데 사용할 수 있는 강력한 도구입니다.
Data Explorer를 사용하기 전에 사이트에서 설치해야 합니다. 도움이 필요하시면 Install plugins on a self-hosted site 을 참조하세요.
Data Explorer 설치가 완료되면 SQL 쿼리 실행을 시작할 수 있습니다.
첫 번째 SQL 쿼리 생성
Data Explorer에 익숙해지는 가장 좋은 방법은 직접 실습하는 것입니다!
첫 번째 쿼리를 생성하면서 시작해 보겠습니다:
- 사이트의 관리자로 이동하여
Plugins탭을 클릭합니다. Data Explorer플러그인을 찾아 클릭합니다.+버튼을 클릭하여 새 SQL 쿼리를 생성하기 위한 텍스트 상자 및 버튼을 표시합니다.- 쿼리 이름을 입력합니다.
Create New를 클릭하여 쿼리를 생성합니다.
이제부터 첫 번째 쿼리를 작성하기 시작할 수 있습니다.
기본 새 쿼리 페이지:
Hello World
첫 번째 쿼리로는 다음을 보여주는 보고서를 만들어 보겠습니다: 사이트에서 가장 많이 조회된 주제 
이를 위해 어떻게 해야 할지 생각하면서, topics 테이블에서 title과 views 필드를 선택하는 것으로 시작해 보겠습니다:
SELECT
title, views
FROM
topics
이 쿼리는 사이트의 모든 주제 목록과 각 주제의 조회 수를 보여줍니다. Run을 클릭하여 실제로 확인해 보세요:
결과 정렬
이 결과를 보면 순서가 정렬되어 있지 않다는 것을 알 수 있습니다. 이는 원하는 대로 결과를 정렬하려면 ORDER BY 문구를 명시적으로 사용해야 하기 때문입니다. 이제 이 문구를 추가해 보겠습니다:
SELECT
title, views
FROM
topics
ORDER BY views DESC
Run을 다시 클릭하여 무엇이 변경되었는지 확인해 보겠습니다:
이제 결과를 descending(내림차순)으로 조회 수 기준으로 정렬했습니다!
결과 형식 지정
이 쿼리에서 주제의 이름을 클릭하면 해당 주제로 바로 이동할 수 있다면 좋겠죠? Formatted Table Results를 사용하면 이를 할 수 있습니다!
title 부분을 id as topic_id로 변경하여 실제로 확인해 보겠습니다:
SELECT
id as topic_id,
views
FROM
topics
ORDER BY views DESC
이제 주제 제목이 하이퍼링크로 표시됩니다!
replies(답글) 수입니다.
매개변수 및 WHERE 문구 추가
쿼리에 대한 마지막 추가 사항으로, X회 이상의 조회 수를 가진 주제만 보이도록 쿼리를 수정해 보겠습니다. 이를 위해 매개변수와 WHERE 문구를 추가해야 합니다. 매개변수로 int(정수)를 사용하며, WHERE 문구는 최소 views 수를 초과하는 주제만 표시되도록 결과를 필터링합니다.
-- [params]
-- int :min_views= 10
SELECT
id as topic_id,
views
FROM
topics
WHERE views > :min_views
ORDER BY views DESC
이 쿼리를 실행하면 결과에 표시되려면 주제가 가져야 하는 최소 조회 수를 변경할 수 있는 min_views 매개변수가 있음을 볼 수 있습니다.
마무리
이 단계들을 거치면서 Data Explorer 쿼리가 어떻게 구축되는지에 대한 개념을 잡기 시작하셨기를 바랍니다. 하지만 이 주제에서는 아직 표면만 스쳐 지나간 수준입니다!
Data Explorer와 더 일반적으로 SQL은 매우 방대한 주제입니다. Data Explorer와 SQL 쿼리에 대해 더 배우고 싶으시다면 이 시리즈의 다른 주제들을 읽을 것을 강력히 권장합니다.