> ## Documentation Index > Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 빠른 시작 둘러보기 > ClickHouse를 빠르게 시작할 수 있는 빠른 시작 가이드를 살펴보세요 export const quickStartsData = [{ "id": "connect-your-iceberg-catalog", "title": "ClickHouse Cloud에서 Iceberg 카탈로그를 연결하는 방법", "description": "ClickHouse Cloud를 데이터 카탈로그에 연결하고 Iceberg 테이블을 쿼리하는 방법을 알아봅니다.", "href": "/ko/get-started/quickstarts/connect-your-iceberg-catalog", "useCases": ["data-warehousing"], "products": ["cloud"] }, { "id": "create-your-first-materialized-view", "title": "첫 materialized view 만들기", "description": "ClickHouse에서 materialized view를 사용해 쿼리 결과를 다른 정렬 순서로 미리 계산해 저장하고, 프라이머리 키(primary key)에 포함되지 않은 컬럼에서도 빠르게 조회하는 방법을 알아봅니다.", "href": "/ko/get-started/quickstarts/create-your-first-materialized-view", "useCases": ["real-time-analytics", "data-warehousing"], "products": ["cloud"] }, { "id": "create-your-first-mergetree-table", "title": "첫 번째 MergeTree 테이블 만들기", "description": "MergeTree 테이블을 만들고 영국 부동산 가격 데이터를 불러오면서, 파트와 머지가 저장소와 쿼리 성능에 어떤 영향을 미치는지 관찰해 ClickHouse의 주요 테이블 엔진이 어떻게 작동하는지 알아봅니다.", "href": "/ko/get-started/quickstarts/create-your-first-mergetree-table", "useCases": ["all"], "products": ["cloud"] }, { "id": "create-your-first-projection", "title": "첫 번째 프로젝션 만들기", "description": "ClickHouse에서 프로젝션을 사용해 동일한 테이블 내에 정렬된 데이터 사본을 추가로 저장하고, 프라이머리 키(primary key)에 포함되지 않은 컬럼도 빠르게 조회하는 방법을 알아봅니다.", "href": "/ko/get-started/quickstarts/create-your-first-projection", "useCases": ["real-time-analytics", "data-warehousing"], "products": ["cloud"] }, { "id": "create-your-first-service-on-cloud", "title": "첫 번째 Cloud 서비스를 만들고 예시 데이터 불러오기", "description": "ClickHouse Cloud 서비스를 만들고 SQL 콘솔을 살펴본 뒤 예시 데이터셋을 로드하여 몇 분 만에 실제 데이터에 쿼리를 실행할 수 있습니다.", "href": "/ko/get-started/quickstarts/create-your-first-service-on-cloud", "useCases": ["all"], "products": ["cloud"] }, { "id": "creating-tables", "title": "ClickHouse에서 테이블 생성", "description": "ClickHouse에서 테이블 생성에 대해 알아봅니다", "href": "/ko/get-started/quickstarts/creating-tables", "useCases": ["all"], "products": ["self-managed"] }, { "id": "insert-data-using-clickhouse-client", "title": "clickhouse-client로 ClickHouse Cloud에 데이터 삽입", "description": "명령줄에서 clickhouse-client를 사용하여 로컬 CSV 및 Parquet 파일의 데이터를 ClickHouse Cloud 서비스에 삽입하는 방법을 알아봅니다.", "href": "/ko/get-started/quickstarts/insert-data-using-clickhouse-client", "useCases": ["all"], "products": ["cloud"] }, { "id": "mutations", "title": "ClickHouse 데이터 업데이트 및 삭제", "description": "ClickHouse에서 업데이트 및 삭제 작업을 수행하는 방법을 설명합니다", "href": "/ko/get-started/quickstarts/mutations", "useCases": ["data-warehousing"], "products": ["self-managed"] }, { "id": "obtain-your-cloud-connection-details", "title": "Cloud 연결 정보 확인", "description": "외부 클라이언트, CLI, 애플리케이션에서 연결할 수 있도록 ClickHouse Cloud 서비스의 호스트명, 포트, 자격 증명을 확인하는 방법을 알아봅니다.", "href": "/ko/get-started/quickstarts/obtain-your-cloud-connection-details", "useCases": ["all"], "products": ["cloud"] }, { "id": "working-with-the-map-type", "title": "ClickHouse에서 맵 타입 사용하기", "description": "OTel 리소스 속성을 예시로, ClickHouse에서 동적 키-값 데이터를 저장, 쿼리, 집계하는 데 맵 타입을 사용하는 방법을 알아봅니다.", "href": "/ko/get-started/quickstarts/working-with-the-map-type", "useCases": ["observability"], "products": ["self-managed"] }, { "id": "writing-queries", "title": "ClickHouse 데이터 선택", "description": "ClickHouse 데이터 선택에 대해 알아봅니다", "href": "/ko/get-started/quickstarts/writing-queries", "useCases": ["all"], "products": ["self-managed"] }]; export const QuickStartsGrid = ({quickStartsData = [], featured = []}) => { const featuredIds = featured.map(f => f.id); const data = quickStartsData || []; const assetBase = typeof window !== "undefined" && window.location.pathname.startsWith("/docs") ? "/docs" : ""; const withBase = p => p && p.startsWith("/") ? assetBase + p : p; const useCaseOptions = [{ value: "real-time-analytics", label: "실시간 분석" }, { value: "data-warehousing", label: "데이터 웨어하우징" }, { value: "observability", label: "관측성" }, { value: "ai-ml", label: "AI/ML" }]; const productOptions = [{ value: "self-managed", label: "ClickHouse (Open-Source)" }, { value: "cloud", label: "ClickHouse Cloud" }, { value: "clickpipes", label: "ClickPipes" }, { value: "language-clients", label: "언어 클라이언트" }, { value: "clickstack", label: "ClickStack" }, { value: "chdb", label: "chDB" }]; const explorable = data.filter(qs => !featuredIds.includes(qs.id)); const visibleUseCaseOptions = useCaseOptions.filter(o => explorable.some(qs => { const u = qs.useCases || []; return u.includes("all") || u.includes(o.value); })); const visibleProductOptions = productOptions.filter(o => explorable.some(qs => (qs.products || []).includes(o.value))); const readStored = key => { if (typeof window === "undefined") return null; try { return localStorage.getItem(key); } catch { return null; } }; const writeStored = (key, value) => { if (typeof window === "undefined") return; try { localStorage.setItem(key, value); } catch {} }; const readStoredSelection = (key, options) => { const raw = readStored(key); if (!raw) return []; try { const parsed = JSON.parse(raw); if (!Array.isArray(parsed)) return []; return parsed.filter(v => options.some(o => o.value === v)); } catch { return []; } }; const [searchTerm, setSearchTerm] = useState(() => readStored("quickstarts-search") || ""); const [selectedUseCases, setSelectedUseCases] = useState(() => readStoredSelection("quickstarts-usecases", visibleUseCaseOptions)); const [selectedProducts, setSelectedProducts] = useState(() => readStoredSelection("quickstarts-products", visibleProductOptions)); const [currentPage, setCurrentPage] = useState(1); const itemsPerPage = 6; const [showFilters, setShowFilters] = useState(() => readStored("quickstarts-show-filters") !== "false"); const [isDesktop, setIsDesktop] = useState(true); useEffect(() => { if (typeof window === "undefined" || !window.matchMedia) return; const mq = window.matchMedia("(min-width: 1024px)"); const update = () => setIsDesktop(mq.matches); update(); mq.addEventListener("change", update); return () => mq.removeEventListener("change", update); }, []); useEffect(() => { writeStored("quickstarts-search", searchTerm); }, [searchTerm]); useEffect(() => { writeStored("quickstarts-usecases", JSON.stringify(selectedUseCases)); }, [selectedUseCases]); useEffect(() => { writeStored("quickstarts-products", JSON.stringify(selectedProducts)); }, [selectedProducts]); useEffect(() => { writeStored("quickstarts-show-filters", String(showFilters)); }, [showFilters]); useEffect(() => { setCurrentPage(1); }, [searchTerm, selectedUseCases, selectedProducts]); const makeToggle = setter => value => { setter(prev => prev.includes(value) ? prev.filter(v => v !== value) : [...prev, value]); }; const toggleUseCase = makeToggle(setSelectedUseCases); const toggleProduct = makeToggle(setSelectedProducts); const resetFilters = () => { setSearchTerm(""); setSelectedUseCases([]); setSelectedProducts([]); }; const hasActiveFilters = searchTerm !== "" || selectedUseCases.length > 0 || selectedProducts.length > 0; const filteredQuickStarts = useMemo(() => { const term = searchTerm.toLowerCase(); return data.filter(quickStart => { if (featuredIds.includes(quickStart.id)) return false; const matchesSearch = term === "" || quickStart.title.toLowerCase().includes(term) || (quickStart.description || "").toLowerCase().includes(term); const useCases = quickStart.useCases || []; const matchesUseCases = selectedUseCases.length === 0 || useCases.includes("all") || useCases.some(uc => selectedUseCases.includes(uc)); const products = quickStart.products || []; const matchesProducts = selectedProducts.length === 0 || products.some(p => selectedProducts.includes(p)); return matchesSearch && matchesUseCases && matchesProducts; }); }, [data, searchTerm, selectedUseCases, selectedProducts, featuredIds]); const handleCardClick = (e, href) => { if (e.defaultPrevented) return; if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return; e.preventDefault(); window.location.assign(withBase(href)); }; const featuredQuickStarts = featured.map(f => { const qs = data.find(q => q.id === f.id); return { id: f.id, href: qs && qs.href || `/ko/get-started/quickstarts/${f.id}`, title: qs && qs.title || "" }; }).filter(f => f.title); const FilterGroup = ({label, options, selectedOptions, onToggle}) => { const activeCount = selectedOptions.length; const displayLabel = activeCount > 0 ? `${label} (${activeCount})` : label; return
{displayLabel}
{options.map(option => )}
; }; return <>
{} {featuredQuickStarts.length > 0 &&

추천 빠른 시작

{featuredQuickStarts.map(quickStart => handleCardClick(e, quickStart.href)} className="group block rounded-xl overflow-hidden border border-gray-200 dark:border-white/10 transition-all hover:border-black dark:hover:border-[#FAFF69] hover:shadow-md"> {}
{quickStart.title}
시작하기
)}
} {}
{}
{}
{}

빠른 시작 탐색

{filteredQuickStarts.length > 0 ? <> {} {(() => { const totalPages = Math.ceil(filteredQuickStarts.length / itemsPerPage); if (totalPages <= 1) return null; const hasPrev = currentPage > 1; const hasNext = currentPage < totalPages; return
{currentPage} / {totalPages} 페이지
; })()} :

검색 조건에 맞는 빠른 시작 가이드가 없습니다.

필터 또는 검색어를 조정하여 다시 시도해 보십시오.

}
; }; export const featuredQuickstarts = [{ id: 'create-your-first-service-on-cloud' }, { id: 'insert-data-using-clickhouse-client' }, { id: 'obtain-your-cloud-connection-details' }];
장식용 배경 이미지. 장식용 배경 이미지.