1단계: 완전 초기화 Step 1: Complete Reset

이전 설치 시도에서 남은 파일이나 설정이 있다면 충돌을 일으킬 수 있습니다. 아래 명령어로 깨끗하게 정리합니다.
참고: Redash를 처음 설치하는 경우 이 단계는 건너뛰어도 됩니다. If there are any leftover files or settings from previous installation attempts, they could cause conflicts. Clean them up with the command below.
Note: You can skip this step if you are installing Redash for the first time.

# 기존 /opt/redash 폴더 삭제 (오류가 나도 괜찮습니다)
sudo rm -rf /opt/redash

# 도커 시스템 정리 (모든 컨테이너, 이미지, 볼륨 등 삭제)
docker system prune -a --volumes -f

2단계: Docker Hub 로그인 Step 2: Log in to Docker Hub

Docker Hub의 이미지 다운로드 제한을 피하기 위해 로그인합니다. 터미널에 아래 명령어를 입력하고 계정 정보를 입력하세요. Log in to avoid Docker Hub's image download limits. Enter the command below in your terminal and provide your account information.

docker login

3단계: 새로운 설치 폴더 생성 Step 3: Create a New Installation Folder

사용자 홈 디렉토리에 Redash 설치를 위한 폴더를 생성합니다. `sudo`가 필요 없습니다. Create a folder for the Redash installation in your home directory. `sudo` is not required.

# 홈 디렉토리로 이동
cd ~

# redash 설치 폴더와 데이터베이스 폴더 생성
mkdir -p ~/redash/postgres-data

4단계: 설정 파일 생성 Step 4: Create Configuration Files

방금 만든 `~/redash` 폴더로 이동한 뒤, `compose.yaml`과 `env` 파일을 생성합니다. Navigate to the `~/redash` folder you just created and create the `compose.yaml` and `env` files.

cd ~/redash

`compose.yaml` 파일 생성: Create `compose.yaml` file:

`vi compose.yaml` 또는 다른 편집기를 사용하여 아래 내용 전체를 복사-붙여넣기 하세요. Use `vi compose.yaml` or another editor to copy and paste the entire content below.

services:
  server:
    image: redash/redash:10.1.0.b50633
    platform: linux/amd64
    depends_on:
      - postgres
      - redis
    env_file: ~/redash/env
    restart: always
    ports:
      - "5100:5000"
  worker:
    image: redash/redash:10.1.0.b50633
    platform: linux/amd64
    depends_on:
      - postgres
      - redis
    env_file: ~/redash/env
    restart: always
    command: worker
  redis:
    image: redis:7-alpine
    restart: always
  postgres:
    image: postgres:13-alpine
    env_file: ~/redash/env
    volumes:
      - ~/redash/postgres-data:/var/lib/postgresql/data
    restart: always
  nginx:
    image: redash/nginx:latest
    ports:
      - "80:80"
    depends_on:
      - server
    links:
      - server:redash
    restart: always

`env` 파일 생성: Create `env` file:

`vi env` 명령어로 파일을 열고 아래 내용을 붙여넣으세요. 비밀번호와 시크릿 키는 원하는 값으로 변경하는 것을 권장합니다. Open the file with `vi env` and paste the content below. It is recommended to change the password and secret key to your own values.

PYTHONUNBUFFERED=0
REDASH_LOG_LEVEL=INFO
REDASH_REDIS_URL=redis://redis:6379/0
POSTGRES_PASSWORD=your_postgres_password
REDASH_COOKIE_SECRET=your_super_secret_cookie
REDASH_DATABASE_URL=postgresql://postgres:your_postgres_password@postgres/postgres

5단계: Redash 실행 Step 5: Run Redash

`~/redash` 폴더 안에서 아래 명령어를 순서대로 실행합니다. Execute the following commands in order inside the `~/redash` folder.

1. 데이터베이스 테이블 생성 (최초 1회만 실행): 1. Create database tables (run only once):

docker compose run --rm server create_db

2. 모든 서비스 실행: 2. Run all services:

docker compose up -d

