> ## 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 kbIndex = { categories: ["Cloud", "Configuration & settings", "Data import & export", "Data management", "General & FAQs", "Integrations & client libraries", "Materialized views & projections", "Monitoring & debugging", "Performance & optimization", "Queries & SQL", "Security & access control", "Setup & installation", "Tables & schema", "Troubleshooting & errors"], tags: ["Best Practices", "Community", "Concepts", "Core Data Concepts", "Data Export", "Data Formats", "Data Ingestion", "Data Modelling", "Data Sources", "Deployments and Scaling", "Errors and Exceptions", "Functions", "Language Clients", "Managing Cloud", "Managing Data", "Native Clients and Interfaces", "Performance and Optimizations", "Runbooks", "Security and Authentication", "Server Admin", "Settings", "System Tables", "Tools and Utilities", "Troubleshooting", "Use Cases"], articles: [{ id: "integrations/python-clickhouse-connect-example", title: "A Python client working example for connecting to ClickHouse Cloud service", description: "Learn how to connect to ClickHouse Cloud Service using Python with a step-by-step example using the clickhouse-connect driver.", href: "/zh/resources/support-center/knowledge-base/integrations/python-clickhouse-connect-example", category: "Integrations & client libraries", tags: ["Language Clients"] }, { id: "configuration-settings/about-quotas-and-query-complexity", title: "About quotas and query complexity", description: "Quotas and Query Complexity are powerful ways to limit and restrict what users can do in ClickHouse. This KB article shows examples on how to apply these two different approaches.", href: "/zh/resources/support-center/knowledge-base/configuration-settings/about-quotas-and-query-complexity", category: "Configuration & settings", tags: ["Managing Cloud"] }, { id: "data-import-export/achieving-atomic-inserts", title: "Achieving atomic inserts and multi-table consistency in ClickHouse Cloud", description: "How to load data atomically and keep multiple tables consistent in ClickHouse Cloud without multi-statement transactions, using staging tables and partition-level operations.", href: "/zh/resources/support-center/knowledge-base/data-import-export/achieving-atomic-inserts", category: "Data import & export", tags: ["Data Ingestion", "Best Practices"] }, { id: "tables-schema/add-column", title: "Adding a column to a table", description: "In this guide, we'll learn how to add a column to an existing table.", href: "/zh/resources/support-center/knowledge-base/tables-schema/add-column", category: "Tables & schema", tags: ["Data Modelling"] }, { id: "configuration-settings/alter-user-settings-exception", title: "Alter user settings exception", description: "Handing the an exception thrown when altering user settings", href: "/zh/resources/support-center/knowledge-base/configuration-settings/alter-user-settings-exception", category: "Configuration & settings", tags: ["Settings", "Errors and Exceptions"] }, { id: "materialized-views/are-materialized-views-inserted-asynchronously", title: "Are Materialized Views inserted synchronously?", description: "This KB article explores whether Materialized Views are inserted synchronously", href: "/zh/resources/support-center/knowledge-base/materialized-views/are-materialized-views-inserted-asynchronously", category: "Materialized views & projections", tags: ["Data Modelling"] }, { id: "tables-schema/schema-migration-tools", title: "Automatic schema migration tools for ClickHouse", description: "Learn about automatic schema migration tools for ClickHouse and how to manage changing database schemas over time.", href: "/zh/resources/support-center/knowledge-base/tables-schema/schema-migration-tools", category: "Tables & schema", tags: ["Tools and Utilities"] }, { id: "cloud-services/aws-privatelink-setup-for-msk-clickpipes", title: "AWS PrivateLink setup to expose MSK for ClickPipes", description: "Setup steps to expose a private MSK via MSK multi-VPC connectivity to ClickPipes.", href: "/zh/resources/support-center/knowledge-base/cloud-services/aws-privatelink-setup-for-msk-clickpipes", category: "Cloud", tags: ["Security and Authentication", "Managing Cloud"] }, { id: "cloud-services/aws-privatelink-setup-for-clickpipes", title: "AWS PrivateLink setup to expose private RDS for ClickPipes", description: "Setup steps to expose a private RDS via AWS PrivateLink to ClickPipes.", href: "/zh/resources/support-center/knowledge-base/cloud-services/aws-privatelink-setup-for-clickpipes", category: "Cloud", tags: ["Security and Authentication", "Managing Cloud"] }, { id: "cloud-services/aws-privatelink-vpc-endpoint-service-for-msk-cluster", title: "面向 MSK 集群的 AWS PrivateLink VPC 端点服务", description: "通过 AWS PrivateLink VPC 端点服务将 MSK 集群暴露给 ClickPipes 的配置步骤。", href: "/zh/resources/support-center/knowledge-base/cloud-services/aws-privatelink-vpc-endpoint-service-for-msk-cluster", category: "Cloud", tags: ["Security and Authentication", "Managing Cloud"] }, { id: "data-management/backing-up-a-specific-partition", title: "Backing up a specific partition", description: "How can I backup a specific partition in ClickHouse?", href: "/zh/resources/support-center/knowledge-base/data-management/backing-up-a-specific-partition", category: "Data management", tags: ["Managing Data"] }, { id: "general-faqs/key-value", title: "Can I use ClickHouse as a key-value storage?", description: "Answers the frequently asked question of whether or not ClickHouse can be used as a key-value storage?", href: "/zh/resources/support-center/knowledge-base/general-faqs/key-value", category: "General & FAQs", tags: [] }, { id: "general-faqs/time-series", title: "Can I use ClickHouse as a time-series database?", description: "Page describing how to use ClickHouse as a time-series database", href: "/zh/resources/support-center/knowledge-base/general-faqs/time-series", category: "General & FAQs", tags: [] }, { id: "queries-sql/pivot", title: "Can you PIVOT in ClickHouse?", description: "ClickHouse doesn't have a PIVOT clause, but we can get close to this functionality using aggregate function combinators. Let's see how to do this using the UK housing prices dataset.", href: "/zh/resources/support-center/knowledge-base/queries-sql/pivot", category: "Queries & SQL", tags: ["Data Modelling", "Core Data Concepts"] }, { id: "general-faqs/vector-search", title: "Can you use ClickHouse for vector search?", description: "Learn how to use ClickHouse for vector search, including storing embeddings and searching with distance functions like cosine similarity.", href: "/zh/resources/support-center/knowledge-base/general-faqs/vector-search", category: "General & FAQs", tags: ["Use Cases", "Concepts"] }, { id: "monitoring-debugging/send-logs-level", title: "Capturing server logs of queries at the client", description: "Learn how to capture server logs at the client level, even with different log settings, using the `send_logs_level` client setting.", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/send-logs-level", category: "Monitoring & debugging", tags: ["Server Admin"] }, { id: "configuration-settings/change-the-prompt-in-clickhouse-client", title: "Change the prompt in clickhouse-client", description: "This article explains how to change the prompt in your Clickhouse client and clickhouse-local terminal window from :) to a prefix followed by :)", href: "/zh/resources/support-center/knowledge-base/configuration-settings/change-the-prompt-in-clickhouse-client", category: "Configuration & settings", tags: ["Settings", "Native Clients and Interfaces"] }, { id: "security/common-rbac-queries", title: "常见 RBAC 查询", description: "帮助向用户授予特定权限的查询。", href: "/zh/resources/support-center/knowledge-base/security/common-rbac-queries", category: "Security & access control", tags: ["Security and Authentication", "Managing Cloud"] }, { id: "queries-sql/comparing-metrics-between-queries", title: "以分贝为单位比较查询之间的指标", description: "在 ClickHouse 中比较两个查询之间指标的查询。", href: "/zh/resources/support-center/knowledge-base/queries-sql/comparing-metrics-between-queries", category: "Queries & SQL", tags: ["Performance and Optimizations"] }, { id: "configuration-settings/configure-cap-ipc-lock-and-cap-sys-nice-in-docker", title: "在 Docker 中配置 CAP_IPC_LOCK 和 CAP_SYS_NICE 能力", description: "了解如何在容器中运行 ClickHouse 时解决 `CAP_IPC_LOCK` 和 `CAP_SYS_NICE` 的 Docker 能力警告。", href: "/zh/resources/support-center/knowledge-base/configuration-settings/configure-cap-ipc-lock-and-cap-sys-nice-in-docker", category: "Configuration & settings", tags: ["Errors and Exceptions"] }, { id: "troubleshooting/configure-cap-ipc-lock-and-cap-sys-nice-in-docker", title: "在 Docker 中配置 CAP_IPC_LOCK 和 CAP_SYS_NICE 能力", description: "了解如何在容器中运行 ClickHouse 时解决 `CAP_IPC_LOCK` 和 `CAP_SYS_NICE` 的 Docker 能力警告。", href: "/zh/resources/support-center/knowledge-base/troubleshooting/configure-cap-ipc-lock-and-cap-sys-nice-in-docker", category: "Troubleshooting & errors", tags: ["Errors and Exceptions"] }, { id: "cloud-services/confluent-cloud-private-connectivity-for-clickpipes", title: "ClickPipes 的 Confluent Cloud 私网连接", description: "如何通过 AWS PrivateLink 或 GCP Private Service Connect 将 ClickPipes 连接到现有的 Confluent Cloud Kafka 集群。", href: "/zh/resources/support-center/knowledge-base/cloud-services/confluent-cloud-private-connectivity-for-clickpipes", category: "Cloud", tags: ["Security and Authentication", "Managing Cloud"] }, { id: "cloud-services/custom-dns-alias-for-instance", title: "通过设置反向代理创建自定义 DNS 别名", description: "了解如何使用反向代理为您的实例设置自定义 DNS 别名", href: "/zh/resources/support-center/knowledge-base/cloud-services/custom-dns-alias-for-instance", category: "Cloud", tags: ["Server Admin", "Security and Authentication"] }, { id: "troubleshooting/part-intersects-previous-part", title: "DB::Exception: Part XXXXX intersects previous part YYYYY. It is a bug or a result of manual intervention in the ZooKeeper data.", description: "本文介绍如何解决 ClickHouse 中与交叉部分相关的 DB::Exception 错误，该错误通常由竞争条件或对 ZooKeeper 数据的手动干预引起。", href: "/zh/resources/support-center/knowledge-base/troubleshooting/part-intersects-previous-part", category: "Troubleshooting & errors", tags: ["Errors and Exceptions", "System Tables"] }, { id: "setup-installation/difference-between-official-builds-and-3rd-party", title: "官方与第三方 ClickHouse 构建版本之间的差异", description: "了解官方 ClickHouse 构建版本与第三方构建版本之间的主要差异，包括更新、兼容性和安全注意事项。", href: "/zh/resources/support-center/knowledge-base/setup-installation/difference-between-official-builds-and-3rd-party", category: "Setup & installation", tags: ["Concepts"] }, { id: "general-faqs/cost-based", title: "ClickHouse 是否有基于成本的优化器", description: "ClickHouse 具有某些基于成本的优化机制", href: "/zh/resources/support-center/knowledge-base/general-faqs/cost-based", category: "General & FAQs", tags: [] }, { id: "general-faqs/datalake", title: "ClickHouse 是否支持数据湖？", description: "ClickHouse 支持数据湖，包括 Iceberg、Delta Lake、Apache Hudi、Apache Paimon、Hive", href: "/zh/resources/support-center/knowledge-base/general-faqs/datalake", category: "General & FAQs", tags: [] }, { id: "general-faqs/distributed-join", title: "ClickHouse 是否支持分布式 JOIN？", description: "ClickHouse 支持分布式 JOIN", href: "/zh/resources/support-center/knowledge-base/general-faqs/distributed-join", category: "General & FAQs", tags: [] }, { id: "general-faqs/federated", title: "ClickHouse 是否支持联邦查询？", description: "ClickHouse 支持广泛的联邦查询和混合查询", href: "/zh/resources/support-center/knowledge-base/general-faqs/federated", category: "General & FAQs", tags: [] }, { id: "general-faqs/concurrency", title: "ClickHouse 是否支持频繁的并发查询？", description: "ClickHouse 支持高 QPS 和高并发", href: "/zh/resources/support-center/knowledge-base/general-faqs/concurrency", category: "General & FAQs", tags: [] }, { id: "cloud-services/multi-region-replication", title: "ClickHouse 是否支持多区域复制？", description: "本页面回答 ClickHouse 是否支持多区域复制", href: "/zh/resources/support-center/knowledge-base/cloud-services/multi-region-replication", category: "Cloud", tags: [] }, { id: "general-faqs/updates", title: "ClickHouse 是否支持实时更新？", description: "ClickHouse 支持轻量级实时更新", href: "/zh/resources/support-center/knowledge-base/general-faqs/updates", category: "General & FAQs", tags: [] }, { id: "security/row-column-policy", title: "ClickHouse 是否支持行级和列级安全？", description: "了解 ClickHouse 和 ClickHouse Cloud 中的行级和列级访问限制，以及如何使用策略实现基于角色的访问控制 (RBAC)。", href: "/zh/resources/support-center/knowledge-base/security/row-column-policy", category: "Security & access control", tags: ["Security and Authentication"] }, { id: "cloud-services/execute-system-queries-in-cloud", title: "在 ClickHouse Cloud 的所有节点上执行 SYSTEM 语句", description: "了解如何使用 `ON CLUSTER` 和 `clusterAllReplicas` 在 ClickHouse Cloud 服务的所有节点上执行 SYSTEM 语句和查询。", href: "/zh/resources/support-center/knowledge-base/cloud-services/execute-system-queries-in-cloud", category: "Cloud", tags: ["Deployments and Scaling"] }, { id: "troubleshooting/count-parts-by-type", title: "查找宽型或紧凑型部分的数量和大小", description: "本知识库文章介绍如何按部分类型（宽型或紧凑型）查找部分数量。", href: "/zh/resources/support-center/knowledge-base/troubleshooting/count-parts-by-type", category: "Troubleshooting & errors", tags: ["Troubleshooting"] }, { id: "troubleshooting/fix-developer-verification-error-in-macos", title: "修复 macOS 中的开发者验证错误", description: "了解如何在运行 ClickHouse 命令时解决 macOS 开发者验证错误，可使用系统设置或终端。", href: "/zh/resources/support-center/knowledge-base/troubleshooting/fix-developer-verification-error-in-macos", category: "Troubleshooting & errors", tags: ["Errors and Exceptions"] }, { id: "data-import-export/s3-export-data-year-month-folders", title: "如何在 S3 上按年和月进行分区写入？", description: "了解如何在 ClickHouse 中按年和月将分区数据写入 S3 存储桶，使用自定义路径结构组织数据。", href: "/zh/resources/support-center/knowledge-base/data-import-export/s3-export-data-year-month-folders", category: "Data import & export", tags: ["Data Export", "Native Clients and Interfaces"] }, { id: "data-import-export/kafka-clickhouse-json", title: "如何将新的 JSON 数据类型与 Kafka 配合使用？", description: "Learn how to load JSON messages from Apache Kafka directly into a single JSON column in ClickHouse using the Kafka table engine and JSON data type.", href: "/zh/resources/support-center/knowledge-base/data-import-export/kafka-clickhouse-json", category: "Data import & export", tags: ["Data Formats", "Data Ingestion"] }, { id: "cloud-services/change-billing-email", title: "如何更改 ClickHouse Cloud 中的账单联系人？", description: "Let's learn how to change your billing address in ClickHouse Cloud.", href: "/zh/resources/support-center/knowledge-base/cloud-services/change-billing-email", category: "Cloud", tags: ["Managing Cloud"] }, { id: "general-faqs/how-do-i-contribute-code-to-clickhouse", title: "How do I contribute code to ClickHouse?", description: "ClickHouse is an open-source project developed on GitHub. As customary, contribution instructions are published in CONTRIBUTING file in the root of the source code repository.", href: "/zh/resources/support-center/knowledge-base/general-faqs/how-do-i-contribute-code-to-clickhouse", category: "General & FAQs", tags: ["Community"] }, { id: "data-import-export/parquet-to-csv-json", title: "如何将文件从 Parquet 转换为 CSV 或 JSON？", description: "Learn how to use ClickHouse's `clickhouse-local` tool to easily convert Parquet files to CSV or JSON formats.", href: "/zh/resources/support-center/knowledge-base/data-import-export/parquet-to-csv-json", category: "Data import & export", tags: ["Data Sources", "Data Formats"] }, { id: "data-import-export/mysql-to-parquet-csv-json", title: "如何使用 ClickHouse 将 MySQL 数据导出为 Parquet、CSV 或 JSON", description: "Learn how to use the `clickhouse-local` tool to export MySQL data into formats like Parquet, CSV, or JSON quickly and efficiently.", href: "/zh/resources/support-center/knowledge-base/data-import-export/mysql-to-parquet-csv-json", category: "Data import & export", tags: ["Data Formats", "Data Export"] }, { id: "data-import-export/postgresql-to-parquet-csv-json", title: "How do I export PostgreSQL data to Parquet, CSV or JSON?", description: "Learn how to export PostgreSQL data to Parquet, CSV, or JSON formats using `clickhouse-local` with various examples.", href: "/zh/resources/support-center/knowledge-base/data-import-export/postgresql-to-parquet-csv-json", category: "Data import & export", tags: ["Data Export", "Data Formats"] }, { id: "setup-installation/install-clickhouse-windows10", title: "如何在 Windows 10 上安装 ClickHouse？", description: "Learn how to install and test ClickHouse on Windows 10 using WSL 2. Includes setup, troubleshooting, and running a test environment.", href: "/zh/resources/support-center/knowledge-base/setup-installation/install-clickhouse-windows10", category: "Setup & installation", tags: ["Tools and Utilities"] }, { id: "security/remove-default-user", title: "How do I remove the default user?", description: "Learn how to remove the default user when running ClickHouse Server.", href: "/zh/resources/support-center/knowledge-base/security/remove-default-user", category: "Security & access control", tags: ["Server Admin"] }, { id: "cloud-services/ingest-failures-23-9-release", title: "如何解决 ClickHouse 23.9 版本发布后的数据摄取失败问题？", description: "Learn how to resolve ingest failures caused by stricter grant checking introduced in ClickHouse 23.9 for tables using `async_inserts`. Update grants to fix errors.", href: "/zh/resources/support-center/knowledge-base/cloud-services/ingest-failures-23-9-release", category: "Cloud", tags: ["Errors and Exceptions"] }, { id: "performance-optimization/insert-select-settings-tuning", title: "How do I solve TOO MANY PARTS error during an INSERT...SELECT?", description: "Resolve the TOO_MANY_PARTS error in ClickHouse during an `INSERT...SELECT` by tuning expert-level settings for larger blocks and increasing partition thresholds.", href: "/zh/resources/support-center/knowledge-base/performance-optimization/insert-select-settings-tuning", category: "Performance & optimization", tags: ["Settings", "Errors and Exceptions"] }, { id: "integrations/node-js-example", title: "How do I use NodeJS with @clickhouse/client", description: "Learn how to use @clickhouse/client in a Node.js application to interact with ClickHouse and perform queries.", href: "/zh/resources/support-center/knowledge-base/integrations/node-js-example", category: "Integrations & client libraries", tags: ["Language Clients"] }, { id: "monitoring-debugging/view-number-of-active-mutations", title: "How do I view the number of active or queued mutations?", description: "Monitor the number of active or queued mutations in ClickHouse, especially when performing `ALTER` or `UPDATE` operations. Use the `system.mutations` table for tracking mutations.", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/view-number-of-active-mutations", category: "Monitoring & debugging", tags: ["System Tables"] }, { id: "data-management/read-consistency", title: "How to achieve data read consistency in ClickHouse?", description: "Learn how to ensure data consistency when reading from ClickHouse, whether you're connected to the same node or a random node.", href: "/zh/resources/support-center/knowledge-base/data-management/read-consistency", category: "Data management", tags: ["Performance and Optimizations"] }, { id: "setup-installation/llvm-clang-up-to-date", title: "How to build LLVM and clang on Linux", description: "Commands to build LLVM and clang on Linux.", href: "/zh/resources/support-center/knowledge-base/setup-installation/llvm-clang-up-to-date", category: "Setup & installation", tags: ["Community", "Tools and Utilities"] }, { id: "data-management/calculate-ratio-of-zero-sparse-serialization", title: "How to calculate the ratio of empty/zero values in every column in a table", description: "Learn how to calculate the ratio of empty or zero values in every column of a ClickHouse table to optimize sparse column serialization.", href: "/zh/resources/support-center/knowledge-base/data-management/calculate-ratio-of-zero-sparse-serialization", category: "Data management", tags: ["Performance and Optimizations"] }, { id: "security/check-users-roles", title: "How to Check Users Assigned to Roles and Vice Versa", description: "Learn how to query ClickHouse's `system.role_grants` to find users assigned to roles and roles assigned to specific users.", href: "/zh/resources/support-center/knowledge-base/security/check-users-roles", category: "Security & access control", tags: ["Server Admin", "System Tables", "Managing Cloud"] }, { id: "monitoring-debugging/which-processes-are-currently-running", title: "How to check what code is currently running on a server?", description: "ClickHouse provides introspection tools like `system.stack_trace` for inspecting what code is currently running on each server thread, helping with debugging and performance monitoring.", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/which-processes-are-currently-running", category: "Monitoring & debugging", tags: ["Server Admin"] }, { id: "cloud-services/how-to-check-my-clickhouse-cloud-sevice-state", title: "如何检查您的 ClickHouse Cloud 服务状态", description: "Learn how to use the ClickHouse Cloud API to check if your service is stopped, idle, or running without waking it up.", href: "/zh/resources/support-center/knowledge-base/cloud-services/how-to-check-my-clickhouse-cloud-sevice-state", category: "Cloud", tags: ["Managing Cloud"] }, { id: "monitoring-debugging/collect-and-draw-traces", title: "如何收集并绘制查询追踪", description: "本指南介绍如何使用内置方法或 Grafana 收集并绘制自托管 ClickHouse 的查询追踪信息。当您处理复杂查询并需要深入了解 EXPLAIN 所提供信息之外的内部执行机制时，本指南尤为实用。", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/collect-and-draw-traces", category: "Monitoring & debugging", tags: ["Tools and Utilities"] }, { id: "configuration-settings/configure-a-user-setting", title: "如何在 ClickHouse 中为用户配置设置", description: "了解如何使用 `SET` 和 `ALTER USER` 命令在 ClickHouse 中为单个查询、客户端会话或特定用户定义设置。", href: "/zh/resources/support-center/knowledge-base/configuration-settings/configure-a-user-setting", category: "Configuration & settings", tags: ["Settings"] }, { id: "materialized-views/projection-example", title: "如何确认查询是否使用了 Projection？", description: "了解如何通过测试示例数据并使用 EXPLAIN 来验证 ClickHouse 查询中是否使用了 projection。", href: "/zh/resources/support-center/knowledge-base/materialized-views/projection-example", category: "Materialized views & projections", tags: ["Data Modelling"] }, { id: "cloud-services/how-to-connect-to-ch-cloud-using-ssh-keys", title: "如何使用 SSH 密钥连接到 ClickHouse", description: "如何使用 SSH 密钥连接到 ClickHouse 和 ClickHouse Cloud", href: "/zh/resources/support-center/knowledge-base/cloud-services/how-to-connect-to-ch-cloud-using-ssh-keys", category: "Cloud", tags: ["Managing Cloud", "Security and Authentication"] }, { id: "data-management/dictionary-using-strings", title: "如何创建使用字符串键和值的 ClickHouse 字典", description: "了解如何以 MergeTree 表为数据源，使用字符串键和值创建 ClickHouse 字典，并附有设置和使用示例。", href: "/zh/resources/support-center/knowledge-base/data-management/dictionary-using-strings", category: "Data management", tags: ["Data Modelling"] }, { id: "tables-schema/how-to-create-table-to-query-multiple-remote-clusters", title: "如何创建可查询多个远程集群的表", description: "如何创建可查询多个远程集群的表", href: "/zh/resources/support-center/knowledge-base/tables-schema/how-to-create-table-to-query-multiple-remote-clusters", category: "Tables & schema", tags: ["Deployments and Scaling"] }, { id: "setup-installation/enabling-ssl-with-lets-encrypt", title: "如何在单台 ClickHouse 服务器上使用 Let's Encrypt 启用 SSL", description: "了解如何使用 Let's Encrypt 为单台 ClickHouse 服务器设置 SSL，包括证书颁发、配置和验证。", href: "/zh/resources/support-center/knowledge-base/setup-installation/enabling-ssl-with-lets-encrypt", category: "Setup & installation", tags: ["Security and Authentication"] }, { id: "data-import-export/file-export", title: "如何将数据从 ClickHouse 导出到文件", description: "了解从 ClickHouse 导出数据的各种方法，包括 `INTO OUTFILE`、File 表引擎和命令行重定向。", href: "/zh/resources/support-center/knowledge-base/data-import-export/file-export", category: "Data import & export", tags: ["Data Export"] }, { id: "queries-sql/how-to-filter-a-clickhouse-table-by-an-array-column", title: "如何按数组列过滤 ClickHouse 表？", description: "关于如何按数组列过滤 ClickHouse 表的知识库文章。", href: "/zh/resources/support-center/knowledge-base/queries-sql/how-to-filter-a-clickhouse-table-by-an-array-column", category: "Queries & SQL", tags: ["Data Modelling", "Functions"] }, { id: "monitoring-debugging/generate-har-file", title: "如何生成 HAR 文件以供支持使用", description: "HAR（HTTP 存档）文件记录浏览器中的网络活动，可帮助我们的支持团队诊断页面加载缓慢、请求失败或其他网络问题。", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/generate-har-file", category: "Monitoring & debugging", tags: ["Tools and Utilities"] }, { id: "materialized-views/how-to-display-queries-using-mv", title: "如何识别 ClickHouse 中使用物化视图的查询", description: "了解如何查询 ClickHouse 日志，以识别指定时间范围内涉及物化视图的所有查询。", href: "/zh/resources/support-center/knowledge-base/materialized-views/how-to-display-queries-using-mv", category: "Materialized views & projections", tags: ["System Tables"] }, { id: "performance-optimization/find-expensive-queries", title: "如何识别 ClickHouse 中最耗资源的查询", description: "了解如何使用 ClickHouse 中的 `query_log` 表识别分布式节点中内存和 CPU 消耗最多的查询。", href: "/zh/resources/support-center/knowledge-base/performance-optimization/find-expensive-queries", category: "Performance & optimization", tags: ["Performance and Optimizations"] }, { id: "configuration-settings/ignoring-incorrect-settings", title: "如何忽略 ClickHouse 中的错误设置", description: "了解如何使用 `skip_check_for_incorrect_settings` 选项，使 ClickHouse 在用户级设置指定错误时仍能正常启动。", href: "/zh/resources/support-center/knowledge-base/configuration-settings/ignoring-incorrect-settings", category: "Configuration & settings", tags: ["Settings"] }, { id: "data-import-export/json-import", title: "如何将 JSON 导入 ClickHouse？", description: "本页介绍如何将 JSON 导入 ClickHouse", href: "/zh/resources/support-center/knowledge-base/data-import-export/json-import", category: "Data import & export", tags: [] }, { id: "setup-installation/how-to-increase-thread-pool-size", title: "如何增加 ClickHouse 中的线程数", description: "了解如何通过调整 `max_thread_pool_size`、`thread_pool_queue_size` 和 `max_thread_pool_free_size` 等设置来配置 ClickHouse 中的全局线程池。", href: "/zh/resources/support-center/knowledge-base/setup-installation/how-to-increase-thread-pool-size", category: "Setup & installation", tags: ["Performance and Optimizations"] }, { id: "data-import-export/kafka-to-clickhouse-setup", title: "如何将数据从 Kafka 摄取到 ClickHouse", description: "了解如何使用 Kafka 表引擎、物化视图和 MergeTree 表将数据从 Kafka 主题摄取到 ClickHouse。", href: "/zh/resources/support-center/knowledge-base/data-import-export/kafka-to-clickhouse-setup", category: "Data import & export", tags: ["Data Ingestion"] }, { id: "data-import-export/ingest-parquet-files-in-s3", title: "如何从 S3 存储桶摄取 Parquet 文件", description: "了解在 ClickHouse 中使用 S3 表引擎从 S3 存储桶摄取和查询 Parquet 文件的基础知识，包括设置、访问权限和数据导入示例。", href: "/zh/resources/support-center/knowledge-base/data-import-export/ingest-parquet-files-in-s3", category: "Data import & export", tags: ["Data Ingestion"] }, { id: "queries-sql/how-to-insert-all-rows-from-another-table", title: "如何将一张表中的所有行插入另一张表？", description: "关于如何将一张表中的所有行插入另一张表的知识库文章。", href: "/zh/resources/support-center/knowledge-base/queries-sql/how-to-insert-all-rows-from-another-table", category: "Queries & SQL", tags: ["Data Ingestion"] }, { id: "performance-optimization/check-query-processing-time-only", title: "如何在不返回行的情况下测量查询处理时间", description: "了解如何使用 ClickHouse 中的 `FORMAT Null` 选项在不向客户端返回任何行的情况下测量查询处理时间。", href: "/zh/resources/support-center/knowledge-base/performance-optimization/check-query-processing-time-only", category: "Performance & optimization", tags: ["Performance and Optimizations"] }, { id: "cloud-services/opt-out-core-dump-collection", title: "如何选择退出崩溃报告收集", description: "本文介绍如何在 ClickHouse Cloud 上选择退出崩溃报告收集", href: "/zh/resources/support-center/knowledge-base/cloud-services/opt-out-core-dump-collection", category: "Cloud", tags: ["Managing Cloud"] }, { id: "monitoring-debugging/outputSendLogsLevelTracesToFile", title: "How to output send logs level traces to file using the clickhouse-client", description: "How to output send logs level traces to file using the clickhouse-client", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/outputSendLogsLevelTracesToFile", category: "Monitoring & debugging", tags: ["Data Export"] }, { id: "tables-schema/recreate-table-across-terminals", title: "How to quickly recreate a small table across different terminals", description: "Learn how to quickly recreate a small table and its data across different terminals using copy/paste for development environments.", href: "/zh/resources/support-center/knowledge-base/tables-schema/recreate-table-across-terminals", category: "Tables & schema", tags: ["Tools and Utilities"] }, { id: "troubleshooting/recovering-from-corrupt-keeper-snapshot", title: "如何从损坏的 Keeper 快照中恢复", description: "本文介绍如何从损坏的 Keeper 快照中恢复：问题的表现形式、快照的定义及其位置，以及可能的恢复策略。", href: "/zh/resources/support-center/knowledge-base/troubleshooting/recovering-from-corrupt-keeper-snapshot", category: "Troubleshooting & errors", tags: ["Troubleshooting"] }, { id: "troubleshooting/restore-replica-after-storage-failure", title: "如何在存储故障后恢复副本", description: "本文介绍在 ClickHouse 中使用原子数据库中的复制表时，当某个副本的磁盘/存储丢失或损坏后如何恢复数据。", href: "/zh/resources/support-center/knowledge-base/troubleshooting/restore-replica-after-storage-failure", category: "Troubleshooting & errors", tags: ["Deployments and Scaling"] }, { id: "integrations/how-to-set-up-ch-on-docker-odbc-connect-mssql", title: "How to set up ClickHouse on Docker with ODBC to connect to a Microsoft SQL Server (MSSQL) database", description: "How to set up ClickHouse on Docker with ODBC to connect to a Microsoft SQL Server (MSSQL) database", href: "/zh/resources/support-center/knowledge-base/integrations/how-to-set-up-ch-on-docker-odbc-connect-mssql", category: "Integrations & client libraries", tags: ["Native Clients and Interfaces"] }, { id: "queries-sql/using-array-join-to-extract-and-query-attributes", title: "How to use array join to extract and query varying attributes using map keys and values", description: "通过简单示例说明如何使用 array join 通过 map 键和值提取并查询动态属性", href: "/zh/resources/support-center/knowledge-base/queries-sql/using-array-join-to-extract-and-query-attributes", category: "Queries & SQL", tags: ["Functions"] }, { id: "materialized-views/how-to-use-parametrised-views", title: "How to Use Parameterized Views in ClickHouse", description: "Learn how to create and query parameterized views in ClickHouse for dynamic data slicing based on query-time parameters.", href: "/zh/resources/support-center/knowledge-base/materialized-views/how-to-use-parametrised-views", category: "Materialized views & projections", tags: ["Use Cases"] }, { id: "tables-schema/exchangeStatementToSwitchTables", title: "How to use the exchange command to switch tables", description: "How to use the exchange command to switch tables", href: "/zh/resources/support-center/knowledge-base/tables-schema/exchangeStatementToSwitchTables", category: "Tables & schema", tags: ["Managing Data"] }, { id: "queries-sql/compare-resultsets", title: "How to Validate if Two Queries Return the Same Result-sets", description: "Learn how to validate that two ClickHouse queries produce identical result-sets using hash functions and comparison techniques.", href: "/zh/resources/support-center/knowledge-base/queries-sql/compare-resultsets", category: "Queries & SQL", tags: ["Functions"] }, { id: "monitoring-debugging/check-query-cache-in-use", title: "How to verify query cache usage in ClickHouse", description: "Learn how to check if query cache is being utilized in ClickHouse using `clickhouse-client` trace logs or SQL commands.", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/check-query-cache-in-use", category: "Monitoring & debugging", tags: ["Performance and Optimizations"] }, { id: "cloud-services/unable-to-access-cloud-service", title: "I am unable to access a ClickHouse Cloud service", description: "Troubleshooting access issues with ClickHouse Cloud services, including IP Access List configuration", href: "/zh/resources/support-center/knowledge-base/cloud-services/unable-to-access-cloud-service", category: "Cloud", tags: ["Errors and Exceptions", "Managing Cloud"] }, { id: "performance-optimization/finding-expensive-queries-by-memory-usage", title: "Identifying Expensive Queries by Memory Usage in ClickHouse", description: "Learn how to use the `system.query_log` table to find the most memory-intensive queries in ClickHouse, with examples for clustered and standalone setups.", href: "/zh/resources/support-center/knowledge-base/performance-optimization/finding-expensive-queries-by-memory-usage", category: "Performance & optimization", tags: ["Performance and Optimizations"] }, { id: "data-import-export/importing-and-working-with-json-array-objects", title: "Importing and Querying JSON Array Objects in ClickHouse", description: "Learn how to import JSON array objects into ClickHouse and perform advanced queries using JSON functions and array operations.", href: "/zh/resources/support-center/knowledge-base/data-import-export/importing-and-working-with-json-array-objects", category: "Data import & export", tags: ["Data Formats"] }, { id: "data-import-export/importing-geojason-with-nested-object-array", title: "Importing GeoJSON with a deeply nested object array", description: "Learn how to import GeoJSON files with deeply nested object arrays into ClickHouse and query the nested feature data.", href: "/zh/resources/support-center/knowledge-base/data-import-export/importing-geojason-with-nested-object-array", category: "Data import & export", tags: ["Data Formats"] }, { id: "performance-optimization/improve-map-performance", title: "Improving Map lookup performance in ClickHouse", description: "Learn how to optimize Map column lookups in ClickHouse for better query performance by materializing specific keys as standalone columns.", href: "/zh/resources/support-center/knowledge-base/performance-optimization/improve-map-performance", category: "Performance & optimization", tags: ["Performance and Optimizations"] }, { id: "tables-schema/delete-old-data", title: "Is it possible to delete old records from a ClickHouse table?", description: "This page answers the question of whether it is possible to delete old records from a ClickHouse table", href: "/zh/resources/support-center/knowledge-base/tables-schema/delete-old-data", category: "Tables & schema", tags: [] }, { id: "general-faqs/separate-storage", title: "Is it possible to deploy ClickHouse with separate storage and compute?", description: "This page provides an answer as to whether it is possible to deploy ClickHouse with separate storage and compute", href: "/zh/resources/support-center/knowledge-base/general-faqs/separate-storage", category: "General & FAQs", tags: [] }, { id: "data-import-export/json-extract-example", title: "JSON Extract example", description: "A short example on how to extract base types from JSON", href: "/zh/resources/support-center/knowledge-base/data-import-export/json-extract-example", category: "Data import & export", tags: ["Data Formats"] }, { id: "queries-sql/calculate-pi-using-sql", title: "Let's calculate pi using SQL", description: "It's Pi Day! Let's calculate pi using ClickHouse SQL", href: "/zh/resources/support-center/knowledge-base/queries-sql/calculate-pi-using-sql", category: "Queries & SQL", tags: ["Use Cases"] }, { id: "cloud-services/clickhouse-cloud-api-usage", title: "Managing ClickHouse Cloud Service with API and cURL", description: "Learn how to start, stop, and resume a ClickHouse Cloud service using API endpoints and cURL commands.", href: "/zh/resources/support-center/knowledge-base/cloud-services/clickhouse-cloud-api-usage", category: "Cloud", tags: ["Managing Cloud", "Tools and Utilities"] }, { id: "monitoring-debugging/mapping-of-system-metrics-to-prometheus-metrics", title: "Mapping of metrics used in system.dashboards to Prometheus metrics in `system.custom_metrics`", description: "Mapping of metrics used in system.dashboards to Prometheus metrics in system.custom_metrics", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/mapping-of-system-metrics-to-prometheus-metrics", category: "Monitoring & debugging", tags: ["System Tables"] }, { id: "security/windows-active-directory-to-ch-roles", title: "Mapping Windows Active Directory security groups to ClickHouse roles", description: "Example of mapping Windows Active Directory security groups to ClickHouse roles", href: "/zh/resources/support-center/knowledge-base/security/windows-active-directory-to-ch-roles", category: "Security & access control", tags: ["Tools and Utilities"] }, { id: "performance-optimization/memory-limit-exceeded-for-query", title: "Memory limit exceeded for query", description: "Troubleshooting memory limit exceeded errors for a query", href: "/zh/resources/support-center/knowledge-base/performance-optimization/memory-limit-exceeded-for-query", category: "Performance & optimization", tags: ["Errors and Exceptions"] }, { id: "integrations/ODBC-authentication-failed-error-using-PowerBI-CH-connector", title: "ODBC authentication failed error when using the Power BI ClickHouse connector", description: "ODBC authentication failed error when using the Power BI ClickHouse connector", href: "/zh/resources/support-center/knowledge-base/integrations/ODBC-authentication-failed-error-using-PowerBI-CH-connector", category: "Integrations & client libraries", tags: ["Native Clients and Interfaces", "Errors and Exceptions"] }, { id: "monitoring-debugging/profiling-clickhouse-with-llvm-xray", title: "Profiling ClickHouse with LLVM's XRay", description: "Learn how to profile ClickHouse using LLVM's XRay instrumentation profiler, visualize traces, and analyze performance.", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/profiling-clickhouse-with-llvm-xray", category: "Monitoring & debugging", tags: ["Performance and Optimizations", "Tools and Utilities"] }, { id: "integrations/python-http-requests", title: "Python quick example using HTTP requests module", description: "An example using Python and requests module to write and read to ClickHouse", href: "/zh/resources/support-center/knowledge-base/integrations/python-http-requests", category: "Integrations & client libraries", tags: ["Native Clients and Interfaces"] }, { id: "configuration-settings/maximum-number-of-tables-and-databases", title: "Recommended Maximum Databases, Tables, Partitions, and Parts in ClickHouse", description: "Learn the recommended maximum limits for databases, tables, partitions, and parts in a ClickHouse cluster to ensure optimal performance.", href: "/zh/resources/support-center/knowledge-base/configuration-settings/maximum-number-of-tables-and-databases", category: "Configuration & settings", tags: ["Performance and Optimizations", "Deployments and Scaling"] }, { id: "data-import-export/cannot-append-data-to-parquet-format", title: 'Resolving "Cannot Append Data in Parquet Format" error in ClickHouse', description: 'Are you getting the error "Cannot append data in format Parquet to file" error in ClickHouse? Let\'s take a look at how to resolve it.', href: "/zh/resources/support-center/knowledge-base/data-import-export/cannot-append-data-to-parquet-format", category: "Data import & export", tags: ["Errors and Exceptions", "Data Formats"] }, { id: "troubleshooting/exception-too-many-parts", title: 'Resolving "Too Many Parts" error in ClickHouse', description: 'Learn how to address the "Too many parts" error in ClickHouse by optimizing insert rates, configuring MergeTree settings, and managing partitions effectively.', href: "/zh/resources/support-center/knowledge-base/troubleshooting/exception-too-many-parts", category: "Troubleshooting & errors", tags: ["Errors and Exceptions"] }, { id: "troubleshooting/certificate-verify-failed-error", title: "Resolving SSL Certificate Verify Error in ClickHouse", description: "Learn how to resolve the SSL Exception CERTIFICATE_VERIFY_FAILED error.", href: "/zh/resources/support-center/knowledge-base/troubleshooting/certificate-verify-failed-error", category: "Troubleshooting & errors", tags: ["Security and Authentication", "Errors and Exceptions"] }, { id: "troubleshooting/connection-timeout-remote-remoteSecure", title: "Resolving Timeout Errors with `remote` and `remoteSecure` Table Functions", description: "Learn how to fix timeout errors when using `remote` or `remoteSecure` table functions in ClickHouse by adjusting the connection timeout settings.", href: "/zh/resources/support-center/knowledge-base/troubleshooting/connection-timeout-remote-remoteSecure", category: "Troubleshooting & errors", tags: ["Errors and Exceptions"] }, { id: "tables-schema/runbook-json", title: "Runbook：JSON schema", description: "为 ClickHouse 中的 JSON 数据选择合适的 schema 方案——类型化列、混合模式、原生 JSON 或 String 存储", href: "/zh/resources/support-center/knowledge-base/tables-schema/runbook-json", category: "Tables & schema", tags: ["Runbooks", "Data Modelling"] }, { id: "tables-schema/search-across-node-for-tables-with-a-wildcard", title: "Searching across nodes for tables with a wildcard", description: "Learn how to search across nodes for tables with a wildcard.", href: "/zh/resources/support-center/knowledge-base/tables-schema/search-across-node-for-tables-with-a-wildcard", category: "Tables & schema", tags: ["Deployments and Scaling"] }, { id: "performance-optimization/query-max-execution-time", title: "Setting a limit on query execution time", description: "How to enforce limit on max query execution time", href: "/zh/resources/support-center/knowledge-base/performance-optimization/query-max-execution-time", category: "Performance & optimization", tags: ["Managing Cloud", "Settings"] }, { id: "data-import-export/json-simple-example", title: "Simple example flow for extracting JSON data using a landing table with a Materialized View", description: "Simple example flow for extracting JSON data using a landing table with a Materialized View", href: "/zh/resources/support-center/knowledge-base/data-import-export/json-simple-example", category: "Data import & export", tags: ["Data Formats"] }, { id: "performance-optimization/async-vs-optimize-read-in-order", title: "Synchronous data reading", description: "The new setting `allow_asynchronous_read_from_io_pool_for_merge_tree` allows the number of reading threads (streams) to be higher than the number of threads in the rest of the query execution pipeline.", href: "/zh/resources/support-center/knowledge-base/performance-optimization/async-vs-optimize-read-in-order", category: "Performance & optimization", tags: ["Settings", "Performance and Optimizations"] }, { id: "integrations/terraform-example", title: "Terraform example on how to use Cloud API", description: "This covers an example of how you can use terraform to create/delete clusters using the API", href: "/zh/resources/support-center/knowledge-base/integrations/terraform-example", category: "Integrations & client libraries", tags: ["Native Clients and Interfaces"] }, { id: "performance-optimization/tips-tricks-optimizing-basic-data-types-in-clickhouse", title: "Tips and tricks on optimizing basic data types in ClickHouse", description: "Tips and tricks on optimizing basic data types in ClickHouse", href: "/zh/resources/support-center/knowledge-base/performance-optimization/tips-tricks-optimizing-basic-data-types-in-clickhouse", category: "Performance & optimization", tags: ["Performance and Optimizations"] }, { id: "data-management/understanding-part-types-and-storage-formats", title: "了解 ClickHouse 中的分片类型与存储格式", description: "了解 ClickHouse 中不同的分片类型（Wide 与 Compact）和存储格式（Full 与 Packed），以及它们对性能的影响。", href: "/zh/resources/support-center/knowledge-base/data-management/understanding-part-types-and-storage-formats", category: "Data management", tags: ["Core Data Concepts"] }, { id: "queries-sql/useful-queries-for-troubleshooting", title: "Useful queries for troubleshooting", description: "A collection of handy queries for troubleshooting ClickHouse, including monitoring table sizes, long-running queries, and errors.", href: "/zh/resources/support-center/knowledge-base/queries-sql/useful-queries-for-troubleshooting", category: "Queries & SQL", tags: ["Settings"] }, { id: "general-faqs/use-clickhouse-for-log-analytics", title: "Using ClickHouse for log analytics", description: "ClickHouse is popular for logs and metrics analysis because of the real-time analytics capabilities provided. Ready to find out more?", href: "/zh/resources/support-center/knowledge-base/general-faqs/use-clickhouse-for-log-analytics", category: "General & FAQs", tags: ["Use Cases"] }, { id: "queries-sql/filtered-aggregates", title: "Using filtered aggregates in ClickHouse", description: "Learn how to use filtered aggregates in ClickHouse with `-If` and `-Distinct` aggregate combinators to simplify query syntax and enhance analytics.", href: "/zh/resources/support-center/knowledge-base/queries-sql/filtered-aggregates", category: "Queries & SQL", tags: ["Functions"] }, { id: "general-faqs/dependencies", title: "What are the 3rd-party dependencies for running ClickHouse?", description: "ClickHouse is self-contained and has no runtime dependencies", href: "/zh/resources/support-center/knowledge-base/general-faqs/dependencies", category: "General & FAQs", tags: [] }, { id: "general-faqs/dbms-naming", title: 'What does "ClickHouse" mean?', description: 'Learn about What does "ClickHouse" mean?', href: "/zh/resources/support-center/knowledge-base/general-faqs/dbms-naming", category: "General & FAQs", tags: [] }, { id: "general-faqs/ne-tormozit", title: "What does “не тормозит” mean?", description: 'This page explains what "Не тормозит" means', href: "/zh/resources/support-center/knowledge-base/general-faqs/ne-tormozit", category: "General & FAQs", tags: [] }, { id: "integrations/oracle-odbc", title: "What if I have a problem with encodings when using Oracle via ODBC?", description: "This page provides guidance on what to do if you have a problem with encodings when using Oracle via ODBC", href: "/zh/resources/support-center/knowledge-base/integrations/oracle-odbc", category: "Integrations & client libraries", tags: [] }, { id: "general-faqs/columnar-database", title: "What is a columnar database?", description: "A columnar database stores the data of each column independently. This allows reading data from disk only for those columns that are used in any given query.", href: "/zh/resources/support-center/knowledge-base/general-faqs/columnar-database", category: "General & FAQs", tags: ["Core Data Concepts"] }, { id: "general-faqs/olap", title: "What is OLAP?", description: "An explainer on what Online Analytical Processing is", href: "/zh/resources/support-center/knowledge-base/general-faqs/olap", category: "General & FAQs", tags: [] }, { id: "performance-optimization/optimize-final-vs-final", title: "What is the difference between OPTIMIZE FINAL and FINAL?", description: "Discusses the differences between OPTIMIZE FINAL and FINAL, and when to use and avoid them.", href: "/zh/resources/support-center/knowledge-base/performance-optimization/optimize-final-vs-final", category: "Performance & optimization", tags: ["Core Data Concepts"] }, { id: "general-faqs/sql", title: "What SQL syntax does ClickHouse support?", description: "ClickHouse supports 100% of SQL syntax", href: "/zh/resources/support-center/knowledge-base/general-faqs/sql", category: "General & FAQs", tags: [] }, { id: "data-management/when-is-ttl-applied", title: "When are TTL rules applied, and do we have control over it?", description: "TTL rules in ClickHouse are eventually applied, and you can control when they are executed using the `merge_with_ttl_timeout` setting. Learn how to force TTL application and manage background threads for TTL execution.", href: "/zh/resources/support-center/knowledge-base/data-management/when-is-ttl-applied", category: "Data management", tags: ["Core Data Concepts"] }, { id: "setup-installation/production", title: "Which ClickHouse version to use in production?", description: "This page provides guidance on which ClickHouse version to use in production", href: "/zh/resources/support-center/knowledge-base/setup-installation/production", category: "Setup & installation", tags: [] }, { id: "general-faqs/who-is-using-clickhouse", title: "Who is using ClickHouse?", description: "Describes who is using ClickHouse", href: "/zh/resources/support-center/knowledge-base/general-faqs/who-is-using-clickhouse", category: "General & FAQs", tags: [] }, { id: "data-management/dictionaries-consistent-state", title: "Why can't I see my data in a dictionary in ClickHouse Cloud?", description: "There is an issue where data in dictionaries may not be visible immediately after creation.", href: "/zh/resources/support-center/knowledge-base/data-management/dictionaries-consistent-state", category: "Data management", tags: ["Managing Cloud", "Data Modelling"] }, { id: "general-faqs/why-recommend-clickhouse-keeper-over-zookeeper", title: "Why is ClickHouse Keeper recommended over ZooKeeper?", description: "ClickHouse Keeper improves upon ZooKeeper with features like reduced disk space usage, faster recovery, and less memory consumption, offering better performance for ClickHouse clusters.", href: "/zh/resources/support-center/knowledge-base/general-faqs/why-recommend-clickhouse-keeper-over-zookeeper", category: "General & FAQs", tags: ["Core Data Concepts"] }, { id: "monitoring-debugging/why-default-logging-verbose", title: "Why is ClickHouse logging so verbose by default?", description: "Learn why the ClickHouse developers chose to set a verbose logging level by default.", href: "/zh/resources/support-center/knowledge-base/monitoring-debugging/why-default-logging-verbose", category: "Monitoring & debugging", tags: ["Settings"] }, { id: "performance-optimization/why-is-my-primary-key-not-used", title: "Why is my primary key not used? How can I check?", description: "Covers a common reason why a primary key is not used in ordering and how we can confirm", href: "/zh/resources/support-center/knowledge-base/performance-optimization/why-is-my-primary-key-not-used", category: "Performance & optimization", tags: ["Performance and Optimizations"] }, { id: "general-faqs/mapreduce", title: "Why not use something like MapReduce?", description: "This page explains why you would use ClickHouse over MapReduce", href: "/zh/resources/support-center/knowledge-base/general-faqs/mapreduce", category: "General & FAQs", tags: [] }] }; export const KBExplorer = ({index, featured = []}) => { const featuredIds = featured.map(f => f.id); const assetBase = typeof window !== "undefined" && window.location.pathname.startsWith("/docs") ? "/docs" : ""; const withBase = p => p && p.startsWith("/") ? assetBase + p : p; const data = index || ({ categories: [], tags: [], articles: [] }); const readStoredList = (key, fallback) => { if (typeof window === "undefined") return fallback; try { const raw = localStorage.getItem(key); if (!raw) return fallback; const parsed = JSON.parse(raw); return Array.isArray(parsed) ? parsed : fallback; } catch { return fallback; } }; const [searchTerm, setSearchTerm] = useState(() => { if (typeof window !== "undefined") { return localStorage.getItem("kb-search") || ""; } return ""; }); const [selectedCategories, setSelectedCategories] = useState(() => readStoredList("kb-categories", ["All"])); const [currentPage, setCurrentPage] = useState(1); const itemsPerPage = 6; const [categoriesDropdownOpen, setCategoriesDropdownOpen] = useState(true); const [showFilters, setShowFilters] = useState(() => { if (typeof window !== "undefined") { return localStorage.getItem("kb-show-filters") !== "false"; } return true; }); 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(() => { if (typeof window !== "undefined") localStorage.setItem("kb-search", searchTerm); }, [searchTerm]); useEffect(() => { if (typeof window !== "undefined") localStorage.setItem("kb-categories", JSON.stringify(selectedCategories)); }, [selectedCategories]); useEffect(() => { if (typeof window !== "undefined") localStorage.setItem("kb-show-filters", String(showFilters)); }, [showFilters]); useEffect(() => { setCurrentPage(1); }, [searchTerm, selectedCategories]); const makeToggle = setter => value => { setter(prev => { if (value === "All") return ["All"]; const withoutAll = prev.filter(v => v !== "All"); const result = withoutAll.includes(value) ? withoutAll.filter(v => v !== value) : [...withoutAll, value]; return result.length === 0 ? ["All"] : result; }); }; const toggleCategory = makeToggle(setSelectedCategories); const categoryOptions = ["All", ...data.categories]; const resetFilters = () => { setSearchTerm(""); setSelectedCategories(["All"]); }; const hasActiveFilters = searchTerm !== "" || !selectedCategories.includes("All"); const filteredArticles = useMemo(() => { const term = searchTerm.toLowerCase(); return data.articles.filter(article => { if (featuredIds.includes(article.id)) return false; const matchesSearch = term === "" || article.title.toLowerCase().includes(term) || (article.description || "").toLowerCase().includes(term) || (article.tags || []).some(t => t.toLowerCase().includes(term)); const matchesCategory = selectedCategories.includes("All") || selectedCategories.includes(article.category); return matchesSearch && matchesCategory; }); }, [data.articles, searchTerm, selectedCategories, 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 featuredArticles = featured.map(f => { const article = data.articles.find(a => a.id === f.id); return { id: f.id, href: article && article.href || `/zh/resources/support-center/knowledge-base/${f.id}`, title: article && article.title || "" }; }).filter(f => f.title); const Expandable = ({label, options, selectedOptions, onToggle, isOpen, setIsOpen}) => { const activeCount = selectedOptions.filter(o => o !== "All").length; const displayLabel = activeCount > 0 ? `${label} (${activeCount})` : label; return
{isOpen &&
{options.map(option => )}
}
; }; return <>
{} {featuredArticles.length > 0 &&

精选文章

{featuredArticles.map(article => handleCardClick(e, article.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"> {}
{article.title}
热门
)}
} {}
{}
{}
{}

浏览文章

{filteredArticles.length > 0 ? <> {} {(() => { const totalPages = Math.ceil(filteredArticles.length / itemsPerPage); if (totalPages <= 1) return null; const hasPrev = currentPage > 1; const hasNext = currentPage < totalPages; return
第 {currentPage} 页，共 {totalPages} 页
; })()} :

未找到符合条件的文章。

请尝试调整筛选条件或搜索词。

}
; }; export const featuredArticles = [{ id: 'cloud-services/aws-privatelink-setup-for-clickpipes' }, { id: 'tables-schema/schema-migration-tools' }, { id: 'data-management/read-consistency' }];
装饰性背景图。 装饰性背景图。