SQL 준비: 프로젝트 다운로드
이 프로젝트는 GitHub에서 소스 코드, 데이터 생성기, 문서를 모두 관리합니다.
이 프로젝트는 GitHub에서 소스 코드, 데이터 생성기, 문서를 모두 관리합니다.
문서는 수시로 업데이트되므로 항상 최신 상태를 유지할 수 있는 Git 사용을 권장합니다. Git이 처음이라면 아래 설명을 참고하세요.
Git이란?
Git은 파일의 변경 이력을 추적하는 버전 관리 시스템입니다. 이 튜토리얼에서는 두 가지만 알면 됩니다:
git clone— 프로젝트를 내 컴퓨터에 복사git pull— 이후 업데이트를 한 줄로 받기
Git 설치 방법 (클릭해서 펼치기)
아래 방법 중 하나를 선택하세요:
방법 1: 설치 파일 (가장 일반적)
git-scm.com에서 다운로드하여 설치합니다. 설치 중 기본 옵션을 그대로 두면 됩니다.
방법 2: winget (Windows 11 기본 내장)
winget install Git.Git
방법 3: Chocolatey
choco install git
설치 후 명령 프롬프트 또는 Git Bash에서 확인:
git --version
터미널에서 git --version을 입력하세요. Git이 설치되어 있지 않으면 Command Line Tools 설치 팝업이 자동으로 나타납니다. "설치"를 클릭하면 됩니다.
# 입력하면 설치 안내가 자동으로 나타남
git --version
# 또는 직접 설치
xcode-select --install
Homebrew의 Git과 다른가요?
xcode-select --install로 설치되는 Git은 Apple이 관리하는 안정 버전입니다. Homebrew(brew install git)는 최신 버전을 제공하지만, 이 튜토리얼에서는 어느 쪽이든 문제없습니다. 아직 Homebrew를 설치하지 않았다면 Command Line Tools만으로 충분합니다.
sudo apt update && sudo apt install git
git --version
# Fedora
sudo dnf install git
# RHEL / CentOS
sudo yum install git
git --version
다운로드 방법
git clone https://github.com/civilian7/sql-tutorial.git
cd sql-tutorial
이후 업데이트가 있을 때:
git pull
커맨드라인이 어렵다면 GitHub Desktop을 사용할 수 있습니다.
- GitHub Desktop 설치 후 실행
- File > Clone repository 선택
- URL 탭에서
https://github.com/civilian7/sql-tutorial.git입력 - 로컬 경로 지정 후 Clone 클릭
- 이후 업데이트: 상단의 Fetch origin → Pull origin 클릭
Git 없이 바로 시작할 수 있지만, 업데이트를 받으려면 매번 다시 다운로드해야 합니다.
- GitHub에서 ZIP 다운로드
- 다운로드한 파일의 압축을 풀기
- 압축을 푼 폴더(
sql-tutorial-main)로 이동
ZIP의 한계
ZIP은 다운로드 시점의 스냅샷입니다. 레슨 추가, 오류 수정 등의 업데이트를 받을 수 없습니다.
다운로드 확인
프로젝트 폴더에 다음 파일이 있으면 정상입니다:
sql-tutorial/
├── requirements.txt ← Python 의존성
├── config.yaml ← 생성 설정
├── src/ ← 생성기·검증·유틸리티 소스 코드
├── data/ ← 상품·카테고리 마스터 데이터
├── docs/ ← 튜토리얼 문서
└── output/ ← (생성 후) DB/SQL 출력