설치가 완료되면 웹 브라우저에서 http://localhost 또는 http://localhost:5100 으로 접속하여 Redash 초기 설정 화면을 확인하세요. Once the installation is complete, open your web browser and go to http://localhost or http://localhost:5100 to see the Redash initial setup screen.

A. Google Cloud 서비스 계정 생성 A. Create a Google Cloud Service Account

1. GCP 콘솔 접속:Access GCP Console: Google Cloud Console에 로그인합니다.Log in to the Google Cloud Console.
2. 서비스 계정 페이지 이동:Navigate to Service Accounts: 왼쪽 메뉴에서 IAM 및 관리자 > 서비스 계정으로 이동합니다.In the left menu, go to IAM & Admin > Service Accounts.
3. 서비스 계정 만들기:Create Service Account: 상단의 [+ 서비스 계정 만들기]를 클릭하고, 계정 이름을 입력합니다 (예: `redash-connector`).Click [+ CREATE SERVICE ACCOUNT] at the top and enter an account name (e.g., `redash-connector`).
4. 역할 부여 (중요):Grant Roles (Important): Redash에 필요한 권한을 부여합니다. 아래 두 가지 역할을 검색하여 추가하세요.Grant the necessary permissions for Redash. Search for and add the following two roles:
   • BigQuery 데이터 뷰어 (BigQuery Data Viewer)
   • BigQuery 작업 사용자 (BigQuery Job User)
5. JSON 키 파일 다운로드:Download JSON Key File:
   • 생성된 서비스 계정 목록에서 방금 만든 계정의 이메일 주소를 클릭합니다.In the list of service accounts, click the email address of the account you just created.
   • 상단의 키(KEYS) 탭으로 이동합니다.Navigate to the KEYS tab at the top.
   • [키 추가] > [새 키 만들기]를 선택하고, 키 유형으로 **JSON**을 선택 후 [만들기]를 클릭합니다.Select [ADD KEY] > [Create new key], choose **JSON** as the key type, and click [CREATE].
   • JSON 키 파일이 컴퓨터에 다운로드됩니다. 이 파일은 비밀 정보이므로 안전하게 보관하세요.The JSON key file will be downloaded to your computer. Keep this file secure as it contains private information.

B. Redash 데이터 소스 추가 B. Add Redash Data Source

1. Redash 데이터 소스 메뉴:Redash Data Source Menu: Redash 로그인 후, 오른쪽 상단 **설정(⚙️) 아이콘** > **Data Sources**를 클릭합니다.After logging into Redash, click the **Settings (⚙️) icon** in the top right > **Data Sources**.
2. 새 데이터 소스 추가:Add New Data Source: **[+ New Data Source]** 버튼을 누르고 목록에서 **BigQuery**를 선택합니다.Click the **[+ New Data Source]** button and select **BigQuery** from the list.
3. 연결 정보 입력:Enter Connection Information:
   • Name: 데이터 소스를 식별할 이름을 입력합니다 (예: `GCP BigQuery`).Enter a name to identify the data source (e.g., `GCP BigQuery`).
   • GCP Project ID: 연결할 GCP 프로젝트의 ID를 입력합니다.Enter the ID of the GCP project to connect to.
   • JSON Key File: 위에서 다운로드한 JSON 키 파일의 전체 내용을 복사하여 이 칸에 붙여넣습니다.Copy the entire contents of the downloaded JSON key file and paste it into this field.
4. 연결 테스트 및 저장:Test and Save Connection: [Test Connection]을 눌러 'Success'가 나오는지 확인한 후, [Create] 버튼을 눌러 저장을 완료합니다.Click [Test Connection] to ensure it shows 'Success', then click [Create] to complete saving.

1. API 요청 정보 확인 1. Check API Request Information

• 사용자 API 키:User API Key: Redash 프로필 페이지(Edit Profile)의 **API Key** 탭에서 확인할 수 있습니다.You can find this in your Redash profile page (Edit Profile) under the **API Key** tab.
• 쿼리 ID:Query ID: API로 실행할 쿼리를 저장한 후, 웹 브라우저 주소창의 `.../queries/ID`에서 `ID` 숫자를 확인합니다.After saving the query you want to run via API, find the `ID` number in the URL in your web browser: `.../queries/ID`.

