본문으로 건너뛰기
최종 수정: 에

Superset

Apache Superset은 다양한 데이터 소스 연결, 여러 시각화 방식, 세분화된 사용자 권한 제어를 지원하는 오픈 소스 데이터 탐색 플랫폼입니다. 주요 기능으로는 셀프서비스 분석, 사용자 지정 대시보드, 분석 결과의 시각화 내보내기, 사용자/역할 권한 제어, 내장 SQL 편집기가 있습니다.

이 문서의 목표: Apache Superset 3.1에서 Apache Doris 데이터 소스를 구성하여 데이터 쿼리와 시각화를 지원합니다.

구성 요소권장 버전참고 사항
Apache Superset3.1 이상Apache Doris 연결을 공식적으로 지원
Apache Doris2.0.4 이상권장
Python3.9 / 3.10 / 3.11안정적인 버전 사용
pydoris1.1.0Doris Python 클라이언트

사전 요구 사항​

구성을 시작하기 전에 다음 준비를 완료하세요.

  1. Apache Superset 3.1 이상을 설치합니다.

    Superset 공식 설치 가이드를 참조하세요.

  2. Apache Doris Python 클라이언트를 설치합니다.

    pip install pydoris

  3. 설치를 확인합니다.

    pip list | grep pydoris
    # Expected output:
    # pydoris                       1.1.0

1단계: Doris 데이터 소스 구성​

환경을 준비한 후 다음 단계에 따라 Superset에 Doris 데이터 소스를 추가합니다.

1. SQLAlchemy 연결 문자열 확인​

Doris는 다음 SQLAlchemy URI 형식을 사용합니다.

doris://<username>:<password>@<host>:<port>/<Catalog>.<database>

매개변수 설명:

매개변수의미예시
usernameDoris 연결 사용자 이름testuser
password사용자 비밀번호xxxxxx
host데이터베이스 호스트127.0.1.28
port쿼리 포트9030
CatalogDoris Catalog. 내부 테이블에는 internal을 사용하고, 외부 테이블을 통해 데이터 레이크를 쿼리할 때는 해당 Catalog를 지정합니다.internal
database데이터베이스 이름tpch

2. Superset에 데이터 소스 추가​

  1. Superset 웹 인터페이스를 열고 오른쪽 상단의 설정을 클릭한 다음 데이터베이스 커넥터를 클릭합니다.

    데이터베이스 커넥터 열기

  2. + 데이터베이스 추가를 클릭하고 데이터베이스 연결 대화 상자에서 Apache Doris를 선택합니다.

    Apache Doris 선택

  3. 연결 세부 정보에 SQLAlchemy URI를 입력합니다. 연결 테스트가 통과하면 연결을 클릭합니다.

    연결 세부 정보 입력

  4. 추가가 완료되면 인터페이스에 데이터 소스가 표시됩니다.

    추가 완료

2단계: 시각화 차트 만들기​

데이터 소스를 구성하면 데이터 시각화를 시작할 수 있습니다.

이 문서에서는 TPC-H 데이터셋을 예로 들어 배송 방식별 주문 금액의 시간에 따른 추이를 분석하는 방법을 설명합니다.

사전 요구 사항: TPC-H 데이터셋이 Apache Doris에 데이터 적재되어 있어야 합니다. TPC-H 데이터 구축 가이드를 참조하세요.

1. 데이터셋 만들기​

  1. 왼쪽 탐색 모음에서 데이터셋을 클릭한 다음 + 데이터셋 추가를 클릭합니다.

    데이터셋 추가

  2. 다음 옵션을 설정한 후 오른쪽 하단의 데이터셋 생성 및 차트 만들기를 클릭합니다.

    • 데이터베이스: Doris
    • 스키마: tpch
    • 테이블: lineitem

    데이터 테이블 선택

2. 사용자 지정 메트릭 추가​

  1. 데이터셋 편집 페이지에서 메트릭을 클릭한 다음 항목 추가를 클릭하여 계산된 메트릭을 추가합니다.

    • 메트릭 키: Revenue
    • SQL 표현식: SUM(l_extendedprice * (1 - l_discount))

    메트릭 추가

3. 차트 만들기​

  1. 차트 페이지로 이동하여 + 차트 추가를 클릭하고 데이터셋으로 lineitem을, 차트 유형으로 꺾은선형 차트를 선택합니다.

    차트 유형 선택

  2. 차트 매개변수를 설정합니다.

    • l_shipdate를 X축으로 드래그하고 시간 단위를 설정합니다.
    • Revenue 메트릭을 메트릭 영역으로 드래그합니다.
    • l_shipmode 열을 차원 영역으로 드래그합니다.

    차트 설정

  3. 차트 업데이트를 클릭하여 차트를 미리 봅니다. 확인이 끝나면 저장을 클릭하여 대시보드를 저장합니다.

    대시보드 저장

자주 묻는 질문과 팁​

사전 요구 사항​

  • Superset 환경에 pydoris를 미리 설치해야 합니다. 설치하지 않으면 데이터베이스를 만들 때 Apache Doris 옵션을 선택할 수 없습니다.

성능 튜닝​

최적화 항목설명
테이블 스키마 설계실제 요구 사항에 맞게 Doris 데이터베이스와 테이블을 설계하고, 시간을 기준으로 파티셔닝과 버킷팅을 적용합니다.
조건자 푸시다운조건자 필터링과 전송되는 데이터양을 효과적으로 줄입니다.
네트워크 보안VPC 사설 연결을 사용하여 공용 네트워크 접근에 따른 보안 위험을 방지합니다.
권한 제어Doris 사용자 계정의 역할과 접근 권한을 세분화하고, 과도한 권한을 부여하지 않습니다.

문제 해결​

질문: 데이터베이스를 추가할 때 Apache Doris가 옵션으로 표시되지 않습니다.

답변: 새 환경에 pydoris가 설치되어 있는지 확인하세요. Superset은 실행 중에 Doris 드라이버를 감지해야 이 옵션을 표시합니다. 설치 후 Superset 서비스를 다시 시작해야 할 수 있습니다.

질문: 연결 테스트가 실패합니다.

답변: SQLAlchemy URI 형식이 올바른지 확인하고, Host와 Port에 접근할 수 있으며 사용자 이름과 비밀번호로 연결할 수 있는지 확인하세요. Doris BE 또는 MySQL Client를 사용하여 먼저 연결을 확인할 수 있습니다.

Report issue