> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Explorar guias de início rápido > Explore guias de início rápido para começar a usar o ClickHouse export const quickStartsData = [{ "id": "connect-your-iceberg-catalog", "title": "Como conectar seu catálogo Iceberg ao ClickHouse Cloud", "description": "Saiba como conectar o ClickHouse Cloud ao seu catálogo de dados e consultar tabelas Iceberg.", "href": "/pt-BR/get-started/quickstarts/connect-your-iceberg-catalog", "useCases": ["data-warehousing"], "products": ["cloud"] }, { "id": "create-your-first-materialized-view", "title": "Crie sua primeira visão materializada", "description": "Saiba como usar visões materializadas no ClickHouse para pré-computar e armazenar resultados de consultas com uma ordenação diferente, permitindo buscas rápidas em colunas não cobertas pela chave primária.", "href": "/pt-BR/get-started/quickstarts/create-your-first-materialized-view", "useCases": ["real-time-analytics", "data-warehousing"], "products": ["cloud"] }, { "id": "create-your-first-mergetree-table", "title": "Crie sua primeira tabela MergeTree", "description": "Aprenda como funciona o principal engine de tabela do ClickHouse criando uma tabela MergeTree, carregando dados de preços de imóveis do Reino Unido e observando como as partes e os merges afetam o armazenamento e o desempenho das consultas.", "href": "/pt-BR/get-started/quickstarts/create-your-first-mergetree-table", "useCases": ["all"], "products": ["cloud"] }, { "id": "create-your-first-projection", "title": "Crie sua primeira projeção", "description": "Saiba como usar projeções no ClickHouse para armazenar uma cópia adicional ordenada dos dados na mesma tabela, permitindo consultas rápidas em colunas não abrangidas pela chave primária.", "href": "/pt-BR/get-started/quickstarts/create-your-first-projection", "useCases": ["real-time-analytics", "data-warehousing"], "products": ["cloud"] }, { "id": "create-your-first-service-on-cloud", "title": "Crie seu primeiro serviço do ClickHouse Cloud e carregue dados de exemplo", "description": "Crie um serviço do ClickHouse Cloud, explore o Console SQL e carregue um conjunto de dados de exemplo para começar a consultar dados reais em poucos minutos.", "href": "/pt-BR/get-started/quickstarts/create-your-first-service-on-cloud", "useCases": ["all"], "products": ["cloud"] }, { "id": "creating-tables", "title": "Criando tabelas no ClickHouse", "description": "Saiba mais sobre como criar tabelas no ClickHouse", "href": "/pt-BR/get-started/quickstarts/creating-tables", "useCases": ["all"], "products": ["self-managed"] }, { "id": "insert-data-using-clickhouse-client", "title": "Inserir dados no ClickHouse Cloud usando clickhouse-client", "description": "Aprenda a usar o clickhouse-client para inserir dados de arquivos CSV e Parquet locais em um serviço do ClickHouse Cloud pela linha de comando.", "href": "/pt-BR/get-started/quickstarts/insert-data-using-clickhouse-client", "useCases": ["all"], "products": ["cloud"] }, { "id": "mutations", "title": "Atualização e exclusão de dados no ClickHouse", "description": "Descreve como realizar operações de atualização e exclusão no ClickHouse", "href": "/pt-BR/get-started/quickstarts/mutations", "useCases": ["data-warehousing"], "products": ["self-managed"] }, { "id": "obtain-your-cloud-connection-details", "title": "Obtenha os detalhes de conexão do Cloud", "description": "Saiba como encontrar o hostname, a porta e as credenciais do seu serviço no ClickHouse Cloud para se conectar por clientes externos, CLIs e aplicativos.", "href": "/pt-BR/get-started/quickstarts/obtain-your-cloud-connection-details", "useCases": ["all"], "products": ["cloud"] }, { "id": "tutorial", "title": "Tutorial avançado", "description": "Aprenda a fazer a ingestão e consultar dados no ClickHouse usando um conjunto de dados de exemplo de táxis da cidade de Nova York.", "href": "/pt-BR/get-started/quickstarts/tutorial", "useCases": ["real-time-analytics", "data-warehousing"], "products": ["cloud", "self-managed"] }, { "id": "working-with-the-map-type", "title": "Trabalhando com o tipo Map no ClickHouse", "description": "Aprenda a usar o tipo Map no ClickHouse para armazenar, consultar e agregar dados dinâmicos no formato chave-valor, usando atributos de recurso do OTel como exemplo prático.", "href": "/pt-BR/get-started/quickstarts/working-with-the-map-type", "useCases": ["observability"], "products": ["self-managed"] }, { "id": "writing-queries", "title": "Selecionando dados do ClickHouse", "description": "Saiba mais sobre como selecionar dados do ClickHouse", "href": "/pt-BR/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: "Analytics em tempo real" }, { value: 'data-warehousing', label: "Armazenamento de dados" }, { value: 'observability', label: "Observabilidade" }, { value: 'ai-ml', label: "AI/ML" }]; const productOptions = [{ value: 'self-managed', label: 'ClickHouse (código aberto)' }, { value: 'cloud', label: 'ClickHouse Cloud' }, { value: 'clickpipes', label: "ClickPipes" }, { value: 'language-clients', label: "Cliente por linguagem" }, { 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 || `/pt-BR/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 &&

Guias de início rápido em destaque

{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}
)}
} {}
{}
{}
{}

Explorar guias de início rápido

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

Nenhum guia de início rápido encontrado para os critérios informados.

Tente ajustar os filtros ou o termo de busca.

}
; }; export const featuredQuickstarts = [{ id: 'create-your-first-service-on-cloud' }, { id: 'insert-data-using-clickhouse-client' }, { id: 'obtain-your-cloud-connection-details' }];
Imagem de fundo decorativa. Imagem de fundo decorativa.