2. API 요청 예시 (cURL) 2. API Request Example (cURL)

아래는 특정 쿼리의 최신 결과를 JSON 형식으로 가져오는 API 요청입니다. Below is an API request to fetch the latest results of a specific query in JSON format.

# YOUR_API_KEY와 YOUR_REDASH_URL, QUERY_ID를 실제 값으로 변경하세요.
curl -X POST -H "Authorization: Key YOUR_API_KEY" "YOUR_REDASH_URL/api/queries/QUERY_ID/results"

예시:Example:

curl -X POST -H "Authorization: Key supersecret123" "http://localhost:5100/api/queries/5/results"

3. 추가 API 요청 예시 (Shell Script) 3. Additional API Request Example (Shell Script)

아래 스크립트는 새 쿼리를 동적으로 생성하고 즉시 실행하여 결과를 받아오는 전체 과정을 자동화합니다. 스크립트를 파일(예: `run_query.sh`)로 저장하고 실행 권한을 준 뒤(chmod +x run_query.sh) 서버 환경에서 실행하세요. The script below automates the entire process of dynamically creating a new query and immediately executing it to fetch the results. Save the script to a file (e.g., `run_query.sh`), give it execution permissions (chmod +x run_query.sh), and run it in a server environment.

#!/bin/bash

# Redash API 키와 URL, 데이터 소스 ID를 설정합니다.
# 중요: API 키는 민감한 정보이므로 외부로 노출되지 않도록 주의해야 합니다.
# 이 스크립트는 서버 환경에서 안전하게 실행하는 것을 전제로 합니다.
API_KEY="YOUR_REDASH_API_KEY" # Redash 프로필에서 발급받은 실제 API 키로 교체하세요.
REDASH_URL="http://localhost:5100" # Redash 설치 주소로 변경하세요.
DATA_SOURCE_ID=1 # 쿼리를 실행할 데이터 소스의 ID로 변경하세요.

# 실행할 SQL 쿼리를 변수로 정의합니다.
SQL_QUERY="SELECT * FROM \`your_project_id.your_dataset.your_table\`;" # 실제 프로젝트, 데이터셋, 테이블명으로 변경하세요.

echo "1단계: 새로운 쿼리를 생성하고 ID를 받아옵니다..."

# 1. 새로운 쿼리 생성을 요청하고, 그 응답에서 jq를 사용해 'id' 값만 추출합니다.
#    -s 옵션은 curl의 진행상황 출력을 숨깁니다.
QUERY_ID=$(curl -s -X POST \
  -H "Authorization: Key ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "data_source_id": '${DATA_SOURCE_ID}',
    "query": "'"${SQL_QUERY}"'",
    "name": "Dynamic Query from Script"
  }' \
  "${REDASH_URL}/api/queries" | jq '.id')

# 쿼리 ID를 성공적으로 받았는지 확인합니다.
if [ -z "$QUERY_ID" ] || [ "$QUERY_ID" == "null" ]; then
  echo "오류: 쿼리 ID를 받아오지 못했습니다. API 키나 데이터 소스 ID를 확인하세요."
  exit 1
fi

echo "성공! 새로 생성된 쿼리 ID: ${QUERY_ID}"
echo "----------------------------------------"
echo "2단계: 받은 ID로 쿼리 결과를 요청합니다..."

# 2. 위에서 받은 QUERY_ID를 사용하여 쿼리 결과를 요청합니다.
# 이 단계는 쿼리 실행을 '요청'하며, 결과는 비동기적으로 처리될 수 있습니다.
# job.id를 받아 상태를 폴링하거나, 단순 결과를 위해 /api/queries/QUERY_ID/results.json?api_key=... 엔드포인트를 사용할 수 있습니다.
curl -X POST \
  -H "Authorization: Key ${API_KEY}" \
  "${REDASH_URL}/api/queries/${QUERY_ID}/results"

echo "\n\n쿼리 실행 요청 완료."