From 8f576913bba2ccbc2ca084e6015e14860f3e948b Mon Sep 17 00:00:00 2001 From: Dominic Tran Date: Tue, 26 Aug 2025 17:01:59 -0500 Subject: [PATCH 1/6] diaxis categorization using anthropic to categorize by content. --- .../api/_invitations-api-reference.md | 1 + docs/_placeholders/api/_keys-api-reference.md | 1 + .../api/_members-api-reference.md | 1 + .../api/_organizations-api-reference.md | 1 + .../api/_services-api-reference.md | 1 + docs/_placeholders/changelog/_index.md | 1 + docs/_snippets/_tabs.md | 1 + docs/about-us/about-faq-index.md | 1 + docs/about-us/adopters.md | 1 + .../beta-and-experimental-features.md | 115 ++++++ docs/about-us/cloud.md | 1 + docs/about-us/distinctive-features.md | 1 + docs/about-us/history.md | 1 + docs/about-us/index.md | 1 + docs/about-us/support.md | 1 + docs/best-practices/avoid_mutations.md | 1 + docs/best-practices/avoid_optimize_final.md | 1 + docs/best-practices/choosing_a_primary_key.md | 1 + docs/best-practices/index.md | 1 + docs/best-practices/json_type.md | 1 + .../best-practices/minimize_optimize_joins.md | 1 + docs/best-practices/select_data_type.md | 1 + .../selecting_an_insert_strategy.md | 1 + .../sizing-and-hardware-recommendations.md | 1 + docs/best-practices/use_materialized_views.md | 1 + .../using_data_skipping_indices.md | 1 + docs/chdb/getting-started.md | 1 + docs/chdb/guides/clickhouse-local.md | 1 + docs/chdb/guides/index.md | 10 + docs/chdb/guides/jupysql.md | 1 + docs/chdb/guides/query-remote-clickhouse.md | 1 + docs/chdb/guides/querying-apache-arrow.md | 1 + docs/chdb/guides/querying-pandas.md | 1 + docs/chdb/guides/querying-parquet.md | 1 + docs/chdb/guides/querying-s3-bucket.md | 1 + docs/chdb/index.md | 1 + docs/chdb/install/bun.md | 1 + docs/chdb/install/c.md | 1 + docs/chdb/install/go.md | 1 + docs/chdb/install/index.md | 1 + docs/chdb/install/nodejs.md | 1 + docs/chdb/install/python.md | 1 + docs/chdb/install/rust.md | 1 + docs/chdb/reference/data-formats.md | 1 + docs/chdb/reference/index.md | 1 + docs/chdb/reference/sql-reference.md | 1 + docs/cloud-index.md | 1 + docs/cloud/bestpractices/index.md | 1 + docs/cloud/bestpractices/multitenancy.md | 1 + docs/cloud/bestpractices/usagelimits.md | 1 + docs/cloud/changelogs/24_02.md | 1 + docs/cloud/changelogs/24_05.md | 1 + docs/cloud/changelogs/24_06.md | 1 + docs/cloud/changelogs/24_08.md | 1 + docs/cloud/changelogs/24_10.md | 1 + docs/cloud/changelogs/24_12.md | 1 + docs/cloud/changelogs/25_04.md | 1 + docs/cloud/changelogs/25_06.md | 1 + docs/cloud/get-started/index.md | 1 + docs/cloud/get-started/query-endpoints.md | 1 + docs/cloud/get-started/query-insights.md | 1 + docs/cloud/get-started/sql-console.md | 1 + docs/cloud/manage/account-close.md | 1 + docs/cloud/manage/api/api-overview.md | 1 + docs/cloud/manage/api/index.md | 1 + .../manage/backups/configurable-backups.md | 1 + .../export-backups-to-own-cloud-account.md | 1 + docs/cloud/manage/backups/index.md | 1 + docs/cloud/manage/backups/overview.md | 1 + docs/cloud/manage/billing.md | 1 + docs/cloud/manage/billing/index.md | 1 + .../marketplace/aws-marketplace-committed.md | 1 + .../marketplace/aws-marketplace-payg.md | 1 + .../azure-marketplace-committed.md | 1 + .../marketplace/azure-marketplace-payg.md | 1 + .../marketplace/gcp-marketplace-committed.md | 1 + .../marketplace/gcp-marketplace-payg.md | 1 + .../cloud/manage/billing/marketplace/index.md | 1 + .../migrate-marketplace-payg-committed.md | 1 + .../manage/billing/marketplace/overview.md | 1 + .../manage/billing/payment-thresholds.md | 1 + docs/cloud/manage/cloud-tiers.md | 1 + docs/cloud/manage/dashboards.md | 1 + docs/cloud/manage/hyperdx.md | 1 + docs/cloud/manage/index.md | 1 + docs/cloud/manage/integrations.md | 1 + docs/cloud/manage/jan2025_faq/backup.md | 1 + docs/cloud/manage/jan2025_faq/billing.md | 1 + docs/cloud/manage/jan2025_faq/dimensions.md | 1 + docs/cloud/manage/jan2025_faq/index.md | 11 + docs/cloud/manage/jan2025_faq/new_tiers.md | 1 + .../manage/jan2025_faq/plan_migrations.md | 1 + docs/cloud/manage/jan2025_faq/scaling.md | 1 + docs/cloud/manage/jan2025_faq/summary.md | 1 + .../manage/monitoring/advanced_dashboard.md | 1 + docs/cloud/manage/monitoring/prometheus.md | 1 + docs/cloud/manage/notifications.md | 1 + docs/cloud/manage/openapi.md | 1 + docs/cloud/manage/postman.md | 1 + docs/cloud/manage/replica-aware-routing.md | 1 + docs/cloud/manage/scaling.md | 1 + docs/cloud/manage/service-uptime.md | 1 + docs/cloud/manage/settings.md | 1 + .../manage/troubleshooting-billing-issues.md | 1 + docs/cloud/manage/upgrades.md | 1 + docs/cloud/migrate/upload-a-csv-file.md | 1 + docs/cloud/reference/architecture.md | 1 + docs/cloud/reference/byoc.md | 1 + docs/cloud/reference/changelog.md | 1 + docs/cloud/reference/changelogs-index.md | 1 + docs/cloud/reference/cloud-compatibility.md | 1 + docs/cloud/reference/index.md | 1 + docs/cloud/reference/release-notes-index.md | 11 + docs/cloud/reference/shared-catalog.md | 1 + docs/cloud/reference/shared-merge-tree.md | 1 + docs/cloud/reference/supported-regions.md | 1 + docs/cloud/reference/warehouses.md | 1 + .../security/accessing-s3-data-securely.md | 1 + docs/cloud/security/audit-logging.md | 1 + docs/cloud/security/aws-privatelink.md | 1 + docs/cloud/security/azure-privatelink.md | 1 + .../cloud-access-management.md | 1 + .../cloud-authentication.md | 1 + .../security/cloud-access-management/index.md | 1 + docs/cloud/security/cloud-endpoints-api.md | 1 + docs/cloud/security/cmek.md | 1 + .../common-access-management-queries.md | 1 + docs/cloud/security/compliance-overview.md | 1 + docs/cloud/security/connectivity-overview.md | 1 + .../security/gcp-private-service-connect.md | 1 + docs/cloud/security/index.md | 1 + docs/cloud/security/inviting-new-users.md | 1 + docs/cloud/security/personal-data-access.md | 1 + .../security/privacy-compliance-overview.md | 1 + docs/cloud/security/private-link-overview.md | 1 + docs/cloud/security/saml-sso-setup.md | 1 + docs/cloud/security/setting-ip-filters.md | 1 + .../security/shared-responsibility-model.md | 1 + docs/cloud/support.md | 1 + docs/concepts/glossary.md | 1 + docs/concepts/index.md | 1 + docs/concepts/olap.md | 1 + .../compression-in-clickhouse.md | 1 + docs/data-compression/compression-modes.md | 1 + docs/data-modeling/backfilling.md | 1 + docs/data-modeling/denormalization.md | 1 + docs/data-modeling/index.md | 1 + .../projections/1_projections.md | 1 + ...2_materialized-views-versus-projections.md | 1 + docs/data-modeling/schema-design.md | 1 + docs/deployment-guides/index.md | 1 + .../01_1_shard_2_replicas.md | 1 + .../02_2_shards_1_replica.md | 1 + .../03_2_shards_2_replicas.md | 1 + docs/deployment-guides/terminology.md | 1 + docs/deployment-modes.md | 1 + docs/dictionary/index.md | 1 + docs/faq/general/columnar-database.md | 1 + docs/faq/general/dbms-naming.md | 1 + docs/faq/general/index.md | 1 + docs/faq/general/mapreduce.md | 1 + docs/faq/general/ne-tormozit.md | 1 + docs/faq/general/olap.md | 1 + docs/faq/general/who-is-using-clickhouse.md | 1 + docs/faq/index.md | 1 + docs/faq/integration/index.md | 1 + docs/faq/integration/json-import.md | 1 + docs/faq/integration/oracle-odbc.md | 1 + docs/faq/operations/delete-old-data.md | 1 + docs/faq/operations/index.md | 1 + .../operations/multi-region-replication.md | 1 + docs/faq/operations/production.md | 1 + docs/faq/operations/separate_storage.md | 1 + docs/faq/troubleshooting.md | 1 + docs/faq/use-cases/index.md | 1 + docs/faq/use-cases/key-value.md | 1 + docs/faq/use-cases/time-series.md | 1 + .../example-datasets/amazon-reviews.md | 1 + .../example-datasets/amplab-benchmark.md | 1 + .../example-datasets/brown-benchmark.md | 1 + .../example-datasets/cell-towers.md | 1 + .../example-datasets/covid19.md | 1 + .../example-datasets/criteo.md | 1 + .../example-datasets/dbpedia.md | 1 + .../example-datasets/environmental-sensors.md | 1 + .../example-datasets/foursquare-os-places.md | 1 + .../example-datasets/github-events.md | 1 + .../example-datasets/github.md | 1 + .../example-datasets/hacker-news.md | 1 + .../getting-started/example-datasets/laion.md | 1 + .../getting-started/example-datasets/menus.md | 1 + .../example-datasets/metrica.md | 1 + docs/getting-started/example-datasets/noaa.md | 1 + .../example-datasets/nyc-taxi.md | 1 + .../example-datasets/nypd_complaint_data.md | 1 + .../example-datasets/ontime.md | 1 + .../example-datasets/stackoverflow.md | 1 + .../example-datasets/star-schema.md | 1 + .../getting-started/example-datasets/tpcds.md | 1 + docs/getting-started/example-datasets/tpch.md | 1 + .../example-datasets/tw-weather.md | 1 + .../example-datasets/uk-price-paid.md | 1 + .../example-datasets/wikistat.md | 1 + .../example-datasets/youtube-dislikes.md | 1 + docs/getting-started/index.md | 30 ++ docs/getting-started/install/advanced.md | 1 + docs/getting-started/install/debian_ubuntu.md | 1 + docs/getting-started/install/docker.md | 1 + docs/getting-started/install/macos.md | 1 + docs/getting-started/install/other_linux.md | 1 + .../install/quick-install-curl.md | 1 + docs/getting-started/install/redhat.md | 1 + docs/getting-started/install/windows.md | 1 + docs/getting-started/playground.md | 1 + docs/guides/best-practices/asyncinserts.md | 1 + docs/guides/best-practices/avoidmutations.md | 1 + .../best-practices/avoidnullablecolumns.md | 1 + .../best-practices/avoidoptimizefinal.md | 1 + docs/guides/best-practices/bulkinserts.md | 1 + docs/guides/best-practices/index.md | 1 + docs/guides/best-practices/partitioningkey.md | 1 + docs/guides/best-practices/prewhere.md | 1 + .../best-practices/query-optimization.md | 1 + .../best-practices/query-parallelism.md | 1 + .../guides/best-practices/skipping-indexes.md | 1 + .../best-practices/sparse-primary-indexes.md | 1 + docs/guides/creating-tables.md | 1 + .../developer/alternative-query-languages.md | 1 + .../developer/cascading-materialized-views.md | 1 + .../developer/debugging-memory-issues.md | 1 + .../deduplicating-inserts-on-retries.md | 1 + docs/guides/developer/deduplication.md | 1 + .../developer/dynamic-column-selection.md | 1 + docs/guides/developer/index.md | 1 + docs/guides/developer/lightweight-delete.md | 1 + docs/guides/developer/merge-table-function.md | 1 + docs/guides/developer/mutations.md | 1 + docs/guides/developer/on-fly-mutations.md | 1 + docs/guides/developer/replacing-merge-tree.md | 1 + .../developer/time-series-filling-gaps.md | 1 + docs/guides/developer/ttl.md | 1 + ...nding-query-execution-with-the-analyzer.md | 1 + .../aggregate_function_combinators/anyIf.md | 1 + .../argMaxIf.md | 1 + .../argMinIf.md | 1 + .../aggregate_function_combinators/avgIf.md | 1 + .../aggregate_function_combinators/avgMap.md | 1 + .../avgMerge.md | 1 + .../avgMergeState.md | 1 + .../avgResample.md | 1 + .../avgState.md | 1 + .../aggregate_function_combinators/countIf.md | 1 + .../countResample.md | 1 + .../groupArrayDistinct.md | 1 + .../groupArrayResample.md | 1 + .../aggregate_function_combinators/maxMap.md | 1 + .../maxSimpleState.md | 1 + .../aggregate_function_combinators/minMap.md | 1 + .../minSimpleState.md | 1 + .../quantilesTimingArrayIf.md | 1 + .../quantilesTimingIf.md | 1 + .../sumArray.md | 1 + .../sumForEach.md | 1 + .../aggregate_function_combinators/sumIf.md | 1 + .../aggregate_function_combinators/sumMap.md | 1 + .../sumSimpleState.md | 1 + .../uniqArray.md | 1 + .../uniqArrayIf.md | 1 + docs/guides/inserting-data.md | 1 + docs/guides/joining-tables.md | 1 + docs/guides/manage-and-deploy-index.md | 1 + docs/guides/separation-storage-compute.md | 1 + docs/guides/sre/configuring-ssl.md | 1 + docs/guides/sre/index.md | 1 + docs/guides/sre/keeper/index.md | 1 + docs/guides/sre/network-ports.md | 1 + docs/guides/sre/scaling-clusters.md | 1 + .../sre/user-management/configuring-ldap.md | 1 + docs/guides/sre/user-management/index.md | 1 + .../sre/user-management/ssl-user-auth.md | 1 + docs/guides/troubleshooting.md | 1 + docs/guides/writing-queries.md | 1 + .../data-ingestion/apache-spark/index.md | 1 + .../data-ingestion/apache-spark/spark-jdbc.md | 1 + .../apache-spark/spark-native-connector.md | 1 + .../data-ingestion/aws-glue/index.md | 1 + .../azure-data-factory/index.md | 1 + .../azure-data-factory/overview.md | 1 + .../using_azureblobstorage.md | 1 + .../using_http_interface.md | 1 + .../data-ingestion/azure-synapse/index.md | 1 + .../clickpipes/aws-privatelink.md | 1 + .../data-ingestion/clickpipes/index.md | 1 + .../kafka/01_create-kafka-clickpipe.md | 1 + .../clickpipes/kafka/02_schema-registries.md | 1 + .../clickpipes/kafka/03_reference.md | 1 + .../clickpipes/kafka/04_best_practices.md | 1 + .../data-ingestion/clickpipes/kafka/05_faq.md | 1 + .../data-ingestion/clickpipes/kafka/index.md | 8 + .../data-ingestion/clickpipes/kinesis.md | 1 + .../clickpipes/mongodb/add_table.md | 1 + .../clickpipes/mongodb/controlling_sync.md | 1 + .../clickpipes/mongodb/datatypes.md | 1 + .../clickpipes/mongodb/index.md | 1 + .../clickpipes/mongodb/lifecycle.md | 1 + .../clickpipes/mongodb/pause_and_resume.md | 1 + .../clickpipes/mongodb/quickstart.md | 1 + .../clickpipes/mongodb/remove_table.md | 1 + .../clickpipes/mongodb/resync.md | 1 + .../clickpipes/mongodb/source/atlas.md | 1 + .../clickpipes/mongodb/source/generic.md | 1 + .../clickpipes/mysql/add_table.md | 1 + .../clickpipes/mysql/controlling_sync.md | 1 + .../clickpipes/mysql/datatypes.md | 1 + .../data-ingestion/clickpipes/mysql/faq.md | 1 + .../data-ingestion/clickpipes/mysql/index.md | 1 + .../clickpipes/mysql/lifecycle.md | 1 + .../clickpipes/mysql/parallel_initial_load.md | 1 + .../clickpipes/mysql/pause_and_resume.md | 1 + .../clickpipes/mysql/remove_table.md | 1 + .../data-ingestion/clickpipes/mysql/resync.md | 1 + .../clickpipes/mysql/schema-changes.md | 1 + .../clickpipes/mysql/source/aurora.md | 1 + .../clickpipes/mysql/source/gcp.md | 1 + .../clickpipes/mysql/source/generic.md | 1 + .../clickpipes/mysql/source/generic_maria.md | 1 + .../clickpipes/mysql/source/rds.md | 1 + .../clickpipes/mysql/source/rds_maria.md | 1 + .../clickpipes/object-storage.md | 1 + .../clickpipes/postgres/add_table.md | 1 + .../clickpipes/postgres/controlling_sync.md | 1 + .../clickpipes/postgres/deduplication.md | 1 + .../data-ingestion/clickpipes/postgres/faq.md | 1 + .../clickpipes/postgres/index.md | 1 + .../clickpipes/postgres/lifecycle.md | 1 + .../clickpipes/postgres/maintenance.md | 1 + .../clickpipes/postgres/ordering_keys.md | 1 + .../postgres/parallel_initial_load.md | 1 + .../clickpipes/postgres/pause_and_resume.md | 1 + .../postgres/postgres_generated_columns.md | 1 + .../clickpipes/postgres/remove_table.md | 1 + .../clickpipes/postgres/resync.md | 1 + .../clickpipes/postgres/scaling.md | 1 + .../clickpipes/postgres/schema-changes.md | 1 + .../clickpipes/postgres/source/aurora.md | 1 + .../source/azure-flexible-server-postgres.md | 1 + .../postgres/source/crunchy-postgres.md | 1 + .../clickpipes/postgres/source/generic.md | 1 + .../postgres/source/google-cloudsql.md | 1 + .../postgres/source/neon-postgres.md | 1 + .../clickpipes/postgres/source/planetscale.md | 1 + .../clickpipes/postgres/source/rds.md | 1 + .../clickpipes/postgres/source/supabase.md | 1 + .../clickpipes/postgres/source/timescale.md | 1 + .../clickpipes/postgres/table_resync.md | 1 + .../clickpipes/postgres/toast.md | 1 + .../clickpipes/secure-kinesis.md | 1 + .../data-ingestion/clickpipes/secure-rds.md | 1 + .../data-formats/arrow-avro-orc.md | 1 + .../data-ingestion/data-formats/binary.md | 1 + .../data-ingestion/data-formats/csv-tsv.md | 1 + .../data-ingestion/data-formats/intro.md | 1 + .../data-formats/json/exporting.md | 1 + .../data-formats/json/formats.md | 1 + .../data-formats/json/inference.md | 1 + .../data-ingestion/data-formats/json/intro.md | 1 + .../data-formats/json/loading.md | 1 + .../data-ingestion/data-formats/json/other.md | 1 + .../data-formats/json/schema.md | 1 + .../data-ingestion/data-formats/parquet.md | 1 + .../data-ingestion/data-formats/sql.md | 1 + .../data-formats/templates-regex.md | 1 + .../data-ingestion/data-ingestion-index.md | 1 + .../data-ingestion/data-sources-index.md | 1 + .../data-ingestion/dbms/dynamodb/index.md | 1 + .../dbms/jdbc-with-clickhouse.md | 1 + .../data-ingestion/dbms/mysql/index.md | 1 + .../dbms/odbc-with-clickhouse.md | 1 + .../postgresql/connecting-to-postgresql.md | 1 + .../dbms/postgresql/inserting-data.md | 1 + .../integrations/data-ingestion/emqx/index.md | 1 + .../etl-tools/airbyte-and-clickhouse.md | 1 + .../data-ingestion/etl-tools/apache-beam.md | 1 + .../etl-tools/bladepipe-and-clickhouse.md | 1 + .../data-ingestion/etl-tools/dbt/index.md | 1 + .../etl-tools/dlt-and-clickhouse.md | 1 + .../etl-tools/fivetran/index.md | 1 + .../etl-tools/nifi-and-clickhouse.md | 1 + .../etl-tools/vector-to-clickhouse.md | 1 + docs/integrations/data-ingestion/gcs/index.md | 1 + .../google-dataflow/dataflow.md | 1 + .../google-dataflow/java-runner.md | 1 + .../google-dataflow/templates.md | 1 + .../templates/bigquery-to-clickhouse.md | 1 + .../data-ingestion/insert-local-files.md | 1 + .../kafka/confluent/confluent-cloud.md | 1 + .../kafka/confluent/custom-connector.md | 1 + .../data-ingestion/kafka/confluent/index.md | 1 + .../kafka/confluent/kafka-connect-http.md | 1 + .../data-ingestion/kafka/index.md | 1 + .../kafka/kafka-clickhouse-connect-sink.md | 1 + .../kafka/kafka-connect-jdbc.md | 1 + .../kafka-table-engine-named-collections.md | 1 + .../kafka/kafka-table-engine.md | 1 + .../data-ingestion/kafka/kafka-vector.md | 1 + .../data-ingestion/kafka/msk/index.md | 1 + .../data-ingestion/redshift/index.md | 1 + docs/integrations/data-ingestion/s3-minio.md | 1 + docs/integrations/data-ingestion/s3/index.md | 1 + .../data-ingestion/s3/performance.md | 1 + docs/integrations/data-sources/cassandra.md | 1 + docs/integrations/data-sources/deltalake.md | 1 + docs/integrations/data-sources/hive.md | 1 + docs/integrations/data-sources/hudi.md | 1 + docs/integrations/data-sources/iceberg.md | 1 + docs/integrations/data-sources/mongodb.md | 1 + docs/integrations/data-sources/mysql.md | 1 + docs/integrations/data-sources/nats.md | 1 + docs/integrations/data-sources/postgres.md | 1 + docs/integrations/data-sources/rabbitmq.md | 1 + docs/integrations/data-sources/redis.md | 1 + docs/integrations/data-sources/rocksdb.md | 1 + docs/integrations/data-sources/sqlite.md | 1 + .../astrato-and-clickhouse.md | 1 + .../chartbrew-and-clickhouse.md | 1 + .../data-visualization/deepnote.md | 1 + .../draxlr-and-clickhouse.md | 1 + .../embeddable-and-clickhouse.md | 1 + .../explo-and-clickhouse.md | 1 + .../data-visualization/fabi-and-clickhouse.md | 1 + .../data-visualization/grafana/config.md | 1 + .../data-visualization/grafana/index.md | 1 + .../grafana/query-builder.md | 1 + .../hashboard-and-clickhouse.md | 1 + docs/integrations/data-visualization/index.md | 1 + .../looker-and-clickhouse.md | 1 + .../looker-studio-and-clickhouse.md | 1 + .../luzmo-and-clickhouse.md | 1 + .../metabase-and-clickhouse.md | 1 + .../mitzu-and-clickhouse.md | 1 + .../data-visualization/omni-and-clickhouse.md | 1 + .../powerbi-and-clickhouse.md | 1 + .../quicksight-and-clickhouse.md | 1 + .../rocketbi-and-clickhouse.md | 1 + .../splunk-and-clickhouse.md | 1 + .../superset-and-clickhouse.md | 1 + .../tableau/tableau-analysis-tips.md | 1 + .../tableau/tableau-and-clickhouse.md | 1 + .../tableau/tableau-connection-tips.md | 1 + .../tableau/tableau-online-and-clickhouse.md | 1 + .../zingdata-and-clickhouse.md | 1 + docs/integrations/language-clients/csharp.md | 1 + .../integrations/language-clients/go/index.md | 1 + docs/integrations/language-clients/index.md | 1 + .../language-clients/java/index.md | 1 + .../language-clients/java/r2dbc.md | 1 + docs/integrations/language-clients/js.md | 1 + .../language-clients/moose-olap.md | 1 + .../language-clients/python/index.md | 1 + docs/integrations/language-clients/rust.md | 1 + .../migration/clickhouse-local-etl.md | 1 + .../migration/clickhouse-to-cloud.md | 1 + .../migration/etl-tool-to-clickhouse.md | 1 + docs/integrations/migration/index.md | 1 + .../migration/object-storage-to-clickhouse.md | 1 + docs/integrations/migration/overview.md | 1 + docs/integrations/misc/index.md | 1 + docs/integrations/sql-clients/datagrip.md | 1 + docs/integrations/sql-clients/dbeaver.md | 1 + docs/integrations/sql-clients/dbvisualizer.md | 1 + docs/integrations/sql-clients/index.md | 1 + docs/integrations/sql-clients/jupysql.md | 1 + docs/integrations/sql-clients/marimo.md | 1 + docs/integrations/sql-clients/qstudio.md | 1 + docs/integrations/sql-clients/sql-console.md | 1 + docs/integrations/sql-clients/tablum.md | 1 + .../tools/data-integration/easypanel/index.md | 1 + .../tools/data-integration/index.md | 1 + .../tools/data-integration/retool/index.md | 1 + .../tools/data-integration/splunk/index.md | 1 + docs/integrations/tools/index.md | 1 + docs/intro.md | 1 + docs/introduction-index.md | 1 + docs/managing-data/core-concepts/index.md | 1 + docs/managing-data/deleting-data/index.md | 1 + docs/managing-data/truncate.md | 1 + docs/managing-data/updating-data/index.md | 1 + .../incremental-materialized-view.md | 1 + docs/materialized-view/index.md | 1 + .../refreshable-materialized-view.md | 1 + .../bigquery/equivalent-concepts.md | 1 + docs/migrations/bigquery/index.md | 1 + docs/migrations/bigquery/loading-data.md | 1 + .../bigquery/migrating-to-clickhouse-cloud.md | 1 + docs/migrations/index.md | 1 + docs/migrations/postgres/appendix.md | 1 + .../postgres/data-modeling-techniques.md | 1 + docs/migrations/postgres/dataset.md | 1 + docs/migrations/postgres/index.md | 1 + docs/migrations/postgres/overview.md | 1 + docs/migrations/postgres/rewriting-queries.md | 1 + docs/migrations/snowflake.md | 1 + docs/native-protocol/basics.md | 1 + docs/native-protocol/client.md | 1 + docs/native-protocol/columns.md | 1 + docs/native-protocol/hash.md | 1 + docs/native-protocol/server.md | 1 + docs/starter-guides/index.md | 1 + .../static-files-disk-uploader.md | 1 + docs/tutorial.md | 1 + docs/use-cases/AI_ML/MCP/01_remote_mcp.md | 1 + docs/use-cases/AI_ML/MCP/02_claude-desktop.md | 1 + docs/use-cases/AI_ML/MCP/03_librechat.md | 1 + docs/use-cases/AI_ML/MCP/04_anythingllm.md | 1 + docs/use-cases/AI_ML/MCP/05_open-webui.md | 1 + docs/use-cases/AI_ML/MCP/06_ollama.md | 1 + docs/use-cases/AI_ML/MCP/07_janai.md | 1 + .../AI_ML/MCP/ai_agent_libraries/agno.md | 1 + .../AI_ML/MCP/ai_agent_libraries/chainlit.md | 1 + .../MCP/ai_agent_libraries/copilotkit.md | 1 + .../AI_ML/MCP/ai_agent_libraries/dspy.md | 1 + .../AI_ML/MCP/ai_agent_libraries/index.md | 1 + .../AI_ML/MCP/ai_agent_libraries/langchain.md | 1 + .../MCP/ai_agent_libraries/llamaindex.md | 1 + .../MCP/ai_agent_libraries/openai-agents.md | 1 + .../MCP/ai_agent_libraries/pydantic-ai.md | 1 + .../AI_ML/MCP/ai_agent_libraries/slackbot.md | 1 + .../AI_ML/MCP/ai_agent_libraries/streamlit.md | 1 + docs/use-cases/AI_ML/MCP/index.md | 2 + .../AI_ML/ai-powered-sql-generation.md | 1 + docs/use-cases/AI_ML/index.md | 1 + docs/use-cases/data_lake/glue_catalog.md | 1 + docs/use-cases/data_lake/index.md | 1 + .../use-cases/data_lake/lakekeeper_catalog.md | 1 + docs/use-cases/data_lake/nessie_catalog.md | 1 + docs/use-cases/data_lake/rest_catalog.md | 1 + docs/use-cases/data_lake/unity_catalog.md | 1 + docs/use-cases/index.md | 1 + .../build-your-own/demo-application.md | 1 + .../observability/build-your-own/grafana.md | 1 + .../observability/build-your-own/index.md | 1 + .../integrating-opentelemetry.md | 1 + .../build-your-own/introduction.md | 1 + .../build-your-own/managing-data.md | 1 + .../build-your-own/schema-design.md | 1 + .../observability/clickstack/alerts.md | 1 + .../observability/clickstack/architecture.md | 1 + .../observability/clickstack/config.md | 1 + .../observability/clickstack/dashboards.md | 1 + .../clickstack/deployment/all-in-one.md | 1 + .../clickstack/deployment/docker-compose.md | 1 + .../clickstack/deployment/helm.md | 1 + .../deployment/hyperdx-clickhouse-cloud.md | 1 + .../clickstack/deployment/hyperdx-only.md | 1 + .../clickstack/deployment/index.md | 1 + .../clickstack/deployment/local-mode-only.md | 1 + .../clickstack/example-datasets/index.md | 1 + .../clickstack/example-datasets/kubernetes.md | 1 + .../clickstack/example-datasets/local-data.md | 1 + .../example-datasets/remote-demo-data.md | 1 + .../example-datasets/sample-data.md | 1 + .../clickstack/getting-started.md | 1 + .../observability/clickstack/index.md | 1 + .../clickstack/ingesting-data/collector.md | 1 + .../clickstack/ingesting-data/index.md | 1 + .../clickstack/ingesting-data/kubernetes.md | 1 + .../ingesting-data/opentelemetry.md | 1 + .../clickstack/ingesting-data/overview.md | 1 + .../clickstack/ingesting-data/schemas.md | 1 + .../ingesting-data/sdks/aws-lambda.md | 1 + .../clickstack/ingesting-data/sdks/browser.md | 1 + .../clickstack/ingesting-data/sdks/deno.md | 1 + .../clickstack/ingesting-data/sdks/elixir.md | 1 + .../clickstack/ingesting-data/sdks/golang.md | 1 + .../clickstack/ingesting-data/sdks/index.md | 1 + .../clickstack/ingesting-data/sdks/java.md | 1 + .../clickstack/ingesting-data/sdks/nestjs.md | 1 + .../clickstack/ingesting-data/sdks/nextjs.md | 1 + .../clickstack/ingesting-data/sdks/nodejs.md | 1 + .../clickstack/ingesting-data/sdks/python.md | 1 + .../ingesting-data/sdks/react-native.md | 1 + .../clickstack/ingesting-data/sdks/ruby.md | 1 + .../clickstack/migration/elastic/concepts.md | 1 + .../clickstack/migration/elastic/index.md | 1 + .../clickstack/migration/elastic/intro.md | 1 + .../migration/elastic/migrating-agents.md | 1 + .../migration/elastic/migrating-data.md | 1 + .../migration/elastic/migrating-sdks.md | 1 + .../clickstack/migration/elastic/search.md | 1 + .../clickstack/migration/elastic/types.md | 1 + .../clickstack/migration/index.md | 1 + .../observability/clickstack/overview.md | 1 + .../observability/clickstack/production.md | 1 + .../observability/clickstack/search.md | 1 + .../use-cases/observability/clickstack/ttl.md | 1 + docs/use-cases/observability/index.md | 1 + .../time-series/analysis-functions.md | 1 + .../use-cases/time-series/basic-operations.md | 1 + .../time-series/date-time-data-types.md | 1 + docs/use-cases/time-series/index.md | 1 + .../time-series/query-performance.md | 1 + .../time-series/storage-efficiency.md | 1 + docs/whats-new/changelog/2017.md | 1 + docs/whats-new/changelog/2018.md | 1 + docs/whats-new/changelog/2019.md | 1 + docs/whats-new/changelog/2020.md | 1 + docs/whats-new/changelog/2021.md | 1 + docs/whats-new/changelog/2022.md | 1 + docs/whats-new/changelog/2023.md | 1 + docs/whats-new/changelog/2024.md | 1 + docs/whats-new/changelog/cloud.md | 1 + docs/whats-new/changelog/index.md | 117 +++--- docs/whats-new/roadmap.md | 1 + docs/whats-new/security-changelog.md | 1 + scripts/categorizer.py | 333 ++++++++++++++++++ 615 files changed, 1182 insertions(+), 61 deletions(-) create mode 100644 scripts/categorizer.py diff --git a/docs/_placeholders/api/_invitations-api-reference.md b/docs/_placeholders/api/_invitations-api-reference.md index cd669fd09d2..16dfccfb71d 100644 --- a/docs/_placeholders/api/_invitations-api-reference.md +++ b/docs/_placeholders/api/_invitations-api-reference.md @@ -1,6 +1,7 @@ --- sidebar_label: Invitations title: Invitations +doc_type: 'reference' --- ## List all invitations {#list-all-invitations} diff --git a/docs/_placeholders/api/_keys-api-reference.md b/docs/_placeholders/api/_keys-api-reference.md index 4d946f3d80d..302df99a633 100644 --- a/docs/_placeholders/api/_keys-api-reference.md +++ b/docs/_placeholders/api/_keys-api-reference.md @@ -1,6 +1,7 @@ --- sidebar_label: Keys title: Keys +doc_type: 'reference' --- ## Get list of all keys {#get-list-of-all-keys} diff --git a/docs/_placeholders/api/_members-api-reference.md b/docs/_placeholders/api/_members-api-reference.md index 01970e1589b..64daa985bab 100644 --- a/docs/_placeholders/api/_members-api-reference.md +++ b/docs/_placeholders/api/_members-api-reference.md @@ -1,6 +1,7 @@ --- sidebar_label: Members title: Members +doc_type: 'reference' --- ## List organization members {#list-organization-members} diff --git a/docs/_placeholders/api/_organizations-api-reference.md b/docs/_placeholders/api/_organizations-api-reference.md index 1c4fab9b6db..cec4e83cdfd 100644 --- a/docs/_placeholders/api/_organizations-api-reference.md +++ b/docs/_placeholders/api/_organizations-api-reference.md @@ -1,6 +1,7 @@ --- sidebar_label: Organizations title: Organizations +doc_type: 'reference' --- ## Get organization details {#get-organization-details} diff --git a/docs/_placeholders/api/_services-api-reference.md b/docs/_placeholders/api/_services-api-reference.md index 51405b7a4c9..bd1b6208cf5 100644 --- a/docs/_placeholders/api/_services-api-reference.md +++ b/docs/_placeholders/api/_services-api-reference.md @@ -1,6 +1,7 @@ --- sidebar_label: Services title: Services +doc_type: 'reference' --- ## List of organization services {#list-of-organization-services} diff --git a/docs/_placeholders/changelog/_index.md b/docs/_placeholders/changelog/_index.md index 4a14fcb7dbf..d35ed65fcdc 100644 --- a/docs/_placeholders/changelog/_index.md +++ b/docs/_placeholders/changelog/_index.md @@ -5,5 +5,6 @@ slug: /whats-new/changelog/ sidebar_position: 2 sidebar_label: '2025' title: '2025 Changelog' +doc_type: 'reference' --- diff --git a/docs/_snippets/_tabs.md b/docs/_snippets/_tabs.md index bf6f077ed53..e9b87d3af41 100644 --- a/docs/_snippets/_tabs.md +++ b/docs/_snippets/_tabs.md @@ -1,5 +1,6 @@ --- sidebar_label: Tabs Sample +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/about-us/about-faq-index.md b/docs/about-us/about-faq-index.md index a517d39a919..48bbaf29c13 100644 --- a/docs/about-us/about-faq-index.md +++ b/docs/about-us/about-faq-index.md @@ -2,6 +2,7 @@ title: 'FAQ' slug: /about-us/faq description: 'Landing page' +doc_type: 'reference' --- | FAQ | diff --git a/docs/about-us/adopters.md b/docs/about-us/adopters.md index 99b5fa4f4a2..4253592a4ba 100644 --- a/docs/about-us/adopters.md +++ b/docs/about-us/adopters.md @@ -4,6 +4,7 @@ sidebar_label: 'Adopters' title: 'ClickHouse Adopters' sidebar_position: 60 description: 'A list of companies using ClickHouse and their success stories' +doc_type: 'reference' --- The following list of companies using ClickHouse and their success stories is assembled from public sources, thus might differ from current reality. We'd appreciate it if you share the story of adopting ClickHouse in your company and [add it to the list](https://github.com/ClickHouse/clickhouse-docs/blob/main/docs/about-us/adopters.md), but please make sure you won't have any NDA issues by doing so. Providing updates with publications from other companies is also useful. diff --git a/docs/about-us/beta-and-experimental-features.md b/docs/about-us/beta-and-experimental-features.md index a38c8d9ab5b..f41dfea15b9 100644 --- a/docs/about-us/beta-and-experimental-features.md +++ b/docs/about-us/beta-and-experimental-features.md @@ -4,6 +4,7 @@ sidebar_label: 'Beta Features and Experimental' title: 'Beta and Experimental Features' description: 'ClickHouse has beta and experimental features. This documentation page discusses definition.' slug: /beta-and-experimental-features +doc_type: 'reference' --- Because ClickHouse is open-source, it receives many contributions not only from ClickHouse employees but also from the community. These contributions are often developed at different speeds; certain features may require a lengthy prototyping phase or more time for sufficient community feedback and iteration to be considered generally available (GA). @@ -44,4 +45,118 @@ Please note: no additional experimental features are allowed to be enabled in Cl --> +## Beta settings {#beta-settings} + +| Name | Default | +|------|--------| +| [geotoh3_argument_order](/operations/settings/settings#geotoh3_argument_order) | `lat_lon` | +| [enable_lightweight_update](/operations/settings/settings#enable_lightweight_update) | `1` | +| [allow_experimental_correlated_subqueries](/operations/settings/settings#allow_experimental_correlated_subqueries) | `1` | +| [allow_experimental_parallel_reading_from_replicas](/operations/settings/settings#allow_experimental_parallel_reading_from_replicas) | `0` | +| [parallel_replicas_mode](/operations/settings/settings#parallel_replicas_mode) | `read_tasks` | +| [parallel_replicas_count](/operations/settings/settings#parallel_replicas_count) | `0` | +| [parallel_replica_offset](/operations/settings/settings#parallel_replica_offset) | `0` | +| [parallel_replicas_custom_key](/operations/settings/settings#parallel_replicas_custom_key) | `` | +| [parallel_replicas_custom_key_range_lower](/operations/settings/settings#parallel_replicas_custom_key_range_lower) | `0` | +| [parallel_replicas_custom_key_range_upper](/operations/settings/settings#parallel_replicas_custom_key_range_upper) | `0` | +| [cluster_for_parallel_replicas](/operations/settings/settings#cluster_for_parallel_replicas) | `` | +| [parallel_replicas_allow_in_with_subquery](/operations/settings/settings#parallel_replicas_allow_in_with_subquery) | `1` | +| [parallel_replicas_for_non_replicated_merge_tree](/operations/settings/settings#parallel_replicas_for_non_replicated_merge_tree) | `0` | +| [parallel_replicas_min_number_of_rows_per_replica](/operations/settings/settings#parallel_replicas_min_number_of_rows_per_replica) | `0` | +| [parallel_replicas_prefer_local_join](/operations/settings/settings#parallel_replicas_prefer_local_join) | `1` | +| [parallel_replicas_mark_segment_size](/operations/settings/settings#parallel_replicas_mark_segment_size) | `0` | +| [parallel_replicas_local_plan](/operations/settings/settings#parallel_replicas_local_plan) | `1` | +| [parallel_replicas_index_analysis_only_on_coordinator](/operations/settings/settings#parallel_replicas_index_analysis_only_on_coordinator) | `1` | +| [parallel_replicas_support_projection](/operations/settings/settings#parallel_replicas_support_projection) | `1` | +| [parallel_replicas_only_with_analyzer](/operations/settings/settings#parallel_replicas_only_with_analyzer) | `1` | +| [parallel_replicas_insert_select_local_pipeline](/operations/settings/settings#parallel_replicas_insert_select_local_pipeline) | `1` | +| [parallel_replicas_connect_timeout_ms](/operations/settings/settings#parallel_replicas_connect_timeout_ms) | `300` | +| [allow_experimental_database_iceberg](/operations/settings/settings#allow_experimental_database_iceberg) | `0` | +| [allow_experimental_database_unity_catalog](/operations/settings/settings#allow_experimental_database_unity_catalog) | `0` | +| [allow_experimental_database_glue_catalog](/operations/settings/settings#allow_experimental_database_glue_catalog) | `0` | +| [session_timezone](/operations/settings/settings#session_timezone) | `` | +| [low_priority_query_wait_time_ms](/operations/settings/settings#low_priority_query_wait_time_ms) | `1000` | +| [allow_experimental_delta_kernel_rs](/operations/settings/settings#allow_experimental_delta_kernel_rs) | `1` | + + +## Experimental settings {#experimental-settings} + +| Name | Default | +|------|--------| +| [allow_experimental_time_time64_type](/operations/settings/settings#allow_experimental_time_time64_type) | `0` | +| [allow_experimental_kafka_offsets_storage_in_keeper](/operations/settings/settings#allow_experimental_kafka_offsets_storage_in_keeper) | `0` | +| [allow_experimental_materialized_postgresql_table](/operations/settings/settings#allow_experimental_materialized_postgresql_table) | `0` | +| [allow_experimental_funnel_functions](/operations/settings/settings#allow_experimental_funnel_functions) | `0` | +| [allow_experimental_nlp_functions](/operations/settings/settings#allow_experimental_nlp_functions) | `0` | +| [allow_experimental_hash_functions](/operations/settings/settings#allow_experimental_hash_functions) | `0` | +| [allow_experimental_object_type](/operations/settings/settings#allow_experimental_object_type) | `0` | +| [allow_experimental_time_series_table](/operations/settings/settings#allow_experimental_time_series_table) | `0` | +| [allow_experimental_codecs](/operations/settings/settings#allow_experimental_codecs) | `0` | +| [throw_on_unsupported_query_inside_transaction](/operations/settings/settings#throw_on_unsupported_query_inside_transaction) | `1` | +| [wait_changes_become_visible_after_commit_mode](/operations/settings/settings#wait_changes_become_visible_after_commit_mode) | `wait_unknown` | +| [implicit_transaction](/operations/settings/settings#implicit_transaction) | `0` | +| [grace_hash_join_initial_buckets](/operations/settings/settings#grace_hash_join_initial_buckets) | `1` | +| [grace_hash_join_max_buckets](/operations/settings/settings#grace_hash_join_max_buckets) | `1024` | +| [join_to_sort_minimum_perkey_rows](/operations/settings/settings#join_to_sort_minimum_perkey_rows) | `40` | +| [join_to_sort_maximum_table_rows](/operations/settings/settings#join_to_sort_maximum_table_rows) | `10000` | +| [allow_experimental_join_right_table_sorting](/operations/settings/settings#allow_experimental_join_right_table_sorting) | `0` | +| [allow_statistics_optimize](/operations/settings/settings#allow_statistics_optimize) | `0` | +| [allow_experimental_statistics](/operations/settings/settings#allow_experimental_statistics) | `0` | +| [allow_experimental_full_text_index](/operations/settings/settings#allow_experimental_full_text_index) | `0` | +| [allow_experimental_live_view](/operations/settings/settings#allow_experimental_live_view) | `0` | +| [live_view_heartbeat_interval](/operations/settings/settings#live_view_heartbeat_interval) | `15` | +| [max_live_view_insert_blocks_before_refresh](/operations/settings/settings#max_live_view_insert_blocks_before_refresh) | `64` | +| [allow_experimental_window_view](/operations/settings/settings#allow_experimental_window_view) | `0` | +| [window_view_clean_interval](/operations/settings/settings#window_view_clean_interval) | `60` | +| [window_view_heartbeat_interval](/operations/settings/settings#window_view_heartbeat_interval) | `15` | +| [wait_for_window_view_fire_signal_timeout](/operations/settings/settings#wait_for_window_view_fire_signal_timeout) | `10` | +| [stop_refreshable_materialized_views_on_startup](/operations/settings/settings#stop_refreshable_materialized_views_on_startup) | `0` | +| [allow_experimental_database_materialized_postgresql](/operations/settings/settings#allow_experimental_database_materialized_postgresql) | `0` | +| [allow_experimental_query_deduplication](/operations/settings/settings#allow_experimental_query_deduplication) | `0` | +| [allow_experimental_database_hms_catalog](/operations/settings/settings#allow_experimental_database_hms_catalog) | `0` | +| [allow_experimental_kusto_dialect](/operations/settings/settings#allow_experimental_kusto_dialect) | `0` | +| [allow_experimental_prql_dialect](/operations/settings/settings#allow_experimental_prql_dialect) | `0` | +| [enable_adaptive_memory_spill_scheduler](/operations/settings/settings#enable_adaptive_memory_spill_scheduler) | `0` | +| [allow_experimental_insert_into_iceberg](/operations/settings/settings#allow_experimental_insert_into_iceberg) | `0` | +| [allow_experimental_iceberg_compaction](/operations/settings/settings#allow_experimental_iceberg_compaction) | `0` | +| [write_full_path_in_iceberg_metadata](/operations/settings/settings#write_full_path_in_iceberg_metadata) | `0` | +| [iceberg_metadata_compression_method](/operations/settings/settings#iceberg_metadata_compression_method) | `` | +| [make_distributed_plan](/operations/settings/settings#make_distributed_plan) | `0` | +| [distributed_plan_execute_locally](/operations/settings/settings#distributed_plan_execute_locally) | `0` | +| [distributed_plan_default_shuffle_join_bucket_count](/operations/settings/settings#distributed_plan_default_shuffle_join_bucket_count) | `8` | +| [distributed_plan_default_reader_bucket_count](/operations/settings/settings#distributed_plan_default_reader_bucket_count) | `8` | +| [distributed_plan_force_exchange_kind](/operations/settings/settings#distributed_plan_force_exchange_kind) | `` | +| [distributed_plan_max_rows_to_broadcast](/operations/settings/settings#distributed_plan_max_rows_to_broadcast) | `20000` | +| [allow_experimental_ytsaurus_table_engine](/operations/settings/settings#allow_experimental_ytsaurus_table_engine) | `0` | +| [allow_experimental_ytsaurus_table_function](/operations/settings/settings#allow_experimental_ytsaurus_table_function) | `0` | +| [allow_experimental_ytsaurus_dictionary_source](/operations/settings/settings#allow_experimental_ytsaurus_dictionary_source) | `0` | +| [distributed_plan_force_shuffle_aggregation](/operations/settings/settings#distributed_plan_force_shuffle_aggregation) | `0` | +| [allow_experimental_time_series_aggregate_functions](/operations/settings/settings#allow_experimental_time_series_aggregate_functions) | `0` | +| [promql_database](/operations/settings/settings#promql_database) | `` | +| [promql_table](/operations/settings/settings#promql_table) | `` | +| [evaluation_time](/operations/settings/settings#evaluation_time) | `auto` | +| [allow_experimental_replacing_merge_with_cleanup](/operations/settings/merge-tree-settings#allow_experimental_replacing_merge_with_cleanup) | `0` | +| [allow_experimental_reverse_key](/operations/settings/merge-tree-settings#allow_experimental_reverse_key) | `0` | +| [allow_remote_fs_zero_copy_replication](/operations/settings/merge-tree-settings#allow_remote_fs_zero_copy_replication) | `0` | +| [enable_replacing_merge_with_cleanup_for_min_age_to_force_merge](/operations/settings/merge-tree-settings#enable_replacing_merge_with_cleanup_for_min_age_to_force_merge) | `0` | +| [force_read_through_cache_for_merges](/operations/settings/merge-tree-settings#force_read_through_cache_for_merges) | `0` | +| [merge_selector_algorithm](/operations/settings/merge-tree-settings#merge_selector_algorithm) | `Simple` | +| [notify_newest_block_number](/operations/settings/merge-tree-settings#notify_newest_block_number) | `0` | +| [part_moves_between_shards_delay_seconds](/operations/settings/merge-tree-settings#part_moves_between_shards_delay_seconds) | `30` | +| [part_moves_between_shards_enable](/operations/settings/merge-tree-settings#part_moves_between_shards_enable) | `0` | +| [remote_fs_zero_copy_path_compatible_mode](/operations/settings/merge-tree-settings#remote_fs_zero_copy_path_compatible_mode) | `0` | +| [remote_fs_zero_copy_zookeeper_path](/operations/settings/merge-tree-settings#remote_fs_zero_copy_zookeeper_path) | `/clickhouse/zero_copy` | +| [remove_rolled_back_parts_immediately](/operations/settings/merge-tree-settings#remove_rolled_back_parts_immediately) | `1` | +| [shared_merge_tree_enable_coordinated_merges](/operations/settings/merge-tree-settings#shared_merge_tree_enable_coordinated_merges) | `0` | +| [shared_merge_tree_enable_keeper_parts_extra_data](/operations/settings/merge-tree-settings#shared_merge_tree_enable_keeper_parts_extra_data) | `0` | +| [shared_merge_tree_merge_coordinator_election_check_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_election_check_period_ms) | `30000` | +| [shared_merge_tree_merge_coordinator_factor](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_factor) | `2` | +| [shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms) | `10000` | +| [shared_merge_tree_merge_coordinator_max_merge_request_size](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_max_merge_request_size) | `20` | +| [shared_merge_tree_merge_coordinator_max_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_max_period_ms) | `10000` | +| [shared_merge_tree_merge_coordinator_merges_prepare_count](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_merges_prepare_count) | `100` | +| [shared_merge_tree_merge_coordinator_min_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_min_period_ms) | `1` | +| [shared_merge_tree_merge_worker_fast_timeout_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_worker_fast_timeout_ms) | `100` | +| [shared_merge_tree_merge_worker_regular_timeout_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_worker_regular_timeout_ms) | `10000` | +| [shared_merge_tree_virtual_parts_discovery_batch](/operations/settings/merge-tree-settings#shared_merge_tree_virtual_parts_discovery_batch) | `1` | diff --git a/docs/about-us/cloud.md b/docs/about-us/cloud.md index 4c641112492..d4c02e35e5b 100644 --- a/docs/about-us/cloud.md +++ b/docs/about-us/cloud.md @@ -4,6 +4,7 @@ sidebar_label: 'Cloud Service' sidebar_position: 10 description: 'ClickHouse Cloud' title: 'ClickHouse Cloud' +doc_type: 'reference' --- # ClickHouse Cloud diff --git a/docs/about-us/distinctive-features.md b/docs/about-us/distinctive-features.md index 1454498c3b5..97cafa00501 100644 --- a/docs/about-us/distinctive-features.md +++ b/docs/about-us/distinctive-features.md @@ -5,6 +5,7 @@ sidebar_position: 50 description: 'Understand what makes ClickHouse stand apart from other database management systems' title: 'Distinctive Features of ClickHouse' keywords: ['compression', 'secondary-indexes','column-oriented'] +doc_type: 'reference' --- # Distinctive features of ClickHouse diff --git a/docs/about-us/history.md b/docs/about-us/history.md index 83c015a9b59..b32f8db2bc6 100644 --- a/docs/about-us/history.md +++ b/docs/about-us/history.md @@ -5,6 +5,7 @@ sidebar_position: 40 description: 'History of ClickHouse development' keywords: ['history','development','Metrica'] title: 'ClickHouse History' +doc_type: 'explanation' --- # ClickHouse history {#clickhouse-history} diff --git a/docs/about-us/index.md b/docs/about-us/index.md index d61d835efd8..8ec4bf00b09 100644 --- a/docs/about-us/index.md +++ b/docs/about-us/index.md @@ -2,6 +2,7 @@ slug: /about title: 'About ClickHouse' description: 'Landing page for About ClickHouse' +doc_type: 'reference' --- # About ClickHouse diff --git a/docs/about-us/support.md b/docs/about-us/support.md index fb02f17832c..11198d3c22d 100644 --- a/docs/about-us/support.md +++ b/docs/about-us/support.md @@ -4,6 +4,7 @@ sidebar_label: 'Support' title: 'ClickHouse Cloud support services' sidebar_position: 30 description: 'Information on ClickHouse Cloud support services' +doc_type: 'reference' --- # ClickHouse Cloud support services diff --git a/docs/best-practices/avoid_mutations.md b/docs/best-practices/avoid_mutations.md index 8f1e942c6d7..47187e755ba 100644 --- a/docs/best-practices/avoid_mutations.md +++ b/docs/best-practices/avoid_mutations.md @@ -5,6 +5,7 @@ sidebar_label: 'Avoid mutations' title: 'Avoid mutations' description: 'Page describing why to avoid mutations in ClickHouse' keywords: ['mutations'] +doc_type: 'how-to' --- import Content from '@site/docs/best-practices/_snippets/_avoid_mutations.md'; diff --git a/docs/best-practices/avoid_optimize_final.md b/docs/best-practices/avoid_optimize_final.md index f016dd551df..f8fca2bcc82 100644 --- a/docs/best-practices/avoid_optimize_final.md +++ b/docs/best-practices/avoid_optimize_final.md @@ -6,6 +6,7 @@ title: 'Avoid OPTIMIZE FINAL' description: 'Page describing why you should avoid the OPTIMIZE FINAL clause in ClickHouse' keywords: ['avoid OPTIMIZE FINAL', 'background merges'] hide_title: true +doc_type: 'how-to' --- # Avoid `OPTIMIZE FINAL` diff --git a/docs/best-practices/choosing_a_primary_key.md b/docs/best-practices/choosing_a_primary_key.md index b1266749e2d..02afb1f563c 100644 --- a/docs/best-practices/choosing_a_primary_key.md +++ b/docs/best-practices/choosing_a_primary_key.md @@ -6,6 +6,7 @@ title: 'Choosing a Primary Key' description: 'Page describing how to choose a primary key in ClickHouse' keywords: ['primary key'] show_related_blogs: true +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/index.md b/docs/best-practices/index.md index 5a3ae78ab5f..dff0b680ca9 100644 --- a/docs/best-practices/index.md +++ b/docs/best-practices/index.md @@ -4,6 +4,7 @@ keywords: ['Cloud', 'Primary key', 'Ordering key', 'Materialized Views', 'Best P title: 'Overview' hide_title: true description: 'Landing page for Best Practices section in ClickHouse' +doc_type: 'reference' --- # Best Practices in ClickHouse {#best-practices-in-clickhouse} diff --git a/docs/best-practices/json_type.md b/docs/best-practices/json_type.md index 22fad8198fb..c5e4ede0757 100644 --- a/docs/best-practices/json_type.md +++ b/docs/best-practices/json_type.md @@ -6,6 +6,7 @@ title: 'Use JSON where appropriate' description: 'Page describing when to use JSON' keywords: ['JSON'] show_related_blogs: true +doc_type: 'reference' --- ClickHouse now offers a native JSON column type designed for semi-structured and dynamic data. It's important to clarify that **this is a column type, not a data format**—you can insert JSON into ClickHouse as a string or via supported formats like [JSONEachRow](/docs/interfaces/formats/JSONEachRow), but that does not imply using the JSON column type. Users should only use the JSON type when the structure of their data is dynamic, not when they simply happen to store JSON. diff --git a/docs/best-practices/minimize_optimize_joins.md b/docs/best-practices/minimize_optimize_joins.md index fd7018e1826..1e74e302689 100644 --- a/docs/best-practices/minimize_optimize_joins.md +++ b/docs/best-practices/minimize_optimize_joins.md @@ -6,6 +6,7 @@ title: 'Minimize and optimize JOINs' description: 'Page describing best practices for JOINs' keywords: ['JOIN', 'Parallel Hash JOIN'] show_related_blogs: true +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/select_data_type.md b/docs/best-practices/select_data_type.md index 2552f9008b5..42bfb343615 100644 --- a/docs/best-practices/select_data_type.md +++ b/docs/best-practices/select_data_type.md @@ -5,6 +5,7 @@ sidebar_label: 'Selecting data Types' title: 'Selecting data Types' description: 'Page describing how to choose data types in ClickHouse' keywords: ['data types'] +doc_type: 'reference' --- import NullableColumns from '@site/docs/best-practices/_snippets/_avoid_nullable_columns.md'; diff --git a/docs/best-practices/selecting_an_insert_strategy.md b/docs/best-practices/selecting_an_insert_strategy.md index c9442d20275..22d633e18b4 100644 --- a/docs/best-practices/selecting_an_insert_strategy.md +++ b/docs/best-practices/selecting_an_insert_strategy.md @@ -6,6 +6,7 @@ title: 'Selecting an insert strategy' description: 'Page describing how to choose an insert strategy in ClickHouse' keywords: ['INSERT', 'asynchronous inserts', 'compression', 'batch inserts'] show_related_blogs: true +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/sizing-and-hardware-recommendations.md b/docs/best-practices/sizing-and-hardware-recommendations.md index 037c0ac6398..99f70abcaaa 100644 --- a/docs/best-practices/sizing-and-hardware-recommendations.md +++ b/docs/best-practices/sizing-and-hardware-recommendations.md @@ -4,6 +4,7 @@ sidebar_label: 'Sizing and hardware recommendations' sidebar_position: 4 title: 'Sizing and hardware recommendations' description: 'This guide discusses our general recommendations regarding hardware, compute, memory, and disk configurations for open-source users.' +doc_type: 'reference' --- # Sizing and hardware recommendations diff --git a/docs/best-practices/use_materialized_views.md b/docs/best-practices/use_materialized_views.md index cc71d0a1cd9..ddb4562b532 100644 --- a/docs/best-practices/use_materialized_views.md +++ b/docs/best-practices/use_materialized_views.md @@ -6,6 +6,7 @@ title: 'Use Materialized Views' description: 'Page describing Materialized Views' keywords: ['materialized views', 'medallion architecture'] show_related_blogs: true +doc_type: 'explanation' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/using_data_skipping_indices.md b/docs/best-practices/using_data_skipping_indices.md index 53a9ef01949..94a7d07a3df 100644 --- a/docs/best-practices/using_data_skipping_indices.md +++ b/docs/best-practices/using_data_skipping_indices.md @@ -6,6 +6,7 @@ title: 'Use data skipping indices where appropriate' description: 'Page describing how and when to use data skipping indices' keywords: ['data skipping index', 'skip index'] show_related_blogs: true +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/chdb/getting-started.md b/docs/chdb/getting-started.md index 86e108c1037..4a2269acadb 100644 --- a/docs/chdb/getting-started.md +++ b/docs/chdb/getting-started.md @@ -4,6 +4,7 @@ sidebar_label: 'Getting started' slug: /chdb/getting-started description: 'chDB is an in-process SQL OLAP Engine powered by ClickHouse' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'in-process', 'in process'] +doc_type: 'tutorial' --- # Getting started with chDB diff --git a/docs/chdb/guides/clickhouse-local.md b/docs/chdb/guides/clickhouse-local.md index 61e200ef8c6..f861492c945 100644 --- a/docs/chdb/guides/clickhouse-local.md +++ b/docs/chdb/guides/clickhouse-local.md @@ -4,6 +4,7 @@ sidebar_label: 'Using clickhouse-local database' slug: /chdb/guides/clickhouse-local description: 'Learn how to use a clickhouse-local database with chDB' keywords: ['chdb', 'clickhouse-local'] +doc_type: 'tutorial' --- [clickhouse-local](/operations/utilities/clickhouse-local) is a CLI with an embedded version of ClickHouse. diff --git a/docs/chdb/guides/index.md b/docs/chdb/guides/index.md index f276e625a2e..970ab185af7 100644 --- a/docs/chdb/guides/index.md +++ b/docs/chdb/guides/index.md @@ -3,6 +3,7 @@ title: 'chDB Guides' slug: /chdb/guides description: 'Index page for chDB guides' keywords: ['chdb', 'guides'] +doc_type: 'reference' --- Take a look at our chDB developer guides below: @@ -14,4 +15,13 @@ in the table of contents, please edit the frontmatter of the files directly. --> +| Page | Description | +|-----|-----| +| [How to query a remote ClickHouse server](/chdb/guides/query-remote-clickhouse) | In this guide, we will learn how to query a remote ClickHouse server from chDB. | +| [How to query Apache Arrow with chDB](/chdb/guides/apache-arrow) | In this guide, we will learn how to query Apache Arrow tables with chDB | +| [How to query data in an S3 bucket](/chdb/guides/querying-s3) | Learn how to query data in an S3 bucket with chDB. | +| [How to query Pandas DataFrames with chDB](/chdb/guides/pandas) | Learn how to query Pandas DataFrames with chDB | +| [How to query Parquet files](/chdb/guides/querying-parquet) | Learn how to query Parquet files with chDB. | +| [JupySQL and chDB](/chdb/guides/jupysql) | How to install chDB for Bun | +| [Using a clickhouse-local database](/chdb/guides/clickhouse-local) | Learn how to use a clickhouse-local database with chDB | diff --git a/docs/chdb/guides/jupysql.md b/docs/chdb/guides/jupysql.md index e9030b23076..ce8150c0f1b 100644 --- a/docs/chdb/guides/jupysql.md +++ b/docs/chdb/guides/jupysql.md @@ -4,6 +4,7 @@ sidebar_label: 'JupySQL' slug: /chdb/guides/jupysql description: 'How to install chDB for Bun' keywords: ['chdb', 'JupySQL'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/chdb/guides/query-remote-clickhouse.md b/docs/chdb/guides/query-remote-clickhouse.md index 1a9509f0e93..ee316b00234 100644 --- a/docs/chdb/guides/query-remote-clickhouse.md +++ b/docs/chdb/guides/query-remote-clickhouse.md @@ -4,6 +4,7 @@ sidebar_label: 'Querying remote ClickHouse' slug: /chdb/guides/query-remote-clickhouse description: 'In this guide, we will learn how to query a remote ClickHouse server from chDB.' keywords: ['chdb', 'clickhouse'] +doc_type: 'how-to' --- In this guide, we're going to learn how to query a remote ClickHouse server from chDB. diff --git a/docs/chdb/guides/querying-apache-arrow.md b/docs/chdb/guides/querying-apache-arrow.md index 0fdf29dcef9..53392db65cb 100644 --- a/docs/chdb/guides/querying-apache-arrow.md +++ b/docs/chdb/guides/querying-apache-arrow.md @@ -4,6 +4,7 @@ sidebar_label: 'Querying Apache Arrow' slug: /chdb/guides/apache-arrow description: 'In this guide, we will learn how to query Apache Arrow tables with chDB' keywords: ['chdb', 'Apache Arrow'] +doc_type: 'how-to' --- [Apache Arrow](https://arrow.apache.org/) is a standardized column-oriented memory format that's gained popularity in the data community. diff --git a/docs/chdb/guides/querying-pandas.md b/docs/chdb/guides/querying-pandas.md index faa78627ac2..d826ec5b2ef 100644 --- a/docs/chdb/guides/querying-pandas.md +++ b/docs/chdb/guides/querying-pandas.md @@ -5,6 +5,7 @@ slug: /chdb/guides/pandas description: 'Learn how to query Pandas DataFrames with chDB' keywords: ['chDB', 'Pandas'] show_related_blogs: true +doc_type: 'how-to' --- [Pandas](https://pandas.pydata.org/) is a popular library for data manipulation and analysis in Python. diff --git a/docs/chdb/guides/querying-parquet.md b/docs/chdb/guides/querying-parquet.md index ecc63923236..8fda11220bc 100644 --- a/docs/chdb/guides/querying-parquet.md +++ b/docs/chdb/guides/querying-parquet.md @@ -4,6 +4,7 @@ sidebar_label: 'Querying Parquet files' slug: /chdb/guides/querying-parquet description: 'Learn how to query Parquet files with chDB.' keywords: ['chdb', 'parquet'] +doc_type: 'how-to' --- A lot of the world's data lives in Amazon S3 buckets. diff --git a/docs/chdb/guides/querying-s3-bucket.md b/docs/chdb/guides/querying-s3-bucket.md index 101f24e491b..f2658da1fae 100644 --- a/docs/chdb/guides/querying-s3-bucket.md +++ b/docs/chdb/guides/querying-s3-bucket.md @@ -4,6 +4,7 @@ sidebar_label: 'Querying data in S3' slug: /chdb/guides/querying-s3 description: 'Learn how to query data in an S3 bucket with chDB.' keywords: ['chdb', 's3'] +doc_type: 'how-to' --- A lot of the world's data lives in Amazon S3 buckets. diff --git a/docs/chdb/index.md b/docs/chdb/index.md index 13c9e708bab..3740570884b 100644 --- a/docs/chdb/index.md +++ b/docs/chdb/index.md @@ -4,6 +4,7 @@ sidebar_label: 'Overview' slug: /chdb description: 'chDB is an in-process SQL OLAP Engine powered by ClickHouse' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'in-process', 'in process'] +doc_type: 'reference' --- # chDB diff --git a/docs/chdb/install/bun.md b/docs/chdb/install/bun.md index 16f2b86740a..321f20abbfe 100644 --- a/docs/chdb/install/bun.md +++ b/docs/chdb/install/bun.md @@ -4,6 +4,7 @@ sidebar_label: 'Bun' slug: /chdb/install/bun description: 'How to install chDB for Bun' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'bun', 'install'] +doc_type: 'how-to' --- # Installing chDB for Bun diff --git a/docs/chdb/install/c.md b/docs/chdb/install/c.md index 8d5a914c1ac..00d2257a3f2 100644 --- a/docs/chdb/install/c.md +++ b/docs/chdb/install/c.md @@ -4,6 +4,7 @@ sidebar_label: 'C and C++' slug: /chdb/install/c description: 'How to install chDB for C and C++' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'install'] +doc_type: 'how-to' --- diff --git a/docs/chdb/install/go.md b/docs/chdb/install/go.md index 5521059d2ad..d81ca910683 100644 --- a/docs/chdb/install/go.md +++ b/docs/chdb/install/go.md @@ -4,6 +4,7 @@ sidebar_label: 'Go' slug: /chdb/install/go description: 'How to install chDB for Go' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'go', 'install'] +doc_type: 'how-to' --- # Installing chDB for Go diff --git a/docs/chdb/install/index.md b/docs/chdb/install/index.md index 10a8dffc43f..287e2e44e7a 100644 --- a/docs/chdb/install/index.md +++ b/docs/chdb/install/index.md @@ -3,6 +3,7 @@ title: 'Language Integrations Index' slug: /chdb/install description: 'Index page for chDB language integrations' keywords: ['python', 'NodeJS', 'Go', 'Rust', 'Bun', 'C', 'C++'] +doc_type: 'reference' --- Instructions for how to get setup with chDB are available below for the following languages and runtimes: diff --git a/docs/chdb/install/nodejs.md b/docs/chdb/install/nodejs.md index 63aa51da075..ff0a0aa960a 100644 --- a/docs/chdb/install/nodejs.md +++ b/docs/chdb/install/nodejs.md @@ -4,6 +4,7 @@ sidebar_label: 'NodeJS' slug: /chdb/install/nodejs description: 'How to install chDB for NodeJS' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'NodeJS', 'install'] +doc_type: 'how-to' --- # Installing chDB for NodeJS diff --git a/docs/chdb/install/python.md b/docs/chdb/install/python.md index 776d15fffa5..f9e0851deb1 100644 --- a/docs/chdb/install/python.md +++ b/docs/chdb/install/python.md @@ -4,6 +4,7 @@ sidebar_label: 'Python' slug: /chdb/install/python description: 'How to install chDB for Python' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'python', 'install'] +doc_type: 'how-to' --- # Installing chDB for Python diff --git a/docs/chdb/install/rust.md b/docs/chdb/install/rust.md index da317008ca9..6449fb69b85 100644 --- a/docs/chdb/install/rust.md +++ b/docs/chdb/install/rust.md @@ -4,6 +4,7 @@ sidebar_label: 'Rust' slug: /chdb/install/rust description: 'How to install chDB for Rust' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'bun', 'install'] +doc_type: 'how-to' --- ## Requirements {#requirements} diff --git a/docs/chdb/reference/data-formats.md b/docs/chdb/reference/data-formats.md index 789b5cf21cc..153de9cf9a0 100644 --- a/docs/chdb/reference/data-formats.md +++ b/docs/chdb/reference/data-formats.md @@ -4,6 +4,7 @@ sidebar_label: 'Data Formats' slug: /chdb/reference/data-formats description: 'Data Formats for chDB' keywords: ['chdb', 'data formats'] +doc_type: 'reference' --- When it comes to data formats, chDB is 100% feature compatible with ClickHouse. diff --git a/docs/chdb/reference/index.md b/docs/chdb/reference/index.md index 9f0bf650586..b5dc07ae58c 100644 --- a/docs/chdb/reference/index.md +++ b/docs/chdb/reference/index.md @@ -3,6 +3,7 @@ title: 'chDB Technical Reference' slug: /chdb/reference description: 'Data Formats for chDB' keywords: ['chdb', 'data formats'] +doc_type: 'reference' --- | Reference page | diff --git a/docs/chdb/reference/sql-reference.md b/docs/chdb/reference/sql-reference.md index 517f51432fa..acd3c506c33 100644 --- a/docs/chdb/reference/sql-reference.md +++ b/docs/chdb/reference/sql-reference.md @@ -4,6 +4,7 @@ sidebar_label: 'SQL Reference' slug: /chdb/reference/sql-reference description: 'SQL Reference for chDB' keywords: ['chdb', 'sql reference'] +doc_type: 'reference' --- chdb supports the same SQL syntax, statements, engines and functions as ClickHouse: diff --git a/docs/cloud-index.md b/docs/cloud-index.md index 911b6d139ff..05d401a8310 100644 --- a/docs/cloud-index.md +++ b/docs/cloud-index.md @@ -4,6 +4,7 @@ keywords: ['AWS', 'Cloud', 'serverless'] title: 'Overview' hide_title: true description: 'Overview page for Cloud' +doc_type: 'reference' --- import Content from '@site/docs/about-us/cloud.md'; diff --git a/docs/cloud/bestpractices/index.md b/docs/cloud/bestpractices/index.md index 550f2901bc4..b0549d8b19a 100644 --- a/docs/cloud/bestpractices/index.md +++ b/docs/cloud/bestpractices/index.md @@ -4,6 +4,7 @@ keywords: ['Cloud', 'Best Practices', 'Bulk Inserts', 'Asynchronous Inserts', 'A title: 'Overview' hide_title: true description: 'Landing page for Best Practices section in ClickHouse Cloud' +doc_type: 'reference' --- # Best Practices in ClickHouse Cloud {#best-practices-in-clickhouse-cloud} diff --git a/docs/cloud/bestpractices/multitenancy.md b/docs/cloud/bestpractices/multitenancy.md index 5289a09b067..928fdc555d8 100644 --- a/docs/cloud/bestpractices/multitenancy.md +++ b/docs/cloud/bestpractices/multitenancy.md @@ -3,6 +3,7 @@ slug: /cloud/bestpractices/multi-tenancy sidebar_label: 'Implement multi tenancy' title: 'Multi tenancy' description: 'Best practices to implement multi tenancy' +doc_type: 'reference' --- On a SaaS data analytics platform, it is common for multiple tenants, such as organizations, customers, or business units, to share the same database infrastructure while maintaining logical separation of their data. This allows different users to securely access their own data within the same platform. diff --git a/docs/cloud/bestpractices/usagelimits.md b/docs/cloud/bestpractices/usagelimits.md index 37ab67b542c..9765272b364 100644 --- a/docs/cloud/bestpractices/usagelimits.md +++ b/docs/cloud/bestpractices/usagelimits.md @@ -3,6 +3,7 @@ slug: /cloud/bestpractices/usage-limits sidebar_label: 'Usage Limits' title: 'Usage limits' description: 'Describes the recommended usage limits in ClickHouse Cloud' +doc_type: 'reference' --- While ClickHouse is known for its speed and reliability, optimal performance is achieved within certain operating parameters. For example, having too many tables, databases or parts could negatively impact performance. To avoid this, Clickhouse Cloud has guardrails set up for several types of items. You can find details of these guardrails below. diff --git a/docs/cloud/changelogs/24_02.md b/docs/cloud/changelogs/24_02.md index fa418da75a8..4eac8f291c2 100644 --- a/docs/cloud/changelogs/24_02.md +++ b/docs/cloud/changelogs/24_02.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v24.2' keywords: ['changelog'] sidebar_label: '24.2' sidebar_position: 8 +doc_type: 'how-to' --- ### ClickHouse release tag: 24.2.2.15987 {#clickhouse-release-tag-242215987} diff --git a/docs/cloud/changelogs/24_05.md b/docs/cloud/changelogs/24_05.md index b6f90bf2eea..6ef47f610a9 100644 --- a/docs/cloud/changelogs/24_05.md +++ b/docs/cloud/changelogs/24_05.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v24.5' keywords: ['changelog', 'cloud'] sidebar_label: '24.5' sidebar_position: 7 +doc_type: 'reference' --- # V24.5 changelog for Cloud diff --git a/docs/cloud/changelogs/24_06.md b/docs/cloud/changelogs/24_06.md index aeed4a90f3c..8789859c210 100644 --- a/docs/cloud/changelogs/24_06.md +++ b/docs/cloud/changelogs/24_06.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v24.6' keywords: ['changelog', 'cloud'] sidebar_label: '24.6' sidebar_position: 6 +doc_type: 'explanation' --- # V24.6 changelog for Cloud diff --git a/docs/cloud/changelogs/24_08.md b/docs/cloud/changelogs/24_08.md index 09a7aa86779..6bf6d551b4c 100644 --- a/docs/cloud/changelogs/24_08.md +++ b/docs/cloud/changelogs/24_08.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v24.8' keywords: ['changelog', 'cloud'] sidebar_label: '24.8' sidebar_position: 5 +doc_type: 'reference' --- Relevant changes for ClickHouse Cloud services based on the v24.8 release. diff --git a/docs/cloud/changelogs/24_10.md b/docs/cloud/changelogs/24_10.md index 419c488272b..80c4df2c1d7 100644 --- a/docs/cloud/changelogs/24_10.md +++ b/docs/cloud/changelogs/24_10.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v24.10' keywords: ['changelog', 'cloud'] sidebar_label: '24.10' sidebar_position: 4 +doc_type: 'reference' --- Relevant changes for ClickHouse Cloud services based on the v24.10 release. diff --git a/docs/cloud/changelogs/24_12.md b/docs/cloud/changelogs/24_12.md index 629ca84d8e2..913905933b6 100644 --- a/docs/cloud/changelogs/24_12.md +++ b/docs/cloud/changelogs/24_12.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v24.12' keywords: ['changelog', 'cloud'] sidebar_label: '24.12' sidebar_position: 3 +doc_type: 'reference' --- Relevant changes for ClickHouse Cloud services based on the v24.12 release. diff --git a/docs/cloud/changelogs/25_04.md b/docs/cloud/changelogs/25_04.md index 3e7067dddc9..33bb1fa3c1a 100644 --- a/docs/cloud/changelogs/25_04.md +++ b/docs/cloud/changelogs/25_04.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v25.4' keywords: ['changelog', 'cloud'] sidebar_label: '25.4' sidebar_position: 2 +doc_type: 'reference' --- ## Backward incompatible changes {#backward-incompatible-changes} diff --git a/docs/cloud/changelogs/25_06.md b/docs/cloud/changelogs/25_06.md index 0120d27df1b..e2a12939f79 100644 --- a/docs/cloud/changelogs/25_06.md +++ b/docs/cloud/changelogs/25_06.md @@ -5,6 +5,7 @@ description: 'Fast release changelog for v25.6' keywords: ['changelog', 'cloud'] sidebar_label: '25.6' sidebar_position: 1 +doc_type: 'reference' --- ## Backward incompatible change {#backward-incompatible-change} diff --git a/docs/cloud/get-started/index.md b/docs/cloud/get-started/index.md index 3c30f63f149..d7ad64c5190 100644 --- a/docs/cloud/get-started/index.md +++ b/docs/cloud/get-started/index.md @@ -3,6 +3,7 @@ slug: /cloud/get-started title: 'Get Started' description: 'Get Started Table Of Contents' keywords: ['Cloud Quick Start', 'SQL Console', 'Query Insights', 'Query API Endpoints', 'Dashboards', 'Cloud Support'] +doc_type: 'reference' --- Welcome to ClickHouse Cloud! Explore the pages below to learn more about what ClickHouse Cloud has to offer. diff --git a/docs/cloud/get-started/query-endpoints.md b/docs/cloud/get-started/query-endpoints.md index 07c332e5fdc..dd29068992e 100644 --- a/docs/cloud/get-started/query-endpoints.md +++ b/docs/cloud/get-started/query-endpoints.md @@ -4,6 +4,7 @@ slug: /cloud/get-started/query-endpoints description: 'Easily spin up REST API endpoints from your saved queries' keywords: ['api', 'query api endpoints', 'query endpoints', 'query rest api'] title: 'Query API Endpoints' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/get-started/query-insights.md b/docs/cloud/get-started/query-insights.md index 5dbddedccb2..6438ec33229 100644 --- a/docs/cloud/get-started/query-insights.md +++ b/docs/cloud/get-started/query-insights.md @@ -4,6 +4,7 @@ slug: /cloud/get-started/query-insights description: 'Visualize system.query_log data to simplify query debugging and performance optimization' keywords: ['query insights', 'query log', 'query log ui', 'system.query_log insights'] title: 'Query Insights' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/get-started/sql-console.md b/docs/cloud/get-started/sql-console.md index 59ba2e1be61..6ef06debff1 100644 --- a/docs/cloud/get-started/sql-console.md +++ b/docs/cloud/get-started/sql-console.md @@ -4,6 +4,7 @@ slug: /cloud/get-started/sql-console description: 'Run queries and create visualizations using the SQL Console.' keywords: ['sql console', 'sql client', 'cloud console', 'console'] title: 'SQL Console' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/account-close.md b/docs/cloud/manage/account-close.md index ac9a79eeeea..1e376551e5e 100644 --- a/docs/cloud/manage/account-close.md +++ b/docs/cloud/manage/account-close.md @@ -3,6 +3,7 @@ sidebar_label: 'Delete Account' slug: /cloud/manage/close_account title: 'Account Close & Deletion' description: 'We know there are circumstances that sometimes necessitate account closure. This guide will help you through the process.' +doc_type: 'how-to' --- ## Account closure and deletion {#account-close--deletion} diff --git a/docs/cloud/manage/api/api-overview.md b/docs/cloud/manage/api/api-overview.md index ab0484d0c5c..3d2691a4c7d 100644 --- a/docs/cloud/manage/api/api-overview.md +++ b/docs/cloud/manage/api/api-overview.md @@ -4,6 +4,7 @@ sidebar_position: 1 title: 'ClickHouse Cloud API' slug: /cloud/manage/api/api-overview description: 'Learn about ClickHouse Cloud API' +doc_type: 'reference' --- # ClickHouse Cloud API diff --git a/docs/cloud/manage/api/index.md b/docs/cloud/manage/api/index.md index da8d8e74c0a..f914d20f409 100644 --- a/docs/cloud/manage/api/index.md +++ b/docs/cloud/manage/api/index.md @@ -2,6 +2,7 @@ title: 'Cloud API' slug: /cloud/manage/cloud-api description: 'Landing page for the Cloud API section' +doc_type: 'reference' --- This section contains reference documentation for Cloud API and contains the following pages: diff --git a/docs/cloud/manage/backups/configurable-backups.md b/docs/cloud/manage/backups/configurable-backups.md index c4c55ad86c8..59f71d53697 100644 --- a/docs/cloud/manage/backups/configurable-backups.md +++ b/docs/cloud/manage/backups/configurable-backups.md @@ -4,6 +4,7 @@ slug: /cloud/manage/backups/configurable-backups description: 'Configurable Backups' title: 'Configurable Backups' keywords: ['backups', 'cloud backups', 'restore'] +doc_type: 'how-to' --- import backup_settings from '@site/static/images/cloud/manage/backup-settings.png'; diff --git a/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md b/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md index 4cd5ea78b62..663ea1fb39d 100644 --- a/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md +++ b/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md @@ -3,6 +3,7 @@ sidebar_label: 'Export Backups to your Own Cloud Account' slug: /cloud/manage/backups/export-backups-to-own-cloud-account title: 'Export Backups to your Own Cloud Account' description: 'Describes how to export backups to your own Cloud account' +doc_type: 'how-to' --- import EnterprisePlanFeatureBadge from '@theme/badges/EnterprisePlanFeatureBadge' diff --git a/docs/cloud/manage/backups/index.md b/docs/cloud/manage/backups/index.md index d42ed0ef899..6d1b18ec90e 100644 --- a/docs/cloud/manage/backups/index.md +++ b/docs/cloud/manage/backups/index.md @@ -3,6 +3,7 @@ slug: /cloud/manage/backups title: 'Backups' description: 'Table of contents page for backups.' keywords: ['backups', 'configurable backups', 'export backups to own cloud'] +doc_type: 'reference' --- | Page | Description | diff --git a/docs/cloud/manage/backups/overview.md b/docs/cloud/manage/backups/overview.md index 785fdb34ec1..f5516337ddf 100644 --- a/docs/cloud/manage/backups/overview.md +++ b/docs/cloud/manage/backups/overview.md @@ -5,6 +5,7 @@ slug: /cloud/manage/backups/overview title: 'Overview' keywords: ['backups', 'cloud backups', 'restore'] description: 'Provides an overview of backups in ClickHouse Cloud' +doc_type: 'tutorial' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/cloud/manage/billing.md b/docs/cloud/manage/billing.md index 3745df1d2aa..34d1eb5012a 100644 --- a/docs/cloud/manage/billing.md +++ b/docs/cloud/manage/billing.md @@ -3,6 +3,7 @@ sidebar_label: 'Overview' slug: /cloud/manage/billing/overview title: 'Pricing' description: 'Overview page for ClickHouse Cloud pricing' +doc_type: 'reference' --- import ClickPipesFAQ from './jan2025_faq/_snippets/_clickpipes_faq.md' diff --git a/docs/cloud/manage/billing/index.md b/docs/cloud/manage/billing/index.md index f940c75a034..25de978ae05 100644 --- a/docs/cloud/manage/billing/index.md +++ b/docs/cloud/manage/billing/index.md @@ -3,6 +3,7 @@ slug: /cloud/manage/billing title: 'Billing' description: 'Table of contents page for billing.' keywords: ['billing', 'payment thresholds', 'trouble shooting', 'marketplace'] +doc_type: 'reference' --- This section of the documentation covers topics related to billing, and contains the following pages: diff --git a/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md b/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md index 93112efd0ab..6f4d2777736 100644 --- a/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md +++ b/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md @@ -3,6 +3,7 @@ slug: /cloud/billing/marketplace/aws-marketplace-committed-contract title: 'AWS Marketplace Committed Contract' description: 'Subscribe to ClickHouse Cloud through the AWS Marketplace (Committed Contract)' keywords: ['aws', 'amazon', 'marketplace', 'billing', 'committed', 'committed contract'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md b/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md index f81eb94b108..42e16ca3e2b 100644 --- a/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md +++ b/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md @@ -3,6 +3,7 @@ slug: /cloud/billing/marketplace/aws-marketplace-payg title: 'AWS Marketplace PAYG' description: 'Subscribe to ClickHouse Cloud through the AWS Marketplace (PAYG).' keywords: ['aws', 'marketplace', 'billing', 'PAYG'] +doc_type: 'how-to' --- import aws_marketplace_payg_1 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-1.png'; diff --git a/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md b/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md index 5eb23177046..87e49904ea8 100644 --- a/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md +++ b/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md @@ -3,6 +3,7 @@ slug: /cloud/billing/marketplace/azure-marketplace-committed-contract title: 'Azure Marketplace Committed Contract' description: 'Subscribe to ClickHouse Cloud through the Azure Marketplace (Committed Contract)' keywords: ['Microsoft', 'Azure', 'marketplace', 'billing', 'committed', 'committed contract'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md b/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md index fb51b888e54..f339c6acd63 100644 --- a/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md +++ b/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md @@ -3,6 +3,7 @@ slug: /cloud/billing/marketplace/azure-marketplace-payg title: 'Azure Marketplace PAYG' description: 'Subscribe to ClickHouse Cloud through the Azure Marketplace (PAYG).' keywords: ['azure', 'marketplace', 'billing', 'PAYG'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md b/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md index 48ce98f6348..dda137e0ba3 100644 --- a/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md +++ b/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md @@ -3,6 +3,7 @@ slug: /cloud/billing/marketplace/gcp-marketplace-committed-contract title: 'GCP Marketplace Committed Contract' description: 'Subscribe to ClickHouse Cloud through the GCP Marketplace (Committed Contract)' keywords: ['gcp', 'google', 'marketplace', 'billing', 'committed', 'committed contract'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md b/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md index 3ad63595812..c0d095d0b4a 100644 --- a/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md +++ b/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md @@ -3,6 +3,7 @@ slug: /cloud/billing/marketplace/gcp-marketplace-payg title: 'GCP Marketplace PAYG' description: 'Subscribe to ClickHouse Cloud through the GCP Marketplace (PAYG).' keywords: ['gcp', 'marketplace', 'billing', 'PAYG'] +doc_type: 'how-to' --- import gcp_marketplace_payg_1 from '@site/static/images/cloud/manage/billing/marketplace/gcp-marketplace-payg-1.png'; diff --git a/docs/cloud/manage/billing/marketplace/index.md b/docs/cloud/manage/billing/marketplace/index.md index cf2b7cecd58..37f3c996158 100644 --- a/docs/cloud/manage/billing/marketplace/index.md +++ b/docs/cloud/manage/billing/marketplace/index.md @@ -3,6 +3,7 @@ slug: /cloud/manage/marketplace/ title: 'Market Place' description: 'Market Place Table of Contents page' keywords: ['Marketplace Billing', 'AWS', 'GCP'] +doc_type: 'reference' --- This section details billing related topics for Marketplace. diff --git a/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md b/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md index 937a751b0fa..edf7238ca7b 100644 --- a/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md +++ b/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md @@ -3,6 +3,7 @@ slug: /cloud/billing/marketplace/migrate title: 'Migrate billing from pay-as-you-go (PAYG) to a committed spend contract in a cloud marketplace' description: 'Migrate from pay-as-you-go to committed spend contract.' keywords: ['marketplace', 'billing', 'PAYG', 'pay-as-you-go', 'committed spend contract'] +doc_type: 'how-to' --- # Migrate billing from pay-as-you-go (PAYG) to a committed spend contract in a cloud marketplace {#migrate-payg-to-committed} diff --git a/docs/cloud/manage/billing/marketplace/overview.md b/docs/cloud/manage/billing/marketplace/overview.md index 1283206ecc3..7e400a46386 100644 --- a/docs/cloud/manage/billing/marketplace/overview.md +++ b/docs/cloud/manage/billing/marketplace/overview.md @@ -3,6 +3,7 @@ slug: /cloud/marketplace/marketplace-billing title: 'Marketplace Billing' description: 'Subscribe to ClickHouse Cloud through the AWS, GCP, and Azure marketplace.' keywords: ['aws', 'azure', 'gcp', 'google cloud', 'marketplace', 'billing'] +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/payment-thresholds.md b/docs/cloud/manage/billing/payment-thresholds.md index 0c2b6948d0e..56105baab98 100644 --- a/docs/cloud/manage/billing/payment-thresholds.md +++ b/docs/cloud/manage/billing/payment-thresholds.md @@ -4,6 +4,7 @@ slug: /cloud/billing/payment-thresholds title: 'Payment Thresholds' description: 'Payment thresholds and automatic invoicing for ClickHouse Cloud.' keywords: ['billing', 'payment thresholds', 'automatic invoicing', 'invoice'] +doc_type: 'how-to' --- # Payment thresholds diff --git a/docs/cloud/manage/cloud-tiers.md b/docs/cloud/manage/cloud-tiers.md index 244b453f8ab..2abae9a1bf6 100644 --- a/docs/cloud/manage/cloud-tiers.md +++ b/docs/cloud/manage/cloud-tiers.md @@ -3,6 +3,7 @@ sidebar_label: 'ClickHouse Cloud Tiers' slug: /cloud/manage/cloud-tiers title: 'ClickHouse Cloud Tiers' description: 'Cloud tiers available in ClickHouse Cloud' +doc_type: 'reference' --- # ClickHouse Cloud tiers diff --git a/docs/cloud/manage/dashboards.md b/docs/cloud/manage/dashboards.md index c33953aa82b..b352e6b05fd 100644 --- a/docs/cloud/manage/dashboards.md +++ b/docs/cloud/manage/dashboards.md @@ -3,6 +3,7 @@ sidebar_label: 'Dashboards' slug: /cloud/manage/dashboards title: 'Dashboards' description: 'The SQL Console''s dashboards feature allows you to collect and share visualizations from saved queries.' +doc_type: 'how-to' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/cloud/manage/hyperdx.md b/docs/cloud/manage/hyperdx.md index 7e56e90d279..3f060e4034d 100644 --- a/docs/cloud/manage/hyperdx.md +++ b/docs/cloud/manage/hyperdx.md @@ -3,6 +3,7 @@ sidebar_label: 'HyperDX' slug: /cloud/manage/hyperdx title: 'HyperDX' description: 'Provides HyperDX, the UI for ClickStack - a production-grade observability platform built on ClickHouse and OpenTelemetry (OTel), unifying logs, traces, metrics, and sessions in a single high-performance scalable solution.' +doc_type: 'reference' --- import PrivatePreviewBadge from '@theme/badges/PrivatePreviewBadge'; diff --git a/docs/cloud/manage/index.md b/docs/cloud/manage/index.md index 46c407d0c6b..5544796b1a0 100644 --- a/docs/cloud/manage/index.md +++ b/docs/cloud/manage/index.md @@ -4,6 +4,7 @@ keywords: ['AWS', 'Cloud', 'serverless', 'management'] title: 'Overview' hide_title: true description: 'Overview page for Managing Cloud' +doc_type: 'reference' --- # Managing Cloud diff --git a/docs/cloud/manage/integrations.md b/docs/cloud/manage/integrations.md index 7f4472b33e7..a92d384a462 100644 --- a/docs/cloud/manage/integrations.md +++ b/docs/cloud/manage/integrations.md @@ -3,6 +3,7 @@ sidebar_label: 'Integrations' slug: /manage/integrations title: 'Integrations' description: 'Integrations for ClickHouse' +doc_type: 'reference' --- To see a full list of integrations for ClickHouse, please see [this page](/integrations). diff --git a/docs/cloud/manage/jan2025_faq/backup.md b/docs/cloud/manage/jan2025_faq/backup.md index 579788f8dec..b0d4e7a233e 100644 --- a/docs/cloud/manage/jan2025_faq/backup.md +++ b/docs/cloud/manage/jan2025_faq/backup.md @@ -3,6 +3,7 @@ title: 'Backup Policy' slug: /cloud/manage/jan-2025-faq/backup keywords: ['new tiers', 'plans', 'pricing', 'backups'] description: 'Backup policy in new tiers' +doc_type: 'how-to' --- ## What is the backup policy? {#what-is-the-backup-policy} diff --git a/docs/cloud/manage/jan2025_faq/billing.md b/docs/cloud/manage/jan2025_faq/billing.md index 4147cc9976d..97e699f1bfd 100644 --- a/docs/cloud/manage/jan2025_faq/billing.md +++ b/docs/cloud/manage/jan2025_faq/billing.md @@ -3,6 +3,7 @@ title: 'Billing' slug: /cloud/manage/jan-2025-faq/billing keywords: ['new pricing', 'billing'] description: 'Billing details for new pricing tiers' +doc_type: 'explanation' --- ## Billing {#billing} diff --git a/docs/cloud/manage/jan2025_faq/dimensions.md b/docs/cloud/manage/jan2025_faq/dimensions.md index c4dd9268593..b9e9a722ab1 100644 --- a/docs/cloud/manage/jan2025_faq/dimensions.md +++ b/docs/cloud/manage/jan2025_faq/dimensions.md @@ -3,6 +3,7 @@ title: 'New Pricing Dimensions' slug: /cloud/manage/jan-2025-faq/pricing-dimensions keywords: ['new pricing', 'dimensions'] description: 'Pricing dimensions for data transfer and ClickPipes' +doc_type: 'explanation' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/jan2025_faq/index.md b/docs/cloud/manage/jan2025_faq/index.md index 840e07c06e7..b9cbcfc21a1 100644 --- a/docs/cloud/manage/jan2025_faq/index.md +++ b/docs/cloud/manage/jan2025_faq/index.md @@ -3,6 +3,7 @@ title: 'Jan 2025 Changes FAQ' slug: /cloud/manage/jan-2025-faq description: 'Index page for new pricing FAQ' keywords: ['new pricing', 'faq'] +doc_type: 'reference' --- +| Page | Description | +|-----|-----| +| | | +| [Backup Policy](/cloud/manage/jan-2025-faq/backup) | Backup policy in new tiers | +| [Billing](/cloud/manage/jan-2025-faq/billing) | Billing details for new pricing tiers | +| [Description of New Tiers](/cloud/manage/jan-2025-faq/new-tiers) | Description of new tiers and features | +| [Migrating to New Plans](/cloud/manage/jan-2025-faq/plan-migrations) | Migrating to new plans, tiers, pricing, how to decide and estimate costs | +| [New Pricing Dimensions](/cloud/manage/jan-2025-faq/pricing-dimensions) | Pricing dimensions for data transfer and ClickPipes | +| [Scaling](/cloud/manage/jan-2025-faq/scaling) | Scaling behavior in new pricing tiers | +| [Summary](/cloud/manage/jan-2025-faq/summary) | Summary of New ClickHouse Cloud Tiers | diff --git a/docs/cloud/manage/jan2025_faq/new_tiers.md b/docs/cloud/manage/jan2025_faq/new_tiers.md index b90874aedb8..ec0ec76b2c9 100644 --- a/docs/cloud/manage/jan2025_faq/new_tiers.md +++ b/docs/cloud/manage/jan2025_faq/new_tiers.md @@ -3,6 +3,7 @@ title: 'Description of New Tiers' slug: /cloud/manage/jan-2025-faq/new-tiers keywords: ['new tiers', 'features', 'pricing', 'description'] description: 'Description of new tiers and features' +doc_type: 'reference' --- ## Summary of key changes {#summary-of-key-changes} diff --git a/docs/cloud/manage/jan2025_faq/plan_migrations.md b/docs/cloud/manage/jan2025_faq/plan_migrations.md index fffdebfe45b..37e383d4c4e 100644 --- a/docs/cloud/manage/jan2025_faq/plan_migrations.md +++ b/docs/cloud/manage/jan2025_faq/plan_migrations.md @@ -3,6 +3,7 @@ title: 'Migrating to New Plans' slug: /cloud/manage/jan-2025-faq/plan-migrations keywords: ['migration', 'new tiers', 'pricing', 'cost', 'estimation'] description: 'Migrating to new plans, tiers, pricing, how to decide and estimate costs' +doc_type: 'how-to' --- ## Choosing new plans {#choosing-new-plans} diff --git a/docs/cloud/manage/jan2025_faq/scaling.md b/docs/cloud/manage/jan2025_faq/scaling.md index e65aff7345e..45560ce32c7 100644 --- a/docs/cloud/manage/jan2025_faq/scaling.md +++ b/docs/cloud/manage/jan2025_faq/scaling.md @@ -3,6 +3,7 @@ title: 'Scaling' slug: /cloud/manage/jan-2025-faq/scaling keywords: ['new pricing', 'faq', 'scaling'] description: 'Scaling behavior in new pricing tiers' +doc_type: 'explanation' --- ClickHouse Cloud allows scaling in both directions - vertical (increasing replica size) and horizontal (adding more replicas). diff --git a/docs/cloud/manage/jan2025_faq/summary.md b/docs/cloud/manage/jan2025_faq/summary.md index dfeafe642d3..07d3fc7ca13 100644 --- a/docs/cloud/manage/jan2025_faq/summary.md +++ b/docs/cloud/manage/jan2025_faq/summary.md @@ -3,6 +3,7 @@ title: 'Summary' slug: /cloud/manage/jan-2025-faq/summary keywords: ['new tiers', 'packaging', 'pricing faq', 'summary'] description: 'Summary of New ClickHouse Cloud Tiers' +doc_type: 'reference' --- The following FAQ summarizes common questions with respect to new tiers introduced in ClickHouse Cloud starting in January 2025. diff --git a/docs/cloud/manage/monitoring/advanced_dashboard.md b/docs/cloud/manage/monitoring/advanced_dashboard.md index ab320eb6ebe..83d483329bd 100644 --- a/docs/cloud/manage/monitoring/advanced_dashboard.md +++ b/docs/cloud/manage/monitoring/advanced_dashboard.md @@ -6,6 +6,7 @@ sidebar_label: 'Advanced dashboard' sidebar_position: 45 slug: /cloud/manage/monitor/advanced-dashboard title: 'Advanced dashboard in ClickHouse Cloud' +doc_type: 'how-to' --- import AdvancedDashboard from '@site/static/images/cloud/manage/monitoring/advanced_dashboard.png'; diff --git a/docs/cloud/manage/monitoring/prometheus.md b/docs/cloud/manage/monitoring/prometheus.md index 9a0c8254579..8ca2dc305eb 100644 --- a/docs/cloud/manage/monitoring/prometheus.md +++ b/docs/cloud/manage/monitoring/prometheus.md @@ -4,6 +4,7 @@ sidebar_label: 'Prometheus' title: 'Prometheus' description: 'Export ClickHouse metrics to Prometheus' keywords: ['prometheus', 'grafana', 'monitoring', 'metrics', 'exporter'] +doc_type: 'reference' --- import prometheus_grafana_metrics_endpoint from '@site/static/images/integrations/prometheus-grafana-metrics-endpoint.png'; diff --git a/docs/cloud/manage/notifications.md b/docs/cloud/manage/notifications.md index 84e619082e3..dfcfd496a53 100644 --- a/docs/cloud/manage/notifications.md +++ b/docs/cloud/manage/notifications.md @@ -3,6 +3,7 @@ title: 'Notifications' slug: /cloud/notifications description: 'Notifications for your ClickHouse Cloud service' keywords: ['cloud', 'notifications'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/openapi.md b/docs/cloud/manage/openapi.md index 919cb38cc48..65fa3f56749 100644 --- a/docs/cloud/manage/openapi.md +++ b/docs/cloud/manage/openapi.md @@ -3,6 +3,7 @@ sidebar_label: 'Managing API Keys' slug: /cloud/manage/openapi title: 'Managing API Keys' description: 'ClickHouse Cloud provides an API utilizing OpenAPI that allows you to programmatically manage your account and aspects of your services.' +doc_type: 'how-to' --- import image_01 from '@site/static/images/cloud/manage/openapi1.png'; diff --git a/docs/cloud/manage/postman.md b/docs/cloud/manage/postman.md index 2abe452bf2f..a4a57b5022e 100644 --- a/docs/cloud/manage/postman.md +++ b/docs/cloud/manage/postman.md @@ -3,6 +3,7 @@ slug: /cloud/manage/postman sidebar_label: 'Programmatic API access with Postman' title: 'Programmatic API access with Postman' description: 'This guide will help you test the ClickHouse Cloud API using Postman' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/replica-aware-routing.md b/docs/cloud/manage/replica-aware-routing.md index 8b8376b8667..62235d28e9e 100644 --- a/docs/cloud/manage/replica-aware-routing.md +++ b/docs/cloud/manage/replica-aware-routing.md @@ -3,6 +3,7 @@ title: 'Replica-aware Routing' slug: /manage/replica-aware-routing description: 'How to use Replica-aware routing to increase cache re-use' keywords: ['cloud', 'sticky endpoints', 'sticky', 'endpoints', 'sticky routing', 'routing', 'replica aware routing'] +doc_type: 'how-to' --- # Replica-aware routing (private preview) diff --git a/docs/cloud/manage/scaling.md b/docs/cloud/manage/scaling.md index 7dd7c5a6a91..a5f13fd2930 100644 --- a/docs/cloud/manage/scaling.md +++ b/docs/cloud/manage/scaling.md @@ -5,6 +5,7 @@ slug: /manage/scaling description: 'Configuring automatic scaling in ClickHouse Cloud' keywords: ['autoscaling', 'auto scaling', 'scaling', 'horizontal', 'vertical', 'bursts'] title: 'Automatic Scaling' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/service-uptime.md b/docs/cloud/manage/service-uptime.md index 3a31e459eaf..a63d02b70d0 100644 --- a/docs/cloud/manage/service-uptime.md +++ b/docs/cloud/manage/service-uptime.md @@ -3,6 +3,7 @@ sidebar_label: 'Service Uptime and SLA' slug: /cloud/manage/service-uptime title: 'Service Uptime' description: 'Users can now see regional uptimes on the status page and subscribe to alerts on service disruptions.' +doc_type: 'reference' --- ## Uptime alerts {#uptime-alerts} diff --git a/docs/cloud/manage/settings.md b/docs/cloud/manage/settings.md index a766ef59c13..d23bfe722fe 100644 --- a/docs/cloud/manage/settings.md +++ b/docs/cloud/manage/settings.md @@ -3,6 +3,7 @@ sidebar_label: 'Configuring Settings' slug: /manage/settings title: 'Configuring Settings' description: 'How to configure settings for your ClickHouse Cloud service for a specific user or role' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md index eea4e5d4c06..6a280be37f0 100644 --- a/docs/cloud/manage/troubleshooting-billing-issues.md +++ b/docs/cloud/manage/troubleshooting-billing-issues.md @@ -4,6 +4,7 @@ slug: /manage/clickhouse-cloud-billing-compliance title: 'ClickHouse Cloud billing compliance' description: 'Page describing ClickHouse Cloud billing compliance' keywords: ['billing compliance', 'pay-as-you-go'] +doc_type: 'reference' --- import billing_compliance from '@site/static/images/cloud/manage/billing_compliance.png'; diff --git a/docs/cloud/manage/upgrades.md b/docs/cloud/manage/upgrades.md index f52cb9d8bbd..9f56d99be2d 100644 --- a/docs/cloud/manage/upgrades.md +++ b/docs/cloud/manage/upgrades.md @@ -3,6 +3,7 @@ sidebar_label: 'Upgrades' slug: /manage/updates title: 'Upgrades' description: 'With ClickHouse Cloud you never have to worry about patching and upgrades. We roll out upgrades that include fixes, new features and performance improvements on a periodic basis.' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/migrate/upload-a-csv-file.md b/docs/cloud/migrate/upload-a-csv-file.md index 71347b0f55e..a81351845a2 100644 --- a/docs/cloud/migrate/upload-a-csv-file.md +++ b/docs/cloud/migrate/upload-a-csv-file.md @@ -2,6 +2,7 @@ title: 'Uploading files' slug: /cloud/migrate/upload-a-csv-file description: 'Learn how to upload files to Cloud' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/reference/architecture.md b/docs/cloud/reference/architecture.md index 9c3d7cf5f56..061a33db0aa 100644 --- a/docs/cloud/reference/architecture.md +++ b/docs/cloud/reference/architecture.md @@ -3,6 +3,7 @@ sidebar_label: 'Architecture' slug: /cloud/reference/architecture title: 'ClickHouse Cloud Architecture' description: 'This page describes the architecture of ClickHouse Cloud' +doc_type: 'reference' --- import Architecture from '@site/static/images/cloud/reference/architecture.svg'; diff --git a/docs/cloud/reference/byoc.md b/docs/cloud/reference/byoc.md index 536a63e7d59..ad7855f5e86 100644 --- a/docs/cloud/reference/byoc.md +++ b/docs/cloud/reference/byoc.md @@ -4,6 +4,7 @@ slug: /cloud/reference/byoc sidebar_label: 'BYOC (Bring Your Own Cloud)' keywords: ['BYOC', 'cloud', 'bring your own cloud'] description: 'Deploy ClickHouse on your own cloud infrastructure' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/reference/changelog.md b/docs/cloud/reference/changelog.md index c2f771077c0..8935463b917 100644 --- a/docs/cloud/reference/changelog.md +++ b/docs/cloud/reference/changelog.md @@ -3,6 +3,7 @@ slug: /whats-new/cloud sidebar_label: 'Cloud Changelog' title: 'Cloud Changelog' description: 'ClickHouse Cloud changelog providing descriptions of what is new in each ClickHouse Cloud release' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/reference/changelogs-index.md b/docs/cloud/reference/changelogs-index.md index c23e70f4ea2..d4aeb6355d5 100644 --- a/docs/cloud/reference/changelogs-index.md +++ b/docs/cloud/reference/changelogs-index.md @@ -2,6 +2,7 @@ slug: /cloud/reference/changelogs title: 'Changelogs' description: 'Landing page for Cloud changelogs' +doc_type: 'reference' --- | Page | Description | diff --git a/docs/cloud/reference/cloud-compatibility.md b/docs/cloud/reference/cloud-compatibility.md index 86dafbfefd5..41063b1fb0c 100644 --- a/docs/cloud/reference/cloud-compatibility.md +++ b/docs/cloud/reference/cloud-compatibility.md @@ -3,6 +3,7 @@ slug: /whats-new/cloud-compatibility sidebar_label: 'Cloud Compatibility' title: 'Cloud Compatibility' description: 'This guide provides an overview of what to expect functionally and operationally in ClickHouse Cloud.' +doc_type: 'reference' --- # ClickHouse Cloud compatibility guide diff --git a/docs/cloud/reference/index.md b/docs/cloud/reference/index.md index a4e19f99a7c..c595b3b9eef 100644 --- a/docs/cloud/reference/index.md +++ b/docs/cloud/reference/index.md @@ -4,6 +4,7 @@ keywords: ['Cloud', 'reference', 'architecture', 'SharedMergeTree', 'Compute-com title: 'Overview' hide_title: true description: 'Landing page for the Cloud reference section' +doc_type: 'reference' --- # Cloud reference diff --git a/docs/cloud/reference/release-notes-index.md b/docs/cloud/reference/release-notes-index.md index c7e32f843b5..1ee4ba54899 100644 --- a/docs/cloud/reference/release-notes-index.md +++ b/docs/cloud/reference/release-notes-index.md @@ -2,6 +2,7 @@ slug: /cloud/reference/changelogs/release-notes title: 'Cloud Release Notes' description: 'Landing page for Cloud release notes' +doc_type: 'reference' --- +| Page | Description | +|-----|-----| +| [v25.6 Changelog for Cloud](/changelogs/25.6) | Fast release changelog for v25.6 | +| [v25.4 Changelog for Cloud](/changelogs/25.4) | Fast release changelog for v25.4 | +| [v24.12 Changelog for Cloud](/changelogs/24.12) | Fast release changelog for v24.12 | +| [v24.10 Changelog for Cloud](/changelogs/24.10) | Fast release changelog for v24.10 | +| [v24.8 Changelog for Cloud](/changelogs/24.8) | Fast release changelog for v24.8 | +| [v24.6 Changelog for Cloud](/changelogs/24.6) | Fast release changelog for v24.6 | +| [v24.5 Changelog for Cloud](/changelogs/24.5) | Fast release changelog for v24.5 | +| [v24.2 Changelog](/whats-new/changelog/24.2-fast-release) | Fast release changelog for v24.2 | diff --git a/docs/cloud/reference/shared-catalog.md b/docs/cloud/reference/shared-catalog.md index fa474c41b74..df46760bf36 100644 --- a/docs/cloud/reference/shared-catalog.md +++ b/docs/cloud/reference/shared-catalog.md @@ -4,6 +4,7 @@ sidebar_label: 'Shared Catalog' title: 'Shared Catalog and Shared Database Engine' keywords: ['SharedCatalog', 'SharedDatabaseEngine'] description: 'Describes the Shared Catalog component and the Shared database engine in ClickHouse Cloud' +doc_type: 'explanation' --- # Shared catalog and shared database engine {#shared-catalog-and-shared-database-engine} diff --git a/docs/cloud/reference/shared-merge-tree.md b/docs/cloud/reference/shared-merge-tree.md index 4098a2ae756..3b5e400d84c 100644 --- a/docs/cloud/reference/shared-merge-tree.md +++ b/docs/cloud/reference/shared-merge-tree.md @@ -4,6 +4,7 @@ sidebar_label: 'SharedMergeTree' title: 'SharedMergeTree' keywords: ['SharedMergeTree'] description: 'Describes the SharedMergeTree table engine' +doc_type: 'reference' --- import shared_merge_tree from '@site/static/images/cloud/reference/shared-merge-tree-1.png'; diff --git a/docs/cloud/reference/supported-regions.md b/docs/cloud/reference/supported-regions.md index f434b8786e1..fe41be3251b 100644 --- a/docs/cloud/reference/supported-regions.md +++ b/docs/cloud/reference/supported-regions.md @@ -4,6 +4,7 @@ sidebar_label: 'Supported Cloud Regions' keywords: ['aws', 'gcp', 'google cloud', 'azure', 'cloud', 'regions'] description: 'Supported regions for ClickHouse Cloud' slug: /cloud/reference/supported-regions +doc_type: 'reference' --- import EnterprisePlanFeatureBadge from '@theme/badges/EnterprisePlanFeatureBadge' diff --git a/docs/cloud/reference/warehouses.md b/docs/cloud/reference/warehouses.md index 6ef40c0c159..1ec9dd0d912 100644 --- a/docs/cloud/reference/warehouses.md +++ b/docs/cloud/reference/warehouses.md @@ -3,6 +3,7 @@ title: 'Warehouses' slug: /cloud/reference/warehouses keywords: ['compute separation', 'cloud', 'architecture', 'compute-compute', 'warehouse', 'warehouses', 'hydra'] description: 'Compute-compute separation in ClickHouse Cloud' +doc_type: 'reference' --- import compute_1 from '@site/static/images/cloud/reference/compute-compute-1.png'; diff --git a/docs/cloud/security/accessing-s3-data-securely.md b/docs/cloud/security/accessing-s3-data-securely.md index f86b42b86eb..3aede9dc062 100644 --- a/docs/cloud/security/accessing-s3-data-securely.md +++ b/docs/cloud/security/accessing-s3-data-securely.md @@ -3,6 +3,7 @@ slug: /cloud/security/secure-s3 sidebar_label: 'Accessing S3 Data Securely' title: 'Accessing S3 Data Securely' description: 'This article demonstrates how ClickHouse Cloud customers can leverage role-based access to authenticate with Amazon Simple Storage Service(S3) and access their data securely.' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/audit-logging.md b/docs/cloud/security/audit-logging.md index 4e9169559e4..139dbf5d358 100644 --- a/docs/cloud/security/audit-logging.md +++ b/docs/cloud/security/audit-logging.md @@ -3,6 +3,7 @@ sidebar_label: 'Audit Logging' slug: /cloud/security/audit-logging title: 'Audit Logging' description: 'This page describes Audit Logging in ClickHouse Cloud. It explains how to access and interpret the audit logs, which record changes made to a ClickHouse Cloud organization.' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/aws-privatelink.md b/docs/cloud/security/aws-privatelink.md index 4a7c9644eb7..e6517248f26 100644 --- a/docs/cloud/security/aws-privatelink.md +++ b/docs/cloud/security/aws-privatelink.md @@ -2,6 +2,7 @@ title: 'AWS PrivateLink' description: 'This document describes how to connect to ClickHouse Cloud using AWS PrivateLink.' slug: /manage/security/aws-privatelink +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/azure-privatelink.md b/docs/cloud/security/azure-privatelink.md index 37355b6c332..21a3e92a4dd 100644 --- a/docs/cloud/security/azure-privatelink.md +++ b/docs/cloud/security/azure-privatelink.md @@ -4,6 +4,7 @@ sidebar_label: 'Azure Private Link' slug: /cloud/security/azure-privatelink description: 'How to set up Azure Private Link' keywords: ['azure', 'private link', 'privatelink'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/cloud-access-management/cloud-access-management.md b/docs/cloud/security/cloud-access-management/cloud-access-management.md index b0794fccf84..bbac438bf37 100644 --- a/docs/cloud/security/cloud-access-management/cloud-access-management.md +++ b/docs/cloud/security/cloud-access-management/cloud-access-management.md @@ -3,6 +3,7 @@ sidebar_label: 'Overview' slug: /cloud/security/cloud-access-management/overview title: 'Cloud access management' description: 'Describes how access control in ClickHouse cloud works, including information on role types' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/cloud-access-management/cloud-authentication.md b/docs/cloud/security/cloud-access-management/cloud-authentication.md index d44f6d19c5a..7fdac4aad03 100644 --- a/docs/cloud/security/cloud-access-management/cloud-authentication.md +++ b/docs/cloud/security/cloud-access-management/cloud-authentication.md @@ -3,6 +3,7 @@ sidebar_label: 'Cloud Authentication' slug: /cloud/security/cloud-authentication title: 'Cloud Authentication' description: 'This guide explains some good practices for configuring your authentication.' +doc_type: 'tutorial' --- import ScalePlanFeatureBadge from '@theme/badges/ScalePlanFeatureBadge' diff --git a/docs/cloud/security/cloud-access-management/index.md b/docs/cloud/security/cloud-access-management/index.md index a61339a7258..deecc25dfe8 100644 --- a/docs/cloud/security/cloud-access-management/index.md +++ b/docs/cloud/security/cloud-access-management/index.md @@ -2,6 +2,7 @@ slug: /cloud/security/cloud-access-management title: 'Cloud access management' description: 'Cloud Access Management Table Of Contents' +doc_type: 'reference' --- | Page | Description | diff --git a/docs/cloud/security/cloud-endpoints-api.md b/docs/cloud/security/cloud-endpoints-api.md index d55ec618f67..babdc8c3688 100644 --- a/docs/cloud/security/cloud-endpoints-api.md +++ b/docs/cloud/security/cloud-endpoints-api.md @@ -3,6 +3,7 @@ slug: /manage/security/cloud-endpoints-api sidebar_label: 'Cloud IP Addresses' title: 'Cloud IP Addresses' description: 'This page documents the Cloud Endpoints API security features within ClickHouse. It details how to secure your ClickHouse deployments by managing access through authentication and authorization mechanisms.' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/cmek.md b/docs/cloud/security/cmek.md index 229aa0ee1d2..b2617d4a71e 100644 --- a/docs/cloud/security/cmek.md +++ b/docs/cloud/security/cmek.md @@ -3,6 +3,7 @@ sidebar_label: 'Enhanced Encryption' slug: /cloud/security/cmek title: 'Customer Managed Encryption Keys (CMEK)' description: 'Learn more about customer managed encryption keys' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/common-access-management-queries.md b/docs/cloud/security/common-access-management-queries.md index 24b98073491..a5cd5dd40b4 100644 --- a/docs/cloud/security/common-access-management-queries.md +++ b/docs/cloud/security/common-access-management-queries.md @@ -3,6 +3,7 @@ sidebar_label: 'Common Access Management Queries' title: 'Common Access Management Queries' slug: /cloud/security/common-access-management-queries description: 'This article shows the basics of defining SQL users and roles and applying those privileges and permissions to databases, tables, rows, and columns.' +doc_type: 'how-to' --- import CommonUserRolesContent from '@site/docs/_snippets/_users-and-roles-common.md'; diff --git a/docs/cloud/security/compliance-overview.md b/docs/cloud/security/compliance-overview.md index 4653c0f09c1..b9305fcc0f3 100644 --- a/docs/cloud/security/compliance-overview.md +++ b/docs/cloud/security/compliance-overview.md @@ -3,6 +3,7 @@ sidebar_label: 'Security and Compliance' slug: /cloud/security/security-and-compliance title: 'Security and Compliance' description: 'This page describes the security and compliance measures implemented by ClickHouse Cloud to protect customer data.' +doc_type: 'reference' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/cloud/security/connectivity-overview.md b/docs/cloud/security/connectivity-overview.md index e62dbcfb377..a57d21da6ed 100644 --- a/docs/cloud/security/connectivity-overview.md +++ b/docs/cloud/security/connectivity-overview.md @@ -2,6 +2,7 @@ slug: /cloud/security/connectivity title: 'connectivity overview' description: 'Landing page for Connectivity' +doc_type: 'reference' --- # Connectivity diff --git a/docs/cloud/security/gcp-private-service-connect.md b/docs/cloud/security/gcp-private-service-connect.md index 8fcd99e06fd..10d07599ab2 100644 --- a/docs/cloud/security/gcp-private-service-connect.md +++ b/docs/cloud/security/gcp-private-service-connect.md @@ -3,6 +3,7 @@ title: 'GCP Private Service Connect' description: 'This document describes how to connect to ClickHouse Cloud using Google Cloud Platform (GCP) Private Service Connect (PSC), and how to disable access to your ClickHouse Cloud services from addresses other than GCP PSC addresses using ClickHouse Cloud IP access lists.' sidebar_label: 'GCP Private Service Connect' slug: /manage/security/gcp-private-service-connect +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/index.md b/docs/cloud/security/index.md index b6a2d56ab1b..60327c63c11 100644 --- a/docs/cloud/security/index.md +++ b/docs/cloud/security/index.md @@ -4,6 +4,7 @@ keywords: ['Cloud', 'Security'] title: 'Overview' hide_title: true description: 'Landing page for ClickHouse Cloud Security' +doc_type: 'reference' --- # ClickHouse Cloud security diff --git a/docs/cloud/security/inviting-new-users.md b/docs/cloud/security/inviting-new-users.md index 38dc099a6cb..4133d009cc3 100644 --- a/docs/cloud/security/inviting-new-users.md +++ b/docs/cloud/security/inviting-new-users.md @@ -3,6 +3,7 @@ sidebar_label: 'Inviting new users' slug: /cloud/security/inviting-new-users title: 'Inviting new users' description: 'This page describes how administrators can invite new users to their organisation and assign roles to them' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/personal-data-access.md b/docs/cloud/security/personal-data-access.md index bcf4514b301..8809d0a13ee 100644 --- a/docs/cloud/security/personal-data-access.md +++ b/docs/cloud/security/personal-data-access.md @@ -3,6 +3,7 @@ sidebar_label: 'Personal Data Access' slug: /cloud/security/personal-data-access title: 'Personal Data Access' description: 'As a registered user, ClickHouse allows you to view and manage your personal account data, including contact information.' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/privacy-compliance-overview.md b/docs/cloud/security/privacy-compliance-overview.md index e47d422c0a8..4ca5921de34 100644 --- a/docs/cloud/security/privacy-compliance-overview.md +++ b/docs/cloud/security/privacy-compliance-overview.md @@ -3,6 +3,7 @@ sidebar_label: 'Privacy and Compliance Overview' slug: /cloud/security/privacy-compliance-overview title: 'Privacy and Compliance' description: 'Landing page for privacy and compliance' +doc_type: 'reference' --- # Privacy and compliance diff --git a/docs/cloud/security/private-link-overview.md b/docs/cloud/security/private-link-overview.md index 183362a8e58..ba8bfa904f0 100644 --- a/docs/cloud/security/private-link-overview.md +++ b/docs/cloud/security/private-link-overview.md @@ -3,6 +3,7 @@ sidebar_label: 'Private link overview' slug: /cloud/security/private-link-overview title: 'Private link overview' description: 'Landing page for private link' +doc_type: 'reference' --- # Private link overview diff --git a/docs/cloud/security/saml-sso-setup.md b/docs/cloud/security/saml-sso-setup.md index 7d42305c1a9..c086e778657 100644 --- a/docs/cloud/security/saml-sso-setup.md +++ b/docs/cloud/security/saml-sso-setup.md @@ -3,6 +3,7 @@ sidebar_label: 'SAML SSO Setup' slug: /cloud/security/saml-setup title: 'SAML SSO Setup' description: 'How to set up SAML SSO with ClickHouse Cloud' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/setting-ip-filters.md b/docs/cloud/security/setting-ip-filters.md index 720f8c6503c..7872ca75eee 100644 --- a/docs/cloud/security/setting-ip-filters.md +++ b/docs/cloud/security/setting-ip-filters.md @@ -3,6 +3,7 @@ sidebar_label: 'Setting IP Filters' slug: /cloud/security/setting-ip-filters title: 'Setting IP Filters' description: 'This page explains how to set IP filters in ClickHouse Cloud to control access to ClickHouse services.' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/security/shared-responsibility-model.md b/docs/cloud/security/shared-responsibility-model.md index dbb828332eb..701aa360e29 100644 --- a/docs/cloud/security/shared-responsibility-model.md +++ b/docs/cloud/security/shared-responsibility-model.md @@ -3,6 +3,7 @@ sidebar_label: 'Shared Responsibility Model' slug: /cloud/security/shared-responsibility-model title: 'Security Shared Responsibility Model' description: 'Learn more about the security model of ClickHouse Cloud' +doc_type: 'reference' --- ## Service types {#service-types} diff --git a/docs/cloud/support.md b/docs/cloud/support.md index 836382cd3c5..2f0958723e5 100644 --- a/docs/cloud/support.md +++ b/docs/cloud/support.md @@ -4,6 +4,7 @@ title: 'Cloud Support' slug: /cloud/support description: 'Learn about Cloud Support' hide_title: true +doc_type: 'reference' --- import Content from '@site/docs/about-us/support.md'; diff --git a/docs/concepts/glossary.md b/docs/concepts/glossary.md index d4ec252617b..de95582ff9c 100644 --- a/docs/concepts/glossary.md +++ b/docs/concepts/glossary.md @@ -3,6 +3,7 @@ sidebar_label: 'Glossary' description: 'This page contains a list of commonly used words and phrases regarding ClickHouse, as well as their definitions.' title: 'Glossary' slug: /concepts/glossary +doc_type: 'reference' --- diff --git a/docs/concepts/index.md b/docs/concepts/index.md index 481a1d11ee9..a5c7871bc55 100644 --- a/docs/concepts/index.md +++ b/docs/concepts/index.md @@ -5,6 +5,7 @@ description: 'Landing page for concepts' pagination_next: null pagination_prev: null keywords: ['concepts', 'OLAP', 'fast'] +doc_type: 'reference' --- In this section of the docs we'll dive into the concepts around what makes ClickHouse so fast and efficient. diff --git a/docs/concepts/olap.md b/docs/concepts/olap.md index 5dd056abf13..a29a5ef745c 100644 --- a/docs/concepts/olap.md +++ b/docs/concepts/olap.md @@ -5,6 +5,7 @@ description: 'OLAP stands for Online Analytical Processing. It is a broad term t title: 'What is OLAP?' slug: /concepts/olap keywords: ['OLAP'] +doc_type: 'explanation' --- # What is OLAP? diff --git a/docs/data-compression/compression-in-clickhouse.md b/docs/data-compression/compression-in-clickhouse.md index 5a23e55176e..a23f6d0080b 100644 --- a/docs/data-compression/compression-in-clickhouse.md +++ b/docs/data-compression/compression-in-clickhouse.md @@ -3,6 +3,7 @@ slug: /data-compression/compression-in-clickhouse title: 'Compression in ClickHouse' description: 'Choosing ClickHouse compression algorithms' keywords: ['compression', 'codec', 'encoding'] +doc_type: 'reference' --- One of the secrets to ClickHouse query performance is compression. diff --git a/docs/data-compression/compression-modes.md b/docs/data-compression/compression-modes.md index 0bdd0a052a1..6a9b3b70390 100644 --- a/docs/data-compression/compression-modes.md +++ b/docs/data-compression/compression-modes.md @@ -4,6 +4,7 @@ sidebar_position: 6 title: 'Compression Modes' description: 'ClickHouse column compression modes' keywords: ['compression', 'codec', 'encoding', 'modes'] +doc_type: 'reference' --- import CompressionBlock from '@site/static/images/data-compression/ch_compression_block.png'; diff --git a/docs/data-modeling/backfilling.md b/docs/data-modeling/backfilling.md index 714bfce330d..2c20c865f3f 100644 --- a/docs/data-modeling/backfilling.md +++ b/docs/data-modeling/backfilling.md @@ -3,6 +3,7 @@ slug: /data-modeling/backfilling title: 'Backfilling Data' description: 'How to use backfill large datasets in ClickHouse' keywords: ['materialized views', 'backfilling', 'inserting data', 'resilient data load'] +doc_type: 'how-to' --- import nullTableMV from '@site/static/images/data-modeling/null_table_mv.png'; diff --git a/docs/data-modeling/denormalization.md b/docs/data-modeling/denormalization.md index 4b308e67f9c..40ec2e1febd 100644 --- a/docs/data-modeling/denormalization.md +++ b/docs/data-modeling/denormalization.md @@ -3,6 +3,7 @@ slug: /data-modeling/denormalization title: 'Denormalizing Data' description: 'How to use denormalization to improve query performance' keywords: ['data denormalization', 'denormalize', 'query optimization'] +doc_type: 'how-to' --- import denormalizationDiagram from '@site/static/images/data-modeling/denormalization-diagram.png'; diff --git a/docs/data-modeling/index.md b/docs/data-modeling/index.md index 43ed151580c..6cf88e10978 100644 --- a/docs/data-modeling/index.md +++ b/docs/data-modeling/index.md @@ -3,6 +3,7 @@ slug: /data-modeling/overview title: 'Data Modelling Overview' description: 'Overview of Data Modelling' keywords: ['data modelling', 'schema design', 'dictionary', 'materialized view', 'data compression', 'denormalizing data'] +doc_type: 'reference' --- # Data Modeling diff --git a/docs/data-modeling/projections/1_projections.md b/docs/data-modeling/projections/1_projections.md index 0a87c11dc55..2de159f48e9 100644 --- a/docs/data-modeling/projections/1_projections.md +++ b/docs/data-modeling/projections/1_projections.md @@ -5,6 +5,7 @@ description: 'Page describing what projections are, how they can be used to impr query performance, and how they differ from materialized views.' keywords: ['projection', 'projections', 'query optimization'] sidebar_order: 1 +doc_type: 'reference' --- import projections_1 from '@site/static/images/data-modeling/projections_1.png'; diff --git a/docs/data-modeling/projections/2_materialized-views-versus-projections.md b/docs/data-modeling/projections/2_materialized-views-versus-projections.md index 9819dbf5278..60d8d40fdb8 100644 --- a/docs/data-modeling/projections/2_materialized-views-versus-projections.md +++ b/docs/data-modeling/projections/2_materialized-views-versus-projections.md @@ -4,6 +4,7 @@ sidebar_label: 'Materialized views vs projections' title: 'Materialized Views versus Projections' hide_title: false description: 'Article comparing materialized views and projections in ClickHouse, including their use cases, performance, and limitations.' +doc_type: 'explanation' --- > A common question from users is when they should use materialized views versus diff --git a/docs/data-modeling/schema-design.md b/docs/data-modeling/schema-design.md index 7e67288929d..76658d7fb17 100644 --- a/docs/data-modeling/schema-design.md +++ b/docs/data-modeling/schema-design.md @@ -3,6 +3,7 @@ slug: /data-modeling/schema-design title: 'Schema Design' description: 'Optimizing ClickHouse schema for query performance' keywords: ['schema', 'schema design', 'query optimization'] +doc_type: 'tutorial' --- import stackOverflowSchema from '@site/static/images/data-modeling/stackoverflow-schema.png'; diff --git a/docs/deployment-guides/index.md b/docs/deployment-guides/index.md index 81f83e1c016..d36eb290222 100644 --- a/docs/deployment-guides/index.md +++ b/docs/deployment-guides/index.md @@ -2,6 +2,7 @@ slug: /deployment-guides/index title: 'Deployment Guides Overview' description: 'Landing page for the deployment and scaling section' +doc_type: 'reference' --- # Deployment and scaling diff --git a/docs/deployment-guides/replication-sharding-examples/01_1_shard_2_replicas.md b/docs/deployment-guides/replication-sharding-examples/01_1_shard_2_replicas.md index 6485ccb9b2b..33527140b3d 100644 --- a/docs/deployment-guides/replication-sharding-examples/01_1_shard_2_replicas.md +++ b/docs/deployment-guides/replication-sharding-examples/01_1_shard_2_replicas.md @@ -4,6 +4,7 @@ sidebar_label: 'Replication' sidebar_position: 10 title: 'Replicating data' description: 'Page describing an example architecture with five servers configured. Two are used to host copies of the data and the rest are used to coordinate the replication of data' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/deployment-guides/replication-sharding-examples/02_2_shards_1_replica.md b/docs/deployment-guides/replication-sharding-examples/02_2_shards_1_replica.md index b8f0b6bedaf..64700da8f3b 100644 --- a/docs/deployment-guides/replication-sharding-examples/02_2_shards_1_replica.md +++ b/docs/deployment-guides/replication-sharding-examples/02_2_shards_1_replica.md @@ -4,6 +4,7 @@ sidebar_label: 'Scaling' sidebar_position: 10 title: 'Scaling' description: 'Page describing an example architecture designed to provide scalability' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/deployment-guides/replication-sharding-examples/03_2_shards_2_replicas.md b/docs/deployment-guides/replication-sharding-examples/03_2_shards_2_replicas.md index 520e085d8f2..22affbe2a2e 100644 --- a/docs/deployment-guides/replication-sharding-examples/03_2_shards_2_replicas.md +++ b/docs/deployment-guides/replication-sharding-examples/03_2_shards_2_replicas.md @@ -4,6 +4,7 @@ sidebar_label: 'Replication + Scaling' sidebar_position: 100 title: 'Replication + Scaling' description: 'By going through this tutorial, you will learn how to set up a simple ClickHouse cluster.' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/deployment-guides/terminology.md b/docs/deployment-guides/terminology.md index 1c200db2379..003b50f5df8 100644 --- a/docs/deployment-guides/terminology.md +++ b/docs/deployment-guides/terminology.md @@ -4,6 +4,7 @@ sidebar_label: 'Introduction' title: 'Introduction' sidebar_position: 1 description: 'Page with deployment examples that are based on the advice provided to ClickHouse users by the ClickHouse Support and Services organization' +doc_type: 'reference' --- import ReplicationShardingTerminology from '@site/docs/_snippets/_replication-sharding-terminology.md'; diff --git a/docs/deployment-modes.md b/docs/deployment-modes.md index 057bc0a98a8..0ed4ee14ca6 100644 --- a/docs/deployment-modes.md +++ b/docs/deployment-modes.md @@ -5,6 +5,7 @@ description: 'ClickHouse offers four deployment options that all use the same po title: 'Deployment modes' keywords: ['Deployment Modes', 'chDB'] show_related_blogs: true +doc_type: 'explanation' --- import chServer from '@site/static/images/deployment-modes/ch-server.png'; diff --git a/docs/dictionary/index.md b/docs/dictionary/index.md index dfe18b195a1..095ef903aea 100644 --- a/docs/dictionary/index.md +++ b/docs/dictionary/index.md @@ -3,6 +3,7 @@ slug: /dictionary title: 'Dictionary' keywords: ['dictionary', 'dictionaries'] description: 'A dictionary provides a key-value representation of data for fast lookups.' +doc_type: 'reference' --- import dictionaryUseCases from '@site/static/images/dictionary/dictionary-use-cases.png'; diff --git a/docs/faq/general/columnar-database.md b/docs/faq/general/columnar-database.md index 41f8c69497f..503e81296a4 100644 --- a/docs/faq/general/columnar-database.md +++ b/docs/faq/general/columnar-database.md @@ -4,6 +4,7 @@ title: 'What is a columnar database?' toc_hidden: true toc_priority: 101 description: 'This page describes what a columnar database is' +doc_type: 'explanation' --- import Image from '@theme/IdealImage'; diff --git a/docs/faq/general/dbms-naming.md b/docs/faq/general/dbms-naming.md index 5c54e43fe07..c15df02b8f8 100644 --- a/docs/faq/general/dbms-naming.md +++ b/docs/faq/general/dbms-naming.md @@ -4,6 +4,7 @@ toc_hidden: true toc_priority: 10 slug: /faq/general/dbms-naming description: 'Learn about What does "ClickHouse" mean?' +doc_type: 'explanation' --- # What does "ClickHouse" mean? {#what-does-clickhouse-mean} diff --git a/docs/faq/general/index.md b/docs/faq/general/index.md index d7faa5313a6..0a5f37676a5 100644 --- a/docs/faq/general/index.md +++ b/docs/faq/general/index.md @@ -5,6 +5,7 @@ sidebar_label: 'General Questions about ClickHouse' keywords: ['faq', 'questions', 'what is'] title: 'General Questions About ClickHouse' description: 'Index page listing general questions about ClickHouse' +doc_type: 'reference' --- # General questions about ClickHouse diff --git a/docs/faq/general/mapreduce.md b/docs/faq/general/mapreduce.md index b056ea32858..54b98671930 100644 --- a/docs/faq/general/mapreduce.md +++ b/docs/faq/general/mapreduce.md @@ -5,6 +5,7 @@ toc_hidden: true toc_priority: 110 description: 'This page explains why you would use ClickHouse over MapReduce' keywords: ['MapReduce'] +doc_type: 'explanation' --- # Why not use something like MapReduce? {#why-not-use-something-like-mapreduce} diff --git a/docs/faq/general/ne-tormozit.md b/docs/faq/general/ne-tormozit.md index ec09494e9a8..6ad0c3c0d14 100644 --- a/docs/faq/general/ne-tormozit.md +++ b/docs/faq/general/ne-tormozit.md @@ -5,6 +5,7 @@ toc_hidden: true toc_priority: 11 description: 'This page explains what "Не тормозит" means' keywords: ['Yandex'] +doc_type: 'explanation' --- # What does "Не тормозит" mean? {#what-does-ne-tormozit-mean} diff --git a/docs/faq/general/olap.md b/docs/faq/general/olap.md index f63850713b8..6dbbba306e9 100644 --- a/docs/faq/general/olap.md +++ b/docs/faq/general/olap.md @@ -5,6 +5,7 @@ toc_hidden: true toc_priority: 100 description: 'An explainer on what Online Analytical Processing is' keywords: ['OLAP'] +doc_type: 'explanation' --- # What Is OLAP? {#what-is-olap} diff --git a/docs/faq/general/who-is-using-clickhouse.md b/docs/faq/general/who-is-using-clickhouse.md index 2ddb8df6898..142693a6e94 100644 --- a/docs/faq/general/who-is-using-clickhouse.md +++ b/docs/faq/general/who-is-using-clickhouse.md @@ -5,6 +5,7 @@ toc_hidden: true toc_priority: 9 description: 'Describes who is using ClickHouse' keywords: ['customer'] +doc_type: 'reference' --- # Who is using ClickHouse? {#who-is-using-clickhouse} diff --git a/docs/faq/index.md b/docs/faq/index.md index f5da4fe328a..38053f8eff9 100644 --- a/docs/faq/index.md +++ b/docs/faq/index.md @@ -4,6 +4,7 @@ title: 'FAQ' description: 'Landing page for FAQ' pagination_prev: null pagination_next: null +doc_type: 'reference' --- | Page | Description | diff --git a/docs/faq/integration/index.md b/docs/faq/integration/index.md index 76939b7bfb3..7a8c0bbf253 100644 --- a/docs/faq/integration/index.md +++ b/docs/faq/integration/index.md @@ -5,6 +5,7 @@ sidebar_label: 'Integrating ClickHouse with other systems' keywords: ['clickhouse', 'faq', 'questions', 'integrations'] title: 'Questions about integrating ClickHouse and other systems' description: 'Landing page listing questions related to integrating ClickHouse with other systems' +doc_type: 'reference' --- # Questions about integrating ClickHouse and other systems diff --git a/docs/faq/integration/json-import.md b/docs/faq/integration/json-import.md index 6363b725a52..060bdf07a9c 100644 --- a/docs/faq/integration/json-import.md +++ b/docs/faq/integration/json-import.md @@ -4,6 +4,7 @@ title: 'How to import JSON into ClickHouse?' toc_hidden: true toc_priority: 11 description: 'This page shows you how to import JSON into ClickHouse' +doc_type: 'how-to' --- # How to Import JSON Into ClickHouse? {#how-to-import-json-into-clickhouse} diff --git a/docs/faq/integration/oracle-odbc.md b/docs/faq/integration/oracle-odbc.md index 630e99c089c..72418fd8f36 100644 --- a/docs/faq/integration/oracle-odbc.md +++ b/docs/faq/integration/oracle-odbc.md @@ -4,6 +4,7 @@ title: 'What if I have a problem with encodings when using Oracle via ODBC?' toc_hidden: true toc_priority: 20 description: 'This page provides guidance on what to do if you have a problem with encodings when using Oracle via ODBC' +doc_type: 'how-to' --- # What if I have a problem with encodings when using Oracle via ODBC? {#oracle-odbc-encodings} diff --git a/docs/faq/operations/delete-old-data.md b/docs/faq/operations/delete-old-data.md index 2db4ff949b4..e8a2a3a4cb8 100644 --- a/docs/faq/operations/delete-old-data.md +++ b/docs/faq/operations/delete-old-data.md @@ -4,6 +4,7 @@ title: 'Is it possible to delete old records from a ClickHouse table?' toc_hidden: true toc_priority: 20 description: 'This page answers the question of whether it is possible to delete old records from a ClickHouse table' +doc_type: 'explanation' --- # Is it possible to delete old records from a ClickHouse table? {#is-it-possible-to-delete-old-records-from-a-clickhouse-table} diff --git a/docs/faq/operations/index.md b/docs/faq/operations/index.md index bd289cac316..c3d48aeaa2f 100644 --- a/docs/faq/operations/index.md +++ b/docs/faq/operations/index.md @@ -4,6 +4,7 @@ sidebar_position: 3 sidebar_label: 'Question about Operating ClickHouse Servers and Clusters' title: 'Question about operating ClickHouse servers and clusters' description: 'Landing page for questions about operating ClickHouse servers and clusters' +doc_type: 'reference' --- # Question about operating ClickHouse servers and clusters diff --git a/docs/faq/operations/multi-region-replication.md b/docs/faq/operations/multi-region-replication.md index f97f1065773..c8ad6a17970 100644 --- a/docs/faq/operations/multi-region-replication.md +++ b/docs/faq/operations/multi-region-replication.md @@ -4,6 +4,7 @@ title: 'Does ClickHouse support multi-region replication?' toc_hidden: true toc_priority: 30 description: 'This page answers whether ClickHouse supports multi-region replication' +doc_type: 'reference' --- # Does ClickHouse support multi-region replication? {#does-clickhouse-support-multi-region-replication} diff --git a/docs/faq/operations/production.md b/docs/faq/operations/production.md index cd06bbe6913..2871f67ddd4 100644 --- a/docs/faq/operations/production.md +++ b/docs/faq/operations/production.md @@ -4,6 +4,7 @@ title: 'Which ClickHouse version to use in production?' toc_hidden: true toc_priority: 10 description: 'This page provides guidance on which ClickHouse version to use in production' +doc_type: 'explanation' --- # Which ClickHouse version to use in production? {#which-clickhouse-version-to-use-in-production} diff --git a/docs/faq/operations/separate_storage.md b/docs/faq/operations/separate_storage.md index be3eae0247e..c029c1f6095 100644 --- a/docs/faq/operations/separate_storage.md +++ b/docs/faq/operations/separate_storage.md @@ -5,6 +5,7 @@ sidebar_label: 'Is it possible to deploy ClickHouse with separate storage and co toc_hidden: true toc_priority: 20 description: 'This page provides an answer as to whether it is possible to deploy ClickHouse with separate storage and compute' +doc_type: 'explanation' --- The short answer is "yes". diff --git a/docs/faq/troubleshooting.md b/docs/faq/troubleshooting.md index 4b1221d7dea..20ea510341b 100644 --- a/docs/faq/troubleshooting.md +++ b/docs/faq/troubleshooting.md @@ -2,6 +2,7 @@ title: 'Troubleshooting' slug: /faq/troubleshooting description: 'How to troubleshoot common ClickHouse Cloud error messages.' +doc_type: 'how-to' --- ## ClickHouse Cloud troubleshooting {#clickhouse-cloud-troubleshooting} diff --git a/docs/faq/use-cases/index.md b/docs/faq/use-cases/index.md index cb8a120cdfc..92ce0d31691 100644 --- a/docs/faq/use-cases/index.md +++ b/docs/faq/use-cases/index.md @@ -4,6 +4,7 @@ sidebar_position: 2 sidebar_label: 'Questions about ClickHouse use cases' title: 'Questions About ClickHouse Use Cases' description: 'Landing page listing common questions about ClickHouse use cases' +doc_type: 'reference' --- # Questions about ClickHouse use cases diff --git a/docs/faq/use-cases/key-value.md b/docs/faq/use-cases/key-value.md index b044eb38ef1..96f12353db5 100644 --- a/docs/faq/use-cases/key-value.md +++ b/docs/faq/use-cases/key-value.md @@ -4,6 +4,7 @@ title: 'Can I use ClickHouse as a key-value storage?' toc_hidden: true toc_priority: 101 description: 'Answers the frequently asked question of whether or not ClickHouse can be used as a key-value storage?' +doc_type: 'explanation' --- # Can I use ClickHouse as a key-value storage? {#can-i-use-clickhouse-as-a-key-value-storage} diff --git a/docs/faq/use-cases/time-series.md b/docs/faq/use-cases/time-series.md index dc62d67c50b..2f4331c453a 100644 --- a/docs/faq/use-cases/time-series.md +++ b/docs/faq/use-cases/time-series.md @@ -4,6 +4,7 @@ title: 'Can I use ClickHouse as a time-series database?' toc_hidden: true toc_priority: 101 description: 'Page describing how to use ClickHouse as a time-series database' +doc_type: 'how-to' --- # Can I use ClickHouse as a time-series database? {#can-i-use-clickhouse-as-a-time-series-database} diff --git a/docs/getting-started/example-datasets/amazon-reviews.md b/docs/getting-started/example-datasets/amazon-reviews.md index 941d4433fb3..63c5d07fcd2 100644 --- a/docs/getting-started/example-datasets/amazon-reviews.md +++ b/docs/getting-started/example-datasets/amazon-reviews.md @@ -3,6 +3,7 @@ description: 'Over 150M customer reviews of Amazon products' sidebar_label: 'Amazon customer reviews' slug: /getting-started/example-datasets/amazon-reviews title: 'Amazon Customer Review' +doc_type: 'how-to' --- This dataset contains over 150M customer reviews of Amazon products. The data is in snappy-compressed Parquet files in AWS S3 that total 49GB in size (compressed). Let's walk through the steps to insert it into ClickHouse. diff --git a/docs/getting-started/example-datasets/amplab-benchmark.md b/docs/getting-started/example-datasets/amplab-benchmark.md index 125ed55e96b..1e48db6e510 100644 --- a/docs/getting-started/example-datasets/amplab-benchmark.md +++ b/docs/getting-started/example-datasets/amplab-benchmark.md @@ -4,6 +4,7 @@ description: 'A benchmark dataset used for comparing the performance of data war sidebar_label: 'AMPLab Big Data Benchmark' slug: /getting-started/example-datasets/amplab-benchmark title: 'AMPLab Big Data Benchmark' +doc_type: 'reference' --- See https://amplab.cs.berkeley.edu/benchmark/ diff --git a/docs/getting-started/example-datasets/brown-benchmark.md b/docs/getting-started/example-datasets/brown-benchmark.md index 8ad45ec5d8a..7a571719043 100644 --- a/docs/getting-started/example-datasets/brown-benchmark.md +++ b/docs/getting-started/example-datasets/brown-benchmark.md @@ -3,6 +3,7 @@ description: 'A new analytical benchmark for machine-generated log data' sidebar_label: 'Brown University Benchmark' slug: /getting-started/example-datasets/brown-benchmark title: 'Brown University Benchmark' +doc_type: 'reference' --- `MgBench` is a new analytical benchmark for machine-generated log data, [Andrew Crotty](http://cs.brown.edu/people/acrotty/). diff --git a/docs/getting-started/example-datasets/cell-towers.md b/docs/getting-started/example-datasets/cell-towers.md index 5626cb4bf89..ffba15921fe 100644 --- a/docs/getting-started/example-datasets/cell-towers.md +++ b/docs/getting-started/example-datasets/cell-towers.md @@ -5,6 +5,7 @@ sidebar_label: 'Geo Data' sidebar_position: 3 slug: /getting-started/example-datasets/cell-towers title: 'Geo Data using the Cell Tower Dataset' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/getting-started/example-datasets/covid19.md b/docs/getting-started/example-datasets/covid19.md index 64e534eff11..12f789d77b1 100644 --- a/docs/getting-started/example-datasets/covid19.md +++ b/docs/getting-started/example-datasets/covid19.md @@ -4,6 +4,7 @@ description: 'COVID-19 Open-Data is a large, open-source database of COVID-19 ep sidebar_label: 'COVID-19 Open-Data' slug: /getting-started/example-datasets/covid19 title: 'COVID-19 Open-Data' +doc_type: 'reference' --- COVID-19 Open-Data attempts to assemble the largest Covid-19 epidemiological database, in addition to a powerful set of expansive covariates. It includes open, publicly sourced, licensed data relating to demographics, economy, epidemiology, geography, health, hospitalizations, mobility, government response, weather, and more. diff --git a/docs/getting-started/example-datasets/criteo.md b/docs/getting-started/example-datasets/criteo.md index db86ae7647f..854a251ae1f 100644 --- a/docs/getting-started/example-datasets/criteo.md +++ b/docs/getting-started/example-datasets/criteo.md @@ -3,6 +3,7 @@ description: 'A terabyte of Click Logs from Criteo' sidebar_label: 'Terabyte Click Logs from Criteo' slug: /getting-started/example-datasets/criteo title: 'Terabyte Click Logs from Criteo' +doc_type: 'reference' --- Download the data from http://labs.criteo.com/downloads/download-terabyte-click-logs/ diff --git a/docs/getting-started/example-datasets/dbpedia.md b/docs/getting-started/example-datasets/dbpedia.md index 9a84f04abc3..db27c6fb874 100644 --- a/docs/getting-started/example-datasets/dbpedia.md +++ b/docs/getting-started/example-datasets/dbpedia.md @@ -4,6 +4,7 @@ sidebar_label: 'dbpedia dataset' slug: /getting-started/example-datasets/dbpedia-dataset title: 'dbpedia dataset' keywords: ['semantic search', 'vector similarity', 'approximate nearest neighbours', 'embeddings'] +doc_type: 'reference' --- The [dbpedia dataset](https://huggingface.co/datasets/Qdrant/dbpedia-entities-openai3-text-embedding-3-large-1536-1M) contains 1 million articles from Wikipedia and their vector embeddings generated using the [text-embedding-3-large](https://platform.openai.com/docs/models/text-embedding-3-large) model from OpenAI. diff --git a/docs/getting-started/example-datasets/environmental-sensors.md b/docs/getting-started/example-datasets/environmental-sensors.md index 136cf65bcfd..e82a8987039 100644 --- a/docs/getting-started/example-datasets/environmental-sensors.md +++ b/docs/getting-started/example-datasets/environmental-sensors.md @@ -4,6 +4,7 @@ description: 'Over 20 billion records of data from Sensor.Community, a contribut sidebar_label: 'Environmental Sensors Data' slug: /getting-started/example-datasets/environmental-sensors title: 'Environmental Sensors Data' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/getting-started/example-datasets/foursquare-os-places.md b/docs/getting-started/example-datasets/foursquare-os-places.md index 026bee817ff..51c48510a4a 100644 --- a/docs/getting-started/example-datasets/foursquare-os-places.md +++ b/docs/getting-started/example-datasets/foursquare-os-places.md @@ -5,6 +5,7 @@ sidebar_label: 'Foursquare places' slug: /getting-started/example-datasets/foursquare-places title: 'Foursquare places' keywords: ['visualizing'] +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/getting-started/example-datasets/github-events.md b/docs/getting-started/example-datasets/github-events.md index 5dca999b883..3255d44c2f5 100644 --- a/docs/getting-started/example-datasets/github-events.md +++ b/docs/getting-started/example-datasets/github-events.md @@ -4,6 +4,7 @@ description: 'Dataset containing all events on GitHub from 2011 to Dec 6 2020, w sidebar_label: 'GitHub Events' slug: /getting-started/example-datasets/github-events title: 'GitHub Events Dataset' +doc_type: 'reference' --- Dataset contains all events on GitHub from 2011 to Dec 6 2020, the size is 3.1 billion records. Download size is 75 GB and it will require up to 200 GB space on disk if stored in a table with lz4 compression. diff --git a/docs/getting-started/example-datasets/github.md b/docs/getting-started/example-datasets/github.md index 6dc66b7f5e9..b7ed259c8d3 100644 --- a/docs/getting-started/example-datasets/github.md +++ b/docs/getting-started/example-datasets/github.md @@ -7,6 +7,7 @@ slug: /getting-started/example-datasets/github title: 'Writing Queries in ClickHouse using GitHub Data' keywords: ['Github'] show_related_blogs: true +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/getting-started/example-datasets/hacker-news.md b/docs/getting-started/example-datasets/hacker-news.md index 0a6a0f6eb45..79da4fa64ba 100644 --- a/docs/getting-started/example-datasets/hacker-news.md +++ b/docs/getting-started/example-datasets/hacker-news.md @@ -3,6 +3,7 @@ description: 'Dataset containing 28 million rows of hacker news data.' sidebar_label: 'Hacker News' slug: /getting-started/example-datasets/hacker-news title: 'Hacker News dataset' +doc_type: 'reference' --- # Hacker News dataset diff --git a/docs/getting-started/example-datasets/laion.md b/docs/getting-started/example-datasets/laion.md index 0da93e5a58a..7d601ab5ecf 100644 --- a/docs/getting-started/example-datasets/laion.md +++ b/docs/getting-started/example-datasets/laion.md @@ -3,6 +3,7 @@ description: 'Dataset containing 400 million images with English image captions' sidebar_label: 'Laion-400M dataset' slug: /getting-started/example-datasets/laion-400m-dataset title: 'Laion-400M dataset' +doc_type: 'reference' --- The [Laion-400M dataset](https://laion.ai/blog/laion-400-open-dataset/) contains 400 million images with English image captions. Laion nowadays provides [an even larger dataset](https://laion.ai/blog/laion-5b/) but working with it will be similar. diff --git a/docs/getting-started/example-datasets/menus.md b/docs/getting-started/example-datasets/menus.md index bace0087323..097cca3fc60 100644 --- a/docs/getting-started/example-datasets/menus.md +++ b/docs/getting-started/example-datasets/menus.md @@ -4,6 +4,7 @@ description: 'Dataset containing 1.3 million records of historical data on the m sidebar_label: 'New York Public Library "What''s on the Menu?" Dataset' slug: /getting-started/example-datasets/menus title: 'New York Public Library "What''s on the Menu?" Dataset' +doc_type: 'reference' --- The dataset is created by the New York Public Library. It contains historical data on the menus of hotels, restaurants and cafes with the dishes along with their prices. diff --git a/docs/getting-started/example-datasets/metrica.md b/docs/getting-started/example-datasets/metrica.md index b06074140bd..0dd597c96ed 100644 --- a/docs/getting-started/example-datasets/metrica.md +++ b/docs/getting-started/example-datasets/metrica.md @@ -4,6 +4,7 @@ description: 'Dataset consisting of two tables containing anonymized web analyti sidebar_label: 'Web Analytics Data' slug: /getting-started/example-datasets/metrica title: 'Anonymized Web Analytics' +doc_type: 'reference' --- # Anonymized web analytics data diff --git a/docs/getting-started/example-datasets/noaa.md b/docs/getting-started/example-datasets/noaa.md index 5c14cb1110a..e196861f49a 100644 --- a/docs/getting-started/example-datasets/noaa.md +++ b/docs/getting-started/example-datasets/noaa.md @@ -4,6 +4,7 @@ sidebar_label: 'NOAA Global Historical Climatology Network ' sidebar_position: 1 slug: /getting-started/example-datasets/noaa title: 'NOAA Global Historical Climatology Network' +doc_type: 'reference' --- This dataset contains weather measurements for the last 120 years. Each row is a measurement for a point in time and station. diff --git a/docs/getting-started/example-datasets/nyc-taxi.md b/docs/getting-started/example-datasets/nyc-taxi.md index 43a2c8eea63..4cf51c0e02e 100644 --- a/docs/getting-started/example-datasets/nyc-taxi.md +++ b/docs/getting-started/example-datasets/nyc-taxi.md @@ -5,6 +5,7 @@ sidebar_label: 'New York Taxi Data' sidebar_position: 2 slug: /getting-started/example-datasets/nyc-taxi title: 'New York Taxi Data' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/getting-started/example-datasets/nypd_complaint_data.md b/docs/getting-started/example-datasets/nypd_complaint_data.md index d53fb4ffac2..3d0e5669d23 100644 --- a/docs/getting-started/example-datasets/nypd_complaint_data.md +++ b/docs/getting-started/example-datasets/nypd_complaint_data.md @@ -3,6 +3,7 @@ description: 'Ingest and query Tab Separated Value data in 5 steps' sidebar_label: 'NYPD Complaint Data' slug: /getting-started/example-datasets/nypd_complaint_data title: 'NYPD Complaint Data' +doc_type: 'tutorial' --- Tab separated value, or TSV, files are common and may include field headings as the first line of the file. ClickHouse can ingest TSVs, and also can query TSVs without ingesting the files. This guide covers both of these cases. If you need to query or ingest CSV files, the same techniques work, simply substitute `TSV` with `CSV` in your format arguments. diff --git a/docs/getting-started/example-datasets/ontime.md b/docs/getting-started/example-datasets/ontime.md index add5a46654a..a1bccee21e9 100644 --- a/docs/getting-started/example-datasets/ontime.md +++ b/docs/getting-started/example-datasets/ontime.md @@ -3,6 +3,7 @@ description: 'Dataset containing the on-time performance of airline flights' sidebar_label: 'OnTime Airline Flight Data' slug: /getting-started/example-datasets/ontime title: 'OnTime' +doc_type: 'reference' --- This dataset contains data from Bureau of Transportation Statistics. diff --git a/docs/getting-started/example-datasets/stackoverflow.md b/docs/getting-started/example-datasets/stackoverflow.md index 1f56e4bfd8c..50d441c4b0e 100644 --- a/docs/getting-started/example-datasets/stackoverflow.md +++ b/docs/getting-started/example-datasets/stackoverflow.md @@ -6,6 +6,7 @@ slug: /getting-started/example-datasets/stackoverflow title: 'Analyzing Stack Overflow data with ClickHouse' keywords: ['StackOverflow'] show_related_blogs: true +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/getting-started/example-datasets/star-schema.md b/docs/getting-started/example-datasets/star-schema.md index d4080a073e8..1aab602659d 100644 --- a/docs/getting-started/example-datasets/star-schema.md +++ b/docs/getting-started/example-datasets/star-schema.md @@ -3,6 +3,7 @@ description: 'The Star Schema Benchmark (SSB) data set and queries' sidebar_label: 'Star Schema Benchmark' slug: /getting-started/example-datasets/star-schema title: 'Star Schema Benchmark (SSB, 2009)' +doc_type: 'reference' --- The Star Schema Benchmark is roughly based on the [TPC-H](tpch.md)'s tables and queries but unlike TPC-H, it uses a star schema layout. diff --git a/docs/getting-started/example-datasets/tpcds.md b/docs/getting-started/example-datasets/tpcds.md index 4577d94e5cd..4ef674d8e5e 100644 --- a/docs/getting-started/example-datasets/tpcds.md +++ b/docs/getting-started/example-datasets/tpcds.md @@ -3,6 +3,7 @@ description: 'The TPC-DS benchmark data set and queries.' sidebar_label: 'TPC-DS' slug: /getting-started/example-datasets/tpcds title: 'TPC-DS (2012)' +doc_type: 'explanation' --- Similar to the [Star Schema Benchmark (SSB)](star-schema.md), TPC-DS is based on [TPC-H](tpch.md), but it took the opposite route, i.e. it expanded the number of joins needed by storing the data in a complex snowflake schema (24 instead of 8 tables). diff --git a/docs/getting-started/example-datasets/tpch.md b/docs/getting-started/example-datasets/tpch.md index 99090b31e73..1fb0da2dcaf 100644 --- a/docs/getting-started/example-datasets/tpch.md +++ b/docs/getting-started/example-datasets/tpch.md @@ -3,6 +3,7 @@ description: 'The TPC-H benchmark data set and queries.' sidebar_label: 'TPC-H' slug: /getting-started/example-datasets/tpch title: 'TPC-H (1999)' +doc_type: 'reference' --- A popular benchmark which models the internal data warehouse of a wholesale supplier. diff --git a/docs/getting-started/example-datasets/tw-weather.md b/docs/getting-started/example-datasets/tw-weather.md index b5d969681bc..ad91d91c803 100644 --- a/docs/getting-started/example-datasets/tw-weather.md +++ b/docs/getting-started/example-datasets/tw-weather.md @@ -4,6 +4,7 @@ sidebar_label: 'Taiwan Historical Weather Datasets' sidebar_position: 1 slug: /getting-started/example-datasets/tw-weather title: 'Taiwan Historical Weather Datasets' +doc_type: 'reference' --- This dataset contains historical meteorological observations measurements for the last 128 years. Each row is a measurement for a point in date time and weather station. diff --git a/docs/getting-started/example-datasets/uk-price-paid.md b/docs/getting-started/example-datasets/uk-price-paid.md index 21623fd8fa1..bf238148c6c 100644 --- a/docs/getting-started/example-datasets/uk-price-paid.md +++ b/docs/getting-started/example-datasets/uk-price-paid.md @@ -6,6 +6,7 @@ sidebar_label: 'UK Property Prices' sidebar_position: 1 slug: /getting-started/example-datasets/uk-price-paid title: 'The UK property prices dataset' +doc_type: 'tutorial' --- This data contains prices paid for real-estate property in England and Wales. The data is available since 1995, and the size of the dataset in uncompressed form is about 4 GiB (which will only take about 278 MiB in ClickHouse). diff --git a/docs/getting-started/example-datasets/wikistat.md b/docs/getting-started/example-datasets/wikistat.md index f13fe397cb7..0f17507e39f 100644 --- a/docs/getting-started/example-datasets/wikistat.md +++ b/docs/getting-started/example-datasets/wikistat.md @@ -3,6 +3,7 @@ description: 'Explore the WikiStat dataset containing 0.5 trillion records.' sidebar_label: 'WikiStat' slug: /getting-started/example-datasets/wikistat title: 'WikiStat' +doc_type: 'reference' --- The dataset contains 0.5 trillion records. diff --git a/docs/getting-started/example-datasets/youtube-dislikes.md b/docs/getting-started/example-datasets/youtube-dislikes.md index eb78ab7b9be..14b1a5b029c 100644 --- a/docs/getting-started/example-datasets/youtube-dislikes.md +++ b/docs/getting-started/example-datasets/youtube-dislikes.md @@ -3,6 +3,7 @@ description: 'A collection is dislikes of YouTube videos.' sidebar_label: 'YouTube Dislikes' slug: /getting-started/example-datasets/youtube-dislikes title: 'YouTube dataset of dislikes' +doc_type: 'reference' --- In November of 2021, YouTube removed the public ***dislike*** count from all of its videos. While creators can still see the number of dislikes, viewers can only see how many ***likes*** a video has received. diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md index ca8b2ee1c18..c8f311e4a48 100644 --- a/docs/getting-started/index.md +++ b/docs/getting-started/index.md @@ -6,6 +6,7 @@ sidebar_label: 'Overview' sidebar_position: 0 slug: /getting-started/example-datasets/ title: 'Tutorials and Example Datasets' +doc_type: 'reference' --- # Tutorials and example datasets @@ -23,4 +24,33 @@ functions in ClickHouse. The sample datasets include: by https://github.com/ClickHouse/clickhouse-docs/blob/main/scripts/autogenerate-table-of-contents.sh --> +| Page | Description | +|-----|-----| +| [Taiwan Historical Weather Datasets](/getting-started/example-datasets/tw-weather) | 131 million rows of weather observation data for the last 128 yrs | +| [Analyzing Stack Overflow data with ClickHouse](/getting-started/example-datasets/stackoverflow) | Analyzing Stack Overflow data with ClickHouse | +| [NOAA Global Historical Climatology Network](/getting-started/example-datasets/noaa) | 2.5 billion rows of climate data for the last 120 yrs | +| [The UK property prices dataset](/getting-started/example-datasets/uk-price-paid) | Learn how to use projections to improve the performance of queries that you run frequently using the UK property dataset, which contains data about prices paid for real-estate property in England and Wales | +| [Writing Queries in ClickHouse using GitHub Data](/getting-started/example-datasets/github) | Dataset containing all of the commits and changes for the ClickHouse repository | +| [New York Taxi Data](/getting-started/example-datasets/nyc-taxi) | Data for billions of taxi and for-hire vehicle (Uber, Lyft, etc.) trips originating in New York City since 2009 | +| [Geo Data using the Cell Tower Dataset](/getting-started/example-datasets/cell-towers) | Learn how to load OpenCelliD data into ClickHouse, connect Apache Superset to ClickHouse and build a dashboard based on data | +| [Amazon Customer Review](/getting-started/example-datasets/amazon-reviews) | Over 150M customer reviews of Amazon products | +| [AMPLab Big Data Benchmark](/getting-started/example-datasets/amplab-benchmark) | A benchmark dataset used for comparing the performance of data warehousing solutions. | +| [Anonymized Web Analytics](/getting-started/example-datasets/metrica) | Dataset consisting of two tables containing anonymized web analytics data with hits and visits | +| [Brown University Benchmark](/getting-started/example-datasets/brown-benchmark) | A new analytical benchmark for machine-generated log data | +| [COVID-19 Open-Data](/getting-started/example-datasets/covid19) | COVID-19 Open-Data is a large, open-source database of COVID-19 epidemiological data and related factors like demographics, economics, and government responses | +| [dbpedia dataset](/getting-started/example-datasets/dbpedia-dataset) | Dataset containing 1 million articles from Wikipedia and their vector embeddings | +| [Environmental Sensors Data](/getting-started/example-datasets/environmental-sensors) | Over 20 billion records of data from Sensor.Community, a contributors-driven global sensor network that creates Open Environmental Data. | +| [Foursquare places](/getting-started/example-datasets/foursquare-places) | Dataset with over 100 million records containing information about places on a map, such as shops, restaurants, parks, playgrounds, and monuments. | +| [GitHub Events Dataset](/getting-started/example-datasets/github-events) | Dataset containing all events on GitHub from 2011 to Dec 6 2020, with a size of 3.1 billion records. | +| [Hacker News dataset](/getting-started/example-datasets/hacker-news) | Dataset containing 28 million rows of hacker news data. | +| [Laion-400M dataset](/getting-started/example-datasets/laion-400m-dataset) | Dataset containing 400 million images with English image captions | +| [New York Public Library "What's on the Menu?" Dataset](/getting-started/example-datasets/menus) | Dataset containing 1.3 million records of historical data on the menus of hotels, restaurants and cafes with the dishes along with their prices. | +| [NYPD Complaint Data](/getting-started/example-datasets/nypd_complaint_data) | Ingest and query Tab Separated Value data in 5 steps | +| [OnTime](/getting-started/example-datasets/ontime) | Dataset containing the on-time performance of airline flights | +| [Star Schema Benchmark (SSB, 2009)](/getting-started/example-datasets/star-schema) | The Star Schema Benchmark (SSB) data set and queries | +| [Terabyte Click Logs from Criteo](/getting-started/example-datasets/criteo) | A terabyte of Click Logs from Criteo | +| [TPC-DS (2012)](/getting-started/example-datasets/tpcds) | The TPC-DS benchmark data set and queries. | +| [TPC-H (1999)](/getting-started/example-datasets/tpch) | The TPC-H benchmark data set and queries. | +| [WikiStat](/getting-started/example-datasets/wikistat) | Explore the WikiStat dataset containing 0.5 trillion records. | +| [YouTube dataset of dislikes](/getting-started/example-datasets/youtube-dislikes) | A collection is dislikes of YouTube videos. | diff --git a/docs/getting-started/install/advanced.md b/docs/getting-started/install/advanced.md index 7f3d7953a62..9cd1b50e6e4 100644 --- a/docs/getting-started/install/advanced.md +++ b/docs/getting-started/install/advanced.md @@ -5,6 +5,7 @@ sidebar_label: 'Advanced install' slug: /install/advanced title: 'Advanced installation methods' hide_title: false +doc_type: 'how-to' --- ## Compile from source {#compile-from-source} diff --git a/docs/getting-started/install/debian_ubuntu.md b/docs/getting-started/install/debian_ubuntu.md index 7c579ac8ffd..aef54f1d6fa 100644 --- a/docs/getting-started/install/debian_ubuntu.md +++ b/docs/getting-started/install/debian_ubuntu.md @@ -5,6 +5,7 @@ sidebar_label: 'Debian/Ubuntu' slug: /install/debian_ubuntu title: 'Install ClickHouse on Debian/Ubuntu' hide_title: true +doc_type: 'how-to' --- import DebianProd from './_snippets/_deb_install.md' diff --git a/docs/getting-started/install/docker.md b/docs/getting-started/install/docker.md index 098831005b0..eec8c731520 100644 --- a/docs/getting-started/install/docker.md +++ b/docs/getting-started/install/docker.md @@ -5,6 +5,7 @@ sidebar_label: 'Docker' slug: /install/docker title: 'Install ClickHouse using Docker' hide_title: true +doc_type: 'how-to' --- import Docker from './_snippets/_docker.md' diff --git a/docs/getting-started/install/macos.md b/docs/getting-started/install/macos.md index 47fc7326738..8656f776eab 100644 --- a/docs/getting-started/install/macos.md +++ b/docs/getting-started/install/macos.md @@ -5,6 +5,7 @@ sidebar_label: 'MacOS' slug: /install/macOS title: 'Install ClickHouse using Homebrew' hide_title: true +doc_type: 'how-to' --- import MacOSProd from './_snippets/_macos.md' diff --git a/docs/getting-started/install/other_linux.md b/docs/getting-started/install/other_linux.md index 79415aa3b86..39391ac551c 100644 --- a/docs/getting-started/install/other_linux.md +++ b/docs/getting-started/install/other_linux.md @@ -5,6 +5,7 @@ sidebar_label: 'Other Linux' slug: /install/linux_other title: 'Install ClickHouse using tgz archives' hide_title: true +doc_type: 'how-to' --- import Tar from './_snippets/_linux_tar_install.md' diff --git a/docs/getting-started/install/quick-install-curl.md b/docs/getting-started/install/quick-install-curl.md index 1338ea87f96..819378e5e75 100644 --- a/docs/getting-started/install/quick-install-curl.md +++ b/docs/getting-started/install/quick-install-curl.md @@ -5,6 +5,7 @@ sidebar_label: 'Quick install' slug: /install/quick-install-curl title: 'Install ClickHouse via script using curl' hide_title: true +doc_type: 'how-to' --- import QuickInstall from './_snippets/_quick_install.md' diff --git a/docs/getting-started/install/redhat.md b/docs/getting-started/install/redhat.md index 30d49ab8200..228715c860d 100644 --- a/docs/getting-started/install/redhat.md +++ b/docs/getting-started/install/redhat.md @@ -5,6 +5,7 @@ sidebar_label: 'Redhat/CentOS' slug: /install/redhat title: 'Install ClickHouse on rpm-based Linux distributions' hide_title: true +doc_type: 'how-to' --- import RPM from './_snippets/_rpm_install.md' diff --git a/docs/getting-started/install/windows.md b/docs/getting-started/install/windows.md index e81fe7b88d9..776e7a81c4d 100644 --- a/docs/getting-started/install/windows.md +++ b/docs/getting-started/install/windows.md @@ -5,6 +5,7 @@ sidebar_label: 'Windows' slug: /install/windows title: 'Install ClickHouse on Windows with WSL' hide_title: true +doc_type: 'how-to' --- import Windows from './_snippets/_windows_install.md' diff --git a/docs/getting-started/playground.md b/docs/getting-started/playground.md index 90371035308..d1c57503eb8 100644 --- a/docs/getting-started/playground.md +++ b/docs/getting-started/playground.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'playground', 'getting', 'started', 'docs'] sidebar_label: 'ClickHouse Playground' slug: /getting-started/playground title: 'ClickHouse Playground' +doc_type: 'reference' --- # ClickHouse playground diff --git a/docs/guides/best-practices/asyncinserts.md b/docs/guides/best-practices/asyncinserts.md index 49c33ecb515..23ead27a915 100644 --- a/docs/guides/best-practices/asyncinserts.md +++ b/docs/guides/best-practices/asyncinserts.md @@ -3,6 +3,7 @@ slug: /optimize/asynchronous-inserts sidebar_label: 'Asynchronous Inserts' title: 'Asynchronous Inserts (async_insert)' description: 'Use asynchronous inserts as an alternative to batching data.' +doc_type: 'how-to' --- import Content from '@site/docs/best-practices/_snippets/_async_inserts.md'; diff --git a/docs/guides/best-practices/avoidmutations.md b/docs/guides/best-practices/avoidmutations.md index c9a2af3a42f..76bfba32e3d 100644 --- a/docs/guides/best-practices/avoidmutations.md +++ b/docs/guides/best-practices/avoidmutations.md @@ -3,6 +3,7 @@ slug: /optimize/avoid-mutations sidebar_label: 'Avoid Mutations' title: 'Avoid Mutations' description: 'Mutations refers to ALTER queries that manipulate table data' +doc_type: 'how-to' --- import Content from '@site/docs/best-practices/_snippets/_avoid_mutations.md'; diff --git a/docs/guides/best-practices/avoidnullablecolumns.md b/docs/guides/best-practices/avoidnullablecolumns.md index b7666559481..36349d32c0a 100644 --- a/docs/guides/best-practices/avoidnullablecolumns.md +++ b/docs/guides/best-practices/avoidnullablecolumns.md @@ -3,6 +3,7 @@ slug: /optimize/avoid-nullable-columns sidebar_label: 'Avoid nullable Columns' title: 'Avoid nullable Columns' description: 'Why Nullable Columns should be avoided in ClickHouse' +doc_type: 'how-to' --- import Content from '@site/docs/best-practices/_snippets/_avoid_nullable_columns.md'; diff --git a/docs/guides/best-practices/avoidoptimizefinal.md b/docs/guides/best-practices/avoidoptimizefinal.md index 55529f979aa..77c180a0b26 100644 --- a/docs/guides/best-practices/avoidoptimizefinal.md +++ b/docs/guides/best-practices/avoidoptimizefinal.md @@ -3,6 +3,7 @@ slug: /optimize/avoidoptimizefinal sidebar_label: 'Avoid Optimize Final' title: 'Avoid Optimize Final' description: 'Using the OPTIMIZE TABLE ... FINAL query will initiate an unscheduled merge of data parts.' +doc_type: 'how-to' --- import Content from '@site/docs/best-practices/_snippets/_avoid_optimize_final.md'; diff --git a/docs/guides/best-practices/bulkinserts.md b/docs/guides/best-practices/bulkinserts.md index d9b5ec1d45d..0ceb26a5533 100644 --- a/docs/guides/best-practices/bulkinserts.md +++ b/docs/guides/best-practices/bulkinserts.md @@ -3,6 +3,7 @@ slug: /optimize/bulk-inserts sidebar_label: 'Bulk Inserts' title: 'Bulk Inserts' description: 'Sending a smaller amount of inserts that each contain more data will reduce the number of writes required.' +doc_type: 'how-to' --- import Content from '@site/docs/best-practices/_snippets/_bulk_inserts.md'; diff --git a/docs/guides/best-practices/index.md b/docs/guides/best-practices/index.md index 0c52281492f..cfe8396b678 100644 --- a/docs/guides/best-practices/index.md +++ b/docs/guides/best-practices/index.md @@ -3,6 +3,7 @@ slug: /operations/overview sidebar_label: 'Performance and Optimizations Overview' description: 'Overview page of Performance and Optimizations' title: 'Performance and Optimizations' +doc_type: 'reference' --- # Performance and optimizations diff --git a/docs/guides/best-practices/partitioningkey.md b/docs/guides/best-practices/partitioningkey.md index a41fa1bf3eb..0462f255c8f 100644 --- a/docs/guides/best-practices/partitioningkey.md +++ b/docs/guides/best-practices/partitioningkey.md @@ -3,6 +3,7 @@ slug: /optimize/partitioning-key sidebar_label: 'Partitioning Key' title: 'Choose a Low Cardinality Partitioning Key' description: 'Use a low cardinality partitioning key or avoid using any partitioning key for your table.' +doc_type: 'how-to' --- import Content from '@site/docs/best-practices/partitioning_keys.mdx'; diff --git a/docs/guides/best-practices/prewhere.md b/docs/guides/best-practices/prewhere.md index b334687c133..6f39c102fc2 100644 --- a/docs/guides/best-practices/prewhere.md +++ b/docs/guides/best-practices/prewhere.md @@ -4,6 +4,7 @@ sidebar_label: 'PREWHERE Optimization' sidebar_position: 21 description: 'PREWHERE reduces I/O by avoiding reading unnecessary column data.' title: 'How does the PREWHERE optimization work?' +doc_type: 'how-to' --- import visual01 from '@site/static/images/guides/best-practices/prewhere_01.gif'; diff --git a/docs/guides/best-practices/query-optimization.md b/docs/guides/best-practices/query-optimization.md index fe044138603..eed8383684f 100644 --- a/docs/guides/best-practices/query-optimization.md +++ b/docs/guides/best-practices/query-optimization.md @@ -3,6 +3,7 @@ slug: /optimize/query-optimization sidebar_label: 'Query optimization' title: 'Guide for Query optimization' description: 'A simple guide for query optimization that describe common path to improve query performance' +doc_type: 'how-to' --- import queryOptimizationDiagram1 from '@site/static/images/guides/best-practices/query_optimization_diagram_1.png'; diff --git a/docs/guides/best-practices/query-parallelism.md b/docs/guides/best-practices/query-parallelism.md index 81aa7776915..dea1323d9f9 100644 --- a/docs/guides/best-practices/query-parallelism.md +++ b/docs/guides/best-practices/query-parallelism.md @@ -4,6 +4,7 @@ sidebar_label: 'Query Parallelism' sidebar_position: 20 description: 'ClickHouse parallelizes query execution using processing lanes and the max_threads setting.' title: 'How ClickHouse executes a query in parallel' +doc_type: 'how-to' --- import visual01 from '@site/static/images/guides/best-practices/query-parallelism_01.gif'; diff --git a/docs/guides/best-practices/skipping-indexes.md b/docs/guides/best-practices/skipping-indexes.md index d2488ab8ab0..7228d2d9ff5 100644 --- a/docs/guides/best-practices/skipping-indexes.md +++ b/docs/guides/best-practices/skipping-indexes.md @@ -4,6 +4,7 @@ sidebar_label: 'Data Skipping Indexes' sidebar_position: 2 description: 'Skip indexes enable ClickHouse to skip reading significant chunks of data that are guaranteed to have no matching values.' title: 'Understanding ClickHouse Data Skipping Indexes' +doc_type: 'explanation' --- import simple_skip from '@site/static/images/guides/best-practices/simple_skip.png'; diff --git a/docs/guides/best-practices/sparse-primary-indexes.md b/docs/guides/best-practices/sparse-primary-indexes.md index bac5455453e..76074f8204b 100644 --- a/docs/guides/best-practices/sparse-primary-indexes.md +++ b/docs/guides/best-practices/sparse-primary-indexes.md @@ -5,6 +5,7 @@ description: 'In this guide we are going to do a deep dive into ClickHouse index title: 'A Practical Introduction to Primary Indexes in ClickHouse' slug: /guides/best-practices/sparse-primary-indexes show_related_blogs: true +doc_type: 'how-to' --- import sparsePrimaryIndexes01 from '@site/static/images/guides/best-practices/sparse-primary-indexes-01.png'; diff --git a/docs/guides/creating-tables.md b/docs/guides/creating-tables.md index fe1ecf915df..d8cf28f214b 100644 --- a/docs/guides/creating-tables.md +++ b/docs/guides/creating-tables.md @@ -4,6 +4,7 @@ sidebar_label: 'Creating tables' title: 'Creating tables in ClickHouse' slug: /guides/creating-tables description: 'Learn about Creating Tables in ClickHouse' +doc_type: 'tutorial' --- # Creating tables in ClickHouse diff --git a/docs/guides/developer/alternative-query-languages.md b/docs/guides/developer/alternative-query-languages.md index 7e62fdc8a14..06e7dc12789 100644 --- a/docs/guides/developer/alternative-query-languages.md +++ b/docs/guides/developer/alternative-query-languages.md @@ -3,6 +3,7 @@ slug: /guides/developer/alternative-query-languages sidebar_label: 'Alternative Query Languages' title: 'Alternative Query Languages' description: 'Use alternative query languages in ClickHouse' +doc_type: 'reference' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/guides/developer/cascading-materialized-views.md b/docs/guides/developer/cascading-materialized-views.md index 83c4828a4e5..efd147aae52 100644 --- a/docs/guides/developer/cascading-materialized-views.md +++ b/docs/guides/developer/cascading-materialized-views.md @@ -3,6 +3,7 @@ slug: /guides/developer/cascading-materialized-views title: 'Cascading Materialized Views' description: 'How to use multiple materialized views from a source table.' keywords: ['materialized view', 'aggregation'] +doc_type: 'tutorial' --- # Cascading materialized views diff --git a/docs/guides/developer/debugging-memory-issues.md b/docs/guides/developer/debugging-memory-issues.md index 44b0191a4af..6ec1fe1bee2 100644 --- a/docs/guides/developer/debugging-memory-issues.md +++ b/docs/guides/developer/debugging-memory-issues.md @@ -5,6 +5,7 @@ sidebar_position: 1 description: 'Queries to help you debug memory issues.' keywords: ['memory issues'] title: 'Debugging memory issues' +doc_type: 'reference' --- # Debugging memory issues {#debugging-memory-issues} diff --git a/docs/guides/developer/deduplicating-inserts-on-retries.md b/docs/guides/developer/deduplicating-inserts-on-retries.md index 12646387a58..72a071f4fb7 100644 --- a/docs/guides/developer/deduplicating-inserts-on-retries.md +++ b/docs/guides/developer/deduplicating-inserts-on-retries.md @@ -3,6 +3,7 @@ slug: /guides/developer/deduplicating-inserts-on-retries title: 'Deduplicating Inserts on Retries' description: 'Preventing duplicate data when retrying insert operations' keywords: ['deduplication', 'deduplicate', 'insert retries', 'inserts'] +doc_type: 'how-to' --- Insert operations can sometimes fail due to errors such as timeouts. When inserts fail, data may or may not have been successfully inserted. This guide covers how to enable deduplication on insert retries such that the same data does not get inserted more than once. diff --git a/docs/guides/developer/deduplication.md b/docs/guides/developer/deduplication.md index f7e6057cb84..d071aee0eb9 100644 --- a/docs/guides/developer/deduplication.md +++ b/docs/guides/developer/deduplication.md @@ -4,6 +4,7 @@ sidebar_label: 'Deduplication Strategies' sidebar_position: 3 description: 'Use deduplication when you need to perform frequent upserts, updates and deletes.' title: 'Deduplication Strategies' +doc_type: 'how-to' --- import deduplication from '@site/static/images/guides/developer/de_duplication.png'; diff --git a/docs/guides/developer/dynamic-column-selection.md b/docs/guides/developer/dynamic-column-selection.md index 39594767137..ceec9dcb05d 100644 --- a/docs/guides/developer/dynamic-column-selection.md +++ b/docs/guides/developer/dynamic-column-selection.md @@ -3,6 +3,7 @@ slug: /guides/developer/dynamic-column-selection sidebar_label: 'Dynamic column selection' title: 'Dynamic column selection' description: 'Use alternative query languages in ClickHouse' +doc_type: 'tutorial' --- [Dynamic column selection](/docs/sql-reference/statements/select#dynamic-column-selection) is a powerful but underutilized ClickHouse feature that allows you to select columns using regular expressions instead of naming each column individually. You can also apply functions to matching columns using the [`APPLY`](/sql-reference/statements/select#apply) modifier, making it incredibly useful for data analysis and transformation tasks. diff --git a/docs/guides/developer/index.md b/docs/guides/developer/index.md index aad644e8cda..caa2b6c2d45 100644 --- a/docs/guides/developer/index.md +++ b/docs/guides/developer/index.md @@ -3,6 +3,7 @@ slug: /guides/developer/overview sidebar_label: 'Advanced Guides Overview' description: 'Overview of the advanced guides' title: 'Advanced Guides' +doc_type: 'reference' --- # Advanced guides diff --git a/docs/guides/developer/lightweight-delete.md b/docs/guides/developer/lightweight-delete.md index bf7a6bff220..70f1d010ca7 100644 --- a/docs/guides/developer/lightweight-delete.md +++ b/docs/guides/developer/lightweight-delete.md @@ -3,6 +3,7 @@ slug: /guides/developer/lightweight-delete title: 'Lightweight Delete' keywords: ['lightweight delete'] description: 'Provides an overview of lightweight deletes in ClickHouse' +doc_type: 'reference' --- import Content from '@site/docs/sql-reference/statements/delete.md'; diff --git a/docs/guides/developer/merge-table-function.md b/docs/guides/developer/merge-table-function.md index d6e1208acfe..dc2f0e3ec19 100644 --- a/docs/guides/developer/merge-table-function.md +++ b/docs/guides/developer/merge-table-function.md @@ -3,6 +3,7 @@ slug: /guides/developer/merge-table-function sidebar_label: 'Merge table function' title: 'Merge table function' description: 'Query multiple tables at the same time.' +doc_type: 'reference' --- The [merge table function](https://clickhouse.com/docs/sql-reference/table-functions/merge) lets us query multiple tables in parallel. diff --git a/docs/guides/developer/mutations.md b/docs/guides/developer/mutations.md index 1cd4c4fd9dc..e89027e6191 100644 --- a/docs/guides/developer/mutations.md +++ b/docs/guides/developer/mutations.md @@ -6,6 +6,7 @@ keywords: ['UPDATE', 'DELETE', 'mutations'] title: 'Updating and deleting ClickHouse data' description: 'Describes how to perform update and delete operations in ClickHouse' show_related_blogs: false +doc_type: 'how-to' --- # Updating and deleting ClickHouse data with mutations diff --git a/docs/guides/developer/on-fly-mutations.md b/docs/guides/developer/on-fly-mutations.md index fe42d48bcd4..3f62e5fb25c 100644 --- a/docs/guides/developer/on-fly-mutations.md +++ b/docs/guides/developer/on-fly-mutations.md @@ -4,6 +4,7 @@ sidebar_label: 'On-the-fly mutation' title: 'On-the-fly Mutations' keywords: ['On-the-fly mutation'] description: 'Provides a description of on-the-fly mutations' +doc_type: 'explanation' --- ## On-the-fly mutations {#on-the-fly-mutations} diff --git a/docs/guides/developer/replacing-merge-tree.md b/docs/guides/developer/replacing-merge-tree.md index aa71858f6f6..c0dfbec1520 100644 --- a/docs/guides/developer/replacing-merge-tree.md +++ b/docs/guides/developer/replacing-merge-tree.md @@ -3,6 +3,7 @@ slug: /guides/replacing-merge-tree title: 'ReplacingMergeTree' description: 'Using the ReplacingMergeTree engine in ClickHouse' keywords: ['replacingmergetree', 'inserts', 'deduplication'] +doc_type: 'explanation' --- import postgres_replacingmergetree from '@site/static/images/migrations/postgres-replacingmergetree.png'; diff --git a/docs/guides/developer/time-series-filling-gaps.md b/docs/guides/developer/time-series-filling-gaps.md index a1aa33c938b..4a07c6e553e 100644 --- a/docs/guides/developer/time-series-filling-gaps.md +++ b/docs/guides/developer/time-series-filling-gaps.md @@ -5,6 +5,7 @@ sidebar_position: 10 description: 'Filling gaps in time-series data.' keywords: ['time series', 'gap fill'] title: 'Filling gaps in time-series data' +doc_type: 'how-to' --- # Filling gaps in time-series data diff --git a/docs/guides/developer/ttl.md b/docs/guides/developer/ttl.md index 49361a6c6cc..448f7d91a29 100644 --- a/docs/guides/developer/ttl.md +++ b/docs/guides/developer/ttl.md @@ -6,6 +6,7 @@ keywords: ['ttl', 'time to live', 'clickhouse', 'old', 'data'] description: 'TTL (time-to-live) refers to the capability of having rows or columns moved, deleted, or rolled up after a certain interval of time has passed.' title: 'Manage Data with TTL (Time-to-live)' show_related_blogs: true +doc_type: 'reference' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/guides/developer/understanding-query-execution-with-the-analyzer.md b/docs/guides/developer/understanding-query-execution-with-the-analyzer.md index 07b70028b3e..4025b4b2650 100644 --- a/docs/guides/developer/understanding-query-execution-with-the-analyzer.md +++ b/docs/guides/developer/understanding-query-execution-with-the-analyzer.md @@ -3,6 +3,7 @@ slug: /guides/developer/understanding-query-execution-with-the-analyzer sidebar_label: 'Understanding Query Execution with the Analyzer' title: 'Understanding Query Execution with the Analyzer' description: 'Describes how you can use the analyzer to understand how ClickHouse executes your queries' +doc_type: 'explanation' --- import analyzer1 from '@site/static/images/guides/developer/analyzer1.png'; diff --git a/docs/guides/examples/aggregate_function_combinators/anyIf.md b/docs/guides/examples/aggregate_function_combinators/anyIf.md index a0368717512..b04e25b3146 100644 --- a/docs/guides/examples/aggregate_function_combinators/anyIf.md +++ b/docs/guides/examples/aggregate_function_combinators/anyIf.md @@ -4,6 +4,7 @@ title: 'anyIf' description: 'Example of using the anyIf combinator' keywords: ['any', 'if', 'combinator', 'examples', 'anyIf'] sidebar_label: 'anyIf' +doc_type: 'how-to' --- # anyIf {#avgif} diff --git a/docs/guides/examples/aggregate_function_combinators/argMaxIf.md b/docs/guides/examples/aggregate_function_combinators/argMaxIf.md index f3ebb5dc512..bfa860a8680 100644 --- a/docs/guides/examples/aggregate_function_combinators/argMaxIf.md +++ b/docs/guides/examples/aggregate_function_combinators/argMaxIf.md @@ -4,6 +4,7 @@ title: 'argMaxIf' description: 'Example of using the argMaxIf combinator' keywords: ['argMax', 'if', 'combinator', 'examples', 'argMaxIf'] sidebar_label: 'argMaxIf' +doc_type: 'reference' --- # argMaxIf {#argmaxif} diff --git a/docs/guides/examples/aggregate_function_combinators/argMinIf.md b/docs/guides/examples/aggregate_function_combinators/argMinIf.md index 9fd236e7ac7..35197ba5297 100644 --- a/docs/guides/examples/aggregate_function_combinators/argMinIf.md +++ b/docs/guides/examples/aggregate_function_combinators/argMinIf.md @@ -4,6 +4,7 @@ title: 'argMinIf' description: 'Example of using the argMinIf combinator' keywords: ['argMin', 'if', 'combinator', 'examples', 'argMinIf'] sidebar_label: 'argMinIf' +doc_type: 'reference' --- # argMinIf {#argminif} diff --git a/docs/guides/examples/aggregate_function_combinators/avgIf.md b/docs/guides/examples/aggregate_function_combinators/avgIf.md index a77130bef53..e82d93877d1 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgIf.md +++ b/docs/guides/examples/aggregate_function_combinators/avgIf.md @@ -4,6 +4,7 @@ title: 'avgIf' description: 'Example of using the avgIf combinator' keywords: ['avg', 'if', 'combinator', 'examples', 'avgIf'] sidebar_label: 'avgIf' +doc_type: 'how-to' --- # avgIf {#avgif} diff --git a/docs/guides/examples/aggregate_function_combinators/avgMap.md b/docs/guides/examples/aggregate_function_combinators/avgMap.md index 51f73f3cf48..75172e2fb06 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgMap.md +++ b/docs/guides/examples/aggregate_function_combinators/avgMap.md @@ -4,6 +4,7 @@ title: 'avgMap' description: 'Example of using the avgMap combinator' keywords: ['avg', 'map', 'combinator', 'examples', 'avgMap'] sidebar_label: 'avgMap' +doc_type: 'tutorial' --- # avgMap {#avgmap} diff --git a/docs/guides/examples/aggregate_function_combinators/avgMerge.md b/docs/guides/examples/aggregate_function_combinators/avgMerge.md index 34a9827561f..e209a3aeb54 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgMerge.md +++ b/docs/guides/examples/aggregate_function_combinators/avgMerge.md @@ -4,6 +4,7 @@ title: 'avgMerge' description: 'Example of using the avgMerge combinator' keywords: ['avg', 'merge', 'combinator', 'examples', 'avgMerge'] sidebar_label: 'avgMerge' +doc_type: 'reference' --- # avgMerge {#avgMerge} diff --git a/docs/guides/examples/aggregate_function_combinators/avgMergeState.md b/docs/guides/examples/aggregate_function_combinators/avgMergeState.md index 916e21fb12a..b44d6172247 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgMergeState.md +++ b/docs/guides/examples/aggregate_function_combinators/avgMergeState.md @@ -4,6 +4,7 @@ title: 'avgMergeState' description: 'Example of using the avgMergeState combinator' keywords: ['avg', 'MergeState', 'combinator', 'examples', 'avgMergeState'] sidebar_label: 'avgMergeState' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/guides/examples/aggregate_function_combinators/avgResample.md b/docs/guides/examples/aggregate_function_combinators/avgResample.md index bdbeb9f91d5..43f119a4910 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgResample.md +++ b/docs/guides/examples/aggregate_function_combinators/avgResample.md @@ -4,6 +4,7 @@ title: 'avgResample' description: 'Example of using the Resample combinator with avg' keywords: ['avg', 'Resample', 'combinator', 'examples', 'avgResample'] sidebar_label: 'avgResample' +doc_type: 'how-to' --- # countResample {#countResample} diff --git a/docs/guides/examples/aggregate_function_combinators/avgState.md b/docs/guides/examples/aggregate_function_combinators/avgState.md index e0e2317701d..f13f94a8d2f 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgState.md +++ b/docs/guides/examples/aggregate_function_combinators/avgState.md @@ -4,6 +4,7 @@ title: 'avgState' description: 'Example of using the avgState combinator' keywords: ['avg', 'state', 'combinator', 'examples', 'avgState'] sidebar_label: 'avgState' +doc_type: 'how-to' --- # avgState {#avgState} diff --git a/docs/guides/examples/aggregate_function_combinators/countIf.md b/docs/guides/examples/aggregate_function_combinators/countIf.md index 53aac092dd4..30e452c6c57 100644 --- a/docs/guides/examples/aggregate_function_combinators/countIf.md +++ b/docs/guides/examples/aggregate_function_combinators/countIf.md @@ -4,6 +4,7 @@ title: 'countIf' description: 'Example of using the countIf combinator' keywords: ['count', 'if', 'combinator', 'examples', 'countIf'] sidebar_label: 'countIf' +doc_type: 'how-to' --- # countIf {#countif} diff --git a/docs/guides/examples/aggregate_function_combinators/countResample.md b/docs/guides/examples/aggregate_function_combinators/countResample.md index f90bb6a168c..64749a0e59c 100644 --- a/docs/guides/examples/aggregate_function_combinators/countResample.md +++ b/docs/guides/examples/aggregate_function_combinators/countResample.md @@ -4,6 +4,7 @@ title: 'countResample' description: 'Example of using the Resample combinator with count' keywords: ['count', 'Resample', 'combinator', 'examples', 'countResample'] sidebar_label: 'countResample' +doc_type: 'how-to' --- # countResample {#countResample} diff --git a/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md b/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md index dd7350258fc..5b600a88270 100644 --- a/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md +++ b/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md @@ -4,6 +4,7 @@ title: 'groupArrayDistinct' description: 'Example of using the groupArrayDistinct combinator' keywords: ['groupArray', 'Distinct', 'combinator', 'examples', 'groupArrayDistinct'] sidebar_label: 'groupArrayDistinct' +doc_type: 'how-to' --- # groupArrayDistinct {#sumdistinct} diff --git a/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md b/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md index 38176eaa49f..b39bfd6148d 100644 --- a/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md +++ b/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md @@ -4,6 +4,7 @@ title: 'groupArrayResample' description: 'Example of using the Resample combinator with groupArray' keywords: ['groupArray', 'Resample', 'combinator', 'examples', 'groupArrayResample'] sidebar_label: 'groupArrayResample' +doc_type: 'how-to' --- # groupArrayResample {#grouparrayresample} diff --git a/docs/guides/examples/aggregate_function_combinators/maxMap.md b/docs/guides/examples/aggregate_function_combinators/maxMap.md index e1ffe4907fb..68fb587d575 100644 --- a/docs/guides/examples/aggregate_function_combinators/maxMap.md +++ b/docs/guides/examples/aggregate_function_combinators/maxMap.md @@ -4,6 +4,7 @@ title: 'maxMap' description: 'Example of using the maxMap combinator' keywords: ['max', 'map', 'combinator', 'examples', 'maxMap'] sidebar_label: 'maxMap' +doc_type: 'reference' --- # maxMap {#maxmap} diff --git a/docs/guides/examples/aggregate_function_combinators/maxSimpleState.md b/docs/guides/examples/aggregate_function_combinators/maxSimpleState.md index 729637ce814..8ebd8e272ac 100644 --- a/docs/guides/examples/aggregate_function_combinators/maxSimpleState.md +++ b/docs/guides/examples/aggregate_function_combinators/maxSimpleState.md @@ -4,6 +4,7 @@ title: 'maxSimpleState' description: 'Example of using the minSimpleState combinator' keywords: ['min', 'state', 'simple', 'combinator', 'examples', 'minSimpleState'] sidebar_label: 'minSimpleState' +doc_type: 'reference' --- # minSimpleState {#minsimplestate} diff --git a/docs/guides/examples/aggregate_function_combinators/minMap.md b/docs/guides/examples/aggregate_function_combinators/minMap.md index e8843244f64..d73f9a91b25 100644 --- a/docs/guides/examples/aggregate_function_combinators/minMap.md +++ b/docs/guides/examples/aggregate_function_combinators/minMap.md @@ -4,6 +4,7 @@ title: 'minMap' description: 'Example of using the minMap combinator' keywords: ['min', 'map', 'combinator', 'examples', 'minMap'] sidebar_label: 'minMap' +doc_type: 'reference' --- # minMap {#minmap} diff --git a/docs/guides/examples/aggregate_function_combinators/minSimpleState.md b/docs/guides/examples/aggregate_function_combinators/minSimpleState.md index 0d7fa86a4ac..0e70bc48160 100644 --- a/docs/guides/examples/aggregate_function_combinators/minSimpleState.md +++ b/docs/guides/examples/aggregate_function_combinators/minSimpleState.md @@ -4,6 +4,7 @@ title: 'minSimpleState' description: 'Example of using the minSimpleState combinator' keywords: ['min', 'state', 'simple', 'combinator', 'examples', 'minSimpleState'] sidebar_label: 'minSimpleState' +doc_type: 'reference' --- # minSimpleState {#minsimplestate} diff --git a/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md b/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md index 3df6548f982..d785c21869f 100644 --- a/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md +++ b/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md @@ -4,6 +4,7 @@ title: 'quantilesTimingArrayIf' description: 'Example of using the quantilesTimingArrayIf combinator' keywords: ['quantilesTiming', 'array', 'if', 'combinator', 'examples', 'quantilesTimingArrayIf'] sidebar_label: 'quantilesTimingArrayIf' +doc_type: 'how-to' --- # quantilesTimingArrayIf {#quantilestimingarrayif} diff --git a/docs/guides/examples/aggregate_function_combinators/quantilesTimingIf.md b/docs/guides/examples/aggregate_function_combinators/quantilesTimingIf.md index 4dc1ae5743b..0564ab5eb62 100644 --- a/docs/guides/examples/aggregate_function_combinators/quantilesTimingIf.md +++ b/docs/guides/examples/aggregate_function_combinators/quantilesTimingIf.md @@ -4,6 +4,7 @@ title: 'quantilesTimingIf' description: 'Example of using the quantilesTimingIf combinator' keywords: ['quantilesTiming', 'if', 'combinator', 'examples', 'quantilesTimingIf'] sidebar_label: 'quantilesTimingIf' +doc_type: 'reference' --- # quantilesTimingIf {#quantilestimingif} diff --git a/docs/guides/examples/aggregate_function_combinators/sumArray.md b/docs/guides/examples/aggregate_function_combinators/sumArray.md index 0f1fdabf461..ff05b916c8e 100644 --- a/docs/guides/examples/aggregate_function_combinators/sumArray.md +++ b/docs/guides/examples/aggregate_function_combinators/sumArray.md @@ -4,6 +4,7 @@ title: 'sumArray' description: 'Example of using the sumArray combinator' keywords: ['sum', 'array', 'combinator', 'examples', 'sumArray'] sidebar_label: 'sumArray' +doc_type: 'reference' --- # sumArray {#sumarray} diff --git a/docs/guides/examples/aggregate_function_combinators/sumForEach.md b/docs/guides/examples/aggregate_function_combinators/sumForEach.md index 67b2ed98e3c..2cbcdefd0f0 100644 --- a/docs/guides/examples/aggregate_function_combinators/sumForEach.md +++ b/docs/guides/examples/aggregate_function_combinators/sumForEach.md @@ -4,6 +4,7 @@ title: 'sumForEach' description: 'Example of using the sumForEach aggregate function' keywords: ['sum', 'ForEach', 'combinator', 'examples', 'sumForEach'] sidebar_label: 'sumForEach' +doc_type: 'how-to' --- # sumForEach {#sumforeach} diff --git a/docs/guides/examples/aggregate_function_combinators/sumIf.md b/docs/guides/examples/aggregate_function_combinators/sumIf.md index 7b70e7117ea..624eb0aef1c 100644 --- a/docs/guides/examples/aggregate_function_combinators/sumIf.md +++ b/docs/guides/examples/aggregate_function_combinators/sumIf.md @@ -4,6 +4,7 @@ title: 'sumIf' description: 'Example of using the sumIf combinator' keywords: ['sum', 'if', 'combinator', 'examples', 'sumIf'] sidebar_label: 'sumIf' +doc_type: 'reference' --- # sumIf {#sumif} diff --git a/docs/guides/examples/aggregate_function_combinators/sumMap.md b/docs/guides/examples/aggregate_function_combinators/sumMap.md index fda6b895388..edf49b60d05 100644 --- a/docs/guides/examples/aggregate_function_combinators/sumMap.md +++ b/docs/guides/examples/aggregate_function_combinators/sumMap.md @@ -4,6 +4,7 @@ title: 'sumMap' description: 'Example of using the sumMap combinator' keywords: ['sum', 'map', 'combinator', 'examples', 'sumMap'] sidebar_label: 'sumMap' +doc_type: 'reference' --- # sumMap {#summap} diff --git a/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md b/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md index 35b8759ea35..2d56b0cba56 100644 --- a/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md +++ b/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md @@ -4,6 +4,7 @@ title: 'sumSimpleState' description: 'Example of using the sumSimpleState combinator' keywords: ['sum', 'state', 'simple', 'combinator', 'examples', 'sumSimpleState'] sidebar_label: 'sumSimpleState' +doc_type: 'how-to' --- # sumSimpleState {#sumsimplestate} diff --git a/docs/guides/examples/aggregate_function_combinators/uniqArray.md b/docs/guides/examples/aggregate_function_combinators/uniqArray.md index 07c651fb298..84f9aa59848 100644 --- a/docs/guides/examples/aggregate_function_combinators/uniqArray.md +++ b/docs/guides/examples/aggregate_function_combinators/uniqArray.md @@ -4,6 +4,7 @@ title: 'uniqArray' description: 'Example of using the uniqArray combinator' keywords: ['uniq', 'array', 'combinator', 'examples', 'uniqArray'] sidebar_label: 'uniqArray' +doc_type: 'reference' --- # uniqArray {#uniqarray} diff --git a/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md b/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md index 31470be7e31..4cf08c7293d 100644 --- a/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md +++ b/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md @@ -4,6 +4,7 @@ title: 'uniqArrayIf' description: 'Example of using the uniqArrayIf combinator' keywords: ['uniq', 'array', 'if', 'combinator', 'examples', 'uniqArrayIf'] sidebar_label: 'uniqArrayIf' +doc_type: 'how-to' --- # uniqArrayIf {#uniqarrayif} diff --git a/docs/guides/inserting-data.md b/docs/guides/inserting-data.md index 360cc36e0cc..7278438eacd 100644 --- a/docs/guides/inserting-data.md +++ b/docs/guides/inserting-data.md @@ -5,6 +5,7 @@ keywords: ['INSERT', 'Batch Insert'] sidebar_label: 'Inserting ClickHouse data' slug: /guides/inserting-data show_related_blogs: true +doc_type: 'how-to' --- import postgres_inserts from '@site/static/images/guides/postgres-inserts.png'; diff --git a/docs/guides/joining-tables.md b/docs/guides/joining-tables.md index 77ba8d118f6..e925e7ac1c8 100644 --- a/docs/guides/joining-tables.md +++ b/docs/guides/joining-tables.md @@ -3,6 +3,7 @@ title: 'Using JOINs in ClickHouse' description: 'How to join tables in ClickHouse' keywords: ['joins', 'join tables'] slug: /guides/joining-tables +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/guides/manage-and-deploy-index.md b/docs/guides/manage-and-deploy-index.md index 388bfcaa4c1..e0dac129a57 100644 --- a/docs/guides/manage-and-deploy-index.md +++ b/docs/guides/manage-and-deploy-index.md @@ -2,6 +2,7 @@ title: 'Manage and Deploy Overview' description: 'Overview page for Manage and Deploy' slug: /guides/manage-and-deploy-index +doc_type: 'reference' --- # Manage and deploy diff --git a/docs/guides/separation-storage-compute.md b/docs/guides/separation-storage-compute.md index b404f55e7f1..f29bb008afc 100644 --- a/docs/guides/separation-storage-compute.md +++ b/docs/guides/separation-storage-compute.md @@ -4,6 +4,7 @@ sidebar_label: 'Separation of Storage and Compute' slug: /guides/separation-storage-compute title: 'Separation of Storage and Compute' description: 'This guide explores how you can use ClickHouse and S3 to implement an architecture with separated storage and compute.' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/guides/sre/configuring-ssl.md b/docs/guides/sre/configuring-ssl.md index 5837b8f322b..5958bc42bdf 100644 --- a/docs/guides/sre/configuring-ssl.md +++ b/docs/guides/sre/configuring-ssl.md @@ -4,6 +4,7 @@ sidebar_label: 'Configuring SSL-TLS' sidebar_position: 20 title: 'Configuring SSL-TLS' description: 'This guide provides simple and minimal settings to configure ClickHouse to use OpenSSL certificates to validate connections.' +doc_type: 'tutorial' --- import SelfManaged from '@site/docs/_snippets/_self_managed_only_automated.md'; diff --git a/docs/guides/sre/index.md b/docs/guides/sre/index.md index a19a1c49ea3..a8c2e4ea319 100644 --- a/docs/guides/sre/index.md +++ b/docs/guides/sre/index.md @@ -2,6 +2,7 @@ slug: /security-and-authentication title: 'Security and Authentication' description: 'Landing page for Security and Authentication' +doc_type: 'reference' --- | Page | Description | diff --git a/docs/guides/sre/keeper/index.md b/docs/guides/sre/keeper/index.md index 7f31356fbd8..3c06fadfe08 100644 --- a/docs/guides/sre/keeper/index.md +++ b/docs/guides/sre/keeper/index.md @@ -6,6 +6,7 @@ sidebar_position: 10 keywords: ['Keeper', 'ZooKeeper', 'clickhouse-keeper'] description: 'ClickHouse Keeper, or clickhouse-keeper, replaces ZooKeeper and provides replication and coordination.' title: 'ClickHouse Keeper' +doc_type: 'reference' --- # ClickHouse Keeper (clickhouse-keeper) diff --git a/docs/guides/sre/network-ports.md b/docs/guides/sre/network-ports.md index 7e28f510db3..209756547fc 100644 --- a/docs/guides/sre/network-ports.md +++ b/docs/guides/sre/network-ports.md @@ -3,6 +3,7 @@ slug: /guides/sre/network-ports sidebar_label: 'Network ports' title: 'Network ports' description: 'Description of available network ports and what they are used for' +doc_type: 'reference' --- # Network ports diff --git a/docs/guides/sre/scaling-clusters.md b/docs/guides/sre/scaling-clusters.md index b9a6bfecbcd..91d9289120c 100644 --- a/docs/guides/sre/scaling-clusters.md +++ b/docs/guides/sre/scaling-clusters.md @@ -4,6 +4,7 @@ sidebar_label: 'Rebalancing Shards' sidebar_position: 20 description: 'ClickHouse does not support automatic shard rebalancing, so we provide some best practices for how to rebalance shards.' title: 'Rebalancing Data' +doc_type: 'how-to' --- # Rebalancing data diff --git a/docs/guides/sre/user-management/configuring-ldap.md b/docs/guides/sre/user-management/configuring-ldap.md index 65837089d09..f8e04ba35d1 100644 --- a/docs/guides/sre/user-management/configuring-ldap.md +++ b/docs/guides/sre/user-management/configuring-ldap.md @@ -4,6 +4,7 @@ sidebar_position: 2 slug: /guides/sre/configuring-ldap title: 'Configuring ClickHouse to Use LDAP for Authentication and Role Mapping' description: 'Describes how to configure ClickHouse to use LDAP for authentication and role mapping' +doc_type: 'how-to' --- import SelfManaged from '@site/docs/_snippets/_self_managed_only_no_roadmap.md'; diff --git a/docs/guides/sre/user-management/index.md b/docs/guides/sre/user-management/index.md index df945e7c0ae..c81bd403867 100644 --- a/docs/guides/sre/user-management/index.md +++ b/docs/guides/sre/user-management/index.md @@ -5,6 +5,7 @@ sidebar_label: 'Users and Roles' title: 'Access Control and Account Management' keywords: ['ClickHouse Cloud', 'Access Control', 'User Management', 'RBAC', 'Security'] description: 'Describes access control and account management in ClickHouse Cloud' +doc_type: 'tutorial' --- # Creating users and roles in ClickHouse diff --git a/docs/guides/sre/user-management/ssl-user-auth.md b/docs/guides/sre/user-management/ssl-user-auth.md index 501e8173347..ff1f74f77be 100644 --- a/docs/guides/sre/user-management/ssl-user-auth.md +++ b/docs/guides/sre/user-management/ssl-user-auth.md @@ -4,6 +4,7 @@ sidebar_position: 3 slug: /guides/sre/ssl-user-auth title: 'Configuring SSL User Certificate for Authentication' description: 'This guide provides simple and minimal settings to configure authentication with SSL user certificates.' +doc_type: 'how-to' --- # Configuring SSL user certificate for authentication diff --git a/docs/guides/troubleshooting.md b/docs/guides/troubleshooting.md index 65cd5ddfeaa..419313f5a2f 100644 --- a/docs/guides/troubleshooting.md +++ b/docs/guides/troubleshooting.md @@ -2,6 +2,7 @@ title: 'Troubleshooting' description: 'Installation troubleshooting guide' slug: /guides/troubleshooting +doc_type: 'how-to' --- ## Installation {#installation} diff --git a/docs/guides/writing-queries.md b/docs/guides/writing-queries.md index 0ca890be3a5..c3a919197f1 100644 --- a/docs/guides/writing-queries.md +++ b/docs/guides/writing-queries.md @@ -6,6 +6,7 @@ slug: /guides/writing-queries description: 'Learn about Selecting ClickHouse Data' keywords: ['SELECT', 'data formats'] show_related_blogs: true +doc_type: 'how-to' --- ClickHouse is a SQL database, and you query your data by writing the same type of `SELECT` queries you are already familiar with. For example: diff --git a/docs/integrations/data-ingestion/apache-spark/index.md b/docs/integrations/data-ingestion/apache-spark/index.md index 73e3726200a..f11cc6e48a1 100644 --- a/docs/integrations/data-ingestion/apache-spark/index.md +++ b/docs/integrations/data-ingestion/apache-spark/index.md @@ -5,6 +5,7 @@ slug: /integrations/apache-spark description: 'Introduction to Apache Spark with ClickHouse' keywords: ['clickhouse', 'Apache Spark', 'migrating', 'data'] title: 'Integrating Apache Spark with ClickHouse' +doc_type: 'reference' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md b/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md index 68e0683b048..230ecf4ac06 100644 --- a/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md +++ b/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md @@ -5,6 +5,7 @@ slug: /integrations/apache-spark/spark-jdbc description: 'Introduction to Apache Spark with ClickHouse' keywords: ['clickhouse', 'Apache Spark', 'jdbc', 'migrating', 'data'] title: 'Spark JDBC' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md b/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md index b5506ee0ead..edeec5e047b 100644 --- a/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md +++ b/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md @@ -5,6 +5,7 @@ slug: /integrations/apache-spark/spark-native-connector description: 'Introduction to Apache Spark with ClickHouse' keywords: ['clickhouse', 'Apache Spark', 'migrating', 'data'] title: 'Spark Connector' +doc_type: 'tutorial' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/data-ingestion/aws-glue/index.md b/docs/integrations/data-ingestion/aws-glue/index.md index cdd12c384b0..e944051a4b8 100644 --- a/docs/integrations/data-ingestion/aws-glue/index.md +++ b/docs/integrations/data-ingestion/aws-glue/index.md @@ -5,6 +5,7 @@ slug: /integrations/glue description: 'Integrate ClickHouse and Amazon Glue' keywords: ['clickhouse', 'amazon', 'aws', 'glue', 'migrating', 'data', 'spark'] title: 'Integrating Amazon Glue with ClickHouse and Spark' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/azure-data-factory/index.md b/docs/integrations/data-ingestion/azure-data-factory/index.md index 40787c3adad..74ab767b2e4 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/index.md +++ b/docs/integrations/data-ingestion/azure-data-factory/index.md @@ -3,6 +3,7 @@ slug: /integrations/azure-data-factory description: 'Bringing Azure Data into ClickHouse' keywords: ['azure data factory', 'azure', 'microsoft', 'data'] title: 'Bringing Azure Data into ClickHouse' +doc_type: 'reference' --- | Page | Description | diff --git a/docs/integrations/data-ingestion/azure-data-factory/overview.md b/docs/integrations/data-ingestion/azure-data-factory/overview.md index b2de22d0af0..2047e27612c 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/overview.md +++ b/docs/integrations/data-ingestion/azure-data-factory/overview.md @@ -4,6 +4,7 @@ slug: /integrations/azure-data-factory/overview description: 'Bringing Azure Data into ClickHouse - Overview' keywords: ['azure data factory', 'azure', 'microsoft', 'data'] title: 'Bringing Azure Data into ClickHouse' +doc_type: 'reference' --- # Bringing Azure Data into ClickHouse diff --git a/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md b/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md index 910b145215a..2ea101085a9 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md +++ b/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md @@ -4,6 +4,7 @@ slug: /integrations/azure-data-factory/table-function description: 'Using ClickHouse''s azureBlobStorage table function' keywords: ['azure data factory', 'azure', 'microsoft', 'data', 'azureBlobStorage'] title: 'Using ClickHouse''s azureBlobStorage table function to bring Azure data into ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md b/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md index 7128678a2f6..3bf304c09d3 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md +++ b/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md @@ -4,6 +4,7 @@ slug: /integrations/azure-data-factory/http-interface description: 'Using ClickHouse''s HTTP interface to bring data from Azure Data Factory into ClickHouse' keywords: ['azure data factory', 'azure', 'microsoft', 'data', 'http interface'] title: 'Using ClickHouse HTTP Interface to bring Azure data into ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/azure-synapse/index.md b/docs/integrations/data-ingestion/azure-synapse/index.md index d962dff19a2..401eaf89c65 100644 --- a/docs/integrations/data-ingestion/azure-synapse/index.md +++ b/docs/integrations/data-ingestion/azure-synapse/index.md @@ -4,6 +4,7 @@ slug: /integrations/azure-synapse description: 'Introduction to Azure Synapse with ClickHouse' keywords: ['clickhouse', 'azure synapse', 'azure', 'synapse', 'microsoft', 'azure spark', 'data'] title: 'Integrating Azure Synapse with ClickHouse' +doc_type: 'reference' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md b/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md index 1d73e9470ed..0172c22dc1d 100644 --- a/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md +++ b/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md @@ -3,6 +3,7 @@ sidebar_label: 'AWS PrivateLink for ClickPipes' description: 'Establish a secure connection between ClickPipes and a data source using AWS PrivateLink.' slug: /integrations/clickpipes/aws-privatelink title: 'AWS PrivateLink for ClickPipes' +doc_type: 'how-to' --- import cp_service from '@site/static/images/integrations/data-ingestion/clickpipes/cp_service.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/index.md b/docs/integrations/data-ingestion/clickpipes/index.md index b1e84692236..d59d334f0dc 100644 --- a/docs/integrations/data-ingestion/clickpipes/index.md +++ b/docs/integrations/data-ingestion/clickpipes/index.md @@ -3,6 +3,7 @@ sidebar_label: 'Introduction' description: 'Seamlessly connect your external data sources to ClickHouse Cloud.' slug: /integrations/clickpipes title: 'Integrating with ClickHouse Cloud' +doc_type: 'tutorial' --- import Kafkasvg from '@site/static/images/integrations/logos/kafka.svg'; diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md b/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md index 2a6f6ac4bca..2eb05ce5806 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md @@ -4,6 +4,7 @@ description: 'Step-by-step guide to creating your first Kafka ClickPipe.' slug: /integrations/clickpipes/kafka/create-your-first-kafka-clickpipe sidebar_position: 1 title: 'Creating your first Kafka ClickPipe' +doc_type: 'how-to' --- import cp_step0 from '@site/static/images/integrations/data-ingestion/clickpipes/cp_step0.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md b/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md index 4e75cbb2d26..8c72873f9dc 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md @@ -4,6 +4,7 @@ description: 'Information on schema registries for Kafka ClickPipe' slug: /integrations/clickpipes/kafka/schema-registries sidebar_position: 1 title: 'Schema registries for Kafka ClickPipe' +doc_type: 'reference' --- # Schema registries {#schema-registries} diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/03_reference.md b/docs/integrations/data-ingestion/clickpipes/kafka/03_reference.md index fcf1220f55e..73090fd61fc 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/03_reference.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/03_reference.md @@ -4,6 +4,7 @@ description: 'Details supported formats, sources, delivery semantics, authentica slug: /integrations/clickpipes/kafka/reference sidebar_position: 1 title: 'Reference' +doc_type: 'reference' --- import Kafkasvg from '@site/static/images/integrations/logos/kafka.svg'; diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md b/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md index 9172015d632..92a30a742c3 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md @@ -4,6 +4,7 @@ description: 'Details best practices to follow when working with Kafka ClickPipe slug: /integrations/clickpipes/kafka/best-practices sidebar_position: 1 title: 'Best practices' +doc_type: 'tutorial' --- # Best practices {#best-practices} diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md b/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md index 2f43b9ce17f..27d891e6aea 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md @@ -4,6 +4,7 @@ description: 'Frequently asked questions about Kafka ClickPipes' slug: /integrations/clickpipes/kafka/faq sidebar_position: 1 title: 'Kafka ClickPipes FAQ' +doc_type: 'explanation' --- ## Kafka ClickPipes FAQ {#faq} diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/index.md b/docs/integrations/data-ingestion/clickpipes/kafka/index.md index 830168afc93..6d7ccdab867 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/index.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/index.md @@ -3,7 +3,15 @@ description: 'Landing page with table of contents for the Kafka ClickPipes secti slug: /integrations/clickpipes/kafka sidebar_position: 1 title: 'Kafka ClickPipes' +doc_type: 'reference' --- +| Page | Description | +|-----|-----| +| [Creating your first Kafka ClickPipe](/integrations/clickpipes/kafka/create-your-first-kafka-clickpipe) | Step-by-step guide to creating your first Kafka ClickPipe. | +| [Reference](/integrations/clickpipes/kafka/reference) | Details supported formats, sources, delivery semantics, authentication and experimental features supported by Kafka ClickPipes | +| [Schema registries for Kafka ClickPipe](/integrations/clickpipes/kafka/schema-registries) | Information on schema registries for Kafka ClickPipe | +| [Kafka ClickPipes FAQ](/integrations/clickpipes/kafka/faq) | Frequently asked questions about Kafka ClickPipes | +| [Best practices](/integrations/clickpipes/kafka/best-practices) | Details best practices to follow when working with Kafka ClickPipes | \ No newline at end of file diff --git a/docs/integrations/data-ingestion/clickpipes/kinesis.md b/docs/integrations/data-ingestion/clickpipes/kinesis.md index 9a6532b3d5d..f9d8f64b612 100644 --- a/docs/integrations/data-ingestion/clickpipes/kinesis.md +++ b/docs/integrations/data-ingestion/clickpipes/kinesis.md @@ -3,6 +3,7 @@ sidebar_label: 'ClickPipes for Amazon Kinesis' description: 'Seamlessly connect your Amazon Kinesis data sources to ClickHouse Cloud.' slug: /integrations/clickpipes/kinesis title: 'Integrating Amazon Kinesis with ClickHouse Cloud' +doc_type: 'how-to' --- import cp_service from '@site/static/images/integrations/data-ingestion/clickpipes/cp_service.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md b/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md index 1de664c7ed8..e533480fbe3 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md @@ -4,6 +4,7 @@ description: 'Describes the steps needed to add specific tables to a ClickPipe.' sidebar_label: 'Add Table' slug: /integrations/clickpipes/mongodb/add_table show_title: false +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md b/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md index 86cca874390..73cfc6a83c9 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md @@ -3,6 +3,7 @@ title: 'Controlling the Syncing of a MongoDB ClickPipe' description: 'Doc for controllling the sync a MongoDB ClickPipe' slug: /integrations/clickpipes/mongodb/sync_control sidebar_label: 'Controlling syncs' +doc_type: 'how-to' --- import edit_sync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/datatypes.md b/docs/integrations/data-ingestion/clickpipes/mongodb/datatypes.md index b487a34a52a..bf09a8f4f17 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/datatypes.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/datatypes.md @@ -2,6 +2,7 @@ title: 'Supported data types' slug: /integrations/clickpipes/mongodb/datatypes description: 'Page describing MongoDB ClickPipe datatype mapping from MongoDB to ClickHouse' +doc_type: 'reference' --- MongoDB stores data records as BSON documents. In ClickPipes, you can configure to ingest BSON documents to ClickHouse as either JSON or JSON String. The following table shows the supported BSON to JSON field type mapping: diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/index.md b/docs/integrations/data-ingestion/clickpipes/mongodb/index.md index 84e04e1b413..189bee23df0 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/index.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/index.md @@ -3,6 +3,7 @@ sidebar_label: 'Ingesting Data from MongoDB to ClickHouse' description: 'Describes how to seamlessly connect your MongoDB to ClickHouse Cloud.' slug: /integrations/clickpipes/mongodb title: 'Ingesting data from MongoDB to ClickHouse (using CDC)' +doc_type: 'how-to' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md b/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md index 821acabba65..5accce1e31d 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md @@ -3,6 +3,7 @@ sidebar_label: 'Lifecycle of a MongoDB ClickPipe' description: 'Various pipe statuses and their meanings' slug: /integrations/clickpipes/mongodb/lifecycle title: 'Lifecycle of a MongoDB ClickPipe' +doc_type: 'reference' --- # Lifecycle of a MongoDB ClickPipe {#lifecycle} diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md b/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md index 56383e8bf63..e77072af9dc 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md @@ -3,6 +3,7 @@ title: 'Pausing and Resuming a MongoDB ClickPipe' description: 'Pausing and Resuming a MongoDB ClickPipe' sidebar_label: 'Pause Table' slug: /integrations/clickpipes/mongodb/pause_and_resume +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md b/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md index 00c87f17c31..aba4750d9d8 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md @@ -3,6 +3,7 @@ title: 'Working with JSON in ClickHouse' sidebar_label: 'Working with JSON' slug: /integrations/clickpipes/mongodb/quickstart description: 'Common patterns for working with JSON data replicated from MongoDB to ClickHouse via ClickPipes' +doc_type: 'reference' --- # Working with JSON in ClickHouse diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md b/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md index b3f0fda176c..5a7b73aef82 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md @@ -3,6 +3,7 @@ title: 'Removing specific tables from a ClickPipe' description: 'Removing specific tables from a ClickPipe' sidebar_label: 'Remove Table' slug: /integrations/clickpipes/mongodb/removing_tables +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md b/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md index 351a06540e5..e33ffd41b58 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md @@ -3,6 +3,7 @@ title: 'Resyncing a Database ClickPipe' description: 'Doc for resyncing a database ClickPipe' slug: /integrations/clickpipes/mongodb/resync sidebar_label: 'Resync ClickPipe' +doc_type: 'how-to' --- import resync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/resync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md b/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md index a2d1754a642..77475b94247 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md @@ -3,6 +3,7 @@ sidebar_label: 'MongoDB Atlas' description: 'Step-by-step guide on how to set up MongoDB Atlas as a source for ClickPipes' slug: /integrations/clickpipes/mongodb/source/atlas title: 'MongoDB Atlas source setup guide' +doc_type: 'how-to' --- import mongo_atlas_configuration from '@site/static/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-cluster-overview-configuration.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md b/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md index a3dcaf660c4..ba4ac7dc396 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md @@ -3,6 +3,7 @@ sidebar_label: 'Generic MongoDB' description: 'Set up any MongoDB instance as a source for ClickPipes' slug: /integrations/clickpipes/mongodb/source/generic title: 'Generic MongoDB source setup guide' +doc_type: 'how-to' --- # Generic MongoDB source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md b/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md index 4074755b0b4..074680aff99 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md @@ -4,6 +4,7 @@ description: 'Describes the steps need to add specific tables to a ClickPipe.' sidebar_label: 'Add Table' slug: /integrations/clickpipes/mysql/add_table show_title: false +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md b/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md index b42feefab0f..e1d887af4a7 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md @@ -3,6 +3,7 @@ title: 'Controlling the Syncing of a MySQL ClickPipe' description: 'Doc for controllling the sync a MySQL ClickPipe' slug: /integrations/clickpipes/mysql/sync_control sidebar_label: 'Controlling syncs' +doc_type: 'how-to' --- import edit_sync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/datatypes.md b/docs/integrations/data-ingestion/clickpipes/mysql/datatypes.md index 3f1181cb55c..e4245fcd664 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/datatypes.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/datatypes.md @@ -2,6 +2,7 @@ title: 'Supported data types' slug: /integrations/clickpipes/mysql/datatypes description: 'Page describing MySQL ClickPipe datatype mapping from MySQL to ClickHouse' +doc_type: 'reference' --- Here is the supported data-type mapping for the MySQL ClickPipe: diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/faq.md b/docs/integrations/data-ingestion/clickpipes/mysql/faq.md index 99008c9744a..32ddca1eeed 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/faq.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/faq.md @@ -4,6 +4,7 @@ description: 'Frequently asked questions about ClickPipes for MySQL.' slug: /integrations/clickpipes/mysql/faq sidebar_position: 2 title: 'ClickPipes for MySQL FAQ' +doc_type: 'explanation' --- # ClickPipes for MySQL FAQ diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/index.md b/docs/integrations/data-ingestion/clickpipes/mysql/index.md index 001983d636f..f834c7547d7 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/index.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/index.md @@ -3,6 +3,7 @@ sidebar_label: 'Ingesting Data from MySQL to ClickHouse' description: 'Describes how to seamlessly connect your MySQL to ClickHouse Cloud.' slug: /integrations/clickpipes/mysql title: 'Ingesting data from MySQL to ClickHouse (using CDC)' +doc_type: 'tutorial' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md b/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md index 3e37af23889..7f8265a970a 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md @@ -3,6 +3,7 @@ sidebar_label: 'Lifecycle of a MySQL ClickPipe' description: 'Various pipe statuses and their meanings' slug: /integrations/clickpipes/mysql/lifecycle title: 'Lifecycle of a MySQL ClickPipe' +doc_type: 'reference' --- # Lifecycle of a MySQL ClickPipe {#lifecycle} diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md b/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md index 27b77bd6ddc..a462d033bfe 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md @@ -3,6 +3,7 @@ title: 'Parallel Snapshot In The MySQL ClickPipe' description: 'Doc for explaining parallel snapshot in the MySQL ClickPipe' slug: /integrations/clickpipes/mysql/parallel_initial_load sidebar_label: 'How parallel snapshot works' +doc_type: 'explanation' --- import snapshot_params from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/snapshot_params.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md b/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md index 88daec6e532..3595ca7f232 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md @@ -3,6 +3,7 @@ title: 'Pausing and Resuming a MySQL ClickPipe' description: 'Pausing and Resuming a MySQL ClickPipe' sidebar_label: 'Pause Table' slug: /integrations/clickpipes/mysql/pause_and_resume +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md b/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md index 58fbc56dc9d..e9c94dcb005 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md @@ -3,6 +3,7 @@ title: 'Removing specific tables from a ClickPipe' description: 'Removing specific tables from a ClickPipe' sidebar_label: 'Remove Table' slug: /integrations/clickpipes/mysql/removing_tables +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/resync.md b/docs/integrations/data-ingestion/clickpipes/mysql/resync.md index 37a65a4249a..64ff0593a00 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/resync.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/resync.md @@ -3,6 +3,7 @@ title: 'Resyncing a Database ClickPipe' description: 'Doc for resyncing a database ClickPipe' slug: /integrations/clickpipes/mysql/resync sidebar_label: 'Resync ClickPipe' +doc_type: 'how-to' --- import resync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/resync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/schema-changes.md b/docs/integrations/data-ingestion/clickpipes/mysql/schema-changes.md index d2c8e37d0df..ec6979aeee5 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/schema-changes.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/schema-changes.md @@ -2,6 +2,7 @@ title: 'Schema Changes Propagation Support' slug: /integrations/clickpipes/mysql/schema-changes description: 'Page describing schema change types detectable by ClickPipes in the source tables' +doc_type: 'reference' --- ClickPipes for MySQL can detect schema changes in the source tables and, in some cases, automatically propagate the changes to the destination tables. The way each DDL operation is handled is documented below: diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md index ec11c9bff48..85f15e05e48 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md @@ -3,6 +3,7 @@ sidebar_label: 'Amazon Aurora MySQL' description: 'Step-by-step guide on how to set up Amazon Aurora MySQL as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/aurora title: 'Aurora MySQL source setup guide' +doc_type: 'tutorial' --- import rds_backups from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md index 3a87882f74c..9ed47de0187 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md @@ -3,6 +3,7 @@ sidebar_label: 'Cloud SQL For MySQL ' description: 'Step-by-step guide on how to set up Cloud SQL for MySQL as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/gcp title: 'Cloud SQL for MySQL source setup guide' +doc_type: 'how-to' --- import gcp_pitr from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-pitr.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md index 438cda38455..847a6888893 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md @@ -3,6 +3,7 @@ sidebar_label: 'Generic MySQL' description: 'Set up any MySQL instance as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/generic title: 'Generic MySQL source setup guide' +doc_type: 'how-to' --- # Generic MySQL source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md index 7099425aae4..8d41c607b35 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md @@ -3,6 +3,7 @@ sidebar_label: 'Generic MariaDB' description: 'Set up any MariaDB instance as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/generic_maria title: 'Generic MariaDB source setup guide' +doc_type: 'how-to' --- # Generic MariaDB source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md index b2a84c21bb9..019e2cf7093 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md @@ -3,6 +3,7 @@ sidebar_label: 'Amazon RDS MySQL' description: 'Step-by-step guide on how to set up Amazon RDS MySQL as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/rds title: 'RDS MySQL source setup guide' +doc_type: 'how-to' --- import rds_backups from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md index 81341917ea1..60909a2e528 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md @@ -3,6 +3,7 @@ sidebar_label: 'Amazon RDS MariaDB' description: 'Step-by-step guide on how to set up Amazon RDS MariaDB as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/rds_maria title: 'RDS MariaDB source setup guide' +doc_type: 'how-to' --- import rds_backups from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/object-storage.md b/docs/integrations/data-ingestion/clickpipes/object-storage.md index e00786d9a11..187e6084297 100644 --- a/docs/integrations/data-ingestion/clickpipes/object-storage.md +++ b/docs/integrations/data-ingestion/clickpipes/object-storage.md @@ -3,6 +3,7 @@ sidebar_label: 'ClickPipes for Object Storage' description: 'Seamlessly connect your object storage to ClickHouse Cloud.' slug: /integrations/clickpipes/object-storage title: 'Integrating Object Storage with ClickHouse Cloud' +doc_type: 'how-to' --- import S3svg from '@site/static/images/integrations/logos/amazon_s3_logo.svg'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md b/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md index 9de4ca503ce..7e11f10fa59 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md @@ -4,6 +4,7 @@ description: 'Describes the steps need to add specific tables to a ClickPipe.' sidebar_label: 'Add Table' slug: /integrations/clickpipes/postgres/add_table show_title: false +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md b/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md index dca3b2a7e83..8825f9e2dc1 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md @@ -3,6 +3,7 @@ title: 'Controlling the Syncing of a Postgres ClickPipe' description: 'Doc for controlling the sync a Postgres ClickPipe' slug: /integrations/clickpipes/postgres/sync_control sidebar_label: 'Controlling syncs' +doc_type: 'how-to' --- import edit_sync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md b/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md index a46c74122fa..409d23588e2 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md @@ -3,6 +3,7 @@ sidebar_label: 'Deduplication Strategies' description: 'Handle duplicates and deleted rows.' slug: /integrations/clickpipes/postgres/deduplication title: 'Deduplication strategies (using CDC)' +doc_type: 'tutorial' --- import clickpipes_initial_load from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/postgres-cdc-initial-load.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/faq.md b/docs/integrations/data-ingestion/clickpipes/postgres/faq.md index 08b658a311c..9be795fcea0 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/faq.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/faq.md @@ -4,6 +4,7 @@ description: 'Frequently asked questions about ClickPipes for Postgres.' slug: /integrations/clickpipes/postgres/faq sidebar_position: 2 title: 'ClickPipes for Postgres FAQ' +doc_type: 'reference' --- # ClickPipes for Postgres FAQ diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/index.md b/docs/integrations/data-ingestion/clickpipes/postgres/index.md index 754e0f6096d..d0fcc3a1e88 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/index.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/index.md @@ -3,6 +3,7 @@ sidebar_label: 'Ingesting Data from Postgres to ClickHouse' description: 'Seamlessly connect your Postgres to ClickHouse Cloud.' slug: /integrations/clickpipes/postgres title: 'Ingesting Data from Postgres to ClickHouse (using CDC)' +doc_type: 'tutorial' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md b/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md index 2ac02df64c5..1636ce90855 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md @@ -3,6 +3,7 @@ sidebar_label: 'Lifecycle of a Postgres ClickPipe' description: 'Various pipe statuses and their meanings' slug: /integrations/clickpipes/postgres/lifecycle title: 'Lifecycle of a Postgres ClickPipe' +doc_type: 'reference' --- # Lifecycle of a Postgres ClickPipe {#lifecycle} diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/maintenance.md b/docs/integrations/data-ingestion/clickpipes/postgres/maintenance.md index 2e0e0bc9393..4220d63f7e8 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/maintenance.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/maintenance.md @@ -3,6 +3,7 @@ sidebar_label: 'Maintenance Windows' description: 'Maintenance windows for ClickPipes for Postgres.' slug: /integrations/clickpipes/postgres/maintenance title: 'Maintenance windows for ClickPipes for Postgres' +doc_type: 'reference' --- # Maintenance windows for ClickPipes for Postgres diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md b/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md index 91337e28051..aff2b001fa1 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md @@ -3,6 +3,7 @@ sidebar_label: 'Ordering keys' description: 'How to define custom ordering keys.' slug: /integrations/clickpipes/postgres/ordering_keys title: 'Ordering Keys' +doc_type: 'how-to' --- Ordering Keys (a.k.a. sorting keys) define how data is sorted on disk and indexed for a table in ClickHouse. When replicating from Postgres, ClickPipes sets the Postgres primary key of a table as the ordering key for the corresponding table in ClickHouse. In most cases, the Postgres primary key serves as a sufficient ordering key, as ClickHouse is already optimized for fast scans, and custom ordering keys are often not required. diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md b/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md index 983ff29b011..e66e6689f90 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md @@ -3,6 +3,7 @@ title: 'Parallel Snapshot In The Postgres ClickPipe' description: 'Doc for explaining parallel snapshot in the Postgres ClickPipe' slug: /integrations/clickpipes/postgres/parallel_initial_load sidebar_label: 'How parallel snapshot works' +doc_type: 'explanation' --- import snapshot_params from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/snapshot_params.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md b/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md index a5ac35d00d1..af613a3a53c 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md @@ -3,6 +3,7 @@ title: 'Pausing and Resuming a Postgres ClickPipe' description: 'Pausing and Resuming a Postgres ClickPipe' sidebar_label: 'Pause Table' slug: /integrations/clickpipes/postgres/pause_and_resume +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md b/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md index 34887d5cff9..29d0e2fdb27 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md @@ -2,6 +2,7 @@ title: 'Postgres Generated Columns: Gotchas and Best Practices' slug: /integrations/clickpipes/postgres/generated_columns description: 'Page describing important considerations to keep in mind when using PostgreSQL generated columns in tables that are being replicated' +doc_type: 'explanation' --- When using PostgreSQL's generated columns in tables that are being replicated, there are some important considerations to keep in mind. These gotchas can affect the replication process and data consistency in your destination systems. diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md b/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md index ea21858d47d..5323dfddf56 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md @@ -3,6 +3,7 @@ title: 'Removing specific tables from a ClickPipe' description: 'Removing specific tables from a ClickPipe' sidebar_label: 'Remove Table' slug: /integrations/clickpipes/postgres/removing_tables +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/resync.md b/docs/integrations/data-ingestion/clickpipes/postgres/resync.md index fe3d558a9b8..2bf5e5185ac 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/resync.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/resync.md @@ -3,6 +3,7 @@ title: 'Resyncing a Database ClickPipe' description: 'Doc for resyncing a database ClickPipe' slug: /integrations/clickpipes/postgres/resync sidebar_label: 'Resync ClickPipe' +doc_type: 'how-to' --- import resync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/resync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md b/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md index ef924002613..edfa95f3220 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md @@ -3,6 +3,7 @@ title: 'Scaling DB ClickPipes via OpenAPI' description: 'Doc for scaling DB ClickPipes via OpenAPI' slug: /integrations/clickpipes/postgres/scaling sidebar_label: 'Scaling' +doc_type: 'how-to' --- :::caution Most users won't need this API diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/schema-changes.md b/docs/integrations/data-ingestion/clickpipes/postgres/schema-changes.md index 96903ac3e45..385989337a4 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/schema-changes.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/schema-changes.md @@ -2,6 +2,7 @@ title: 'Schema Changes Propagation Support' slug: /integrations/clickpipes/postgres/schema-changes description: 'Page describing schema change types detectable by ClickPipes in the source tables' +doc_type: 'reference' --- ClickPipes for Postgres can detect schema changes in the source tables and, in some cases, automatically propagate the changes to the destination tables. The way each DDL operation is handled is documented below: diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md index 2101871b31c..976d8ad7c2e 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md @@ -3,6 +3,7 @@ sidebar_label: 'Amazon Aurora Postgres' description: 'Set up Amazon Aurora Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/aurora title: 'Aurora Postgres Source Setup Guide' +doc_type: 'how-to' --- import parameter_group_in_blade from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/rds/parameter_group_in_blade.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md index 0704d7ed828..119295463a2 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md @@ -3,6 +3,7 @@ sidebar_label: 'Azure Flexible Server for Postgres' description: 'Set up Azure Flexible Server for Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/azure-flexible-server-postgres title: 'Azure Flexible Server for Postgres Source Setup Guide' +doc_type: 'how-to' --- import server_parameters from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres/server_parameters.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md index aa5cbf6e155..5c5c5fba649 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md @@ -3,6 +3,7 @@ sidebar_label: 'Crunchy Bridge Postgres' description: 'Set up Crunchy Bridge Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/crunchy-postgres title: 'Crunchy Bridge Postgres Source Setup Guide' +doc_type: 'how-to' --- import firewall_rules_crunchy_bridge from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/setup/crunchy-postgres/firewall_rules_crunchy_bridge.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md index 3cc69865841..090deb556bb 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md @@ -3,6 +3,7 @@ sidebar_label: 'Generic Postgres' description: 'Set up any Postgres instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/generic title: 'Generic Postgres Source Setup Guide' +doc_type: 'how-to' --- # Generic Postgres source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md index bc535d6e9d1..20d0d25fa82 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md @@ -3,6 +3,7 @@ sidebar_label: 'Google Cloud SQL' description: 'Set up Google Cloud SQL Postgres instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/google-cloudsql title: 'Google Cloud SQL Postgres Source Setup Guide' +doc_type: 'how-to' --- import edit_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql/edit.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md index 8d332071e7f..c63b75c66dc 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md @@ -3,6 +3,7 @@ sidebar_label: 'Neon Postgres' description: 'Set up Neon Postgres instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/neon-postgres title: 'Neon Postgres Source Setup Guide' +doc_type: 'how-to' --- import neon_commands from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-commands.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md index ad71ea71b63..70ca4a13048 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md @@ -3,6 +3,7 @@ sidebar_label: 'Planetscale for Postgres' description: 'Set up Planetscale for Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/planetscale title: 'PlanetScale for Postgres Source Setup Guide' +doc_type: 'how-to' --- import planetscale_wal_level_logical from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/planetscale/planetscale_wal_level_logical.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md index 8ced731ee65..65d46a06283 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md @@ -3,6 +3,7 @@ sidebar_label: 'Amazon RDS Postgres' description: 'Set up Amazon RDS Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/rds title: 'RDS Postgres Source Setup Guide' +doc_type: 'how-to' --- import parameter_group_in_blade from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/rds/parameter_group_in_blade.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md index cb750c42544..5f45df02274 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md @@ -3,6 +3,7 @@ sidebar_label: 'Supabase Postgres' description: 'Set up Supabase instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/supabase title: 'Supabase Source Setup Guide' +doc_type: 'how-to' --- import supabase_commands from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/setup/supabase/supabase-commands.jpg' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md index b4c23c5dc94..06e9f57db8e 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md @@ -4,6 +4,7 @@ description: 'Set up Postgres with the TimescaleDB extension as a source for Cli slug: /integrations/clickpipes/postgres/source/timescale title: 'Postgres with TimescaleDB source setup guide' keywords: ['TimescaleDB'] +doc_type: 'how-to' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md b/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md index 11288c5290c..b6520a4a78e 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md @@ -3,6 +3,7 @@ title: 'Resyncing Specific Tables' description: 'Resyncing specific tables in a Postgres ClickPipe' slug: /integrations/clickpipes/postgres/table_resync sidebar_label: 'Resync Table' +doc_type: 'how-to' --- # Resyncing specific tables {#resync-tables} diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/toast.md b/docs/integrations/data-ingestion/clickpipes/postgres/toast.md index bf3fd659f2e..8bfb75ea96a 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/toast.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/toast.md @@ -2,6 +2,7 @@ title: 'Handling TOAST Columns' description: 'Learn how to handle TOAST columns when replicating data from PostgreSQL to ClickHouse.' slug: /integrations/clickpipes/postgres/toast +doc_type: 'how-to' --- When replicating data from PostgreSQL to ClickHouse, it's important to understand the limitations and special considerations for TOAST (The Oversized-Attribute Storage Technique) columns. This guide will help you identify and properly handle TOAST columns in your replication process. diff --git a/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md b/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md index 7b6044bd43c..8274573e98e 100644 --- a/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md +++ b/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md @@ -3,6 +3,7 @@ slug: /integrations/clickpipes/secure-kinesis sidebar_label: 'Kinesis Role-Based Access' title: 'Kinesis Role-Based Access' description: 'This article demonstrates how ClickPipes customers can leverage role-based access to authenticate with Amazon Kinesis and access their data streams securely.' +doc_type: 'how-to' --- import secure_kinesis from '@site/static/images/integrations/data-ingestion/clickpipes/securekinesis.jpg'; diff --git a/docs/integrations/data-ingestion/clickpipes/secure-rds.md b/docs/integrations/data-ingestion/clickpipes/secure-rds.md index e3e90e0bb10..c408cac068a 100644 --- a/docs/integrations/data-ingestion/clickpipes/secure-rds.md +++ b/docs/integrations/data-ingestion/clickpipes/secure-rds.md @@ -3,6 +3,7 @@ slug: /integrations/clickpipes/secure-rds sidebar_label: 'AWS IAM DB Authentication (RDS/Aurora)' title: 'AWS IAM DB Authentication (RDS/Aurora)' description: 'This article demonstrates how ClickPipes customers can leverage role-based access to authenticate with Amazon RDS/Aurora and access their database securely.' +doc_type: 'how-to' --- import secures3_arn from '@site/static/images/cloud/security/secures3_arn.png'; diff --git a/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md b/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md index 58968b30633..9fe374424ff 100644 --- a/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md +++ b/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md @@ -4,6 +4,7 @@ sidebar_position: 5 slug: /integrations/data-formats/arrow-avro-orc title: 'Working with Avro, Arrow, and ORC data in ClickHouse' description: 'Page describing how to work with Avro, Arrow and ORC data in ClickHouse' +doc_type: 'how-to' --- # Working with Avro, Arrow, and ORC data in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/binary.md b/docs/integrations/data-ingestion/data-formats/binary.md index 254948a18fd..7377ed201e1 100644 --- a/docs/integrations/data-ingestion/data-formats/binary.md +++ b/docs/integrations/data-ingestion/data-formats/binary.md @@ -3,6 +3,7 @@ sidebar_label: 'Binary and Native' slug: /integrations/data-formats/binary-native title: 'Using native and binary formats in ClickHouse' description: 'Page describing how to use native and binary formats in ClickHouse' +doc_type: 'how-to' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/data-formats/csv-tsv.md b/docs/integrations/data-ingestion/data-formats/csv-tsv.md index 253993d1148..bb707412c96 100644 --- a/docs/integrations/data-ingestion/data-formats/csv-tsv.md +++ b/docs/integrations/data-ingestion/data-formats/csv-tsv.md @@ -3,6 +3,7 @@ sidebar_label: 'CSV and TSV' slug: /integrations/data-formats/csv-tsv title: 'Working with CSV and TSV data in ClickHouse' description: 'Page describing how to work with CSV and TSV data in ClickHouse' +doc_type: 'reference' --- # Working with CSV and TSV data in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/intro.md b/docs/integrations/data-ingestion/data-formats/intro.md index 54f5b5f41bc..2ef4174c890 100644 --- a/docs/integrations/data-ingestion/data-formats/intro.md +++ b/docs/integrations/data-ingestion/data-formats/intro.md @@ -6,6 +6,7 @@ keywords: ['clickhouse', 'CSV', 'TSV', 'Parquet', 'clickhouse-client', 'clickhou title: 'Importing from various data formats to ClickHouse' description: 'Page describing how to import various data formats into ClickHouse' show_related_blogs: true +doc_type: 'how-to' --- # Importing from various data formats to ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/json/exporting.md b/docs/integrations/data-ingestion/data-formats/json/exporting.md index 7a39c46c360..98fde15c3e7 100644 --- a/docs/integrations/data-ingestion/data-formats/json/exporting.md +++ b/docs/integrations/data-ingestion/data-formats/json/exporting.md @@ -3,6 +3,7 @@ title: 'Exporting JSON' slug: /integrations/data-formats/json/exporting description: 'How to export JSON data from ClickHouse' keywords: ['json', 'clickhouse', 'formats', 'exporting'] +doc_type: 'how-to' --- # Exporting JSON diff --git a/docs/integrations/data-ingestion/data-formats/json/formats.md b/docs/integrations/data-ingestion/data-formats/json/formats.md index 91fa04533a8..598a3fe6cc0 100644 --- a/docs/integrations/data-ingestion/data-formats/json/formats.md +++ b/docs/integrations/data-ingestion/data-formats/json/formats.md @@ -4,6 +4,7 @@ slug: /integrations/data-formats/json/other-formats description: 'Handling other JSON formats' sidebar_label: 'Handling other formats' keywords: ['json', 'formats', 'json formats'] +doc_type: 'reference' --- # Handling other JSON formats diff --git a/docs/integrations/data-ingestion/data-formats/json/inference.md b/docs/integrations/data-ingestion/data-formats/json/inference.md index a6c6eecb754..74e79f1c2ab 100644 --- a/docs/integrations/data-ingestion/data-formats/json/inference.md +++ b/docs/integrations/data-ingestion/data-formats/json/inference.md @@ -3,6 +3,7 @@ title: 'JSON schema inference' slug: /integrations/data-formats/json/inference description: 'How to use JSON schema inference' keywords: ['json', 'schema', 'inference', 'schema inference'] +doc_type: 'reference' --- ClickHouse can automatically determine the structure of JSON data. This can be used to query JSON data directly e.g. on disk with `clickhouse-local` or S3 buckets, and/or automatically create schemas prior to loading the data into ClickHouse. diff --git a/docs/integrations/data-ingestion/data-formats/json/intro.md b/docs/integrations/data-ingestion/data-formats/json/intro.md index ff7fe692bfb..b7d288d4060 100644 --- a/docs/integrations/data-ingestion/data-formats/json/intro.md +++ b/docs/integrations/data-ingestion/data-formats/json/intro.md @@ -6,6 +6,7 @@ slug: /integrations/data-formats/json/overview description: 'Working with JSON in ClickHouse' keywords: ['json', 'clickhouse'] score: 10 +doc_type: 'how-to' --- # JSON Overview diff --git a/docs/integrations/data-ingestion/data-formats/json/loading.md b/docs/integrations/data-ingestion/data-formats/json/loading.md index 5ec169066f3..d19f20da9b9 100644 --- a/docs/integrations/data-ingestion/data-formats/json/loading.md +++ b/docs/integrations/data-ingestion/data-formats/json/loading.md @@ -6,6 +6,7 @@ slug: /integrations/data-formats/json/loading description: 'Loading JSON' keywords: ['json', 'clickhouse', 'inserting', 'loading', 'inserting'] score: 15 +doc_type: 'tutorial' --- # Loading JSON {#loading-json} diff --git a/docs/integrations/data-ingestion/data-formats/json/other.md b/docs/integrations/data-ingestion/data-formats/json/other.md index 95411202514..2c4f1e20b22 100644 --- a/docs/integrations/data-ingestion/data-formats/json/other.md +++ b/docs/integrations/data-ingestion/data-formats/json/other.md @@ -3,6 +3,7 @@ title: 'Other JSON approaches' slug: /integrations/data-formats/json/other-approaches description: 'Other approaches to modeling JSON' keywords: ['json', 'formats'] +doc_type: 'explanation' --- # Other approaches to modeling JSON diff --git a/docs/integrations/data-ingestion/data-formats/json/schema.md b/docs/integrations/data-ingestion/data-formats/json/schema.md index af0ca123b67..74488afe75f 100644 --- a/docs/integrations/data-ingestion/data-formats/json/schema.md +++ b/docs/integrations/data-ingestion/data-formats/json/schema.md @@ -4,6 +4,7 @@ slug: /integrations/data-formats/json/schema description: 'How to optimally design JSON schemas' keywords: ['json', 'clickhouse', 'inserting', 'loading', 'formats', 'schema', 'structured', 'semi-structured'] score: 20 +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/data-formats/parquet.md b/docs/integrations/data-ingestion/data-formats/parquet.md index 01afd4efdd3..af120ba9b8a 100644 --- a/docs/integrations/data-ingestion/data-formats/parquet.md +++ b/docs/integrations/data-ingestion/data-formats/parquet.md @@ -4,6 +4,7 @@ sidebar_position: 3 slug: /integrations/data-formats/parquet title: 'Working with Parquet in ClickHouse' description: 'Page describing how to work with Parquet in ClickHouse' +doc_type: 'how-to' --- # Working with Parquet in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/sql.md b/docs/integrations/data-ingestion/data-formats/sql.md index e3ec019c4d6..4e76f93981d 100644 --- a/docs/integrations/data-ingestion/data-formats/sql.md +++ b/docs/integrations/data-ingestion/data-formats/sql.md @@ -3,6 +3,7 @@ sidebar_label: 'SQL Dumps' slug: /integrations/data-formats/sql title: 'Inserting and dumping SQL data in ClickHouse' description: 'Page describing how to transfer data between other databases and ClickHouse using SQL dumps.' +doc_type: 'how-to' --- # Inserting and dumping SQL data in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/templates-regex.md b/docs/integrations/data-ingestion/data-formats/templates-regex.md index c3f4fc18f4b..ec95e0a78b2 100644 --- a/docs/integrations/data-ingestion/data-formats/templates-regex.md +++ b/docs/integrations/data-ingestion/data-formats/templates-regex.md @@ -4,6 +4,7 @@ sidebar_position: 3 slug: /integrations/data-formats/templates-regexp title: 'Importing and exporting custom text data using Templates and Regex in ClickHouse' description: 'Page describing how to import and export custom text using templates and regex in ClickHouse' +doc_type: 'reference' --- # Importing and exporting custom text data using Templates and Regex in ClickHouse diff --git a/docs/integrations/data-ingestion/data-ingestion-index.md b/docs/integrations/data-ingestion/data-ingestion-index.md index 0f88aa8e1a4..28f91086d9d 100644 --- a/docs/integrations/data-ingestion/data-ingestion-index.md +++ b/docs/integrations/data-ingestion/data-ingestion-index.md @@ -3,6 +3,7 @@ slug: /integrations/data-ingestion-overview keywords: [ 'Airbyte', 'Apache Spark', 'Spark', 'Azure Synapse', 'Amazon Glue', 'Apache Beam', 'dbt', 'Fivetran', 'NiFi', 'dlt', 'Vector' ] title: 'Data Ingestion' description: 'Landing page for the data ingestion section' +doc_type: 'reference' --- # Data Ingestion diff --git a/docs/integrations/data-ingestion/data-sources-index.md b/docs/integrations/data-ingestion/data-sources-index.md index 9344185da62..69e9d38aac3 100644 --- a/docs/integrations/data-ingestion/data-sources-index.md +++ b/docs/integrations/data-ingestion/data-sources-index.md @@ -3,6 +3,7 @@ slug: /integrations/data-sources/index keywords: ['AWS S3', 'Azure Data Factory', 'PostgreSQL', 'Kafka', 'MySQL', 'Cassandra', 'Data Factory', 'Redis', 'RabbitMQ', 'MongoDB', 'Google Cloud Storage', 'Hive', 'Hudi', 'Iceberg', 'MinIO', 'Delta Lake', 'RocksDB', 'Splunk', 'SQLite', 'NATS', 'EMQX', 'local files', 'JDBC', 'ODBC'] description: 'Datasources overview page' title: 'Data Sources' +doc_type: 'reference' --- # Data sources diff --git a/docs/integrations/data-ingestion/dbms/dynamodb/index.md b/docs/integrations/data-ingestion/dbms/dynamodb/index.md index 144b95daca7..32d229dc096 100644 --- a/docs/integrations/data-ingestion/dbms/dynamodb/index.md +++ b/docs/integrations/data-ingestion/dbms/dynamodb/index.md @@ -6,6 +6,7 @@ description: 'ClickPipes allows you to connect ClickHouse to DynamoDB.' keywords: ['DynamoDB'] title: 'CDC from DynamoDB to ClickHouse' show_related_blogs: true +doc_type: 'tutorial' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md b/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md index 981a11bad97..4da23bdc435 100644 --- a/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md +++ b/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'jdbc', 'connect', 'integrate'] slug: /integrations/jdbc/jdbc-with-clickhouse description: 'The ClickHouse JDBC Bridge allows ClickHouse to access data from any external data source for which a JDBC driver is available' title: 'Connecting ClickHouse to external data sources with JDBC' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/dbms/mysql/index.md b/docs/integrations/data-ingestion/dbms/mysql/index.md index 47594a4417c..14a961536a6 100644 --- a/docs/integrations/data-ingestion/dbms/mysql/index.md +++ b/docs/integrations/data-ingestion/dbms/mysql/index.md @@ -6,6 +6,7 @@ description: 'The MySQL table engine allows you to connect ClickHouse to MySQL.' keywords: ['mysql'] title: 'Integrating MySQL with ClickHouse' show_related_blogs: true +doc_type: 'tutorial' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/dbms/odbc-with-clickhouse.md b/docs/integrations/data-ingestion/dbms/odbc-with-clickhouse.md index 73aae819a8e..1e5be9d9bec 100644 --- a/docs/integrations/data-ingestion/dbms/odbc-with-clickhouse.md +++ b/docs/integrations/data-ingestion/dbms/odbc-with-clickhouse.md @@ -4,6 +4,7 @@ sidebar_position: 1 title: 'ODBC' slug: /integrations/data-ingestion/dbms/odbc-with-clickhouse description: 'Page describing the ODBC integration' +doc_type: 'reference' --- import Content from '@site/docs/engines/table-engines/integrations/odbc.md'; diff --git a/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md b/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md index da2f81cc9f6..530a110346d 100644 --- a/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md +++ b/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md @@ -4,6 +4,7 @@ title: 'Connecting to PostgreSQL' keywords: ['clickhouse', 'postgres', 'postgresql', 'connect', 'integrate', 'table', 'engine'] description: 'Page describing the various ways to connect PostgreSQL to ClickHouse' show_related_blogs: true +doc_type: 'explanation' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md b/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md index 9b51f0c4461..40bd9dfc858 100644 --- a/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md +++ b/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md @@ -3,6 +3,7 @@ slug: /integrations/postgresql/inserting-data title: 'How to insert data from PostgreSQL' keywords: ['postgres', 'postgresql', 'inserts'] description: 'Page describing how to insert data from PostgresSQL using ClickPipes, PeerDB or the Postgres table function' +doc_type: 'how-to' --- We recommend reading [this guide](/guides/inserting-data) to learn best practices on inserting data to ClickHouse to optimize for insert performance. diff --git a/docs/integrations/data-ingestion/emqx/index.md b/docs/integrations/data-ingestion/emqx/index.md index 09e93ac070c..2a3a1033924 100644 --- a/docs/integrations/data-ingestion/emqx/index.md +++ b/docs/integrations/data-ingestion/emqx/index.md @@ -4,6 +4,7 @@ sidebar_position: 1 slug: /integrations/emqx description: 'Introduction to EMQX with ClickHouse' title: 'Integrating EMQX with ClickHouse' +doc_type: 'tutorial' --- import emqx_cloud_artitecture from '@site/static/images/integrations/data-ingestion/emqx/emqx-cloud-artitecture.png'; diff --git a/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md index d4ff6c85bd0..659c6b68db2 100644 --- a/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'Airbyte', 'connect', 'integrate', 'etl', 'data integra slug: /integrations/airbyte description: 'Stream data into ClickHouse using Airbyte data pipelines' title: 'Connect Airbyte to ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/etl-tools/apache-beam.md b/docs/integrations/data-ingestion/etl-tools/apache-beam.md index 04662198f65..7b5887757cd 100644 --- a/docs/integrations/data-ingestion/etl-tools/apache-beam.md +++ b/docs/integrations/data-ingestion/etl-tools/apache-beam.md @@ -3,6 +3,7 @@ sidebar_label: 'Apache Beam' slug: /integrations/apache-beam description: 'Users can ingest data into ClickHouse using Apache Beam' title: 'Integrating Apache Beam and ClickHouse' +doc_type: 'how-to' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md index f7594deb7df..1e86d6b4a83 100644 --- a/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'BladePipe', 'connect', 'integrate', 'cdc', 'etl', 'dat slug: /integrations/bladepipe description: 'Stream data into ClickHouse using BladePipe data pipelines' title: 'Connect BladePipe to ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/etl-tools/dbt/index.md b/docs/integrations/data-ingestion/etl-tools/dbt/index.md index a7e52bcef32..0a64ca85610 100644 --- a/docs/integrations/data-ingestion/etl-tools/dbt/index.md +++ b/docs/integrations/data-ingestion/etl-tools/dbt/index.md @@ -4,6 +4,7 @@ slug: /integrations/dbt sidebar_position: 1 description: 'Users can transform and model their data in ClickHouse using dbt' title: 'Integrating dbt and ClickHouse' +doc_type: 'tutorial' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md index 02aa71ca10a..82c42c8e04d 100644 --- a/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md @@ -4,6 +4,7 @@ keywords: ['clickhouse', 'dlt', 'connect', 'integrate', 'etl', 'data integration description: 'Load data into Clickhouse using dlt integration' title: 'Connect dlt to ClickHouse' slug: /integrations/data-ingestion/etl-tools/dlt-and-clickhouse +doc_type: 'how-to' --- import CommunityMaintainedBadge from '@theme/badges/CommunityMaintained'; diff --git a/docs/integrations/data-ingestion/etl-tools/fivetran/index.md b/docs/integrations/data-ingestion/etl-tools/fivetran/index.md index b8d127e3b7b..9528c9cbb08 100644 --- a/docs/integrations/data-ingestion/etl-tools/fivetran/index.md +++ b/docs/integrations/data-ingestion/etl-tools/fivetran/index.md @@ -4,6 +4,7 @@ slug: /integrations/fivetran sidebar_position: 2 description: 'Users can transform and model their data in ClickHouse using dbt' title: 'Fivetran and ClickHouse Cloud' +doc_type: 'reference' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md index b7249a06d11..429dc1fd050 100644 --- a/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'NiFi', 'connect', 'integrate', 'etl', 'data integratio slug: /integrations/nifi description: 'Stream data into ClickHouse using NiFi data pipelines' title: 'Connect Apache NiFi to ClickHouse' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md index 5dd69834249..805085a432b 100644 --- a/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/vector description: 'How to tail a log file into ClickHouse using Vector' title: 'Integrating Vector with ClickHouse' show_related_blogs: true +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/gcs/index.md b/docs/integrations/data-ingestion/gcs/index.md index dc4659a77a0..f8dfebc30d2 100644 --- a/docs/integrations/data-ingestion/gcs/index.md +++ b/docs/integrations/data-ingestion/gcs/index.md @@ -4,6 +4,7 @@ sidebar_position: 4 slug: /integrations/gcs description: 'Google Cloud Storage (GCS) Backed MergeTree' title: 'Integrate Google Cloud Storage with ClickHouse' +doc_type: 'tutorial' --- import BucketDetails from '@site/docs/_snippets/_GCS_authentication_and_bucket.md'; diff --git a/docs/integrations/data-ingestion/google-dataflow/dataflow.md b/docs/integrations/data-ingestion/google-dataflow/dataflow.md index f982e6c1618..baef7e33eff 100644 --- a/docs/integrations/data-ingestion/google-dataflow/dataflow.md +++ b/docs/integrations/data-ingestion/google-dataflow/dataflow.md @@ -4,6 +4,7 @@ slug: /integrations/google-dataflow/dataflow sidebar_position: 1 description: 'Users can ingest data into ClickHouse using Google Dataflow' title: 'Integrating Google Dataflow with ClickHouse' +doc_type: 'how-to' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/google-dataflow/java-runner.md b/docs/integrations/data-ingestion/google-dataflow/java-runner.md index fe6abe1e201..42997b5195f 100644 --- a/docs/integrations/data-ingestion/google-dataflow/java-runner.md +++ b/docs/integrations/data-ingestion/google-dataflow/java-runner.md @@ -4,6 +4,7 @@ slug: /integrations/google-dataflow/java-runner sidebar_position: 2 description: 'Users can ingest data into ClickHouse using Google Dataflow Java Runner' title: 'Dataflow Java Runner' +doc_type: 'how-to' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/google-dataflow/templates.md b/docs/integrations/data-ingestion/google-dataflow/templates.md index a7bcfb0b87e..3436325d3d0 100644 --- a/docs/integrations/data-ingestion/google-dataflow/templates.md +++ b/docs/integrations/data-ingestion/google-dataflow/templates.md @@ -4,6 +4,7 @@ slug: /integrations/google-dataflow/templates sidebar_position: 3 description: 'Users can ingest data into ClickHouse using Google Dataflow Templates' title: 'Google Dataflow Templates' +doc_type: 'reference' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md b/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md index 860980af59c..e7193a65988 100644 --- a/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md +++ b/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md @@ -4,6 +4,7 @@ sidebar_position: 1 slug: /integrations/google-dataflow/templates/bigquery-to-clickhouse description: 'Users can ingest data from BigQuery into ClickHouse using Google Dataflow Template' title: 'Dataflow BigQuery to ClickHouse template' +doc_type: 'reference' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-ingestion/insert-local-files.md b/docs/integrations/data-ingestion/insert-local-files.md index bf584f4e5aa..6b42723c675 100644 --- a/docs/integrations/data-ingestion/insert-local-files.md +++ b/docs/integrations/data-ingestion/insert-local-files.md @@ -5,6 +5,7 @@ title: 'Insert Local Files' slug: /integrations/data-ingestion/insert-local-files description: 'Learn about Insert Local Files' show_related_blogs: true +doc_type: 'explanation' --- # Insert local files diff --git a/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md b/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md index a395202e7c2..5bbcc2eb748 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md +++ b/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md @@ -5,6 +5,7 @@ slug: /integrations/kafka/cloud/confluent/sink-connector description: 'Guide to using the fully managed ClickHouse Connector Sinkon Confluent Cloud' title: 'Integrating Confluent Cloud with ClickHouse' keywords: ['Kafka', 'Confluent Cloud'] +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md b/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md index f2651bfc0f0..666a1b0067d 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md +++ b/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md @@ -4,6 +4,7 @@ sidebar_position: 3 slug: /integrations/kafka/cloud/confluent/custom-connector description: 'Using ClickHouse Connector Sink with Kafka Connect and ClickHouse' title: 'Integrating Confluent Cloud with ClickHouse' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/confluent/index.md b/docs/integrations/data-ingestion/kafka/confluent/index.md index be62342cb6b..5800d45ee68 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/index.md +++ b/docs/integrations/data-ingestion/kafka/confluent/index.md @@ -4,6 +4,7 @@ sidebar_position: 1 slug: /integrations/kafka/cloud/confluent description: 'Kafka Connectivity with Confluent Cloud' title: 'Integrating Confluent Cloud with ClickHouse' +doc_type: 'reference' --- # Integrating Confluent Cloud with ClickHouse diff --git a/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md b/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md index 8ebeb2d3358..f72ec7759b6 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md +++ b/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md @@ -4,6 +4,7 @@ sidebar_position: 4 slug: /integrations/kafka/cloud/confluent/http description: 'Using HTTP Connector Sink with Kafka Connect and ClickHouse' title: 'Confluent HTTP Sink Connector' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/index.md b/docs/integrations/data-ingestion/kafka/index.md index bde0ca73608..36b20169c5f 100644 --- a/docs/integrations/data-ingestion/kafka/index.md +++ b/docs/integrations/data-ingestion/kafka/index.md @@ -4,6 +4,7 @@ sidebar_position: 1 slug: /integrations/kafka description: 'Introduction to Kafka with ClickHouse' title: 'Integrating Kafka with ClickHouse' +doc_type: 'reference' --- # Integrating Kafka with ClickHouse diff --git a/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md b/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md index d8dcb3f4969..1b81b045769 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md +++ b/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md @@ -4,6 +4,7 @@ sidebar_position: 2 slug: /integrations/kafka/clickhouse-kafka-connect-sink description: 'The official Kafka connector from ClickHouse.' title: 'ClickHouse Kafka Connect Sink' +doc_type: 'reference' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md b/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md index 3d637f4d561..752f0160d39 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md +++ b/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md @@ -4,6 +4,7 @@ sidebar_position: 4 slug: /integrations/kafka/kafka-connect-jdbc description: 'Using JDBC Connector Sink with Kafka Connect and ClickHouse' title: 'JDBC Connector' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md b/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md index 81edf388e47..c8eeec08a8a 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md +++ b/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md @@ -3,6 +3,7 @@ title: 'Integrating ClickHouse with Kafka using Named Collections' description: 'How to use named collections to connect clickhouse to kafka' keywords: ['named collection', 'how to', 'kafka'] slug: /integrations/data-ingestion/kafka/kafka-table-engine-named-collections +doc_type: 'how-to' --- # Integrating ClickHouse with Kafka using named collections diff --git a/docs/integrations/data-ingestion/kafka/kafka-table-engine.md b/docs/integrations/data-ingestion/kafka/kafka-table-engine.md index 4081e24f4bc..8cdacec6990 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-table-engine.md +++ b/docs/integrations/data-ingestion/kafka/kafka-table-engine.md @@ -4,6 +4,7 @@ sidebar_position: 5 slug: /integrations/kafka/kafka-table-engine description: 'Using the Kafka Table Engine' title: 'Using the Kafka table engine' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/kafka/kafka-vector.md b/docs/integrations/data-ingestion/kafka/kafka-vector.md index f326bf4b0a5..43ee5106af2 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-vector.md +++ b/docs/integrations/data-ingestion/kafka/kafka-vector.md @@ -4,6 +4,7 @@ sidebar_position: 3 slug: /integrations/kafka/kafka-vector description: 'Using Vector with Kafka and ClickHouse' title: 'Using Vector with Kafka and ClickHouse' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/msk/index.md b/docs/integrations/data-ingestion/kafka/msk/index.md index 547b2b9c30a..ad1f3f9cca4 100644 --- a/docs/integrations/data-ingestion/kafka/msk/index.md +++ b/docs/integrations/data-ingestion/kafka/msk/index.md @@ -5,6 +5,7 @@ slug: /integrations/kafka/cloud/amazon-msk/ description: 'The official Kafka connector from ClickHouse with Amazon MSK' keywords: ['integration', 'kafka', 'amazon msk', 'sink', 'connector'] title: 'Integrating Amazon MSK with ClickHouse' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/redshift/index.md b/docs/integrations/data-ingestion/redshift/index.md index 3e936cec37b..01ff878f2e7 100644 --- a/docs/integrations/data-ingestion/redshift/index.md +++ b/docs/integrations/data-ingestion/redshift/index.md @@ -5,6 +5,7 @@ description: 'Migrating Data from Redshift to ClickHouse' title: 'Migrating data from Redshift to ClickHouse' keywords: ['Redshift'] show_related_blogs: true +doc_type: 'tutorial' --- import redshiftToClickhouse from '@site/static/images/integrations/data-ingestion/redshift/redshift-to-clickhouse.png'; diff --git a/docs/integrations/data-ingestion/s3-minio.md b/docs/integrations/data-ingestion/s3-minio.md index c40e23dbac2..9c1ce208547 100644 --- a/docs/integrations/data-ingestion/s3-minio.md +++ b/docs/integrations/data-ingestion/s3-minio.md @@ -4,6 +4,7 @@ sidebar_position: 6 slug: /integrations/minio description: 'Page describing how to use MinIO with ClickHouse' title: 'Using MinIO' +doc_type: 'how-to' --- # Using MinIO diff --git a/docs/integrations/data-ingestion/s3/index.md b/docs/integrations/data-ingestion/s3/index.md index c2195918426..fb15f597281 100644 --- a/docs/integrations/data-ingestion/s3/index.md +++ b/docs/integrations/data-ingestion/s3/index.md @@ -4,6 +4,7 @@ sidebar_position: 1 sidebar_label: 'Integrating S3 with ClickHouse' title: 'Integrating S3 with ClickHouse' description: 'Page describing how to integrate S3 with ClickHouse' +doc_type: 'how-to' --- import BucketDetails from '@site/docs/_snippets/_S3_authentication_and_bucket.md'; diff --git a/docs/integrations/data-ingestion/s3/performance.md b/docs/integrations/data-ingestion/s3/performance.md index e9cabe29d6f..36854033f94 100644 --- a/docs/integrations/data-ingestion/s3/performance.md +++ b/docs/integrations/data-ingestion/s3/performance.md @@ -4,6 +4,7 @@ sidebar_position: 2 sidebar_label: 'Optimizing for Performance' title: 'Optimizing for S3 Insert and Read Performance' description: 'Optimizing the performance of S3 read and insert' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-sources/cassandra.md b/docs/integrations/data-sources/cassandra.md index 983ab3967e6..943a5d9e1df 100644 --- a/docs/integrations/data-sources/cassandra.md +++ b/docs/integrations/data-sources/cassandra.md @@ -3,6 +3,7 @@ slug: /integrations/cassandra sidebar_label: 'Cassandra' title: 'Cassandra' description: 'Page describing how users can integrate with Cassandra via a dictionary.' +doc_type: 'reference' --- # Cassandra integration diff --git a/docs/integrations/data-sources/deltalake.md b/docs/integrations/data-sources/deltalake.md index 7e0efee394b..87956ae8009 100644 --- a/docs/integrations/data-sources/deltalake.md +++ b/docs/integrations/data-sources/deltalake.md @@ -3,6 +3,7 @@ slug: /integrations/deltalake sidebar_label: 'Delta Lake' title: 'Delta Lake' description: 'Page describing how users can integrate with the Delta lake table format via the table function.' +doc_type: 'reference' --- import DeltaLakeFunction from '@site/docs/sql-reference/table-functions/deltalake.md'; diff --git a/docs/integrations/data-sources/hive.md b/docs/integrations/data-sources/hive.md index 82f88e1250a..a841a252aef 100644 --- a/docs/integrations/data-sources/hive.md +++ b/docs/integrations/data-sources/hive.md @@ -4,6 +4,7 @@ sidebar_label: 'Hive' title: 'Hive' hide_title: true description: 'Page describing the Hive table engine' +doc_type: 'reference' --- import HiveTableEngine from '@site/docs/engines/table-engines/integrations/hive.md'; diff --git a/docs/integrations/data-sources/hudi.md b/docs/integrations/data-sources/hudi.md index ef7b220f0a8..7365c6b1bca 100644 --- a/docs/integrations/data-sources/hudi.md +++ b/docs/integrations/data-sources/hudi.md @@ -4,6 +4,7 @@ sidebar_label: 'Hudi' title: 'Hudi' hide_title: true description: 'Page describing the Hudi table engine' +doc_type: 'reference' --- import HudiTableEngine from '@site/docs/engines/table-engines/integrations/hudi.md'; diff --git a/docs/integrations/data-sources/iceberg.md b/docs/integrations/data-sources/iceberg.md index cb6db487847..07755e57bc2 100644 --- a/docs/integrations/data-sources/iceberg.md +++ b/docs/integrations/data-sources/iceberg.md @@ -3,6 +3,7 @@ slug: /integrations/iceberg sidebar_label: 'Iceberg' title: 'Iceberg' description: 'Page describing the IcebergFunction which can be used to integrate ClickHouse with the Iceberg table format' +doc_type: 'reference' --- import IcebergFunction from '@site/docs/sql-reference/table-functions/iceberg.md'; diff --git a/docs/integrations/data-sources/mongodb.md b/docs/integrations/data-sources/mongodb.md index 8750366c870..83ff9e661c3 100644 --- a/docs/integrations/data-sources/mongodb.md +++ b/docs/integrations/data-sources/mongodb.md @@ -4,6 +4,7 @@ sidebar_label: 'MongoDB' title: 'MongoDB' hide_title: true description: 'Page describing integration using the MongoDB engine' +doc_type: 'reference' --- import MongoDBEngine from '@site/docs/engines/table-engines/integrations/mongodb.md'; diff --git a/docs/integrations/data-sources/mysql.md b/docs/integrations/data-sources/mysql.md index 7d60df1a874..b1ac2eb9dee 100644 --- a/docs/integrations/data-sources/mysql.md +++ b/docs/integrations/data-sources/mysql.md @@ -4,6 +4,7 @@ sidebar_label: 'MySQL' title: 'MySQL' hide_title: true description: 'Page describing MySQL integration' +doc_type: 'reference' --- import MySQL from '@site/docs/integrations/data-ingestion/dbms/mysql/index.md'; diff --git a/docs/integrations/data-sources/nats.md b/docs/integrations/data-sources/nats.md index afc17e6c816..be9eeb6a75a 100644 --- a/docs/integrations/data-sources/nats.md +++ b/docs/integrations/data-sources/nats.md @@ -4,6 +4,7 @@ sidebar_label: 'NATS' title: 'NATS' hide_title: true description: 'Page describing integration with the NATS engine' +doc_type: 'reference' --- import NatsEngine from '@site/docs/engines/table-engines/integrations/nats.md'; diff --git a/docs/integrations/data-sources/postgres.md b/docs/integrations/data-sources/postgres.md index 4d21b4728cb..3acb8f9ceb0 100644 --- a/docs/integrations/data-sources/postgres.md +++ b/docs/integrations/data-sources/postgres.md @@ -4,6 +4,7 @@ sidebar_label: 'PostgreSQL' title: 'PostgreSQL' hide_title: false description: 'Page describing how to integrate Postgres with ClickHouse' +doc_type: 'how-to' --- import PostgreSQL from '@site/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md'; diff --git a/docs/integrations/data-sources/rabbitmq.md b/docs/integrations/data-sources/rabbitmq.md index 893541f9aac..a8e66cea6e7 100644 --- a/docs/integrations/data-sources/rabbitmq.md +++ b/docs/integrations/data-sources/rabbitmq.md @@ -4,6 +4,7 @@ sidebar_label: 'RabbitMQ' title: 'RabbitMQ' hide_title: true description: 'Page describing the RabbitMQEngine integration' +doc_type: 'reference' --- import RabbitMQEngine from '@site/docs/engines/table-engines/integrations/rabbitmq.md'; diff --git a/docs/integrations/data-sources/redis.md b/docs/integrations/data-sources/redis.md index b47d08ccb1d..761e8278699 100644 --- a/docs/integrations/data-sources/redis.md +++ b/docs/integrations/data-sources/redis.md @@ -3,6 +3,7 @@ slug: /integrations/redis sidebar_label: 'Redis' title: 'Redis' description: 'Page describing the Redis table function' +doc_type: 'reference' --- import RedisFunction from '@site/docs/sql-reference/table-functions/redis.md'; diff --git a/docs/integrations/data-sources/rocksdb.md b/docs/integrations/data-sources/rocksdb.md index 0fbf91f611a..5be85cc2a07 100644 --- a/docs/integrations/data-sources/rocksdb.md +++ b/docs/integrations/data-sources/rocksdb.md @@ -4,6 +4,7 @@ sidebar_label: 'RocksDB' title: 'RocksDB' hide_title: true description: 'Page describing the RocksDBTableEngine' +doc_type: 'reference' --- import RocksDBTableEngine from '@site/docs/engines/table-engines/integrations/embedded-rocksdb.md'; diff --git a/docs/integrations/data-sources/sqlite.md b/docs/integrations/data-sources/sqlite.md index 7bb019c60fe..3b9fd71435b 100644 --- a/docs/integrations/data-sources/sqlite.md +++ b/docs/integrations/data-sources/sqlite.md @@ -4,6 +4,7 @@ sidebar_label: 'SQLite' title: 'SQLite' hide_title: true description: 'Page describing integration using the SQLite engine' +doc_type: 'reference' --- import SQLiteEngine from '@site/docs/engines/table-engines/integrations/sqlite.md'; diff --git a/docs/integrations/data-visualization/astrato-and-clickhouse.md b/docs/integrations/data-visualization/astrato-and-clickhouse.md index f47b6856129..41fc2c60d58 100644 --- a/docs/integrations/data-visualization/astrato-and-clickhouse.md +++ b/docs/integrations/data-visualization/astrato-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/astrato keywords: ['clickhouse', 'Power BI', 'connect', 'integrate', 'ui', 'data apps', 'data viz', 'embedded analytics', 'Astrato'] description: 'Astrato brings true Self-Service BI to Enterprises & Data Businesses by putting analytics in the hands of every user, enabling them to build their own dashboards, reports and data apps, enabling the answering of data questions without IT help. Astrato accelerates adoption, speeds up decision-making, and unifies analytics, embedded analytics, data input, and data apps in one platform. Astrato unites action and analytics in one, introduce live write-back, interact with ML models, accelerate your analytics with AI – go beyond dashboarding, thanks to pushdown SQL support in Astrato.' title: 'Connecting Astrato to ClickHouse' +doc_type: 'how-to' --- import astrato_1_dataconnection from '@site/static/images/integrations/data-visualization/astrato_1_dataconnection.png'; diff --git a/docs/integrations/data-visualization/chartbrew-and-clickhouse.md b/docs/integrations/data-visualization/chartbrew-and-clickhouse.md index 21a6c30fbb5..ff6431121a0 100644 --- a/docs/integrations/data-visualization/chartbrew-and-clickhouse.md +++ b/docs/integrations/data-visualization/chartbrew-and-clickhouse.md @@ -5,6 +5,7 @@ sidebar_position: 131 slug: /integrations/chartbrew-and-clickhouse keywords: ['ClickHouse', 'Chartbrew', 'connect', 'integrate', 'visualization'] description: 'Connect Chartbrew to ClickHouse to create real-time dashboards and client reports.' +doc_type: 'how-to' --- import chartbrew_01 from '@site/static/images/integrations/data-visualization/chartbrew_01.png'; diff --git a/docs/integrations/data-visualization/deepnote.md b/docs/integrations/data-visualization/deepnote.md index 55a3d803e61..2de9d3e4c06 100644 --- a/docs/integrations/data-visualization/deepnote.md +++ b/docs/integrations/data-visualization/deepnote.md @@ -5,6 +5,7 @@ slug: /integrations/deepnote keywords: ['clickhouse', 'Deepnote', 'connect', 'integrate', 'notebook'] description: 'Efficiently query very large datasets, analyzing and modeling in the comfort of known notebook environment.' title: 'Connect ClickHouse to Deepnote' +doc_type: 'how-to' --- import deepnote_01 from '@site/static/images/integrations/data-visualization/deepnote_01.png'; diff --git a/docs/integrations/data-visualization/draxlr-and-clickhouse.md b/docs/integrations/data-visualization/draxlr-and-clickhouse.md index 1ded9c2f56e..90ee977165d 100644 --- a/docs/integrations/data-visualization/draxlr-and-clickhouse.md +++ b/docs/integrations/data-visualization/draxlr-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/draxlr keywords: ['clickhouse', 'Draxlr', 'connect', 'integrate', 'ui'] description: 'Draxlr is a Business intelligence tool with data visualization and analytics.' title: 'Connecting Draxlr to ClickHouse' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/embeddable-and-clickhouse.md b/docs/integrations/data-visualization/embeddable-and-clickhouse.md index 2534cf523c5..62a6bad16cf 100644 --- a/docs/integrations/data-visualization/embeddable-and-clickhouse.md +++ b/docs/integrations/data-visualization/embeddable-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/embeddable keywords: ['clickhouse', 'Embeddable', 'connect', 'integrate', 'ui'] description: 'Embeddable is a developer toolkit for building fast, interactive, fully-custom analytics experiences directly into your app.' title: 'Connecting Embeddable to ClickHouse' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/explo-and-clickhouse.md b/docs/integrations/data-visualization/explo-and-clickhouse.md index 2173ec92192..994b5539845 100644 --- a/docs/integrations/data-visualization/explo-and-clickhouse.md +++ b/docs/integrations/data-visualization/explo-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/explo keywords: ['clickhouse', 'Explo', 'connect', 'integrate', 'ui'] description: 'Explo is an easy-to-use, open source UI tool for asking questions about your data.' title: 'Connecting Explo to ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/fabi-and-clickhouse.md b/docs/integrations/data-visualization/fabi-and-clickhouse.md index a22236a0018..6254033e646 100644 --- a/docs/integrations/data-visualization/fabi-and-clickhouse.md +++ b/docs/integrations/data-visualization/fabi-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/fabi.ai keywords: ['clickhouse', 'Fabi.ai', 'connect', 'integrate', 'notebook', 'ui', 'analytics'] description: 'Fabi.ai is an all-in-one collaborate data analysis platform. You can leverage SQL, Python, AI, and no-code to build dashboard and data workflows faster than ever before' title: 'Connect ClickHouse to Fabi.ai' +doc_type: 'how-to' --- import fabi_01 from '@site/static/images/integrations/data-visualization/fabi_01.png'; diff --git a/docs/integrations/data-visualization/grafana/config.md b/docs/integrations/data-visualization/grafana/config.md index fd2186d62f2..9619432020c 100644 --- a/docs/integrations/data-visualization/grafana/config.md +++ b/docs/integrations/data-visualization/grafana/config.md @@ -4,6 +4,7 @@ sidebar_position: 3 slug: /integrations/grafana/config description: 'Configuration options for the ClickHouse data source plugin in Grafana' title: 'Configuring ClickHouse data source in Grafana' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/grafana/index.md b/docs/integrations/data-visualization/grafana/index.md index e0112629062..c491acffd56 100644 --- a/docs/integrations/data-visualization/grafana/index.md +++ b/docs/integrations/data-visualization/grafana/index.md @@ -5,6 +5,7 @@ slug: /integrations/grafana description: 'Introduction to using ClickHouse with Grafana' title: 'ClickHouse data source plugin for Grafana' show_related_blogs: true +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_native.md'; diff --git a/docs/integrations/data-visualization/grafana/query-builder.md b/docs/integrations/data-visualization/grafana/query-builder.md index be4d321a13c..64e900141ba 100644 --- a/docs/integrations/data-visualization/grafana/query-builder.md +++ b/docs/integrations/data-visualization/grafana/query-builder.md @@ -4,6 +4,7 @@ sidebar_position: 2 slug: /integrations/grafana/query-builder description: 'Using the Query Builder in the ClickHouse Grafana plugin' title: 'Query Builder' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/hashboard-and-clickhouse.md b/docs/integrations/data-visualization/hashboard-and-clickhouse.md index 67af29908e8..ca5bbd2e72e 100644 --- a/docs/integrations/data-visualization/hashboard-and-clickhouse.md +++ b/docs/integrations/data-visualization/hashboard-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/hashboard keywords: ['clickhouse', 'Hashboard', 'connect', 'integrate', 'ui', 'analytics'] description: 'Hashboard is a robust analytics platform that can be easily integrated with ClickHouse for real-time data analysis.' title: 'Connecting ClickHouse to Hashboard' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_native.md'; diff --git a/docs/integrations/data-visualization/index.md b/docs/integrations/data-visualization/index.md index 0e32a3ed2bd..8f977ef6ec3 100644 --- a/docs/integrations/data-visualization/index.md +++ b/docs/integrations/data-visualization/index.md @@ -5,6 +5,7 @@ keywords: ['ClickHouse', 'connect', 'Luzmo', 'Explo', 'Fabi.ai', 'Tableau', 'Gra title: 'Visualizing Data in ClickHouse' slug: /integrations/data-visualization description: 'Learn about Visualizing Data in ClickHouse' +doc_type: 'reference' --- # Visualizing data in ClickHouse diff --git a/docs/integrations/data-visualization/looker-and-clickhouse.md b/docs/integrations/data-visualization/looker-and-clickhouse.md index acee94b3457..6233502ceb6 100644 --- a/docs/integrations/data-visualization/looker-and-clickhouse.md +++ b/docs/integrations/data-visualization/looker-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/looker keywords: ['clickhouse', 'looker', 'connect', 'integrate', 'ui'] description: 'Looker is an enterprise platform for BI, data applications, and embedded analytics that helps you explore and share insights in real time.' title: 'Looker' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/looker-studio-and-clickhouse.md b/docs/integrations/data-visualization/looker-studio-and-clickhouse.md index b9ec7d7c97a..c6e66a7ee0f 100644 --- a/docs/integrations/data-visualization/looker-studio-and-clickhouse.md +++ b/docs/integrations/data-visualization/looker-studio-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/lookerstudio keywords: ['clickhouse', 'looker', 'studio', 'connect', 'mysql', 'integrate', 'ui'] description: 'Looker Studio, formerly Google Data Studio, is an online tool for converting data into customizable informative reports and dashboards.' title: 'Looker Studio' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/luzmo-and-clickhouse.md b/docs/integrations/data-visualization/luzmo-and-clickhouse.md index 2e3fff028a5..f80182b550f 100644 --- a/docs/integrations/data-visualization/luzmo-and-clickhouse.md +++ b/docs/integrations/data-visualization/luzmo-and-clickhouse.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'Luzmo', 'connect', 'integrate', 'ui', 'embedded'] description: 'Luzmo is an embedded analytics platform with a native ClickHouse integration, purpose-built for Software and SaaS applications.' title: 'Integrating Luzmo with ClickHouse' sidebar: 'integrations' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/metabase-and-clickhouse.md b/docs/integrations/data-visualization/metabase-and-clickhouse.md index d621c11cb9d..3194e868759 100644 --- a/docs/integrations/data-visualization/metabase-and-clickhouse.md +++ b/docs/integrations/data-visualization/metabase-and-clickhouse.md @@ -6,6 +6,7 @@ keywords: ['Metabase'] description: 'Metabase is an easy-to-use, open source UI tool for asking questions about your data.' title: 'Connecting Metabase to ClickHouse' show_related_blogs: true +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/mitzu-and-clickhouse.md b/docs/integrations/data-visualization/mitzu-and-clickhouse.md index 6dc80d9a9f7..919058a21ea 100644 --- a/docs/integrations/data-visualization/mitzu-and-clickhouse.md +++ b/docs/integrations/data-visualization/mitzu-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/mitzu keywords: ['clickhouse', 'Mitzu', 'connect', 'integrate', 'ui'] description: 'Mitzu is a no-code warehouse-native product analytics application.' title: 'Connecting Mitzu to ClickHouse' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/omni-and-clickhouse.md b/docs/integrations/data-visualization/omni-and-clickhouse.md index d3ddcaa9789..b6db6eaf644 100644 --- a/docs/integrations/data-visualization/omni-and-clickhouse.md +++ b/docs/integrations/data-visualization/omni-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/omni keywords: ['clickhouse', 'Omni', 'connect', 'integrate', 'ui'] description: 'Omni is an enterprise platform for BI, data applications, and embedded analytics that helps you explore and share insights in real time.' title: 'Omni' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/powerbi-and-clickhouse.md b/docs/integrations/data-visualization/powerbi-and-clickhouse.md index ea93ada5b08..6a9d6b9a273 100644 --- a/docs/integrations/data-visualization/powerbi-and-clickhouse.md +++ b/docs/integrations/data-visualization/powerbi-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/powerbi keywords: ['clickhouse', 'Power BI', 'connect', 'integrate', 'ui'] description: 'Microsoft Power BI is an interactive data visualization software product developed by Microsoft with a primary focus on business intelligence.' title: 'Power BI' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/quicksight-and-clickhouse.md b/docs/integrations/data-visualization/quicksight-and-clickhouse.md index 303c3c60279..c8c85ff5c63 100644 --- a/docs/integrations/data-visualization/quicksight-and-clickhouse.md +++ b/docs/integrations/data-visualization/quicksight-and-clickhouse.md @@ -4,6 +4,7 @@ slug: /integrations/quicksight keywords: ['clickhouse', 'aws', 'amazon', 'QuickSight', 'mysql', 'connect', 'integrate', 'ui'] description: 'Amazon QuickSight powers data-driven organizations with unified business intelligence (BI).' title: 'QuickSight' +doc_type: 'how-to' --- import MySQLOnPremiseSetup from '@site/docs/_snippets/_clickhouse_mysql_on_premise_setup.mdx'; diff --git a/docs/integrations/data-visualization/rocketbi-and-clickhouse.md b/docs/integrations/data-visualization/rocketbi-and-clickhouse.md index cacdc3acc3b..11c204bbff4 100644 --- a/docs/integrations/data-visualization/rocketbi-and-clickhouse.md +++ b/docs/integrations/data-visualization/rocketbi-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/rocketbi keywords: ['clickhouse', 'RocketBI', 'connect', 'integrate', 'ui'] description: 'RocketBI is a self-service business intelligence platform that helps you quickly analyze data, build drag-n-drop visualizations and collaborate with colleagues right on your web browser.' title: 'GOAL: BUILD YOUR 1ST DASHBOARD' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/splunk-and-clickhouse.md b/docs/integrations/data-visualization/splunk-and-clickhouse.md index 9da898cfcb7..31e327ee30d 100644 --- a/docs/integrations/data-visualization/splunk-and-clickhouse.md +++ b/docs/integrations/data-visualization/splunk-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/splunk keywords: ['Splunk', 'integration', 'data visualization'] description: 'Connect Splunk dashboards to ClickHouse' title: 'Connecting Splunk to ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/superset-and-clickhouse.md b/docs/integrations/data-visualization/superset-and-clickhouse.md index 8753506afda..ddf23393876 100644 --- a/docs/integrations/data-visualization/superset-and-clickhouse.md +++ b/docs/integrations/data-visualization/superset-and-clickhouse.md @@ -6,6 +6,7 @@ keywords: ['superset'] description: 'Apache Superset is an open-source data exploration and visualization platform.' title: 'Connect Superset to ClickHouse' show_related_blogs: true +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md b/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md index 08d4cdd5ca9..18375bb8749 100644 --- a/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md +++ b/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md @@ -5,6 +5,7 @@ slug: /integrations/tableau/analysis-tips keywords: ['clickhouse', 'tableau', 'online', 'mysql', 'connect', 'integrate', 'ui'] description: 'Tableau analysis tips when using ClickHouse official connector.' title: 'Analysis tips' +doc_type: 'reference' --- # Analysis tips diff --git a/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md b/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md index b931b7eb189..558b21e577b 100644 --- a/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md +++ b/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/tableau keywords: ['clickhouse', 'tableau', 'connect', 'integrate', 'ui'] description: 'Tableau can use ClickHouse databases and tables as a data source.' title: 'Connecting Tableau to ClickHouse' +doc_type: 'tutorial' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-visualization/tableau/tableau-connection-tips.md b/docs/integrations/data-visualization/tableau/tableau-connection-tips.md index 3392c21dc1c..f517a0aaf2d 100644 --- a/docs/integrations/data-visualization/tableau/tableau-connection-tips.md +++ b/docs/integrations/data-visualization/tableau/tableau-connection-tips.md @@ -5,6 +5,7 @@ slug: /integrations/tableau/connection-tips keywords: ['clickhouse', 'tableau', 'online', 'mysql', 'connect', 'integrate', 'ui'] description: 'Tableau connection tips when using ClickHouse official connector.' title: 'Connection tips' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md b/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md index 3f722896b8a..d9749f27f1b 100644 --- a/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md +++ b/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md @@ -5,6 +5,7 @@ slug: /integrations/tableau-online keywords: ['clickhouse', 'tableau', 'online', 'mysql', 'connect', 'integrate', 'ui'] description: 'Tableau Online streamlines the power of data to make people faster and more confident decision makers from anywhere.' title: 'Tableau Online' +doc_type: 'how-to' --- import MySQLCloudSetup from '@site/docs/_snippets/_clickhouse_mysql_cloud_setup.mdx'; diff --git a/docs/integrations/data-visualization/zingdata-and-clickhouse.md b/docs/integrations/data-visualization/zingdata-and-clickhouse.md index 431509786c1..af66c439674 100644 --- a/docs/integrations/data-visualization/zingdata-and-clickhouse.md +++ b/docs/integrations/data-visualization/zingdata-and-clickhouse.md @@ -6,6 +6,7 @@ keywords: ['Zing Data'] description: 'Zing Data is simple social business intelligence for ClickHouse, made for iOS, Android and the web.' title: 'Connect Zing Data to ClickHouse' show_related_blogs: true +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/language-clients/csharp.md b/docs/integrations/language-clients/csharp.md index 97c11abc56c..f08cc68e950 100644 --- a/docs/integrations/language-clients/csharp.md +++ b/docs/integrations/language-clients/csharp.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'cs', 'c#', '.net', 'dotnet', 'csharp', 'client', 'driv slug: /integrations/csharp description: 'The official C# client for connecting to ClickHouse.' title: 'ClickHouse C# Driver' +doc_type: 'tutorial' --- # ClickHouse C# Client diff --git a/docs/integrations/language-clients/go/index.md b/docs/integrations/language-clients/go/index.md index 68aa097ccaf..27dd8e8a938 100644 --- a/docs/integrations/language-clients/go/index.md +++ b/docs/integrations/language-clients/go/index.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'go', 'client', 'golang'] slug: /integrations/go description: 'The Go clients for ClickHouse allows users to connect to ClickHouse using either the Go standard database/sql interface or an optimized native interface.' title: 'ClickHouse Go' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_native.md'; diff --git a/docs/integrations/language-clients/index.md b/docs/integrations/language-clients/index.md index 3f3db2e10cc..45331727acb 100644 --- a/docs/integrations/language-clients/index.md +++ b/docs/integrations/language-clients/index.md @@ -3,6 +3,7 @@ slug: /integrations/language-clients title: 'Language Clients' description: 'Table of contents page for Language Clients.' keywords: ['Language Clients', 'C++', 'Go', 'JavaScript', 'Java', 'Python', 'Rust'] +doc_type: 'reference' --- In this section of the documentation, you can learn more about the many language client integrations diff --git a/docs/integrations/language-clients/java/index.md b/docs/integrations/language-clients/java/index.md index 216af1f7585..b816ab32529 100644 --- a/docs/integrations/language-clients/java/index.md +++ b/docs/integrations/language-clients/java/index.md @@ -3,6 +3,7 @@ title: 'Java' keywords: ['clickhouse', 'java', 'jdbc', 'client', 'integrate', 'r2dbc'] description: 'Options for connecting to ClickHouse from Java' slug: /integrations/java +doc_type: 'reference' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/language-clients/java/r2dbc.md b/docs/integrations/language-clients/java/r2dbc.md index c420f26484a..a1ba8a7662b 100644 --- a/docs/integrations/language-clients/java/r2dbc.md +++ b/docs/integrations/language-clients/java/r2dbc.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'java', 'driver', 'integrate', 'r2dbc'] description: 'ClickHouse R2DBC Driver' slug: /integrations/java/r2dbc title: 'R2DBC driver' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/language-clients/js.md b/docs/integrations/language-clients/js.md index a1a8172092f..aa5ba02650c 100644 --- a/docs/integrations/language-clients/js.md +++ b/docs/integrations/language-clients/js.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'js', 'JavaScript', 'NodeJS', 'web', 'browser', 'Cloudf slug: /integrations/javascript description: 'The official JS client for connecting to ClickHouse.' title: 'ClickHouse JS' +doc_type: 'reference' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/language-clients/moose-olap.md b/docs/integrations/language-clients/moose-olap.md index 987418e76f6..44de886e1e4 100644 --- a/docs/integrations/language-clients/moose-olap.md +++ b/docs/integrations/language-clients/moose-olap.md @@ -5,6 +5,7 @@ sidebar_position: 25 slug: /interfaces/third-party/moose-olap title: 'Developing on ClickHouse with Moose OLAP' keywords: ['Moose'] +doc_type: 'tutorial' --- import CommunityMaintainedBadge from '@theme/badges/CommunityMaintained'; diff --git a/docs/integrations/language-clients/python/index.md b/docs/integrations/language-clients/python/index.md index edeae79d993..bed30842ba1 100644 --- a/docs/integrations/language-clients/python/index.md +++ b/docs/integrations/language-clients/python/index.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'python', 'client', 'connect', 'integrate'] slug: /integrations/python description: 'The ClickHouse Connect project suite for connecting Python to ClickHouse' title: 'Python Integration with ClickHouse Connect' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/language-clients/rust.md b/docs/integrations/language-clients/rust.md index 9c57ed8c567..747252917a3 100644 --- a/docs/integrations/language-clients/rust.md +++ b/docs/integrations/language-clients/rust.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'rs', 'rust', 'cargo', 'crate', 'http', 'client', 'conn slug: /integrations/rust description: 'The official Rust client for connecting to ClickHouse.' title: 'ClickHouse Rust Client' +doc_type: 'explanation' --- # ClickHouse Rust client diff --git a/docs/integrations/migration/clickhouse-local-etl.md b/docs/integrations/migration/clickhouse-local-etl.md index 2faf0a935d7..586eb72c306 100644 --- a/docs/integrations/migration/clickhouse-local-etl.md +++ b/docs/integrations/migration/clickhouse-local-etl.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data', 'etl', 'el slug: /cloud/migration/clickhouse-local title: 'Migrating to ClickHouse using clickhouse-local' description: 'Guide showing how to migrate to ClickHouse using clickhouse-local' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/clickhouse-to-cloud.md b/docs/integrations/migration/clickhouse-to-cloud.md index 551314651e2..c215243702d 100644 --- a/docs/integrations/migration/clickhouse-to-cloud.md +++ b/docs/integrations/migration/clickhouse-to-cloud.md @@ -4,6 +4,7 @@ sidebar_label: 'ClickHouse to ClickHouse Cloud' slug: /cloud/migration/clickhouse-to-cloud title: 'Migrating between self-managed ClickHouse and ClickHouse Cloud' description: 'Page describing how to migrate between self-managed ClickHouse and ClickHouse Cloud' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/etl-tool-to-clickhouse.md b/docs/integrations/migration/etl-tool-to-clickhouse.md index f66e6ff2c47..f822a8e8108 100644 --- a/docs/integrations/migration/etl-tool-to-clickhouse.md +++ b/docs/integrations/migration/etl-tool-to-clickhouse.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data', 'etl', 'el slug: /cloud/migration/etl-tool-to-clickhouse title: 'Using a 3rd-party ETL Tool' description: 'Page describing how to use a 3rd-party ETL tool with ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/index.md b/docs/integrations/migration/index.md index f58f3bb14f8..c8da80d88f1 100644 --- a/docs/integrations/migration/index.md +++ b/docs/integrations/migration/index.md @@ -5,6 +5,7 @@ keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data'] description: 'Migrating To Cloud Table Of Contents' title: 'Migrating To Cloud' slug: /integrations/migration +doc_type: 'reference' --- This section of the docs explores how you can migrate from ClickHouse to ClickHouse Cloud. diff --git a/docs/integrations/migration/object-storage-to-clickhouse.md b/docs/integrations/migration/object-storage-to-clickhouse.md index 2f323db04ef..fe917510b40 100644 --- a/docs/integrations/migration/object-storage-to-clickhouse.md +++ b/docs/integrations/migration/object-storage-to-clickhouse.md @@ -3,6 +3,7 @@ title: 'Object Storage to ClickHouse Cloud' description: 'Moving data from object storage to ClickHouse Cloud' keywords: ['object storage', 's3', 'azure blob', 'gcs', 'migration'] slug: /integrations/migration/object-storage-to-clickhouse +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/overview.md b/docs/integrations/migration/overview.md index 46457d3c294..d5b82b08b86 100644 --- a/docs/integrations/migration/overview.md +++ b/docs/integrations/migration/overview.md @@ -5,6 +5,7 @@ slug: /integrations/migration/overview keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data'] title: 'Migrating Data into ClickHouse' description: 'Page describing the options available for migrating data into ClickHouse' +doc_type: 'how-to' --- # Migrating data into ClickHouse diff --git a/docs/integrations/misc/index.md b/docs/integrations/misc/index.md index cf0c7a6c583..3c81fd66165 100644 --- a/docs/integrations/misc/index.md +++ b/docs/integrations/misc/index.md @@ -3,6 +3,7 @@ slug: /integrations/misc keywords: ['Retool', 'Easypanel', 'Splunk'] title: 'Tools' description: 'Landing page for the Tools section' +doc_type: 'reference' --- # Tools diff --git a/docs/integrations/sql-clients/datagrip.md b/docs/integrations/sql-clients/datagrip.md index 11f33769bff..0acf409d331 100644 --- a/docs/integrations/sql-clients/datagrip.md +++ b/docs/integrations/sql-clients/datagrip.md @@ -3,6 +3,7 @@ sidebar_label: 'DataGrip' slug: /integrations/datagrip description: 'DataGrip is a database IDE that supports ClickHouse out of the box.' title: 'Connecting DataGrip to ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/dbeaver.md b/docs/integrations/sql-clients/dbeaver.md index 8e5b5bfee6e..31186b8439a 100644 --- a/docs/integrations/sql-clients/dbeaver.md +++ b/docs/integrations/sql-clients/dbeaver.md @@ -3,6 +3,7 @@ slug: /integrations/dbeaver sidebar_label: 'DBeaver' description: 'DBeaver is a multi-platform database tool.' title: 'Connect DBeaver to ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/dbvisualizer.md b/docs/integrations/sql-clients/dbvisualizer.md index 78901286134..eb49955fc43 100644 --- a/docs/integrations/sql-clients/dbvisualizer.md +++ b/docs/integrations/sql-clients/dbvisualizer.md @@ -3,6 +3,7 @@ sidebar_label: 'DbVisualizer' slug: /integrations/dbvisualizer description: 'DbVisualizer is a database tool with extended support for ClickHouse.' title: 'Connecting DbVisualizer to ClickHouse' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/sql-clients/index.md b/docs/integrations/sql-clients/index.md index 46f9c26296b..ed952526966 100644 --- a/docs/integrations/sql-clients/index.md +++ b/docs/integrations/sql-clients/index.md @@ -3,6 +3,7 @@ slug: /integrations/sql-clients/ description: 'Overview page for ClickHouse SQL clients.' keywords: ['integrations', 'DataGrip', 'DBeaver', 'DbVisualizer', 'Jupyter Notebooks', 'QStudio', 'TABLUM.IO', 'marimo'] title: 'SQL Client Integrations' +doc_type: 'reference' --- # SQL client integrations diff --git a/docs/integrations/sql-clients/jupysql.md b/docs/integrations/sql-clients/jupysql.md index ee2eea15c05..bc468f83b29 100644 --- a/docs/integrations/sql-clients/jupysql.md +++ b/docs/integrations/sql-clients/jupysql.md @@ -3,6 +3,7 @@ slug: /integrations/jupysql sidebar_label: 'Jupyter notebooks' description: 'JupySQL is a multi-platform database tool for Jupyter.' title: 'Using JupySQL with ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/marimo.md b/docs/integrations/sql-clients/marimo.md index cff3817d3a8..7d64697f06e 100644 --- a/docs/integrations/sql-clients/marimo.md +++ b/docs/integrations/sql-clients/marimo.md @@ -3,6 +3,7 @@ slug: /integrations/marimo sidebar_label: 'marimo' description: 'marimo is a next-generation Python notebook for interacting with data' title: 'Using marimo with ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/qstudio.md b/docs/integrations/sql-clients/qstudio.md index 4f0faa45fe1..a853b7e6e2a 100644 --- a/docs/integrations/sql-clients/qstudio.md +++ b/docs/integrations/sql-clients/qstudio.md @@ -3,6 +3,7 @@ slug: /integrations/qstudio sidebar_label: 'QStudio' description: 'QStudio is a free SQL tool.' title: 'Connect QStudio to ClickHouse' +doc_type: 'how-to' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/sql-clients/sql-console.md b/docs/integrations/sql-clients/sql-console.md index f2a9f4825eb..879ed3be3c7 100644 --- a/docs/integrations/sql-clients/sql-console.md +++ b/docs/integrations/sql-clients/sql-console.md @@ -4,6 +4,7 @@ sidebar_position: 1 title: 'SQL Console' slug: /integrations/sql-clients/sql-console description: 'Learn about SQL Console' +doc_type: 'how-to' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/integrations/sql-clients/tablum.md b/docs/integrations/sql-clients/tablum.md index 60f671ea7f6..194bd64b013 100644 --- a/docs/integrations/sql-clients/tablum.md +++ b/docs/integrations/sql-clients/tablum.md @@ -3,6 +3,7 @@ sidebar_label: 'TABLUM.IO' slug: /integrations/tablumio description: 'TABLUM.IO is a data management SaaS that supports ClickHouse out of the box.' title: 'Connecting TABLUM.IO to ClickHouse' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/tools/data-integration/easypanel/index.md b/docs/integrations/tools/data-integration/easypanel/index.md index 14f97a28899..dc20605558c 100644 --- a/docs/integrations/tools/data-integration/easypanel/index.md +++ b/docs/integrations/tools/data-integration/easypanel/index.md @@ -4,6 +4,7 @@ slug: /integrations/easypanel keywords: ['clickhouse', 'Easypanel', 'deployment', 'integrate', 'install'] description: 'You can use it to deploy ClickHouse on your own server.' title: 'Deploying ClickHouse on Easypanel' +doc_type: 'how-to' --- import CommunityMaintainedBadge from '@theme/badges/CommunityMaintained'; diff --git a/docs/integrations/tools/data-integration/index.md b/docs/integrations/tools/data-integration/index.md index c62c99f45e2..6771b8f6786 100644 --- a/docs/integrations/tools/data-integration/index.md +++ b/docs/integrations/tools/data-integration/index.md @@ -3,6 +3,7 @@ slug: /integrations/tools/data-integrations keywords: ['Retool', 'Easypanel', 'Splunk'] title: 'Data Integrations' description: 'Landing page for the data integrations section' +doc_type: 'reference' --- # Data Integrations diff --git a/docs/integrations/tools/data-integration/retool/index.md b/docs/integrations/tools/data-integration/retool/index.md index dc7bfba9642..663f33a3fc7 100644 --- a/docs/integrations/tools/data-integration/retool/index.md +++ b/docs/integrations/tools/data-integration/retool/index.md @@ -4,6 +4,7 @@ slug: /integrations/retool keywords: ['clickhouse', 'retool', 'connect', 'integrate', 'ui', 'admin', 'panel', 'dashboard', 'nocode', 'no-code'] description: 'Quickly build web and mobile apps with rich user interfaces, automate complex tasks, and integrate AI—all powered by your data.' title: 'Connecting Retool to ClickHouse' +doc_type: 'tutorial' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/tools/data-integration/splunk/index.md b/docs/integrations/tools/data-integration/splunk/index.md index 8b840ccbda7..aa9070fe8c2 100644 --- a/docs/integrations/tools/data-integration/splunk/index.md +++ b/docs/integrations/tools/data-integration/splunk/index.md @@ -4,6 +4,7 @@ slug: /integrations/audit-splunk keywords: ['clickhouse', 'Splunk', 'audit', 'cloud'] description: 'Store ClickHouse Cloud audit logs into Splunk.' title: 'Storing ClickHouse Cloud Audit logs into Splunk' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/tools/index.md b/docs/integrations/tools/index.md index 890fc562879..ff6dfefe913 100644 --- a/docs/integrations/tools/index.md +++ b/docs/integrations/tools/index.md @@ -3,6 +3,7 @@ slug: /integrations/tools keywords: ['Retool', 'Easypanel', 'Splunk'] title: 'Tools' description: 'Landing page for the tools section' +doc_type: 'reference' --- # Tools diff --git a/docs/intro.md b/docs/intro.md index fa8a1703a4e..c45550de22f 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -3,6 +3,7 @@ slug: /intro sidebar_label: 'What is ClickHouse?' description: 'ClickHouse® is a column-oriented SQL database management system (DBMS) for online analytical processing (OLAP). It is available as both an open-source software and a cloud offering.' title: 'What is ClickHouse?' +doc_type: 'explanation' --- import column_example from '@site/static/images/column-oriented-example-query.png'; diff --git a/docs/introduction-index.md b/docs/introduction-index.md index 4acb45d44c3..c43141f2804 100644 --- a/docs/introduction-index.md +++ b/docs/introduction-index.md @@ -3,6 +3,7 @@ slug: /introduction-clickhouse title: 'Introduction' description: 'Landing page for Introduction' pagination_next: null +doc_type: 'reference' --- Welcome to ClickHouse! Check out the pages below to learn how to get up and running with ClickHouse - the fastest and most resource efficient real-time data warehouse and open-source database. diff --git a/docs/managing-data/core-concepts/index.md b/docs/managing-data/core-concepts/index.md index 4404a163dbe..15bb27c7828 100644 --- a/docs/managing-data/core-concepts/index.md +++ b/docs/managing-data/core-concepts/index.md @@ -3,6 +3,7 @@ slug: /managing-data/core-concepts title: 'Core Concepts' description: 'Learn Core Concepts of how ClickHouse works' keywords: ['concepts', 'part', 'partition', 'primary index'] +doc_type: 'reference' --- In this section of the documentation, diff --git a/docs/managing-data/deleting-data/index.md b/docs/managing-data/deleting-data/index.md index a02d3dae796..05b5fe665a4 100644 --- a/docs/managing-data/deleting-data/index.md +++ b/docs/managing-data/deleting-data/index.md @@ -3,6 +3,7 @@ slug: /managing-data/deleting-data/overview title: 'Deleting Data' description: 'How to delete data in ClickHouse Table Of Contents' keywords: ['delete', 'truncate', 'drop', 'lightweight delete'] +doc_type: 'reference' --- In this section of the documentation, diff --git a/docs/managing-data/truncate.md b/docs/managing-data/truncate.md index d3a2a0409d3..55206e4e159 100644 --- a/docs/managing-data/truncate.md +++ b/docs/managing-data/truncate.md @@ -4,6 +4,7 @@ sidebar_label: 'Truncate Table' title: 'Truncate Table' hide_title: false description: 'Truncate allows the data in a table or database to be removed, while preserving their existence.' +doc_type: 'how-to' --- Truncate allows the data in a table or database to be removed, while preserving their existence. This is a lightweight operation which cannot be reversed. diff --git a/docs/managing-data/updating-data/index.md b/docs/managing-data/updating-data/index.md index fc1f07c6af2..a025868d57d 100644 --- a/docs/managing-data/updating-data/index.md +++ b/docs/managing-data/updating-data/index.md @@ -3,6 +3,7 @@ slug: /updating-data title: 'Updating Data' description: 'Updating Data Table Of Contents' keywords: ['update', 'updating data'] +doc_type: 'reference' --- In this section of the documentation, you will learn how you can update your data. diff --git a/docs/materialized-view/incremental-materialized-view.md b/docs/materialized-view/incremental-materialized-view.md index 18e3f8871aa..3047bb67a0c 100644 --- a/docs/materialized-view/incremental-materialized-view.md +++ b/docs/materialized-view/incremental-materialized-view.md @@ -4,6 +4,7 @@ title: 'Incremental materialized view' description: 'How to use incremental materialized views to speed up queries' keywords: ['incremental materialized views', 'speed up queries', 'query optimization'] score: 10000 +doc_type: 'how-to' --- import materializedViewDiagram from '@site/static/images/materialized-view/materialized-view-diagram.png'; diff --git a/docs/materialized-view/index.md b/docs/materialized-view/index.md index 6976401a192..3d1f1c7d2bc 100644 --- a/docs/materialized-view/index.md +++ b/docs/materialized-view/index.md @@ -3,6 +3,7 @@ slug: /materialized-views title: 'Materialized Views' description: 'Index page for materialized views' keywords: ['materialized views', 'speed up queries', 'query optimization', 'refreshable', 'incremental'] +doc_type: 'reference' --- | Page | Description | diff --git a/docs/materialized-view/refreshable-materialized-view.md b/docs/materialized-view/refreshable-materialized-view.md index 36d7a0b8f2c..3fe9b6bf698 100644 --- a/docs/materialized-view/refreshable-materialized-view.md +++ b/docs/materialized-view/refreshable-materialized-view.md @@ -3,6 +3,7 @@ slug: /materialized-view/refreshable-materialized-view title: 'Refreshable materialized view' description: 'How to use materialized views to speed up queries' keywords: ['refreshable materialized view', 'refresh', 'materialized views', 'speed up queries', 'query optimization'] +doc_type: 'how-to' --- import refreshableMaterializedViewDiagram from '@site/static/images/materialized-view/refreshable-materialized-view-diagram.png'; diff --git a/docs/migrations/bigquery/equivalent-concepts.md b/docs/migrations/bigquery/equivalent-concepts.md index ee330a0610c..5116bc73315 100644 --- a/docs/migrations/bigquery/equivalent-concepts.md +++ b/docs/migrations/bigquery/equivalent-concepts.md @@ -4,6 +4,7 @@ slug: /migrations/bigquery/biquery-vs-clickhouse-cloud description: 'How BigQuery differs from ClickHouse Cloud' keywords: ['BigQuery'] show_related_blogs: true +doc_type: 'reference' --- import bigquery_1 from '@site/static/images/migrations/bigquery-1.png'; diff --git a/docs/migrations/bigquery/index.md b/docs/migrations/bigquery/index.md index fdb90ce1ab8..5a5f5c907d7 100644 --- a/docs/migrations/bigquery/index.md +++ b/docs/migrations/bigquery/index.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null description: 'Landing page for the BigQuery migrations section' keywords: ['BigQuery', 'migration'] +doc_type: 'reference' --- In this section of the docs, learn more about the similarities and differences between BigQuery and ClickHouse Cloud, as well as why you might want to migrate and how to do so. diff --git a/docs/migrations/bigquery/loading-data.md b/docs/migrations/bigquery/loading-data.md index c39430ec10d..e65db6fb99c 100644 --- a/docs/migrations/bigquery/loading-data.md +++ b/docs/migrations/bigquery/loading-data.md @@ -4,6 +4,7 @@ title: 'Loading data from BigQuery to ClickHouse' slug: /migrations/bigquery/loading-data description: 'How to load data from BigQuery to ClickHouse' keywords: ['migrate', 'migration', 'migrating', 'data', 'etl', 'elt', 'BigQuery'] +doc_type: 'how-to' --- _This guide is compatible with ClickHouse Cloud and for self-hosted ClickHouse v23.5+._ diff --git a/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md b/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md index 44f8c8c7d20..75c0e66c061 100644 --- a/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md +++ b/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md @@ -4,6 +4,7 @@ slug: /migrations/bigquery/migrating-to-clickhouse-cloud description: 'How to migrate your data from BigQuery to ClickHouse Cloud' keywords: ['BigQuery'] show_related_blogs: true +doc_type: 'how-to' --- import bigquery_2 from '@site/static/images/migrations/bigquery-2.png'; diff --git a/docs/migrations/index.md b/docs/migrations/index.md index 3404415cac1..3a5ea806eaa 100644 --- a/docs/migrations/index.md +++ b/docs/migrations/index.md @@ -4,6 +4,7 @@ title: 'Migrations' pagination_prev: null pagination_next: null description: 'Landing page for the migrations section' +doc_type: 'reference' --- | Page | Description | diff --git a/docs/migrations/postgres/appendix.md b/docs/migrations/postgres/appendix.md index 532967514da..785aac2172d 100644 --- a/docs/migrations/postgres/appendix.md +++ b/docs/migrations/postgres/appendix.md @@ -3,6 +3,7 @@ slug: /migrations/postgresql/appendix title: 'Appendix' keywords: ['postgres', 'postgresql', 'data types', 'types'] description: 'Additional information relative to migrating from PostgreSQL' +doc_type: 'reference' --- import postgresReplicas from '@site/static/images/integrations/data-ingestion/dbms/postgres-replicas.png'; diff --git a/docs/migrations/postgres/data-modeling-techniques.md b/docs/migrations/postgres/data-modeling-techniques.md index f864bd8fb3e..1a62967b8c6 100644 --- a/docs/migrations/postgres/data-modeling-techniques.md +++ b/docs/migrations/postgres/data-modeling-techniques.md @@ -4,6 +4,7 @@ title: 'Data modeling techniques' description: 'Data modeling for migrating from PostgreSQL to ClickHouse' keywords: ['postgres', 'postgresql'] show_related_blogs: true +doc_type: 'tutorial' --- import postgres_b_tree from '@site/static/images/migrations/postgres-b-tree.png'; diff --git a/docs/migrations/postgres/dataset.md b/docs/migrations/postgres/dataset.md index 2574252e1da..8c1ebecbc8d 100644 --- a/docs/migrations/postgres/dataset.md +++ b/docs/migrations/postgres/dataset.md @@ -4,6 +4,7 @@ title: 'Migrating data' description: 'Dataset example to migrate from PostgreSQL to ClickHouse' keywords: ['Postgres'] show_related_blogs: true +doc_type: 'reference' --- import postgres_stackoverflow_schema from '@site/static/images/migrations/postgres-stackoverflow-schema.png'; diff --git a/docs/migrations/postgres/index.md b/docs/migrations/postgres/index.md index e4052fd1ab9..6b2e52cad31 100644 --- a/docs/migrations/postgres/index.md +++ b/docs/migrations/postgres/index.md @@ -4,6 +4,7 @@ pagination_prev: null pagination_next: null title: 'PostgreSQL' description: 'Landing page for the PostgreSQL migrations section' +doc_type: 'reference' --- | Page | Description | diff --git a/docs/migrations/postgres/overview.md b/docs/migrations/postgres/overview.md index ca1d195b914..3aaaab4e123 100644 --- a/docs/migrations/postgres/overview.md +++ b/docs/migrations/postgres/overview.md @@ -3,6 +3,7 @@ slug: /migrations/postgresql/overview title: 'Migrating from PostgreSQL to ClickHouse' description: 'A guide to migrating from PostgreSQL to ClickHouse' keywords: ['postgres', 'postgresql', 'migrate', 'migration'] +doc_type: 'explanation' --- ## Why use ClickHouse over Postgres? {#why-use-clickhouse-over-postgres} diff --git a/docs/migrations/postgres/rewriting-queries.md b/docs/migrations/postgres/rewriting-queries.md index 451d1b37d9a..af5000302cf 100644 --- a/docs/migrations/postgres/rewriting-queries.md +++ b/docs/migrations/postgres/rewriting-queries.md @@ -3,6 +3,7 @@ slug: /migrations/postgresql/rewriting-queries title: 'Rewriting PostgreSQL Queries' keywords: ['postgres', 'postgresql', 'rewriting queries'] description: 'Part 2 of a guide on migrating from PostgreSQL to ClickHouse' +doc_type: 'reference' --- > This is **Part 2** of a guide on migrating from PostgreSQL to ClickHouse. Using a practical example, it demonstrates how to efficiently carry out the migration with a real-time replication (CDC) approach. Many of the concepts covered are also applicable to manual bulk data transfers from PostgreSQL to ClickHouse. diff --git a/docs/migrations/snowflake.md b/docs/migrations/snowflake.md index 38d3b8dfac1..ea2307a16d0 100644 --- a/docs/migrations/snowflake.md +++ b/docs/migrations/snowflake.md @@ -6,6 +6,7 @@ description: 'Migrating from Snowflake to ClickHouse' keywords: ['Snowflake'] title: 'Migrating from Snowflake to ClickHouse' show_related_blogs: true +doc_type: 'how-to' --- import migrate_snowflake_clickhouse from '@site/static/images/migrations/migrate_snowflake_clickhouse.png'; diff --git a/docs/native-protocol/basics.md b/docs/native-protocol/basics.md index 7f77395a518..663c67e4b19 100644 --- a/docs/native-protocol/basics.md +++ b/docs/native-protocol/basics.md @@ -3,6 +3,7 @@ slug: /native-protocol/basics sidebar_position: 1 title: 'Basics' description: 'Native protocol basics' +doc_type: 'reference' --- # Basics diff --git a/docs/native-protocol/client.md b/docs/native-protocol/client.md index 5fe29e134f4..bbbd35b985e 100644 --- a/docs/native-protocol/client.md +++ b/docs/native-protocol/client.md @@ -3,6 +3,7 @@ slug: /native-protocol/client sidebar_position: 2 title: 'Native client packets' description: 'Native protocol client' +doc_type: 'how-to' --- # Client packets diff --git a/docs/native-protocol/columns.md b/docs/native-protocol/columns.md index e0b65368ac0..ffb36c9c414 100644 --- a/docs/native-protocol/columns.md +++ b/docs/native-protocol/columns.md @@ -3,6 +3,7 @@ slug: /native-protocol/columns sidebar_position: 4 title: 'Column types' description: 'Column types for the native protocol' +doc_type: 'reference' --- # Column types diff --git a/docs/native-protocol/hash.md b/docs/native-protocol/hash.md index 3de9ac70315..55d14907cb1 100644 --- a/docs/native-protocol/hash.md +++ b/docs/native-protocol/hash.md @@ -3,6 +3,7 @@ slug: /native-protocol/hash sidebar_position: 5 title: 'CityHash' description: 'Native protocol hash' +doc_type: 'reference' --- # CityHash diff --git a/docs/native-protocol/server.md b/docs/native-protocol/server.md index f3503a425b0..2cac99f987c 100644 --- a/docs/native-protocol/server.md +++ b/docs/native-protocol/server.md @@ -3,6 +3,7 @@ slug: /native-protocol/server sidebar_position: 3 title: 'Server packets' description: 'Native protocol server' +doc_type: 'how-to' --- # Server packets diff --git a/docs/starter-guides/index.md b/docs/starter-guides/index.md index feb98f67f63..e11fb4faf0e 100644 --- a/docs/starter-guides/index.md +++ b/docs/starter-guides/index.md @@ -4,6 +4,7 @@ title: 'Starter Guides' description: 'Landing page for starter guides' pagination_prev: null pagination_next: null +doc_type: 'reference' --- In this section of the docs you'll find starter guides for common SQL queries: `CREATE`, `INSERT`, `SELECT`, and mutations `UPDATE` and `DELETE`. diff --git a/docs/tools-and-utilities/static-files-disk-uploader.md b/docs/tools-and-utilities/static-files-disk-uploader.md index 3de2afe1cd1..d1b4f3442e1 100644 --- a/docs/tools-and-utilities/static-files-disk-uploader.md +++ b/docs/tools-and-utilities/static-files-disk-uploader.md @@ -3,6 +3,7 @@ slug: /operations/utilities/static-files-disk-uploader title: 'clickhouse-static-files-disk-uploader' keywords: ['clickhouse-static-files-disk-uploader', 'utility', 'disk', 'uploader'] description: 'Provides a description of the clickhouse-static-files-disk-uploader utility' +doc_type: 'how-to' --- # clickhouse-static-files-disk-uploader diff --git a/docs/tutorial.md b/docs/tutorial.md index 73c0b627f8d..836060a7d81 100644 --- a/docs/tutorial.md +++ b/docs/tutorial.md @@ -6,6 +6,7 @@ description: 'Learn how to ingest and query data in ClickHouse using a New York sidebar_position: 0.5 keywords: ['clickhouse', 'install', 'tutorial', 'dictionary', 'dictionaries', 'example', 'advanced', 'taxi', 'new york', 'nyc'] show_related_blogs: true +doc_type: 'tutorial' --- # Advanced Tutorial diff --git a/docs/use-cases/AI_ML/MCP/01_remote_mcp.md b/docs/use-cases/AI_ML/MCP/01_remote_mcp.md index 96fb158aa7d..9a22b06683c 100644 --- a/docs/use-cases/AI_ML/MCP/01_remote_mcp.md +++ b/docs/use-cases/AI_ML/MCP/01_remote_mcp.md @@ -8,6 +8,7 @@ description: 'This guide explains how to enable and use the ClickHouse Cloud Rem keywords: ['AI', 'ClickHouse Cloud', 'MCP'] show_related_blogs: true sidebar_position: 1 +doc_type: 'how-to' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/02_claude-desktop.md b/docs/use-cases/AI_ML/MCP/02_claude-desktop.md index dc822b5615f..eb2844c7280 100644 --- a/docs/use-cases/AI_ML/MCP/02_claude-desktop.md +++ b/docs/use-cases/AI_ML/MCP/02_claude-desktop.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Claude Desktop with a ClickHouse MCP server.' keywords: ['AI', 'Librechat', 'MCP'] show_related_blogs: true +doc_type: 'tutorial' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/03_librechat.md b/docs/use-cases/AI_ML/MCP/03_librechat.md index f2c88b8a5e9..83fd7a98f91 100644 --- a/docs/use-cases/AI_ML/MCP/03_librechat.md +++ b/docs/use-cases/AI_ML/MCP/03_librechat.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This guide explains how to set up LibreChat with a ClickHouse MCP server using Docker.' keywords: ['AI', 'Librechat', 'MCP'] show_related_blogs: true +doc_type: 'tutorial' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/04_anythingllm.md b/docs/use-cases/AI_ML/MCP/04_anythingllm.md index bb3370069f7..937cc6addb4 100644 --- a/docs/use-cases/AI_ML/MCP/04_anythingllm.md +++ b/docs/use-cases/AI_ML/MCP/04_anythingllm.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This guide explains how to set up AnythingLLM with a ClickHouse MCP server using Docker.' keywords: ['AI', 'AnythingLLM', 'MCP'] show_related_blogs: true +doc_type: 'how-to' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/05_open-webui.md b/docs/use-cases/AI_ML/MCP/05_open-webui.md index 996c185e792..009ad8ec6a7 100644 --- a/docs/use-cases/AI_ML/MCP/05_open-webui.md +++ b/docs/use-cases/AI_ML/MCP/05_open-webui.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Open WebUI with a ClickHouse MCP server using Docker.' keywords: ['AI', 'Open WebUI', 'MCP'] show_related_blogs: true +doc_type: 'tutorial' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/06_ollama.md b/docs/use-cases/AI_ML/MCP/06_ollama.md index 02e38cef3c0..0a39fd00e38 100644 --- a/docs/use-cases/AI_ML/MCP/06_ollama.md +++ b/docs/use-cases/AI_ML/MCP/06_ollama.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Ollama with a ClickHouse MCP server.' keywords: ['AI', 'Ollama', 'MCP'] show_related_blogs: true +doc_type: 'how-to' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/07_janai.md b/docs/use-cases/AI_ML/MCP/07_janai.md index 64b2d909bde..d14cbbc906c 100644 --- a/docs/use-cases/AI_ML/MCP/07_janai.md +++ b/docs/use-cases/AI_ML/MCP/07_janai.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Jan.ai with a ClickHouse MCP server.' keywords: ['AI', 'Jan.ai', 'MCP'] show_related_blogs: true +doc_type: 'how-to' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md index 8eda3c5aac2..5cdbe83aa77 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how build an AI Agent with Agno and the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'Agno'] show_related_blogs: true +doc_type: 'how-to' --- # How to build an AI Agent with Agno and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md index 09238237422..5b494197bd3 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to use Chainlit to build LLM-based chat apps together with the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'Chainlit'] show_related_blogs: true +doc_type: 'tutorial' --- # How to build an AI agent with Chainlit and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md index ece4180d2ff..8782fa7906d 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build an agentic application using data stored in ClickHouse with ClickHouse MCP and CopilotKit' keywords: ['ClickHouse', 'MCP', 'copilotkit'] show_related_blogs: true +doc_type: 'tutorial' --- # How to build an AI agent with CopilotKit and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md index 777dae48937..cbf0d847a28 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build an AI agent with DSPy and the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'DSPy'] show_related_blogs: true +doc_type: 'how-to' --- # How to build an AI Agent with DSPy and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md index ff5c7f8f3e6..1fc2dc85a3a 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null description: 'Learn how to build an AI agent with DSPy and the ClickHouse MCP Server' keywords: ['ClickHouse', 'Agno', 'Chainlit', 'MCP', 'DSPy', 'LangChain', 'LlamaIndex', 'OpenAI agents', 'PydanticAI', 'SlackBot', 'StreamLit'] +doc_type: 'reference' --- # Guides for integrating AI agent libraries with ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md index 9f99f668978..6c93c99d56e 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build a LangChain/LangGraph AI agent that can interact with ClickHouse''s SQL playground using ClickHouse''s MCP Server.' keywords: ['ClickHouse', 'MCP', 'LangChain', 'LangGraph'] show_related_blogs: true +doc_type: 'how-to' --- # How to build a LangChain/LangGraph AI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md index af6bd90534c..03722907c98 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build a LlamaIndex AI agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'LlamaIndex'] show_related_blogs: true +doc_type: 'how-to' --- # How to build a LlamaIndex AI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md index 1c44d780c39..fe28de23751 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build an OpenAI agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'OpenAI'] show_related_blogs: true +doc_type: 'how-to' --- # How to build an OpenAI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md index 71efc7d1a78..9c2e19cd8c0 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build a PydanticAI agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'PydanticAI'] show_related_blogs: true +doc_type: 'how-to' --- # How to build a PydanticAI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md index e7cc096ceb8..3b031494cf1 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build a SlackBot agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'Slack', 'SlackBot', 'PydanticAI'] show_related_blogs: true +doc_type: 'how-to' --- # How to build a SlackBot agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md index 964d6f7f9bc..633e622555f 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md @@ -7,6 +7,7 @@ pagination_next: null description: 'Learn how to build a web-based AI Agent with Streamlit and the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'Streamlit', 'Agno', 'AI Agent'] show_related_blogs: true +doc_type: 'how-to' --- # How to build a ClickHouse-backed AI Agent with Streamlit diff --git a/docs/use-cases/AI_ML/MCP/index.md b/docs/use-cases/AI_ML/MCP/index.md index 353d777de53..67a00548b4a 100644 --- a/docs/use-cases/AI_ML/MCP/index.md +++ b/docs/use-cases/AI_ML/MCP/index.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This page provides an intro to Model Context Protocol (MCP) and has a table of contents for MCP guides.' keywords: ['ClickHouse', 'MCP'] show_related_blogs: true +doc_type: 'reference' --- import Image from '@theme/IdealImage'; @@ -62,6 +63,7 @@ Below are some guides showing how to use the ClickHouse MCP Server. | [How to build an OpenAI agent using ClickHouse MCP Server.](/use-cases/AI/MCP/ai-agent-libraries/openai-agents) | Learn how to build an OpenAI agent that can interact with ClickHouse MCP Server. | | [Set Up ClickHouse MCP Server with AnythingLLM and ClickHouse Cloud](/use-cases/AI/MCP/anythingllm) | This guide explains how to set up AnythingLLM with a ClickHouse MCP server using Docker. | | [Set Up ClickHouse MCP Server with Claude Desktop](/use-cases/AI/MCP/claude-desktop) | This guide explains how to set up Claude Desktop with a ClickHouse MCP server. | +| [Set Up ClickHouse MCP Server with Jan.ai](/use-cases/AI/MCP/janai) | This guide explains how to set up Jan.ai with a ClickHouse MCP server. | | [Set Up ClickHouse MCP Server with LibreChat and ClickHouse Cloud](/use-cases/AI/MCP/librechat) | This guide explains how to set up LibreChat with a ClickHouse MCP server using Docker. | | [Set Up ClickHouse MCP Server with Ollama](/use-cases/AI/MCP/ollama) | This guide explains how to set up Ollama with a ClickHouse MCP server. | | [Set Up ClickHouse MCP Server with Open WebUI and ClickHouse Cloud](/use-cases/AI/MCP/open-webui) | This guide explains how to set up Open WebUI with a ClickHouse MCP server using Docker. | diff --git a/docs/use-cases/AI_ML/ai-powered-sql-generation.md b/docs/use-cases/AI_ML/ai-powered-sql-generation.md index 3c8ee0010e4..3a7f026cf1e 100644 --- a/docs/use-cases/AI_ML/ai-powered-sql-generation.md +++ b/docs/use-cases/AI_ML/ai-powered-sql-generation.md @@ -7,6 +7,7 @@ pagination_next: null description: 'This guide explains how to use AI to generate SQL queries in ClickHouse Client or clickhouse-local.' keywords: ['AI', 'SQL generation'] show_related_blogs: true +doc_type: 'reference' --- Starting from ClickHouse 25.7, [ClickHouse Client](https://clickhouse.com/docs/interfaces/cli) and [clickhouse-local](https://clickhouse.com/docs/operations/utilities/clickhouse-local) include [AI-powered functionality](https://clickhouse.com/docs/interfaces/cli#ai-sql-generation) that converts natural language descriptions into SQL queries. This feature allows users to describe their data requirements in plain text, which the system then translates into corresponding SQL statements. diff --git a/docs/use-cases/AI_ML/index.md b/docs/use-cases/AI_ML/index.md index 3b4a877f7fe..b69c49ecb65 100644 --- a/docs/use-cases/AI_ML/index.md +++ b/docs/use-cases/AI_ML/index.md @@ -5,6 +5,7 @@ pagination_next: null slug: /use-cases/AI title: 'Machine learning and GenAI' keywords: ['machine learning', 'genAI', 'AI'] +doc_type: 'reference' --- # Machine Learning and GenAI diff --git a/docs/use-cases/data_lake/glue_catalog.md b/docs/use-cases/data_lake/glue_catalog.md index 472683bfeb6..c2d86ed3965 100644 --- a/docs/use-cases/data_lake/glue_catalog.md +++ b/docs/use-cases/data_lake/glue_catalog.md @@ -8,6 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data in S3 buckets using ClickHouse and the AWS Glue Data Catalog.' keywords: ['Glue', 'Data Lake'] show_related_blogs: true +doc_type: 'reference' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/index.md b/docs/use-cases/data_lake/index.md index 1149c918ec7..0d7b4bca766 100644 --- a/docs/use-cases/data_lake/index.md +++ b/docs/use-cases/data_lake/index.md @@ -5,6 +5,7 @@ pagination_next: null slug: /use-cases/data-lake title: 'Data Lake' keywords: ['data lake', 'glue', 'unity', 'rest'] +doc_type: 'reference' --- ClickHouse supports integration with multiple catalogs (Unity, Glue, REST, Polaris, etc.). diff --git a/docs/use-cases/data_lake/lakekeeper_catalog.md b/docs/use-cases/data_lake/lakekeeper_catalog.md index 6c0eb373497..33f8942da66 100644 --- a/docs/use-cases/data_lake/lakekeeper_catalog.md +++ b/docs/use-cases/data_lake/lakekeeper_catalog.md @@ -8,6 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data using ClickHouse and the Lakekeeper Catalog.' keywords: ['Lakekeeper', 'REST', 'Tabular', 'Data Lake', 'Iceberg'] show_related_blogs: true +doc_type: 'tutorial' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/nessie_catalog.md b/docs/use-cases/data_lake/nessie_catalog.md index 98a4ec9b9a7..58b9716c7ec 100644 --- a/docs/use-cases/data_lake/nessie_catalog.md +++ b/docs/use-cases/data_lake/nessie_catalog.md @@ -8,6 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data using ClickHouse and the Nessie Catalog.' keywords: ['Nessie', 'REST', 'Transactional', 'Data Lake', 'Iceberg', 'Git-like'] show_related_blogs: true +doc_type: 'tutorial' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/rest_catalog.md b/docs/use-cases/data_lake/rest_catalog.md index 33d97f23dda..6b93ee05705 100644 --- a/docs/use-cases/data_lake/rest_catalog.md +++ b/docs/use-cases/data_lake/rest_catalog.md @@ -8,6 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data using ClickHouse and the REST Catalog.' keywords: ['REST', 'Tabular', 'Data Lake', 'Iceberg'] show_related_blogs: true +doc_type: 'tutorial' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/unity_catalog.md b/docs/use-cases/data_lake/unity_catalog.md index 83cfe9bae62..2b58d0c7ddb 100644 --- a/docs/use-cases/data_lake/unity_catalog.md +++ b/docs/use-cases/data_lake/unity_catalog.md @@ -8,6 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data in S3 buckets using ClickHouse and the Unity Catalog.' keywords: ['Unity', 'Data Lake'] show_related_blogs: true +doc_type: 'tutorial' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/index.md b/docs/use-cases/index.md index 69341937ce1..dc73935cab9 100644 --- a/docs/use-cases/index.md +++ b/docs/use-cases/index.md @@ -4,6 +4,7 @@ title: 'Use Case Guides' pagination_prev: null pagination_next: null description: 'Landing page for use case guides' +doc_type: 'reference' --- In this section of the docs you can find our use case guides. diff --git a/docs/use-cases/observability/build-your-own/demo-application.md b/docs/use-cases/observability/build-your-own/demo-application.md index acf870ef5de..45e71ce0f1d 100644 --- a/docs/use-cases/observability/build-your-own/demo-application.md +++ b/docs/use-cases/observability/build-your-own/demo-application.md @@ -3,6 +3,7 @@ title: 'Demo Application' description: 'Demo application for observability' slug: /observability/demo-application keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] +doc_type: 'reference' --- The OpenTelemetry project includes a [demo application](https://opentelemetry.io/docs/demo/). A maintained fork of this application with ClickHouse as a data source for logs and traces can be found [here](https://github.com/ClickHouse/opentelemetry-demo). The [official demo instructions](https://opentelemetry.io/docs/demo/docker-deployment/) can be followed to deploy this demo with docker. In addition to the [existing components](https://opentelemetry.io/docs/demo/collector-data-flow-dashboard/), an instance of ClickHouse will be deployed and used for the storage of logs and traces. diff --git a/docs/use-cases/observability/build-your-own/grafana.md b/docs/use-cases/observability/build-your-own/grafana.md index b44c5fb27b5..e8ece161dee 100644 --- a/docs/use-cases/observability/build-your-own/grafana.md +++ b/docs/use-cases/observability/build-your-own/grafana.md @@ -4,6 +4,7 @@ description: 'Using Grafana and ClickHouse for observability' slug: /observability/grafana keywords: ['Observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] show_related_blogs: true +doc_type: 'tutorial' --- import observability_15 from '@site/static/images/use-cases/observability/observability-15.png'; diff --git a/docs/use-cases/observability/build-your-own/index.md b/docs/use-cases/observability/build-your-own/index.md index 1ec79f79ba7..04788ea8b26 100644 --- a/docs/use-cases/observability/build-your-own/index.md +++ b/docs/use-cases/observability/build-your-own/index.md @@ -4,6 +4,7 @@ title: 'Build Your Own Observability Stack' pagination_prev: null pagination_next: null description: 'Landing page building your own observability stack' +doc_type: 'reference' --- This guide helps you build a custom observability stack using ClickHouse as the foundation. Learn how to design, implement, and optimize your observability solution for logs, metrics, and traces, with practical examples and best practices. diff --git a/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md b/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md index 0c81c84bb85..2e351f80c75 100644 --- a/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md +++ b/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md @@ -4,6 +4,7 @@ description: 'Integrating OpenTelemetry and ClickHouse for observability' slug: /observability/integrating-opentelemetry keywords: ['Observability', 'OpenTelemetry'] show_related_blogs: true +doc_type: 'how-to' --- import observability_3 from '@site/static/images/use-cases/observability/observability-3.png'; diff --git a/docs/use-cases/observability/build-your-own/introduction.md b/docs/use-cases/observability/build-your-own/introduction.md index ef2cacbcb33..9377cbd36c8 100644 --- a/docs/use-cases/observability/build-your-own/introduction.md +++ b/docs/use-cases/observability/build-your-own/introduction.md @@ -4,6 +4,7 @@ description: 'Using ClickHouse as an observability solution' slug: /use-cases/observability/introduction keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] show_related_blogs: true +doc_type: 'how-to' --- import observability_1 from '@site/static/images/use-cases/observability/observability-1.png'; diff --git a/docs/use-cases/observability/build-your-own/managing-data.md b/docs/use-cases/observability/build-your-own/managing-data.md index 02cab46abb8..83f9f0a6104 100644 --- a/docs/use-cases/observability/build-your-own/managing-data.md +++ b/docs/use-cases/observability/build-your-own/managing-data.md @@ -4,6 +4,7 @@ description: 'Managing Data for Observability' slug: /observability/managing-data keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] show_related_blogs: true +doc_type: 'tutorial' --- import observability_14 from '@site/static/images/use-cases/observability/observability-14.png'; diff --git a/docs/use-cases/observability/build-your-own/schema-design.md b/docs/use-cases/observability/build-your-own/schema-design.md index 1869d83ba4f..eb04f8fa7aa 100644 --- a/docs/use-cases/observability/build-your-own/schema-design.md +++ b/docs/use-cases/observability/build-your-own/schema-design.md @@ -4,6 +4,7 @@ description: 'Designing a schema design for observability' keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] slug: /use-cases/observability/schema-design show_related_blogs: true +doc_type: 'how-to' --- import observability_10 from '@site/static/images/use-cases/observability/observability-10.png'; diff --git a/docs/use-cases/observability/clickstack/alerts.md b/docs/use-cases/observability/clickstack/alerts.md index 11c5cfe9c17..18918d32aa7 100644 --- a/docs/use-cases/observability/clickstack/alerts.md +++ b/docs/use-cases/observability/clickstack/alerts.md @@ -5,6 +5,7 @@ sidebar_label: 'Alerts' pagination_prev: null pagination_next: null description: 'Alerts with ClickStack' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/architecture.md b/docs/use-cases/observability/clickstack/architecture.md index 57cffd93514..f767586ae2a 100644 --- a/docs/use-cases/observability/clickstack/architecture.md +++ b/docs/use-cases/observability/clickstack/architecture.md @@ -4,6 +4,7 @@ pagination_prev: null pagination_next: null description: 'Architecture of ClickStack - The ClickHouse Observability Stack' title: 'Architecture' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/config.md b/docs/use-cases/observability/clickstack/config.md index 788a7e68b4c..05c5e013dfe 100644 --- a/docs/use-cases/observability/clickstack/config.md +++ b/docs/use-cases/observability/clickstack/config.md @@ -4,6 +4,7 @@ title: 'Configuration Options' pagination_prev: null pagination_next: null description: 'Configuration options for ClickStack - The ClickHouse Observability Stack' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/dashboards.md b/docs/use-cases/observability/clickstack/dashboards.md index 84809ebd83c..11140f6a87d 100644 --- a/docs/use-cases/observability/clickstack/dashboards.md +++ b/docs/use-cases/observability/clickstack/dashboards.md @@ -5,6 +5,7 @@ sidebar_label: 'Dashboards' pagination_prev: null pagination_next: null description: 'Visualizations and Dashboards with ClickStack' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/all-in-one.md b/docs/use-cases/observability/clickstack/deployment/all-in-one.md index 2aeab9f4c7a..1e7c9e21b4d 100644 --- a/docs/use-cases/observability/clickstack/deployment/all-in-one.md +++ b/docs/use-cases/observability/clickstack/deployment/all-in-one.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 0 description: 'Deploying ClickStack with All In One - The ClickHouse Observability Stack' +doc_type: 'tutorial' --- import JSONSupport from '@site/docs/use-cases/observability/clickstack/deployment/_snippets/_json_support.md'; diff --git a/docs/use-cases/observability/clickstack/deployment/docker-compose.md b/docs/use-cases/observability/clickstack/deployment/docker-compose.md index 807cfb1acc4..1e8cab48dbb 100644 --- a/docs/use-cases/observability/clickstack/deployment/docker-compose.md +++ b/docs/use-cases/observability/clickstack/deployment/docker-compose.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 3 description: 'Deploying ClickStack with Docker Compose - The ClickHouse Observability Stack' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/helm.md b/docs/use-cases/observability/clickstack/deployment/helm.md index ed4ad898300..f7a8ff0964d 100644 --- a/docs/use-cases/observability/clickstack/deployment/helm.md +++ b/docs/use-cases/observability/clickstack/deployment/helm.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 2 description: 'Deploying ClickStack with Helm - The ClickHouse Observability Stack' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md b/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md index fab556c92ef..caa263cd833 100644 --- a/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md +++ b/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 1 description: 'Deploying ClickStack with ClickHouse Cloud' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md b/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md index aaf2b71cd35..6740181429b 100644 --- a/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md +++ b/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 4 description: 'Deploying HyperDX only' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/index.md b/docs/use-cases/observability/clickstack/deployment/index.md index 85b40c90475..7c93f6ea6b3 100644 --- a/docs/use-cases/observability/clickstack/deployment/index.md +++ b/docs/use-cases/observability/clickstack/deployment/index.md @@ -4,6 +4,7 @@ title: 'Deployment Options' pagination_prev: null pagination_next: null description: 'Deploying ClickStack - The ClickHouse Observability Stack' +doc_type: 'reference' --- ClickStack provides multiple deployment options to suit various use cases. diff --git a/docs/use-cases/observability/clickstack/deployment/local-mode-only.md b/docs/use-cases/observability/clickstack/deployment/local-mode-only.md index 7bded24aa01..ccf83858385 100644 --- a/docs/use-cases/observability/clickstack/deployment/local-mode-only.md +++ b/docs/use-cases/observability/clickstack/deployment/local-mode-only.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 5 description: 'Deploying ClickStack with Local Mode Only - The ClickHouse Observability Stack' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/index.md b/docs/use-cases/observability/clickstack/example-datasets/index.md index 0cd8cb18670..acf94a79156 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/index.md +++ b/docs/use-cases/observability/clickstack/example-datasets/index.md @@ -4,6 +4,7 @@ title: 'Sample Datasets' pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and sample datasets' +doc_type: 'reference' --- This section provides various sample datasets and examples to help you get started with ClickStack. These examples demonstrate different ways to work with observability data in ClickStack, from local development to production scenarios. diff --git a/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md b/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md index 51164d0b089..bee0c094fa8 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md +++ b/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md @@ -5,6 +5,7 @@ sidebar_position: 1 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and monitoring Kubernetes' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/local-data.md b/docs/use-cases/observability/clickstack/example-datasets/local-data.md index f0ccdddeae3..ece449ddd76 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/local-data.md +++ b/docs/use-cases/observability/clickstack/example-datasets/local-data.md @@ -5,6 +5,7 @@ sidebar_position: 1 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack local and system data and metrics' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md b/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md index d7a97c6f32f..617a1be89b3 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md +++ b/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md @@ -5,6 +5,7 @@ sidebar_position: 2 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and a remote demo dataset' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/sample-data.md b/docs/use-cases/observability/clickstack/example-datasets/sample-data.md index b6b3c860417..c1ea5575d34 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/sample-data.md +++ b/docs/use-cases/observability/clickstack/example-datasets/sample-data.md @@ -5,6 +5,7 @@ sidebar_position: 0 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and a sample dataset with logs, sessions, traces and metrics' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/getting-started.md b/docs/use-cases/observability/clickstack/getting-started.md index 4ab5bae0e19..881743eec89 100644 --- a/docs/use-cases/observability/clickstack/getting-started.md +++ b/docs/use-cases/observability/clickstack/getting-started.md @@ -5,6 +5,7 @@ sidebar_label: 'Getting Started' pagination_prev: null pagination_next: use-cases/observability/clickstack/example-datasets/index description: 'Getting started with ClickStack - The ClickHouse Observability Stack' +doc_type: 'tutorial' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/index.md b/docs/use-cases/observability/clickstack/index.md index 300779be624..13ef8181f5b 100644 --- a/docs/use-cases/observability/clickstack/index.md +++ b/docs/use-cases/observability/clickstack/index.md @@ -4,6 +4,7 @@ title: 'ClickStack - The ClickHouse Observability Stack' pagination_prev: null pagination_next: null description: 'Landing page for the ClickHouse Observability Stack' +doc_type: 'reference' --- **ClickStack** is a production-grade observability platform built on ClickHouse and OpenTelemetry (OTel), unifying logs, traces, metrics and session in a single high-performance solution. Designed for monitoring and debugging complex systems, ClickStack enables developers and SREs to trace issues end-to-end without switching between tools or manually stitching together data using timestamps or correlation IDs. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/collector.md b/docs/use-cases/observability/clickstack/ingesting-data/collector.md index 8e61466701c..5e03a89744d 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/collector.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/collector.md @@ -5,6 +5,7 @@ pagination_next: null description: 'OpenTelemetry collector for ClickStack - The ClickHouse Observability Stack' sidebar_label: 'OpenTelemetry Collector' title: 'ClickStack OpenTelemetry Collector' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/index.md b/docs/use-cases/observability/clickstack/ingesting-data/index.md index 20196403bf7..8c4cfd2c982 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/index.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/index.md @@ -4,6 +4,7 @@ pagination_prev: null pagination_next: null description: 'Data ingestion for ClickStack - The ClickHouse Observability Stack' title: 'Ingesting data' +doc_type: 'reference' --- ClickStack provides multiple ways to ingest observability data into your ClickHouse instance. Whether you're collecting logs, metrics, traces, or session data, you can use the OpenTelemetry (OTel) collector as a unified ingestion point or leverage platform-specific integrations for specialized use cases. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md b/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md index be89ba52f81..4335ce38499 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md @@ -4,6 +4,7 @@ pagination_prev: null pagination_next: null description: 'Kubernetes integration for ClickStack - The ClickHouse Observability Stack' title: 'Kubernetes' +doc_type: 'tutorial' --- ClickStack uses the OpenTelemetry (OTel) collector to collect logs, metrics, and Kubernetes events from Kubernetes clusters and forward them to ClickStack. We support the native OTel log format and require no additional vendor-specific configuration. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md b/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md index 721889d75dd..6db1e4fce1e 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md @@ -4,6 +4,7 @@ pagination_prev: null pagination_next: null description: 'Data ingestion with OpenTelemetry for ClickStack - The ClickHouse Observability Stack' title: 'Ingesting with OpenTelemetry' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/overview.md b/docs/use-cases/observability/clickstack/ingesting-data/overview.md index 39a2de304e5..4e8dca1aaed 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/overview.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/overview.md @@ -6,6 +6,7 @@ sidebar_position: 0 pagination_prev: null pagination_next: use-cases/observability/clickstack/ingesting-data/opentelemetry description: 'Overview for ingesting data to ClickStack' +doc_type: 'explanation' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/schemas.md b/docs/use-cases/observability/clickstack/ingesting-data/schemas.md index 473aba54acd..19e694a248d 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/schemas.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/schemas.md @@ -5,6 +5,7 @@ pagination_next: null description: 'Tables and schemas used by ClickStack - The ClickHouse Observability Stack' sidebar_label: 'Tables and Schemas' title: 'Tables and schemas used by ClickStack' +doc_type: 'reference' --- The ClickStack OpenTelemetry (OTel) collector uses the [ClickHouse exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/exporter/clickhouseexporter/README.md) to create tables in ClickHouse and insert data. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md index 3128056d834..e20fd8701da 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 6 description: 'AWS Lambda for ClickStack - The ClickHouse Observability Stack' title: 'AWS Lambda' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md index 20854a37e08..ff1b72019ff 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 0 description: 'Browser SDK for ClickStack - The ClickHouse Observability Stack' title: 'Browser JS' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md index e82b48a4f36..73d2e15eecf 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 6 description: 'Deno SDK for ClickStack - The ClickHouse Observability Stack' title: 'Deno' +doc_type: 'how-to' --- This guide Integrates the following: diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md index ad65b2937aa..9780f3ac66a 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 1 description: 'Elixir SDK for ClickStack - The ClickHouse Observability Stack' title: 'Elixir' +doc_type: 'how-to' --- diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md index f2ca0833ef5..af155d88936 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 2 description: 'Golang SDK for ClickStack - The ClickHouse Observability Stack' title: 'Golang' +doc_type: 'tutorial' --- ClickStack uses the OpenTelemetry standard for collecting telemetry data (logs and diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md index 9dc65b41ae2..684740f170f 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md @@ -4,6 +4,7 @@ pagination_prev: null pagination_next: null description: 'Language SDKs for ClickStack - The ClickHouse Observability Stack' title: 'Language SDKs' +doc_type: 'reference' --- Users typically send data to ClickStack via the **OpenTelemetry (OTel) collector**, either directly from language SDKs or through intermediate OpenTelemetry collector acting as agents e.g. collecting infrastructure metrics and logs. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md index 50e77dbf7ef..99d2ad3ad81 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 3 description: 'Java SDK for ClickStack - The ClickHouse Observability Stack' title: 'Java' +doc_type: 'how-to' --- ClickStack uses the OpenTelemetry standard for collecting telemetry data (logs and diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md index 42964cde1dc..944d18189f2 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 4 description: 'NestJS SDK for ClickStack - The ClickHouse Observability Stack' title: 'NestJS' +doc_type: 'how-to' --- The ClickStack NestJS integration allows you to create a logger or use the default diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md index be9f5dd8e0a..4cc30ebd9bb 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 4 description: 'Next.js SDK for ClickStack - The ClickHouse Observability Stack' title: 'Next.js' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md index 1e8a4c8411a..0d24736745a 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 5 description: 'Node.js SDK for ClickStack - The ClickHouse Observability Stack' title: 'Node.js' +doc_type: 'tutorial' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md index 89b725aff72..9c13f8d5f43 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 7 description: 'Python for ClickStack - The ClickHouse Observability Stack' title: 'Python' +doc_type: 'how-to' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md index da822eedbb2..008cd934363 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 7 description: 'React Native SDK for ClickStack - The ClickHouse Observability Stack' title: 'React Native' +doc_type: 'how-to' --- The ClickStack React Native SDK allows you to instrument your React Native diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md index 1bd4fa7cc37..84eade69bc2 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md @@ -5,6 +5,7 @@ pagination_next: null sidebar_position: 7 description: 'Ruby on Rails SDK for ClickStack - The ClickHouse Observability Stack' title: 'Ruby on Rails' +doc_type: 'tutorial' --- This guide integrates: diff --git a/docs/use-cases/observability/clickstack/migration/elastic/concepts.md b/docs/use-cases/observability/clickstack/migration/elastic/concepts.md index b63560bef62..f6b17e3a2c8 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/concepts.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/concepts.md @@ -8,6 +8,7 @@ sidebar_position: 1 description: 'Equivalent concepts - ClickStack and Elastic' show_related_blogs: true keywords: ['Elasticsearch'] +doc_type: 'explanation' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/elastic/index.md b/docs/use-cases/observability/clickstack/migration/elastic/index.md index e304d41f34d..c11f0a761e4 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/index.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/index.md @@ -6,6 +6,7 @@ pagination_next: null description: 'Landing page migrating to the ClickHouse Observability Stack from Elastic' show_related_blogs: true keywords: ['Elasticsearch'] +doc_type: 'reference' --- This guide provides a comprehensive approach to migrating from Elastic Stack to ClickStack. We focus on a parallel operation strategy that minimizes risk while leveraging ClickHouse's strengths in observability workloads. diff --git a/docs/use-cases/observability/clickstack/migration/elastic/intro.md b/docs/use-cases/observability/clickstack/migration/elastic/intro.md index 66bed39785f..be53fc980db 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/intro.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/intro.md @@ -8,6 +8,7 @@ sidebar_position: 0 description: 'Overview for migrating to the ClickHouse Observability Stack from Elastic' show_related_blogs: true keywords: ['Elasticsearch'] +doc_type: 'explanation' --- ## Migrating to ClickStack from Elastic {#migrating-to-clickstack-from-elastic} diff --git a/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md b/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md index da4072283c0..a441e1a97f7 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md @@ -8,6 +8,7 @@ sidebar_position: 5 description: 'Migrating agents from Elastic' show_related_blogs: true keywords: ['ClickStack'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md b/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md index c4bd8ce828b..27279e1580c 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md @@ -8,6 +8,7 @@ sidebar_position: 4 description: 'Migrating data to ClickHouse Observability Stack from Elastic' show_related_blogs: true keywords: ['ClickStack'] +doc_type: 'tutorial' --- ## Parallel operation strategy {#parallel-operation-strategy} diff --git a/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md b/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md index 9b3e8d5c166..640cc1cadef 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md @@ -8,6 +8,7 @@ sidebar_position: 6 description: 'Migrating SDKs from Elastic' show_related_blogs: true keywords: ['ClickStack'] +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/elastic/search.md b/docs/use-cases/observability/clickstack/migration/elastic/search.md index 16478273a63..4d3de3559c0 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/search.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/search.md @@ -6,6 +6,7 @@ pagination_next: null sidebar_label: 'Search' sidebar_position: 3 description: 'Searching in ClickStack and Elastic' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/elastic/types.md b/docs/use-cases/observability/clickstack/migration/elastic/types.md index 57c2670c955..fbe1cbc1e92 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/types.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/types.md @@ -8,6 +8,7 @@ sidebar_position: 2 description: 'Mapping types in ClickHouse and Elasticsearch' show_related_blogs: true keywords: ['JSON', 'Codecs'] +doc_type: 'reference' --- Elasticsearch and ClickHouse support a wide variety of data types, but their underlying storage and query models are fundamentally different. This section maps commonly used Elasticsearch field types to their ClickHouse equivalents, where available, and provides context to help guide migrations. Where no equivalent exists, alternatives or notes are provided in the comments. diff --git a/docs/use-cases/observability/clickstack/migration/index.md b/docs/use-cases/observability/clickstack/migration/index.md index eea17c4238b..2c73da6f557 100644 --- a/docs/use-cases/observability/clickstack/migration/index.md +++ b/docs/use-cases/observability/clickstack/migration/index.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null sidebar_label: 'Migration guides' description: 'Migrating to ClickStack from other Observability solutions' +doc_type: 'how-to' --- This section provides comprehensive guides for migrating from various observability solutions to ClickStack. Each guide includes detailed instructions for transitioning your data, agents, and workflows while maintaining operational continuity. diff --git a/docs/use-cases/observability/clickstack/overview.md b/docs/use-cases/observability/clickstack/overview.md index 504f525e78b..733376b176b 100644 --- a/docs/use-cases/observability/clickstack/overview.md +++ b/docs/use-cases/observability/clickstack/overview.md @@ -5,6 +5,7 @@ sidebar_label: 'Overview' pagination_prev: null pagination_next: use-cases/observability/clickstack/getting-started description: 'Overview for ClickStack - The ClickHouse Observability Stack' +doc_type: 'explanation' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/production.md b/docs/use-cases/observability/clickstack/production.md index 4fd11eadf10..5cd038a01ad 100644 --- a/docs/use-cases/observability/clickstack/production.md +++ b/docs/use-cases/observability/clickstack/production.md @@ -5,6 +5,7 @@ sidebar_label: 'Production' pagination_prev: null pagination_next: null description: 'Going to production with ClickStack' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/search.md b/docs/use-cases/observability/clickstack/search.md index 4099ac8abd3..7d0fb5a4391 100644 --- a/docs/use-cases/observability/clickstack/search.md +++ b/docs/use-cases/observability/clickstack/search.md @@ -5,6 +5,7 @@ sidebar_label: 'Search' pagination_prev: null pagination_next: null description: 'Search with ClickStack' +doc_type: 'how-to' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ttl.md b/docs/use-cases/observability/clickstack/ttl.md index a11ba3eef2e..786a32fd128 100644 --- a/docs/use-cases/observability/clickstack/ttl.md +++ b/docs/use-cases/observability/clickstack/ttl.md @@ -5,6 +5,7 @@ sidebar_label: 'Managing TTL' pagination_prev: null pagination_next: null description: 'Managing TTL with ClickStack' +doc_type: 'tutorial' --- import observability_14 from '@site/static/images/use-cases/observability/observability-14.png'; diff --git a/docs/use-cases/observability/index.md b/docs/use-cases/observability/index.md index 3845ba84e8c..ad8737e6f78 100644 --- a/docs/use-cases/observability/index.md +++ b/docs/use-cases/observability/index.md @@ -5,6 +5,7 @@ pagination_prev: null pagination_next: null description: 'Landing page for the Observability use case guide' keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] +doc_type: 'reference' --- ClickHouse offers unmatched speed, scale, and cost-efficiency for observability. This guide provides two paths depending on your needs: diff --git a/docs/use-cases/time-series/analysis-functions.md b/docs/use-cases/time-series/analysis-functions.md index cdcdb3d2c2e..5c901ab82d2 100644 --- a/docs/use-cases/time-series/analysis-functions.md +++ b/docs/use-cases/time-series/analysis-functions.md @@ -5,6 +5,7 @@ description: 'Functions for analyzing time-series data in ClickHouse.' slug: /use-cases/time-series/analysis-functions keywords: ['time-series'] show_related_blogs: true +doc_type: 'reference' --- # Time-series analysis functions diff --git a/docs/use-cases/time-series/basic-operations.md b/docs/use-cases/time-series/basic-operations.md index 541f828a6fc..634bbd829b1 100644 --- a/docs/use-cases/time-series/basic-operations.md +++ b/docs/use-cases/time-series/basic-operations.md @@ -5,6 +5,7 @@ description: 'Basic time-series operations in ClickHouse.' slug: /use-cases/time-series/basic-operations keywords: ['time-series'] show_related_blogs: true +doc_type: 'tutorial' --- # Basic time-series operations diff --git a/docs/use-cases/time-series/date-time-data-types.md b/docs/use-cases/time-series/date-time-data-types.md index 73959386808..657bb318f8e 100644 --- a/docs/use-cases/time-series/date-time-data-types.md +++ b/docs/use-cases/time-series/date-time-data-types.md @@ -5,6 +5,7 @@ description: 'Time-series data types in ClickHouse.' slug: /use-cases/time-series/date-time-data-types keywords: ['Time Series', 'DateTime'] show_related_blogs: true +doc_type: 'reference' --- # Date and time data types diff --git a/docs/use-cases/time-series/index.md b/docs/use-cases/time-series/index.md index d1a37acd28e..5d4d59a8c6c 100644 --- a/docs/use-cases/time-series/index.md +++ b/docs/use-cases/time-series/index.md @@ -4,6 +4,7 @@ slug: /use-cases/time-series title: 'Time-Series' pagination_prev: null pagination_next: null +doc_type: 'reference' --- Welcome to our time-series use case guide. In this guide you'll learn how you can get setup and use ClickHouse for time-series. diff --git a/docs/use-cases/time-series/query-performance.md b/docs/use-cases/time-series/query-performance.md index 8b181e2b2a7..a9ef5905b0c 100644 --- a/docs/use-cases/time-series/query-performance.md +++ b/docs/use-cases/time-series/query-performance.md @@ -5,6 +5,7 @@ description: 'Improving time-series query performance' slug: /use-cases/time-series/query-performance keywords: ['time-series'] show_related_blogs: true +doc_type: 'how-to' --- # Time-series query performance diff --git a/docs/use-cases/time-series/storage-efficiency.md b/docs/use-cases/time-series/storage-efficiency.md index b093726da13..f16dd692205 100644 --- a/docs/use-cases/time-series/storage-efficiency.md +++ b/docs/use-cases/time-series/storage-efficiency.md @@ -5,6 +5,7 @@ description: 'Improving time-series storage efficiency' slug: /use-cases/time-series/storage-efficiency keywords: ['time-series'] show_related_blogs: true +doc_type: 'how-to' --- # Time-series storage efficiency diff --git a/docs/whats-new/changelog/2017.md b/docs/whats-new/changelog/2017.md index 65fbd254699..a0cfbb25ae9 100644 --- a/docs/whats-new/changelog/2017.md +++ b/docs/whats-new/changelog/2017.md @@ -4,6 +4,7 @@ sidebar_position: 10 sidebar_label: '2017' title: '2017 Changelog' description: 'Changelog for 2017' +doc_type: 'reference' --- ### ClickHouse Release 1.1.54327, 2017-12-21 {#clickhouse-release-1-1-54327-2017-12-21} diff --git a/docs/whats-new/changelog/2018.md b/docs/whats-new/changelog/2018.md index 8f730d6baf7..923f2757b79 100644 --- a/docs/whats-new/changelog/2018.md +++ b/docs/whats-new/changelog/2018.md @@ -4,6 +4,7 @@ sidebar_position: 9 sidebar_label: '2018' title: '2018 Changelog' description: 'Changelog for 2018' +doc_type: 'reference' --- ## ClickHouse Release 18.16 {#clickhouse-release-18-16} diff --git a/docs/whats-new/changelog/2019.md b/docs/whats-new/changelog/2019.md index 21de463a3e5..01b143ed38c 100644 --- a/docs/whats-new/changelog/2019.md +++ b/docs/whats-new/changelog/2019.md @@ -4,6 +4,7 @@ sidebar_position: 8 sidebar_label: '2019' title: '2019 Changelog' description: 'Changelog for 2019' +doc_type: 'reference' --- ## ClickHouse Release 19.17 {#clickhouse-release-v19-17} diff --git a/docs/whats-new/changelog/2020.md b/docs/whats-new/changelog/2020.md index ff5154fc130..ba9861cced1 100644 --- a/docs/whats-new/changelog/2020.md +++ b/docs/whats-new/changelog/2020.md @@ -4,6 +4,7 @@ sidebar_position: 7 sidebar_label: '2020' title: '2020 Changelog' description: 'Changelog for 2020' +doc_type: 'reference' --- ### ClickHouse release 20.12 {#clickhouse-release-2012} diff --git a/docs/whats-new/changelog/2021.md b/docs/whats-new/changelog/2021.md index 853d1b88c9e..d3aa52af67e 100644 --- a/docs/whats-new/changelog/2021.md +++ b/docs/whats-new/changelog/2021.md @@ -4,6 +4,7 @@ sidebar_position: 6 sidebar_label: '2021' title: '2021 Changelog' description: 'Changelog for 2021' +doc_type: 'reference' --- ### ClickHouse release v21.12, 2021-12-15 {#clickhouse-release-v2112-2021-12-15} diff --git a/docs/whats-new/changelog/2022.md b/docs/whats-new/changelog/2022.md index 96820bf05cc..a6c2aa5f964 100644 --- a/docs/whats-new/changelog/2022.md +++ b/docs/whats-new/changelog/2022.md @@ -4,6 +4,7 @@ sidebar_position: 5 sidebar_label: '2022' title: '2022 Changelog' description: 'Changelog for 2022' +doc_type: 'reference' --- ### ClickHouse release 22.12, 2022-12-15 {#a-id2212a-clickhouse-release-2212-2022-12-15} diff --git a/docs/whats-new/changelog/2023.md b/docs/whats-new/changelog/2023.md index d321f74fdd6..77ed4292386 100644 --- a/docs/whats-new/changelog/2023.md +++ b/docs/whats-new/changelog/2023.md @@ -4,6 +4,7 @@ sidebar_position: 4 sidebar_label: '2023' title: '2023 Changelog' description: 'Changelog for 2023' +doc_type: 'reference' --- ### Table of Contents {#table-of-contents} diff --git a/docs/whats-new/changelog/2024.md b/docs/whats-new/changelog/2024.md index e3b57784dc1..2d8f3bd4e60 100644 --- a/docs/whats-new/changelog/2024.md +++ b/docs/whats-new/changelog/2024.md @@ -4,6 +4,7 @@ sidebar_position: 3 sidebar_label: '2024' title: '2024 Changelog' description: 'Changelog for 2024' +doc_type: 'reference' --- ### Table of Contents {#table-of-contents} diff --git a/docs/whats-new/changelog/cloud.md b/docs/whats-new/changelog/cloud.md index cbc3f51a2f8..6e6457f54c6 100644 --- a/docs/whats-new/changelog/cloud.md +++ b/docs/whats-new/changelog/cloud.md @@ -4,6 +4,7 @@ sidebar_label: 'Cloud' title: 'Cloud Changelog' slug: /whats-new/changelog/cloud description: 'Learn about Cloud Changelog' +doc_type: 'reference' --- # Cloud Changelog diff --git a/docs/whats-new/changelog/index.md b/docs/whats-new/changelog/index.md index 5e70c9ecc81..94cdd9f1e17 100644 --- a/docs/whats-new/changelog/index.md +++ b/docs/whats-new/changelog/index.md @@ -5,10 +5,11 @@ slug: /whats-new/changelog/ sidebar_position: 2 sidebar_label: '2025' title: '2025 Changelog' +doc_type: 'reference' --- ### Table of Contents -**[ClickHouse release v25.7, 2025-07-24](#256)**
+**[ClickHouse release v25.7, 2025-07-24](#257)**
**[ClickHouse release v25.6, 2025-06-26](#256)**
**[ClickHouse release v25.5, 2025-05-22](#255)**
**[ClickHouse release v25.4, 2025-04-22](#254)**
@@ -28,140 +29,134 @@ title: '2025 Changelog' ### ClickHouse release 25.7, 2025-07-24 {#257} #### Backward Incompatible Change -* Changes to `extractKeyValuePairs` function: Introduce a new argument `unexpected_quoting_character_strategy` that controls what happens when a `quoting_character` is unexpectedly found when reading a non quoted key or value. The value can be one of: `invalid`, `accept` or `promote`. Invalid will discard the key and go back to waiting key state. Accept will treat it as part of the key. Promote will discard previous character and start parsing as a quoted key. In addition, after parsing a quoted value, only parse the next key if a pair delimiter is found. [#80657](https://github.com/ClickHouse/ClickHouse/pull/80657) ([Arthur Passos](https://github.com/arthurpassos)). +* Changes to `extractKeyValuePairs` function: introduce a new argument `unexpected_quoting_character_strategy` that controls what happens when a `quoting_character` is unexpectedly found when reading a non quoted key or value. The value can be one of: `invalid`, `accept` or `promote`. Invalid will discard the key and go back to waiting key state. Accept will treat it as part of the key. Promote will discard previous character and start parsing as a quoted key. In addition, after parsing a quoted value, only parse the next key if a pair delimiter is found. [#80657](https://github.com/ClickHouse/ClickHouse/pull/80657) ([Arthur Passos](https://github.com/arthurpassos)). * Support zero-byte match in `countMatches` function. Users who like to retain the old behavior can enable setting `count_matches_stop_at_empty_match`. [#81676](https://github.com/ClickHouse/ClickHouse/pull/81676) ([Elmi Ahmadov](https://github.com/ahmadov)). * Use server-wide throttlers for local (`max_local_read_bandwidth_for_server` and `max_local_write_bandwidth_for_server`) and remote (`max_remote_read_network_bandwidth_for_server` and `max_remote_write_network_bandwidth_for_server`) when generating BACKUPs in addition to their dedicated server settings (`max_backup_bandwidth_for_server`, `max_mutations_bandwidth_for_server` and `max_merges_bandwidth_for_server`). [#81753](https://github.com/ClickHouse/ClickHouse/pull/81753) ([Sergei Trifonov](https://github.com/serxa)). * Forbid the creation of a table without insertable columns. [#81835](https://github.com/ClickHouse/ClickHouse/pull/81835) ([Pervakov Grigorii](https://github.com/GrigoryPervakov)). -* Cluster functions with archives used to send over the whole archives to replicas, making reading within archives not-parallelizable with clusters (e.g. with a single archive we would just send it to one of the replicas as a whole to process and all other replicas will just be idle, which is inefficient). Added a new setting `cluster_function_process_archive_on_multiple_nodes`, by default equal to `true`. If set to `true`, increases performance of processing archives in cluster functions. Should be set to `false` for compatibility and to avoid errors during upgrade to 25.7+ if using cluster functions with archives on earlier versions. [#82355](https://github.com/ClickHouse/ClickHouse/pull/82355) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Parallelize cluster functions by files within archives. In previous versions, the whole archive (such as zip, tar, or 7z) was a unit of work. Added a new setting `cluster_function_process_archive_on_multiple_nodes`, by default equal to `true`. If set to `true`, increases performance of processing archives in cluster functions. Should be set to `false` for compatibility and to avoid errors during upgrade to 25.7+ if using cluster functions with archives on earlier versions. [#82355](https://github.com/ClickHouse/ClickHouse/pull/82355) ([Kseniia Sumarokova](https://github.com/kssenii)). * `SYSTEM RESTART REPLICAS` query led to the wakeup of tables in the Lazy database, even without access to that database, and it happened while these tables were being concurrently dropped. Note: Now `SYSTEM RESTART REPLICAS` will only restart replicas in the databases where you have permission to `SHOW TABLES`, which is natural. [#83321](https://github.com/ClickHouse/ClickHouse/pull/83321) ([Alexey Milovidov](https://github.com/alexey-milovidov)). #### New Feature * Added support for lightweight updates for `MergeTree`-family tables. Lightweight updates can be used by a new syntax: `UPDATE
SET col1 = val1, col2 = val2, ... WHERE `. Added implementation of lightweight deletes via lightweight updates. It can be enabled by setting `lightweight_delete_mode = 'lightweight_update'`. [#82004](https://github.com/ClickHouse/ClickHouse/pull/82004) ([Anton Popov](https://github.com/CurtizJ)). -* Support complex types in iceberg schema evolution. [#73714](https://github.com/ClickHouse/ClickHouse/pull/73714) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Support complex types in Iceberg schema evolution. [#73714](https://github.com/ClickHouse/ClickHouse/pull/73714) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Introduce support for INSERTs into Iceberg tables. [#82692](https://github.com/ClickHouse/ClickHouse/pull/82692) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Read Iceberg data files by field ids. This improves compatibility with Iceberg: the fields can be renamed in the metadata while being mapped to the different names in the underlying Parquet files. This closes [#83065](https://github.com/ClickHouse/ClickHouse/issues/83065). [#83653](https://github.com/ClickHouse/ClickHouse/pull/83653) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Now clickhouse supports compressed `metadata.json` files for Iceberg. Fixes [#70874](https://github.com/ClickHouse/ClickHouse/issues/70874). [#81451](https://github.com/ClickHouse/ClickHouse/pull/81451) ([alesapin](https://github.com/alesapin)). +* Support `TimestampTZ` in Glue catalog. This closes [#81654](https://github.com/ClickHouse/ClickHouse/issues/81654). [#83132](https://github.com/ClickHouse/ClickHouse/pull/83132) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Add AI-powered SQL generation to ClickHouse client. Users can now generate SQL queries from natural language descriptions by prefixing their query with `??`. Supports OpenAI and Anthropic providers with automatic schema discovery. [#83314](https://github.com/ClickHouse/ClickHouse/pull/83314) ([Kaushik Iska](https://github.com/iskakaushik)). +* Add a function to write Geo types into WKB format. [#82935](https://github.com/ClickHouse/ClickHouse/pull/82935) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Introduced two new access types: `READ` and `WRITE` for sources and deprecates all previous access types related to sources. Before `GRANT S3 ON *.* TO user`, now: `GRANT READ, WRITE ON S3 TO user`. This also allows to separate `READ` and `WRITE` permissions for sources, e.g.: `GRANT READ ON * TO user`, `GRANT WRITE ON S3 TO user`. The feature is controlled by a setting `access_control_improvements.enable_read_write_grants` and disabled by default. [#73659](https://github.com/ClickHouse/ClickHouse/pull/73659) ([pufit](https://github.com/pufit)). * NumericIndexedVector: new vector data-structure backed by bit-sliced, Roaring-bitmap compression, together with more than 20 functions for building, analysing and point-wise arithmetic. Can cut storage and speed up joins, filters and aggregations on sparse data. Implements [#70582](https://github.com/ClickHouse/ClickHouse/issues/70582) and [“Large-Scale Metric Computation in Online Controlled Experiment Platform” paper](https://arxiv.org/abs/2405.08411) by T. Xiong and Y. Wang from VLDB 2024. [#74193](https://github.com/ClickHouse/ClickHouse/pull/74193) ([FriendLey](https://github.com/FriendLey)). * The workload setting `max_waiting_queries` is now supported. It can be used to limit the size of the query queue. If the limit is reached, all subsequent queries will be terminated with the `SERVER_OVERLOADED` error. [#81250](https://github.com/ClickHouse/ClickHouse/pull/81250) ([Oleg Doronin](https://github.com/dorooleg)). * Add financial functions: `financialInternalRateOfReturnExtended` (`XIRR`), `financialInternalRateOfReturn` (`IRR`), `financialNetPresentValueExtended` (`XNPV`), `financialNetPresentValue` (`NPV`). [#81599](https://github.com/ClickHouse/ClickHouse/pull/81599) ([Joanna Hulboj](https://github.com/jh0x)). -* Add the geospatial functions `polygonIntersectsCartesian` and `polygonIntersectsSpherical` to check if two polygons intersect. [#81882](https://github.com/ClickHouse/ClickHouse/pull/81882) ([Paul Lamb](https://github.com/plamb)). -* Support `_part_granule_offset` virtual column in MergeTree-family tables. This column indicates the zero-based index of the granule/mark each row belongs to within its data part. This addresses [#79572](https://github.com/ClickHouse/ClickHouse/issues/79572). [#82341](https://github.com/ClickHouse/ClickHouse/pull/82341) ([Amos Bird](https://github.com/amosbird)). -* Introduce Iceberg writes for `insert` queries. [#82692](https://github.com/ClickHouse/ClickHouse/pull/82692) ([Konstantin Vedernikov](https://github.com/scanhex12)). -* Add SZ3 as a lossy yet error-bounded compression codec for columns of type `Float32` and `Float64`. [#83088](https://github.com/ClickHouse/ClickHouse/pull/83088) ([Konstantin Vedernikov](https://github.com/scanhex12)). -* Add AI-powered SQL generation to ClickHouse client. Users can now generate SQL queries from natural language descriptions by prefixing their query with "??". Supports OpenAI and Anthropic providers with automatic schema discovery. [#83314](https://github.com/ClickHouse/ClickHouse/pull/83314) ([Kaushik Iska](https://github.com/iskakaushik)). -* Read iceberg data files by field ids. This closes [#83065](https://github.com/ClickHouse/ClickHouse/issues/83065). [#83653](https://github.com/ClickHouse/ClickHouse/pull/83653) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Add the geospatial functions `polygonsIntersectCartesian` and `polygonsIntersectSpherical` to check if two polygons intersect. [#81882](https://github.com/ClickHouse/ClickHouse/pull/81882) ([Paul Lamb](https://github.com/plamb)). +* Support `_part_granule_offset` virtual column in MergeTree-family tables. This column indicates the zero-based index of the granule/mark each row belongs to within its data part. This addresses [#79572](https://github.com/ClickHouse/ClickHouse/issues/79572). [#82341](https://github.com/ClickHouse/ClickHouse/pull/82341) ([Amos Bird](https://github.com/amosbird)). [#82341](https://github.com/ClickHouse/ClickHouse/pull/82341) ([Amos Bird](https://github.com/amosbird)) * Added SQL functions `colorSRGBToOkLCH` and `colorOkLCHToSRGB` for converting colours between the sRGB and OkLCH colour spaces. [#83679](https://github.com/ClickHouse/ClickHouse/pull/83679) ([Fgrtue](https://github.com/Fgrtue)). -* Add _part_granule_offset column". [#82341](https://github.com/ClickHouse/ClickHouse/pull/82341) ([Amos Bird](https://github.com/amosbird)). +* Allow parameters in `CREATE USER` queries for usernames. [#81387](https://github.com/ClickHouse/ClickHouse/pull/81387) ([Diskein](https://github.com/Diskein)). +* The `system.formats` table now contains extended information about formats, such as HTTP content type, the capabilities of schema inference, etc. [#81505](https://github.com/ClickHouse/ClickHouse/pull/81505) ([Alexey Milovidov](https://github.com/alexey-milovidov)). #### Experimental Feature * Added functions `searchAny` and `searchAll` which are general purpose tools to search text indexes. [#80641](https://github.com/ClickHouse/ClickHouse/pull/80641) ([Elmi Ahmadov](https://github.com/ahmadov)). -* The text index now supports `string` tokenizer. [#81752](https://github.com/ClickHouse/ClickHouse/pull/81752) ([Elmi Ahmadov](https://github.com/ahmadov)). +* The text index now supports the new `split` tokenizer. [#81752](https://github.com/ClickHouse/ClickHouse/pull/81752) ([Elmi Ahmadov](https://github.com/ahmadov)). * Changed the default index granularity value for `text` indexes to 64. This improves the expected performance for the average test query in internal benchmarks. [#82162](https://github.com/ClickHouse/ClickHouse/pull/82162) ([Jimmy Aguilar Mena](https://github.com/Ergus)). * The 256-bit bitmap stores the outgoing labels of a state ordered, but outgoing states are saved into disk in the order they appear in the hash table. Therefore, a label would point to a wrong next state while reading from disk. [#82783](https://github.com/ClickHouse/ClickHouse/pull/82783) ([Elmi Ahmadov](https://github.com/ahmadov)). -* Enable zstd compression for FST tree blob. [#83093](https://github.com/ClickHouse/ClickHouse/pull/83093) ([Elmi Ahmadov](https://github.com/ahmadov)). -* Promote vector similarity index to BETA. Introduced alias setting `enable_vector_similarity_index` which must be enabled to use the vector similarity index. [#83459](https://github.com/ClickHouse/ClickHouse/pull/83459) ([Robert Schulze](https://github.com/rschu1ze)). +* Enable zstd compression for FST tree blob in text indices. [#83093](https://github.com/ClickHouse/ClickHouse/pull/83093) ([Elmi Ahmadov](https://github.com/ahmadov)). +* Promote vector similarity index to beta. Introduced alias setting `enable_vector_similarity_index` which must be enabled to use the vector similarity index. [#83459](https://github.com/ClickHouse/ClickHouse/pull/83459) ([Robert Schulze](https://github.com/rschu1ze)). +* Removed experimental `send_metadata` logic related to experimental zero-copy replication. It wasn't ever used and nobody supports this code. Since there were even no tests related to it, there is a high chance that it's broken long time ago. [#82508](https://github.com/ClickHouse/ClickHouse/pull/82508) ([alesapin](https://github.com/alesapin)). +* Integrate `StorageKafka2` to `system.kafka_consumers`. [#82652](https://github.com/ClickHouse/ClickHouse/pull/82652) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)). +* Estimate complex CNF/DNF, for example, `(a < 1 and a > 0) or b = 3`, by statistics. [#82663](https://github.com/ClickHouse/ClickHouse/pull/82663) ([Han Fei](https://github.com/hanfei1991)). #### Performance Improvement -* Trivial optimization for -If combinator. [#78454](https://github.com/ClickHouse/ClickHouse/pull/78454) ([李扬](https://github.com/taiyang-li)). +* Introduce async logging. When logs are output to a slow device, it no longer delays queries. [#82516](https://github.com/ClickHouse/ClickHouse/pull/82516) ([Raúl Marín](https://github.com/Algunenano)). Limit the max number of entries that are hold in the queue. [#83214](https://github.com/ClickHouse/ClickHouse/pull/83214) ([Raúl Marín](https://github.com/Algunenano)). +* Parallel distributed INSERT SELECT is enabled by default in mode where INSERT SELECT executed on each shard independently, see `parallel_distributed_insert_select` setting. [#83040](https://github.com/ClickHouse/ClickHouse/pull/83040) ([Igor Nikonov](https://github.com/devcrafter)). +* When the aggregation query contains only a single `count()` function on a not-`Nullable` column, the aggregation logic is fully inlined during hash table probing. This avoids allocating and maintaining any aggregation state, significantly reducing memory usage and CPU overhead. This partially addresses [#81982](https://github.com/ClickHouse/ClickHouse/issues/81982). [#82104](https://github.com/ClickHouse/ClickHouse/pull/82104) ([Amos Bird](https://github.com/amosbird)). +* Performance of `HashJoin` optimised by removing the additional loop over hash maps in the typical case of only one key column, also `null_map` and `join_mask` checks are eliminated when they're always `true`/`false`. [#82308](https://github.com/ClickHouse/ClickHouse/pull/82308) ([Nikita Taranov](https://github.com/nickitat)). +* Trivial optimization for `-If` combinator. [#78454](https://github.com/ClickHouse/ClickHouse/pull/78454) ([李扬](https://github.com/taiyang-li)). * Vector search queries using a vector similarity index complete with lower latency due to reduced storage reads and reduced CPU usage. [#79103](https://github.com/ClickHouse/ClickHouse/pull/79103) ([Shankar Iyer](https://github.com/shankar-iyer)). * Respect `merge_tree_min_{rows,bytes}_for_seek` in `filterPartsByQueryConditionCache` to align it with other methods filtering by indexes. [#80312](https://github.com/ClickHouse/ClickHouse/pull/80312) ([李扬](https://github.com/taiyang-li)). -* Make the pipeline after the TOTALS step multithreaded. [#80331](https://github.com/ClickHouse/ClickHouse/pull/80331) ([UnamedRus](https://github.com/UnamedRus)). -* Fix filter by key for Redis and KeeperMap storages. [#81833](https://github.com/ClickHouse/ClickHouse/pull/81833) ([Pervakov Grigorii](https://github.com/GrigoryPervakov)). +* Make the pipeline after the `TOTALS` step multithreaded. [#80331](https://github.com/ClickHouse/ClickHouse/pull/80331) ([UnamedRus](https://github.com/UnamedRus)). +* Fix filter by key for `Redis` and `KeeperMap` storages. [#81833](https://github.com/ClickHouse/ClickHouse/pull/81833) ([Pervakov Grigorii](https://github.com/GrigoryPervakov)). * Add new setting `min_joined_block_size_rows` (analogous to `min_joined_block_size_bytes`; defaults to 65409) to control the minimum block size (in rows) for JOIN input and output blocks (if the join algorithm supports it). Small blocks will be squashed. [#81886](https://github.com/ClickHouse/ClickHouse/pull/81886) ([Nikita Taranov](https://github.com/nickitat)). -* When the aggregation query contains only a single `COUNT()` function on a NOT NULL column, the aggregation logic is fully inlined during hash table probing. This avoids allocating and maintaining any aggregation state, significantly reducing memory usage and CPU overhead. This partially addresses [#81982](https://github.com/ClickHouse/ClickHouse/issues/81982). [#82104](https://github.com/ClickHouse/ClickHouse/pull/82104) ([Amos Bird](https://github.com/amosbird)). -* Performance of `HashJoin` optimised by removing the additional loop over hash maps in the typical case of only one key column, also `null_map` and `join_mask` checks are eliminated when they're always `true`/`false`. [#82308](https://github.com/ClickHouse/ClickHouse/pull/82308) ([Nikita Taranov](https://github.com/nickitat)). * `ATTACH PARTITION` no longer leads to the dropping of all caches. [#82377](https://github.com/ClickHouse/ClickHouse/pull/82377) ([Alexey Milovidov](https://github.com/alexey-milovidov)). * Optimize the generated plan for correlated subqueries by removing redundant JOIN operations using equivalence classes. If there are equivalent expressions for all correlated columns, `CROSS JOIN` is not produced if `query_plan_correlated_subqueries_use_substitution` setting is enabled. [#82435](https://github.com/ClickHouse/ClickHouse/pull/82435) ([Dmitry Novik](https://github.com/novikd)). * Read only required columns in correlated subquery when it appears to be an argument of function `EXISTS`. [#82443](https://github.com/ClickHouse/ClickHouse/pull/82443) ([Dmitry Novik](https://github.com/novikd)). -* Introduce async logging. [#82516](https://github.com/ClickHouse/ClickHouse/pull/82516) ([Raúl Marín](https://github.com/Algunenano)). -* Speedup QueryTreeHash a bit. [#82617](https://github.com/ClickHouse/ClickHouse/pull/82617) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). +* Speedup comparisons of query trees during the query analysis a bit. [#82617](https://github.com/ClickHouse/ClickHouse/pull/82617) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). * Add alignment in the Counter of ProfileEvents to reduce false sharing. [#82697](https://github.com/ClickHouse/ClickHouse/pull/82697) ([Jiebin Sun](https://github.com/jiebinn)). -* Parallel distributed INSERT SELECT is enabled by default in mode where INSERT SELECT executed on each shard independently, see `parallel_distributed_insert_select` setting. [#83040](https://github.com/ClickHouse/ClickHouse/pull/83040) ([Igor Nikonov](https://github.com/devcrafter)). * The optimizations for `null_map` and `JoinMask` from [#82308](https://github.com/ClickHouse/ClickHouse/issues/82308) were applied to the case of JOIN with multiple disjuncts. Also, the `KnownRowsHolder` data structure was optimized. [#83041](https://github.com/ClickHouse/ClickHouse/pull/83041) ([Nikita Taranov](https://github.com/nickitat)). * Plain `std::vector` is used for join flags to avoid calculating a hash on each access to flags. [#83043](https://github.com/ClickHouse/ClickHouse/pull/83043) ([Nikita Taranov](https://github.com/nickitat)). * Don't pre-allocate memory for result columns beforehand when `HashJoin` uses `lazy` output mode. It is suboptimal, especially when the number of matches is low. Moreover, we know the exact amount of matches after joining is done, so we can preallocate more precisely. [#83304](https://github.com/ClickHouse/ClickHouse/pull/83304) ([Nikita Taranov](https://github.com/nickitat)). * Minimize memory copy in port headers during pipeline construction. Original [PR](https://github.com/ClickHouse/ClickHouse/pull/70105) by [heymind](https://github.com/heymind). [#83381](https://github.com/ClickHouse/ClickHouse/pull/83381) ([Raúl Marín](https://github.com/Algunenano)). -* Improve Keeper with rocksdb initial loading. [#83390](https://github.com/ClickHouse/ClickHouse/pull/83390) ([Antonio Andelic](https://github.com/antonio2368)). +* Improve the startup of clickhouse-keeper when it uses rocksdb storage. [#83390](https://github.com/ClickHouse/ClickHouse/pull/83390) ([Antonio Andelic](https://github.com/antonio2368)). * Avoid holding the lock while creating storage snapshot data to reduce lock contention with high concurrent load. [#83510](https://github.com/ClickHouse/ClickHouse/pull/83510) ([Duc Canh Le](https://github.com/canhld94)). -* Improved performance of the ProtobufSingle input format by reusing the serializer when no parsing errors occur. [#83613](https://github.com/ClickHouse/ClickHouse/pull/83613) ([Eduard Karacharov](https://github.com/korowa)). -* Improve the performance of pipeline building. [#83631](https://github.com/ClickHouse/ClickHouse/pull/83631) ([Raúl Marín](https://github.com/Algunenano)). -* Optimize MergeTreeReadersChain::getSampleBlock. [#83875](https://github.com/ClickHouse/ClickHouse/pull/83875) ([Raúl Marín](https://github.com/Algunenano)). +* Improved performance of the `ProtobufSingle` input format by reusing the serializer when no parsing errors occur. [#83613](https://github.com/ClickHouse/ClickHouse/pull/83613) ([Eduard Karacharov](https://github.com/korowa)). +* Improve the performance of pipeline building that speeds up short queries. [#83631](https://github.com/ClickHouse/ClickHouse/pull/83631) ([Raúl Marín](https://github.com/Algunenano)). +* Optimize `MergeTreeReadersChain::getSampleBlock` that speeds up short queries. [#83875](https://github.com/ClickHouse/ClickHouse/pull/83875) ([Raúl Marín](https://github.com/Algunenano)). +* Speedup tables listing in data catalogs by asynchronous requests. [#81084](https://github.com/ClickHouse/ClickHouse/pull/81084) ([alesapin](https://github.com/alesapin)). +* Introduce jitter to the S3 retry mechanism when the `s3_slow_all_threads_after_network_error` configuration is enabled. [#81849](https://github.com/ClickHouse/ClickHouse/pull/81849) ([zoomxi](https://github.com/zoomxi)). #### Improvement -* Introduced two new access types: `READ` and `WRITE` for sources and deprecates all previous access types related to sources. Before `GRANT S3 ON *.* TO user`, now: `GRANT READ, WRITE ON S3 TO user`. This also allows to separate `READ` and `WRITE` permissions for sources, e.g.: `GRANT READ ON * TO user`, `GRANT WRITE ON S3 TO user`. The feature is controlled by a setting `access_control_improvements.enable_read_write_grants` and disabled by default. [#73659](https://github.com/ClickHouse/ClickHouse/pull/73659) ([pufit](https://github.com/pufit)). -* Verify the part has consistent checksum.txt file right before committing it. [#76625](https://github.com/ClickHouse/ClickHouse/pull/76625) ([Sema Checherinda](https://github.com/CheSema)). -* Implement methods `moveFile` and `replaceFile` in s3_plain_rewritable to support it as a database disk. [#79424](https://github.com/ClickHouse/ClickHouse/pull/79424) ([Tuan Pham Anh](https://github.com/tuanpach)). -* Allow backups for PostgreSQL, MySQL & DataLake databases. A backup of such a database would only save the definition and not the data inside of it. [#79982](https://github.com/ClickHouse/ClickHouse/pull/79982) ([Nikolay Degterinsky](https://github.com/evillique)). -* Support position deletes for Iceberg TableEngine. [#80237](https://github.com/ClickHouse/ClickHouse/pull/80237) ([YanghongZhong](https://github.com/yahoNanJing)). -* Setting `allow_experimental_join_condition` marked as obsolete. [#80566](https://github.com/ClickHouse/ClickHouse/pull/80566) ([Vladimir Cherkasov](https://github.com/vdimir)). +* Color parenthesis in multiple colors for better readability. [#82538](https://github.com/ClickHouse/ClickHouse/pull/82538) ([Konstantin Bogdanov](https://github.com/thevar1able)). +* Highlight metacharacters in LIKE/REGEXP patterns as you type. We already have it in `clickhouse-format` and in the echo in `clickhouse-client`, but now it is done in the command prompt as well. [#82871](https://github.com/ClickHouse/ClickHouse/pull/82871) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Highlighting in `clickhouse-format` and in the client's echo will work in the same way as the highlighting in the command line prompt. [#82874](https://github.com/ClickHouse/ClickHouse/pull/82874) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Now `plain_rewritable` disks are allowed as disks for database metadata. Implement methods `moveFile` and `replaceFile` in `plain_rewritable` to support it as a database disk. [#79424](https://github.com/ClickHouse/ClickHouse/pull/79424) ([Tuan Pham Anh](https://github.com/tuanpach)). +* Allow backups for `PostgreSQL`, `MySQL` and `DataLake` databases. A backup of such a database would only save the definition and not the data inside of it. [#79982](https://github.com/ClickHouse/ClickHouse/pull/79982) ([Nikolay Degterinsky](https://github.com/evillique)). +* Setting `allow_experimental_join_condition` marked as obsolete, because it is now always allowed. [#80566](https://github.com/ClickHouse/ClickHouse/pull/80566) ([Vladimir Cherkasov](https://github.com/vdimir)). * Add pressure metrics to ClickHouse async metrics. [#80779](https://github.com/ClickHouse/ClickHouse/pull/80779) ([Xander Garbett](https://github.com/Garbett1)). * Added metrics `MarkCacheEvictedBytes`, `MarkCacheEvictedMarks`, `MarkCacheEvictedFiles` for tracking evictions from the mark cache. (issue [#60989](https://github.com/ClickHouse/ClickHouse/issues/60989)). [#80799](https://github.com/ClickHouse/ClickHouse/pull/80799) ([Shivji Kumar Jha](https://github.com/shiv4289)). -* Speedup tables listing in data catalogs by asynchronous requests. [#81084](https://github.com/ClickHouse/ClickHouse/pull/81084) ([alesapin](https://github.com/alesapin)). -* Support writing parquet enum as byte array as the [spec](https://github.com/apache/parquet-format/blob/master/LogicalTypes.md#enum) dictates. I'll write more info later. [#81090](https://github.com/ClickHouse/ClickHouse/pull/81090) ([Arthur Passos](https://github.com/arthurpassos)). +* Support writing Parquet enum as byte array as the [spec](https://github.com/apache/parquet-format/blob/master/LogicalTypes.md#enum) dictates. [#81090](https://github.com/ClickHouse/ClickHouse/pull/81090) ([Arthur Passos](https://github.com/arthurpassos)). * An improvement for `DeltaLake` table engine: delta-kernel-rs has `ExpressionVisitor` API which is implemented in this PR and is applied to partition column expressions transform (it will replace an old deprecated within the delta-kernel-rs way, which was used before in our code). In the future this `ExpressionVisitor` will also allow to implement statistics based pruning and some delta-lake proprietary features. Additionally the purpose of this change is to support partition pruning in `DeltaLakeCluster` table engine (the result of a parsed expression - ActionsDAG - will be serialized and sent from the initiator along with the data path, because this kind of information, which is needed for pruning, is only available as meta information on data files listing, which is done by initiator only, but it has to be applied to data on each reading server). [#81136](https://github.com/ClickHouse/ClickHouse/pull/81136) ([Kseniia Sumarokova](https://github.com/kssenii)). -* Try to preserve element names when deriving supertypes for named tuples. [#81345](https://github.com/ClickHouse/ClickHouse/pull/81345) ([lgbo](https://github.com/lgbo-ustc)). -* Allow parameters in `CREATE USER` queries for usernames. [#81387](https://github.com/ClickHouse/ClickHouse/pull/81387) ([Diskein](https://github.com/Diskein)). -* Now clickhouse supports compressed `metadata.json` files for Iceberg. Fixes [#70874](https://github.com/ClickHouse/ClickHouse/issues/70874). [#81451](https://github.com/ClickHouse/ClickHouse/pull/81451) ([alesapin](https://github.com/alesapin)). -* The `system.formats` table now contains extended information about formats, such as HTTP content type, the capabilities of schema inference, etc. [#81505](https://github.com/ClickHouse/ClickHouse/pull/81505) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Preserve element names when deriving supertypes for named tuples. [#81345](https://github.com/ClickHouse/ClickHouse/pull/81345) ([lgbo](https://github.com/lgbo-ustc)). * Count consumed messages manually to avoid depending on previous committed offset in StorageKafka2. [#81662](https://github.com/ClickHouse/ClickHouse/pull/81662) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)). * Added `clickhouse-keeper-utils`, a new command-line tool for managing and analyzing ClickHouse Keeper data. The tool supports dumping state from snapshots and changelogs, analyzing changelog files, and extracting specific log ranges. [#81677](https://github.com/ClickHouse/ClickHouse/pull/81677) ([Antonio Andelic](https://github.com/antonio2368)). * The total and per-user network throttlers are never reset, which ensures that `max_network_bandwidth_for_all_users` and `max_network_bandwidth_for_all_users` limits are never exceeded. [#81729](https://github.com/ClickHouse/ClickHouse/pull/81729) ([Sergei Trifonov](https://github.com/serxa)). * Support writing geoparquets as output format. [#81784](https://github.com/ClickHouse/ClickHouse/pull/81784) ([Konstantin Vedernikov](https://github.com/scanhex12)). * Forbid to start `RENAME COLUMN` alter mutation if it will rename some column that right now affected by incomplete data mutation. [#81823](https://github.com/ClickHouse/ClickHouse/pull/81823) ([Mikhail Artemenko](https://github.com/Michicosun)). -* Introduce jitter to the S3 retry mechanism when the `s3_slow_all_threads_after_network_error` configuration is enabled. [#81849](https://github.com/ClickHouse/ClickHouse/pull/81849) ([zoomxi](https://github.com/zoomxi)). * Header Connection is send at the end of headers. When we know is the connection should be preserved. [#81951](https://github.com/ClickHouse/ClickHouse/pull/81951) ([Sema Checherinda](https://github.com/CheSema)). * Tune TCP servers queue (64 by default) based on listen_backlog (4096 by default). [#82045](https://github.com/ClickHouse/ClickHouse/pull/82045) ([Azat Khuzhin](https://github.com/azat)). * Add ability to reload `max_local_read_bandwidth_for_server` and `max_local_write_bandwidth_for_server` on fly without restart server. [#82083](https://github.com/ClickHouse/ClickHouse/pull/82083) ([Kai Zhu](https://github.com/nauu)). * Add support for clearing all warnings from the `system.warnings` table using `TRUNCATE TABLE system.warnings`. [#82087](https://github.com/ClickHouse/ClickHouse/pull/82087) ([Vladimir Cherkasov](https://github.com/vdimir)). * Fix partition pruning with data lake cluster functions. [#82131](https://github.com/ClickHouse/ClickHouse/pull/82131) ([Kseniia Sumarokova](https://github.com/kssenii)). * Fix reading partitioned data in DeltaLakeCluster table function. In this PR cluster functions protocol version is increased, allowing to send extra info from initiator to replicas. This extra info contains delta-kernel transform expression, which is needed to parse partition columns (and some other staff in the future, like generated columns, etc). [#82132](https://github.com/ClickHouse/ClickHouse/pull/82132) ([Kseniia Sumarokova](https://github.com/kssenii)). -* Fix a list of problems that can occur when trying to run integration tests on a local host. [#82135](https://github.com/ClickHouse/ClickHouse/pull/82135) ([Oleg Doronin](https://github.com/dorooleg)). +* Function `reinterpret` function now supports conversion to `Array(T)` where `T` is a fixed-size data type (issue [#82621](https://github.com/ClickHouse/ClickHouse/issues/82621)). [#83399](https://github.com/ClickHouse/ClickHouse/pull/83399) ([Shankar Iyer](https://github.com/shankar-iyer)). * Now database Datalake throw more convenient exception. Fixes [#81211](https://github.com/ClickHouse/ClickHouse/issues/81211). [#82304](https://github.com/ClickHouse/ClickHouse/pull/82304) ([alesapin](https://github.com/alesapin)). -* Improve HashJoin::needUsedFlagsForPerRightTableRow, returns false for cross join. [#82379](https://github.com/ClickHouse/ClickHouse/pull/82379) ([lgbo](https://github.com/lgbo-ustc)). -* Allow write/read map columns as array of tuples. [#82408](https://github.com/ClickHouse/ClickHouse/pull/82408) ([MikhailBurdukov](https://github.com/MikhailBurdukov)). -* List the licenses of rust crates in system.licenses. [#82440](https://github.com/ClickHouse/ClickHouse/pull/82440) ([Raúl Marín](https://github.com/Algunenano)). +* Improve CROSS JOIN by returning false from `HashJoin::needUsedFlagsForPerRightTableRow`. [#82379](https://github.com/ClickHouse/ClickHouse/pull/82379) ([lgbo](https://github.com/lgbo-ustc)). +* Allow write/read map columns as Array of Tuples. [#82408](https://github.com/ClickHouse/ClickHouse/pull/82408) ([MikhailBurdukov](https://github.com/MikhailBurdukov)). +* List the licenses of [Rust](https://clickhouse.com/blog/rust) crates in `system.licenses`. [#82440](https://github.com/ClickHouse/ClickHouse/pull/82440) ([Raúl Marín](https://github.com/Algunenano)). * Macros like `{uuid}` can now be used in the `keeper_path` setting of the S3Queue table engine. [#82463](https://github.com/ClickHouse/ClickHouse/pull/82463) ([Nikolay Degterinsky](https://github.com/evillique)). * Keeper improvement: move changelog files between disk in a background thread. Previously, moving changelog to a different disk would block Keeper globally until the move is finished. This lead to performance degradation if moving is a long operation (e.g. to S3 disk). [#82485](https://github.com/ClickHouse/ClickHouse/pull/82485) ([Antonio Andelic](https://github.com/antonio2368)). * Keeper improvement: add new config `keeper_server.cleanup_old_and_ignore_new_acl`. If enabled, all nodes will have their ACLs cleared while ACL for new requests will be ignored. If the goal is to completely remove ACL from nodes, it's important to leave the config enabled until a new snapshot is created. [#82496](https://github.com/ClickHouse/ClickHouse/pull/82496) ([Antonio Andelic](https://github.com/antonio2368)). -* Removed experimental `send_metadata` logic related to experimental zero-copy replication. It wasn't ever used and nobody supports this code. Since there were even no tests related to it, there is a high chance that it's broken long time ago. [#82508](https://github.com/ClickHouse/ClickHouse/pull/82508) ([alesapin](https://github.com/alesapin)). * Added a new server setting `s3queue_disable_streaming` which disables streaming in tables with S3Queue table engine. This setting is changeable without server restart. [#82515](https://github.com/ClickHouse/ClickHouse/pull/82515) ([Kseniia Sumarokova](https://github.com/kssenii)). -* Color parenthesis in multiple colors for better readability. [#82538](https://github.com/ClickHouse/ClickHouse/pull/82538) ([Konstantin Bogdanov](https://github.com/thevar1able)). * Refactor dynamic resize feature of filesystem cache. Added more logs for introspection. [#82556](https://github.com/ClickHouse/ClickHouse/pull/82556) ([Kseniia Sumarokova](https://github.com/kssenii)). * `clickhouse-server` without a configuration file will also listen to the PostgreSQL port 9005, like with the default config. [#82633](https://github.com/ClickHouse/ClickHouse/pull/82633) ([Alexey Milovidov](https://github.com/alexey-milovidov)). -* Integrate `StorageKafka2` to `system.kafka_consumers`. [#82652](https://github.com/ClickHouse/ClickHouse/pull/82652) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)). -* Estimate complex cnf/dnf, for example, `(a < 1 and a > 0) or b = 3`, by statistics. [#82663](https://github.com/ClickHouse/ClickHouse/pull/82663) ([Han Fei](https://github.com/hanfei1991)). * In `ReplicatedMergeTree::executeMetadataAlter`, we get the StorageID, and without taking DDLGuard, we try to call `IDatabase::alterTable`. In between this time we could have technically exchanged the table in question with another table, so when we get the definiton we would get the wrong one. To avoid this we add a separate check for UUIDs to match when we try to call `IDatabase::alterTable`. [#82666](https://github.com/ClickHouse/ClickHouse/pull/82666) ([Nikolay Degterinsky](https://github.com/evillique)). * When attaching a database with a read-only remote disk, manually add table UUIDs into DatabaseCatalog. [#82670](https://github.com/ClickHouse/ClickHouse/pull/82670) ([Tuan Pham Anh](https://github.com/tuanpach)). * Prevent user from using `nan` and `inf` with `NumericIndexedVector`. Fixes [#82239](https://github.com/ClickHouse/ClickHouse/issues/82239) and a little more. [#82681](https://github.com/ClickHouse/ClickHouse/pull/82681) ([Raufs Dunamalijevs](https://github.com/rienath)). * Do not omit zero values in the `X-ClickHouse-Progress` and `X-ClickHouse-Summary` header formats. [#82727](https://github.com/ClickHouse/ClickHouse/pull/82727) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)). * Keeper improvement: support specific permissions for world:anyone ACL. [#82755](https://github.com/ClickHouse/ClickHouse/pull/82755) ([Antonio Andelic](https://github.com/antonio2368)). -* Do not allow RENAME COLUMN or DROP COLUMN involving explicitly listed columns to sum in SummingMergeTree. Closes [#81836](https://github.com/ClickHouse/ClickHouse/issues/81836). [#82821](https://github.com/ClickHouse/ClickHouse/pull/82821) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Do not allow `RENAME COLUMN` or `DROP COLUMN` involving explicitly listed columns to sum in SummingMergeTree. Closes [#81836](https://github.com/ClickHouse/ClickHouse/issues/81836). [#82821](https://github.com/ClickHouse/ClickHouse/pull/82821) ([Alexey Milovidov](https://github.com/alexey-milovidov)). * Improve the precision of conversion from `Decimal` to `Float32`. Implement conversion from `Decimal` to `BFloat16`. Closes [#82660](https://github.com/ClickHouse/ClickHouse/issues/82660). [#82823](https://github.com/ClickHouse/ClickHouse/pull/82823) ([Alexey Milovidov](https://github.com/alexey-milovidov)). * Scrollbars in the Web UI will look slightly better. [#82869](https://github.com/ClickHouse/ClickHouse/pull/82869) ([Alexey Milovidov](https://github.com/alexey-milovidov)). * `clickhouse-server` with embedded configuration will allow using the Web UI by providing an HTTP OPTIONS response. [#82870](https://github.com/ClickHouse/ClickHouse/pull/82870) ([Alexey Milovidov](https://github.com/alexey-milovidov)). -* Highlight metacharacters in LIKE/REGEXP patterns as you type. We already have it in `clickhouse-format` and in the echo in `clickhouse-client`, but now it is done in the command prompt as well. [#82871](https://github.com/ClickHouse/ClickHouse/pull/82871) ([Alexey Milovidov](https://github.com/alexey-milovidov)). -* Highlighting in `clickhouse-format` and in the client's echo will work in the same way as the highlighting in the command line prompt. [#82874](https://github.com/ClickHouse/ClickHouse/pull/82874) ([Alexey Milovidov](https://github.com/alexey-milovidov)). * Add support for specifying extra Keeper ACL for paths in config. If you want to add extra ACL for a specific path you define it in the config under `zookeeper.path_acls`. [#82898](https://github.com/ClickHouse/ClickHouse/pull/82898) ([Antonio Andelic](https://github.com/antonio2368)). -* Add function to write types into wkb format. [#82935](https://github.com/ClickHouse/ClickHouse/pull/82935) ([Konstantin Vedernikov](https://github.com/scanhex12)). * Now mutations snapshot will be built from the visible parts snapshot. Also mutation counters used in snapshot will be recalculated from the included mutations. [#82945](https://github.com/ClickHouse/ClickHouse/pull/82945) ([Mikhail Artemenko](https://github.com/Michicosun)). * Adds ProfileEvent when Keeper rejects a write due to soft memory limit. [#82963](https://github.com/ClickHouse/ClickHouse/pull/82963) ([Xander Garbett](https://github.com/Garbett1)). * Add columns `commit_time`, `commit_id` to `system.s3queue_log`. [#83016](https://github.com/ClickHouse/ClickHouse/pull/83016) ([Kseniia Sumarokova](https://github.com/kssenii)). -* In some cases, we need to have multiple dimensions to our metrics. For example, counting failed merges or mutations by error codes rather than having a single counter. [#83030](https://github.com/ClickHouse/ClickHouse/pull/83030) ([Miсhael Stetsyuk](https://github.com/mstetsyuk)). +* In some cases, we need to have multiple dimensions to our metrics. For example, counting failed merges or mutations by error codes rather than having a single counter. Introduce `system.dimensional_metrics`, which does precisely that and adds the first dimensional metric called `failed_merges`. [#83030](https://github.com/ClickHouse/ClickHouse/pull/83030) ([Miсhael Stetsyuk](https://github.com/mstetsyuk)). * Consolidate unknown settings warnings in clickhouse client and log them as a summary. [#83042](https://github.com/ClickHouse/ClickHouse/pull/83042) ([Bharat Nallan](https://github.com/bharatnc)). * Clickhouse client now reports the local port when connection error happens. [#83050](https://github.com/ClickHouse/ClickHouse/pull/83050) ([Jianfei Hu](https://github.com/incfly)). * Slightly better error handling in `AsynchronousMetrics`. If the `/sys/block` directory exists but is not accessible, the server will start without monitoring the block devices. Closes [#79229](https://github.com/ClickHouse/ClickHouse/issues/79229). [#83115](https://github.com/ClickHouse/ClickHouse/pull/83115) ([Alexey Milovidov](https://github.com/alexey-milovidov)). -* Support `TimestampTZ` in Glue catalog. This closes [#81654](https://github.com/ClickHouse/ClickHouse/issues/81654). [#83132](https://github.com/ClickHouse/ClickHouse/pull/83132) ([Konstantin Vedernikov](https://github.com/scanhex12)). * Shutdown SystemLogs after ordinary tables (and before system tables, instead of before ordinary). [#83134](https://github.com/ClickHouse/ClickHouse/pull/83134) ([Kseniia Sumarokova](https://github.com/kssenii)). -* Add logs for s3queue shutdown process. [#83163](https://github.com/ClickHouse/ClickHouse/pull/83163) ([Kseniia Sumarokova](https://github.com/kssenii)). -* Async logs: Limit the max number of entries that are hold in the queue. [#83214](https://github.com/ClickHouse/ClickHouse/pull/83214) ([Raúl Marín](https://github.com/Algunenano)). -* Possibility to parse Time and Time64 as MM:SS, M:SS, SS, or S. [#83299](https://github.com/ClickHouse/ClickHouse/pull/83299) ([Yarik Briukhovetskyi](https://github.com/yariks5s)). +* Add logs for `S3Queue` shutdown process. [#83163](https://github.com/ClickHouse/ClickHouse/pull/83163) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Possibility to parse `Time` and `Time64` as `MM:SS`, `M:SS`, `SS`, or `S`. [#83299](https://github.com/ClickHouse/ClickHouse/pull/83299) ([Yarik Briukhovetskyi](https://github.com/yariks5s)). * When `distributed_ddl_output_mode='*_only_active'`, don't wait for new or recovered replicas that have replication lag bigger than `max_replication_lag_to_enqueue`. This should help to avoid `DDL task is not finished on some hosts` when a new replica becomes active after finishing initialization or recovery, but it accumulated huge replication log while initializing. Also, implement `SYSTEM SYNC DATABASE REPLICA STRICT` query that waits for replication log to become below `max_replication_lag_to_enqueue`. [#83302](https://github.com/ClickHouse/ClickHouse/pull/83302) ([Alexander Tokmakov](https://github.com/tavplubix)). * Do not output too long descriptions of expression actions in exception messages. Closes [#83164](https://github.com/ClickHouse/ClickHouse/issues/83164). [#83350](https://github.com/ClickHouse/ClickHouse/pull/83350) ([Alexey Milovidov](https://github.com/alexey-milovidov)). * Add ability to parse part's prefix and suffix and also check coverage for non constant columns. [#83377](https://github.com/ClickHouse/ClickHouse/pull/83377) ([Mikhail Artemenko](https://github.com/Michicosun)). -* Function `reinterpret()` function now supports conversion to `Array(T)` where `T` is a fixed-size data type (issue [#82621](https://github.com/ClickHouse/ClickHouse/issues/82621)). [#83399](https://github.com/ClickHouse/ClickHouse/pull/83399) ([Shankar Iyer](https://github.com/shankar-iyer)). * Unify parameter names in ODBC and JDBC when using named collections. [#83410](https://github.com/ClickHouse/ClickHouse/pull/83410) ([Andrey Zvonov](https://github.com/zvonand)). * When the storage is shutting down, `getStatus` throws an `ErrorCodes::ABORTED` exception. Previously, this would fail the select query. Now we catch the `ErrorCodes::ABORTED` exceptions and intentionally ignore them instead. [#83435](https://github.com/ClickHouse/ClickHouse/pull/83435) ([Miсhael Stetsyuk](https://github.com/mstetsyuk)). * Add process resource metrics (such as `UserTimeMicroseconds`, `SystemTimeMicroseconds`, `RealTimeMicroseconds`) to part_log profile events for `MergeParts` entries. [#83460](https://github.com/ClickHouse/ClickHouse/pull/83460) ([Vladimir Cherkasov](https://github.com/vdimir)). * Enable `create_if_not_exists`, `check_not_exists`, `remove_recursive` feature flags in Keeper by default which enable new types of requests. [#83488](https://github.com/ClickHouse/ClickHouse/pull/83488) ([Antonio Andelic](https://github.com/antonio2368)). * Shutdown S3(Azure/etc)Queue streaming before shutting down any tables on server shutdown. [#83530](https://github.com/ClickHouse/ClickHouse/pull/83530) ([Kseniia Sumarokova](https://github.com/kssenii)). -* Enable Date/Date32 as integers in JSON input formats. [#83597](https://github.com/ClickHouse/ClickHouse/pull/83597) ([MikhailBurdukov](https://github.com/MikhailBurdukov)). +* Enable `Date`/`Date32` as integers in `JSON` input formats. [#83597](https://github.com/ClickHouse/ClickHouse/pull/83597) ([MikhailBurdukov](https://github.com/MikhailBurdukov)). * Made exception messages for certain situations for loading and adding projections easier to read. [#83728](https://github.com/ClickHouse/ClickHouse/pull/83728) ([Robert Schulze](https://github.com/rschu1ze)). * Introduce a configuration option to skip binary checksum integrity checks for `clickhouse-server`. Resolves [#83637](https://github.com/ClickHouse/ClickHouse/issues/83637). [#83749](https://github.com/ClickHouse/ClickHouse/pull/83749) ([Rafael Roquetto](https://github.com/rafaelroquetto)). @@ -266,16 +261,16 @@ title: '2025 Changelog' * Fix deadlock on shutdown due to recursive context locking during library bridge cleanup. [#83824](https://github.com/ClickHouse/ClickHouse/pull/83824) ([Azat Khuzhin](https://github.com/azat)). #### Build/Testing/Packaging Improvement -* Build a minimal C library (10 KB) for the ClickHouse lexer. This is needed for [#80977](https://github.com/ClickHouse/ClickHouse/issues/80977). [#81347](https://github.com/ClickHouse/ClickHouse/pull/81347) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Build a minimal C library (10 KB) for the ClickHouse lexer. This is needed for [#80977](https://github.com/ClickHouse/ClickHouse/issues/80977). [#81347](https://github.com/ClickHouse/ClickHouse/pull/81347) ([Alexey Milovidov](https://github.com/alexey-milovidov)). Add test for standalone lexer, add test tag `fasttest-only`. [#82472](https://github.com/ClickHouse/ClickHouse/pull/82472) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)). * Add a check for Nix submodule inputs. [#81691](https://github.com/ClickHouse/ClickHouse/pull/81691) ([Konstantin Bogdanov](https://github.com/thevar1able)). +* Fix a list of problems that can occur when trying to run integration tests on a localhost. [#82135](https://github.com/ClickHouse/ClickHouse/pull/82135) ([Oleg Doronin](https://github.com/dorooleg)). * Compile SymbolIndex on Mac and FreeBSD. (But it will work only on ELF systems, Linux and FreeBSD). [#82347](https://github.com/ClickHouse/ClickHouse/pull/82347) ([Alexey Milovidov](https://github.com/alexey-milovidov)). -* Add test for standalone lexer, add test tag `fasttest-only`. [#82472](https://github.com/ClickHouse/ClickHouse/pull/82472) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)). * Bumped Azure SDK to v1.15.0. [#82747](https://github.com/ClickHouse/ClickHouse/pull/82747) ([Smita Kulkarni](https://github.com/SmitaRKulkarni)). * Add storage module from google-cloud-cpp to build system. [#82881](https://github.com/ClickHouse/ClickHouse/pull/82881) ([Pablo Marcos](https://github.com/pamarcos)). * Change `Dockerfile.ubuntu` for clickhouse-server to fit requirements in Docker Official Library. [#83039](https://github.com/ClickHouse/ClickHouse/pull/83039) ([Mikhail f. Shiryaev](https://github.com/Felixoid)). * A follow-up for [#83158](https://github.com/ClickHouse/ClickHouse/issues/83158) to fix uploading builds to `curl clickhouse.com`. [#83463](https://github.com/ClickHouse/ClickHouse/pull/83463) ([Mikhail f. Shiryaev](https://github.com/Felixoid)). * Adding `busybox` binary and install tools in `clickhouse/clickhouse-server` and official `clickhouse` images. [#83735](https://github.com/ClickHouse/ClickHouse/pull/83735) ([Mikhail f. Shiryaev](https://github.com/Felixoid)). -* Added support for the **`CLICKHOUSE_HOST` environment variable** to specify the ClickHouse server host, aligning with existing `CLICKHOUSE_USER` and `CLICKHOUSE_PASSWORD` environment variables. This allows for easier configuration without modifying client or configuration files directly. [#83659](https://github.com/ClickHouse/ClickHouse/pull/83659) ([Doron David](https://github.com/dorki)). +* Added support for the `CLICKHOUSE_HOST` environment variable to specify the ClickHouse server host, aligning with existing `CLICKHOUSE_USER` and `CLICKHOUSE_PASSWORD` environment variables. This allows for easier configuration without modifying client or configuration files directly. [#83659](https://github.com/ClickHouse/ClickHouse/pull/83659) ([Doron David](https://github.com/dorki)). ### ClickHouse release 25.6, 2025-06-26 {#256} diff --git a/docs/whats-new/roadmap.md b/docs/whats-new/roadmap.md index 93f7d5313dd..7ea4f22cbc3 100644 --- a/docs/whats-new/roadmap.md +++ b/docs/whats-new/roadmap.md @@ -3,6 +3,7 @@ title: 'Roadmap' slug: /whats-new/roadmap sidebar_position: 50 description: 'Present and past ClickHouse road maps' +doc_type: 'reference' --- ## Current roadmap {#current-roadmap} diff --git a/docs/whats-new/security-changelog.md b/docs/whats-new/security-changelog.md index 2f02469a7e5..d7c6123a1cf 100644 --- a/docs/whats-new/security-changelog.md +++ b/docs/whats-new/security-changelog.md @@ -4,6 +4,7 @@ sidebar_position: 20 sidebar_label: 'Security changelog' title: 'Security changelog' description: 'Security changelog detailing security related updates and changes' +doc_type: 'reference' --- # Security changelog diff --git a/scripts/categorizer.py b/scripts/categorizer.py new file mode 100644 index 00000000000..0a1bfaf52b4 --- /dev/null +++ b/scripts/categorizer.py @@ -0,0 +1,333 @@ +#!/usr/bin/env python3 +""" +Document Categorizer using Diataxis Framework +Automatically categorizes markdown documents and updates frontmatter with doc_type. +""" + +import os +import re +import asyncio +import aiohttp +import yaml +from pathlib import Path +from typing import Dict, List, Optional, Tuple +import argparse +import json +from datetime import datetime + +# Configuration +ANTHROPIC_API_KEY = os.getenv('ANTHROPIC_API_KEY', '') +API_URL = 'https://api.anthropic.com/v1/messages' +MODEL = 'claude-3-haiku-20240307' +MAX_CONTENT_LENGTH = 8000 +BATCH_SIZE = 5 +RATE_LIMIT_DELAY = 1 + +# Categorization prompt +CATEGORIZATION_PROMPT = """ +Categorize this markdown document using the Diataxis framework. + +Categories: +- tutorial: Learning-oriented, step-by-step learning journey +- how-to: Task-oriented, problem-solving guides with procedures +- reference: Information-oriented, systematic lookup material (APIs, tables, indexes) +- explanation: Understanding-oriented, conceptual background and context + +Guidelines: +- Index/TOC pages with tables of links → reference +- Step-by-step guides with procedures → how-to +- Conceptual overviews and FAQs → explanation +- Learning journeys for beginners → tutorial + +Filename: {filename} +Title: {title} +Description: {description} + +Content: {content} + +IMPORTANT: Respond with ONLY one word: tutorial, how-to, reference, or explanation +""" + +class DocumentCategorizer: + def __init__(self, api_key: str, dry_run: bool = False): + self.api_key = api_key + self.dry_run = dry_run + self.session = None + self.results = [] + + async def __aenter__(self): + self.session = aiohttp.ClientSession() + return self + + async def __aexit__(self, exc_type, exc_val, exc_tb): + if self.session: + await self.session.close() + + def extract_frontmatter_info(self, content: str) -> Tuple[Optional[Dict], str, bool]: + """Extract frontmatter info without full parsing.""" + frontmatter_pattern = r'^---\s*\n(.*?)\n---\s*\n(.*)$' + match = re.match(frontmatter_pattern, content, re.DOTALL) + + if not match: + return None, content, False + + try: + yaml_content = match.group(1) + body_content = match.group(2) + frontmatter_dict = yaml.safe_load(yaml_content) + has_doc_type = frontmatter_dict and 'doc_type' in frontmatter_dict + return frontmatter_dict or {}, body_content, has_doc_type + except yaml.YAMLError as e: + print(f"YAML parsing error: {e}") + return None, content, False + + async def categorize_document(self, content: str, filename: str, frontmatter: Dict) -> str: + """Send document to Claude API for categorization.""" + if not self.api_key: + raise ValueError("ANTHROPIC_API_KEY environment variable not set") + + # Prepare content for API + truncated_content = content[:MAX_CONTENT_LENGTH] + if len(content) > MAX_CONTENT_LENGTH: + truncated_content += "\n... (truncated)" + + # Build prompt + prompt = CATEGORIZATION_PROMPT.format( + filename=filename, + title=frontmatter.get('title', ''), + description=frontmatter.get('description', ''), + content=truncated_content + ) + + # API request + headers = { + 'x-api-key': self.api_key, + 'Content-Type': 'application/json', + 'anthropic-version': '2023-06-01' + } + + data = { + 'model': MODEL, + 'max_tokens': 20, + 'messages': [{'role': 'user', 'content': prompt}] + } + + async with self.session.post(API_URL, headers=headers, json=data) as response: + if response.status != 200: + error_text = await response.text() + raise Exception(f"API request failed: {response.status} - {error_text}") + + result = await response.json() + raw_response = result['content'][0]['text'].strip().lower() + + # Extract category from response + valid_categories = {'tutorial', 'how-to', 'reference', 'explanation'} + + # Look for exact matches first + for category in valid_categories: + if category in raw_response: + return category + + # Fallback patterns + if 'tutorial' in raw_response or 'learning' in raw_response: + return 'tutorial' + elif 'how-to' in raw_response or 'how to' in raw_response or 'step-by-step' in raw_response: + return 'how-to' + elif 'reference' in raw_response or 'lookup' in raw_response or 'api' in raw_response: + return 'reference' + else: + return 'explanation' + + def add_doc_type_to_frontmatter(self, file_path: Path, category: str) -> bool: + """Add doc_type to existing frontmatter without reformatting.""" + try: + with open(file_path, 'r', encoding='utf-8') as f: + content = f.read() + + # Find the frontmatter sections + match = re.match(r'^(---\s*\n)(.*?)(\n---\s*\n)(.*)$', content, re.DOTALL) + if not match: + return False + + frontmatter_start = match.group(1) # "---\n" + frontmatter_content = match.group(2) # The YAML content + frontmatter_end = match.group(3) # "\n---\n" + body = match.group(4) # Rest of document + + # Add doc_type as the last line in frontmatter + new_frontmatter_content = frontmatter_content + f"\ndoc_type: '{category}'" + new_content = f"{frontmatter_start}{new_frontmatter_content}{frontmatter_end}{body}" + + if not self.dry_run: + with open(file_path, 'w', encoding='utf-8') as f: + f.write(new_content) + + return True + except Exception as e: + print(f"Error updating {file_path}: {e}") + return False + + async def process_document(self, file_path: Path) -> Dict: + """Process a single document.""" + try: + with open(file_path, 'r', encoding='utf-8') as f: + content = f.read() + + frontmatter_dict, body, has_doc_type = self.extract_frontmatter_info(content) + + # Skip files without frontmatter + if frontmatter_dict is None: + return { + 'file': str(file_path), + 'status': 'skipped', + 'reason': 'no_frontmatter' + } + + # Skip if already categorized + if has_doc_type: + return { + 'file': str(file_path), + 'status': 'skipped', + 'reason': 'already_categorized', + 'existing_category': frontmatter_dict['doc_type'] + } + + # Categorize using API + category = await self.categorize_document(body, file_path.name, frontmatter_dict) + + # Update file + if self.add_doc_type_to_frontmatter(file_path, category): + return { + 'file': str(file_path), + 'status': 'success', + 'category': category + } + else: + return { + 'file': str(file_path), + 'status': 'error', + 'reason': 'failed_to_update' + } + + except Exception as e: + return { + 'file': str(file_path), + 'status': 'error', + 'reason': str(e) + } + + async def process_batch(self, files: List[Path]) -> List[Dict]: + """Process a batch of files.""" + tasks = [self.process_document(file_path) for file_path in files] + return await asyncio.gather(*tasks, return_exceptions=True) + + async def process_directory(self, directory: Path, pattern: str = "*.md") -> None: + """Process all matching files in directory.""" + files = list(directory.rglob(pattern)) + total_files = len(files) + + print(f"Found {total_files} markdown files") + if self.dry_run: + print("DRY RUN MODE - No files will be modified") + + processed = 0 + + # Process in batches + for i in range(0, total_files, BATCH_SIZE): + batch = files[i:i + BATCH_SIZE] + print(f"Processing batch {i // BATCH_SIZE + 1} ({len(batch)} files)...") + + try: + results = await self.process_batch(batch) + self.results.extend(results) + processed += len(batch) + + # Rate limiting + if i + BATCH_SIZE < total_files: + await asyncio.sleep(RATE_LIMIT_DELAY) + + # Progress update + print(f"Progress: {processed}/{total_files} files processed") + + except Exception as e: + print(f"Error processing batch: {e}") + continue + + def print_summary(self) -> None: + """Print processing summary.""" + success = sum(1 for r in self.results if r.get('status') == 'success') + skipped = sum(1 for r in self.results if r.get('status') == 'skipped') + errors = sum(1 for r in self.results if r.get('status') == 'error') + + print(f"\n=== Summary ===") + print(f"Successfully categorized: {success}") + print(f"Skipped (already categorized or no frontmatter): {skipped}") + print(f"Errors: {errors}") + + # Show category breakdown + categories = {} + for r in self.results: + if r.get('status') == 'success': + cat = r.get('category') + categories[cat] = categories.get(cat, 0) + 1 + + if categories: + print(f"\nCategory breakdown:") + for cat, count in sorted(categories.items()): + print(f" {cat}: {count}") + + # Show errors + error_results = [r for r in self.results if r.get('status') == 'error'] + if error_results: + print(f"\nErrors:") + for r in error_results[:10]: + print(f" {r['file']}: {r.get('reason', 'Unknown error')}") + if len(error_results) > 10: + print(f" ... and {len(error_results) - 10} more") + +async def main(): + parser = argparse.ArgumentParser(description='Categorize markdown documents using Diataxis framework') + parser.add_argument('directory', help='Directory containing markdown files') + parser.add_argument('--pattern', default='*.md', help='File pattern to match (default: *.md)') + parser.add_argument('--dry-run', action='store_true', help='Show what would be done without making changes') + parser.add_argument('--output-log', help='Save results to JSON file') + + args = parser.parse_args() + + directory = Path(args.directory) + if not directory.exists(): + print(f"Error: Directory {directory} does not exist") + return 1 + + if not ANTHROPIC_API_KEY: + print("Error: ANTHROPIC_API_KEY environment variable not set") + print("Get your API key from: https://console.anthropic.com/") + return 1 + + async with DocumentCategorizer(ANTHROPIC_API_KEY, args.dry_run) as categorizer: + try: + await categorizer.process_directory(directory, args.pattern) + categorizer.print_summary() + + if args.output_log: + with open(args.output_log, 'w') as f: + json.dump({ + 'timestamp': datetime.now().isoformat(), + 'directory': str(directory), + 'pattern': args.pattern, + 'dry_run': args.dry_run, + 'results': categorizer.results + }, f, indent=2) + print(f"Results saved to {args.output_log}") + + except KeyboardInterrupt: + print("\nInterrupted by user") + return 1 + except Exception as e: + print(f"Error: {e}") + return 1 + + return 0 + +if __name__ == '__main__': + exit(asyncio.run(main())) \ No newline at end of file From b5aaf9b02f00141976a5ccb05e609941d49c0b5a Mon Sep 17 00:00:00 2001 From: Dominic Tran Date: Wed, 27 Aug 2025 09:43:24 -0500 Subject: [PATCH 2/6] aspell --- scripts/aspell-ignore/en/aspell-dict.txt | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/scripts/aspell-ignore/en/aspell-dict.txt b/scripts/aspell-ignore/en/aspell-dict.txt index a1c061b7cbe..18eb6a8c29e 100644 --- a/scripts/aspell-ignore/en/aspell-dict.txt +++ b/scripts/aspell-ignore/en/aspell-dict.txt @@ -1,4 +1,4 @@ -personal_ws-1.1 en 3638 +personal_ws-1.1 en 3646 AArch ACLs AICPA @@ -646,10 +646,10 @@ LOCALTIMESTAMP LONGLONG LOONGARCH LaGuardia +Lakekeeper LangChain LangGraph Langchain -Lakekeeper Lemire Levenshtein Lhotsky @@ -794,7 +794,6 @@ NDJSON NEKUDOTAYIM NEWDATE NEWDECIMAL -Nessie NFKC NFKD NIST @@ -809,6 +808,7 @@ Nambiar Namenode NamesAndTypesList Nano +Nessie NestJS Nesterov NetFlow @@ -968,8 +968,8 @@ PendingAsyncInsert Percona PerfEventInfo PhpStorm -PlantUML PlanetScale +PlantUML Poess PointDistKm PointDistM @@ -1019,10 +1019,10 @@ ProxySQL Punycode PyArrow PyCharm -Pydantic PyPI PyReader PySpark +Pydantic PydanticAI QATlib QEMU @@ -1292,7 +1292,6 @@ ThreadPoolRemoteFSReaderThreads ThreadPoolRemoteFSReaderThreadsActive ThreadsActive ThreadsInOvercommitTracker -Trino TiDB TimeSeries TimescaleDB @@ -1324,6 +1323,7 @@ TotalsMode Tradeoff Transactional TransactionsWaitCSNMode +Trino Tsai Tukey TwoColumnList @@ -2855,6 +2855,7 @@ profiler programmatically proleptic prometheus +promql proportionsZTest proto protobuf @@ -3634,6 +3635,7 @@ xz yaml yandex youtube +ytsaurus zLib zLinux zabbix From 69cbbfb905362af9323a94b85ee5cbf2718292fc Mon Sep 17 00:00:00 2001 From: Dominic Tran Date: Tue, 2 Sep 2025 10:49:15 -0500 Subject: [PATCH 3/6] Adding doc_type as a required field in frontmatter --- plugins/frontmatter-validation/customParseFrontMatter.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/frontmatter-validation/customParseFrontMatter.js b/plugins/frontmatter-validation/customParseFrontMatter.js index ac64a9a8b2c..5919a0329f1 100644 --- a/plugins/frontmatter-validation/customParseFrontMatter.js +++ b/plugins/frontmatter-validation/customParseFrontMatter.js @@ -141,7 +141,7 @@ async function customParseFrontMatter(params) { // Use Docusaurus's default parser to get the frontmatter data const parsedData = await defaultParseFrontMatter(params); // Check for required fields - const requiredFields = ['title', 'slug', 'description']; + const requiredFields = ['title', 'slug', 'description', 'doc_type']; for (const field of requiredFields) { if (!parsedData.frontMatter[field]) { issues.push(`missing required field: ${field}`); From a907c708a37118a13be6f4346dc3ac19536f8763 Mon Sep 17 00:00:00 2001 From: Dominic Tran Date: Fri, 5 Sep 2025 14:21:23 -0500 Subject: [PATCH 4/6] categories guide, reference, changelog and landing page for our purposes. docs retyped --- .../api/_services-api-reference.md | 2 +- docs/_placeholders/changelog/_index.md | 2 +- docs/_snippets/_tabs.md | 23 -- docs/about-us/about-faq-index.md | 2 +- docs/about-us/distinctive-features.md | 2 +- docs/about-us/history.md | 2 +- docs/about-us/index.md | 2 +- docs/best-practices/avoid_mutations.md | 2 +- docs/best-practices/avoid_optimize_final.md | 2 +- docs/best-practices/choosing_a_primary_key.md | 2 +- docs/best-practices/index.md | 2 +- .../best-practices/minimize_optimize_joins.md | 2 +- .../selecting_an_insert_strategy.md | 2 +- .../sizing-and-hardware-recommendations.md | 2 +- docs/best-practices/use_materialized_views.md | 2 +- .../using_data_skipping_indices.md | 2 +- docs/chdb/getting-started.md | 2 +- docs/chdb/guides/clickhouse-local.md | 2 +- docs/chdb/guides/index.md | 2 +- docs/chdb/guides/jupysql.md | 2 +- docs/chdb/guides/query-remote-clickhouse.md | 2 +- docs/chdb/guides/querying-apache-arrow.md | 2 +- docs/chdb/guides/querying-pandas.md | 2 +- docs/chdb/guides/querying-parquet.md | 2 +- docs/chdb/guides/querying-s3-bucket.md | 2 +- docs/chdb/index.md | 2 +- docs/chdb/install/bun.md | 2 +- docs/chdb/install/c.md | 2 +- docs/chdb/install/go.md | 2 +- docs/chdb/install/index.md | 2 +- docs/chdb/install/nodejs.md | 2 +- docs/chdb/install/python.md | 2 +- docs/chdb/install/rust.md | 2 +- docs/cloud-index.md | 2 +- docs/cloud/bestpractices/index.md | 2 +- docs/cloud/bestpractices/multitenancy.md | 2 +- docs/cloud/changelogs/24_02.md | 2 +- docs/cloud/changelogs/24_05.md | 2 +- docs/cloud/changelogs/24_06.md | 2 +- docs/cloud/changelogs/24_08.md | 2 +- docs/cloud/changelogs/24_10.md | 2 +- docs/cloud/changelogs/24_12.md | 2 +- docs/cloud/changelogs/25_04.md | 2 +- docs/cloud/changelogs/25_06.md | 2 +- docs/cloud/get-started/index.md | 2 +- docs/cloud/get-started/query-endpoints.md | 2 +- docs/cloud/get-started/query-insights.md | 2 +- docs/cloud/get-started/sql-console.md | 2 +- docs/cloud/manage/account-close.md | 2 +- docs/cloud/manage/api/index.md | 2 +- .../manage/backups/configurable-backups.md | 2 +- .../export-backups-to-own-cloud-account.md | 2 +- docs/cloud/manage/backups/index.md | 2 +- docs/cloud/manage/backups/overview.md | 2 +- docs/cloud/manage/billing/index.md | 2 +- .../marketplace/aws-marketplace-committed.md | 2 +- .../marketplace/aws-marketplace-payg.md | 2 +- .../azure-marketplace-committed.md | 2 +- .../marketplace/azure-marketplace-payg.md | 2 +- .../marketplace/gcp-marketplace-committed.md | 2 +- .../marketplace/gcp-marketplace-payg.md | 2 +- .../cloud/manage/billing/marketplace/index.md | 2 +- .../migrate-marketplace-payg-committed.md | 2 +- .../manage/billing/marketplace/overview.md | 2 +- .../manage/billing/payment-thresholds.md | 2 +- docs/cloud/manage/dashboards.md | 2 +- docs/cloud/manage/hyperdx.md | 2 +- docs/cloud/manage/index.md | 2 +- docs/cloud/manage/jan2025_faq/backup.md | 2 +- docs/cloud/manage/jan2025_faq/billing.md | 2 +- docs/cloud/manage/jan2025_faq/dimensions.md | 2 +- docs/cloud/manage/jan2025_faq/index.md | 12 +- docs/cloud/manage/jan2025_faq/new_tiers.md | 2 +- .../manage/jan2025_faq/plan_migrations.md | 2 +- docs/cloud/manage/jan2025_faq/scaling.md | 2 +- docs/cloud/manage/jan2025_faq/summary.md | 2 +- .../manage/monitoring/advanced_dashboard.md | 2 +- docs/cloud/manage/notifications.md | 2 +- docs/cloud/manage/openapi.md | 2 +- docs/cloud/manage/postman.md | 2 +- docs/cloud/manage/replica-aware-routing.md | 2 +- docs/cloud/manage/scaling.md | 2 +- docs/cloud/manage/settings.md | 2 +- .../manage/troubleshooting-billing-issues.md | 2 +- docs/cloud/manage/upgrades.md | 2 +- docs/cloud/migrate/upload-a-csv-file.md | 2 +- docs/cloud/reference/changelog.md | 2 +- docs/cloud/reference/changelogs-index.md | 2 +- docs/cloud/reference/cloud-compatibility.md | 2 +- docs/cloud/reference/index.md | 2 +- docs/cloud/reference/release-notes-index.md | 2 +- docs/cloud/reference/shared-catalog.md | 2 +- .../security/accessing-s3-data-securely.md | 2 +- docs/cloud/security/aws-privatelink.md | 2 +- docs/cloud/security/azure-privatelink.md | 2 +- .../cloud-access-management.md | 2 +- .../cloud-authentication.md | 2 +- .../security/cloud-access-management/index.md | 2 +- docs/cloud/security/cmek.md | 2 +- .../common-access-management-queries.md | 2 +- docs/cloud/security/compliance-overview.md | 2 +- docs/cloud/security/connectivity-overview.md | 2 +- .../security/gcp-private-service-connect.md | 2 +- docs/cloud/security/index.md | 2 +- docs/cloud/security/inviting-new-users.md | 2 +- .../security/privacy-compliance-overview.md | 2 +- docs/cloud/security/private-link-overview.md | 2 +- docs/cloud/security/saml-sso-setup.md | 2 +- docs/cloud/security/setting-ip-filters.md | 2 +- docs/cloud/support.md | 2 +- docs/concepts/index.md | 2 +- docs/concepts/olap.md | 2 +- docs/data-modeling/backfilling.md | 2 +- docs/data-modeling/denormalization.md | 2 +- docs/data-modeling/index.md | 2 +- .../projections/1_projections.md | 2 +- ...2_materialized-views-versus-projections.md | 2 +- docs/data-modeling/schema-design.md | 2 +- docs/deployment-guides/index.md | 2 +- .../01_1_shard_2_replicas.md | 2 +- .../02_2_shards_1_replica.md | 2 +- .../03_2_shards_2_replicas.md | 2 +- docs/deployment-guides/terminology.md | 2 +- docs/deployment-modes.md | 2 +- docs/faq/general/columnar-database.md | 2 +- docs/faq/general/dbms-naming.md | 2 +- docs/faq/general/index.md | 2 +- docs/faq/general/mapreduce.md | 2 +- docs/faq/general/ne-tormozit.md | 2 +- docs/faq/general/olap.md | 2 +- docs/faq/index.md | 2 +- docs/faq/integration/index.md | 2 +- docs/faq/integration/json-import.md | 2 +- docs/faq/integration/oracle-odbc.md | 2 +- docs/faq/operations/delete-old-data.md | 2 +- docs/faq/operations/index.md | 2 +- docs/faq/operations/production.md | 2 +- docs/faq/operations/separate_storage.md | 2 +- docs/faq/troubleshooting.md | 2 +- docs/faq/use-cases/index.md | 2 +- docs/faq/use-cases/key-value.md | 2 +- docs/faq/use-cases/time-series.md | 2 +- .../example-datasets/amazon-reviews.md | 2 +- .../example-datasets/cell-towers.md | 2 +- .../example-datasets/laion5b.md | 1 + .../example-datasets/nyc-taxi.md | 2 +- .../example-datasets/nypd_complaint_data.md | 2 +- .../getting-started/example-datasets/tpcds.md | 2 +- docs/getting-started/index.md | 31 +- docs/getting-started/install/advanced.md | 2 +- docs/getting-started/install/debian_ubuntu.md | 2 +- docs/getting-started/install/docker.md | 2 +- docs/getting-started/install/macos.md | 2 +- docs/getting-started/install/other_linux.md | 2 +- .../install/quick-install-curl.md | 2 +- docs/getting-started/install/redhat.md | 2 +- docs/getting-started/install/windows.md | 2 +- docs/getting-started/playground.md | 2 +- docs/guides/best-practices/asyncinserts.md | 2 +- docs/guides/best-practices/avoidmutations.md | 2 +- .../best-practices/avoidnullablecolumns.md | 2 +- .../best-practices/avoidoptimizefinal.md | 2 +- docs/guides/best-practices/bulkinserts.md | 2 +- docs/guides/best-practices/partitioningkey.md | 2 +- docs/guides/best-practices/prewhere.md | 2 +- .../best-practices/query-optimization.md | 2 +- .../best-practices/query-parallelism.md | 2 +- .../guides/best-practices/skipping-indexes.md | 2 +- .../best-practices/sparse-primary-indexes.md | 2 +- docs/guides/creating-tables.md | 2 +- .../developer/cascading-materialized-views.md | 2 +- .../developer/debugging-memory-issues.md | 2 +- .../deduplicating-inserts-on-retries.md | 2 +- docs/guides/developer/deduplication.md | 2 +- .../developer/dynamic-column-selection.md | 2 +- docs/guides/developer/index.md | 2 +- docs/guides/developer/mutations.md | 2 +- docs/guides/developer/on-fly-mutations.md | 2 +- docs/guides/developer/replacing-merge-tree.md | 2 +- .../developer/time-series-filling-gaps.md | 2 +- docs/guides/developer/ttl.md | 2 +- ...nding-query-execution-with-the-analyzer.md | 2 +- .../aggregate_function_combinators/anyIf.md | 2 +- .../aggregate_function_combinators/avgIf.md | 2 +- .../aggregate_function_combinators/avgMap.md | 2 +- .../avgMergeState.md | 2 +- .../avgResample.md | 2 +- .../avgState.md | 2 +- .../aggregate_function_combinators/countIf.md | 2 +- .../countResample.md | 2 +- .../groupArrayDistinct.md | 2 +- .../groupArrayResample.md | 2 +- .../quantilesTimingArrayIf.md | 2 +- .../sumForEach.md | 2 +- .../sumSimpleState.md | 2 +- .../uniqArrayIf.md | 2 +- docs/guides/inserting-data.md | 2 +- docs/guides/joining-tables.md | 2 +- docs/guides/manage-and-deploy-index.md | 2 +- docs/guides/separation-storage-compute.md | 2 +- docs/guides/sre/configuring-ssl.md | 2 +- docs/guides/sre/index.md | 2 +- docs/guides/sre/keeper/index.md | 2 +- docs/guides/sre/scaling-clusters.md | 2 +- .../sre/user-management/configuring-ldap.md | 2 +- docs/guides/sre/user-management/index.md | 2 +- .../sre/user-management/ssl-user-auth.md | 2 +- docs/guides/troubleshooting.md | 2 +- docs/guides/writing-queries.md | 2 +- .../data-ingestion/apache-spark/index.md | 2 +- .../data-ingestion/apache-spark/spark-jdbc.md | 2 +- .../apache-spark/spark-native-connector.md | 2 +- .../data-ingestion/aws-glue/index.md | 2 +- .../azure-data-factory/index.md | 2 +- .../azure-data-factory/overview.md | 2 +- .../using_azureblobstorage.md | 2 +- .../using_http_interface.md | 2 +- .../data-ingestion/azure-synapse/index.md | 2 +- .../clickpipes/aws-privatelink.md | 2 +- .../data-ingestion/clickpipes/index.md | 2 +- .../kafka/01_create-kafka-clickpipe.md | 2 +- .../clickpipes/kafka/02_schema-registries.md | 2 +- .../clickpipes/kafka/04_best_practices.md | 2 +- .../data-ingestion/clickpipes/kafka/05_faq.md | 2 +- .../data-ingestion/clickpipes/kafka/index.md | 6 +- .../data-ingestion/clickpipes/kinesis.md | 2 +- .../clickpipes/mongodb/add_table.md | 2 +- .../clickpipes/mongodb/controlling_sync.md | 2 +- .../clickpipes/mongodb/index.md | 2 +- .../clickpipes/mongodb/lifecycle.md | 2 +- .../clickpipes/mongodb/pause_and_resume.md | 2 +- .../clickpipes/mongodb/quickstart.md | 2 +- .../clickpipes/mongodb/remove_table.md | 2 +- .../clickpipes/mongodb/resync.md | 2 +- .../clickpipes/mongodb/source/atlas.md | 2 +- .../clickpipes/mongodb/source/generic.md | 2 +- .../clickpipes/mysql/add_table.md | 2 +- .../clickpipes/mysql/controlling_sync.md | 2 +- .../data-ingestion/clickpipes/mysql/faq.md | 2 +- .../data-ingestion/clickpipes/mysql/index.md | 2 +- .../clickpipes/mysql/lifecycle.md | 2 +- .../clickpipes/mysql/parallel_initial_load.md | 2 +- .../clickpipes/mysql/pause_and_resume.md | 2 +- .../clickpipes/mysql/remove_table.md | 2 +- .../data-ingestion/clickpipes/mysql/resync.md | 2 +- .../clickpipes/mysql/source/aurora.md | 2 +- .../clickpipes/mysql/source/gcp.md | 2 +- .../clickpipes/mysql/source/generic.md | 2 +- .../clickpipes/mysql/source/generic_maria.md | 2 +- .../clickpipes/mysql/source/rds.md | 2 +- .../clickpipes/mysql/source/rds_maria.md | 2 +- .../clickpipes/object-storage.md | 2 +- .../clickpipes/postgres/add_table.md | 2 +- .../clickpipes/postgres/controlling_sync.md | 2 +- .../clickpipes/postgres/deduplication.md | 2 +- .../clickpipes/postgres/index.md | 2 +- .../clickpipes/postgres/lifecycle.md | 2 +- .../clickpipes/postgres/ordering_keys.md | 2 +- .../postgres/parallel_initial_load.md | 2 +- .../clickpipes/postgres/pause_and_resume.md | 2 +- .../postgres/postgres_generated_columns.md | 2 +- .../clickpipes/postgres/remove_table.md | 2 +- .../clickpipes/postgres/resync.md | 2 +- .../clickpipes/postgres/scaling.md | 2 +- .../clickpipes/postgres/source/aurora.md | 2 +- .../source/azure-flexible-server-postgres.md | 2 +- .../postgres/source/crunchy-postgres.md | 2 +- .../clickpipes/postgres/source/generic.md | 2 +- .../postgres/source/google-cloudsql.md | 2 +- .../postgres/source/neon-postgres.md | 2 +- .../clickpipes/postgres/source/planetscale.md | 2 +- .../clickpipes/postgres/source/rds.md | 2 +- .../clickpipes/postgres/source/supabase.md | 2 +- .../clickpipes/postgres/source/timescale.md | 2 +- .../clickpipes/postgres/table_resync.md | 2 +- .../clickpipes/postgres/toast.md | 2 +- .../clickpipes/secure-kinesis.md | 2 +- .../data-ingestion/clickpipes/secure-rds.md | 2 +- .../data-formats/arrow-avro-orc.md | 2 +- .../data-ingestion/data-formats/binary.md | 2 +- .../data-ingestion/data-formats/csv-tsv.md | 2 +- .../data-ingestion/data-formats/intro.md | 2 +- .../data-formats/json/exporting.md | 2 +- .../data-formats/json/formats.md | 2 +- .../data-formats/json/inference.md | 2 +- .../data-ingestion/data-formats/json/intro.md | 2 +- .../data-formats/json/loading.md | 2 +- .../data-ingestion/data-formats/json/other.md | 2 +- .../data-formats/json/schema.md | 2 +- .../data-ingestion/data-formats/parquet.md | 2 +- .../data-ingestion/data-formats/sql.md | 2 +- .../data-formats/templates-regex.md | 2 +- .../data-ingestion/data-ingestion-index.md | 2 +- .../data-ingestion/data-sources-index.md | 2 +- .../data-ingestion/dbms/dynamodb/index.md | 2 +- .../dbms/jdbc-with-clickhouse.md | 2 +- .../data-ingestion/dbms/mysql/index.md | 2 +- .../postgresql/connecting-to-postgresql.md | 2 +- .../dbms/postgresql/inserting-data.md | 2 +- .../integrations/data-ingestion/emqx/index.md | 2 +- .../etl-tools/airbyte-and-clickhouse.md | 2 +- .../data-ingestion/etl-tools/apache-beam.md | 2 +- .../etl-tools/bladepipe-and-clickhouse.md | 2 +- .../data-ingestion/etl-tools/dbt/index.md | 2 +- .../etl-tools/dlt-and-clickhouse.md | 2 +- .../etl-tools/fivetran/index.md | 2 +- .../etl-tools/nifi-and-clickhouse.md | 2 +- .../etl-tools/vector-to-clickhouse.md | 2 +- docs/integrations/data-ingestion/gcs/index.md | 2 +- .../google-dataflow/dataflow.md | 2 +- .../google-dataflow/java-runner.md | 2 +- .../google-dataflow/templates.md | 2 +- .../templates/bigquery-to-clickhouse.md | 2 +- .../data-ingestion/insert-local-files.md | 2 +- .../kafka/confluent/confluent-cloud.md | 2 +- .../kafka/confluent/custom-connector.md | 2 +- .../data-ingestion/kafka/confluent/index.md | 2 +- .../kafka/confluent/kafka-connect-http.md | 2 +- .../data-ingestion/kafka/index.md | 2 +- .../kafka/kafka-clickhouse-connect-sink.md | 2 +- .../kafka/kafka-connect-jdbc.md | 2 +- .../kafka-table-engine-named-collections.md | 2 +- .../kafka/kafka-table-engine.md | 2 +- .../data-ingestion/kafka/kafka-vector.md | 2 +- .../data-ingestion/kafka/msk/index.md | 2 +- .../data-ingestion/redshift/index.md | 2 +- docs/integrations/data-ingestion/s3-minio.md | 2 +- docs/integrations/data-ingestion/s3/index.md | 2 +- .../data-ingestion/s3/performance.md | 2 +- docs/integrations/data-sources/iceberg.md | 2 +- docs/integrations/data-sources/postgres.md | 2 +- .../astrato-and-clickhouse.md | 2 +- .../chartbrew-and-clickhouse.md | 2 +- .../data-visualization/deepnote.md | 2 +- .../draxlr-and-clickhouse.md | 2 +- .../embeddable-and-clickhouse.md | 2 +- .../explo-and-clickhouse.md | 2 +- .../data-visualization/fabi-and-clickhouse.md | 2 +- .../data-visualization/grafana/config.md | 2 +- .../data-visualization/grafana/index.md | 2 +- .../grafana/query-builder.md | 2 +- .../hashboard-and-clickhouse.md | 2 +- docs/integrations/data-visualization/index.md | 2 +- .../looker-and-clickhouse.md | 2 +- .../looker-studio-and-clickhouse.md | 2 +- .../luzmo-and-clickhouse.md | 2 +- .../metabase-and-clickhouse.md | 2 +- .../mitzu-and-clickhouse.md | 2 +- .../data-visualization/omni-and-clickhouse.md | 2 +- .../powerbi-and-clickhouse.md | 2 +- .../quicksight-and-clickhouse.md | 2 +- .../rocketbi-and-clickhouse.md | 2 +- .../splunk-and-clickhouse.md | 2 +- .../superset-and-clickhouse.md | 2 +- .../tableau/tableau-analysis-tips.md | 2 +- .../tableau/tableau-and-clickhouse.md | 2 +- .../tableau/tableau-connection-tips.md | 2 +- .../tableau/tableau-online-and-clickhouse.md | 2 +- .../zingdata-and-clickhouse.md | 2 +- docs/integrations/language-clients/csharp.md | 2 +- .../integrations/language-clients/go/index.md | 2 +- docs/integrations/language-clients/index.md | 2 +- .../language-clients/java/r2dbc.md | 2 +- .../language-clients/moose-olap.md | 2 +- .../language-clients/python/index.md | 2 +- docs/integrations/language-clients/rust.md | 2 +- .../migration/clickhouse-local-etl.md | 2 +- .../migration/clickhouse-to-cloud.md | 2 +- .../migration/etl-tool-to-clickhouse.md | 2 +- docs/integrations/migration/index.md | 2 +- .../migration/object-storage-to-clickhouse.md | 2 +- docs/integrations/migration/overview.md | 2 +- docs/integrations/misc/index.md | 2 +- docs/integrations/sql-clients/datagrip.md | 2 +- docs/integrations/sql-clients/dbeaver.md | 2 +- docs/integrations/sql-clients/dbvisualizer.md | 2 +- docs/integrations/sql-clients/index.md | 2 +- docs/integrations/sql-clients/jupysql.md | 2 +- docs/integrations/sql-clients/marimo.md | 2 +- docs/integrations/sql-clients/qstudio.md | 2 +- docs/integrations/sql-clients/sql-console.md | 2 +- docs/integrations/sql-clients/tablum.md | 2 +- .../tools/data-integration/easypanel/index.md | 2 +- .../tools/data-integration/index.md | 2 +- .../tools/data-integration/retool/index.md | 2 +- .../tools/data-integration/splunk/index.md | 2 +- docs/integrations/tools/index.md | 2 +- docs/intro.md | 2 +- docs/introduction-index.md | 2 +- docs/managing-data/core-concepts/index.md | 2 +- docs/managing-data/deleting-data/index.md | 2 +- docs/managing-data/truncate.md | 2 +- docs/managing-data/updating-data/index.md | 2 +- .../incremental-materialized-view.md | 2 +- docs/materialized-view/index.md | 2 +- .../refreshable-materialized-view.md | 2 +- .../bigquery/equivalent-concepts.md | 2 +- docs/migrations/bigquery/index.md | 2 +- docs/migrations/bigquery/loading-data.md | 2 +- .../bigquery/migrating-to-clickhouse-cloud.md | 2 +- docs/migrations/index.md | 2 +- .../postgres/data-modeling-techniques.md | 2 +- docs/migrations/postgres/dataset.md | 2 +- docs/migrations/postgres/index.md | 2 +- docs/migrations/postgres/overview.md | 2 +- docs/migrations/postgres/rewriting-queries.md | 2 +- docs/migrations/snowflake.md | 2 +- docs/native-protocol/basics.md | 2 +- docs/native-protocol/client.md | 2 +- docs/native-protocol/server.md | 2 +- docs/starter-guides/index.md | 2 +- docs/tips-and-tricks/community-wisdom.md | 2 +- docs/tips-and-tricks/cost-optimization.md | 2 +- docs/tips-and-tricks/debugging-insights.md | 2 +- docs/tips-and-tricks/materialized-views.md | 2 +- .../performance-optimization.md | 2 +- docs/tips-and-tricks/success-stories.md | 2 +- docs/tips-and-tricks/too-many-parts.md | 2 +- .../static-files-disk-uploader.md | 2 +- docs/troubleshooting/index.md | 2 +- docs/tutorial.md | 2 +- docs/use-cases/AI_ML/MCP/01_remote_mcp.md | 2 +- docs/use-cases/AI_ML/MCP/02_claude-desktop.md | 2 +- docs/use-cases/AI_ML/MCP/03_librechat.md | 2 +- docs/use-cases/AI_ML/MCP/04_anythingllm.md | 2 +- docs/use-cases/AI_ML/MCP/05_open-webui.md | 2 +- docs/use-cases/AI_ML/MCP/06_ollama.md | 2 +- docs/use-cases/AI_ML/MCP/07_janai.md | 2 +- .../AI_ML/MCP/ai_agent_libraries/agno.md | 2 +- .../AI_ML/MCP/ai_agent_libraries/chainlit.md | 2 +- .../MCP/ai_agent_libraries/copilotkit.md | 2 +- .../AI_ML/MCP/ai_agent_libraries/dspy.md | 2 +- .../AI_ML/MCP/ai_agent_libraries/index.md | 2 +- .../AI_ML/MCP/ai_agent_libraries/langchain.md | 2 +- .../MCP/ai_agent_libraries/llamaindex.md | 2 +- .../MCP/ai_agent_libraries/openai-agents.md | 2 +- .../MCP/ai_agent_libraries/pydantic-ai.md | 2 +- .../AI_ML/MCP/ai_agent_libraries/slackbot.md | 2 +- .../AI_ML/MCP/ai_agent_libraries/streamlit.md | 2 +- docs/use-cases/AI_ML/MCP/index.md | 2 +- .../AI_ML/ai-powered-sql-generation.md | 2 +- docs/use-cases/AI_ML/index.md | 2 +- docs/use-cases/data_lake/glue_catalog.md | 2 +- docs/use-cases/data_lake/index.md | 2 +- .../use-cases/data_lake/lakekeeper_catalog.md | 2 +- docs/use-cases/data_lake/nessie_catalog.md | 2 +- docs/use-cases/data_lake/rest_catalog.md | 2 +- docs/use-cases/data_lake/unity_catalog.md | 2 +- docs/use-cases/index.md | 2 +- .../build-your-own/demo-application.md | 2 +- .../observability/build-your-own/grafana.md | 2 +- .../observability/build-your-own/index.md | 2 +- .../integrating-opentelemetry.md | 2 +- .../build-your-own/introduction.md | 2 +- .../build-your-own/managing-data.md | 2 +- .../build-your-own/schema-design.md | 2 +- .../observability/clickstack/alerts.md | 2 +- .../observability/clickstack/dashboards.md | 2 +- .../clickstack/deployment/all-in-one.md | 2 +- .../clickstack/deployment/docker-compose.md | 2 +- .../clickstack/deployment/helm.md | 2 +- .../deployment/hyperdx-clickhouse-cloud.md | 2 +- .../clickstack/deployment/hyperdx-only.md | 2 +- .../clickstack/deployment/local-mode-only.md | 2 +- .../clickstack/example-datasets/index.md | 2 +- .../clickstack/example-datasets/kubernetes.md | 2 +- .../clickstack/example-datasets/local-data.md | 2 +- .../example-datasets/remote-demo-data.md | 2 +- .../example-datasets/sample-data.md | 2 +- .../clickstack/getting-started.md | 2 +- .../observability/clickstack/index.md | 2 +- .../clickstack/ingesting-data/collector.md | 2 +- .../clickstack/ingesting-data/index.md | 2 +- .../clickstack/ingesting-data/kubernetes.md | 2 +- .../ingesting-data/opentelemetry.md | 2 +- .../clickstack/ingesting-data/overview.md | 2 +- .../ingesting-data/sdks/aws-lambda.md | 2 +- .../clickstack/ingesting-data/sdks/browser.md | 2 +- .../clickstack/ingesting-data/sdks/deno.md | 2 +- .../clickstack/ingesting-data/sdks/elixir.md | 2 +- .../clickstack/ingesting-data/sdks/golang.md | 2 +- .../clickstack/ingesting-data/sdks/index.md | 2 +- .../clickstack/ingesting-data/sdks/java.md | 2 +- .../clickstack/ingesting-data/sdks/nestjs.md | 2 +- .../clickstack/ingesting-data/sdks/nextjs.md | 2 +- .../clickstack/ingesting-data/sdks/nodejs.md | 2 +- .../clickstack/ingesting-data/sdks/python.md | 2 +- .../ingesting-data/sdks/react-native.md | 2 +- .../clickstack/ingesting-data/sdks/ruby.md | 2 +- .../clickstack/migration/elastic/concepts.md | 2 +- .../clickstack/migration/elastic/index.md | 2 +- .../clickstack/migration/elastic/intro.md | 2 +- .../migration/elastic/migrating-agents.md | 2 +- .../migration/elastic/migrating-data.md | 2 +- .../migration/elastic/migrating-sdks.md | 2 +- .../clickstack/migration/elastic/search.md | 2 +- .../clickstack/migration/index.md | 2 +- .../observability/clickstack/overview.md | 2 +- .../observability/clickstack/production.md | 2 +- .../observability/clickstack/search.md | 2 +- .../use-cases/observability/clickstack/ttl.md | 2 +- docs/use-cases/observability/index.md | 2 +- .../use-cases/time-series/basic-operations.md | 2 +- docs/use-cases/time-series/index.md | 2 +- .../time-series/query-performance.md | 2 +- .../time-series/storage-efficiency.md | 2 +- docs/whats-new/changelog/2017.md | 2 +- docs/whats-new/changelog/2018.md | 2 +- docs/whats-new/changelog/2019.md | 2 +- docs/whats-new/changelog/2020.md | 2 +- docs/whats-new/changelog/2021.md | 2 +- docs/whats-new/changelog/2022.md | 2 +- docs/whats-new/changelog/2023.md | 2 +- docs/whats-new/changelog/2024.md | 2 +- docs/whats-new/changelog/cloud.md | 2 +- docs/whats-new/changelog/index.md | 318 +++++++++++++++++- docs/whats-new/roadmap.md | 2 +- docs/whats-new/security-changelog.md | 2 +- .../beta-and-experimental-features.md | 106 ------ scripts/categorizer.py | 113 +++++-- 520 files changed, 918 insertions(+), 716 deletions(-) delete mode 100644 docs/_snippets/_tabs.md diff --git a/docs/_placeholders/api/_services-api-reference.md b/docs/_placeholders/api/_services-api-reference.md index bd1b6208cf5..3968f0a276b 100644 --- a/docs/_placeholders/api/_services-api-reference.md +++ b/docs/_placeholders/api/_services-api-reference.md @@ -1,7 +1,7 @@ --- sidebar_label: Services title: Services -doc_type: 'reference' +doc_type: 'landing-page' --- ## List of organization services {#list-of-organization-services} diff --git a/docs/_placeholders/changelog/_index.md b/docs/_placeholders/changelog/_index.md index d35ed65fcdc..c5c638730ba 100644 --- a/docs/_placeholders/changelog/_index.md +++ b/docs/_placeholders/changelog/_index.md @@ -5,6 +5,6 @@ slug: /whats-new/changelog/ sidebar_position: 2 sidebar_label: '2025' title: '2025 Changelog' -doc_type: 'reference' +doc_type: 'changelog' --- diff --git a/docs/_snippets/_tabs.md b/docs/_snippets/_tabs.md deleted file mode 100644 index e9b87d3af41..00000000000 --- a/docs/_snippets/_tabs.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -sidebar_label: Tabs Sample -doc_type: 'how-to' ---- - -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; -import CodeBlock from '@theme/CodeBlock'; - -## Step 1. {#step-1} - - - - -Cloud - - - - -Self-managed - - - diff --git a/docs/about-us/about-faq-index.md b/docs/about-us/about-faq-index.md index 48bbaf29c13..8f42b97f6a6 100644 --- a/docs/about-us/about-faq-index.md +++ b/docs/about-us/about-faq-index.md @@ -2,7 +2,7 @@ title: 'FAQ' slug: /about-us/faq description: 'Landing page' -doc_type: 'reference' +doc_type: 'landing-page' --- | FAQ | diff --git a/docs/about-us/distinctive-features.md b/docs/about-us/distinctive-features.md index 97cafa00501..c90b05bd416 100644 --- a/docs/about-us/distinctive-features.md +++ b/docs/about-us/distinctive-features.md @@ -5,7 +5,7 @@ sidebar_position: 50 description: 'Understand what makes ClickHouse stand apart from other database management systems' title: 'Distinctive Features of ClickHouse' keywords: ['compression', 'secondary-indexes','column-oriented'] -doc_type: 'reference' +doc_type: 'guide' --- # Distinctive features of ClickHouse diff --git a/docs/about-us/history.md b/docs/about-us/history.md index b32f8db2bc6..5cf269d055b 100644 --- a/docs/about-us/history.md +++ b/docs/about-us/history.md @@ -5,7 +5,7 @@ sidebar_position: 40 description: 'History of ClickHouse development' keywords: ['history','development','Metrica'] title: 'ClickHouse History' -doc_type: 'explanation' +doc_type: 'reference' --- # ClickHouse history {#clickhouse-history} diff --git a/docs/about-us/index.md b/docs/about-us/index.md index 8ec4bf00b09..e4fe70bd794 100644 --- a/docs/about-us/index.md +++ b/docs/about-us/index.md @@ -2,7 +2,7 @@ slug: /about title: 'About ClickHouse' description: 'Landing page for About ClickHouse' -doc_type: 'reference' +doc_type: 'landing-page' --- # About ClickHouse diff --git a/docs/best-practices/avoid_mutations.md b/docs/best-practices/avoid_mutations.md index 47187e755ba..13b8008ba40 100644 --- a/docs/best-practices/avoid_mutations.md +++ b/docs/best-practices/avoid_mutations.md @@ -5,7 +5,7 @@ sidebar_label: 'Avoid mutations' title: 'Avoid mutations' description: 'Page describing why to avoid mutations in ClickHouse' keywords: ['mutations'] -doc_type: 'how-to' +doc_type: 'guide' --- import Content from '@site/docs/best-practices/_snippets/_avoid_mutations.md'; diff --git a/docs/best-practices/avoid_optimize_final.md b/docs/best-practices/avoid_optimize_final.md index f8fca2bcc82..f569b97f6a2 100644 --- a/docs/best-practices/avoid_optimize_final.md +++ b/docs/best-practices/avoid_optimize_final.md @@ -6,7 +6,7 @@ title: 'Avoid OPTIMIZE FINAL' description: 'Page describing why you should avoid the OPTIMIZE FINAL clause in ClickHouse' keywords: ['avoid OPTIMIZE FINAL', 'background merges'] hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- # Avoid `OPTIMIZE FINAL` diff --git a/docs/best-practices/choosing_a_primary_key.md b/docs/best-practices/choosing_a_primary_key.md index 02afb1f563c..1f829d03f76 100644 --- a/docs/best-practices/choosing_a_primary_key.md +++ b/docs/best-practices/choosing_a_primary_key.md @@ -6,7 +6,7 @@ title: 'Choosing a Primary Key' description: 'Page describing how to choose a primary key in ClickHouse' keywords: ['primary key'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/index.md b/docs/best-practices/index.md index dff0b680ca9..e511a4cc6a3 100644 --- a/docs/best-practices/index.md +++ b/docs/best-practices/index.md @@ -4,7 +4,7 @@ keywords: ['Cloud', 'Primary key', 'Ordering key', 'Materialized Views', 'Best P title: 'Overview' hide_title: true description: 'Landing page for Best Practices section in ClickHouse' -doc_type: 'reference' +doc_type: 'landing-page' --- # Best Practices in ClickHouse {#best-practices-in-clickhouse} diff --git a/docs/best-practices/minimize_optimize_joins.md b/docs/best-practices/minimize_optimize_joins.md index 1e74e302689..dca4f036dde 100644 --- a/docs/best-practices/minimize_optimize_joins.md +++ b/docs/best-practices/minimize_optimize_joins.md @@ -6,7 +6,7 @@ title: 'Minimize and optimize JOINs' description: 'Page describing best practices for JOINs' keywords: ['JOIN', 'Parallel Hash JOIN'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/selecting_an_insert_strategy.md b/docs/best-practices/selecting_an_insert_strategy.md index 22d633e18b4..9bc94865411 100644 --- a/docs/best-practices/selecting_an_insert_strategy.md +++ b/docs/best-practices/selecting_an_insert_strategy.md @@ -6,7 +6,7 @@ title: 'Selecting an insert strategy' description: 'Page describing how to choose an insert strategy in ClickHouse' keywords: ['INSERT', 'asynchronous inserts', 'compression', 'batch inserts'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/sizing-and-hardware-recommendations.md b/docs/best-practices/sizing-and-hardware-recommendations.md index 99f70abcaaa..0aabfd4ed55 100644 --- a/docs/best-practices/sizing-and-hardware-recommendations.md +++ b/docs/best-practices/sizing-and-hardware-recommendations.md @@ -4,7 +4,7 @@ sidebar_label: 'Sizing and hardware recommendations' sidebar_position: 4 title: 'Sizing and hardware recommendations' description: 'This guide discusses our general recommendations regarding hardware, compute, memory, and disk configurations for open-source users.' -doc_type: 'reference' +doc_type: 'guide' --- # Sizing and hardware recommendations diff --git a/docs/best-practices/use_materialized_views.md b/docs/best-practices/use_materialized_views.md index ddb4562b532..a7497f00b1c 100644 --- a/docs/best-practices/use_materialized_views.md +++ b/docs/best-practices/use_materialized_views.md @@ -6,7 +6,7 @@ title: 'Use Materialized Views' description: 'Page describing Materialized Views' keywords: ['materialized views', 'medallion architecture'] show_related_blogs: true -doc_type: 'explanation' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/best-practices/using_data_skipping_indices.md b/docs/best-practices/using_data_skipping_indices.md index 94a7d07a3df..c962ff827d4 100644 --- a/docs/best-practices/using_data_skipping_indices.md +++ b/docs/best-practices/using_data_skipping_indices.md @@ -6,7 +6,7 @@ title: 'Use data skipping indices where appropriate' description: 'Page describing how and when to use data skipping indices' keywords: ['data skipping index', 'skip index'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/chdb/getting-started.md b/docs/chdb/getting-started.md index 4a2269acadb..93d0f05afdd 100644 --- a/docs/chdb/getting-started.md +++ b/docs/chdb/getting-started.md @@ -4,7 +4,7 @@ sidebar_label: 'Getting started' slug: /chdb/getting-started description: 'chDB is an in-process SQL OLAP Engine powered by ClickHouse' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'in-process', 'in process'] -doc_type: 'tutorial' +doc_type: 'guide' --- # Getting started with chDB diff --git a/docs/chdb/guides/clickhouse-local.md b/docs/chdb/guides/clickhouse-local.md index f861492c945..fd7348f6dfe 100644 --- a/docs/chdb/guides/clickhouse-local.md +++ b/docs/chdb/guides/clickhouse-local.md @@ -4,7 +4,7 @@ sidebar_label: 'Using clickhouse-local database' slug: /chdb/guides/clickhouse-local description: 'Learn how to use a clickhouse-local database with chDB' keywords: ['chdb', 'clickhouse-local'] -doc_type: 'tutorial' +doc_type: 'guide' --- [clickhouse-local](/operations/utilities/clickhouse-local) is a CLI with an embedded version of ClickHouse. diff --git a/docs/chdb/guides/index.md b/docs/chdb/guides/index.md index 970ab185af7..ba5a8abf33d 100644 --- a/docs/chdb/guides/index.md +++ b/docs/chdb/guides/index.md @@ -3,7 +3,7 @@ title: 'chDB Guides' slug: /chdb/guides description: 'Index page for chDB guides' keywords: ['chdb', 'guides'] -doc_type: 'reference' +doc_type: 'landing-page' --- Take a look at our chDB developer guides below: diff --git a/docs/chdb/guides/jupysql.md b/docs/chdb/guides/jupysql.md index ce8150c0f1b..fd91b223d5e 100644 --- a/docs/chdb/guides/jupysql.md +++ b/docs/chdb/guides/jupysql.md @@ -4,7 +4,7 @@ sidebar_label: 'JupySQL' slug: /chdb/guides/jupysql description: 'How to install chDB for Bun' keywords: ['chdb', 'JupySQL'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/chdb/guides/query-remote-clickhouse.md b/docs/chdb/guides/query-remote-clickhouse.md index ee316b00234..ca5706e46dc 100644 --- a/docs/chdb/guides/query-remote-clickhouse.md +++ b/docs/chdb/guides/query-remote-clickhouse.md @@ -4,7 +4,7 @@ sidebar_label: 'Querying remote ClickHouse' slug: /chdb/guides/query-remote-clickhouse description: 'In this guide, we will learn how to query a remote ClickHouse server from chDB.' keywords: ['chdb', 'clickhouse'] -doc_type: 'how-to' +doc_type: 'guide' --- In this guide, we're going to learn how to query a remote ClickHouse server from chDB. diff --git a/docs/chdb/guides/querying-apache-arrow.md b/docs/chdb/guides/querying-apache-arrow.md index 53392db65cb..418f2bc3fc4 100644 --- a/docs/chdb/guides/querying-apache-arrow.md +++ b/docs/chdb/guides/querying-apache-arrow.md @@ -4,7 +4,7 @@ sidebar_label: 'Querying Apache Arrow' slug: /chdb/guides/apache-arrow description: 'In this guide, we will learn how to query Apache Arrow tables with chDB' keywords: ['chdb', 'Apache Arrow'] -doc_type: 'how-to' +doc_type: 'guide' --- [Apache Arrow](https://arrow.apache.org/) is a standardized column-oriented memory format that's gained popularity in the data community. diff --git a/docs/chdb/guides/querying-pandas.md b/docs/chdb/guides/querying-pandas.md index d826ec5b2ef..28ec1619571 100644 --- a/docs/chdb/guides/querying-pandas.md +++ b/docs/chdb/guides/querying-pandas.md @@ -5,7 +5,7 @@ slug: /chdb/guides/pandas description: 'Learn how to query Pandas DataFrames with chDB' keywords: ['chDB', 'Pandas'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- [Pandas](https://pandas.pydata.org/) is a popular library for data manipulation and analysis in Python. diff --git a/docs/chdb/guides/querying-parquet.md b/docs/chdb/guides/querying-parquet.md index 8fda11220bc..d4332a6f8cc 100644 --- a/docs/chdb/guides/querying-parquet.md +++ b/docs/chdb/guides/querying-parquet.md @@ -4,7 +4,7 @@ sidebar_label: 'Querying Parquet files' slug: /chdb/guides/querying-parquet description: 'Learn how to query Parquet files with chDB.' keywords: ['chdb', 'parquet'] -doc_type: 'how-to' +doc_type: 'guide' --- A lot of the world's data lives in Amazon S3 buckets. diff --git a/docs/chdb/guides/querying-s3-bucket.md b/docs/chdb/guides/querying-s3-bucket.md index f2658da1fae..23bfff26465 100644 --- a/docs/chdb/guides/querying-s3-bucket.md +++ b/docs/chdb/guides/querying-s3-bucket.md @@ -4,7 +4,7 @@ sidebar_label: 'Querying data in S3' slug: /chdb/guides/querying-s3 description: 'Learn how to query data in an S3 bucket with chDB.' keywords: ['chdb', 's3'] -doc_type: 'how-to' +doc_type: 'guide' --- A lot of the world's data lives in Amazon S3 buckets. diff --git a/docs/chdb/index.md b/docs/chdb/index.md index 3740570884b..1070a27e216 100644 --- a/docs/chdb/index.md +++ b/docs/chdb/index.md @@ -4,7 +4,7 @@ sidebar_label: 'Overview' slug: /chdb description: 'chDB is an in-process SQL OLAP Engine powered by ClickHouse' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'in-process', 'in process'] -doc_type: 'reference' +doc_type: 'guide' --- # chDB diff --git a/docs/chdb/install/bun.md b/docs/chdb/install/bun.md index 321f20abbfe..3213eff9101 100644 --- a/docs/chdb/install/bun.md +++ b/docs/chdb/install/bun.md @@ -4,7 +4,7 @@ sidebar_label: 'Bun' slug: /chdb/install/bun description: 'How to install chDB for Bun' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'bun', 'install'] -doc_type: 'how-to' +doc_type: 'guide' --- # Installing chDB for Bun diff --git a/docs/chdb/install/c.md b/docs/chdb/install/c.md index 00d2257a3f2..b4e6edde748 100644 --- a/docs/chdb/install/c.md +++ b/docs/chdb/install/c.md @@ -4,7 +4,7 @@ sidebar_label: 'C and C++' slug: /chdb/install/c description: 'How to install chDB for C and C++' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'install'] -doc_type: 'how-to' +doc_type: 'guide' --- diff --git a/docs/chdb/install/go.md b/docs/chdb/install/go.md index d81ca910683..358e829752d 100644 --- a/docs/chdb/install/go.md +++ b/docs/chdb/install/go.md @@ -4,7 +4,7 @@ sidebar_label: 'Go' slug: /chdb/install/go description: 'How to install chDB for Go' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'go', 'install'] -doc_type: 'how-to' +doc_type: 'guide' --- # Installing chDB for Go diff --git a/docs/chdb/install/index.md b/docs/chdb/install/index.md index 287e2e44e7a..3079ae49321 100644 --- a/docs/chdb/install/index.md +++ b/docs/chdb/install/index.md @@ -3,7 +3,7 @@ title: 'Language Integrations Index' slug: /chdb/install description: 'Index page for chDB language integrations' keywords: ['python', 'NodeJS', 'Go', 'Rust', 'Bun', 'C', 'C++'] -doc_type: 'reference' +doc_type: 'landing-page' --- Instructions for how to get setup with chDB are available below for the following languages and runtimes: diff --git a/docs/chdb/install/nodejs.md b/docs/chdb/install/nodejs.md index ff0a0aa960a..06cb82c181d 100644 --- a/docs/chdb/install/nodejs.md +++ b/docs/chdb/install/nodejs.md @@ -4,7 +4,7 @@ sidebar_label: 'NodeJS' slug: /chdb/install/nodejs description: 'How to install chDB for NodeJS' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'NodeJS', 'install'] -doc_type: 'how-to' +doc_type: 'guide' --- # Installing chDB for NodeJS diff --git a/docs/chdb/install/python.md b/docs/chdb/install/python.md index f9e0851deb1..00a2d57b8d9 100644 --- a/docs/chdb/install/python.md +++ b/docs/chdb/install/python.md @@ -4,7 +4,7 @@ sidebar_label: 'Python' slug: /chdb/install/python description: 'How to install chDB for Python' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'python', 'install'] -doc_type: 'how-to' +doc_type: 'guide' --- # Installing chDB for Python diff --git a/docs/chdb/install/rust.md b/docs/chdb/install/rust.md index 6449fb69b85..5c726ec9d95 100644 --- a/docs/chdb/install/rust.md +++ b/docs/chdb/install/rust.md @@ -4,7 +4,7 @@ sidebar_label: 'Rust' slug: /chdb/install/rust description: 'How to install chDB for Rust' keywords: ['chdb', 'embedded', 'clickhouse-lite', 'bun', 'install'] -doc_type: 'how-to' +doc_type: 'guide' --- ## Requirements {#requirements} diff --git a/docs/cloud-index.md b/docs/cloud-index.md index 05d401a8310..f277bba83e2 100644 --- a/docs/cloud-index.md +++ b/docs/cloud-index.md @@ -4,7 +4,7 @@ keywords: ['AWS', 'Cloud', 'serverless'] title: 'Overview' hide_title: true description: 'Overview page for Cloud' -doc_type: 'reference' +doc_type: 'landing-page' --- import Content from '@site/docs/about-us/cloud.md'; diff --git a/docs/cloud/bestpractices/index.md b/docs/cloud/bestpractices/index.md index b0549d8b19a..d2cc76ded74 100644 --- a/docs/cloud/bestpractices/index.md +++ b/docs/cloud/bestpractices/index.md @@ -4,7 +4,7 @@ keywords: ['Cloud', 'Best Practices', 'Bulk Inserts', 'Asynchronous Inserts', 'A title: 'Overview' hide_title: true description: 'Landing page for Best Practices section in ClickHouse Cloud' -doc_type: 'reference' +doc_type: 'landing-page' --- # Best Practices in ClickHouse Cloud {#best-practices-in-clickhouse-cloud} diff --git a/docs/cloud/bestpractices/multitenancy.md b/docs/cloud/bestpractices/multitenancy.md index 928fdc555d8..e0f7cc993c1 100644 --- a/docs/cloud/bestpractices/multitenancy.md +++ b/docs/cloud/bestpractices/multitenancy.md @@ -3,7 +3,7 @@ slug: /cloud/bestpractices/multi-tenancy sidebar_label: 'Implement multi tenancy' title: 'Multi tenancy' description: 'Best practices to implement multi tenancy' -doc_type: 'reference' +doc_type: 'guide' --- On a SaaS data analytics platform, it is common for multiple tenants, such as organizations, customers, or business units, to share the same database infrastructure while maintaining logical separation of their data. This allows different users to securely access their own data within the same platform. diff --git a/docs/cloud/changelogs/24_02.md b/docs/cloud/changelogs/24_02.md index 4eac8f291c2..0600119bc76 100644 --- a/docs/cloud/changelogs/24_02.md +++ b/docs/cloud/changelogs/24_02.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v24.2' keywords: ['changelog'] sidebar_label: '24.2' sidebar_position: 8 -doc_type: 'how-to' +doc_type: 'changelog' --- ### ClickHouse release tag: 24.2.2.15987 {#clickhouse-release-tag-242215987} diff --git a/docs/cloud/changelogs/24_05.md b/docs/cloud/changelogs/24_05.md index 6ef47f610a9..ad97ed2b6ac 100644 --- a/docs/cloud/changelogs/24_05.md +++ b/docs/cloud/changelogs/24_05.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v24.5' keywords: ['changelog', 'cloud'] sidebar_label: '24.5' sidebar_position: 7 -doc_type: 'reference' +doc_type: 'changelog' --- # V24.5 changelog for Cloud diff --git a/docs/cloud/changelogs/24_06.md b/docs/cloud/changelogs/24_06.md index 8789859c210..1436edd5227 100644 --- a/docs/cloud/changelogs/24_06.md +++ b/docs/cloud/changelogs/24_06.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v24.6' keywords: ['changelog', 'cloud'] sidebar_label: '24.6' sidebar_position: 6 -doc_type: 'explanation' +doc_type: 'changelog' --- # V24.6 changelog for Cloud diff --git a/docs/cloud/changelogs/24_08.md b/docs/cloud/changelogs/24_08.md index 6bf6d551b4c..5567fdccb05 100644 --- a/docs/cloud/changelogs/24_08.md +++ b/docs/cloud/changelogs/24_08.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v24.8' keywords: ['changelog', 'cloud'] sidebar_label: '24.8' sidebar_position: 5 -doc_type: 'reference' +doc_type: 'changelog' --- Relevant changes for ClickHouse Cloud services based on the v24.8 release. diff --git a/docs/cloud/changelogs/24_10.md b/docs/cloud/changelogs/24_10.md index 80c4df2c1d7..097e6fa5f91 100644 --- a/docs/cloud/changelogs/24_10.md +++ b/docs/cloud/changelogs/24_10.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v24.10' keywords: ['changelog', 'cloud'] sidebar_label: '24.10' sidebar_position: 4 -doc_type: 'reference' +doc_type: 'changelog' --- Relevant changes for ClickHouse Cloud services based on the v24.10 release. diff --git a/docs/cloud/changelogs/24_12.md b/docs/cloud/changelogs/24_12.md index 913905933b6..239257061ea 100644 --- a/docs/cloud/changelogs/24_12.md +++ b/docs/cloud/changelogs/24_12.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v24.12' keywords: ['changelog', 'cloud'] sidebar_label: '24.12' sidebar_position: 3 -doc_type: 'reference' +doc_type: 'changelog' --- Relevant changes for ClickHouse Cloud services based on the v24.12 release. diff --git a/docs/cloud/changelogs/25_04.md b/docs/cloud/changelogs/25_04.md index 33bb1fa3c1a..248509a5425 100644 --- a/docs/cloud/changelogs/25_04.md +++ b/docs/cloud/changelogs/25_04.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v25.4' keywords: ['changelog', 'cloud'] sidebar_label: '25.4' sidebar_position: 2 -doc_type: 'reference' +doc_type: 'changelog' --- ## Backward incompatible changes {#backward-incompatible-changes} diff --git a/docs/cloud/changelogs/25_06.md b/docs/cloud/changelogs/25_06.md index e2a12939f79..5f8735fc4a2 100644 --- a/docs/cloud/changelogs/25_06.md +++ b/docs/cloud/changelogs/25_06.md @@ -5,7 +5,7 @@ description: 'Fast release changelog for v25.6' keywords: ['changelog', 'cloud'] sidebar_label: '25.6' sidebar_position: 1 -doc_type: 'reference' +doc_type: 'changelog' --- ## Backward incompatible change {#backward-incompatible-change} diff --git a/docs/cloud/get-started/index.md b/docs/cloud/get-started/index.md index d7ad64c5190..2a2206825ec 100644 --- a/docs/cloud/get-started/index.md +++ b/docs/cloud/get-started/index.md @@ -3,7 +3,7 @@ slug: /cloud/get-started title: 'Get Started' description: 'Get Started Table Of Contents' keywords: ['Cloud Quick Start', 'SQL Console', 'Query Insights', 'Query API Endpoints', 'Dashboards', 'Cloud Support'] -doc_type: 'reference' +doc_type: 'landing-page' --- Welcome to ClickHouse Cloud! Explore the pages below to learn more about what ClickHouse Cloud has to offer. diff --git a/docs/cloud/get-started/query-endpoints.md b/docs/cloud/get-started/query-endpoints.md index dd29068992e..80dff31fb3e 100644 --- a/docs/cloud/get-started/query-endpoints.md +++ b/docs/cloud/get-started/query-endpoints.md @@ -4,7 +4,7 @@ slug: /cloud/get-started/query-endpoints description: 'Easily spin up REST API endpoints from your saved queries' keywords: ['api', 'query api endpoints', 'query endpoints', 'query rest api'] title: 'Query API Endpoints' -doc_type: 'reference' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/get-started/query-insights.md b/docs/cloud/get-started/query-insights.md index 6438ec33229..b70126f0804 100644 --- a/docs/cloud/get-started/query-insights.md +++ b/docs/cloud/get-started/query-insights.md @@ -4,7 +4,7 @@ slug: /cloud/get-started/query-insights description: 'Visualize system.query_log data to simplify query debugging and performance optimization' keywords: ['query insights', 'query log', 'query log ui', 'system.query_log insights'] title: 'Query Insights' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/get-started/sql-console.md b/docs/cloud/get-started/sql-console.md index 6ef06debff1..f0c0d4b2e8e 100644 --- a/docs/cloud/get-started/sql-console.md +++ b/docs/cloud/get-started/sql-console.md @@ -4,7 +4,7 @@ slug: /cloud/get-started/sql-console description: 'Run queries and create visualizations using the SQL Console.' keywords: ['sql console', 'sql client', 'cloud console', 'console'] title: 'SQL Console' -doc_type: 'reference' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/account-close.md b/docs/cloud/manage/account-close.md index 1e376551e5e..ed849c39f1e 100644 --- a/docs/cloud/manage/account-close.md +++ b/docs/cloud/manage/account-close.md @@ -3,7 +3,7 @@ sidebar_label: 'Delete Account' slug: /cloud/manage/close_account title: 'Account Close & Deletion' description: 'We know there are circumstances that sometimes necessitate account closure. This guide will help you through the process.' -doc_type: 'how-to' +doc_type: 'guide' --- ## Account closure and deletion {#account-close--deletion} diff --git a/docs/cloud/manage/api/index.md b/docs/cloud/manage/api/index.md index f914d20f409..aca38eca54a 100644 --- a/docs/cloud/manage/api/index.md +++ b/docs/cloud/manage/api/index.md @@ -2,7 +2,7 @@ title: 'Cloud API' slug: /cloud/manage/cloud-api description: 'Landing page for the Cloud API section' -doc_type: 'reference' +doc_type: 'landing-page' --- This section contains reference documentation for Cloud API and contains the following pages: diff --git a/docs/cloud/manage/backups/configurable-backups.md b/docs/cloud/manage/backups/configurable-backups.md index 59f71d53697..19b7443d746 100644 --- a/docs/cloud/manage/backups/configurable-backups.md +++ b/docs/cloud/manage/backups/configurable-backups.md @@ -4,7 +4,7 @@ slug: /cloud/manage/backups/configurable-backups description: 'Configurable Backups' title: 'Configurable Backups' keywords: ['backups', 'cloud backups', 'restore'] -doc_type: 'how-to' +doc_type: 'guide' --- import backup_settings from '@site/static/images/cloud/manage/backup-settings.png'; diff --git a/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md b/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md index 663ea1fb39d..665ca9e7727 100644 --- a/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md +++ b/docs/cloud/manage/backups/export-backups-to-own-cloud-account.md @@ -3,7 +3,7 @@ sidebar_label: 'Export Backups to your Own Cloud Account' slug: /cloud/manage/backups/export-backups-to-own-cloud-account title: 'Export Backups to your Own Cloud Account' description: 'Describes how to export backups to your own Cloud account' -doc_type: 'how-to' +doc_type: 'guide' --- import EnterprisePlanFeatureBadge from '@theme/badges/EnterprisePlanFeatureBadge' diff --git a/docs/cloud/manage/backups/index.md b/docs/cloud/manage/backups/index.md index 6d1b18ec90e..a22582d4ea0 100644 --- a/docs/cloud/manage/backups/index.md +++ b/docs/cloud/manage/backups/index.md @@ -3,7 +3,7 @@ slug: /cloud/manage/backups title: 'Backups' description: 'Table of contents page for backups.' keywords: ['backups', 'configurable backups', 'export backups to own cloud'] -doc_type: 'reference' +doc_type: 'landing-page' --- | Page | Description | diff --git a/docs/cloud/manage/backups/overview.md b/docs/cloud/manage/backups/overview.md index f5516337ddf..6495f1fdcf2 100644 --- a/docs/cloud/manage/backups/overview.md +++ b/docs/cloud/manage/backups/overview.md @@ -5,7 +5,7 @@ slug: /cloud/manage/backups/overview title: 'Overview' keywords: ['backups', 'cloud backups', 'restore'] description: 'Provides an overview of backups in ClickHouse Cloud' -doc_type: 'tutorial' +doc_type: 'guide' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/cloud/manage/billing/index.md b/docs/cloud/manage/billing/index.md index 25de978ae05..08833502551 100644 --- a/docs/cloud/manage/billing/index.md +++ b/docs/cloud/manage/billing/index.md @@ -3,7 +3,7 @@ slug: /cloud/manage/billing title: 'Billing' description: 'Table of contents page for billing.' keywords: ['billing', 'payment thresholds', 'trouble shooting', 'marketplace'] -doc_type: 'reference' +doc_type: 'landing-page' --- This section of the documentation covers topics related to billing, and contains the following pages: diff --git a/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md b/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md index 6f4d2777736..95cdfbeaba6 100644 --- a/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md +++ b/docs/cloud/manage/billing/marketplace/aws-marketplace-committed.md @@ -3,7 +3,7 @@ slug: /cloud/billing/marketplace/aws-marketplace-committed-contract title: 'AWS Marketplace Committed Contract' description: 'Subscribe to ClickHouse Cloud through the AWS Marketplace (Committed Contract)' keywords: ['aws', 'amazon', 'marketplace', 'billing', 'committed', 'committed contract'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md b/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md index 42e16ca3e2b..695bc6c4d50 100644 --- a/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md +++ b/docs/cloud/manage/billing/marketplace/aws-marketplace-payg.md @@ -3,7 +3,7 @@ slug: /cloud/billing/marketplace/aws-marketplace-payg title: 'AWS Marketplace PAYG' description: 'Subscribe to ClickHouse Cloud through the AWS Marketplace (PAYG).' keywords: ['aws', 'marketplace', 'billing', 'PAYG'] -doc_type: 'how-to' +doc_type: 'guide' --- import aws_marketplace_payg_1 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-1.png'; diff --git a/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md b/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md index 87e49904ea8..c2ab127b3e6 100644 --- a/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md +++ b/docs/cloud/manage/billing/marketplace/azure-marketplace-committed.md @@ -3,7 +3,7 @@ slug: /cloud/billing/marketplace/azure-marketplace-committed-contract title: 'Azure Marketplace Committed Contract' description: 'Subscribe to ClickHouse Cloud through the Azure Marketplace (Committed Contract)' keywords: ['Microsoft', 'Azure', 'marketplace', 'billing', 'committed', 'committed contract'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md b/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md index f339c6acd63..ecf4ae12a09 100644 --- a/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md +++ b/docs/cloud/manage/billing/marketplace/azure-marketplace-payg.md @@ -3,7 +3,7 @@ slug: /cloud/billing/marketplace/azure-marketplace-payg title: 'Azure Marketplace PAYG' description: 'Subscribe to ClickHouse Cloud through the Azure Marketplace (PAYG).' keywords: ['azure', 'marketplace', 'billing', 'PAYG'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md b/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md index dda137e0ba3..ced70c443fe 100644 --- a/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md +++ b/docs/cloud/manage/billing/marketplace/gcp-marketplace-committed.md @@ -3,7 +3,7 @@ slug: /cloud/billing/marketplace/gcp-marketplace-committed-contract title: 'GCP Marketplace Committed Contract' description: 'Subscribe to ClickHouse Cloud through the GCP Marketplace (Committed Contract)' keywords: ['gcp', 'google', 'marketplace', 'billing', 'committed', 'committed contract'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md b/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md index c0d095d0b4a..b40dbc74701 100644 --- a/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md +++ b/docs/cloud/manage/billing/marketplace/gcp-marketplace-payg.md @@ -3,7 +3,7 @@ slug: /cloud/billing/marketplace/gcp-marketplace-payg title: 'GCP Marketplace PAYG' description: 'Subscribe to ClickHouse Cloud through the GCP Marketplace (PAYG).' keywords: ['gcp', 'marketplace', 'billing', 'PAYG'] -doc_type: 'how-to' +doc_type: 'guide' --- import gcp_marketplace_payg_1 from '@site/static/images/cloud/manage/billing/marketplace/gcp-marketplace-payg-1.png'; diff --git a/docs/cloud/manage/billing/marketplace/index.md b/docs/cloud/manage/billing/marketplace/index.md index 37f3c996158..4d5dc5d88c0 100644 --- a/docs/cloud/manage/billing/marketplace/index.md +++ b/docs/cloud/manage/billing/marketplace/index.md @@ -3,7 +3,7 @@ slug: /cloud/manage/marketplace/ title: 'Market Place' description: 'Market Place Table of Contents page' keywords: ['Marketplace Billing', 'AWS', 'GCP'] -doc_type: 'reference' +doc_type: 'landing-page' --- This section details billing related topics for Marketplace. diff --git a/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md b/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md index edf7238ca7b..9e5429ce318 100644 --- a/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md +++ b/docs/cloud/manage/billing/marketplace/migrate-marketplace-payg-committed.md @@ -3,7 +3,7 @@ slug: /cloud/billing/marketplace/migrate title: 'Migrate billing from pay-as-you-go (PAYG) to a committed spend contract in a cloud marketplace' description: 'Migrate from pay-as-you-go to committed spend contract.' keywords: ['marketplace', 'billing', 'PAYG', 'pay-as-you-go', 'committed spend contract'] -doc_type: 'how-to' +doc_type: 'guide' --- # Migrate billing from pay-as-you-go (PAYG) to a committed spend contract in a cloud marketplace {#migrate-payg-to-committed} diff --git a/docs/cloud/manage/billing/marketplace/overview.md b/docs/cloud/manage/billing/marketplace/overview.md index 7e400a46386..578c6f7e428 100644 --- a/docs/cloud/manage/billing/marketplace/overview.md +++ b/docs/cloud/manage/billing/marketplace/overview.md @@ -3,7 +3,7 @@ slug: /cloud/marketplace/marketplace-billing title: 'Marketplace Billing' description: 'Subscribe to ClickHouse Cloud through the AWS, GCP, and Azure marketplace.' keywords: ['aws', 'azure', 'gcp', 'google cloud', 'marketplace', 'billing'] -doc_type: 'reference' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/billing/payment-thresholds.md b/docs/cloud/manage/billing/payment-thresholds.md index 56105baab98..717afe535ea 100644 --- a/docs/cloud/manage/billing/payment-thresholds.md +++ b/docs/cloud/manage/billing/payment-thresholds.md @@ -4,7 +4,7 @@ slug: /cloud/billing/payment-thresholds title: 'Payment Thresholds' description: 'Payment thresholds and automatic invoicing for ClickHouse Cloud.' keywords: ['billing', 'payment thresholds', 'automatic invoicing', 'invoice'] -doc_type: 'how-to' +doc_type: 'guide' --- # Payment thresholds diff --git a/docs/cloud/manage/dashboards.md b/docs/cloud/manage/dashboards.md index b352e6b05fd..c01a59c2d1b 100644 --- a/docs/cloud/manage/dashboards.md +++ b/docs/cloud/manage/dashboards.md @@ -3,7 +3,7 @@ sidebar_label: 'Dashboards' slug: /cloud/manage/dashboards title: 'Dashboards' description: 'The SQL Console''s dashboards feature allows you to collect and share visualizations from saved queries.' -doc_type: 'how-to' +doc_type: 'guide' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/cloud/manage/hyperdx.md b/docs/cloud/manage/hyperdx.md index 3f060e4034d..cbd5023c110 100644 --- a/docs/cloud/manage/hyperdx.md +++ b/docs/cloud/manage/hyperdx.md @@ -3,7 +3,7 @@ sidebar_label: 'HyperDX' slug: /cloud/manage/hyperdx title: 'HyperDX' description: 'Provides HyperDX, the UI for ClickStack - a production-grade observability platform built on ClickHouse and OpenTelemetry (OTel), unifying logs, traces, metrics, and sessions in a single high-performance scalable solution.' -doc_type: 'reference' +doc_type: 'guide' --- import PrivatePreviewBadge from '@theme/badges/PrivatePreviewBadge'; diff --git a/docs/cloud/manage/index.md b/docs/cloud/manage/index.md index 5544796b1a0..3b36200e3e3 100644 --- a/docs/cloud/manage/index.md +++ b/docs/cloud/manage/index.md @@ -4,7 +4,7 @@ keywords: ['AWS', 'Cloud', 'serverless', 'management'] title: 'Overview' hide_title: true description: 'Overview page for Managing Cloud' -doc_type: 'reference' +doc_type: 'landing-page' --- # Managing Cloud diff --git a/docs/cloud/manage/jan2025_faq/backup.md b/docs/cloud/manage/jan2025_faq/backup.md index b0d4e7a233e..9a82f98c602 100644 --- a/docs/cloud/manage/jan2025_faq/backup.md +++ b/docs/cloud/manage/jan2025_faq/backup.md @@ -3,7 +3,7 @@ title: 'Backup Policy' slug: /cloud/manage/jan-2025-faq/backup keywords: ['new tiers', 'plans', 'pricing', 'backups'] description: 'Backup policy in new tiers' -doc_type: 'how-to' +doc_type: 'guide' --- ## What is the backup policy? {#what-is-the-backup-policy} diff --git a/docs/cloud/manage/jan2025_faq/billing.md b/docs/cloud/manage/jan2025_faq/billing.md index 97e699f1bfd..97df6cd3a05 100644 --- a/docs/cloud/manage/jan2025_faq/billing.md +++ b/docs/cloud/manage/jan2025_faq/billing.md @@ -3,7 +3,7 @@ title: 'Billing' slug: /cloud/manage/jan-2025-faq/billing keywords: ['new pricing', 'billing'] description: 'Billing details for new pricing tiers' -doc_type: 'explanation' +doc_type: 'reference' --- ## Billing {#billing} diff --git a/docs/cloud/manage/jan2025_faq/dimensions.md b/docs/cloud/manage/jan2025_faq/dimensions.md index b9e9a722ab1..2d3d5179dd0 100644 --- a/docs/cloud/manage/jan2025_faq/dimensions.md +++ b/docs/cloud/manage/jan2025_faq/dimensions.md @@ -3,7 +3,7 @@ title: 'New Pricing Dimensions' slug: /cloud/manage/jan-2025-faq/pricing-dimensions keywords: ['new pricing', 'dimensions'] description: 'Pricing dimensions for data transfer and ClickPipes' -doc_type: 'explanation' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/jan2025_faq/index.md b/docs/cloud/manage/jan2025_faq/index.md index b9cbcfc21a1..d0fffd95d79 100644 --- a/docs/cloud/manage/jan2025_faq/index.md +++ b/docs/cloud/manage/jan2025_faq/index.md @@ -3,7 +3,7 @@ title: 'Jan 2025 Changes FAQ' slug: /cloud/manage/jan-2025-faq description: 'Index page for new pricing FAQ' keywords: ['new pricing', 'faq'] -doc_type: 'reference' +doc_type: 'landing-page' --- -| Page | Description | -|-----|-----| -| | | -| [Backup Policy](/cloud/manage/jan-2025-faq/backup) | Backup policy in new tiers | -| [Billing](/cloud/manage/jan-2025-faq/billing) | Billing details for new pricing tiers | -| [Description of New Tiers](/cloud/manage/jan-2025-faq/new-tiers) | Description of new tiers and features | -| [Migrating to New Plans](/cloud/manage/jan-2025-faq/plan-migrations) | Migrating to new plans, tiers, pricing, how to decide and estimate costs | -| [New Pricing Dimensions](/cloud/manage/jan-2025-faq/pricing-dimensions) | Pricing dimensions for data transfer and ClickPipes | -| [Scaling](/cloud/manage/jan-2025-faq/scaling) | Scaling behavior in new pricing tiers | -| [Summary](/cloud/manage/jan-2025-faq/summary) | Summary of New ClickHouse Cloud Tiers | diff --git a/docs/cloud/manage/jan2025_faq/new_tiers.md b/docs/cloud/manage/jan2025_faq/new_tiers.md index ec0ec76b2c9..bed1da97d28 100644 --- a/docs/cloud/manage/jan2025_faq/new_tiers.md +++ b/docs/cloud/manage/jan2025_faq/new_tiers.md @@ -3,7 +3,7 @@ title: 'Description of New Tiers' slug: /cloud/manage/jan-2025-faq/new-tiers keywords: ['new tiers', 'features', 'pricing', 'description'] description: 'Description of new tiers and features' -doc_type: 'reference' +doc_type: 'guide' --- ## Summary of key changes {#summary-of-key-changes} diff --git a/docs/cloud/manage/jan2025_faq/plan_migrations.md b/docs/cloud/manage/jan2025_faq/plan_migrations.md index 37e383d4c4e..1aeba941eb8 100644 --- a/docs/cloud/manage/jan2025_faq/plan_migrations.md +++ b/docs/cloud/manage/jan2025_faq/plan_migrations.md @@ -3,7 +3,7 @@ title: 'Migrating to New Plans' slug: /cloud/manage/jan-2025-faq/plan-migrations keywords: ['migration', 'new tiers', 'pricing', 'cost', 'estimation'] description: 'Migrating to new plans, tiers, pricing, how to decide and estimate costs' -doc_type: 'how-to' +doc_type: 'guide' --- ## Choosing new plans {#choosing-new-plans} diff --git a/docs/cloud/manage/jan2025_faq/scaling.md b/docs/cloud/manage/jan2025_faq/scaling.md index 45560ce32c7..45a4a1e5a81 100644 --- a/docs/cloud/manage/jan2025_faq/scaling.md +++ b/docs/cloud/manage/jan2025_faq/scaling.md @@ -3,7 +3,7 @@ title: 'Scaling' slug: /cloud/manage/jan-2025-faq/scaling keywords: ['new pricing', 'faq', 'scaling'] description: 'Scaling behavior in new pricing tiers' -doc_type: 'explanation' +doc_type: 'guide' --- ClickHouse Cloud allows scaling in both directions - vertical (increasing replica size) and horizontal (adding more replicas). diff --git a/docs/cloud/manage/jan2025_faq/summary.md b/docs/cloud/manage/jan2025_faq/summary.md index 07d3fc7ca13..d83f158b147 100644 --- a/docs/cloud/manage/jan2025_faq/summary.md +++ b/docs/cloud/manage/jan2025_faq/summary.md @@ -3,7 +3,7 @@ title: 'Summary' slug: /cloud/manage/jan-2025-faq/summary keywords: ['new tiers', 'packaging', 'pricing faq', 'summary'] description: 'Summary of New ClickHouse Cloud Tiers' -doc_type: 'reference' +doc_type: 'guide' --- The following FAQ summarizes common questions with respect to new tiers introduced in ClickHouse Cloud starting in January 2025. diff --git a/docs/cloud/manage/monitoring/advanced_dashboard.md b/docs/cloud/manage/monitoring/advanced_dashboard.md index 83d483329bd..aafb03c3faf 100644 --- a/docs/cloud/manage/monitoring/advanced_dashboard.md +++ b/docs/cloud/manage/monitoring/advanced_dashboard.md @@ -6,7 +6,7 @@ sidebar_label: 'Advanced dashboard' sidebar_position: 45 slug: /cloud/manage/monitor/advanced-dashboard title: 'Advanced dashboard in ClickHouse Cloud' -doc_type: 'how-to' +doc_type: 'guide' --- import AdvancedDashboard from '@site/static/images/cloud/manage/monitoring/advanced_dashboard.png'; diff --git a/docs/cloud/manage/notifications.md b/docs/cloud/manage/notifications.md index dfcfd496a53..4f3a25c6323 100644 --- a/docs/cloud/manage/notifications.md +++ b/docs/cloud/manage/notifications.md @@ -3,7 +3,7 @@ title: 'Notifications' slug: /cloud/notifications description: 'Notifications for your ClickHouse Cloud service' keywords: ['cloud', 'notifications'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/openapi.md b/docs/cloud/manage/openapi.md index 65fa3f56749..fee9eefc66c 100644 --- a/docs/cloud/manage/openapi.md +++ b/docs/cloud/manage/openapi.md @@ -3,7 +3,7 @@ sidebar_label: 'Managing API Keys' slug: /cloud/manage/openapi title: 'Managing API Keys' description: 'ClickHouse Cloud provides an API utilizing OpenAPI that allows you to programmatically manage your account and aspects of your services.' -doc_type: 'how-to' +doc_type: 'guide' --- import image_01 from '@site/static/images/cloud/manage/openapi1.png'; diff --git a/docs/cloud/manage/postman.md b/docs/cloud/manage/postman.md index a4a57b5022e..35f77dc90b6 100644 --- a/docs/cloud/manage/postman.md +++ b/docs/cloud/manage/postman.md @@ -3,7 +3,7 @@ slug: /cloud/manage/postman sidebar_label: 'Programmatic API access with Postman' title: 'Programmatic API access with Postman' description: 'This guide will help you test the ClickHouse Cloud API using Postman' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/replica-aware-routing.md b/docs/cloud/manage/replica-aware-routing.md index 62235d28e9e..9875022c681 100644 --- a/docs/cloud/manage/replica-aware-routing.md +++ b/docs/cloud/manage/replica-aware-routing.md @@ -3,7 +3,7 @@ title: 'Replica-aware Routing' slug: /manage/replica-aware-routing description: 'How to use Replica-aware routing to increase cache re-use' keywords: ['cloud', 'sticky endpoints', 'sticky', 'endpoints', 'sticky routing', 'routing', 'replica aware routing'] -doc_type: 'how-to' +doc_type: 'guide' --- # Replica-aware routing (private preview) diff --git a/docs/cloud/manage/scaling.md b/docs/cloud/manage/scaling.md index a5f13fd2930..fd0972b4a62 100644 --- a/docs/cloud/manage/scaling.md +++ b/docs/cloud/manage/scaling.md @@ -5,7 +5,7 @@ slug: /manage/scaling description: 'Configuring automatic scaling in ClickHouse Cloud' keywords: ['autoscaling', 'auto scaling', 'scaling', 'horizontal', 'vertical', 'bursts'] title: 'Automatic Scaling' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/settings.md b/docs/cloud/manage/settings.md index d23bfe722fe..85e876a691d 100644 --- a/docs/cloud/manage/settings.md +++ b/docs/cloud/manage/settings.md @@ -3,7 +3,7 @@ sidebar_label: 'Configuring Settings' slug: /manage/settings title: 'Configuring Settings' description: 'How to configure settings for your ClickHouse Cloud service for a specific user or role' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md index 6a280be37f0..f0bac694ddd 100644 --- a/docs/cloud/manage/troubleshooting-billing-issues.md +++ b/docs/cloud/manage/troubleshooting-billing-issues.md @@ -4,7 +4,7 @@ slug: /manage/clickhouse-cloud-billing-compliance title: 'ClickHouse Cloud billing compliance' description: 'Page describing ClickHouse Cloud billing compliance' keywords: ['billing compliance', 'pay-as-you-go'] -doc_type: 'reference' +doc_type: 'guide' --- import billing_compliance from '@site/static/images/cloud/manage/billing_compliance.png'; diff --git a/docs/cloud/manage/upgrades.md b/docs/cloud/manage/upgrades.md index 9f56d99be2d..a958abb779a 100644 --- a/docs/cloud/manage/upgrades.md +++ b/docs/cloud/manage/upgrades.md @@ -3,7 +3,7 @@ sidebar_label: 'Upgrades' slug: /manage/updates title: 'Upgrades' description: 'With ClickHouse Cloud you never have to worry about patching and upgrades. We roll out upgrades that include fixes, new features and performance improvements on a periodic basis.' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/migrate/upload-a-csv-file.md b/docs/cloud/migrate/upload-a-csv-file.md index a81351845a2..b675456766a 100644 --- a/docs/cloud/migrate/upload-a-csv-file.md +++ b/docs/cloud/migrate/upload-a-csv-file.md @@ -2,7 +2,7 @@ title: 'Uploading files' slug: /cloud/migrate/upload-a-csv-file description: 'Learn how to upload files to Cloud' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/reference/changelog.md b/docs/cloud/reference/changelog.md index 88dff0ee7ec..b363b37068b 100644 --- a/docs/cloud/reference/changelog.md +++ b/docs/cloud/reference/changelog.md @@ -3,7 +3,7 @@ slug: /whats-new/cloud sidebar_label: 'Cloud Changelog' title: 'Cloud Changelog' description: 'ClickHouse Cloud changelog providing descriptions of what is new in each ClickHouse Cloud release' -doc_type: 'reference' +doc_type: 'changelog' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/reference/changelogs-index.md b/docs/cloud/reference/changelogs-index.md index d4aeb6355d5..b0ea7cdbe60 100644 --- a/docs/cloud/reference/changelogs-index.md +++ b/docs/cloud/reference/changelogs-index.md @@ -2,7 +2,7 @@ slug: /cloud/reference/changelogs title: 'Changelogs' description: 'Landing page for Cloud changelogs' -doc_type: 'reference' +doc_type: 'landing-page' --- | Page | Description | diff --git a/docs/cloud/reference/cloud-compatibility.md b/docs/cloud/reference/cloud-compatibility.md index 41063b1fb0c..18408ee8521 100644 --- a/docs/cloud/reference/cloud-compatibility.md +++ b/docs/cloud/reference/cloud-compatibility.md @@ -3,7 +3,7 @@ slug: /whats-new/cloud-compatibility sidebar_label: 'Cloud Compatibility' title: 'Cloud Compatibility' description: 'This guide provides an overview of what to expect functionally and operationally in ClickHouse Cloud.' -doc_type: 'reference' +doc_type: 'guide' --- # ClickHouse Cloud compatibility guide diff --git a/docs/cloud/reference/index.md b/docs/cloud/reference/index.md index c595b3b9eef..d417a53572e 100644 --- a/docs/cloud/reference/index.md +++ b/docs/cloud/reference/index.md @@ -4,7 +4,7 @@ keywords: ['Cloud', 'reference', 'architecture', 'SharedMergeTree', 'Compute-com title: 'Overview' hide_title: true description: 'Landing page for the Cloud reference section' -doc_type: 'reference' +doc_type: 'landing-page' --- # Cloud reference diff --git a/docs/cloud/reference/release-notes-index.md b/docs/cloud/reference/release-notes-index.md index 1ee4ba54899..2e2a21899d9 100644 --- a/docs/cloud/reference/release-notes-index.md +++ b/docs/cloud/reference/release-notes-index.md @@ -2,7 +2,7 @@ slug: /cloud/reference/changelogs/release-notes title: 'Cloud Release Notes' description: 'Landing page for Cloud release notes' -doc_type: 'reference' +doc_type: 'landing-page' --- -| Page | Description | -|-----|-----| -| [Taiwan Historical Weather Datasets](/getting-started/example-datasets/tw-weather) | 131 million rows of weather observation data for the last 128 yrs | -| [Analyzing Stack Overflow data with ClickHouse](/getting-started/example-datasets/stackoverflow) | Analyzing Stack Overflow data with ClickHouse | -| [NOAA Global Historical Climatology Network](/getting-started/example-datasets/noaa) | 2.5 billion rows of climate data for the last 120 yrs | -| [The UK property prices dataset](/getting-started/example-datasets/uk-price-paid) | Learn how to use projections to improve the performance of queries that you run frequently using the UK property dataset, which contains data about prices paid for real-estate property in England and Wales | -| [Writing Queries in ClickHouse using GitHub Data](/getting-started/example-datasets/github) | Dataset containing all of the commits and changes for the ClickHouse repository | -| [New York Taxi Data](/getting-started/example-datasets/nyc-taxi) | Data for billions of taxi and for-hire vehicle (Uber, Lyft, etc.) trips originating in New York City since 2009 | -| [Geo Data using the Cell Tower Dataset](/getting-started/example-datasets/cell-towers) | Learn how to load OpenCelliD data into ClickHouse, connect Apache Superset to ClickHouse and build a dashboard based on data | -| [Amazon Customer Review](/getting-started/example-datasets/amazon-reviews) | Over 150M customer reviews of Amazon products | -| [AMPLab Big Data Benchmark](/getting-started/example-datasets/amplab-benchmark) | A benchmark dataset used for comparing the performance of data warehousing solutions. | -| [Anonymized Web Analytics](/getting-started/example-datasets/metrica) | Dataset consisting of two tables containing anonymized web analytics data with hits and visits | -| [Brown University Benchmark](/getting-started/example-datasets/brown-benchmark) | A new analytical benchmark for machine-generated log data | -| [COVID-19 Open-Data](/getting-started/example-datasets/covid19) | COVID-19 Open-Data is a large, open-source database of COVID-19 epidemiological data and related factors like demographics, economics, and government responses | -| [dbpedia dataset](/getting-started/example-datasets/dbpedia-dataset) | Dataset containing 1 million articles from Wikipedia and their vector embeddings | -| [Environmental Sensors Data](/getting-started/example-datasets/environmental-sensors) | Over 20 billion records of data from Sensor.Community, a contributors-driven global sensor network that creates Open Environmental Data. | -| [Foursquare places](/getting-started/example-datasets/foursquare-places) | Dataset with over 100 million records containing information about places on a map, such as shops, restaurants, parks, playgrounds, and monuments. | -| [GitHub Events Dataset](/getting-started/example-datasets/github-events) | Dataset containing all events on GitHub from 2011 to Dec 6 2020, with a size of 3.1 billion records. | -| [Hacker News dataset](/getting-started/example-datasets/hacker-news) | Dataset containing 28 million rows of hacker news data. | -| [Laion-400M dataset](/getting-started/example-datasets/laion-400m-dataset) | Dataset containing 400 million images with English image captions | -| [New York Public Library "What's on the Menu?" Dataset](/getting-started/example-datasets/menus) | Dataset containing 1.3 million records of historical data on the menus of hotels, restaurants and cafes with the dishes along with their prices. | -| [NYPD Complaint Data](/getting-started/example-datasets/nypd_complaint_data) | Ingest and query Tab Separated Value data in 5 steps | -| [OnTime](/getting-started/example-datasets/ontime) | Dataset containing the on-time performance of airline flights | -| [Star Schema Benchmark (SSB, 2009)](/getting-started/example-datasets/star-schema) | The Star Schema Benchmark (SSB) data set and queries | -| [Terabyte Click Logs from Criteo](/getting-started/example-datasets/criteo) | A terabyte of Click Logs from Criteo | -| [TPC-DS (2012)](/getting-started/example-datasets/tpcds) | The TPC-DS benchmark data set and queries. | -| [TPC-H (1999)](/getting-started/example-datasets/tpch) | The TPC-H benchmark data set and queries. | -| [WikiStat](/getting-started/example-datasets/wikistat) | Explore the WikiStat dataset containing 0.5 trillion records. | -| [YouTube dataset of dislikes](/getting-started/example-datasets/youtube-dislikes) | A collection is dislikes of YouTube videos. | diff --git a/docs/getting-started/install/advanced.md b/docs/getting-started/install/advanced.md index 9cd1b50e6e4..e42613d21d7 100644 --- a/docs/getting-started/install/advanced.md +++ b/docs/getting-started/install/advanced.md @@ -5,7 +5,7 @@ sidebar_label: 'Advanced install' slug: /install/advanced title: 'Advanced installation methods' hide_title: false -doc_type: 'how-to' +doc_type: 'guide' --- ## Compile from source {#compile-from-source} diff --git a/docs/getting-started/install/debian_ubuntu.md b/docs/getting-started/install/debian_ubuntu.md index aef54f1d6fa..d3e5aafd421 100644 --- a/docs/getting-started/install/debian_ubuntu.md +++ b/docs/getting-started/install/debian_ubuntu.md @@ -5,7 +5,7 @@ sidebar_label: 'Debian/Ubuntu' slug: /install/debian_ubuntu title: 'Install ClickHouse on Debian/Ubuntu' hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- import DebianProd from './_snippets/_deb_install.md' diff --git a/docs/getting-started/install/docker.md b/docs/getting-started/install/docker.md index eec8c731520..029e51e5354 100644 --- a/docs/getting-started/install/docker.md +++ b/docs/getting-started/install/docker.md @@ -5,7 +5,7 @@ sidebar_label: 'Docker' slug: /install/docker title: 'Install ClickHouse using Docker' hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- import Docker from './_snippets/_docker.md' diff --git a/docs/getting-started/install/macos.md b/docs/getting-started/install/macos.md index 8656f776eab..747fd53429b 100644 --- a/docs/getting-started/install/macos.md +++ b/docs/getting-started/install/macos.md @@ -5,7 +5,7 @@ sidebar_label: 'MacOS' slug: /install/macOS title: 'Install ClickHouse using Homebrew' hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- import MacOSProd from './_snippets/_macos.md' diff --git a/docs/getting-started/install/other_linux.md b/docs/getting-started/install/other_linux.md index 39391ac551c..b10f2c2e5c6 100644 --- a/docs/getting-started/install/other_linux.md +++ b/docs/getting-started/install/other_linux.md @@ -5,7 +5,7 @@ sidebar_label: 'Other Linux' slug: /install/linux_other title: 'Install ClickHouse using tgz archives' hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- import Tar from './_snippets/_linux_tar_install.md' diff --git a/docs/getting-started/install/quick-install-curl.md b/docs/getting-started/install/quick-install-curl.md index 819378e5e75..b8de0052cfd 100644 --- a/docs/getting-started/install/quick-install-curl.md +++ b/docs/getting-started/install/quick-install-curl.md @@ -5,7 +5,7 @@ sidebar_label: 'Quick install' slug: /install/quick-install-curl title: 'Install ClickHouse via script using curl' hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- import QuickInstall from './_snippets/_quick_install.md' diff --git a/docs/getting-started/install/redhat.md b/docs/getting-started/install/redhat.md index 228715c860d..f7540654b8c 100644 --- a/docs/getting-started/install/redhat.md +++ b/docs/getting-started/install/redhat.md @@ -5,7 +5,7 @@ sidebar_label: 'Redhat/CentOS' slug: /install/redhat title: 'Install ClickHouse on rpm-based Linux distributions' hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- import RPM from './_snippets/_rpm_install.md' diff --git a/docs/getting-started/install/windows.md b/docs/getting-started/install/windows.md index 776e7a81c4d..936eda78170 100644 --- a/docs/getting-started/install/windows.md +++ b/docs/getting-started/install/windows.md @@ -5,7 +5,7 @@ sidebar_label: 'Windows' slug: /install/windows title: 'Install ClickHouse on Windows with WSL' hide_title: true -doc_type: 'how-to' +doc_type: 'guide' --- import Windows from './_snippets/_windows_install.md' diff --git a/docs/getting-started/playground.md b/docs/getting-started/playground.md index d1c57503eb8..6870f21c735 100644 --- a/docs/getting-started/playground.md +++ b/docs/getting-started/playground.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'playground', 'getting', 'started', 'docs'] sidebar_label: 'ClickHouse Playground' slug: /getting-started/playground title: 'ClickHouse Playground' -doc_type: 'reference' +doc_type: 'guide' --- # ClickHouse playground diff --git a/docs/guides/best-practices/asyncinserts.md b/docs/guides/best-practices/asyncinserts.md index 23ead27a915..dddd0c7d5a1 100644 --- a/docs/guides/best-practices/asyncinserts.md +++ b/docs/guides/best-practices/asyncinserts.md @@ -3,7 +3,7 @@ slug: /optimize/asynchronous-inserts sidebar_label: 'Asynchronous Inserts' title: 'Asynchronous Inserts (async_insert)' description: 'Use asynchronous inserts as an alternative to batching data.' -doc_type: 'how-to' +doc_type: 'guide' --- import Content from '@site/docs/best-practices/_snippets/_async_inserts.md'; diff --git a/docs/guides/best-practices/avoidmutations.md b/docs/guides/best-practices/avoidmutations.md index 76bfba32e3d..e08716782f0 100644 --- a/docs/guides/best-practices/avoidmutations.md +++ b/docs/guides/best-practices/avoidmutations.md @@ -3,7 +3,7 @@ slug: /optimize/avoid-mutations sidebar_label: 'Avoid Mutations' title: 'Avoid Mutations' description: 'Mutations refers to ALTER queries that manipulate table data' -doc_type: 'how-to' +doc_type: 'guide' --- import Content from '@site/docs/best-practices/_snippets/_avoid_mutations.md'; diff --git a/docs/guides/best-practices/avoidnullablecolumns.md b/docs/guides/best-practices/avoidnullablecolumns.md index 36349d32c0a..74cba990613 100644 --- a/docs/guides/best-practices/avoidnullablecolumns.md +++ b/docs/guides/best-practices/avoidnullablecolumns.md @@ -3,7 +3,7 @@ slug: /optimize/avoid-nullable-columns sidebar_label: 'Avoid nullable Columns' title: 'Avoid nullable Columns' description: 'Why Nullable Columns should be avoided in ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Content from '@site/docs/best-practices/_snippets/_avoid_nullable_columns.md'; diff --git a/docs/guides/best-practices/avoidoptimizefinal.md b/docs/guides/best-practices/avoidoptimizefinal.md index 77c180a0b26..82b9ddebb36 100644 --- a/docs/guides/best-practices/avoidoptimizefinal.md +++ b/docs/guides/best-practices/avoidoptimizefinal.md @@ -3,7 +3,7 @@ slug: /optimize/avoidoptimizefinal sidebar_label: 'Avoid Optimize Final' title: 'Avoid Optimize Final' description: 'Using the OPTIMIZE TABLE ... FINAL query will initiate an unscheduled merge of data parts.' -doc_type: 'how-to' +doc_type: 'guide' --- import Content from '@site/docs/best-practices/_snippets/_avoid_optimize_final.md'; diff --git a/docs/guides/best-practices/bulkinserts.md b/docs/guides/best-practices/bulkinserts.md index 0ceb26a5533..17875929633 100644 --- a/docs/guides/best-practices/bulkinserts.md +++ b/docs/guides/best-practices/bulkinserts.md @@ -3,7 +3,7 @@ slug: /optimize/bulk-inserts sidebar_label: 'Bulk Inserts' title: 'Bulk Inserts' description: 'Sending a smaller amount of inserts that each contain more data will reduce the number of writes required.' -doc_type: 'how-to' +doc_type: 'guide' --- import Content from '@site/docs/best-practices/_snippets/_bulk_inserts.md'; diff --git a/docs/guides/best-practices/partitioningkey.md b/docs/guides/best-practices/partitioningkey.md index 0462f255c8f..e6487f602ef 100644 --- a/docs/guides/best-practices/partitioningkey.md +++ b/docs/guides/best-practices/partitioningkey.md @@ -3,7 +3,7 @@ slug: /optimize/partitioning-key sidebar_label: 'Partitioning Key' title: 'Choose a Low Cardinality Partitioning Key' description: 'Use a low cardinality partitioning key or avoid using any partitioning key for your table.' -doc_type: 'how-to' +doc_type: 'guide' --- import Content from '@site/docs/best-practices/partitioning_keys.mdx'; diff --git a/docs/guides/best-practices/prewhere.md b/docs/guides/best-practices/prewhere.md index 6f39c102fc2..bd4edc0e51a 100644 --- a/docs/guides/best-practices/prewhere.md +++ b/docs/guides/best-practices/prewhere.md @@ -4,7 +4,7 @@ sidebar_label: 'PREWHERE Optimization' sidebar_position: 21 description: 'PREWHERE reduces I/O by avoiding reading unnecessary column data.' title: 'How does the PREWHERE optimization work?' -doc_type: 'how-to' +doc_type: 'guide' --- import visual01 from '@site/static/images/guides/best-practices/prewhere_01.gif'; diff --git a/docs/guides/best-practices/query-optimization.md b/docs/guides/best-practices/query-optimization.md index eed8383684f..7639a1d7658 100644 --- a/docs/guides/best-practices/query-optimization.md +++ b/docs/guides/best-practices/query-optimization.md @@ -3,7 +3,7 @@ slug: /optimize/query-optimization sidebar_label: 'Query optimization' title: 'Guide for Query optimization' description: 'A simple guide for query optimization that describe common path to improve query performance' -doc_type: 'how-to' +doc_type: 'guide' --- import queryOptimizationDiagram1 from '@site/static/images/guides/best-practices/query_optimization_diagram_1.png'; diff --git a/docs/guides/best-practices/query-parallelism.md b/docs/guides/best-practices/query-parallelism.md index dea1323d9f9..5f5b58f640f 100644 --- a/docs/guides/best-practices/query-parallelism.md +++ b/docs/guides/best-practices/query-parallelism.md @@ -4,7 +4,7 @@ sidebar_label: 'Query Parallelism' sidebar_position: 20 description: 'ClickHouse parallelizes query execution using processing lanes and the max_threads setting.' title: 'How ClickHouse executes a query in parallel' -doc_type: 'how-to' +doc_type: 'guide' --- import visual01 from '@site/static/images/guides/best-practices/query-parallelism_01.gif'; diff --git a/docs/guides/best-practices/skipping-indexes.md b/docs/guides/best-practices/skipping-indexes.md index 7228d2d9ff5..7a15a2566a9 100644 --- a/docs/guides/best-practices/skipping-indexes.md +++ b/docs/guides/best-practices/skipping-indexes.md @@ -4,7 +4,7 @@ sidebar_label: 'Data Skipping Indexes' sidebar_position: 2 description: 'Skip indexes enable ClickHouse to skip reading significant chunks of data that are guaranteed to have no matching values.' title: 'Understanding ClickHouse Data Skipping Indexes' -doc_type: 'explanation' +doc_type: 'guide' --- import simple_skip from '@site/static/images/guides/best-practices/simple_skip.png'; diff --git a/docs/guides/best-practices/sparse-primary-indexes.md b/docs/guides/best-practices/sparse-primary-indexes.md index 76074f8204b..0182a21cef6 100644 --- a/docs/guides/best-practices/sparse-primary-indexes.md +++ b/docs/guides/best-practices/sparse-primary-indexes.md @@ -5,7 +5,7 @@ description: 'In this guide we are going to do a deep dive into ClickHouse index title: 'A Practical Introduction to Primary Indexes in ClickHouse' slug: /guides/best-practices/sparse-primary-indexes show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import sparsePrimaryIndexes01 from '@site/static/images/guides/best-practices/sparse-primary-indexes-01.png'; diff --git a/docs/guides/creating-tables.md b/docs/guides/creating-tables.md index d8cf28f214b..926968ad8fb 100644 --- a/docs/guides/creating-tables.md +++ b/docs/guides/creating-tables.md @@ -4,7 +4,7 @@ sidebar_label: 'Creating tables' title: 'Creating tables in ClickHouse' slug: /guides/creating-tables description: 'Learn about Creating Tables in ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- # Creating tables in ClickHouse diff --git a/docs/guides/developer/cascading-materialized-views.md b/docs/guides/developer/cascading-materialized-views.md index efd147aae52..6333a8d79ad 100644 --- a/docs/guides/developer/cascading-materialized-views.md +++ b/docs/guides/developer/cascading-materialized-views.md @@ -3,7 +3,7 @@ slug: /guides/developer/cascading-materialized-views title: 'Cascading Materialized Views' description: 'How to use multiple materialized views from a source table.' keywords: ['materialized view', 'aggregation'] -doc_type: 'tutorial' +doc_type: 'guide' --- # Cascading materialized views diff --git a/docs/guides/developer/debugging-memory-issues.md b/docs/guides/developer/debugging-memory-issues.md index 6ec1fe1bee2..408090a64f7 100644 --- a/docs/guides/developer/debugging-memory-issues.md +++ b/docs/guides/developer/debugging-memory-issues.md @@ -5,7 +5,7 @@ sidebar_position: 1 description: 'Queries to help you debug memory issues.' keywords: ['memory issues'] title: 'Debugging memory issues' -doc_type: 'reference' +doc_type: 'guide' --- # Debugging memory issues {#debugging-memory-issues} diff --git a/docs/guides/developer/deduplicating-inserts-on-retries.md b/docs/guides/developer/deduplicating-inserts-on-retries.md index 72a071f4fb7..1ab71a57824 100644 --- a/docs/guides/developer/deduplicating-inserts-on-retries.md +++ b/docs/guides/developer/deduplicating-inserts-on-retries.md @@ -3,7 +3,7 @@ slug: /guides/developer/deduplicating-inserts-on-retries title: 'Deduplicating Inserts on Retries' description: 'Preventing duplicate data when retrying insert operations' keywords: ['deduplication', 'deduplicate', 'insert retries', 'inserts'] -doc_type: 'how-to' +doc_type: 'guide' --- Insert operations can sometimes fail due to errors such as timeouts. When inserts fail, data may or may not have been successfully inserted. This guide covers how to enable deduplication on insert retries such that the same data does not get inserted more than once. diff --git a/docs/guides/developer/deduplication.md b/docs/guides/developer/deduplication.md index d071aee0eb9..e72ff889e76 100644 --- a/docs/guides/developer/deduplication.md +++ b/docs/guides/developer/deduplication.md @@ -4,7 +4,7 @@ sidebar_label: 'Deduplication Strategies' sidebar_position: 3 description: 'Use deduplication when you need to perform frequent upserts, updates and deletes.' title: 'Deduplication Strategies' -doc_type: 'how-to' +doc_type: 'guide' --- import deduplication from '@site/static/images/guides/developer/de_duplication.png'; diff --git a/docs/guides/developer/dynamic-column-selection.md b/docs/guides/developer/dynamic-column-selection.md index ceec9dcb05d..486bc02a1d0 100644 --- a/docs/guides/developer/dynamic-column-selection.md +++ b/docs/guides/developer/dynamic-column-selection.md @@ -3,7 +3,7 @@ slug: /guides/developer/dynamic-column-selection sidebar_label: 'Dynamic column selection' title: 'Dynamic column selection' description: 'Use alternative query languages in ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- [Dynamic column selection](/docs/sql-reference/statements/select#dynamic-column-selection) is a powerful but underutilized ClickHouse feature that allows you to select columns using regular expressions instead of naming each column individually. You can also apply functions to matching columns using the [`APPLY`](/sql-reference/statements/select#apply) modifier, making it incredibly useful for data analysis and transformation tasks. diff --git a/docs/guides/developer/index.md b/docs/guides/developer/index.md index caa2b6c2d45..feb680bc8f6 100644 --- a/docs/guides/developer/index.md +++ b/docs/guides/developer/index.md @@ -3,7 +3,7 @@ slug: /guides/developer/overview sidebar_label: 'Advanced Guides Overview' description: 'Overview of the advanced guides' title: 'Advanced Guides' -doc_type: 'reference' +doc_type: 'guide' --- # Advanced guides diff --git a/docs/guides/developer/mutations.md b/docs/guides/developer/mutations.md index e89027e6191..b12159d1356 100644 --- a/docs/guides/developer/mutations.md +++ b/docs/guides/developer/mutations.md @@ -6,7 +6,7 @@ keywords: ['UPDATE', 'DELETE', 'mutations'] title: 'Updating and deleting ClickHouse data' description: 'Describes how to perform update and delete operations in ClickHouse' show_related_blogs: false -doc_type: 'how-to' +doc_type: 'guide' --- # Updating and deleting ClickHouse data with mutations diff --git a/docs/guides/developer/on-fly-mutations.md b/docs/guides/developer/on-fly-mutations.md index 3f62e5fb25c..a28689c01b0 100644 --- a/docs/guides/developer/on-fly-mutations.md +++ b/docs/guides/developer/on-fly-mutations.md @@ -4,7 +4,7 @@ sidebar_label: 'On-the-fly mutation' title: 'On-the-fly Mutations' keywords: ['On-the-fly mutation'] description: 'Provides a description of on-the-fly mutations' -doc_type: 'explanation' +doc_type: 'guide' --- ## On-the-fly mutations {#on-the-fly-mutations} diff --git a/docs/guides/developer/replacing-merge-tree.md b/docs/guides/developer/replacing-merge-tree.md index c0dfbec1520..3def2b9a483 100644 --- a/docs/guides/developer/replacing-merge-tree.md +++ b/docs/guides/developer/replacing-merge-tree.md @@ -3,7 +3,7 @@ slug: /guides/replacing-merge-tree title: 'ReplacingMergeTree' description: 'Using the ReplacingMergeTree engine in ClickHouse' keywords: ['replacingmergetree', 'inserts', 'deduplication'] -doc_type: 'explanation' +doc_type: 'guide' --- import postgres_replacingmergetree from '@site/static/images/migrations/postgres-replacingmergetree.png'; diff --git a/docs/guides/developer/time-series-filling-gaps.md b/docs/guides/developer/time-series-filling-gaps.md index 4a07c6e553e..c3b8ea2cdce 100644 --- a/docs/guides/developer/time-series-filling-gaps.md +++ b/docs/guides/developer/time-series-filling-gaps.md @@ -5,7 +5,7 @@ sidebar_position: 10 description: 'Filling gaps in time-series data.' keywords: ['time series', 'gap fill'] title: 'Filling gaps in time-series data' -doc_type: 'how-to' +doc_type: 'guide' --- # Filling gaps in time-series data diff --git a/docs/guides/developer/ttl.md b/docs/guides/developer/ttl.md index 448f7d91a29..dfd08c375f9 100644 --- a/docs/guides/developer/ttl.md +++ b/docs/guides/developer/ttl.md @@ -6,7 +6,7 @@ keywords: ['ttl', 'time to live', 'clickhouse', 'old', 'data'] description: 'TTL (time-to-live) refers to the capability of having rows or columns moved, deleted, or rolled up after a certain interval of time has passed.' title: 'Manage Data with TTL (Time-to-live)' show_related_blogs: true -doc_type: 'reference' +doc_type: 'guide' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/guides/developer/understanding-query-execution-with-the-analyzer.md b/docs/guides/developer/understanding-query-execution-with-the-analyzer.md index 4025b4b2650..5841c3411bc 100644 --- a/docs/guides/developer/understanding-query-execution-with-the-analyzer.md +++ b/docs/guides/developer/understanding-query-execution-with-the-analyzer.md @@ -3,7 +3,7 @@ slug: /guides/developer/understanding-query-execution-with-the-analyzer sidebar_label: 'Understanding Query Execution with the Analyzer' title: 'Understanding Query Execution with the Analyzer' description: 'Describes how you can use the analyzer to understand how ClickHouse executes your queries' -doc_type: 'explanation' +doc_type: 'guide' --- import analyzer1 from '@site/static/images/guides/developer/analyzer1.png'; diff --git a/docs/guides/examples/aggregate_function_combinators/anyIf.md b/docs/guides/examples/aggregate_function_combinators/anyIf.md index b04e25b3146..896d9704f45 100644 --- a/docs/guides/examples/aggregate_function_combinators/anyIf.md +++ b/docs/guides/examples/aggregate_function_combinators/anyIf.md @@ -4,7 +4,7 @@ title: 'anyIf' description: 'Example of using the anyIf combinator' keywords: ['any', 'if', 'combinator', 'examples', 'anyIf'] sidebar_label: 'anyIf' -doc_type: 'how-to' +doc_type: 'reference' --- # anyIf {#avgif} diff --git a/docs/guides/examples/aggregate_function_combinators/avgIf.md b/docs/guides/examples/aggregate_function_combinators/avgIf.md index e82d93877d1..535ee31d1da 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgIf.md +++ b/docs/guides/examples/aggregate_function_combinators/avgIf.md @@ -4,7 +4,7 @@ title: 'avgIf' description: 'Example of using the avgIf combinator' keywords: ['avg', 'if', 'combinator', 'examples', 'avgIf'] sidebar_label: 'avgIf' -doc_type: 'how-to' +doc_type: 'reference' --- # avgIf {#avgif} diff --git a/docs/guides/examples/aggregate_function_combinators/avgMap.md b/docs/guides/examples/aggregate_function_combinators/avgMap.md index 75172e2fb06..16a91058834 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgMap.md +++ b/docs/guides/examples/aggregate_function_combinators/avgMap.md @@ -4,7 +4,7 @@ title: 'avgMap' description: 'Example of using the avgMap combinator' keywords: ['avg', 'map', 'combinator', 'examples', 'avgMap'] sidebar_label: 'avgMap' -doc_type: 'tutorial' +doc_type: 'reference' --- # avgMap {#avgmap} diff --git a/docs/guides/examples/aggregate_function_combinators/avgMergeState.md b/docs/guides/examples/aggregate_function_combinators/avgMergeState.md index b44d6172247..2e1de95c91e 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgMergeState.md +++ b/docs/guides/examples/aggregate_function_combinators/avgMergeState.md @@ -4,7 +4,7 @@ title: 'avgMergeState' description: 'Example of using the avgMergeState combinator' keywords: ['avg', 'MergeState', 'combinator', 'examples', 'avgMergeState'] sidebar_label: 'avgMergeState' -doc_type: 'how-to' +doc_type: 'reference' --- import Tabs from '@theme/Tabs'; diff --git a/docs/guides/examples/aggregate_function_combinators/avgResample.md b/docs/guides/examples/aggregate_function_combinators/avgResample.md index 43f119a4910..7e54f873241 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgResample.md +++ b/docs/guides/examples/aggregate_function_combinators/avgResample.md @@ -4,7 +4,7 @@ title: 'avgResample' description: 'Example of using the Resample combinator with avg' keywords: ['avg', 'Resample', 'combinator', 'examples', 'avgResample'] sidebar_label: 'avgResample' -doc_type: 'how-to' +doc_type: 'reference' --- # countResample {#countResample} diff --git a/docs/guides/examples/aggregate_function_combinators/avgState.md b/docs/guides/examples/aggregate_function_combinators/avgState.md index f13f94a8d2f..1dec7554042 100644 --- a/docs/guides/examples/aggregate_function_combinators/avgState.md +++ b/docs/guides/examples/aggregate_function_combinators/avgState.md @@ -4,7 +4,7 @@ title: 'avgState' description: 'Example of using the avgState combinator' keywords: ['avg', 'state', 'combinator', 'examples', 'avgState'] sidebar_label: 'avgState' -doc_type: 'how-to' +doc_type: 'reference' --- # avgState {#avgState} diff --git a/docs/guides/examples/aggregate_function_combinators/countIf.md b/docs/guides/examples/aggregate_function_combinators/countIf.md index 30e452c6c57..ee5131edf08 100644 --- a/docs/guides/examples/aggregate_function_combinators/countIf.md +++ b/docs/guides/examples/aggregate_function_combinators/countIf.md @@ -4,7 +4,7 @@ title: 'countIf' description: 'Example of using the countIf combinator' keywords: ['count', 'if', 'combinator', 'examples', 'countIf'] sidebar_label: 'countIf' -doc_type: 'how-to' +doc_type: 'reference' --- # countIf {#countif} diff --git a/docs/guides/examples/aggregate_function_combinators/countResample.md b/docs/guides/examples/aggregate_function_combinators/countResample.md index 64749a0e59c..826e8806fa8 100644 --- a/docs/guides/examples/aggregate_function_combinators/countResample.md +++ b/docs/guides/examples/aggregate_function_combinators/countResample.md @@ -4,7 +4,7 @@ title: 'countResample' description: 'Example of using the Resample combinator with count' keywords: ['count', 'Resample', 'combinator', 'examples', 'countResample'] sidebar_label: 'countResample' -doc_type: 'how-to' +doc_type: 'reference' --- # countResample {#countResample} diff --git a/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md b/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md index 5b600a88270..9f950dde551 100644 --- a/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md +++ b/docs/guides/examples/aggregate_function_combinators/groupArrayDistinct.md @@ -4,7 +4,7 @@ title: 'groupArrayDistinct' description: 'Example of using the groupArrayDistinct combinator' keywords: ['groupArray', 'Distinct', 'combinator', 'examples', 'groupArrayDistinct'] sidebar_label: 'groupArrayDistinct' -doc_type: 'how-to' +doc_type: 'reference' --- # groupArrayDistinct {#sumdistinct} diff --git a/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md b/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md index b39bfd6148d..c392ffebbfe 100644 --- a/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md +++ b/docs/guides/examples/aggregate_function_combinators/groupArrayResample.md @@ -4,7 +4,7 @@ title: 'groupArrayResample' description: 'Example of using the Resample combinator with groupArray' keywords: ['groupArray', 'Resample', 'combinator', 'examples', 'groupArrayResample'] sidebar_label: 'groupArrayResample' -doc_type: 'how-to' +doc_type: 'reference' --- # groupArrayResample {#grouparrayresample} diff --git a/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md b/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md index d785c21869f..837c008d03a 100644 --- a/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md +++ b/docs/guides/examples/aggregate_function_combinators/quantilesTimingArrayIf.md @@ -4,7 +4,7 @@ title: 'quantilesTimingArrayIf' description: 'Example of using the quantilesTimingArrayIf combinator' keywords: ['quantilesTiming', 'array', 'if', 'combinator', 'examples', 'quantilesTimingArrayIf'] sidebar_label: 'quantilesTimingArrayIf' -doc_type: 'how-to' +doc_type: 'reference' --- # quantilesTimingArrayIf {#quantilestimingarrayif} diff --git a/docs/guides/examples/aggregate_function_combinators/sumForEach.md b/docs/guides/examples/aggregate_function_combinators/sumForEach.md index 2cbcdefd0f0..ffe94333ef4 100644 --- a/docs/guides/examples/aggregate_function_combinators/sumForEach.md +++ b/docs/guides/examples/aggregate_function_combinators/sumForEach.md @@ -4,7 +4,7 @@ title: 'sumForEach' description: 'Example of using the sumForEach aggregate function' keywords: ['sum', 'ForEach', 'combinator', 'examples', 'sumForEach'] sidebar_label: 'sumForEach' -doc_type: 'how-to' +doc_type: 'reference' --- # sumForEach {#sumforeach} diff --git a/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md b/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md index 2d56b0cba56..a6a6d315f9c 100644 --- a/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md +++ b/docs/guides/examples/aggregate_function_combinators/sumSimpleState.md @@ -4,7 +4,7 @@ title: 'sumSimpleState' description: 'Example of using the sumSimpleState combinator' keywords: ['sum', 'state', 'simple', 'combinator', 'examples', 'sumSimpleState'] sidebar_label: 'sumSimpleState' -doc_type: 'how-to' +doc_type: 'reference' --- # sumSimpleState {#sumsimplestate} diff --git a/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md b/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md index 4cf08c7293d..38f07ce03f3 100644 --- a/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md +++ b/docs/guides/examples/aggregate_function_combinators/uniqArrayIf.md @@ -4,7 +4,7 @@ title: 'uniqArrayIf' description: 'Example of using the uniqArrayIf combinator' keywords: ['uniq', 'array', 'if', 'combinator', 'examples', 'uniqArrayIf'] sidebar_label: 'uniqArrayIf' -doc_type: 'how-to' +doc_type: 'reference' --- # uniqArrayIf {#uniqarrayif} diff --git a/docs/guides/inserting-data.md b/docs/guides/inserting-data.md index 7278438eacd..8c4ba0c08f4 100644 --- a/docs/guides/inserting-data.md +++ b/docs/guides/inserting-data.md @@ -5,7 +5,7 @@ keywords: ['INSERT', 'Batch Insert'] sidebar_label: 'Inserting ClickHouse data' slug: /guides/inserting-data show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import postgres_inserts from '@site/static/images/guides/postgres-inserts.png'; diff --git a/docs/guides/joining-tables.md b/docs/guides/joining-tables.md index e925e7ac1c8..2dff656e607 100644 --- a/docs/guides/joining-tables.md +++ b/docs/guides/joining-tables.md @@ -3,7 +3,7 @@ title: 'Using JOINs in ClickHouse' description: 'How to join tables in ClickHouse' keywords: ['joins', 'join tables'] slug: /guides/joining-tables -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/guides/manage-and-deploy-index.md b/docs/guides/manage-and-deploy-index.md index e0dac129a57..1191a6a4092 100644 --- a/docs/guides/manage-and-deploy-index.md +++ b/docs/guides/manage-and-deploy-index.md @@ -2,7 +2,7 @@ title: 'Manage and Deploy Overview' description: 'Overview page for Manage and Deploy' slug: /guides/manage-and-deploy-index -doc_type: 'reference' +doc_type: 'landing-page' --- # Manage and deploy diff --git a/docs/guides/separation-storage-compute.md b/docs/guides/separation-storage-compute.md index f29bb008afc..b18cc806ff1 100644 --- a/docs/guides/separation-storage-compute.md +++ b/docs/guides/separation-storage-compute.md @@ -4,7 +4,7 @@ sidebar_label: 'Separation of Storage and Compute' slug: /guides/separation-storage-compute title: 'Separation of Storage and Compute' description: 'This guide explores how you can use ClickHouse and S3 to implement an architecture with separated storage and compute.' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/guides/sre/configuring-ssl.md b/docs/guides/sre/configuring-ssl.md index 5958bc42bdf..16a8598d4da 100644 --- a/docs/guides/sre/configuring-ssl.md +++ b/docs/guides/sre/configuring-ssl.md @@ -4,7 +4,7 @@ sidebar_label: 'Configuring SSL-TLS' sidebar_position: 20 title: 'Configuring SSL-TLS' description: 'This guide provides simple and minimal settings to configure ClickHouse to use OpenSSL certificates to validate connections.' -doc_type: 'tutorial' +doc_type: 'guide' --- import SelfManaged from '@site/docs/_snippets/_self_managed_only_automated.md'; diff --git a/docs/guides/sre/index.md b/docs/guides/sre/index.md index a8c2e4ea319..26ccc26789a 100644 --- a/docs/guides/sre/index.md +++ b/docs/guides/sre/index.md @@ -2,7 +2,7 @@ slug: /security-and-authentication title: 'Security and Authentication' description: 'Landing page for Security and Authentication' -doc_type: 'reference' +doc_type: 'landing-page' --- | Page | Description | diff --git a/docs/guides/sre/keeper/index.md b/docs/guides/sre/keeper/index.md index 3c06fadfe08..39e18dc7baa 100644 --- a/docs/guides/sre/keeper/index.md +++ b/docs/guides/sre/keeper/index.md @@ -6,7 +6,7 @@ sidebar_position: 10 keywords: ['Keeper', 'ZooKeeper', 'clickhouse-keeper'] description: 'ClickHouse Keeper, or clickhouse-keeper, replaces ZooKeeper and provides replication and coordination.' title: 'ClickHouse Keeper' -doc_type: 'reference' +doc_type: 'guide' --- # ClickHouse Keeper (clickhouse-keeper) diff --git a/docs/guides/sre/scaling-clusters.md b/docs/guides/sre/scaling-clusters.md index 91d9289120c..0bcf4a8283f 100644 --- a/docs/guides/sre/scaling-clusters.md +++ b/docs/guides/sre/scaling-clusters.md @@ -4,7 +4,7 @@ sidebar_label: 'Rebalancing Shards' sidebar_position: 20 description: 'ClickHouse does not support automatic shard rebalancing, so we provide some best practices for how to rebalance shards.' title: 'Rebalancing Data' -doc_type: 'how-to' +doc_type: 'guide' --- # Rebalancing data diff --git a/docs/guides/sre/user-management/configuring-ldap.md b/docs/guides/sre/user-management/configuring-ldap.md index f8e04ba35d1..6f950f3c562 100644 --- a/docs/guides/sre/user-management/configuring-ldap.md +++ b/docs/guides/sre/user-management/configuring-ldap.md @@ -4,7 +4,7 @@ sidebar_position: 2 slug: /guides/sre/configuring-ldap title: 'Configuring ClickHouse to Use LDAP for Authentication and Role Mapping' description: 'Describes how to configure ClickHouse to use LDAP for authentication and role mapping' -doc_type: 'how-to' +doc_type: 'guide' --- import SelfManaged from '@site/docs/_snippets/_self_managed_only_no_roadmap.md'; diff --git a/docs/guides/sre/user-management/index.md b/docs/guides/sre/user-management/index.md index c81bd403867..69856c34c32 100644 --- a/docs/guides/sre/user-management/index.md +++ b/docs/guides/sre/user-management/index.md @@ -5,7 +5,7 @@ sidebar_label: 'Users and Roles' title: 'Access Control and Account Management' keywords: ['ClickHouse Cloud', 'Access Control', 'User Management', 'RBAC', 'Security'] description: 'Describes access control and account management in ClickHouse Cloud' -doc_type: 'tutorial' +doc_type: 'guide' --- # Creating users and roles in ClickHouse diff --git a/docs/guides/sre/user-management/ssl-user-auth.md b/docs/guides/sre/user-management/ssl-user-auth.md index ff1f74f77be..387f8cc37fd 100644 --- a/docs/guides/sre/user-management/ssl-user-auth.md +++ b/docs/guides/sre/user-management/ssl-user-auth.md @@ -4,7 +4,7 @@ sidebar_position: 3 slug: /guides/sre/ssl-user-auth title: 'Configuring SSL User Certificate for Authentication' description: 'This guide provides simple and minimal settings to configure authentication with SSL user certificates.' -doc_type: 'how-to' +doc_type: 'guide' --- # Configuring SSL user certificate for authentication diff --git a/docs/guides/troubleshooting.md b/docs/guides/troubleshooting.md index 419313f5a2f..77eaceb881a 100644 --- a/docs/guides/troubleshooting.md +++ b/docs/guides/troubleshooting.md @@ -2,7 +2,7 @@ title: 'Troubleshooting' description: 'Installation troubleshooting guide' slug: /guides/troubleshooting -doc_type: 'how-to' +doc_type: 'guide' --- ## Installation {#installation} diff --git a/docs/guides/writing-queries.md b/docs/guides/writing-queries.md index c3a919197f1..79a868c6ba7 100644 --- a/docs/guides/writing-queries.md +++ b/docs/guides/writing-queries.md @@ -6,7 +6,7 @@ slug: /guides/writing-queries description: 'Learn about Selecting ClickHouse Data' keywords: ['SELECT', 'data formats'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- ClickHouse is a SQL database, and you query your data by writing the same type of `SELECT` queries you are already familiar with. For example: diff --git a/docs/integrations/data-ingestion/apache-spark/index.md b/docs/integrations/data-ingestion/apache-spark/index.md index f11cc6e48a1..7e46f668261 100644 --- a/docs/integrations/data-ingestion/apache-spark/index.md +++ b/docs/integrations/data-ingestion/apache-spark/index.md @@ -5,7 +5,7 @@ slug: /integrations/apache-spark description: 'Introduction to Apache Spark with ClickHouse' keywords: ['clickhouse', 'Apache Spark', 'migrating', 'data'] title: 'Integrating Apache Spark with ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md b/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md index 230ecf4ac06..65e0738ff33 100644 --- a/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md +++ b/docs/integrations/data-ingestion/apache-spark/spark-jdbc.md @@ -5,7 +5,7 @@ slug: /integrations/apache-spark/spark-jdbc description: 'Introduction to Apache Spark with ClickHouse' keywords: ['clickhouse', 'Apache Spark', 'jdbc', 'migrating', 'data'] title: 'Spark JDBC' -doc_type: 'how-to' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md b/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md index edeec5e047b..ab984cfd1a2 100644 --- a/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md +++ b/docs/integrations/data-ingestion/apache-spark/spark-native-connector.md @@ -5,7 +5,7 @@ slug: /integrations/apache-spark/spark-native-connector description: 'Introduction to Apache Spark with ClickHouse' keywords: ['clickhouse', 'Apache Spark', 'migrating', 'data'] title: 'Spark Connector' -doc_type: 'tutorial' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/data-ingestion/aws-glue/index.md b/docs/integrations/data-ingestion/aws-glue/index.md index e944051a4b8..5ca02c890c8 100644 --- a/docs/integrations/data-ingestion/aws-glue/index.md +++ b/docs/integrations/data-ingestion/aws-glue/index.md @@ -5,7 +5,7 @@ slug: /integrations/glue description: 'Integrate ClickHouse and Amazon Glue' keywords: ['clickhouse', 'amazon', 'aws', 'glue', 'migrating', 'data', 'spark'] title: 'Integrating Amazon Glue with ClickHouse and Spark' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/azure-data-factory/index.md b/docs/integrations/data-ingestion/azure-data-factory/index.md index 74ab767b2e4..cb5e01ec5dd 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/index.md +++ b/docs/integrations/data-ingestion/azure-data-factory/index.md @@ -3,7 +3,7 @@ slug: /integrations/azure-data-factory description: 'Bringing Azure Data into ClickHouse' keywords: ['azure data factory', 'azure', 'microsoft', 'data'] title: 'Bringing Azure Data into ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- | Page | Description | diff --git a/docs/integrations/data-ingestion/azure-data-factory/overview.md b/docs/integrations/data-ingestion/azure-data-factory/overview.md index 2047e27612c..cba2200b2f7 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/overview.md +++ b/docs/integrations/data-ingestion/azure-data-factory/overview.md @@ -4,7 +4,7 @@ slug: /integrations/azure-data-factory/overview description: 'Bringing Azure Data into ClickHouse - Overview' keywords: ['azure data factory', 'azure', 'microsoft', 'data'] title: 'Bringing Azure Data into ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- # Bringing Azure Data into ClickHouse diff --git a/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md b/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md index 2ea101085a9..2e76d3d9c6e 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md +++ b/docs/integrations/data-ingestion/azure-data-factory/using_azureblobstorage.md @@ -4,7 +4,7 @@ slug: /integrations/azure-data-factory/table-function description: 'Using ClickHouse''s azureBlobStorage table function' keywords: ['azure data factory', 'azure', 'microsoft', 'data', 'azureBlobStorage'] title: 'Using ClickHouse''s azureBlobStorage table function to bring Azure data into ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md b/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md index 3bf304c09d3..a64060de294 100644 --- a/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md +++ b/docs/integrations/data-ingestion/azure-data-factory/using_http_interface.md @@ -4,7 +4,7 @@ slug: /integrations/azure-data-factory/http-interface description: 'Using ClickHouse''s HTTP interface to bring data from Azure Data Factory into ClickHouse' keywords: ['azure data factory', 'azure', 'microsoft', 'data', 'http interface'] title: 'Using ClickHouse HTTP Interface to bring Azure data into ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/azure-synapse/index.md b/docs/integrations/data-ingestion/azure-synapse/index.md index 401eaf89c65..a92b98dcaa5 100644 --- a/docs/integrations/data-ingestion/azure-synapse/index.md +++ b/docs/integrations/data-ingestion/azure-synapse/index.md @@ -4,7 +4,7 @@ slug: /integrations/azure-synapse description: 'Introduction to Azure Synapse with ClickHouse' keywords: ['clickhouse', 'azure synapse', 'azure', 'synapse', 'microsoft', 'azure spark', 'data'] title: 'Integrating Azure Synapse with ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md b/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md index 0172c22dc1d..6748d89407f 100644 --- a/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md +++ b/docs/integrations/data-ingestion/clickpipes/aws-privatelink.md @@ -3,7 +3,7 @@ sidebar_label: 'AWS PrivateLink for ClickPipes' description: 'Establish a secure connection between ClickPipes and a data source using AWS PrivateLink.' slug: /integrations/clickpipes/aws-privatelink title: 'AWS PrivateLink for ClickPipes' -doc_type: 'how-to' +doc_type: 'guide' --- import cp_service from '@site/static/images/integrations/data-ingestion/clickpipes/cp_service.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/index.md b/docs/integrations/data-ingestion/clickpipes/index.md index adfe44d98b3..5fcd85ab548 100644 --- a/docs/integrations/data-ingestion/clickpipes/index.md +++ b/docs/integrations/data-ingestion/clickpipes/index.md @@ -3,7 +3,7 @@ sidebar_label: 'Introduction' description: 'Seamlessly connect your external data sources to ClickHouse Cloud.' slug: /integrations/clickpipes title: 'Integrating with ClickHouse Cloud' -doc_type: 'tutorial' +doc_type: 'guide' --- import Kafkasvg from '@site/static/images/integrations/logos/kafka.svg'; diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md b/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md index 2eb05ce5806..0472fd0867d 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/01_create-kafka-clickpipe.md @@ -4,7 +4,7 @@ description: 'Step-by-step guide to creating your first Kafka ClickPipe.' slug: /integrations/clickpipes/kafka/create-your-first-kafka-clickpipe sidebar_position: 1 title: 'Creating your first Kafka ClickPipe' -doc_type: 'how-to' +doc_type: 'guide' --- import cp_step0 from '@site/static/images/integrations/data-ingestion/clickpipes/cp_step0.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md b/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md index f168140bf1b..1697e89dc5c 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/02_schema-registries.md @@ -4,7 +4,7 @@ description: 'How to integrate for ClickPipes with a schema registry for schema slug: /integrations/clickpipes/kafka/schema-registries sidebar_position: 1 title: 'Schema registries for Kafka ClickPipe' -doc_type: 'reference' +doc_type: 'guide' --- # Schema registries {#schema-registries} diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md b/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md index 92a30a742c3..9e78a838c9d 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/04_best_practices.md @@ -4,7 +4,7 @@ description: 'Details best practices to follow when working with Kafka ClickPipe slug: /integrations/clickpipes/kafka/best-practices sidebar_position: 1 title: 'Best practices' -doc_type: 'tutorial' +doc_type: 'guide' --- # Best practices {#best-practices} diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md b/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md index 84d6689e3ce..890dc76cbae 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/05_faq.md @@ -4,7 +4,7 @@ description: 'Frequently asked questions about ClickPipes for Kafka' slug: /integrations/clickpipes/kafka/faq sidebar_position: 1 title: 'Kafka ClickPipes FAQ' -doc_type: 'explanation' +doc_type: 'guide' --- ## Kafka ClickPipes FAQ {#faq} diff --git a/docs/integrations/data-ingestion/clickpipes/kafka/index.md b/docs/integrations/data-ingestion/clickpipes/kafka/index.md index 6d7ccdab867..fc10636ae34 100644 --- a/docs/integrations/data-ingestion/clickpipes/kafka/index.md +++ b/docs/integrations/data-ingestion/clickpipes/kafka/index.md @@ -3,7 +3,7 @@ description: 'Landing page with table of contents for the Kafka ClickPipes secti slug: /integrations/clickpipes/kafka sidebar_position: 1 title: 'Kafka ClickPipes' -doc_type: 'reference' +doc_type: 'landing-page' --- @@ -11,7 +11,7 @@ doc_type: 'reference' |-----|-----| | [Creating your first Kafka ClickPipe](/integrations/clickpipes/kafka/create-your-first-kafka-clickpipe) | Step-by-step guide to creating your first Kafka ClickPipe. | | [Reference](/integrations/clickpipes/kafka/reference) | Details supported formats, sources, delivery semantics, authentication and experimental features supported by Kafka ClickPipes | -| [Schema registries for Kafka ClickPipe](/integrations/clickpipes/kafka/schema-registries) | Information on schema registries for Kafka ClickPipe | -| [Kafka ClickPipes FAQ](/integrations/clickpipes/kafka/faq) | Frequently asked questions about Kafka ClickPipes | +| [Schema registries for Kafka ClickPipe](/integrations/clickpipes/kafka/schema-registries) | How to integrate for ClickPipes with a schema registry for schema management | +| [Kafka ClickPipes FAQ](/integrations/clickpipes/kafka/faq) | Frequently asked questions about ClickPipes for Kafka | | [Best practices](/integrations/clickpipes/kafka/best-practices) | Details best practices to follow when working with Kafka ClickPipes | \ No newline at end of file diff --git a/docs/integrations/data-ingestion/clickpipes/kinesis.md b/docs/integrations/data-ingestion/clickpipes/kinesis.md index f9d8f64b612..64615f36fbf 100644 --- a/docs/integrations/data-ingestion/clickpipes/kinesis.md +++ b/docs/integrations/data-ingestion/clickpipes/kinesis.md @@ -3,7 +3,7 @@ sidebar_label: 'ClickPipes for Amazon Kinesis' description: 'Seamlessly connect your Amazon Kinesis data sources to ClickHouse Cloud.' slug: /integrations/clickpipes/kinesis title: 'Integrating Amazon Kinesis with ClickHouse Cloud' -doc_type: 'how-to' +doc_type: 'guide' --- import cp_service from '@site/static/images/integrations/data-ingestion/clickpipes/cp_service.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md b/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md index e533480fbe3..1e46a40c9bc 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/add_table.md @@ -4,7 +4,7 @@ description: 'Describes the steps needed to add specific tables to a ClickPipe.' sidebar_label: 'Add Table' slug: /integrations/clickpipes/mongodb/add_table show_title: false -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md b/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md index 73cfc6a83c9..fa2a6967f7e 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/controlling_sync.md @@ -3,7 +3,7 @@ title: 'Controlling the Syncing of a MongoDB ClickPipe' description: 'Doc for controllling the sync a MongoDB ClickPipe' slug: /integrations/clickpipes/mongodb/sync_control sidebar_label: 'Controlling syncs' -doc_type: 'how-to' +doc_type: 'guide' --- import edit_sync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/index.md b/docs/integrations/data-ingestion/clickpipes/mongodb/index.md index 189bee23df0..7c27e63d61d 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/index.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/index.md @@ -3,7 +3,7 @@ sidebar_label: 'Ingesting Data from MongoDB to ClickHouse' description: 'Describes how to seamlessly connect your MongoDB to ClickHouse Cloud.' slug: /integrations/clickpipes/mongodb title: 'Ingesting data from MongoDB to ClickHouse (using CDC)' -doc_type: 'how-to' +doc_type: 'guide' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md b/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md index 5accce1e31d..14ffef69847 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/lifecycle.md @@ -3,7 +3,7 @@ sidebar_label: 'Lifecycle of a MongoDB ClickPipe' description: 'Various pipe statuses and their meanings' slug: /integrations/clickpipes/mongodb/lifecycle title: 'Lifecycle of a MongoDB ClickPipe' -doc_type: 'reference' +doc_type: 'guide' --- # Lifecycle of a MongoDB ClickPipe {#lifecycle} diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md b/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md index e77072af9dc..a4696440a41 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/pause_and_resume.md @@ -3,7 +3,7 @@ title: 'Pausing and Resuming a MongoDB ClickPipe' description: 'Pausing and Resuming a MongoDB ClickPipe' sidebar_label: 'Pause Table' slug: /integrations/clickpipes/mongodb/pause_and_resume -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md b/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md index aba4750d9d8..16ff53a80f7 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/quickstart.md @@ -3,7 +3,7 @@ title: 'Working with JSON in ClickHouse' sidebar_label: 'Working with JSON' slug: /integrations/clickpipes/mongodb/quickstart description: 'Common patterns for working with JSON data replicated from MongoDB to ClickHouse via ClickPipes' -doc_type: 'reference' +doc_type: 'guide' --- # Working with JSON in ClickHouse diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md b/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md index 5a7b73aef82..eca2e1e7647 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/remove_table.md @@ -3,7 +3,7 @@ title: 'Removing specific tables from a ClickPipe' description: 'Removing specific tables from a ClickPipe' sidebar_label: 'Remove Table' slug: /integrations/clickpipes/mongodb/removing_tables -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md b/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md index e33ffd41b58..6e346ed5378 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/resync.md @@ -3,7 +3,7 @@ title: 'Resyncing a Database ClickPipe' description: 'Doc for resyncing a database ClickPipe' slug: /integrations/clickpipes/mongodb/resync sidebar_label: 'Resync ClickPipe' -doc_type: 'how-to' +doc_type: 'guide' --- import resync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/resync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md b/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md index 77475b94247..25c831322ed 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/source/atlas.md @@ -3,7 +3,7 @@ sidebar_label: 'MongoDB Atlas' description: 'Step-by-step guide on how to set up MongoDB Atlas as a source for ClickPipes' slug: /integrations/clickpipes/mongodb/source/atlas title: 'MongoDB Atlas source setup guide' -doc_type: 'how-to' +doc_type: 'guide' --- import mongo_atlas_configuration from '@site/static/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-cluster-overview-configuration.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md b/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md index ba4ac7dc396..fdcae906f83 100644 --- a/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md +++ b/docs/integrations/data-ingestion/clickpipes/mongodb/source/generic.md @@ -3,7 +3,7 @@ sidebar_label: 'Generic MongoDB' description: 'Set up any MongoDB instance as a source for ClickPipes' slug: /integrations/clickpipes/mongodb/source/generic title: 'Generic MongoDB source setup guide' -doc_type: 'how-to' +doc_type: 'guide' --- # Generic MongoDB source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md b/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md index 074680aff99..d857f42671b 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/add_table.md @@ -4,7 +4,7 @@ description: 'Describes the steps need to add specific tables to a ClickPipe.' sidebar_label: 'Add Table' slug: /integrations/clickpipes/mysql/add_table show_title: false -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md b/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md index e1d887af4a7..887a8af43a7 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/controlling_sync.md @@ -3,7 +3,7 @@ title: 'Controlling the Syncing of a MySQL ClickPipe' description: 'Doc for controllling the sync a MySQL ClickPipe' slug: /integrations/clickpipes/mysql/sync_control sidebar_label: 'Controlling syncs' -doc_type: 'how-to' +doc_type: 'guide' --- import edit_sync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/faq.md b/docs/integrations/data-ingestion/clickpipes/mysql/faq.md index 64364dbb1ef..8a8e71d1596 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/faq.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/faq.md @@ -4,7 +4,7 @@ description: 'Frequently asked questions about ClickPipes for MySQL.' slug: /integrations/clickpipes/mysql/faq sidebar_position: 2 title: 'ClickPipes for MySQL FAQ' -doc_type: 'explanation' +doc_type: 'reference' --- # ClickPipes for MySQL FAQ diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/index.md b/docs/integrations/data-ingestion/clickpipes/mysql/index.md index f834c7547d7..62ca71ddc64 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/index.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/index.md @@ -3,7 +3,7 @@ sidebar_label: 'Ingesting Data from MySQL to ClickHouse' description: 'Describes how to seamlessly connect your MySQL to ClickHouse Cloud.' slug: /integrations/clickpipes/mysql title: 'Ingesting data from MySQL to ClickHouse (using CDC)' -doc_type: 'tutorial' +doc_type: 'guide' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md b/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md index 7f8265a970a..f189083d4ec 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/lifecycle.md @@ -3,7 +3,7 @@ sidebar_label: 'Lifecycle of a MySQL ClickPipe' description: 'Various pipe statuses and their meanings' slug: /integrations/clickpipes/mysql/lifecycle title: 'Lifecycle of a MySQL ClickPipe' -doc_type: 'reference' +doc_type: 'guide' --- # Lifecycle of a MySQL ClickPipe {#lifecycle} diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md b/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md index a462d033bfe..bb9ecf85976 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/parallel_initial_load.md @@ -3,7 +3,7 @@ title: 'Parallel Snapshot In The MySQL ClickPipe' description: 'Doc for explaining parallel snapshot in the MySQL ClickPipe' slug: /integrations/clickpipes/mysql/parallel_initial_load sidebar_label: 'How parallel snapshot works' -doc_type: 'explanation' +doc_type: 'guide' --- import snapshot_params from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/snapshot_params.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md b/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md index 3595ca7f232..71a858a8c72 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/pause_and_resume.md @@ -3,7 +3,7 @@ title: 'Pausing and Resuming a MySQL ClickPipe' description: 'Pausing and Resuming a MySQL ClickPipe' sidebar_label: 'Pause Table' slug: /integrations/clickpipes/mysql/pause_and_resume -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md b/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md index e9c94dcb005..5a25cb2c013 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/remove_table.md @@ -3,7 +3,7 @@ title: 'Removing specific tables from a ClickPipe' description: 'Removing specific tables from a ClickPipe' sidebar_label: 'Remove Table' slug: /integrations/clickpipes/mysql/removing_tables -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/resync.md b/docs/integrations/data-ingestion/clickpipes/mysql/resync.md index 64ff0593a00..41e19f5d2fc 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/resync.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/resync.md @@ -3,7 +3,7 @@ title: 'Resyncing a Database ClickPipe' description: 'Doc for resyncing a database ClickPipe' slug: /integrations/clickpipes/mysql/resync sidebar_label: 'Resync ClickPipe' -doc_type: 'how-to' +doc_type: 'guide' --- import resync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/resync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md index 85f15e05e48..9bed84338c7 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/aurora.md @@ -3,7 +3,7 @@ sidebar_label: 'Amazon Aurora MySQL' description: 'Step-by-step guide on how to set up Amazon Aurora MySQL as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/aurora title: 'Aurora MySQL source setup guide' -doc_type: 'tutorial' +doc_type: 'guide' --- import rds_backups from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md index 9ed47de0187..c93cd2b08a7 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/gcp.md @@ -3,7 +3,7 @@ sidebar_label: 'Cloud SQL For MySQL ' description: 'Step-by-step guide on how to set up Cloud SQL for MySQL as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/gcp title: 'Cloud SQL for MySQL source setup guide' -doc_type: 'how-to' +doc_type: 'guide' --- import gcp_pitr from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-pitr.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md index 847a6888893..a41d6c17521 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic.md @@ -3,7 +3,7 @@ sidebar_label: 'Generic MySQL' description: 'Set up any MySQL instance as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/generic title: 'Generic MySQL source setup guide' -doc_type: 'how-to' +doc_type: 'guide' --- # Generic MySQL source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md index 8d41c607b35..dbc58e79f29 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/generic_maria.md @@ -3,7 +3,7 @@ sidebar_label: 'Generic MariaDB' description: 'Set up any MariaDB instance as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/generic_maria title: 'Generic MariaDB source setup guide' -doc_type: 'how-to' +doc_type: 'guide' --- # Generic MariaDB source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md index 019e2cf7093..8e6da3bebb7 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds.md @@ -3,7 +3,7 @@ sidebar_label: 'Amazon RDS MySQL' description: 'Step-by-step guide on how to set up Amazon RDS MySQL as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/rds title: 'RDS MySQL source setup guide' -doc_type: 'how-to' +doc_type: 'guide' --- import rds_backups from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md index 60909a2e528..c88b0b9c373 100644 --- a/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md +++ b/docs/integrations/data-ingestion/clickpipes/mysql/source/rds_maria.md @@ -3,7 +3,7 @@ sidebar_label: 'Amazon RDS MariaDB' description: 'Step-by-step guide on how to set up Amazon RDS MariaDB as a source for ClickPipes' slug: /integrations/clickpipes/mysql/source/rds_maria title: 'RDS MariaDB source setup guide' -doc_type: 'how-to' +doc_type: 'guide' --- import rds_backups from '@site/static/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/object-storage.md b/docs/integrations/data-ingestion/clickpipes/object-storage.md index 187e6084297..70fc40d4e11 100644 --- a/docs/integrations/data-ingestion/clickpipes/object-storage.md +++ b/docs/integrations/data-ingestion/clickpipes/object-storage.md @@ -3,7 +3,7 @@ sidebar_label: 'ClickPipes for Object Storage' description: 'Seamlessly connect your object storage to ClickHouse Cloud.' slug: /integrations/clickpipes/object-storage title: 'Integrating Object Storage with ClickHouse Cloud' -doc_type: 'how-to' +doc_type: 'guide' --- import S3svg from '@site/static/images/integrations/logos/amazon_s3_logo.svg'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md b/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md index 7e11f10fa59..5f529f62e29 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/add_table.md @@ -4,7 +4,7 @@ description: 'Describes the steps need to add specific tables to a ClickPipe.' sidebar_label: 'Add Table' slug: /integrations/clickpipes/postgres/add_table show_title: false -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md b/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md index 8825f9e2dc1..28cf0be2ed0 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/controlling_sync.md @@ -3,7 +3,7 @@ title: 'Controlling the Syncing of a Postgres ClickPipe' description: 'Doc for controlling the sync a Postgres ClickPipe' slug: /integrations/clickpipes/postgres/sync_control sidebar_label: 'Controlling syncs' -doc_type: 'how-to' +doc_type: 'guide' --- import edit_sync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md b/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md index 409d23588e2..0fbcda76070 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/deduplication.md @@ -3,7 +3,7 @@ sidebar_label: 'Deduplication Strategies' description: 'Handle duplicates and deleted rows.' slug: /integrations/clickpipes/postgres/deduplication title: 'Deduplication strategies (using CDC)' -doc_type: 'tutorial' +doc_type: 'guide' --- import clickpipes_initial_load from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/postgres-cdc-initial-load.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/index.md b/docs/integrations/data-ingestion/clickpipes/postgres/index.md index d0fcc3a1e88..8c4af9ed75b 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/index.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/index.md @@ -3,7 +3,7 @@ sidebar_label: 'Ingesting Data from Postgres to ClickHouse' description: 'Seamlessly connect your Postgres to ClickHouse Cloud.' slug: /integrations/clickpipes/postgres title: 'Ingesting Data from Postgres to ClickHouse (using CDC)' -doc_type: 'tutorial' +doc_type: 'guide' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md b/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md index 1636ce90855..022e6f315b6 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/lifecycle.md @@ -3,7 +3,7 @@ sidebar_label: 'Lifecycle of a Postgres ClickPipe' description: 'Various pipe statuses and their meanings' slug: /integrations/clickpipes/postgres/lifecycle title: 'Lifecycle of a Postgres ClickPipe' -doc_type: 'reference' +doc_type: 'guide' --- # Lifecycle of a Postgres ClickPipe {#lifecycle} diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md b/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md index aff2b001fa1..f2c011a6eb6 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/ordering_keys.md @@ -3,7 +3,7 @@ sidebar_label: 'Ordering keys' description: 'How to define custom ordering keys.' slug: /integrations/clickpipes/postgres/ordering_keys title: 'Ordering Keys' -doc_type: 'how-to' +doc_type: 'guide' --- Ordering Keys (a.k.a. sorting keys) define how data is sorted on disk and indexed for a table in ClickHouse. When replicating from Postgres, ClickPipes sets the Postgres primary key of a table as the ordering key for the corresponding table in ClickHouse. In most cases, the Postgres primary key serves as a sufficient ordering key, as ClickHouse is already optimized for fast scans, and custom ordering keys are often not required. diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md b/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md index e66e6689f90..f3e47d11af0 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/parallel_initial_load.md @@ -3,7 +3,7 @@ title: 'Parallel Snapshot In The Postgres ClickPipe' description: 'Doc for explaining parallel snapshot in the Postgres ClickPipe' slug: /integrations/clickpipes/postgres/parallel_initial_load sidebar_label: 'How parallel snapshot works' -doc_type: 'explanation' +doc_type: 'guide' --- import snapshot_params from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/snapshot_params.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md b/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md index af613a3a53c..35d756ac22d 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/pause_and_resume.md @@ -3,7 +3,7 @@ title: 'Pausing and Resuming a Postgres ClickPipe' description: 'Pausing and Resuming a Postgres ClickPipe' sidebar_label: 'Pause Table' slug: /integrations/clickpipes/postgres/pause_and_resume -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md b/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md index 29d0e2fdb27..304f720b680 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/postgres_generated_columns.md @@ -2,7 +2,7 @@ title: 'Postgres Generated Columns: Gotchas and Best Practices' slug: /integrations/clickpipes/postgres/generated_columns description: 'Page describing important considerations to keep in mind when using PostgreSQL generated columns in tables that are being replicated' -doc_type: 'explanation' +doc_type: 'guide' --- When using PostgreSQL's generated columns in tables that are being replicated, there are some important considerations to keep in mind. These gotchas can affect the replication process and data consistency in your destination systems. diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md b/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md index 5323dfddf56..e63c0129739 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/remove_table.md @@ -3,7 +3,7 @@ title: 'Removing specific tables from a ClickPipe' description: 'Removing specific tables from a ClickPipe' sidebar_label: 'Remove Table' slug: /integrations/clickpipes/postgres/removing_tables -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/resync.md b/docs/integrations/data-ingestion/clickpipes/postgres/resync.md index 2bf5e5185ac..467cdd1a90c 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/resync.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/resync.md @@ -3,7 +3,7 @@ title: 'Resyncing a Database ClickPipe' description: 'Doc for resyncing a database ClickPipe' slug: /integrations/clickpipes/postgres/resync sidebar_label: 'Resync ClickPipe' -doc_type: 'how-to' +doc_type: 'guide' --- import resync_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/resync_button.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md b/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md index edfa95f3220..28f1e90840e 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/scaling.md @@ -3,7 +3,7 @@ title: 'Scaling DB ClickPipes via OpenAPI' description: 'Doc for scaling DB ClickPipes via OpenAPI' slug: /integrations/clickpipes/postgres/scaling sidebar_label: 'Scaling' -doc_type: 'how-to' +doc_type: 'guide' --- :::caution Most users won't need this API diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md index 976d8ad7c2e..a1239c5f25c 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/aurora.md @@ -3,7 +3,7 @@ sidebar_label: 'Amazon Aurora Postgres' description: 'Set up Amazon Aurora Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/aurora title: 'Aurora Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import parameter_group_in_blade from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/rds/parameter_group_in_blade.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md index 119295463a2..d31d1918cd2 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres.md @@ -3,7 +3,7 @@ sidebar_label: 'Azure Flexible Server for Postgres' description: 'Set up Azure Flexible Server for Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/azure-flexible-server-postgres title: 'Azure Flexible Server for Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import server_parameters from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/azure-flexible-server-postgres/server_parameters.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md index 5c5c5fba649..f6257840826 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/crunchy-postgres.md @@ -3,7 +3,7 @@ sidebar_label: 'Crunchy Bridge Postgres' description: 'Set up Crunchy Bridge Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/crunchy-postgres title: 'Crunchy Bridge Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import firewall_rules_crunchy_bridge from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/setup/crunchy-postgres/firewall_rules_crunchy_bridge.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md index 090deb556bb..012be5b41ed 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/generic.md @@ -3,7 +3,7 @@ sidebar_label: 'Generic Postgres' description: 'Set up any Postgres instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/generic title: 'Generic Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- # Generic Postgres source setup guide diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md index 20d0d25fa82..b6b2f24e236 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql.md @@ -3,7 +3,7 @@ sidebar_label: 'Google Cloud SQL' description: 'Set up Google Cloud SQL Postgres instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/google-cloudsql title: 'Google Cloud SQL Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import edit_button from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/google-cloudsql/edit.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md index c63b75c66dc..e53919c06c0 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/neon-postgres.md @@ -3,7 +3,7 @@ sidebar_label: 'Neon Postgres' description: 'Set up Neon Postgres instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/neon-postgres title: 'Neon Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import neon_commands from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-commands.png' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md index 70ca4a13048..4bd4ffa4503 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/planetscale.md @@ -3,7 +3,7 @@ sidebar_label: 'Planetscale for Postgres' description: 'Set up Planetscale for Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/planetscale title: 'PlanetScale for Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import planetscale_wal_level_logical from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/planetscale/planetscale_wal_level_logical.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md index 65d46a06283..5adab8fb5a6 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/rds.md @@ -3,7 +3,7 @@ sidebar_label: 'Amazon RDS Postgres' description: 'Set up Amazon RDS Postgres as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/rds title: 'RDS Postgres Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import parameter_group_in_blade from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/rds/parameter_group_in_blade.png'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md index 5f45df02274..4148f2ea6c0 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/supabase.md @@ -3,7 +3,7 @@ sidebar_label: 'Supabase Postgres' description: 'Set up Supabase instance as a source for ClickPipes' slug: /integrations/clickpipes/postgres/source/supabase title: 'Supabase Source Setup Guide' -doc_type: 'how-to' +doc_type: 'guide' --- import supabase_commands from '@site/static/images/integrations/data-ingestion/clickpipes/postgres/source/setup/supabase/supabase-commands.jpg' diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md b/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md index 06e9f57db8e..aa6d675b468 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/source/timescale.md @@ -4,7 +4,7 @@ description: 'Set up Postgres with the TimescaleDB extension as a source for Cli slug: /integrations/clickpipes/postgres/source/timescale title: 'Postgres with TimescaleDB source setup guide' keywords: ['TimescaleDB'] -doc_type: 'how-to' +doc_type: 'guide' --- import BetaBadge from '@theme/badges/BetaBadge'; diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md b/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md index b6520a4a78e..74e777a3c0d 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/table_resync.md @@ -3,7 +3,7 @@ title: 'Resyncing Specific Tables' description: 'Resyncing specific tables in a Postgres ClickPipe' slug: /integrations/clickpipes/postgres/table_resync sidebar_label: 'Resync Table' -doc_type: 'how-to' +doc_type: 'guide' --- # Resyncing specific tables {#resync-tables} diff --git a/docs/integrations/data-ingestion/clickpipes/postgres/toast.md b/docs/integrations/data-ingestion/clickpipes/postgres/toast.md index 8bfb75ea96a..49860298a40 100644 --- a/docs/integrations/data-ingestion/clickpipes/postgres/toast.md +++ b/docs/integrations/data-ingestion/clickpipes/postgres/toast.md @@ -2,7 +2,7 @@ title: 'Handling TOAST Columns' description: 'Learn how to handle TOAST columns when replicating data from PostgreSQL to ClickHouse.' slug: /integrations/clickpipes/postgres/toast -doc_type: 'how-to' +doc_type: 'guide' --- When replicating data from PostgreSQL to ClickHouse, it's important to understand the limitations and special considerations for TOAST (The Oversized-Attribute Storage Technique) columns. This guide will help you identify and properly handle TOAST columns in your replication process. diff --git a/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md b/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md index 8274573e98e..2e6426e2cd5 100644 --- a/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md +++ b/docs/integrations/data-ingestion/clickpipes/secure-kinesis.md @@ -3,7 +3,7 @@ slug: /integrations/clickpipes/secure-kinesis sidebar_label: 'Kinesis Role-Based Access' title: 'Kinesis Role-Based Access' description: 'This article demonstrates how ClickPipes customers can leverage role-based access to authenticate with Amazon Kinesis and access their data streams securely.' -doc_type: 'how-to' +doc_type: 'guide' --- import secure_kinesis from '@site/static/images/integrations/data-ingestion/clickpipes/securekinesis.jpg'; diff --git a/docs/integrations/data-ingestion/clickpipes/secure-rds.md b/docs/integrations/data-ingestion/clickpipes/secure-rds.md index c408cac068a..5d11f64571f 100644 --- a/docs/integrations/data-ingestion/clickpipes/secure-rds.md +++ b/docs/integrations/data-ingestion/clickpipes/secure-rds.md @@ -3,7 +3,7 @@ slug: /integrations/clickpipes/secure-rds sidebar_label: 'AWS IAM DB Authentication (RDS/Aurora)' title: 'AWS IAM DB Authentication (RDS/Aurora)' description: 'This article demonstrates how ClickPipes customers can leverage role-based access to authenticate with Amazon RDS/Aurora and access their database securely.' -doc_type: 'how-to' +doc_type: 'guide' --- import secures3_arn from '@site/static/images/cloud/security/secures3_arn.png'; diff --git a/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md b/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md index 9fe374424ff..86c333d4d83 100644 --- a/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md +++ b/docs/integrations/data-ingestion/data-formats/arrow-avro-orc.md @@ -4,7 +4,7 @@ sidebar_position: 5 slug: /integrations/data-formats/arrow-avro-orc title: 'Working with Avro, Arrow, and ORC data in ClickHouse' description: 'Page describing how to work with Avro, Arrow and ORC data in ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- # Working with Avro, Arrow, and ORC data in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/binary.md b/docs/integrations/data-ingestion/data-formats/binary.md index 7377ed201e1..e720dbce392 100644 --- a/docs/integrations/data-ingestion/data-formats/binary.md +++ b/docs/integrations/data-ingestion/data-formats/binary.md @@ -3,7 +3,7 @@ sidebar_label: 'Binary and Native' slug: /integrations/data-formats/binary-native title: 'Using native and binary formats in ClickHouse' description: 'Page describing how to use native and binary formats in ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/data-formats/csv-tsv.md b/docs/integrations/data-ingestion/data-formats/csv-tsv.md index bb707412c96..c7b49429ee3 100644 --- a/docs/integrations/data-ingestion/data-formats/csv-tsv.md +++ b/docs/integrations/data-ingestion/data-formats/csv-tsv.md @@ -3,7 +3,7 @@ sidebar_label: 'CSV and TSV' slug: /integrations/data-formats/csv-tsv title: 'Working with CSV and TSV data in ClickHouse' description: 'Page describing how to work with CSV and TSV data in ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- # Working with CSV and TSV data in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/intro.md b/docs/integrations/data-ingestion/data-formats/intro.md index 2ef4174c890..cc1ce5472d0 100644 --- a/docs/integrations/data-ingestion/data-formats/intro.md +++ b/docs/integrations/data-ingestion/data-formats/intro.md @@ -6,7 +6,7 @@ keywords: ['clickhouse', 'CSV', 'TSV', 'Parquet', 'clickhouse-client', 'clickhou title: 'Importing from various data formats to ClickHouse' description: 'Page describing how to import various data formats into ClickHouse' show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # Importing from various data formats to ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/json/exporting.md b/docs/integrations/data-ingestion/data-formats/json/exporting.md index 98fde15c3e7..a1e1627f5be 100644 --- a/docs/integrations/data-ingestion/data-formats/json/exporting.md +++ b/docs/integrations/data-ingestion/data-formats/json/exporting.md @@ -3,7 +3,7 @@ title: 'Exporting JSON' slug: /integrations/data-formats/json/exporting description: 'How to export JSON data from ClickHouse' keywords: ['json', 'clickhouse', 'formats', 'exporting'] -doc_type: 'how-to' +doc_type: 'guide' --- # Exporting JSON diff --git a/docs/integrations/data-ingestion/data-formats/json/formats.md b/docs/integrations/data-ingestion/data-formats/json/formats.md index 598a3fe6cc0..805087e7b24 100644 --- a/docs/integrations/data-ingestion/data-formats/json/formats.md +++ b/docs/integrations/data-ingestion/data-formats/json/formats.md @@ -4,7 +4,7 @@ slug: /integrations/data-formats/json/other-formats description: 'Handling other JSON formats' sidebar_label: 'Handling other formats' keywords: ['json', 'formats', 'json formats'] -doc_type: 'reference' +doc_type: 'guide' --- # Handling other JSON formats diff --git a/docs/integrations/data-ingestion/data-formats/json/inference.md b/docs/integrations/data-ingestion/data-formats/json/inference.md index 74e79f1c2ab..4a5dbe6e5a9 100644 --- a/docs/integrations/data-ingestion/data-formats/json/inference.md +++ b/docs/integrations/data-ingestion/data-formats/json/inference.md @@ -3,7 +3,7 @@ title: 'JSON schema inference' slug: /integrations/data-formats/json/inference description: 'How to use JSON schema inference' keywords: ['json', 'schema', 'inference', 'schema inference'] -doc_type: 'reference' +doc_type: 'guide' --- ClickHouse can automatically determine the structure of JSON data. This can be used to query JSON data directly e.g. on disk with `clickhouse-local` or S3 buckets, and/or automatically create schemas prior to loading the data into ClickHouse. diff --git a/docs/integrations/data-ingestion/data-formats/json/intro.md b/docs/integrations/data-ingestion/data-formats/json/intro.md index b7d288d4060..0e1e4ece5fa 100644 --- a/docs/integrations/data-ingestion/data-formats/json/intro.md +++ b/docs/integrations/data-ingestion/data-formats/json/intro.md @@ -6,7 +6,7 @@ slug: /integrations/data-formats/json/overview description: 'Working with JSON in ClickHouse' keywords: ['json', 'clickhouse'] score: 10 -doc_type: 'how-to' +doc_type: 'guide' --- # JSON Overview diff --git a/docs/integrations/data-ingestion/data-formats/json/loading.md b/docs/integrations/data-ingestion/data-formats/json/loading.md index d19f20da9b9..25aa01cf6a2 100644 --- a/docs/integrations/data-ingestion/data-formats/json/loading.md +++ b/docs/integrations/data-ingestion/data-formats/json/loading.md @@ -6,7 +6,7 @@ slug: /integrations/data-formats/json/loading description: 'Loading JSON' keywords: ['json', 'clickhouse', 'inserting', 'loading', 'inserting'] score: 15 -doc_type: 'tutorial' +doc_type: 'guide' --- # Loading JSON {#loading-json} diff --git a/docs/integrations/data-ingestion/data-formats/json/other.md b/docs/integrations/data-ingestion/data-formats/json/other.md index 2c4f1e20b22..54c8f661857 100644 --- a/docs/integrations/data-ingestion/data-formats/json/other.md +++ b/docs/integrations/data-ingestion/data-formats/json/other.md @@ -3,7 +3,7 @@ title: 'Other JSON approaches' slug: /integrations/data-formats/json/other-approaches description: 'Other approaches to modeling JSON' keywords: ['json', 'formats'] -doc_type: 'explanation' +doc_type: 'reference' --- # Other approaches to modeling JSON diff --git a/docs/integrations/data-ingestion/data-formats/json/schema.md b/docs/integrations/data-ingestion/data-formats/json/schema.md index 74488afe75f..d2737daf9b2 100644 --- a/docs/integrations/data-ingestion/data-formats/json/schema.md +++ b/docs/integrations/data-ingestion/data-formats/json/schema.md @@ -4,7 +4,7 @@ slug: /integrations/data-formats/json/schema description: 'How to optimally design JSON schemas' keywords: ['json', 'clickhouse', 'inserting', 'loading', 'formats', 'schema', 'structured', 'semi-structured'] score: 20 -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/data-formats/parquet.md b/docs/integrations/data-ingestion/data-formats/parquet.md index af120ba9b8a..b4fdc91b32f 100644 --- a/docs/integrations/data-ingestion/data-formats/parquet.md +++ b/docs/integrations/data-ingestion/data-formats/parquet.md @@ -4,7 +4,7 @@ sidebar_position: 3 slug: /integrations/data-formats/parquet title: 'Working with Parquet in ClickHouse' description: 'Page describing how to work with Parquet in ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- # Working with Parquet in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/sql.md b/docs/integrations/data-ingestion/data-formats/sql.md index 4e76f93981d..038196ea3bb 100644 --- a/docs/integrations/data-ingestion/data-formats/sql.md +++ b/docs/integrations/data-ingestion/data-formats/sql.md @@ -3,7 +3,7 @@ sidebar_label: 'SQL Dumps' slug: /integrations/data-formats/sql title: 'Inserting and dumping SQL data in ClickHouse' description: 'Page describing how to transfer data between other databases and ClickHouse using SQL dumps.' -doc_type: 'how-to' +doc_type: 'guide' --- # Inserting and dumping SQL data in ClickHouse diff --git a/docs/integrations/data-ingestion/data-formats/templates-regex.md b/docs/integrations/data-ingestion/data-formats/templates-regex.md index ec95e0a78b2..4a9a6a8d522 100644 --- a/docs/integrations/data-ingestion/data-formats/templates-regex.md +++ b/docs/integrations/data-ingestion/data-formats/templates-regex.md @@ -4,7 +4,7 @@ sidebar_position: 3 slug: /integrations/data-formats/templates-regexp title: 'Importing and exporting custom text data using Templates and Regex in ClickHouse' description: 'Page describing how to import and export custom text using templates and regex in ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- # Importing and exporting custom text data using Templates and Regex in ClickHouse diff --git a/docs/integrations/data-ingestion/data-ingestion-index.md b/docs/integrations/data-ingestion/data-ingestion-index.md index 28f91086d9d..fbdfeaf6bc1 100644 --- a/docs/integrations/data-ingestion/data-ingestion-index.md +++ b/docs/integrations/data-ingestion/data-ingestion-index.md @@ -3,7 +3,7 @@ slug: /integrations/data-ingestion-overview keywords: [ 'Airbyte', 'Apache Spark', 'Spark', 'Azure Synapse', 'Amazon Glue', 'Apache Beam', 'dbt', 'Fivetran', 'NiFi', 'dlt', 'Vector' ] title: 'Data Ingestion' description: 'Landing page for the data ingestion section' -doc_type: 'reference' +doc_type: 'landing-page' --- # Data Ingestion diff --git a/docs/integrations/data-ingestion/data-sources-index.md b/docs/integrations/data-ingestion/data-sources-index.md index 69e9d38aac3..b7cd897f61f 100644 --- a/docs/integrations/data-ingestion/data-sources-index.md +++ b/docs/integrations/data-ingestion/data-sources-index.md @@ -3,7 +3,7 @@ slug: /integrations/data-sources/index keywords: ['AWS S3', 'Azure Data Factory', 'PostgreSQL', 'Kafka', 'MySQL', 'Cassandra', 'Data Factory', 'Redis', 'RabbitMQ', 'MongoDB', 'Google Cloud Storage', 'Hive', 'Hudi', 'Iceberg', 'MinIO', 'Delta Lake', 'RocksDB', 'Splunk', 'SQLite', 'NATS', 'EMQX', 'local files', 'JDBC', 'ODBC'] description: 'Datasources overview page' title: 'Data Sources' -doc_type: 'reference' +doc_type: 'landing-page' --- # Data sources diff --git a/docs/integrations/data-ingestion/dbms/dynamodb/index.md b/docs/integrations/data-ingestion/dbms/dynamodb/index.md index 32d229dc096..13baeda5b54 100644 --- a/docs/integrations/data-ingestion/dbms/dynamodb/index.md +++ b/docs/integrations/data-ingestion/dbms/dynamodb/index.md @@ -6,7 +6,7 @@ description: 'ClickPipes allows you to connect ClickHouse to DynamoDB.' keywords: ['DynamoDB'] title: 'CDC from DynamoDB to ClickHouse' show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md b/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md index 4da23bdc435..44aa7c183f9 100644 --- a/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md +++ b/docs/integrations/data-ingestion/dbms/jdbc-with-clickhouse.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'jdbc', 'connect', 'integrate'] slug: /integrations/jdbc/jdbc-with-clickhouse description: 'The ClickHouse JDBC Bridge allows ClickHouse to access data from any external data source for which a JDBC driver is available' title: 'Connecting ClickHouse to external data sources with JDBC' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/dbms/mysql/index.md b/docs/integrations/data-ingestion/dbms/mysql/index.md index 14a961536a6..88f54ace244 100644 --- a/docs/integrations/data-ingestion/dbms/mysql/index.md +++ b/docs/integrations/data-ingestion/dbms/mysql/index.md @@ -6,7 +6,7 @@ description: 'The MySQL table engine allows you to connect ClickHouse to MySQL.' keywords: ['mysql'] title: 'Integrating MySQL with ClickHouse' show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md b/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md index 530a110346d..c89664195bb 100644 --- a/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md +++ b/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md @@ -4,7 +4,7 @@ title: 'Connecting to PostgreSQL' keywords: ['clickhouse', 'postgres', 'postgresql', 'connect', 'integrate', 'table', 'engine'] description: 'Page describing the various ways to connect PostgreSQL to ClickHouse' show_related_blogs: true -doc_type: 'explanation' +doc_type: 'guide' --- import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge'; diff --git a/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md b/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md index 40bd9dfc858..2348f729917 100644 --- a/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md +++ b/docs/integrations/data-ingestion/dbms/postgresql/inserting-data.md @@ -3,7 +3,7 @@ slug: /integrations/postgresql/inserting-data title: 'How to insert data from PostgreSQL' keywords: ['postgres', 'postgresql', 'inserts'] description: 'Page describing how to insert data from PostgresSQL using ClickPipes, PeerDB or the Postgres table function' -doc_type: 'how-to' +doc_type: 'guide' --- We recommend reading [this guide](/guides/inserting-data) to learn best practices on inserting data to ClickHouse to optimize for insert performance. diff --git a/docs/integrations/data-ingestion/emqx/index.md b/docs/integrations/data-ingestion/emqx/index.md index 2a3a1033924..288fa1f4b3d 100644 --- a/docs/integrations/data-ingestion/emqx/index.md +++ b/docs/integrations/data-ingestion/emqx/index.md @@ -4,7 +4,7 @@ sidebar_position: 1 slug: /integrations/emqx description: 'Introduction to EMQX with ClickHouse' title: 'Integrating EMQX with ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- import emqx_cloud_artitecture from '@site/static/images/integrations/data-ingestion/emqx/emqx-cloud-artitecture.png'; diff --git a/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md index 659c6b68db2..1a6c82db2e4 100644 --- a/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/airbyte-and-clickhouse.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'Airbyte', 'connect', 'integrate', 'etl', 'data integra slug: /integrations/airbyte description: 'Stream data into ClickHouse using Airbyte data pipelines' title: 'Connect Airbyte to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/etl-tools/apache-beam.md b/docs/integrations/data-ingestion/etl-tools/apache-beam.md index 7b5887757cd..5139529cb01 100644 --- a/docs/integrations/data-ingestion/etl-tools/apache-beam.md +++ b/docs/integrations/data-ingestion/etl-tools/apache-beam.md @@ -3,7 +3,7 @@ sidebar_label: 'Apache Beam' slug: /integrations/apache-beam description: 'Users can ingest data into ClickHouse using Apache Beam' title: 'Integrating Apache Beam and ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md index 1e86d6b4a83..d552e50561b 100644 --- a/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/bladepipe-and-clickhouse.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'BladePipe', 'connect', 'integrate', 'cdc', 'etl', 'dat slug: /integrations/bladepipe description: 'Stream data into ClickHouse using BladePipe data pipelines' title: 'Connect BladePipe to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/etl-tools/dbt/index.md b/docs/integrations/data-ingestion/etl-tools/dbt/index.md index 0a64ca85610..9d9ac698341 100644 --- a/docs/integrations/data-ingestion/etl-tools/dbt/index.md +++ b/docs/integrations/data-ingestion/etl-tools/dbt/index.md @@ -4,7 +4,7 @@ slug: /integrations/dbt sidebar_position: 1 description: 'Users can transform and model their data in ClickHouse using dbt' title: 'Integrating dbt and ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md index 82c42c8e04d..566c36bd5ef 100644 --- a/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/dlt-and-clickhouse.md @@ -4,7 +4,7 @@ keywords: ['clickhouse', 'dlt', 'connect', 'integrate', 'etl', 'data integration description: 'Load data into Clickhouse using dlt integration' title: 'Connect dlt to ClickHouse' slug: /integrations/data-ingestion/etl-tools/dlt-and-clickhouse -doc_type: 'how-to' +doc_type: 'guide' --- import CommunityMaintainedBadge from '@theme/badges/CommunityMaintained'; diff --git a/docs/integrations/data-ingestion/etl-tools/fivetran/index.md b/docs/integrations/data-ingestion/etl-tools/fivetran/index.md index 9528c9cbb08..400ea3a9fd1 100644 --- a/docs/integrations/data-ingestion/etl-tools/fivetran/index.md +++ b/docs/integrations/data-ingestion/etl-tools/fivetran/index.md @@ -4,7 +4,7 @@ slug: /integrations/fivetran sidebar_position: 2 description: 'Users can transform and model their data in ClickHouse using dbt' title: 'Fivetran and ClickHouse Cloud' -doc_type: 'reference' +doc_type: 'guide' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md index 429dc1fd050..6678c164539 100644 --- a/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/nifi-and-clickhouse.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'NiFi', 'connect', 'integrate', 'etl', 'data integratio slug: /integrations/nifi description: 'Stream data into ClickHouse using NiFi data pipelines' title: 'Connect Apache NiFi to ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md b/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md index 805085a432b..dc5c36aef08 100644 --- a/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md +++ b/docs/integrations/data-ingestion/etl-tools/vector-to-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/vector description: 'How to tail a log file into ClickHouse using Vector' title: 'Integrating Vector with ClickHouse' show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/gcs/index.md b/docs/integrations/data-ingestion/gcs/index.md index f8dfebc30d2..ee640dc9a6e 100644 --- a/docs/integrations/data-ingestion/gcs/index.md +++ b/docs/integrations/data-ingestion/gcs/index.md @@ -4,7 +4,7 @@ sidebar_position: 4 slug: /integrations/gcs description: 'Google Cloud Storage (GCS) Backed MergeTree' title: 'Integrate Google Cloud Storage with ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- import BucketDetails from '@site/docs/_snippets/_GCS_authentication_and_bucket.md'; diff --git a/docs/integrations/data-ingestion/google-dataflow/dataflow.md b/docs/integrations/data-ingestion/google-dataflow/dataflow.md index baef7e33eff..d0560a44a85 100644 --- a/docs/integrations/data-ingestion/google-dataflow/dataflow.md +++ b/docs/integrations/data-ingestion/google-dataflow/dataflow.md @@ -4,7 +4,7 @@ slug: /integrations/google-dataflow/dataflow sidebar_position: 1 description: 'Users can ingest data into ClickHouse using Google Dataflow' title: 'Integrating Google Dataflow with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/google-dataflow/java-runner.md b/docs/integrations/data-ingestion/google-dataflow/java-runner.md index 42997b5195f..4f4384c8bd2 100644 --- a/docs/integrations/data-ingestion/google-dataflow/java-runner.md +++ b/docs/integrations/data-ingestion/google-dataflow/java-runner.md @@ -4,7 +4,7 @@ slug: /integrations/google-dataflow/java-runner sidebar_position: 2 description: 'Users can ingest data into ClickHouse using Google Dataflow Java Runner' title: 'Dataflow Java Runner' -doc_type: 'how-to' +doc_type: 'guide' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/google-dataflow/templates.md b/docs/integrations/data-ingestion/google-dataflow/templates.md index 3436325d3d0..7577e81793f 100644 --- a/docs/integrations/data-ingestion/google-dataflow/templates.md +++ b/docs/integrations/data-ingestion/google-dataflow/templates.md @@ -4,7 +4,7 @@ slug: /integrations/google-dataflow/templates sidebar_position: 3 description: 'Users can ingest data into ClickHouse using Google Dataflow Templates' title: 'Google Dataflow Templates' -doc_type: 'reference' +doc_type: 'guide' --- import ClickHouseSupportedBadge from '@theme/badges/ClickHouseSupported'; diff --git a/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md b/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md index e7193a65988..f425206de0d 100644 --- a/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md +++ b/docs/integrations/data-ingestion/google-dataflow/templates/bigquery-to-clickhouse.md @@ -4,7 +4,7 @@ sidebar_position: 1 slug: /integrations/google-dataflow/templates/bigquery-to-clickhouse description: 'Users can ingest data from BigQuery into ClickHouse using Google Dataflow Template' title: 'Dataflow BigQuery to ClickHouse template' -doc_type: 'reference' +doc_type: 'guide' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-ingestion/insert-local-files.md b/docs/integrations/data-ingestion/insert-local-files.md index 6b42723c675..2c75929d32c 100644 --- a/docs/integrations/data-ingestion/insert-local-files.md +++ b/docs/integrations/data-ingestion/insert-local-files.md @@ -5,7 +5,7 @@ title: 'Insert Local Files' slug: /integrations/data-ingestion/insert-local-files description: 'Learn about Insert Local Files' show_related_blogs: true -doc_type: 'explanation' +doc_type: 'guide' --- # Insert local files diff --git a/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md b/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md index 5bbcc2eb748..8855215ceba 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md +++ b/docs/integrations/data-ingestion/kafka/confluent/confluent-cloud.md @@ -5,7 +5,7 @@ slug: /integrations/kafka/cloud/confluent/sink-connector description: 'Guide to using the fully managed ClickHouse Connector Sinkon Confluent Cloud' title: 'Integrating Confluent Cloud with ClickHouse' keywords: ['Kafka', 'Confluent Cloud'] -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md b/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md index 666a1b0067d..9225c8e16e9 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md +++ b/docs/integrations/data-ingestion/kafka/confluent/custom-connector.md @@ -4,7 +4,7 @@ sidebar_position: 3 slug: /integrations/kafka/cloud/confluent/custom-connector description: 'Using ClickHouse Connector Sink with Kafka Connect and ClickHouse' title: 'Integrating Confluent Cloud with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/confluent/index.md b/docs/integrations/data-ingestion/kafka/confluent/index.md index 5800d45ee68..55aa538e451 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/index.md +++ b/docs/integrations/data-ingestion/kafka/confluent/index.md @@ -4,7 +4,7 @@ sidebar_position: 1 slug: /integrations/kafka/cloud/confluent description: 'Kafka Connectivity with Confluent Cloud' title: 'Integrating Confluent Cloud with ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- # Integrating Confluent Cloud with ClickHouse diff --git a/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md b/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md index f72ec7759b6..27b9fe6a745 100644 --- a/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md +++ b/docs/integrations/data-ingestion/kafka/confluent/kafka-connect-http.md @@ -4,7 +4,7 @@ sidebar_position: 4 slug: /integrations/kafka/cloud/confluent/http description: 'Using HTTP Connector Sink with Kafka Connect and ClickHouse' title: 'Confluent HTTP Sink Connector' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/index.md b/docs/integrations/data-ingestion/kafka/index.md index 36b20169c5f..ae7e41ee7fc 100644 --- a/docs/integrations/data-ingestion/kafka/index.md +++ b/docs/integrations/data-ingestion/kafka/index.md @@ -4,7 +4,7 @@ sidebar_position: 1 slug: /integrations/kafka description: 'Introduction to Kafka with ClickHouse' title: 'Integrating Kafka with ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- # Integrating Kafka with ClickHouse diff --git a/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md b/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md index 1b81b045769..cd2b3399f61 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md +++ b/docs/integrations/data-ingestion/kafka/kafka-clickhouse-connect-sink.md @@ -4,7 +4,7 @@ sidebar_position: 2 slug: /integrations/kafka/clickhouse-kafka-connect-sink description: 'The official Kafka connector from ClickHouse.' title: 'ClickHouse Kafka Connect Sink' -doc_type: 'reference' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md b/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md index 752f0160d39..194375d2289 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md +++ b/docs/integrations/data-ingestion/kafka/kafka-connect-jdbc.md @@ -4,7 +4,7 @@ sidebar_position: 4 slug: /integrations/kafka/kafka-connect-jdbc description: 'Using JDBC Connector Sink with Kafka Connect and ClickHouse' title: 'JDBC Connector' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md b/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md index c8eeec08a8a..6b25bb2f135 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md +++ b/docs/integrations/data-ingestion/kafka/kafka-table-engine-named-collections.md @@ -3,7 +3,7 @@ title: 'Integrating ClickHouse with Kafka using Named Collections' description: 'How to use named collections to connect clickhouse to kafka' keywords: ['named collection', 'how to', 'kafka'] slug: /integrations/data-ingestion/kafka/kafka-table-engine-named-collections -doc_type: 'how-to' +doc_type: 'guide' --- # Integrating ClickHouse with Kafka using named collections diff --git a/docs/integrations/data-ingestion/kafka/kafka-table-engine.md b/docs/integrations/data-ingestion/kafka/kafka-table-engine.md index 8cdacec6990..b27b4191ee4 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-table-engine.md +++ b/docs/integrations/data-ingestion/kafka/kafka-table-engine.md @@ -4,7 +4,7 @@ sidebar_position: 5 slug: /integrations/kafka/kafka-table-engine description: 'Using the Kafka Table Engine' title: 'Using the Kafka table engine' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-ingestion/kafka/kafka-vector.md b/docs/integrations/data-ingestion/kafka/kafka-vector.md index 43ee5106af2..32ec1cf2a97 100644 --- a/docs/integrations/data-ingestion/kafka/kafka-vector.md +++ b/docs/integrations/data-ingestion/kafka/kafka-vector.md @@ -4,7 +4,7 @@ sidebar_position: 3 slug: /integrations/kafka/kafka-vector description: 'Using Vector with Kafka and ClickHouse' title: 'Using Vector with Kafka and ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/kafka/msk/index.md b/docs/integrations/data-ingestion/kafka/msk/index.md index ad1f3f9cca4..825e974a213 100644 --- a/docs/integrations/data-ingestion/kafka/msk/index.md +++ b/docs/integrations/data-ingestion/kafka/msk/index.md @@ -5,7 +5,7 @@ slug: /integrations/kafka/cloud/amazon-msk/ description: 'The official Kafka connector from ClickHouse with Amazon MSK' keywords: ['integration', 'kafka', 'amazon msk', 'sink', 'connector'] title: 'Integrating Amazon MSK with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-ingestion/redshift/index.md b/docs/integrations/data-ingestion/redshift/index.md index 01ff878f2e7..a44d9e30f48 100644 --- a/docs/integrations/data-ingestion/redshift/index.md +++ b/docs/integrations/data-ingestion/redshift/index.md @@ -5,7 +5,7 @@ description: 'Migrating Data from Redshift to ClickHouse' title: 'Migrating data from Redshift to ClickHouse' keywords: ['Redshift'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import redshiftToClickhouse from '@site/static/images/integrations/data-ingestion/redshift/redshift-to-clickhouse.png'; diff --git a/docs/integrations/data-ingestion/s3-minio.md b/docs/integrations/data-ingestion/s3-minio.md index 9c1ce208547..ee1e05bfe89 100644 --- a/docs/integrations/data-ingestion/s3-minio.md +++ b/docs/integrations/data-ingestion/s3-minio.md @@ -4,7 +4,7 @@ sidebar_position: 6 slug: /integrations/minio description: 'Page describing how to use MinIO with ClickHouse' title: 'Using MinIO' -doc_type: 'how-to' +doc_type: 'guide' --- # Using MinIO diff --git a/docs/integrations/data-ingestion/s3/index.md b/docs/integrations/data-ingestion/s3/index.md index fb15f597281..9a7cd275da8 100644 --- a/docs/integrations/data-ingestion/s3/index.md +++ b/docs/integrations/data-ingestion/s3/index.md @@ -4,7 +4,7 @@ sidebar_position: 1 sidebar_label: 'Integrating S3 with ClickHouse' title: 'Integrating S3 with ClickHouse' description: 'Page describing how to integrate S3 with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import BucketDetails from '@site/docs/_snippets/_S3_authentication_and_bucket.md'; diff --git a/docs/integrations/data-ingestion/s3/performance.md b/docs/integrations/data-ingestion/s3/performance.md index 36854033f94..eaf9ea3bcef 100644 --- a/docs/integrations/data-ingestion/s3/performance.md +++ b/docs/integrations/data-ingestion/s3/performance.md @@ -4,7 +4,7 @@ sidebar_position: 2 sidebar_label: 'Optimizing for Performance' title: 'Optimizing for S3 Insert and Read Performance' description: 'Optimizing the performance of S3 read and insert' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-sources/iceberg.md b/docs/integrations/data-sources/iceberg.md index 07755e57bc2..3debb02cf81 100644 --- a/docs/integrations/data-sources/iceberg.md +++ b/docs/integrations/data-sources/iceberg.md @@ -3,7 +3,7 @@ slug: /integrations/iceberg sidebar_label: 'Iceberg' title: 'Iceberg' description: 'Page describing the IcebergFunction which can be used to integrate ClickHouse with the Iceberg table format' -doc_type: 'reference' +doc_type: 'guide' --- import IcebergFunction from '@site/docs/sql-reference/table-functions/iceberg.md'; diff --git a/docs/integrations/data-sources/postgres.md b/docs/integrations/data-sources/postgres.md index 3acb8f9ceb0..6acb1d4a5fc 100644 --- a/docs/integrations/data-sources/postgres.md +++ b/docs/integrations/data-sources/postgres.md @@ -4,7 +4,7 @@ sidebar_label: 'PostgreSQL' title: 'PostgreSQL' hide_title: false description: 'Page describing how to integrate Postgres with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import PostgreSQL from '@site/docs/integrations/data-ingestion/dbms/postgresql/connecting-to-postgresql.md'; diff --git a/docs/integrations/data-visualization/astrato-and-clickhouse.md b/docs/integrations/data-visualization/astrato-and-clickhouse.md index 41fc2c60d58..2900a48daad 100644 --- a/docs/integrations/data-visualization/astrato-and-clickhouse.md +++ b/docs/integrations/data-visualization/astrato-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/astrato keywords: ['clickhouse', 'Power BI', 'connect', 'integrate', 'ui', 'data apps', 'data viz', 'embedded analytics', 'Astrato'] description: 'Astrato brings true Self-Service BI to Enterprises & Data Businesses by putting analytics in the hands of every user, enabling them to build their own dashboards, reports and data apps, enabling the answering of data questions without IT help. Astrato accelerates adoption, speeds up decision-making, and unifies analytics, embedded analytics, data input, and data apps in one platform. Astrato unites action and analytics in one, introduce live write-back, interact with ML models, accelerate your analytics with AI – go beyond dashboarding, thanks to pushdown SQL support in Astrato.' title: 'Connecting Astrato to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import astrato_1_dataconnection from '@site/static/images/integrations/data-visualization/astrato_1_dataconnection.png'; diff --git a/docs/integrations/data-visualization/chartbrew-and-clickhouse.md b/docs/integrations/data-visualization/chartbrew-and-clickhouse.md index ff6431121a0..27cc5e8bfc6 100644 --- a/docs/integrations/data-visualization/chartbrew-and-clickhouse.md +++ b/docs/integrations/data-visualization/chartbrew-and-clickhouse.md @@ -5,7 +5,7 @@ sidebar_position: 131 slug: /integrations/chartbrew-and-clickhouse keywords: ['ClickHouse', 'Chartbrew', 'connect', 'integrate', 'visualization'] description: 'Connect Chartbrew to ClickHouse to create real-time dashboards and client reports.' -doc_type: 'how-to' +doc_type: 'guide' --- import chartbrew_01 from '@site/static/images/integrations/data-visualization/chartbrew_01.png'; diff --git a/docs/integrations/data-visualization/deepnote.md b/docs/integrations/data-visualization/deepnote.md index 2de9d3e4c06..936c384ea62 100644 --- a/docs/integrations/data-visualization/deepnote.md +++ b/docs/integrations/data-visualization/deepnote.md @@ -5,7 +5,7 @@ slug: /integrations/deepnote keywords: ['clickhouse', 'Deepnote', 'connect', 'integrate', 'notebook'] description: 'Efficiently query very large datasets, analyzing and modeling in the comfort of known notebook environment.' title: 'Connect ClickHouse to Deepnote' -doc_type: 'how-to' +doc_type: 'guide' --- import deepnote_01 from '@site/static/images/integrations/data-visualization/deepnote_01.png'; diff --git a/docs/integrations/data-visualization/draxlr-and-clickhouse.md b/docs/integrations/data-visualization/draxlr-and-clickhouse.md index 90ee977165d..b010bd07703 100644 --- a/docs/integrations/data-visualization/draxlr-and-clickhouse.md +++ b/docs/integrations/data-visualization/draxlr-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/draxlr keywords: ['clickhouse', 'Draxlr', 'connect', 'integrate', 'ui'] description: 'Draxlr is a Business intelligence tool with data visualization and analytics.' title: 'Connecting Draxlr to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/embeddable-and-clickhouse.md b/docs/integrations/data-visualization/embeddable-and-clickhouse.md index 62a6bad16cf..9fb83005510 100644 --- a/docs/integrations/data-visualization/embeddable-and-clickhouse.md +++ b/docs/integrations/data-visualization/embeddable-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/embeddable keywords: ['clickhouse', 'Embeddable', 'connect', 'integrate', 'ui'] description: 'Embeddable is a developer toolkit for building fast, interactive, fully-custom analytics experiences directly into your app.' title: 'Connecting Embeddable to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/explo-and-clickhouse.md b/docs/integrations/data-visualization/explo-and-clickhouse.md index 994b5539845..071a3b3a275 100644 --- a/docs/integrations/data-visualization/explo-and-clickhouse.md +++ b/docs/integrations/data-visualization/explo-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/explo keywords: ['clickhouse', 'Explo', 'connect', 'integrate', 'ui'] description: 'Explo is an easy-to-use, open source UI tool for asking questions about your data.' title: 'Connecting Explo to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/fabi-and-clickhouse.md b/docs/integrations/data-visualization/fabi-and-clickhouse.md index 6254033e646..878b66a3208 100644 --- a/docs/integrations/data-visualization/fabi-and-clickhouse.md +++ b/docs/integrations/data-visualization/fabi-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/fabi.ai keywords: ['clickhouse', 'Fabi.ai', 'connect', 'integrate', 'notebook', 'ui', 'analytics'] description: 'Fabi.ai is an all-in-one collaborate data analysis platform. You can leverage SQL, Python, AI, and no-code to build dashboard and data workflows faster than ever before' title: 'Connect ClickHouse to Fabi.ai' -doc_type: 'how-to' +doc_type: 'guide' --- import fabi_01 from '@site/static/images/integrations/data-visualization/fabi_01.png'; diff --git a/docs/integrations/data-visualization/grafana/config.md b/docs/integrations/data-visualization/grafana/config.md index 9619432020c..8acc6fd0d0b 100644 --- a/docs/integrations/data-visualization/grafana/config.md +++ b/docs/integrations/data-visualization/grafana/config.md @@ -4,7 +4,7 @@ sidebar_position: 3 slug: /integrations/grafana/config description: 'Configuration options for the ClickHouse data source plugin in Grafana' title: 'Configuring ClickHouse data source in Grafana' -doc_type: 'reference' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/grafana/index.md b/docs/integrations/data-visualization/grafana/index.md index c491acffd56..1f4ee182e47 100644 --- a/docs/integrations/data-visualization/grafana/index.md +++ b/docs/integrations/data-visualization/grafana/index.md @@ -5,7 +5,7 @@ slug: /integrations/grafana description: 'Introduction to using ClickHouse with Grafana' title: 'ClickHouse data source plugin for Grafana' show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_native.md'; diff --git a/docs/integrations/data-visualization/grafana/query-builder.md b/docs/integrations/data-visualization/grafana/query-builder.md index 64e900141ba..8b934c57adf 100644 --- a/docs/integrations/data-visualization/grafana/query-builder.md +++ b/docs/integrations/data-visualization/grafana/query-builder.md @@ -4,7 +4,7 @@ sidebar_position: 2 slug: /integrations/grafana/query-builder description: 'Using the Query Builder in the ClickHouse Grafana plugin' title: 'Query Builder' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/hashboard-and-clickhouse.md b/docs/integrations/data-visualization/hashboard-and-clickhouse.md index ca5bbd2e72e..429511071c0 100644 --- a/docs/integrations/data-visualization/hashboard-and-clickhouse.md +++ b/docs/integrations/data-visualization/hashboard-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/hashboard keywords: ['clickhouse', 'Hashboard', 'connect', 'integrate', 'ui', 'analytics'] description: 'Hashboard is a robust analytics platform that can be easily integrated with ClickHouse for real-time data analysis.' title: 'Connecting ClickHouse to Hashboard' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_native.md'; diff --git a/docs/integrations/data-visualization/index.md b/docs/integrations/data-visualization/index.md index 8f977ef6ec3..7f18ec5c05d 100644 --- a/docs/integrations/data-visualization/index.md +++ b/docs/integrations/data-visualization/index.md @@ -5,7 +5,7 @@ keywords: ['ClickHouse', 'connect', 'Luzmo', 'Explo', 'Fabi.ai', 'Tableau', 'Gra title: 'Visualizing Data in ClickHouse' slug: /integrations/data-visualization description: 'Learn about Visualizing Data in ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- # Visualizing data in ClickHouse diff --git a/docs/integrations/data-visualization/looker-and-clickhouse.md b/docs/integrations/data-visualization/looker-and-clickhouse.md index 6233502ceb6..cc3be8c1055 100644 --- a/docs/integrations/data-visualization/looker-and-clickhouse.md +++ b/docs/integrations/data-visualization/looker-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/looker keywords: ['clickhouse', 'looker', 'connect', 'integrate', 'ui'] description: 'Looker is an enterprise platform for BI, data applications, and embedded analytics that helps you explore and share insights in real time.' title: 'Looker' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/looker-studio-and-clickhouse.md b/docs/integrations/data-visualization/looker-studio-and-clickhouse.md index c6e66a7ee0f..07590cf70d6 100644 --- a/docs/integrations/data-visualization/looker-studio-and-clickhouse.md +++ b/docs/integrations/data-visualization/looker-studio-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/lookerstudio keywords: ['clickhouse', 'looker', 'studio', 'connect', 'mysql', 'integrate', 'ui'] description: 'Looker Studio, formerly Google Data Studio, is an online tool for converting data into customizable informative reports and dashboards.' title: 'Looker Studio' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/luzmo-and-clickhouse.md b/docs/integrations/data-visualization/luzmo-and-clickhouse.md index f80182b550f..93b5b8fd4ce 100644 --- a/docs/integrations/data-visualization/luzmo-and-clickhouse.md +++ b/docs/integrations/data-visualization/luzmo-and-clickhouse.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'Luzmo', 'connect', 'integrate', 'ui', 'embedded'] description: 'Luzmo is an embedded analytics platform with a native ClickHouse integration, purpose-built for Software and SaaS applications.' title: 'Integrating Luzmo with ClickHouse' sidebar: 'integrations' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/metabase-and-clickhouse.md b/docs/integrations/data-visualization/metabase-and-clickhouse.md index 3194e868759..93cde69c5d3 100644 --- a/docs/integrations/data-visualization/metabase-and-clickhouse.md +++ b/docs/integrations/data-visualization/metabase-and-clickhouse.md @@ -6,7 +6,7 @@ keywords: ['Metabase'] description: 'Metabase is an easy-to-use, open source UI tool for asking questions about your data.' title: 'Connecting Metabase to ClickHouse' show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/mitzu-and-clickhouse.md b/docs/integrations/data-visualization/mitzu-and-clickhouse.md index 919058a21ea..97e83b62594 100644 --- a/docs/integrations/data-visualization/mitzu-and-clickhouse.md +++ b/docs/integrations/data-visualization/mitzu-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/mitzu keywords: ['clickhouse', 'Mitzu', 'connect', 'integrate', 'ui'] description: 'Mitzu is a no-code warehouse-native product analytics application.' title: 'Connecting Mitzu to ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/omni-and-clickhouse.md b/docs/integrations/data-visualization/omni-and-clickhouse.md index b6db6eaf644..267e8f5a514 100644 --- a/docs/integrations/data-visualization/omni-and-clickhouse.md +++ b/docs/integrations/data-visualization/omni-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/omni keywords: ['clickhouse', 'Omni', 'connect', 'integrate', 'ui'] description: 'Omni is an enterprise platform for BI, data applications, and embedded analytics that helps you explore and share insights in real time.' title: 'Omni' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/powerbi-and-clickhouse.md b/docs/integrations/data-visualization/powerbi-and-clickhouse.md index 6a9d6b9a273..82a5f578a32 100644 --- a/docs/integrations/data-visualization/powerbi-and-clickhouse.md +++ b/docs/integrations/data-visualization/powerbi-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/powerbi keywords: ['clickhouse', 'Power BI', 'connect', 'integrate', 'ui'] description: 'Microsoft Power BI is an interactive data visualization software product developed by Microsoft with a primary focus on business intelligence.' title: 'Power BI' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/quicksight-and-clickhouse.md b/docs/integrations/data-visualization/quicksight-and-clickhouse.md index c8c85ff5c63..47cbf7806ff 100644 --- a/docs/integrations/data-visualization/quicksight-and-clickhouse.md +++ b/docs/integrations/data-visualization/quicksight-and-clickhouse.md @@ -4,7 +4,7 @@ slug: /integrations/quicksight keywords: ['clickhouse', 'aws', 'amazon', 'QuickSight', 'mysql', 'connect', 'integrate', 'ui'] description: 'Amazon QuickSight powers data-driven organizations with unified business intelligence (BI).' title: 'QuickSight' -doc_type: 'how-to' +doc_type: 'guide' --- import MySQLOnPremiseSetup from '@site/docs/_snippets/_clickhouse_mysql_on_premise_setup.mdx'; diff --git a/docs/integrations/data-visualization/rocketbi-and-clickhouse.md b/docs/integrations/data-visualization/rocketbi-and-clickhouse.md index 11c204bbff4..cf43ecea971 100644 --- a/docs/integrations/data-visualization/rocketbi-and-clickhouse.md +++ b/docs/integrations/data-visualization/rocketbi-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/rocketbi keywords: ['clickhouse', 'RocketBI', 'connect', 'integrate', 'ui'] description: 'RocketBI is a self-service business intelligence platform that helps you quickly analyze data, build drag-n-drop visualizations and collaborate with colleagues right on your web browser.' title: 'GOAL: BUILD YOUR 1ST DASHBOARD' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/splunk-and-clickhouse.md b/docs/integrations/data-visualization/splunk-and-clickhouse.md index 31e327ee30d..a8c65cf8626 100644 --- a/docs/integrations/data-visualization/splunk-and-clickhouse.md +++ b/docs/integrations/data-visualization/splunk-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/splunk keywords: ['Splunk', 'integration', 'data visualization'] description: 'Connect Splunk dashboards to ClickHouse' title: 'Connecting Splunk to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/superset-and-clickhouse.md b/docs/integrations/data-visualization/superset-and-clickhouse.md index ddf23393876..e842b9214da 100644 --- a/docs/integrations/data-visualization/superset-and-clickhouse.md +++ b/docs/integrations/data-visualization/superset-and-clickhouse.md @@ -6,7 +6,7 @@ keywords: ['superset'] description: 'Apache Superset is an open-source data exploration and visualization platform.' title: 'Connect Superset to ClickHouse' show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md b/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md index 18375bb8749..37a7320ee0c 100644 --- a/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md +++ b/docs/integrations/data-visualization/tableau/tableau-analysis-tips.md @@ -5,7 +5,7 @@ slug: /integrations/tableau/analysis-tips keywords: ['clickhouse', 'tableau', 'online', 'mysql', 'connect', 'integrate', 'ui'] description: 'Tableau analysis tips when using ClickHouse official connector.' title: 'Analysis tips' -doc_type: 'reference' +doc_type: 'guide' --- # Analysis tips diff --git a/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md b/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md index 558b21e577b..99adb55708d 100644 --- a/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md +++ b/docs/integrations/data-visualization/tableau/tableau-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/tableau keywords: ['clickhouse', 'tableau', 'connect', 'integrate', 'ui'] description: 'Tableau can use ClickHouse databases and tables as a data source.' title: 'Connecting Tableau to ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- import TOCInline from '@theme/TOCInline'; diff --git a/docs/integrations/data-visualization/tableau/tableau-connection-tips.md b/docs/integrations/data-visualization/tableau/tableau-connection-tips.md index f517a0aaf2d..71df9e5f76b 100644 --- a/docs/integrations/data-visualization/tableau/tableau-connection-tips.md +++ b/docs/integrations/data-visualization/tableau/tableau-connection-tips.md @@ -5,7 +5,7 @@ slug: /integrations/tableau/connection-tips keywords: ['clickhouse', 'tableau', 'online', 'mysql', 'connect', 'integrate', 'ui'] description: 'Tableau connection tips when using ClickHouse official connector.' title: 'Connection tips' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md b/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md index d9749f27f1b..7d3dcdd5636 100644 --- a/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md +++ b/docs/integrations/data-visualization/tableau/tableau-online-and-clickhouse.md @@ -5,7 +5,7 @@ slug: /integrations/tableau-online keywords: ['clickhouse', 'tableau', 'online', 'mysql', 'connect', 'integrate', 'ui'] description: 'Tableau Online streamlines the power of data to make people faster and more confident decision makers from anywhere.' title: 'Tableau Online' -doc_type: 'how-to' +doc_type: 'guide' --- import MySQLCloudSetup from '@site/docs/_snippets/_clickhouse_mysql_cloud_setup.mdx'; diff --git a/docs/integrations/data-visualization/zingdata-and-clickhouse.md b/docs/integrations/data-visualization/zingdata-and-clickhouse.md index af66c439674..33011e68f42 100644 --- a/docs/integrations/data-visualization/zingdata-and-clickhouse.md +++ b/docs/integrations/data-visualization/zingdata-and-clickhouse.md @@ -6,7 +6,7 @@ keywords: ['Zing Data'] description: 'Zing Data is simple social business intelligence for ClickHouse, made for iOS, Android and the web.' title: 'Connect Zing Data to ClickHouse' show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/language-clients/csharp.md b/docs/integrations/language-clients/csharp.md index f08cc68e950..cc7fd3274ea 100644 --- a/docs/integrations/language-clients/csharp.md +++ b/docs/integrations/language-clients/csharp.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'cs', 'c#', '.net', 'dotnet', 'csharp', 'client', 'driv slug: /integrations/csharp description: 'The official C# client for connecting to ClickHouse.' title: 'ClickHouse C# Driver' -doc_type: 'tutorial' +doc_type: 'guide' --- # ClickHouse C# Client diff --git a/docs/integrations/language-clients/go/index.md b/docs/integrations/language-clients/go/index.md index 27dd8e8a938..b4c6be03bfd 100644 --- a/docs/integrations/language-clients/go/index.md +++ b/docs/integrations/language-clients/go/index.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'go', 'client', 'golang'] slug: /integrations/go description: 'The Go clients for ClickHouse allows users to connect to ClickHouse using either the Go standard database/sql interface or an optimized native interface.' title: 'ClickHouse Go' -doc_type: 'tutorial' +doc_type: 'reference' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_native.md'; diff --git a/docs/integrations/language-clients/index.md b/docs/integrations/language-clients/index.md index 45331727acb..239f498fd1a 100644 --- a/docs/integrations/language-clients/index.md +++ b/docs/integrations/language-clients/index.md @@ -3,7 +3,7 @@ slug: /integrations/language-clients title: 'Language Clients' description: 'Table of contents page for Language Clients.' keywords: ['Language Clients', 'C++', 'Go', 'JavaScript', 'Java', 'Python', 'Rust'] -doc_type: 'reference' +doc_type: 'landing-page' --- In this section of the documentation, you can learn more about the many language client integrations diff --git a/docs/integrations/language-clients/java/r2dbc.md b/docs/integrations/language-clients/java/r2dbc.md index a1ba8a7662b..6ad36d9f3bc 100644 --- a/docs/integrations/language-clients/java/r2dbc.md +++ b/docs/integrations/language-clients/java/r2dbc.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'java', 'driver', 'integrate', 'r2dbc'] description: 'ClickHouse R2DBC Driver' slug: /integrations/java/r2dbc title: 'R2DBC driver' -doc_type: 'how-to' +doc_type: 'reference' --- import Tabs from '@theme/Tabs'; diff --git a/docs/integrations/language-clients/moose-olap.md b/docs/integrations/language-clients/moose-olap.md index 44de886e1e4..6d6458e0ca9 100644 --- a/docs/integrations/language-clients/moose-olap.md +++ b/docs/integrations/language-clients/moose-olap.md @@ -5,7 +5,7 @@ sidebar_position: 25 slug: /interfaces/third-party/moose-olap title: 'Developing on ClickHouse with Moose OLAP' keywords: ['Moose'] -doc_type: 'tutorial' +doc_type: 'guide' --- import CommunityMaintainedBadge from '@theme/badges/CommunityMaintained'; diff --git a/docs/integrations/language-clients/python/index.md b/docs/integrations/language-clients/python/index.md index bed30842ba1..c26b5698978 100644 --- a/docs/integrations/language-clients/python/index.md +++ b/docs/integrations/language-clients/python/index.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'python', 'client', 'connect', 'integrate'] slug: /integrations/python description: 'The ClickHouse Connect project suite for connecting Python to ClickHouse' title: 'Python Integration with ClickHouse Connect' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/language-clients/rust.md b/docs/integrations/language-clients/rust.md index 747252917a3..09592eab3f2 100644 --- a/docs/integrations/language-clients/rust.md +++ b/docs/integrations/language-clients/rust.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'rs', 'rust', 'cargo', 'crate', 'http', 'client', 'conn slug: /integrations/rust description: 'The official Rust client for connecting to ClickHouse.' title: 'ClickHouse Rust Client' -doc_type: 'explanation' +doc_type: 'reference' --- # ClickHouse Rust client diff --git a/docs/integrations/migration/clickhouse-local-etl.md b/docs/integrations/migration/clickhouse-local-etl.md index 586eb72c306..70cd864e282 100644 --- a/docs/integrations/migration/clickhouse-local-etl.md +++ b/docs/integrations/migration/clickhouse-local-etl.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data', 'etl', 'el slug: /cloud/migration/clickhouse-local title: 'Migrating to ClickHouse using clickhouse-local' description: 'Guide showing how to migrate to ClickHouse using clickhouse-local' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/clickhouse-to-cloud.md b/docs/integrations/migration/clickhouse-to-cloud.md index c215243702d..24fd14ffc1c 100644 --- a/docs/integrations/migration/clickhouse-to-cloud.md +++ b/docs/integrations/migration/clickhouse-to-cloud.md @@ -4,7 +4,7 @@ sidebar_label: 'ClickHouse to ClickHouse Cloud' slug: /cloud/migration/clickhouse-to-cloud title: 'Migrating between self-managed ClickHouse and ClickHouse Cloud' description: 'Page describing how to migrate between self-managed ClickHouse and ClickHouse Cloud' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/etl-tool-to-clickhouse.md b/docs/integrations/migration/etl-tool-to-clickhouse.md index f822a8e8108..a2487b4ebab 100644 --- a/docs/integrations/migration/etl-tool-to-clickhouse.md +++ b/docs/integrations/migration/etl-tool-to-clickhouse.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data', 'etl', 'el slug: /cloud/migration/etl-tool-to-clickhouse title: 'Using a 3rd-party ETL Tool' description: 'Page describing how to use a 3rd-party ETL tool with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/index.md b/docs/integrations/migration/index.md index c8da80d88f1..dc0db0d12e0 100644 --- a/docs/integrations/migration/index.md +++ b/docs/integrations/migration/index.md @@ -5,7 +5,7 @@ keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data'] description: 'Migrating To Cloud Table Of Contents' title: 'Migrating To Cloud' slug: /integrations/migration -doc_type: 'reference' +doc_type: 'landing-page' --- This section of the docs explores how you can migrate from ClickHouse to ClickHouse Cloud. diff --git a/docs/integrations/migration/object-storage-to-clickhouse.md b/docs/integrations/migration/object-storage-to-clickhouse.md index fe917510b40..5e87cff7d29 100644 --- a/docs/integrations/migration/object-storage-to-clickhouse.md +++ b/docs/integrations/migration/object-storage-to-clickhouse.md @@ -3,7 +3,7 @@ title: 'Object Storage to ClickHouse Cloud' description: 'Moving data from object storage to ClickHouse Cloud' keywords: ['object storage', 's3', 'azure blob', 'gcs', 'migration'] slug: /integrations/migration/object-storage-to-clickhouse -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/migration/overview.md b/docs/integrations/migration/overview.md index d5b82b08b86..0872c1d66ae 100644 --- a/docs/integrations/migration/overview.md +++ b/docs/integrations/migration/overview.md @@ -5,7 +5,7 @@ slug: /integrations/migration/overview keywords: ['clickhouse', 'migrate', 'migration', 'migrating', 'data'] title: 'Migrating Data into ClickHouse' description: 'Page describing the options available for migrating data into ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- # Migrating data into ClickHouse diff --git a/docs/integrations/misc/index.md b/docs/integrations/misc/index.md index 3c81fd66165..a05f2d55af1 100644 --- a/docs/integrations/misc/index.md +++ b/docs/integrations/misc/index.md @@ -3,7 +3,7 @@ slug: /integrations/misc keywords: ['Retool', 'Easypanel', 'Splunk'] title: 'Tools' description: 'Landing page for the Tools section' -doc_type: 'reference' +doc_type: 'landing-page' --- # Tools diff --git a/docs/integrations/sql-clients/datagrip.md b/docs/integrations/sql-clients/datagrip.md index 0acf409d331..6cfe1bb4039 100644 --- a/docs/integrations/sql-clients/datagrip.md +++ b/docs/integrations/sql-clients/datagrip.md @@ -3,7 +3,7 @@ sidebar_label: 'DataGrip' slug: /integrations/datagrip description: 'DataGrip is a database IDE that supports ClickHouse out of the box.' title: 'Connecting DataGrip to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/dbeaver.md b/docs/integrations/sql-clients/dbeaver.md index 31186b8439a..e8cbe7337ef 100644 --- a/docs/integrations/sql-clients/dbeaver.md +++ b/docs/integrations/sql-clients/dbeaver.md @@ -3,7 +3,7 @@ slug: /integrations/dbeaver sidebar_label: 'DBeaver' description: 'DBeaver is a multi-platform database tool.' title: 'Connect DBeaver to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/dbvisualizer.md b/docs/integrations/sql-clients/dbvisualizer.md index eb49955fc43..35478e8b0b5 100644 --- a/docs/integrations/sql-clients/dbvisualizer.md +++ b/docs/integrations/sql-clients/dbvisualizer.md @@ -3,7 +3,7 @@ sidebar_label: 'DbVisualizer' slug: /integrations/dbvisualizer description: 'DbVisualizer is a database tool with extended support for ClickHouse.' title: 'Connecting DbVisualizer to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/sql-clients/index.md b/docs/integrations/sql-clients/index.md index ed952526966..1724ffe050c 100644 --- a/docs/integrations/sql-clients/index.md +++ b/docs/integrations/sql-clients/index.md @@ -3,7 +3,7 @@ slug: /integrations/sql-clients/ description: 'Overview page for ClickHouse SQL clients.' keywords: ['integrations', 'DataGrip', 'DBeaver', 'DbVisualizer', 'Jupyter Notebooks', 'QStudio', 'TABLUM.IO', 'marimo'] title: 'SQL Client Integrations' -doc_type: 'reference' +doc_type: 'landing-page' --- # SQL client integrations diff --git a/docs/integrations/sql-clients/jupysql.md b/docs/integrations/sql-clients/jupysql.md index bc468f83b29..b1663e76575 100644 --- a/docs/integrations/sql-clients/jupysql.md +++ b/docs/integrations/sql-clients/jupysql.md @@ -3,7 +3,7 @@ slug: /integrations/jupysql sidebar_label: 'Jupyter notebooks' description: 'JupySQL is a multi-platform database tool for Jupyter.' title: 'Using JupySQL with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/marimo.md b/docs/integrations/sql-clients/marimo.md index 7d64697f06e..ed12d9085de 100644 --- a/docs/integrations/sql-clients/marimo.md +++ b/docs/integrations/sql-clients/marimo.md @@ -3,7 +3,7 @@ slug: /integrations/marimo sidebar_label: 'marimo' description: 'marimo is a next-generation Python notebook for interacting with data' title: 'Using marimo with ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/sql-clients/qstudio.md b/docs/integrations/sql-clients/qstudio.md index a853b7e6e2a..f1edc42ec82 100644 --- a/docs/integrations/sql-clients/qstudio.md +++ b/docs/integrations/sql-clients/qstudio.md @@ -3,7 +3,7 @@ slug: /integrations/qstudio sidebar_label: 'QStudio' description: 'QStudio is a free SQL tool.' title: 'Connect QStudio to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/sql-clients/sql-console.md b/docs/integrations/sql-clients/sql-console.md index 879ed3be3c7..92576f98007 100644 --- a/docs/integrations/sql-clients/sql-console.md +++ b/docs/integrations/sql-clients/sql-console.md @@ -4,7 +4,7 @@ sidebar_position: 1 title: 'SQL Console' slug: /integrations/sql-clients/sql-console description: 'Learn about SQL Console' -doc_type: 'how-to' +doc_type: 'guide' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/integrations/sql-clients/tablum.md b/docs/integrations/sql-clients/tablum.md index 194bd64b013..3dcd100d2dc 100644 --- a/docs/integrations/sql-clients/tablum.md +++ b/docs/integrations/sql-clients/tablum.md @@ -3,7 +3,7 @@ sidebar_label: 'TABLUM.IO' slug: /integrations/tablumio description: 'TABLUM.IO is a data management SaaS that supports ClickHouse out of the box.' title: 'Connecting TABLUM.IO to ClickHouse' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/tools/data-integration/easypanel/index.md b/docs/integrations/tools/data-integration/easypanel/index.md index dc20605558c..f0ac1717b67 100644 --- a/docs/integrations/tools/data-integration/easypanel/index.md +++ b/docs/integrations/tools/data-integration/easypanel/index.md @@ -4,7 +4,7 @@ slug: /integrations/easypanel keywords: ['clickhouse', 'Easypanel', 'deployment', 'integrate', 'install'] description: 'You can use it to deploy ClickHouse on your own server.' title: 'Deploying ClickHouse on Easypanel' -doc_type: 'how-to' +doc_type: 'guide' --- import CommunityMaintainedBadge from '@theme/badges/CommunityMaintained'; diff --git a/docs/integrations/tools/data-integration/index.md b/docs/integrations/tools/data-integration/index.md index 6771b8f6786..0b42e03cd7a 100644 --- a/docs/integrations/tools/data-integration/index.md +++ b/docs/integrations/tools/data-integration/index.md @@ -3,7 +3,7 @@ slug: /integrations/tools/data-integrations keywords: ['Retool', 'Easypanel', 'Splunk'] title: 'Data Integrations' description: 'Landing page for the data integrations section' -doc_type: 'reference' +doc_type: 'landing-page' --- # Data Integrations diff --git a/docs/integrations/tools/data-integration/retool/index.md b/docs/integrations/tools/data-integration/retool/index.md index 663f33a3fc7..a33567b4111 100644 --- a/docs/integrations/tools/data-integration/retool/index.md +++ b/docs/integrations/tools/data-integration/retool/index.md @@ -4,7 +4,7 @@ slug: /integrations/retool keywords: ['clickhouse', 'retool', 'connect', 'integrate', 'ui', 'admin', 'panel', 'dashboard', 'nocode', 'no-code'] description: 'Quickly build web and mobile apps with rich user interfaces, automate complex tasks, and integrate AI—all powered by your data.' title: 'Connecting Retool to ClickHouse' -doc_type: 'tutorial' +doc_type: 'guide' --- import ConnectionDetails from '@site/docs/_snippets/_gather_your_details_http.mdx'; diff --git a/docs/integrations/tools/data-integration/splunk/index.md b/docs/integrations/tools/data-integration/splunk/index.md index aa9070fe8c2..f57228f0fa7 100644 --- a/docs/integrations/tools/data-integration/splunk/index.md +++ b/docs/integrations/tools/data-integration/splunk/index.md @@ -4,7 +4,7 @@ slug: /integrations/audit-splunk keywords: ['clickhouse', 'Splunk', 'audit', 'cloud'] description: 'Store ClickHouse Cloud audit logs into Splunk.' title: 'Storing ClickHouse Cloud Audit logs into Splunk' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/integrations/tools/index.md b/docs/integrations/tools/index.md index ff6dfefe913..b100e363480 100644 --- a/docs/integrations/tools/index.md +++ b/docs/integrations/tools/index.md @@ -3,7 +3,7 @@ slug: /integrations/tools keywords: ['Retool', 'Easypanel', 'Splunk'] title: 'Tools' description: 'Landing page for the tools section' -doc_type: 'reference' +doc_type: 'landing-page' --- # Tools diff --git a/docs/intro.md b/docs/intro.md index c45550de22f..908954e6dc5 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -3,7 +3,7 @@ slug: /intro sidebar_label: 'What is ClickHouse?' description: 'ClickHouse® is a column-oriented SQL database management system (DBMS) for online analytical processing (OLAP). It is available as both an open-source software and a cloud offering.' title: 'What is ClickHouse?' -doc_type: 'explanation' +doc_type: 'guide' --- import column_example from '@site/static/images/column-oriented-example-query.png'; diff --git a/docs/introduction-index.md b/docs/introduction-index.md index c43141f2804..dddd2c49a60 100644 --- a/docs/introduction-index.md +++ b/docs/introduction-index.md @@ -3,7 +3,7 @@ slug: /introduction-clickhouse title: 'Introduction' description: 'Landing page for Introduction' pagination_next: null -doc_type: 'reference' +doc_type: 'landing-page' --- Welcome to ClickHouse! Check out the pages below to learn how to get up and running with ClickHouse - the fastest and most resource efficient real-time data warehouse and open-source database. diff --git a/docs/managing-data/core-concepts/index.md b/docs/managing-data/core-concepts/index.md index 15bb27c7828..140de323c10 100644 --- a/docs/managing-data/core-concepts/index.md +++ b/docs/managing-data/core-concepts/index.md @@ -3,7 +3,7 @@ slug: /managing-data/core-concepts title: 'Core Concepts' description: 'Learn Core Concepts of how ClickHouse works' keywords: ['concepts', 'part', 'partition', 'primary index'] -doc_type: 'reference' +doc_type: 'guide' --- In this section of the documentation, diff --git a/docs/managing-data/deleting-data/index.md b/docs/managing-data/deleting-data/index.md index 05b5fe665a4..2584070683d 100644 --- a/docs/managing-data/deleting-data/index.md +++ b/docs/managing-data/deleting-data/index.md @@ -3,7 +3,7 @@ slug: /managing-data/deleting-data/overview title: 'Deleting Data' description: 'How to delete data in ClickHouse Table Of Contents' keywords: ['delete', 'truncate', 'drop', 'lightweight delete'] -doc_type: 'reference' +doc_type: 'guide' --- In this section of the documentation, diff --git a/docs/managing-data/truncate.md b/docs/managing-data/truncate.md index 55206e4e159..6f8f89408c8 100644 --- a/docs/managing-data/truncate.md +++ b/docs/managing-data/truncate.md @@ -4,7 +4,7 @@ sidebar_label: 'Truncate Table' title: 'Truncate Table' hide_title: false description: 'Truncate allows the data in a table or database to be removed, while preserving their existence.' -doc_type: 'how-to' +doc_type: 'reference' --- Truncate allows the data in a table or database to be removed, while preserving their existence. This is a lightweight operation which cannot be reversed. diff --git a/docs/managing-data/updating-data/index.md b/docs/managing-data/updating-data/index.md index a025868d57d..7ee4b24f241 100644 --- a/docs/managing-data/updating-data/index.md +++ b/docs/managing-data/updating-data/index.md @@ -3,7 +3,7 @@ slug: /updating-data title: 'Updating Data' description: 'Updating Data Table Of Contents' keywords: ['update', 'updating data'] -doc_type: 'reference' +doc_type: 'landing-page' --- In this section of the documentation, you will learn how you can update your data. diff --git a/docs/materialized-view/incremental-materialized-view.md b/docs/materialized-view/incremental-materialized-view.md index 3047bb67a0c..947c4434acf 100644 --- a/docs/materialized-view/incremental-materialized-view.md +++ b/docs/materialized-view/incremental-materialized-view.md @@ -4,7 +4,7 @@ title: 'Incremental materialized view' description: 'How to use incremental materialized views to speed up queries' keywords: ['incremental materialized views', 'speed up queries', 'query optimization'] score: 10000 -doc_type: 'how-to' +doc_type: 'guide' --- import materializedViewDiagram from '@site/static/images/materialized-view/materialized-view-diagram.png'; diff --git a/docs/materialized-view/index.md b/docs/materialized-view/index.md index 3d1f1c7d2bc..1dd82f8a319 100644 --- a/docs/materialized-view/index.md +++ b/docs/materialized-view/index.md @@ -3,7 +3,7 @@ slug: /materialized-views title: 'Materialized Views' description: 'Index page for materialized views' keywords: ['materialized views', 'speed up queries', 'query optimization', 'refreshable', 'incremental'] -doc_type: 'reference' +doc_type: 'landing-page' --- | Page | Description | diff --git a/docs/materialized-view/refreshable-materialized-view.md b/docs/materialized-view/refreshable-materialized-view.md index 3fe9b6bf698..cd7bc990192 100644 --- a/docs/materialized-view/refreshable-materialized-view.md +++ b/docs/materialized-view/refreshable-materialized-view.md @@ -3,7 +3,7 @@ slug: /materialized-view/refreshable-materialized-view title: 'Refreshable materialized view' description: 'How to use materialized views to speed up queries' keywords: ['refreshable materialized view', 'refresh', 'materialized views', 'speed up queries', 'query optimization'] -doc_type: 'how-to' +doc_type: 'guide' --- import refreshableMaterializedViewDiagram from '@site/static/images/materialized-view/refreshable-materialized-view-diagram.png'; diff --git a/docs/migrations/bigquery/equivalent-concepts.md b/docs/migrations/bigquery/equivalent-concepts.md index 5116bc73315..ac10cb220a1 100644 --- a/docs/migrations/bigquery/equivalent-concepts.md +++ b/docs/migrations/bigquery/equivalent-concepts.md @@ -4,7 +4,7 @@ slug: /migrations/bigquery/biquery-vs-clickhouse-cloud description: 'How BigQuery differs from ClickHouse Cloud' keywords: ['BigQuery'] show_related_blogs: true -doc_type: 'reference' +doc_type: 'guide' --- import bigquery_1 from '@site/static/images/migrations/bigquery-1.png'; diff --git a/docs/migrations/bigquery/index.md b/docs/migrations/bigquery/index.md index 5a5f5c907d7..ddfcdb44e4c 100644 --- a/docs/migrations/bigquery/index.md +++ b/docs/migrations/bigquery/index.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null description: 'Landing page for the BigQuery migrations section' keywords: ['BigQuery', 'migration'] -doc_type: 'reference' +doc_type: 'landing-page' --- In this section of the docs, learn more about the similarities and differences between BigQuery and ClickHouse Cloud, as well as why you might want to migrate and how to do so. diff --git a/docs/migrations/bigquery/loading-data.md b/docs/migrations/bigquery/loading-data.md index e65db6fb99c..104d03e8c4c 100644 --- a/docs/migrations/bigquery/loading-data.md +++ b/docs/migrations/bigquery/loading-data.md @@ -4,7 +4,7 @@ title: 'Loading data from BigQuery to ClickHouse' slug: /migrations/bigquery/loading-data description: 'How to load data from BigQuery to ClickHouse' keywords: ['migrate', 'migration', 'migrating', 'data', 'etl', 'elt', 'BigQuery'] -doc_type: 'how-to' +doc_type: 'guide' --- _This guide is compatible with ClickHouse Cloud and for self-hosted ClickHouse v23.5+._ diff --git a/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md b/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md index 75c0e66c061..e6c472f9d9c 100644 --- a/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md +++ b/docs/migrations/bigquery/migrating-to-clickhouse-cloud.md @@ -4,7 +4,7 @@ slug: /migrations/bigquery/migrating-to-clickhouse-cloud description: 'How to migrate your data from BigQuery to ClickHouse Cloud' keywords: ['BigQuery'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import bigquery_2 from '@site/static/images/migrations/bigquery-2.png'; diff --git a/docs/migrations/index.md b/docs/migrations/index.md index 3a5ea806eaa..624ce7c9777 100644 --- a/docs/migrations/index.md +++ b/docs/migrations/index.md @@ -4,7 +4,7 @@ title: 'Migrations' pagination_prev: null pagination_next: null description: 'Landing page for the migrations section' -doc_type: 'reference' +doc_type: 'landing-page' --- | Page | Description | diff --git a/docs/migrations/postgres/data-modeling-techniques.md b/docs/migrations/postgres/data-modeling-techniques.md index 1a62967b8c6..b365fc9a742 100644 --- a/docs/migrations/postgres/data-modeling-techniques.md +++ b/docs/migrations/postgres/data-modeling-techniques.md @@ -4,7 +4,7 @@ title: 'Data modeling techniques' description: 'Data modeling for migrating from PostgreSQL to ClickHouse' keywords: ['postgres', 'postgresql'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import postgres_b_tree from '@site/static/images/migrations/postgres-b-tree.png'; diff --git a/docs/migrations/postgres/dataset.md b/docs/migrations/postgres/dataset.md index 8c1ebecbc8d..5b091d5f7ee 100644 --- a/docs/migrations/postgres/dataset.md +++ b/docs/migrations/postgres/dataset.md @@ -4,7 +4,7 @@ title: 'Migrating data' description: 'Dataset example to migrate from PostgreSQL to ClickHouse' keywords: ['Postgres'] show_related_blogs: true -doc_type: 'reference' +doc_type: 'guide' --- import postgres_stackoverflow_schema from '@site/static/images/migrations/postgres-stackoverflow-schema.png'; diff --git a/docs/migrations/postgres/index.md b/docs/migrations/postgres/index.md index 6b2e52cad31..7a415b58319 100644 --- a/docs/migrations/postgres/index.md +++ b/docs/migrations/postgres/index.md @@ -4,7 +4,7 @@ pagination_prev: null pagination_next: null title: 'PostgreSQL' description: 'Landing page for the PostgreSQL migrations section' -doc_type: 'reference' +doc_type: 'landing-page' --- | Page | Description | diff --git a/docs/migrations/postgres/overview.md b/docs/migrations/postgres/overview.md index 3aaaab4e123..f5f30cc9a3b 100644 --- a/docs/migrations/postgres/overview.md +++ b/docs/migrations/postgres/overview.md @@ -3,7 +3,7 @@ slug: /migrations/postgresql/overview title: 'Migrating from PostgreSQL to ClickHouse' description: 'A guide to migrating from PostgreSQL to ClickHouse' keywords: ['postgres', 'postgresql', 'migrate', 'migration'] -doc_type: 'explanation' +doc_type: 'guide' --- ## Why use ClickHouse over Postgres? {#why-use-clickhouse-over-postgres} diff --git a/docs/migrations/postgres/rewriting-queries.md b/docs/migrations/postgres/rewriting-queries.md index af5000302cf..49731677fba 100644 --- a/docs/migrations/postgres/rewriting-queries.md +++ b/docs/migrations/postgres/rewriting-queries.md @@ -3,7 +3,7 @@ slug: /migrations/postgresql/rewriting-queries title: 'Rewriting PostgreSQL Queries' keywords: ['postgres', 'postgresql', 'rewriting queries'] description: 'Part 2 of a guide on migrating from PostgreSQL to ClickHouse' -doc_type: 'reference' +doc_type: 'guide' --- > This is **Part 2** of a guide on migrating from PostgreSQL to ClickHouse. Using a practical example, it demonstrates how to efficiently carry out the migration with a real-time replication (CDC) approach. Many of the concepts covered are also applicable to manual bulk data transfers from PostgreSQL to ClickHouse. diff --git a/docs/migrations/snowflake.md b/docs/migrations/snowflake.md index ea2307a16d0..71057d350e4 100644 --- a/docs/migrations/snowflake.md +++ b/docs/migrations/snowflake.md @@ -6,7 +6,7 @@ description: 'Migrating from Snowflake to ClickHouse' keywords: ['Snowflake'] title: 'Migrating from Snowflake to ClickHouse' show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import migrate_snowflake_clickhouse from '@site/static/images/migrations/migrate_snowflake_clickhouse.png'; diff --git a/docs/native-protocol/basics.md b/docs/native-protocol/basics.md index 663c67e4b19..0c36c53b86a 100644 --- a/docs/native-protocol/basics.md +++ b/docs/native-protocol/basics.md @@ -3,7 +3,7 @@ slug: /native-protocol/basics sidebar_position: 1 title: 'Basics' description: 'Native protocol basics' -doc_type: 'reference' +doc_type: 'guide' --- # Basics diff --git a/docs/native-protocol/client.md b/docs/native-protocol/client.md index bbbd35b985e..d8734c2da86 100644 --- a/docs/native-protocol/client.md +++ b/docs/native-protocol/client.md @@ -3,7 +3,7 @@ slug: /native-protocol/client sidebar_position: 2 title: 'Native client packets' description: 'Native protocol client' -doc_type: 'how-to' +doc_type: 'reference' --- # Client packets diff --git a/docs/native-protocol/server.md b/docs/native-protocol/server.md index 2cac99f987c..560be1e9695 100644 --- a/docs/native-protocol/server.md +++ b/docs/native-protocol/server.md @@ -3,7 +3,7 @@ slug: /native-protocol/server sidebar_position: 3 title: 'Server packets' description: 'Native protocol server' -doc_type: 'how-to' +doc_type: 'reference' --- # Server packets diff --git a/docs/starter-guides/index.md b/docs/starter-guides/index.md index e11fb4faf0e..995fad09b37 100644 --- a/docs/starter-guides/index.md +++ b/docs/starter-guides/index.md @@ -4,7 +4,7 @@ title: 'Starter Guides' description: 'Landing page for starter guides' pagination_prev: null pagination_next: null -doc_type: 'reference' +doc_type: 'landing-page' --- In this section of the docs you'll find starter guides for common SQL queries: `CREATE`, `INSERT`, `SELECT`, and mutations `UPDATE` and `DELETE`. diff --git a/docs/tips-and-tricks/community-wisdom.md b/docs/tips-and-tricks/community-wisdom.md index ce41c2efd49..e6191cbba2c 100644 --- a/docs/tips-and-tricks/community-wisdom.md +++ b/docs/tips-and-tricks/community-wisdom.md @@ -2,7 +2,7 @@ sidebar_position: 1 slug: /tips-and-tricks/community-wisdom sidebar_label: 'Community Wisdom' -doc_type: 'overview' +doc_type: 'landing-page' keywords: [ 'database tips', 'community wisdom', diff --git a/docs/tips-and-tricks/cost-optimization.md b/docs/tips-and-tricks/cost-optimization.md index a302275e4a5..4e35e77bee5 100644 --- a/docs/tips-and-tricks/cost-optimization.md +++ b/docs/tips-and-tricks/cost-optimization.md @@ -2,7 +2,7 @@ sidebar_position: 1 slug: /community-wisdom/cost-optimization sidebar_label: 'Cost Optimization' -doc_type: 'how-to-guide' +doc_type: 'guide' keywords: [ 'cost optimization', 'storage costs', diff --git a/docs/tips-and-tricks/debugging-insights.md b/docs/tips-and-tricks/debugging-insights.md index 4dc45937519..3c0e4ac0b85 100644 --- a/docs/tips-and-tricks/debugging-insights.md +++ b/docs/tips-and-tricks/debugging-insights.md @@ -2,7 +2,7 @@ sidebar_position: 1 slug: /community-wisdom/debugging-insights sidebar_label: 'Debugging Insights' -doc_type: 'how-to-guide' +doc_type: 'guide' keywords: [ 'clickhouse troubleshooting', 'clickhouse errors', diff --git a/docs/tips-and-tricks/materialized-views.md b/docs/tips-and-tricks/materialized-views.md index 38bc0d32d5b..7a5338cc79e 100644 --- a/docs/tips-and-tricks/materialized-views.md +++ b/docs/tips-and-tricks/materialized-views.md @@ -2,7 +2,7 @@ sidebar_position: 1 slug: /tips-and-tricks/materialized-views sidebar_label: 'Materialized Views' -doc_type: 'how-to' +doc_type: 'guide' keywords: [ 'clickhouse materialized views', 'materialized view optimization', diff --git a/docs/tips-and-tricks/performance-optimization.md b/docs/tips-and-tricks/performance-optimization.md index d0e39924ba0..d2b39a83a38 100644 --- a/docs/tips-and-tricks/performance-optimization.md +++ b/docs/tips-and-tricks/performance-optimization.md @@ -2,7 +2,7 @@ sidebar_position: 1 slug: /community-wisdom/performance-optimization sidebar_label: 'Performance Optimization' -doc_type: 'how-to-guide' +doc_type: 'guide' keywords: [ 'performance optimization', 'query performance', diff --git a/docs/tips-and-tricks/success-stories.md b/docs/tips-and-tricks/success-stories.md index c8104a136d6..f474f2b249e 100644 --- a/docs/tips-and-tricks/success-stories.md +++ b/docs/tips-and-tricks/success-stories.md @@ -2,7 +2,7 @@ sidebar_position: 1 slug: /community-wisdom/creative-use-cases sidebar_label: 'Success Stories' -doc_type: 'how-to-guide' +doc_type: 'guide' keywords: [ 'clickhouse creative use cases', 'clickhouse success stories', diff --git a/docs/tips-and-tricks/too-many-parts.md b/docs/tips-and-tricks/too-many-parts.md index e721e0733d3..6b805dd6bdb 100644 --- a/docs/tips-and-tricks/too-many-parts.md +++ b/docs/tips-and-tricks/too-many-parts.md @@ -2,7 +2,7 @@ sidebar_position: 1 slug: /tips-and-tricks/too-many-parts sidebar_label: 'Too Many Parts' -doc_type: 'how-to' +doc_type: 'guide' keywords: [ 'clickhouse too many parts', 'too many parts error', diff --git a/docs/tools-and-utilities/static-files-disk-uploader.md b/docs/tools-and-utilities/static-files-disk-uploader.md index d1b4f3442e1..c78b8ecaa9d 100644 --- a/docs/tools-and-utilities/static-files-disk-uploader.md +++ b/docs/tools-and-utilities/static-files-disk-uploader.md @@ -3,7 +3,7 @@ slug: /operations/utilities/static-files-disk-uploader title: 'clickhouse-static-files-disk-uploader' keywords: ['clickhouse-static-files-disk-uploader', 'utility', 'disk', 'uploader'] description: 'Provides a description of the clickhouse-static-files-disk-uploader utility' -doc_type: 'how-to' +doc_type: 'guide' --- # clickhouse-static-files-disk-uploader diff --git a/docs/troubleshooting/index.md b/docs/troubleshooting/index.md index a85f66cdf8b..ba06869b670 100644 --- a/docs/troubleshooting/index.md +++ b/docs/troubleshooting/index.md @@ -1,7 +1,7 @@ --- slug: /troubleshooting sidebar_label: 'Troubleshooting' -doc_type: 'reference' +doc_type: 'guide' keywords: [ 'clickhouse troubleshooting', 'clickhouse errors', diff --git a/docs/tutorial.md b/docs/tutorial.md index 836060a7d81..98cfc8224eb 100644 --- a/docs/tutorial.md +++ b/docs/tutorial.md @@ -6,7 +6,7 @@ description: 'Learn how to ingest and query data in ClickHouse using a New York sidebar_position: 0.5 keywords: ['clickhouse', 'install', 'tutorial', 'dictionary', 'dictionaries', 'example', 'advanced', 'taxi', 'new york', 'nyc'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- # Advanced Tutorial diff --git a/docs/use-cases/AI_ML/MCP/01_remote_mcp.md b/docs/use-cases/AI_ML/MCP/01_remote_mcp.md index 9a22b06683c..a8599a8f179 100644 --- a/docs/use-cases/AI_ML/MCP/01_remote_mcp.md +++ b/docs/use-cases/AI_ML/MCP/01_remote_mcp.md @@ -8,7 +8,7 @@ description: 'This guide explains how to enable and use the ClickHouse Cloud Rem keywords: ['AI', 'ClickHouse Cloud', 'MCP'] show_related_blogs: true sidebar_position: 1 -doc_type: 'how-to' +doc_type: 'guide' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/02_claude-desktop.md b/docs/use-cases/AI_ML/MCP/02_claude-desktop.md index eb2844c7280..664900e0b36 100644 --- a/docs/use-cases/AI_ML/MCP/02_claude-desktop.md +++ b/docs/use-cases/AI_ML/MCP/02_claude-desktop.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Claude Desktop with a ClickHouse MCP server.' keywords: ['AI', 'Librechat', 'MCP'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/03_librechat.md b/docs/use-cases/AI_ML/MCP/03_librechat.md index 83fd7a98f91..90ec522f813 100644 --- a/docs/use-cases/AI_ML/MCP/03_librechat.md +++ b/docs/use-cases/AI_ML/MCP/03_librechat.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This guide explains how to set up LibreChat with a ClickHouse MCP server using Docker.' keywords: ['AI', 'Librechat', 'MCP'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/04_anythingllm.md b/docs/use-cases/AI_ML/MCP/04_anythingllm.md index 937cc6addb4..bdc8894fd5a 100644 --- a/docs/use-cases/AI_ML/MCP/04_anythingllm.md +++ b/docs/use-cases/AI_ML/MCP/04_anythingllm.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This guide explains how to set up AnythingLLM with a ClickHouse MCP server using Docker.' keywords: ['AI', 'AnythingLLM', 'MCP'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/05_open-webui.md b/docs/use-cases/AI_ML/MCP/05_open-webui.md index 009ad8ec6a7..f11dbe535c5 100644 --- a/docs/use-cases/AI_ML/MCP/05_open-webui.md +++ b/docs/use-cases/AI_ML/MCP/05_open-webui.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Open WebUI with a ClickHouse MCP server using Docker.' keywords: ['AI', 'Open WebUI', 'MCP'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/06_ollama.md b/docs/use-cases/AI_ML/MCP/06_ollama.md index 0a39fd00e38..8b286158b11 100644 --- a/docs/use-cases/AI_ML/MCP/06_ollama.md +++ b/docs/use-cases/AI_ML/MCP/06_ollama.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Ollama with a ClickHouse MCP server.' keywords: ['AI', 'Ollama', 'MCP'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/07_janai.md b/docs/use-cases/AI_ML/MCP/07_janai.md index d14cbbc906c..5c6e2685fde 100644 --- a/docs/use-cases/AI_ML/MCP/07_janai.md +++ b/docs/use-cases/AI_ML/MCP/07_janai.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This guide explains how to set up Jan.ai with a ClickHouse MCP server.' keywords: ['AI', 'Jan.ai', 'MCP'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import {CardHorizontal} from '@clickhouse/click-ui/bundled' diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md index 5cdbe83aa77..c480ea7519a 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/agno.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how build an AI Agent with Agno and the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'Agno'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build an AI Agent with Agno and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md index 5b494197bd3..63ae9e20930 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/chainlit.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to use Chainlit to build LLM-based chat apps together with the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'Chainlit'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- # How to build an AI agent with Chainlit and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md index 8782fa7906d..bca912a4f28 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/copilotkit.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build an agentic application using data stored in ClickHouse with ClickHouse MCP and CopilotKit' keywords: ['ClickHouse', 'MCP', 'copilotkit'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- # How to build an AI agent with CopilotKit and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md index cbf0d847a28..2acbaa30302 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/dspy.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build an AI agent with DSPy and the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'DSPy'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build an AI Agent with DSPy and the ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md index 1fc2dc85a3a..832a73952b3 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/index.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null description: 'Learn how to build an AI agent with DSPy and the ClickHouse MCP Server' keywords: ['ClickHouse', 'Agno', 'Chainlit', 'MCP', 'DSPy', 'LangChain', 'LlamaIndex', 'OpenAI agents', 'PydanticAI', 'SlackBot', 'StreamLit'] -doc_type: 'reference' +doc_type: 'guide' --- # Guides for integrating AI agent libraries with ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md index 6c93c99d56e..3c58b2d8e69 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/langchain.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build a LangChain/LangGraph AI agent that can interact with ClickHouse''s SQL playground using ClickHouse''s MCP Server.' keywords: ['ClickHouse', 'MCP', 'LangChain', 'LangGraph'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build a LangChain/LangGraph AI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md index 03722907c98..c09bae9ba41 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/llamaindex.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build a LlamaIndex AI agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'LlamaIndex'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build a LlamaIndex AI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md index fe28de23751..cbd2cbda855 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/openai-agents.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build an OpenAI agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'OpenAI'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build an OpenAI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md index 9c2e19cd8c0..86bd69314c3 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/pydantic-ai.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build a PydanticAI agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'PydanticAI'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build a PydanticAI agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md index 3b031494cf1..5144129aba5 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/slackbot.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build a SlackBot agent that can interact with ClickHouse MCP Server.' keywords: ['ClickHouse', 'MCP', 'Slack', 'SlackBot', 'PydanticAI'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build a SlackBot agent using ClickHouse MCP Server diff --git a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md index 633e622555f..a2441bf3598 100644 --- a/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md +++ b/docs/use-cases/AI_ML/MCP/ai_agent_libraries/streamlit.md @@ -7,7 +7,7 @@ pagination_next: null description: 'Learn how to build a web-based AI Agent with Streamlit and the ClickHouse MCP Server' keywords: ['ClickHouse', 'MCP', 'Streamlit', 'Agno', 'AI Agent'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # How to build a ClickHouse-backed AI Agent with Streamlit diff --git a/docs/use-cases/AI_ML/MCP/index.md b/docs/use-cases/AI_ML/MCP/index.md index 67a00548b4a..a6ac4ba5dc4 100644 --- a/docs/use-cases/AI_ML/MCP/index.md +++ b/docs/use-cases/AI_ML/MCP/index.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This page provides an intro to Model Context Protocol (MCP) and has a table of contents for MCP guides.' keywords: ['ClickHouse', 'MCP'] show_related_blogs: true -doc_type: 'reference' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/AI_ML/ai-powered-sql-generation.md b/docs/use-cases/AI_ML/ai-powered-sql-generation.md index 3a7f026cf1e..3862d124931 100644 --- a/docs/use-cases/AI_ML/ai-powered-sql-generation.md +++ b/docs/use-cases/AI_ML/ai-powered-sql-generation.md @@ -7,7 +7,7 @@ pagination_next: null description: 'This guide explains how to use AI to generate SQL queries in ClickHouse Client or clickhouse-local.' keywords: ['AI', 'SQL generation'] show_related_blogs: true -doc_type: 'reference' +doc_type: 'guide' --- Starting from ClickHouse 25.7, [ClickHouse Client](https://clickhouse.com/docs/interfaces/cli) and [clickhouse-local](https://clickhouse.com/docs/operations/utilities/clickhouse-local) include [AI-powered functionality](https://clickhouse.com/docs/interfaces/cli#ai-sql-generation) that converts natural language descriptions into SQL queries. This feature allows users to describe their data requirements in plain text, which the system then translates into corresponding SQL statements. diff --git a/docs/use-cases/AI_ML/index.md b/docs/use-cases/AI_ML/index.md index b69c49ecb65..3ee09343b31 100644 --- a/docs/use-cases/AI_ML/index.md +++ b/docs/use-cases/AI_ML/index.md @@ -5,7 +5,7 @@ pagination_next: null slug: /use-cases/AI title: 'Machine learning and GenAI' keywords: ['machine learning', 'genAI', 'AI'] -doc_type: 'reference' +doc_type: 'landing-page' --- # Machine Learning and GenAI diff --git a/docs/use-cases/data_lake/glue_catalog.md b/docs/use-cases/data_lake/glue_catalog.md index c2d86ed3965..6106c9aa225 100644 --- a/docs/use-cases/data_lake/glue_catalog.md +++ b/docs/use-cases/data_lake/glue_catalog.md @@ -8,7 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data in S3 buckets using ClickHouse and the AWS Glue Data Catalog.' keywords: ['Glue', 'Data Lake'] show_related_blogs: true -doc_type: 'reference' +doc_type: 'guide' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/index.md b/docs/use-cases/data_lake/index.md index 0d7b4bca766..1243d345581 100644 --- a/docs/use-cases/data_lake/index.md +++ b/docs/use-cases/data_lake/index.md @@ -5,7 +5,7 @@ pagination_next: null slug: /use-cases/data-lake title: 'Data Lake' keywords: ['data lake', 'glue', 'unity', 'rest'] -doc_type: 'reference' +doc_type: 'landing-page' --- ClickHouse supports integration with multiple catalogs (Unity, Glue, REST, Polaris, etc.). diff --git a/docs/use-cases/data_lake/lakekeeper_catalog.md b/docs/use-cases/data_lake/lakekeeper_catalog.md index 33f8942da66..74164354a5a 100644 --- a/docs/use-cases/data_lake/lakekeeper_catalog.md +++ b/docs/use-cases/data_lake/lakekeeper_catalog.md @@ -8,7 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data using ClickHouse and the Lakekeeper Catalog.' keywords: ['Lakekeeper', 'REST', 'Tabular', 'Data Lake', 'Iceberg'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/nessie_catalog.md b/docs/use-cases/data_lake/nessie_catalog.md index 58b9716c7ec..aa79e4cff74 100644 --- a/docs/use-cases/data_lake/nessie_catalog.md +++ b/docs/use-cases/data_lake/nessie_catalog.md @@ -8,7 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data using ClickHouse and the Nessie Catalog.' keywords: ['Nessie', 'REST', 'Transactional', 'Data Lake', 'Iceberg', 'Git-like'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/rest_catalog.md b/docs/use-cases/data_lake/rest_catalog.md index 6b93ee05705..1c35ac8fd5b 100644 --- a/docs/use-cases/data_lake/rest_catalog.md +++ b/docs/use-cases/data_lake/rest_catalog.md @@ -8,7 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data using ClickHouse and the REST Catalog.' keywords: ['REST', 'Tabular', 'Data Lake', 'Iceberg'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/data_lake/unity_catalog.md b/docs/use-cases/data_lake/unity_catalog.md index 2b58d0c7ddb..46194da84c7 100644 --- a/docs/use-cases/data_lake/unity_catalog.md +++ b/docs/use-cases/data_lake/unity_catalog.md @@ -8,7 +8,7 @@ description: 'In this guide, we will walk you through the steps to query your data in S3 buckets using ClickHouse and the Unity Catalog.' keywords: ['Unity', 'Data Lake'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import ExperimentalBadge from '@theme/badges/ExperimentalBadge'; diff --git a/docs/use-cases/index.md b/docs/use-cases/index.md index dc73935cab9..60d105eb612 100644 --- a/docs/use-cases/index.md +++ b/docs/use-cases/index.md @@ -4,7 +4,7 @@ title: 'Use Case Guides' pagination_prev: null pagination_next: null description: 'Landing page for use case guides' -doc_type: 'reference' +doc_type: 'landing-page' --- In this section of the docs you can find our use case guides. diff --git a/docs/use-cases/observability/build-your-own/demo-application.md b/docs/use-cases/observability/build-your-own/demo-application.md index 45e71ce0f1d..050a4fc4218 100644 --- a/docs/use-cases/observability/build-your-own/demo-application.md +++ b/docs/use-cases/observability/build-your-own/demo-application.md @@ -3,7 +3,7 @@ title: 'Demo Application' description: 'Demo application for observability' slug: /observability/demo-application keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] -doc_type: 'reference' +doc_type: 'guide' --- The OpenTelemetry project includes a [demo application](https://opentelemetry.io/docs/demo/). A maintained fork of this application with ClickHouse as a data source for logs and traces can be found [here](https://github.com/ClickHouse/opentelemetry-demo). The [official demo instructions](https://opentelemetry.io/docs/demo/docker-deployment/) can be followed to deploy this demo with docker. In addition to the [existing components](https://opentelemetry.io/docs/demo/collector-data-flow-dashboard/), an instance of ClickHouse will be deployed and used for the storage of logs and traces. diff --git a/docs/use-cases/observability/build-your-own/grafana.md b/docs/use-cases/observability/build-your-own/grafana.md index e8ece161dee..70b0488b2bb 100644 --- a/docs/use-cases/observability/build-your-own/grafana.md +++ b/docs/use-cases/observability/build-your-own/grafana.md @@ -4,7 +4,7 @@ description: 'Using Grafana and ClickHouse for observability' slug: /observability/grafana keywords: ['Observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import observability_15 from '@site/static/images/use-cases/observability/observability-15.png'; diff --git a/docs/use-cases/observability/build-your-own/index.md b/docs/use-cases/observability/build-your-own/index.md index 04788ea8b26..5159ab1d4a4 100644 --- a/docs/use-cases/observability/build-your-own/index.md +++ b/docs/use-cases/observability/build-your-own/index.md @@ -4,7 +4,7 @@ title: 'Build Your Own Observability Stack' pagination_prev: null pagination_next: null description: 'Landing page building your own observability stack' -doc_type: 'reference' +doc_type: 'landing-page' --- This guide helps you build a custom observability stack using ClickHouse as the foundation. Learn how to design, implement, and optimize your observability solution for logs, metrics, and traces, with practical examples and best practices. diff --git a/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md b/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md index 2e351f80c75..6f87bccd860 100644 --- a/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md +++ b/docs/use-cases/observability/build-your-own/integrating-opentelemetry.md @@ -4,7 +4,7 @@ description: 'Integrating OpenTelemetry and ClickHouse for observability' slug: /observability/integrating-opentelemetry keywords: ['Observability', 'OpenTelemetry'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import observability_3 from '@site/static/images/use-cases/observability/observability-3.png'; diff --git a/docs/use-cases/observability/build-your-own/introduction.md b/docs/use-cases/observability/build-your-own/introduction.md index 9377cbd36c8..073298371ff 100644 --- a/docs/use-cases/observability/build-your-own/introduction.md +++ b/docs/use-cases/observability/build-your-own/introduction.md @@ -4,7 +4,7 @@ description: 'Using ClickHouse as an observability solution' slug: /use-cases/observability/introduction keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import observability_1 from '@site/static/images/use-cases/observability/observability-1.png'; diff --git a/docs/use-cases/observability/build-your-own/managing-data.md b/docs/use-cases/observability/build-your-own/managing-data.md index 83f9f0a6104..1413800ea1b 100644 --- a/docs/use-cases/observability/build-your-own/managing-data.md +++ b/docs/use-cases/observability/build-your-own/managing-data.md @@ -4,7 +4,7 @@ description: 'Managing Data for Observability' slug: /observability/managing-data keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- import observability_14 from '@site/static/images/use-cases/observability/observability-14.png'; diff --git a/docs/use-cases/observability/build-your-own/schema-design.md b/docs/use-cases/observability/build-your-own/schema-design.md index eb04f8fa7aa..770421d0bef 100644 --- a/docs/use-cases/observability/build-your-own/schema-design.md +++ b/docs/use-cases/observability/build-your-own/schema-design.md @@ -4,7 +4,7 @@ description: 'Designing a schema design for observability' keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] slug: /use-cases/observability/schema-design show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- import observability_10 from '@site/static/images/use-cases/observability/observability-10.png'; diff --git a/docs/use-cases/observability/clickstack/alerts.md b/docs/use-cases/observability/clickstack/alerts.md index 18918d32aa7..b228f222d4b 100644 --- a/docs/use-cases/observability/clickstack/alerts.md +++ b/docs/use-cases/observability/clickstack/alerts.md @@ -5,7 +5,7 @@ sidebar_label: 'Alerts' pagination_prev: null pagination_next: null description: 'Alerts with ClickStack' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/dashboards.md b/docs/use-cases/observability/clickstack/dashboards.md index 11140f6a87d..0284027d730 100644 --- a/docs/use-cases/observability/clickstack/dashboards.md +++ b/docs/use-cases/observability/clickstack/dashboards.md @@ -5,7 +5,7 @@ sidebar_label: 'Dashboards' pagination_prev: null pagination_next: null description: 'Visualizations and Dashboards with ClickStack' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/all-in-one.md b/docs/use-cases/observability/clickstack/deployment/all-in-one.md index 1e7c9e21b4d..db134182aeb 100644 --- a/docs/use-cases/observability/clickstack/deployment/all-in-one.md +++ b/docs/use-cases/observability/clickstack/deployment/all-in-one.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 0 description: 'Deploying ClickStack with All In One - The ClickHouse Observability Stack' -doc_type: 'tutorial' +doc_type: 'guide' --- import JSONSupport from '@site/docs/use-cases/observability/clickstack/deployment/_snippets/_json_support.md'; diff --git a/docs/use-cases/observability/clickstack/deployment/docker-compose.md b/docs/use-cases/observability/clickstack/deployment/docker-compose.md index 1e8cab48dbb..f8c2be3b4ae 100644 --- a/docs/use-cases/observability/clickstack/deployment/docker-compose.md +++ b/docs/use-cases/observability/clickstack/deployment/docker-compose.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 3 description: 'Deploying ClickStack with Docker Compose - The ClickHouse Observability Stack' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/helm.md b/docs/use-cases/observability/clickstack/deployment/helm.md index f7a8ff0964d..9119cd6bd85 100644 --- a/docs/use-cases/observability/clickstack/deployment/helm.md +++ b/docs/use-cases/observability/clickstack/deployment/helm.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 2 description: 'Deploying ClickStack with Helm - The ClickHouse Observability Stack' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md b/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md index caa263cd833..4d1f2215848 100644 --- a/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md +++ b/docs/use-cases/observability/clickstack/deployment/hyperdx-clickhouse-cloud.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 1 description: 'Deploying ClickStack with ClickHouse Cloud' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md b/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md index 6740181429b..75fbc0b37e3 100644 --- a/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md +++ b/docs/use-cases/observability/clickstack/deployment/hyperdx-only.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 4 description: 'Deploying HyperDX only' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/deployment/local-mode-only.md b/docs/use-cases/observability/clickstack/deployment/local-mode-only.md index ccf83858385..3c446fa25ad 100644 --- a/docs/use-cases/observability/clickstack/deployment/local-mode-only.md +++ b/docs/use-cases/observability/clickstack/deployment/local-mode-only.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null sidebar_position: 5 description: 'Deploying ClickStack with Local Mode Only - The ClickHouse Observability Stack' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/index.md b/docs/use-cases/observability/clickstack/example-datasets/index.md index acf94a79156..acfacdf3485 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/index.md +++ b/docs/use-cases/observability/clickstack/example-datasets/index.md @@ -4,7 +4,7 @@ title: 'Sample Datasets' pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and sample datasets' -doc_type: 'reference' +doc_type: 'landing-page' --- This section provides various sample datasets and examples to help you get started with ClickStack. These examples demonstrate different ways to work with observability data in ClickStack, from local development to production scenarios. diff --git a/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md b/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md index 6667d2a81fd..a2d23520514 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md +++ b/docs/use-cases/observability/clickstack/example-datasets/kubernetes.md @@ -5,7 +5,7 @@ sidebar_position: 1 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and monitoring Kubernetes' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/local-data.md b/docs/use-cases/observability/clickstack/example-datasets/local-data.md index ece449ddd76..4c3eef0c2b3 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/local-data.md +++ b/docs/use-cases/observability/clickstack/example-datasets/local-data.md @@ -5,7 +5,7 @@ sidebar_position: 1 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack local and system data and metrics' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md b/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md index 617a1be89b3..ee4af85dcc2 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md +++ b/docs/use-cases/observability/clickstack/example-datasets/remote-demo-data.md @@ -5,7 +5,7 @@ sidebar_position: 2 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and a remote demo dataset' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/example-datasets/sample-data.md b/docs/use-cases/observability/clickstack/example-datasets/sample-data.md index c1ea5575d34..e9add75accf 100644 --- a/docs/use-cases/observability/clickstack/example-datasets/sample-data.md +++ b/docs/use-cases/observability/clickstack/example-datasets/sample-data.md @@ -5,7 +5,7 @@ sidebar_position: 0 pagination_prev: null pagination_next: null description: 'Getting started with ClickStack and a sample dataset with logs, sessions, traces and metrics' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/getting-started.md b/docs/use-cases/observability/clickstack/getting-started.md index 881743eec89..c4785781d81 100644 --- a/docs/use-cases/observability/clickstack/getting-started.md +++ b/docs/use-cases/observability/clickstack/getting-started.md @@ -5,7 +5,7 @@ sidebar_label: 'Getting Started' pagination_prev: null pagination_next: use-cases/observability/clickstack/example-datasets/index description: 'Getting started with ClickStack - The ClickHouse Observability Stack' -doc_type: 'tutorial' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/index.md b/docs/use-cases/observability/clickstack/index.md index 13ef8181f5b..e1bbcf01c9d 100644 --- a/docs/use-cases/observability/clickstack/index.md +++ b/docs/use-cases/observability/clickstack/index.md @@ -4,7 +4,7 @@ title: 'ClickStack - The ClickHouse Observability Stack' pagination_prev: null pagination_next: null description: 'Landing page for the ClickHouse Observability Stack' -doc_type: 'reference' +doc_type: 'landing-page' --- **ClickStack** is a production-grade observability platform built on ClickHouse and OpenTelemetry (OTel), unifying logs, traces, metrics and session in a single high-performance solution. Designed for monitoring and debugging complex systems, ClickStack enables developers and SREs to trace issues end-to-end without switching between tools or manually stitching together data using timestamps or correlation IDs. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/collector.md b/docs/use-cases/observability/clickstack/ingesting-data/collector.md index 5e03a89744d..54352cbe98a 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/collector.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/collector.md @@ -5,7 +5,7 @@ pagination_next: null description: 'OpenTelemetry collector for ClickStack - The ClickHouse Observability Stack' sidebar_label: 'OpenTelemetry Collector' title: 'ClickStack OpenTelemetry Collector' -doc_type: 'reference' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/index.md b/docs/use-cases/observability/clickstack/ingesting-data/index.md index 8c4cfd2c982..b7371556a50 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/index.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/index.md @@ -4,7 +4,7 @@ pagination_prev: null pagination_next: null description: 'Data ingestion for ClickStack - The ClickHouse Observability Stack' title: 'Ingesting data' -doc_type: 'reference' +doc_type: 'landing-page' --- ClickStack provides multiple ways to ingest observability data into your ClickHouse instance. Whether you're collecting logs, metrics, traces, or session data, you can use the OpenTelemetry (OTel) collector as a unified ingestion point or leverage platform-specific integrations for specialized use cases. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md b/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md index 4335ce38499..4a9382df317 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/kubernetes.md @@ -4,7 +4,7 @@ pagination_prev: null pagination_next: null description: 'Kubernetes integration for ClickStack - The ClickHouse Observability Stack' title: 'Kubernetes' -doc_type: 'tutorial' +doc_type: 'guide' --- ClickStack uses the OpenTelemetry (OTel) collector to collect logs, metrics, and Kubernetes events from Kubernetes clusters and forward them to ClickStack. We support the native OTel log format and require no additional vendor-specific configuration. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md b/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md index 6db1e4fce1e..087026e7c17 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/opentelemetry.md @@ -4,7 +4,7 @@ pagination_prev: null pagination_next: null description: 'Data ingestion with OpenTelemetry for ClickStack - The ClickHouse Observability Stack' title: 'Ingesting with OpenTelemetry' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/overview.md b/docs/use-cases/observability/clickstack/ingesting-data/overview.md index 4e8dca1aaed..d41285a9b79 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/overview.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/overview.md @@ -6,7 +6,7 @@ sidebar_position: 0 pagination_prev: null pagination_next: use-cases/observability/clickstack/ingesting-data/opentelemetry description: 'Overview for ingesting data to ClickStack' -doc_type: 'explanation' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md index e20fd8701da..c30b6658f0c 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/aws-lambda.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 6 description: 'AWS Lambda for ClickStack - The ClickHouse Observability Stack' title: 'AWS Lambda' -doc_type: 'how-to' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md index ff1b72019ff..93b291d425c 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/browser.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 0 description: 'Browser SDK for ClickStack - The ClickHouse Observability Stack' title: 'Browser JS' -doc_type: 'how-to' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md index 73d2e15eecf..b3adedd347f 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/deno.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 6 description: 'Deno SDK for ClickStack - The ClickHouse Observability Stack' title: 'Deno' -doc_type: 'how-to' +doc_type: 'guide' --- This guide Integrates the following: diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md index 9780f3ac66a..d54832800e6 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/elixir.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 1 description: 'Elixir SDK for ClickStack - The ClickHouse Observability Stack' title: 'Elixir' -doc_type: 'how-to' +doc_type: 'guide' ---
diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md index af155d88936..835fd056092 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/golang.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 2 description: 'Golang SDK for ClickStack - The ClickHouse Observability Stack' title: 'Golang' -doc_type: 'tutorial' +doc_type: 'guide' --- ClickStack uses the OpenTelemetry standard for collecting telemetry data (logs and diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md index 684740f170f..2a4b87323bb 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/index.md @@ -4,7 +4,7 @@ pagination_prev: null pagination_next: null description: 'Language SDKs for ClickStack - The ClickHouse Observability Stack' title: 'Language SDKs' -doc_type: 'reference' +doc_type: 'guide' --- Users typically send data to ClickStack via the **OpenTelemetry (OTel) collector**, either directly from language SDKs or through intermediate OpenTelemetry collector acting as agents e.g. collecting infrastructure metrics and logs. diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md index 99d2ad3ad81..1eacb038a4b 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/java.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 3 description: 'Java SDK for ClickStack - The ClickHouse Observability Stack' title: 'Java' -doc_type: 'how-to' +doc_type: 'guide' --- ClickStack uses the OpenTelemetry standard for collecting telemetry data (logs and diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md index 944d18189f2..9e0414bf592 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nestjs.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 4 description: 'NestJS SDK for ClickStack - The ClickHouse Observability Stack' title: 'NestJS' -doc_type: 'how-to' +doc_type: 'guide' --- The ClickStack NestJS integration allows you to create a logger or use the default diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md index 4cc30ebd9bb..1de85c02ba4 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nextjs.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 4 description: 'Next.js SDK for ClickStack - The ClickHouse Observability Stack' title: 'Next.js' -doc_type: 'how-to' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md index 0d24736745a..f4cf384497c 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/nodejs.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 5 description: 'Node.js SDK for ClickStack - The ClickHouse Observability Stack' title: 'Node.js' -doc_type: 'tutorial' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md index 9c13f8d5f43..90e26a514ef 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/python.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 7 description: 'Python for ClickStack - The ClickHouse Observability Stack' title: 'Python' -doc_type: 'how-to' +doc_type: 'guide' --- import Tabs from '@theme/Tabs'; diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md index 008cd934363..4549941ed31 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/react-native.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 7 description: 'React Native SDK for ClickStack - The ClickHouse Observability Stack' title: 'React Native' -doc_type: 'how-to' +doc_type: 'guide' --- The ClickStack React Native SDK allows you to instrument your React Native diff --git a/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md b/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md index 84eade69bc2..4ff6f6f93ce 100644 --- a/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md +++ b/docs/use-cases/observability/clickstack/ingesting-data/sdks/ruby.md @@ -5,7 +5,7 @@ pagination_next: null sidebar_position: 7 description: 'Ruby on Rails SDK for ClickStack - The ClickHouse Observability Stack' title: 'Ruby on Rails' -doc_type: 'tutorial' +doc_type: 'guide' --- This guide integrates: diff --git a/docs/use-cases/observability/clickstack/migration/elastic/concepts.md b/docs/use-cases/observability/clickstack/migration/elastic/concepts.md index f6b17e3a2c8..db96a4fba48 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/concepts.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/concepts.md @@ -8,7 +8,7 @@ sidebar_position: 1 description: 'Equivalent concepts - ClickStack and Elastic' show_related_blogs: true keywords: ['Elasticsearch'] -doc_type: 'explanation' +doc_type: 'reference' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/elastic/index.md b/docs/use-cases/observability/clickstack/migration/elastic/index.md index c11f0a761e4..217c16e534f 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/index.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/index.md @@ -6,7 +6,7 @@ pagination_next: null description: 'Landing page migrating to the ClickHouse Observability Stack from Elastic' show_related_blogs: true keywords: ['Elasticsearch'] -doc_type: 'reference' +doc_type: 'landing-page' --- This guide provides a comprehensive approach to migrating from Elastic Stack to ClickStack. We focus on a parallel operation strategy that minimizes risk while leveraging ClickHouse's strengths in observability workloads. diff --git a/docs/use-cases/observability/clickstack/migration/elastic/intro.md b/docs/use-cases/observability/clickstack/migration/elastic/intro.md index be53fc980db..ea874d54f85 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/intro.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/intro.md @@ -8,7 +8,7 @@ sidebar_position: 0 description: 'Overview for migrating to the ClickHouse Observability Stack from Elastic' show_related_blogs: true keywords: ['Elasticsearch'] -doc_type: 'explanation' +doc_type: 'guide' --- ## Migrating to ClickStack from Elastic {#migrating-to-clickstack-from-elastic} diff --git a/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md b/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md index a441e1a97f7..0effc78a1f4 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/migrating-agents.md @@ -8,7 +8,7 @@ sidebar_position: 5 description: 'Migrating agents from Elastic' show_related_blogs: true keywords: ['ClickStack'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md b/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md index 27279e1580c..04439bbe8be 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/migrating-data.md @@ -8,7 +8,7 @@ sidebar_position: 4 description: 'Migrating data to ClickHouse Observability Stack from Elastic' show_related_blogs: true keywords: ['ClickStack'] -doc_type: 'tutorial' +doc_type: 'guide' --- ## Parallel operation strategy {#parallel-operation-strategy} diff --git a/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md b/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md index 640cc1cadef..f83c6bfc770 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/migrating-sdks.md @@ -8,7 +8,7 @@ sidebar_position: 6 description: 'Migrating SDKs from Elastic' show_related_blogs: true keywords: ['ClickStack'] -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/elastic/search.md b/docs/use-cases/observability/clickstack/migration/elastic/search.md index 4d3de3559c0..15be70e22de 100644 --- a/docs/use-cases/observability/clickstack/migration/elastic/search.md +++ b/docs/use-cases/observability/clickstack/migration/elastic/search.md @@ -6,7 +6,7 @@ pagination_next: null sidebar_label: 'Search' sidebar_position: 3 description: 'Searching in ClickStack and Elastic' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/migration/index.md b/docs/use-cases/observability/clickstack/migration/index.md index 2c73da6f557..a8875f6af5c 100644 --- a/docs/use-cases/observability/clickstack/migration/index.md +++ b/docs/use-cases/observability/clickstack/migration/index.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null sidebar_label: 'Migration guides' description: 'Migrating to ClickStack from other Observability solutions' -doc_type: 'how-to' +doc_type: 'guide' --- This section provides comprehensive guides for migrating from various observability solutions to ClickStack. Each guide includes detailed instructions for transitioning your data, agents, and workflows while maintaining operational continuity. diff --git a/docs/use-cases/observability/clickstack/overview.md b/docs/use-cases/observability/clickstack/overview.md index 733376b176b..54c1f0f3a74 100644 --- a/docs/use-cases/observability/clickstack/overview.md +++ b/docs/use-cases/observability/clickstack/overview.md @@ -5,7 +5,7 @@ sidebar_label: 'Overview' pagination_prev: null pagination_next: use-cases/observability/clickstack/getting-started description: 'Overview for ClickStack - The ClickHouse Observability Stack' -doc_type: 'explanation' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/production.md b/docs/use-cases/observability/clickstack/production.md index 5cd038a01ad..3c01ef4fc1d 100644 --- a/docs/use-cases/observability/clickstack/production.md +++ b/docs/use-cases/observability/clickstack/production.md @@ -5,7 +5,7 @@ sidebar_label: 'Production' pagination_prev: null pagination_next: null description: 'Going to production with ClickStack' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/search.md b/docs/use-cases/observability/clickstack/search.md index 7d0fb5a4391..67d3fecd284 100644 --- a/docs/use-cases/observability/clickstack/search.md +++ b/docs/use-cases/observability/clickstack/search.md @@ -5,7 +5,7 @@ sidebar_label: 'Search' pagination_prev: null pagination_next: null description: 'Search with ClickStack' -doc_type: 'how-to' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/use-cases/observability/clickstack/ttl.md b/docs/use-cases/observability/clickstack/ttl.md index 786a32fd128..5abfc587ad8 100644 --- a/docs/use-cases/observability/clickstack/ttl.md +++ b/docs/use-cases/observability/clickstack/ttl.md @@ -5,7 +5,7 @@ sidebar_label: 'Managing TTL' pagination_prev: null pagination_next: null description: 'Managing TTL with ClickStack' -doc_type: 'tutorial' +doc_type: 'guide' --- import observability_14 from '@site/static/images/use-cases/observability/observability-14.png'; diff --git a/docs/use-cases/observability/index.md b/docs/use-cases/observability/index.md index ad8737e6f78..67948a5a0cd 100644 --- a/docs/use-cases/observability/index.md +++ b/docs/use-cases/observability/index.md @@ -5,7 +5,7 @@ pagination_prev: null pagination_next: null description: 'Landing page for the Observability use case guide' keywords: ['observability', 'logs', 'traces', 'metrics', 'OpenTelemetry', 'Grafana', 'OTel'] -doc_type: 'reference' +doc_type: 'guide' --- ClickHouse offers unmatched speed, scale, and cost-efficiency for observability. This guide provides two paths depending on your needs: diff --git a/docs/use-cases/time-series/basic-operations.md b/docs/use-cases/time-series/basic-operations.md index 634bbd829b1..0a4d2d7037f 100644 --- a/docs/use-cases/time-series/basic-operations.md +++ b/docs/use-cases/time-series/basic-operations.md @@ -5,7 +5,7 @@ description: 'Basic time-series operations in ClickHouse.' slug: /use-cases/time-series/basic-operations keywords: ['time-series'] show_related_blogs: true -doc_type: 'tutorial' +doc_type: 'guide' --- # Basic time-series operations diff --git a/docs/use-cases/time-series/index.md b/docs/use-cases/time-series/index.md index 5d4d59a8c6c..050c1fcfc13 100644 --- a/docs/use-cases/time-series/index.md +++ b/docs/use-cases/time-series/index.md @@ -4,7 +4,7 @@ slug: /use-cases/time-series title: 'Time-Series' pagination_prev: null pagination_next: null -doc_type: 'reference' +doc_type: 'guide' --- Welcome to our time-series use case guide. In this guide you'll learn how you can get setup and use ClickHouse for time-series. diff --git a/docs/use-cases/time-series/query-performance.md b/docs/use-cases/time-series/query-performance.md index a9ef5905b0c..11de0077bf2 100644 --- a/docs/use-cases/time-series/query-performance.md +++ b/docs/use-cases/time-series/query-performance.md @@ -5,7 +5,7 @@ description: 'Improving time-series query performance' slug: /use-cases/time-series/query-performance keywords: ['time-series'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # Time-series query performance diff --git a/docs/use-cases/time-series/storage-efficiency.md b/docs/use-cases/time-series/storage-efficiency.md index f16dd692205..1a908b791cb 100644 --- a/docs/use-cases/time-series/storage-efficiency.md +++ b/docs/use-cases/time-series/storage-efficiency.md @@ -5,7 +5,7 @@ description: 'Improving time-series storage efficiency' slug: /use-cases/time-series/storage-efficiency keywords: ['time-series'] show_related_blogs: true -doc_type: 'how-to' +doc_type: 'guide' --- # Time-series storage efficiency diff --git a/docs/whats-new/changelog/2017.md b/docs/whats-new/changelog/2017.md index a0cfbb25ae9..b4062c984cf 100644 --- a/docs/whats-new/changelog/2017.md +++ b/docs/whats-new/changelog/2017.md @@ -4,7 +4,7 @@ sidebar_position: 10 sidebar_label: '2017' title: '2017 Changelog' description: 'Changelog for 2017' -doc_type: 'reference' +doc_type: 'changelog' --- ### ClickHouse Release 1.1.54327, 2017-12-21 {#clickhouse-release-1-1-54327-2017-12-21} diff --git a/docs/whats-new/changelog/2018.md b/docs/whats-new/changelog/2018.md index 923f2757b79..ed37477fde9 100644 --- a/docs/whats-new/changelog/2018.md +++ b/docs/whats-new/changelog/2018.md @@ -4,7 +4,7 @@ sidebar_position: 9 sidebar_label: '2018' title: '2018 Changelog' description: 'Changelog for 2018' -doc_type: 'reference' +doc_type: 'changelog' --- ## ClickHouse Release 18.16 {#clickhouse-release-18-16} diff --git a/docs/whats-new/changelog/2019.md b/docs/whats-new/changelog/2019.md index 01b143ed38c..95e699e6604 100644 --- a/docs/whats-new/changelog/2019.md +++ b/docs/whats-new/changelog/2019.md @@ -4,7 +4,7 @@ sidebar_position: 8 sidebar_label: '2019' title: '2019 Changelog' description: 'Changelog for 2019' -doc_type: 'reference' +doc_type: 'changelog' --- ## ClickHouse Release 19.17 {#clickhouse-release-v19-17} diff --git a/docs/whats-new/changelog/2020.md b/docs/whats-new/changelog/2020.md index ba9861cced1..c4be50ead1f 100644 --- a/docs/whats-new/changelog/2020.md +++ b/docs/whats-new/changelog/2020.md @@ -4,7 +4,7 @@ sidebar_position: 7 sidebar_label: '2020' title: '2020 Changelog' description: 'Changelog for 2020' -doc_type: 'reference' +doc_type: 'changelog' --- ### ClickHouse release 20.12 {#clickhouse-release-2012} diff --git a/docs/whats-new/changelog/2021.md b/docs/whats-new/changelog/2021.md index d3aa52af67e..092f4749451 100644 --- a/docs/whats-new/changelog/2021.md +++ b/docs/whats-new/changelog/2021.md @@ -4,7 +4,7 @@ sidebar_position: 6 sidebar_label: '2021' title: '2021 Changelog' description: 'Changelog for 2021' -doc_type: 'reference' +doc_type: 'changelog' --- ### ClickHouse release v21.12, 2021-12-15 {#clickhouse-release-v2112-2021-12-15} diff --git a/docs/whats-new/changelog/2022.md b/docs/whats-new/changelog/2022.md index a6c2aa5f964..adeae8e0200 100644 --- a/docs/whats-new/changelog/2022.md +++ b/docs/whats-new/changelog/2022.md @@ -4,7 +4,7 @@ sidebar_position: 5 sidebar_label: '2022' title: '2022 Changelog' description: 'Changelog for 2022' -doc_type: 'reference' +doc_type: 'changelog' --- ### ClickHouse release 22.12, 2022-12-15 {#a-id2212a-clickhouse-release-2212-2022-12-15} diff --git a/docs/whats-new/changelog/2023.md b/docs/whats-new/changelog/2023.md index 77ed4292386..11058c59dce 100644 --- a/docs/whats-new/changelog/2023.md +++ b/docs/whats-new/changelog/2023.md @@ -4,7 +4,7 @@ sidebar_position: 4 sidebar_label: '2023' title: '2023 Changelog' description: 'Changelog for 2023' -doc_type: 'reference' +doc_type: 'changelog' --- ### Table of Contents {#table-of-contents} diff --git a/docs/whats-new/changelog/2024.md b/docs/whats-new/changelog/2024.md index 2d8f3bd4e60..6c28c3cab7b 100644 --- a/docs/whats-new/changelog/2024.md +++ b/docs/whats-new/changelog/2024.md @@ -4,7 +4,7 @@ sidebar_position: 3 sidebar_label: '2024' title: '2024 Changelog' description: 'Changelog for 2024' -doc_type: 'reference' +doc_type: 'changelog' --- ### Table of Contents {#table-of-contents} diff --git a/docs/whats-new/changelog/cloud.md b/docs/whats-new/changelog/cloud.md index 6e6457f54c6..b92e2cc8909 100644 --- a/docs/whats-new/changelog/cloud.md +++ b/docs/whats-new/changelog/cloud.md @@ -4,7 +4,7 @@ sidebar_label: 'Cloud' title: 'Cloud Changelog' slug: /whats-new/changelog/cloud description: 'Learn about Cloud Changelog' -doc_type: 'reference' +doc_type: 'changelog' --- # Cloud Changelog diff --git a/docs/whats-new/changelog/index.md b/docs/whats-new/changelog/index.md index 94cdd9f1e17..a8807622ca2 100644 --- a/docs/whats-new/changelog/index.md +++ b/docs/whats-new/changelog/index.md @@ -5,10 +5,11 @@ slug: /whats-new/changelog/ sidebar_position: 2 sidebar_label: '2025' title: '2025 Changelog' -doc_type: 'reference' +doc_type: 'changelog' --- ### Table of Contents +**[ClickHouse release v25.8, 2025-08-28](#258)**
**[ClickHouse release v25.7, 2025-07-24](#257)**
**[ClickHouse release v25.6, 2025-06-26](#256)**
**[ClickHouse release v25.5, 2025-05-22](#255)**
@@ -26,6 +27,321 @@ doc_type: 'reference' **[Changelog for 2017](https://clickhouse.com/docs/whats-new/changelog/2017/)**
+### ClickHouse release 25.8, 2025-08-28 {#258} + +#### Backward Incompatible Change +* All the allocations done by external libraries are now visible to ClickHouse's memory tracker and accounted properly. This may result in "increased" reported memory usage for certain queries or failures with `MEMORY_LIMIT_EXCEEDED`. [#84082](https://github.com/ClickHouse/ClickHouse/pull/84082) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)). +* Infer `Array(Dynamic)` instead of unnamed `Tuple` for arrays of values with different types in JSON. To use the previous behaviour, disable setting `input_format_json_infer_array_of_dynamic_from_array_of_different_types`. [#80859](https://github.com/ClickHouse/ClickHouse/pull/80859) ([Pavel Kruglov](https://github.com/Avogar)). +* Move S3 latency metrics to histograms for homogeneity and simplicity. [#82305](https://github.com/ClickHouse/ClickHouse/pull/82305) ([Miсhael Stetsyuk](https://github.com/mstetsyuk)). +* Require backticks around identifiers with dots in default expressions to prevent them from being parsed as compound identifiers. [#83162](https://github.com/ClickHouse/ClickHouse/pull/83162) ([Pervakov Grigorii](https://github.com/GrigoryPervakov)). +* Lazy materialization is enabled only with analyzer (which is the default) to avoid maintenance without analyzer, — which, in our experience, have some issues (for example, when using `indexHint()` in conditions). [#83791](https://github.com/ClickHouse/ClickHouse/pull/83791) ([Igor Nikonov](https://github.com/devcrafter)). +* Write values of `Enum` type as `BYTE_ARRAY` with `ENUM` logical type in Parquet output format by default. [#84169](https://github.com/ClickHouse/ClickHouse/pull/84169) ([Pavel Kruglov](https://github.com/Avogar)). +* Enable MergeTree setting `write_marks_for_substreams_in_compact_parts` by default. It significantly improves performance of subcolumns reading from newly created Compact parts. Servers with version less then 25.5 won't be able to read new Compact parts. [#84171](https://github.com/ClickHouse/ClickHouse/pull/84171) ([Pavel Kruglov](https://github.com/Avogar)). +* The previous `concurrent_threads_scheduler` default value was `round_robin`, which proved unfair in the presence of a high number of single-threaded queries (e.g., INSERTs). This change makes a safer alternative `fair_round_robin` scheduler, the default. [#84747](https://github.com/ClickHouse/ClickHouse/pull/84747) ([Sergei Trifonov](https://github.com/serxa)). +* ClickHouse supports PostgreSQL-style heredoc syntax: `$tag$ string contents... $tag$`, also known as dollar-quoted string literals. In previous versions, there were fewer restrictions on tags: they could contain arbitrary characters, including punctuation and whitespace. This introduces parsing ambiguity with identifiers that can also start with a dollar character. At the same time, PostgreSQL only allows word characters for tags. To resolve the problem, we now restrict heredoc tags only to contain word characters. Closes [#84731](https://github.com/ClickHouse/ClickHouse/issues/84731). [#84846](https://github.com/ClickHouse/ClickHouse/pull/84846) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* The functions `azureBlobStorage`, `deltaLakeAzure`, and `icebergAzure` have been updated to properly validate `AZURE` permissions. All cluster-variant functions (`-Cluster` functions) now verify permissions against their corresponding non-clustered counterparts. Additionally, the `icebergLocal` and `deltaLakeLocal` functions now enforce `FILE` permission checks. [#84938](https://github.com/ClickHouse/ClickHouse/pull/84938) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)). +* Enables `allow_dynamic_metadata_for_data_lakes` setting (Table Engine level setting) by default. [#85044](https://github.com/ClickHouse/ClickHouse/pull/85044) ([Daniil Ivanik](https://github.com/divanik)). + +#### New Feature +* Basic support for the PromQL dialect is added. To use it, set `dialect='promql'` in clickhouse-client, point it to the TimeSeries table using the setting `promql_table_name='X'` and execute queries like `rate(ClickHouseProfileEvents_ReadCompressedBytes[1m])[5m:1m]`. In addition you can wrap the PromQL query with SQL: `SELECT * FROM prometheusQuery('up', ...);`. So far only functions `rate`, `delta` and `increase` are supported. No unary/binary operators. No HTTP API. [#75036](https://github.com/ClickHouse/ClickHouse/pull/75036) ([Vitaly Baranov](https://github.com/vitlibar)). +* AI Powered SQL generation can now infer from env ANTHROPIC_API_KEY and OPENAI_API_KEY if available, this is to make it so that we can have a zero config option to use this feature. [#83787](https://github.com/ClickHouse/ClickHouse/pull/83787) ([Kaushik Iska](https://github.com/iskakaushik)). +* Implement support for [ArrowFlight RPC](https://arrow.apache.org/docs/format/Flight.html) protocol by adding: - new table function `arrowflight`. [#74184](https://github.com/ClickHouse/ClickHouse/pull/74184) ([zakr600](https://github.com/zakr600)). +* Now all tables support the `_table` virtual column (not only tables with the `Merge` engine), which is especially useful for queries with UNION ALL. [#63665](https://github.com/ClickHouse/ClickHouse/pull/63665) ([Xiaozhe Yu](https://github.com/wudidapaopao)). +* Allow to use any storage policy (i.e. object storage, such as S3) for external aggregation/sorting. [#84734](https://github.com/ClickHouse/ClickHouse/pull/84734) ([Azat Khuzhin](https://github.com/azat)). +* Implement AWS S3 authentication with an explicitly provided IAM role. Implement OAuth for GCS. These features were recently only available in ClickHouse Cloud and are now open-sourced. Synchronize some interfaces such as serialization of the connection parameters for object storages. [#84011](https://github.com/ClickHouse/ClickHouse/pull/84011) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Support position deletes for Iceberg TableEngine. [#83094](https://github.com/ClickHouse/ClickHouse/pull/83094) ([Daniil Ivanik](https://github.com/divanik)). +* Support Iceberg Equality Deletes. [#85843](https://github.com/ClickHouse/ClickHouse/pull/85843) ([Han Fei](https://github.com/hanfei1991)). +* Iceberg writes for create. Closes [#83927](https://github.com/ClickHouse/ClickHouse/issues/83927). [#83983](https://github.com/ClickHouse/ClickHouse/pull/83983) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Glue catalogs for writes. [#84136](https://github.com/ClickHouse/ClickHouse/pull/84136) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Iceberg Rest catalogs for writes. [#84684](https://github.com/ClickHouse/ClickHouse/pull/84684) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Merge all iceberg position delete files into data files. This will reduce amount and sizes of parquet files in iceberg storage. Syntax: `OPTIMIZE TABLE table_name`. [#85250](https://github.com/ClickHouse/ClickHouse/pull/85250) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Support `drop table` for iceberg (Removing from REST/Glue catalogs + removing metadata about table). [#85395](https://github.com/ClickHouse/ClickHouse/pull/85395) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Support alter delete mutations for iceberg in merge-on-read format. [#85549](https://github.com/ClickHouse/ClickHouse/pull/85549) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Support writes into DeltaLake. Closes [#79603](https://github.com/ClickHouse/ClickHouse/issues/79603). [#85564](https://github.com/ClickHouse/ClickHouse/pull/85564) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Added setting `delta_lake_snapshot_version` to allow reading specific snapshot version in table engine `DeltaLake`. [#85295](https://github.com/ClickHouse/ClickHouse/pull/85295) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Write more iceberg statistics (column sizes, lower and upper bounds) in metadata (manifest entries) for min-max pruning. [#85746](https://github.com/ClickHouse/ClickHouse/pull/85746) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Support add/drop/modify columns in iceberg for simple types. [#85769](https://github.com/ClickHouse/ClickHouse/pull/85769) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Iceberg: support writing version-hint file. This closes [#85097](https://github.com/ClickHouse/ClickHouse/issues/85097). [#85130](https://github.com/ClickHouse/ClickHouse/pull/85130) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Views, created by ephemeral users, will now store a copy of an actual user and will no longer be invalidated after the ephemeral user is deleted. [#84763](https://github.com/ClickHouse/ClickHouse/pull/84763) ([pufit](https://github.com/pufit)). +* The vector similarity index now supports binary quantization. Binary quantization significantly reduces the memory consumption and speeds up the process of building a vector index (due to faster distance calculation). Also, the existing setting `vector_search_postfilter_multiplier `was made obsolete and replaced by a more general setting : `vector_search_index_fetch_multiplier`. [#85024](https://github.com/ClickHouse/ClickHouse/pull/85024) ([Shankar Iyer](https://github.com/shankar-iyer)). +* Allow key value arguments in `s3` or `s3Cluster` table engine/function, e.g. for example `s3('url', CSV, structure = 'a Int32', compression_method = 'gzip')`. [#85134](https://github.com/ClickHouse/ClickHouse/pull/85134) ([Kseniia Sumarokova](https://github.com/kssenii)). +* A new system table to keep erroneous incoming messages from engines like kafka ("dead letter queue"). [#68873](https://github.com/ClickHouse/ClickHouse/pull/68873) ([Ilya Golshtein](https://github.com/ilejn)). +* The new SYSTEM RESTORE DATABASE REPLICA for Replicated databases, similar to the existing functionality for restore in ReplicatedMergeTree. [#73100](https://github.com/ClickHouse/ClickHouse/pull/73100) ([Konstantin Morozov](https://github.com/k-morozov)). +* PostgreSQL protocol now supports the `COPY` command. [#74344](https://github.com/ClickHouse/ClickHouse/pull/74344) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Support C# client for mysql protocol. This closes [#83992](https://github.com/ClickHouse/ClickHouse/issues/83992). [#84397](https://github.com/ClickHouse/ClickHouse/pull/84397) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Add support for hive partition style reads and writes. [#76802](https://github.com/ClickHouse/ClickHouse/pull/76802) ([Arthur Passos](https://github.com/arthurpassos)). +* Add `zookeeper_connection_log` system table to store historical information about ZooKeeper connections. [#79494](https://github.com/ClickHouse/ClickHouse/pull/79494) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)). +* Server setting `cpu_slot_preemption` enables preemptive CPU scheduling for workloads and ensures max-min fair allocation of CPU time among workloads. New workload settings for CPU throttling are added: `max_cpus`, `max_cpu_share` and `max_burst_cpu_seconds`. More details: https://clickhouse.com/docs/operations/workload-scheduling#cpu_scheduling. [#80879](https://github.com/ClickHouse/ClickHouse/pull/80879) ([Sergei Trifonov](https://github.com/serxa)). +* Drop TCP connection after a configured number of queries or time threshold. This makes sense for a more uniform connection distribution between cluster nodes behind a load balancer. Resolves [#68000](https://github.com/ClickHouse/ClickHouse/issues/68000). [#81472](https://github.com/ClickHouse/ClickHouse/pull/81472) ([Kenny Sun](https://github.com/hwabis)). +* Parallel replicas now support using projections for queries. [#82659](https://github.com/ClickHouse/ClickHouse/issues/82659). [#82807](https://github.com/ClickHouse/ClickHouse/pull/82807) ([zoomxi](https://github.com/zoomxi)). +* Support DESCRIBE SELECT in addition to DESCRIBE (SELECT ...). [#82947](https://github.com/ClickHouse/ClickHouse/pull/82947) ([Yarik Briukhovetskyi](https://github.com/yariks5s)). +* Force secure connection for mysql_port and postgresql_port. [#82962](https://github.com/ClickHouse/ClickHouse/pull/82962) ([tiandiwonder](https://github.com/tiandiwonder)). +* Users can now do case-insensitive JSON key lookups using `JSONExtractCaseInsensitive` (and other variants of `JSONExtract`). [#83770](https://github.com/ClickHouse/ClickHouse/pull/83770) ([Alistair Evans](https://github.com/alistairjevans)). +* Introduction of `system.completions` table. Closes [#81889](https://github.com/ClickHouse/ClickHouse/issues/81889). [#83833](https://github.com/ClickHouse/ClickHouse/pull/83833) ([|2ustam](https://github.com/RuS2m)). +* Added a new function `nowInBlock64`. Example usage: `SELECT nowInBlock64(6)` returns `2025-07-29 17:09:37.775725`. [#84178](https://github.com/ClickHouse/ClickHouse/pull/84178) ([Halersson Paris](https://github.com/halersson)). +* Add extra_credentials to AzureBlobStorage to authenticate with client_id and tenant_id. [#84235](https://github.com/ClickHouse/ClickHouse/pull/84235) ([Pablo Marcos](https://github.com/pamarcos)). +* Added function `dateTimeToUUIDv7` to convert a DateTime value to a UUIDv7. Example usage: `SELECT dateTimeToUUIDv7(toDateTime('2025-08-15 18:57:56'))` returns `0198af18-8320-7a7d-abd3-358db23b9d5c`. [#84319](https://github.com/ClickHouse/ClickHouse/pull/84319) ([samradovich](https://github.com/samradovich)). +* `timeSeriesDerivToGrid` and `timeSeriesPredictLinearToGrid` aggregate functions to re-sample data to a time grid defined by the specified start timestamp, end timestamp, and step; calculates PromQL-like `deriv` and `predict_linear`, respectively. [#84328](https://github.com/ClickHouse/ClickHouse/pull/84328) ([Stephen Chi](https://github.com/stephchi0)). +* Add two new TimeSeries functions: - `timeSeriesRange(start_timestamp, end_timestamp, step)`, - `timeSeriesFromGrid(start_timestamp, end_timestamp, step, values)`,. [#85435](https://github.com/ClickHouse/ClickHouse/pull/85435) ([Vitaly Baranov](https://github.com/vitlibar)). +* New syntax added `GRANT READ ON S3('s3://foo/.*') TO user`. [#84503](https://github.com/ClickHouse/ClickHouse/pull/84503) ([pufit](https://github.com/pufit)). +* Added `Hash` as a new output format. It calculates a single hash value for all columns and rows of the result. This is useful for calculating a "fingerprint" of the result, for example, in use cases where data transfer is a bottleneck. Example: `SELECT arrayJoin(['abc', 'def']), 42 FORMAT Hash` returns `e5f9e676db098fdb9530d2059d8c23ef`. [#84607](https://github.com/ClickHouse/ClickHouse/pull/84607) ([Robert Schulze](https://github.com/rschu1ze)). +* Add the ability to set up arbitrary watches in Keeper Multi queries. [#84964](https://github.com/ClickHouse/ClickHouse/pull/84964) ([Mikhail Artemenko](https://github.com/Michicosun)). +* Adds an option `--max-concurrency` for the `clickhouse-benchmark` tool that enables a mode with a gradual increase in the number of parallel queries. [#85623](https://github.com/ClickHouse/ClickHouse/pull/85623) ([Sergei Trifonov](https://github.com/serxa)). +* TODO: what's that? Support partially aggregated metrics. [#85328](https://github.com/ClickHouse/ClickHouse/pull/85328) ([Mikhail Artemenko](https://github.com/Michicosun)). + +#### Experimental Feature +* Enable correlated subqueries support by default, they are no longer experimental. [#85107](https://github.com/ClickHouse/ClickHouse/pull/85107) ([Dmitry Novik](https://github.com/novikd)). +* Unity, Glue, Rest, and Hive Metastore data lake catalogs are promoted from experimental to beta. [#85848](https://github.com/ClickHouse/ClickHouse/pull/85848) ([Melvyn Peignon](https://github.com/melvynator)). +* Lightweight updates and deletes are promoted from experimental to beta. +* Approximate vector search with vector similarity indexes is now GA. [#85888](https://github.com/ClickHouse/ClickHouse/pull/85888) ([Robert Schulze](https://github.com/rschu1ze)). +* Ytsaurus table engine and table function. [#77606](https://github.com/ClickHouse/ClickHouse/pull/77606) ([MikhailBurdukov](https://github.com/MikhailBurdukov)). +* Previously, the text index data would be separated into multiple segments (each segment size by default was 256 MiB). This might reduce the memory consumption while building the text index, however this increases the space requirement on the disk and increase the query response time. [#84590](https://github.com/ClickHouse/ClickHouse/pull/84590) ([Elmi Ahmadov](https://github.com/ahmadov)). + +#### Performance Improvement +* New parquet reader implementation. It's generally faster and supports page-level filter pushdown and PREWHERE. Currently experimental. Use setting `input_format_parquet_use_native_reader_v3` to enable. [#82789](https://github.com/ClickHouse/ClickHouse/pull/82789) ([Michael Kolupaev](https://github.com/al13n321)). +* Replaced the official HTTP transport in Azure library with our own HTTP client implementation for Azure Blob Storage. Introduced multiple settings for this clients which mirror settings from S3. Introduced aggressive connection timeouts for both Azure and S3. Improved introspection into Azure profile events and metrics. New client is enabled by default, provide much better latencies for cold queries on top of Azure Blob Storage. Old `Curl` client can be returned back by setting `azure_sdk_use_native_client=false`. [#83294](https://github.com/ClickHouse/ClickHouse/pull/83294) ([alesapin](https://github.com/alesapin)). The previous, official implementation of Azure client was unsuitable for production due to terrible latency spikes, ranging from five seconds to minutes. We have ditched that terrible implementation and are very proud of that. +* Processes indexes in increasing order of file size. The net index ordering prioritizes minmax and vector indexes (due to simplicity and selectivity respectively), and small indexes thereafter. Within the minmax/vector indexes smaller indexes are also preferred. [#84094](https://github.com/ClickHouse/ClickHouse/pull/84094) ([Maruth Goyal](https://github.com/maruthgoyal)). +* Enable MergeTree setting `write_marks_for_substreams_in_compact_parts` by default. It significantly improves performance of subcolumns reading from newly created Compact parts. Servers with version less then 25.5 won't be able to read new Compact parts. [#84171](https://github.com/ClickHouse/ClickHouse/pull/84171) ([Pavel Kruglov](https://github.com/Avogar)). +* `azureBlobStorage` table engine: cache and reuse managed identity authentication tokens when possible to avoid throttling. [#79860](https://github.com/ClickHouse/ClickHouse/pull/79860) ([Nick Blakely](https://github.com/niblak)). +* `ALL` `LEFT/INNER` JOINs will be automatically converted to `RightAny` if the right side is functionally determined by the join key columns (all rows have unique join key values). [#84010](https://github.com/ClickHouse/ClickHouse/pull/84010) ([Nikita Taranov](https://github.com/nickitat)). +* Add `max_joined_block_size_bytes` in addition to `max_joined_block_size_rows` to limit the memory usage of JOINs with heavy columns. [#83869](https://github.com/ClickHouse/ClickHouse/pull/83869) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). +* Added new logic (controlled by the setting `enable_producing_buckets_out_of_order_in_aggregation`, enabled by default) that allows sending some buckets out of order during memory-efficient aggregation. When some aggregation buckets take significantly longer to merge than others, it improves performance by allowing the initiator to merge buckets with higher bucket id-s in the meantime. The downside is potentially higher memory usage (shouldn't be significant). [#80179](https://github.com/ClickHouse/ClickHouse/pull/80179) ([Nikita Taranov](https://github.com/nickitat)). +* Introduced the `optimize_rewrite_regexp_functions` setting (enabled by default), which allows the optimizer to rewrite certain `replaceRegexpAll`, `replaceRegexpOne`, and `extract` calls into simpler and more efficient forms when specific regular expression patterns are detected. (issue [#81981](https://github.com/ClickHouse/ClickHouse/issues/81981)). [#81992](https://github.com/ClickHouse/ClickHouse/pull/81992) ([Amos Bird](https://github.com/amosbird)). +* Process `max_joined_block_rows` outside of hash JOIN main loop. Slightly better performance for ALL JOIN. [#83216](https://github.com/ClickHouse/ClickHouse/pull/83216) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). +* Process higher granularity min-max indexes first. Closes [#75381](https://github.com/ClickHouse/ClickHouse/issues/75381). [#83798](https://github.com/ClickHouse/ClickHouse/pull/83798) ([Maruth Goyal](https://github.com/maruthgoyal)). +* Make `DISTINCT` window aggregates run in linear time and fix a bug in `sumDistinct`. Closes [#79792](https://github.com/ClickHouse/ClickHouse/issues/79792). Closes [#52253](https://github.com/ClickHouse/ClickHouse/issues/52253). [#79859](https://github.com/ClickHouse/ClickHouse/pull/79859) ([Nihal Z. Miaji](https://github.com/nihalzp)). +* Vector search queries using a vector similarity index complete with lower latency due to reduced storage reads and reduced CPU usage. [#83803](https://github.com/ClickHouse/ClickHouse/pull/83803) ([Shankar Iyer](https://github.com/shankar-iyer)). +* Rendezvous hashing for improve cache locality of workload distribution among parallel replicas. [#82511](https://github.com/ClickHouse/ClickHouse/pull/82511) ([Anton Ivashkin](https://github.com/ianton-ru)). +* Implement addManyDefaults for If combinators, so now aggregate functions with If combinators work faster. [#83870](https://github.com/ClickHouse/ClickHouse/pull/83870) ([Raúl Marín](https://github.com/Algunenano)). +* Calculate serialized key columnarly when group by multiple string or number columns. [#83884](https://github.com/ClickHouse/ClickHouse/pull/83884) ([李扬](https://github.com/taiyang-li)). +* Eliminated full scans for the cases when index analysis results in empty ranges for parallel replicas reading. [#84971](https://github.com/ClickHouse/ClickHouse/pull/84971) ([Eduard Karacharov](https://github.com/korowa)). +* Try -falign-functions=64 in attempt for more stable perf tests. [#83920](https://github.com/ClickHouse/ClickHouse/pull/83920) ([Azat Khuzhin](https://github.com/azat)). +* The bloom filter index is now used for conditions like `has([c1, c2, ...], column)`, where `column` is not of an `Array` type. This improves performance for such queries, making them as efficient as the `IN` operator. [#83945](https://github.com/ClickHouse/ClickHouse/pull/83945) ([Doron David](https://github.com/dorki)). +* Reduce unnecessary memcpy calls in CompressedReadBufferBase::readCompressedData. [#83986](https://github.com/ClickHouse/ClickHouse/pull/83986) ([Raúl Marín](https://github.com/Algunenano)). +* Optimize `largestTriangleThreeBuckets` by removing temporary data. [#84479](https://github.com/ClickHouse/ClickHouse/pull/84479) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Optimize string deserialization by simplifying the code. Closes [#38564](https://github.com/ClickHouse/ClickHouse/issues/38564). [#84561](https://github.com/ClickHouse/ClickHouse/pull/84561) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Fixed the calculation of the minimal task size for parallel replicas. [#84752](https://github.com/ClickHouse/ClickHouse/pull/84752) ([Nikita Taranov](https://github.com/nickitat)). +* Improved performance of applying patch parts in `Join` mode. [#85040](https://github.com/ClickHouse/ClickHouse/pull/85040) ([Anton Popov](https://github.com/CurtizJ)). +* Remove zero byte. Closes [#85062](https://github.com/ClickHouse/ClickHouse/issues/85062). A few minor bugs were fixed. Functions `structureToProtobufSchema`, `structureToCapnProtoSchema` didn't correctly put a zero-terminating byte and were using a newline instead of it. That was leading to a missing newline in the output, and could lead to buffer overflows while using other functions that depend on the zero byte (such as `logTrace`, `demangle`, `extractURLParameter`, `toStringCutToZero`, and `encrypt`/`decrypt`). The `regexp_tree` dictionary layout didn't support processing strings with zero bytes. The `formatRowNoNewline` function, called with `Values` format or with any other format without a newline at the end of rows, erroneously cuts the last character of the output. Function `stem` contained an exception-safety error that could lead to a memory leak in a very rare scenario. The `initcap` function worked in the wrong way for `FixedString` arguments: it didn't recognize the start of the word at the start of the string if the previous string in a block ended with a word character. Fixed a security vulnerability of the Apache `ORC` format, which could lead to the exposure of uninitialized memory. Changed behavior of the function `replaceRegexpAll` and the corresponding alias, `REGEXP_REPLACE`: now it can do an empty match at the end of the string even if the previous match processed the whole string, such as in the case of `^a*|a*$` or `^|.*` - this corresponds to the semantic of JavaScript, Perl, Python, PHP, Ruby, but differs to the semantic of PostgreSQL. Implementation of many functions has been simplified and optimized. Documentation for several functions was wrong and has now been fixed. Keep in mind that the output of `byteSize` for String columns and complex types, which consisted of String columns, has changed (from 9 bytes per empty string to 8 bytes per empty string), and this is normal. [#85063](https://github.com/ClickHouse/ClickHouse/pull/85063) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Optimize the materialization of constants in cases when we do this materialization only to return a single row. [#85071](https://github.com/ClickHouse/ClickHouse/pull/85071) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Improve parallel files processing with delta-kernel-rs backend. [#85642](https://github.com/ClickHouse/ClickHouse/pull/85642) ([Azat Khuzhin](https://github.com/azat)). +* A new setting, enable_add_distinct_to_in_subqueries, has been introduced. When enabled, ClickHouse will automatically add DISTINCT to subqueries in IN clauses for distributed queries. This can significantly reduce the size of temporary tables transferred between shards and improve network efficiency. Note: This is a trade-off—while network transfer is reduced, additional merging (deduplication) work is required on each node. Enable this setting when network transfer is a bottleneck and the merging cost is acceptable. [#81908](https://github.com/ClickHouse/ClickHouse/pull/81908) ([fhw12345](https://github.com/fhw12345)). +* Reduce query memory tracking overhead for executable user-defined functions. [#83929](https://github.com/ClickHouse/ClickHouse/pull/83929) ([Eduard Karacharov](https://github.com/korowa)). +* Implement internal `delta-kernel-rs` filtering (statistics and partition pruning) in storage `DeltaLake`. [#84006](https://github.com/ClickHouse/ClickHouse/pull/84006) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Disable skipping indexes that depend on columns updated on the fly or by patch parts more granularly. Now, skipping indexes are not used only in parts affected by on-the-fly mutations or patch parts; previously, those indexes were disabled for all parts. [#84241](https://github.com/ClickHouse/ClickHouse/pull/84241) ([Anton Popov](https://github.com/CurtizJ)). +* Allocate the minimum amount of memory needed for encrypted_buffer for encrypted named collections. [#84432](https://github.com/ClickHouse/ClickHouse/pull/84432) ([Pablo Marcos](https://github.com/pamarcos)). +* Improved support for bloom filter indexes (regular, ngram, and token) to be utilized when the first argument is a constant array (the set) and the second is the indexed column (the subset), enabling more efficient query execution. [#84700](https://github.com/ClickHouse/ClickHouse/pull/84700) ([Doron David](https://github.com/dorki)). +* Reduce contention on storage lock in Keeper. [#84732](https://github.com/ClickHouse/ClickHouse/pull/84732) ([Antonio Andelic](https://github.com/antonio2368)). +* Add missing support of `read_in_order_use_virtual_row` for `WHERE`. It allows to skip reading more parts for queries with filters that were not fully pushed to `PREWHERE`. [#84835](https://github.com/ClickHouse/ClickHouse/pull/84835) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). +* Allows asynchronously iterating objects from Iceberg table without storing objects for each data file explicitly. [#85369](https://github.com/ClickHouse/ClickHouse/pull/85369) ([Daniil Ivanik](https://github.com/divanik)). +* Execute non-correlated `EXISTS` as a scalar subquery. This allows using a scalar subquery cache and constant-folding the result, which is helpful for indexes. For compatibility, the new setting `execute_exists_as_scalar_subquery=1` is added. [#85481](https://github.com/ClickHouse/ClickHouse/pull/85481) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). + +#### Improvement +* Add `database_replicated` settings defining the default values of DatabaseReplicatedSettings. If the setting is not present in the Replicated DB create query, the value from this setting is used. [#85127](https://github.com/ClickHouse/ClickHouse/pull/85127) ([Tuan Pham Anh](https://github.com/tuanpach)). +* Made the table columns in the web UI (play) resizable. [#84012](https://github.com/ClickHouse/ClickHouse/pull/84012) ([Doron David](https://github.com/dorki)). +* Support compressed `.metadata.json` file via `iceberg_metadata_compression_method` setting. It supports all clickhouse compression methods. This closes [#84895](https://github.com/ClickHouse/ClickHouse/issues/84895). [#85196](https://github.com/ClickHouse/ClickHouse/pull/85196) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Show the number of ranges to be read in the output of `EXPLAIN indexes = 1`. [#79938](https://github.com/ClickHouse/ClickHouse/pull/79938) ([Christoph Wurm](https://github.com/cwurm)). +* Introduce settings to set ORC compression block size, and update its default value from 64KB to 256KB to keep consistent with spark or hive. [#80602](https://github.com/ClickHouse/ClickHouse/pull/80602) ([李扬](https://github.com/taiyang-li)). +* Add `columns_substreams.txt` file to Wide part to track all substreams stored in the part. It helps to track dynamic streams in JSON and Dynamic types and so avoid reading sample of these columns to get the list of dynamic streams (for example for columns sizes calculation). Also now all dynamic streams are reflected in `system.parts_columns`. [#81091](https://github.com/ClickHouse/ClickHouse/pull/81091) ([Pavel Kruglov](https://github.com/Avogar)). +* Add a CLI flag --show_secrets to clickhouse format to hide sensitive data by default. [#81524](https://github.com/ClickHouse/ClickHouse/pull/81524) ([Nikolai Ryzhov](https://github.com/Dolaxom)). +* S3 read and write requests are throttled on the HTTP socket level (instead of whole S3 requests) to avoid issues with `max_remote_read_network_bandwidth_for_server` and `max_remote_write_network_bandwidth_for_server` throttling. [#81837](https://github.com/ClickHouse/ClickHouse/pull/81837) ([Sergei Trifonov](https://github.com/serxa)). +* Allow to mix different collations for the same column in different windows (for window functions). [#82877](https://github.com/ClickHouse/ClickHouse/pull/82877) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)). +* Add a tool to simulate, visualize and compare merge selectors. [#71496](https://github.com/ClickHouse/ClickHouse/pull/71496) ([Sergei Trifonov](https://github.com/serxa)). +* Add support of `remote*` table functions with parallel replicas if cluster is provided in `address_expression` argument. Also, fixes [#73295](https://github.com/ClickHouse/ClickHouse/issues/73295). [#82904](https://github.com/ClickHouse/ClickHouse/pull/82904) ([Igor Nikonov](https://github.com/devcrafter)). +* Set all log messages for writing backup files to TRACE. [#82907](https://github.com/ClickHouse/ClickHouse/pull/82907) ([Hans Krutzer](https://github.com/hkrutzer)). +* User-defined functions with unusual names and codecs can be formatted inconsistently by the SQL formatter. This closes [#83092](https://github.com/ClickHouse/ClickHouse/issues/83092). [#83644](https://github.com/ClickHouse/ClickHouse/pull/83644) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Users can now use Time and Time64 types inside the JSON type. [#83784](https://github.com/ClickHouse/ClickHouse/pull/83784) ([Yarik Briukhovetskyi](https://github.com/yariks5s)). +* Joins with parallel replicas now use the join logical step. In case of any issues with join queries using parallel replicas, try `SET query_plan_use_new_logical_join_step=0` and report an issue. [#83801](https://github.com/ClickHouse/ClickHouse/pull/83801) ([Vladimir Cherkasov](https://github.com/vdimir)). +* Fix compatibility for cluster_function_process_archive_on_multiple_nodes. [#83968](https://github.com/ClickHouse/ClickHouse/pull/83968) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Support changing mv insert settings on `S3Queue` table level. Added new `S3Queue` level settings: `min_insert_block_size_rows_for_materialized_views` and `min_insert_block_size_bytes_for_materialized_views`. By default profile level settings will be used and `S3Queue` level settings will override those. [#83971](https://github.com/ClickHouse/ClickHouse/pull/83971) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Added profile event `MutationAffectedRowsUpperBound` that shows the number of affected rows in a mutation (e.g., the total number of rows that satisfy the condition in `ALTER UPDATE` or `ALTER DELETE` query. [#83978](https://github.com/ClickHouse/ClickHouse/pull/83978) ([Anton Popov](https://github.com/CurtizJ)). +* Use information from cgroup (if applicable, i.e. `memory_worker_use_cgroup` and cgroups are available) to adjust memory tracker (`memory_worker_correct_memory_tracker`). [#83981](https://github.com/ClickHouse/ClickHouse/pull/83981) ([Azat Khuzhin](https://github.com/azat)). +* MongoDB: Implicit parsing of strings to numeric types. Previously, if a string value was received from a MongoDB source for a numeric column in a ClickHouse table, an exception was thrown. Now, the engine attempts to parse the numeric value from the string automatically. Closes [#81167](https://github.com/ClickHouse/ClickHouse/issues/81167). [#84069](https://github.com/ClickHouse/ClickHouse/pull/84069) ([Kirill Nikiforov](https://github.com/allmazz)). +* Highlight digit groups in `Pretty` formats for `Nullable` numbers. [#84070](https://github.com/ClickHouse/ClickHouse/pull/84070) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Dashboard: the tooltip will not overflow the container at the top. [#84072](https://github.com/ClickHouse/ClickHouse/pull/84072) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Slightly better-looking dots on the dashboard. [#84074](https://github.com/ClickHouse/ClickHouse/pull/84074) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Dashboard now has a slightly better favicon. [#84076](https://github.com/ClickHouse/ClickHouse/pull/84076) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Web UI: Give browsers a chance to save the password. Also, it will remember the URL values. [#84087](https://github.com/ClickHouse/ClickHouse/pull/84087) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Add support for applying extra ACL on specific Keeper nodes using `apply_to_children` config. [#84137](https://github.com/ClickHouse/ClickHouse/pull/84137) ([Antonio Andelic](https://github.com/antonio2368)). +* Fix usage of "compact" Variant discriminators serialization in MergeTree. Perviously it wasn't used in some cases when it could be used. [#84141](https://github.com/ClickHouse/ClickHouse/pull/84141) ([Pavel Kruglov](https://github.com/Avogar)). +* Added a server setting, `logs_to_keep` to database replicated settings, that allows changing the default `logs_to_keep` parameter for replicated databases. Lower values reduce the number of ZNodes (especially if there are many databases), while higher values allow a missing replica to catch up after a longer period of time. [#84183](https://github.com/ClickHouse/ClickHouse/pull/84183) ([Alexey Khatskevich](https://github.com/Khatskevich)). +* Add a setting `json_type_escape_dots_in_keys` to escape dots in JSON keys during JSON type parsing. The setting is disabled by default. [#84207](https://github.com/ClickHouse/ClickHouse/pull/84207) ([Pavel Kruglov](https://github.com/Avogar)). +* Check if connection is cancelled before checking for EOF to prevent reading from closed connection. Fixes [#83893](https://github.com/ClickHouse/ClickHouse/issues/83893). [#84227](https://github.com/ClickHouse/ClickHouse/pull/84227) ([Raufs Dunamalijevs](https://github.com/rienath)). +* Slightly better colors of text selection in Web UI. The difference is significant only for selected table cells in the dark mode. In previous versions, there was not enough contrast between the text and the selection background. [#84258](https://github.com/ClickHouse/ClickHouse/pull/84258) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Improved server shutdown handling for client connections by simplifying internal checks. [#84312](https://github.com/ClickHouse/ClickHouse/pull/84312) ([Raufs Dunamalijevs](https://github.com/rienath)). +* Added a setting `delta_lake_enable_expression_visitor_logging` to turn off expression visitor logs as they can be too verbose even for test log level when debugging something. [#84315](https://github.com/ClickHouse/ClickHouse/pull/84315) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Cgroup-level and system-wide metrics are reported now altogether. Cgroup-level metrics have names `CGroup` and OS-level metrics (collected from procfs) have names `OS`. [#84317](https://github.com/ClickHouse/ClickHouse/pull/84317) ([Nikita Taranov](https://github.com/nickitat)). +* Slightly better charts in Web UI. Not much, but better. [#84326](https://github.com/ClickHouse/ClickHouse/pull/84326) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Change the default of the Replicated database setting `max_retries_before_automatic_recovery` to 10, so it will recover faster in some cases. [#84369](https://github.com/ClickHouse/ClickHouse/pull/84369) ([Alexander Tokmakov](https://github.com/tavplubix)). +* Fix formatting of CREATE USER with query parameters (i.e. `CREATE USER {username:Identifier} IDENTIFIED WITH no_password`). [#84376](https://github.com/ClickHouse/ClickHouse/pull/84376) ([Azat Khuzhin](https://github.com/azat)). +* Introduce `backup_restore_s3_retry_initial_backoff_ms`, `backup_restore_s3_retry_max_backoff_ms`, `backup_restore_s3_retry_jitter_factor` to configure the S3 retry backoff strategy used during backup and restore operations. [#84421](https://github.com/ClickHouse/ClickHouse/pull/84421) ([Julia Kartseva](https://github.com/jkartseva)). +* S3Queue ordered mode fix: quit earlier if shutdown was called. [#84463](https://github.com/ClickHouse/ClickHouse/pull/84463) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Support iceberg writes to read from pyiceberg. [#84466](https://github.com/ClickHouse/ClickHouse/pull/84466) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Allow set values type casting when pushing down `IN` / `GLOBAL IN` filters over KeyValue storage primary keys (e.g., EmbeddedRocksDB, KeeperMap). [#84515](https://github.com/ClickHouse/ClickHouse/pull/84515) ([Eduard Karacharov](https://github.com/korowa)). +* Bump chdig to [25.7.1](https://github.com/azat/chdig/releases/tag/v25.7.1). [#84521](https://github.com/ClickHouse/ClickHouse/pull/84521) ([Azat Khuzhin](https://github.com/azat)). +* Low-level errors during UDF execution now fail with error code `UDF_EXECUTION_FAILED`, whereas previously different error codes could be returned. [#84547](https://github.com/ClickHouse/ClickHouse/pull/84547) ([Xu Jia](https://github.com/XuJia0210)). +* Add `get_acl` command to KeeperClient. [#84641](https://github.com/ClickHouse/ClickHouse/pull/84641) ([Antonio Andelic](https://github.com/antonio2368)). +* Adds snapshot version to data lake table engines. [#84659](https://github.com/ClickHouse/ClickHouse/pull/84659) ([Pete Hampton](https://github.com/pjhampton)). +* Add a dimensional metric for the size of `ConcurrentBoundedQueue`, labelled by the queue type (i.e. what the queue is there for) and queue id (i.e. randomly generated id for the current instance of the queue). [#84675](https://github.com/ClickHouse/ClickHouse/pull/84675) ([Miсhael Stetsyuk](https://github.com/mstetsyuk)). +* The `system.columns` table now provides `column` as an alias for the existing `name` column. [#84695](https://github.com/ClickHouse/ClickHouse/pull/84695) ([Yunchi Pang](https://github.com/yunchipang)). +* New MergeTree setting `search_orphaned_parts_drives` to limit scope to look for parts e.g. by disks with local metadata. [#84710](https://github.com/ClickHouse/ClickHouse/pull/84710) ([Ilya Golshtein](https://github.com/ilejn)). +* Add 4LW in Keeper, `lgrq`, for toggling request logging of received requests. [#84719](https://github.com/ClickHouse/ClickHouse/pull/84719) ([Antonio Andelic](https://github.com/antonio2368)). +* Match external auth forward_headers in case-insensitive way. [#84737](https://github.com/ClickHouse/ClickHouse/pull/84737) ([ingodwerust](https://github.com/ingodwerust)). +* The `encrypt_decrypt` tool now supports encrypted ZooKeeper connections. [#84764](https://github.com/ClickHouse/ClickHouse/pull/84764) ([Roman Vasin](https://github.com/rvasin)). +* Add format string column to `system.errors`. This column is needed to group by the same error type in alerting rules. [#84776](https://github.com/ClickHouse/ClickHouse/pull/84776) ([Miсhael Stetsyuk](https://github.com/mstetsyuk)). +* Updated `clickhouse-format` to accept `--highlight` as an alias for `--hilite`. - Updated `clickhouse-client` to accept `--hilite` as an alias for `--highlight`. - Updated `clickhouse-format` documentation to reflect the change. [#84806](https://github.com/ClickHouse/ClickHouse/pull/84806) ([Rishabh Bhardwaj](https://github.com/rishabh1815769)). +* Fix iceberg reading by field ids for complex types. [#84821](https://github.com/ClickHouse/ClickHouse/pull/84821) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Introduce a new `backup_slow_all_threads_after_retryable_s3_error` setting to reduce pressure on S3 during retry storms caused by errors such as `SlowDown`, by slowing down all threads once a single retryable error is observed. [#84854](https://github.com/ClickHouse/ClickHouse/pull/84854) ([Julia Kartseva](https://github.com/jkartseva)). +* Skip creating and renaming the old temp table of non-append RMV DDLs in Replicated DBs. [#84858](https://github.com/ClickHouse/ClickHouse/pull/84858) ([Tuan Pham Anh](https://github.com/tuanpach)). +* Limit Keeper log entry cache size by number of entries using `keeper_server.coordination_settings.latest_logs_cache_entry_count_threshold` and `keeper_server.coordination_settings.commit_logs_cache_entry_count_threshold`. [#84877](https://github.com/ClickHouse/ClickHouse/pull/84877) ([Antonio Andelic](https://github.com/antonio2368)). +* Allow using `simdjson` on unsupported architectures (previously leads to `CANNOT_ALLOCATE_MEMORY` errors). [#84966](https://github.com/ClickHouse/ClickHouse/pull/84966) ([Azat Khuzhin](https://github.com/azat)). +* Async logging: Make limits tuneable and add introspection. [#85105](https://github.com/ClickHouse/ClickHouse/pull/85105) ([Raúl Marín](https://github.com/Algunenano)). +* Collect all removed objects to execute single object storage remove operation. [#85316](https://github.com/ClickHouse/ClickHouse/pull/85316) ([Mikhail Artemenko](https://github.com/Michicosun)). +* Iceberg's current implementation of positional delete files keeps all data in RAM. This can be quite expensive if the positional delete files are large, which is often the case. My implementation keeps only the last row-group of Parquet delete files in RAM, which is significantly cheaper. [#85329](https://github.com/ClickHouse/ClickHouse/pull/85329) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* chdig: fix leftovers on the screen, fix crash after edit query in editor, search in `path` for `editor`, update to [25.8.1](https://github.com/azat/chdig/releases/tag/v25.8.1). [#85341](https://github.com/ClickHouse/ClickHouse/pull/85341) ([Azat Khuzhin](https://github.com/azat)). +* Add missing `partition_columns_in_data_file` to azure configuration. [#85373](https://github.com/ClickHouse/ClickHouse/pull/85373) ([Arthur Passos](https://github.com/arthurpassos)). +* Allow zero step in functions `timeSeries*ToGrid` This is part of [#75036](https://github.com/ClickHouse/ClickHouse/pull/75036). [#85390](https://github.com/ClickHouse/ClickHouse/pull/85390) ([Vitaly Baranov](https://github.com/vitlibar)). +* Added show_data_lake_catalogs_in_system_tables flag to manage adding data lake tables in system.tables. Resolves [#85384](https://github.com/ClickHouse/ClickHouse/issues/85384). [#85411](https://github.com/ClickHouse/ClickHouse/pull/85411) ([Smita Kulkarni](https://github.com/SmitaRKulkarni)). +* Added support for macro expansion in `remote_fs_zero_copy_zookeeper_path`. [#85437](https://github.com/ClickHouse/ClickHouse/pull/85437) ([Mikhail Koviazin](https://github.com/mkmkme)). +* AI in clickhouse-client will look slightly better. [#85447](https://github.com/ClickHouse/ClickHouse/pull/85447) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Enable trace_log.symbolize for old deployments by default. [#85456](https://github.com/ClickHouse/ClickHouse/pull/85456) ([Azat Khuzhin](https://github.com/azat)). +* Support resolution of more cases for compound identifiers. Particularly, it improves the compatibility of `ARRAY JOIN` with the old analyzer. Introduce a new setting `analyzer_compatibility_allow_compound_identifiers_in_unflatten_nested` to keep the old behaviour. [#85492](https://github.com/ClickHouse/ClickHouse/pull/85492) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). +* Ignore UNKNOWN_DATABASE while obtaining table columns sizes for system.columns. [#85632](https://github.com/ClickHouse/ClickHouse/pull/85632) ([Azat Khuzhin](https://github.com/azat)). +* Added a limit (table setting `max_uncompressed_bytes_in_patches`) for total uncompressed bytes in patch parts. It prevents significant slowdowns of SELECT queries after lightweight updates and prevents possible misuse of lightweight updates. [#85641](https://github.com/ClickHouse/ClickHouse/pull/85641) ([Anton Popov](https://github.com/CurtizJ)). +* Add a `parameter` column to `system.grants` to determine source type for `GRANT READ/WRITE` and the table engine for `GRANT TABLE ENGINE`. [#85643](https://github.com/ClickHouse/ClickHouse/pull/85643) ([MikhailBurdukov](https://github.com/MikhailBurdukov)). +* Fix parsing of a trailing comma in columns of the CREATE DICTIONARY query after a column with parameters, for example, Decimal(8). Closes [#85586](https://github.com/ClickHouse/ClickHouse/issues/85586). [#85653](https://github.com/ClickHouse/ClickHouse/pull/85653) ([Nikolay Degterinsky](https://github.com/evillique)). +* Support inner arrays for the function `nested`. [#85719](https://github.com/ClickHouse/ClickHouse/pull/85719) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). + +#### Bug Fix (user-visible misbehavior in an official stable release) + +* This pr fixes the metadata resolution when querying iceberg tables through rest catalog. ... [#80562](https://github.com/ClickHouse/ClickHouse/pull/80562) ([Saurabh Kumar Ojha](https://github.com/saurabhojha)). +* Fix markReplicasActive in DDLWorker and DatabaseReplicatedDDLWorker. [#81395](https://github.com/ClickHouse/ClickHouse/pull/81395) ([Tuan Pham Anh](https://github.com/tuanpach)). +* Fix rollback of Dynamic column on parsing failure. [#82169](https://github.com/ClickHouse/ClickHouse/pull/82169) ([Pavel Kruglov](https://github.com/Avogar)). +* If function `trim` called with all-constant inputs now produces a constant output string. (Bug [#78796](https://github.com/ClickHouse/ClickHouse/issues/78796)). [#82900](https://github.com/ClickHouse/ClickHouse/pull/82900) ([Robert Schulze](https://github.com/rschu1ze)). +* Fix logical error with duplicate subqueries when `optimize_syntax_fuse_functions` is enabled, close [#75511](https://github.com/ClickHouse/ClickHouse/issues/75511). [#83300](https://github.com/ClickHouse/ClickHouse/pull/83300) ([Vladimir Cherkasov](https://github.com/vdimir)). +* Fixed incorrect result of queries with `WHERE ... IN ()` clause and enabled query condition cache (setting `use_query_condition_cache`). [#83445](https://github.com/ClickHouse/ClickHouse/pull/83445) ([LB7666](https://github.com/acking-you)). +* Historically, `gcs` function did not require any access to use. Now it will check `GRANT READ ON S3` permission for usage. Closes [#70567](https://github.com/ClickHouse/ClickHouse/issues/70567). [#83503](https://github.com/ClickHouse/ClickHouse/pull/83503) ([pufit](https://github.com/pufit)). +* Skip unavailable nodes during INSERT SELECT from s3Cluster() into replicated MergeTree. [#83676](https://github.com/ClickHouse/ClickHouse/pull/83676) ([Igor Nikonov](https://github.com/devcrafter)). +* Fix write with append (in MergeTree used for experimental transactions) with `plain_rewritable`/`plain` metadata types, previously they were simply ignored. [#83695](https://github.com/ClickHouse/ClickHouse/pull/83695) ([Tuan Pham Anh](https://github.com/tuanpach)). +* Mask Avro schema registry authentication details to be not visible to user or in logs. [#83713](https://github.com/ClickHouse/ClickHouse/pull/83713) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)). +* Fix the issue where, if a MergeTree table is created with `add_minmax_index_for_numeric_columns=1` or `add_minmax_index_for_string_columns=1`, the index is later materialized during an ALTER operation, and it prevents the Replicated database from initializing correctly on a new replica. [#83751](https://github.com/ClickHouse/ClickHouse/pull/83751) ([Nikolay Degterinsky](https://github.com/evillique)). +* Fixed parquet writer outputting incorrect statistics (min/max) for Decimal types. [#83754](https://github.com/ClickHouse/ClickHouse/pull/83754) ([Michael Kolupaev](https://github.com/al13n321)). +* Fix sort of NaN values in `LowCardinality(Float32|Float64|BFloat16)` type. [#83786](https://github.com/ClickHouse/ClickHouse/pull/83786) ([Pervakov Grigorii](https://github.com/GrigoryPervakov)). +* When restoring from backup, the definer user may not be backed up, which will cause the whole backup to be broken. To fix this, we postpone the permissions check on the target table's creation during restore and only check it during runtime. [#83818](https://github.com/ClickHouse/ClickHouse/pull/83818) ([pufit](https://github.com/pufit)). +* Fix crash in client due to connection left in disconnected state after bad INSERT. [#83842](https://github.com/ClickHouse/ClickHouse/pull/83842) ([Azat Khuzhin](https://github.com/azat)). +* Allow referencing any table in `view(...)` argument of `remote` table function with enabled analyzer. Fixes [#78717](https://github.com/ClickHouse/ClickHouse/issues/78717). Fixes [#79377](https://github.com/ClickHouse/ClickHouse/issues/79377). [#83844](https://github.com/ClickHouse/ClickHouse/pull/83844) ([Dmitry Novik](https://github.com/novikd)). +* Onprogress call in jsoneachrowwithprogress is synchronized with finalization. [#83879](https://github.com/ClickHouse/ClickHouse/pull/83879) ([Sema Checherinda](https://github.com/CheSema)). +* This closes [#81303](https://github.com/ClickHouse/ClickHouse/issues/81303). [#83892](https://github.com/ClickHouse/ClickHouse/pull/83892) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Fix colorSRGBToOKLCH/colorOKLCHToSRGB for mix of const and non-const args. [#83906](https://github.com/ClickHouse/ClickHouse/pull/83906) ([Azat Khuzhin](https://github.com/azat)). +* Fix writing JSON paths with NULL values in RowBinary format. [#83923](https://github.com/ClickHouse/ClickHouse/pull/83923) ([Pavel Kruglov](https://github.com/Avogar)). +* Overflow large values (>2106-02-07) when casting from Date to DateTime64 is fixed. [#83982](https://github.com/ClickHouse/ClickHouse/pull/83982) ([Yarik Briukhovetskyi](https://github.com/yariks5s)). +* Always apply `filesystem_prefetches_limit` (not only from `MergeTreePrefetchedReadPool`). [#83999](https://github.com/ClickHouse/ClickHouse/pull/83999) ([Azat Khuzhin](https://github.com/azat)). +* Fix rare bug when `MATERIALIZE COLUMN` query could lead to unexpected files in `checksums.txt` and eventually detached data parts. [#84007](https://github.com/ClickHouse/ClickHouse/pull/84007) ([alesapin](https://github.com/alesapin)). +* Fix the logical error `Expected single dictionary argument for function` while doing JOIN on an inequality condition when one of the columns is `LowCardinality` and the other is a constant. Closes [#81779](https://github.com/ClickHouse/ClickHouse/issues/81779). [#84019](https://github.com/ClickHouse/ClickHouse/pull/84019) ([Alexey Milovidov](https://github.com/alexey-milovidov)). +* Fix crash with clickhouse client when used in interactive mode with syntax highlighting. [#84025](https://github.com/ClickHouse/ClickHouse/pull/84025) ([Bharat Nallan](https://github.com/bharatnc)). +* Fixed wrong results when the query condition cache is used in conjunction with recursive CTEs (issue [#81506](https://github.com/ClickHouse/ClickHouse/issues/81506)). [#84026](https://github.com/ClickHouse/ClickHouse/pull/84026) ([zhongyuankai](https://github.com/zhongyuankai)). +* Handle exceptions properly in periodic parts refresh. [#84083](https://github.com/ClickHouse/ClickHouse/pull/84083) ([Azat Khuzhin](https://github.com/azat)). +* Fix filter merging into JOIN condition in cases when equality operands have different types or they reference constants. Fixes [#83432](https://github.com/ClickHouse/ClickHouse/issues/83432). [#84145](https://github.com/ClickHouse/ClickHouse/pull/84145) ([Dmitry Novik](https://github.com/novikd)). +* Fix rare clickhouse crash when table has projection, `lightweight_mutation_projection_mode = 'rebuild'` and user execute lighweight delete which deletes ALL rows from any block in table. [#84158](https://github.com/ClickHouse/ClickHouse/pull/84158) ([alesapin](https://github.com/alesapin)). +* Fix deadlock caused by background cancellation checker thread. [#84203](https://github.com/ClickHouse/ClickHouse/pull/84203) ([Antonio Andelic](https://github.com/antonio2368)). +* Fix infinite recursive analysis of invalid `WINDOW` definitions. Fixes [#83131](https://github.com/ClickHouse/ClickHouse/issues/83131). [#84242](https://github.com/ClickHouse/ClickHouse/pull/84242) ([Dmitry Novik](https://github.com/novikd)). +* Fixed a bug that was causing incorrect Bech32 Encoding and Decoding. The bug wasn't caught originally due to an online implementation of the algorithm used for testing having the same issue. [#84257](https://github.com/ClickHouse/ClickHouse/pull/84257) ([George Larionov](https://github.com/george-larionov)). +* Fixed incorrect construction of empty tuples in the `array()` function. This fixes [#84202](https://github.com/ClickHouse/ClickHouse/issues/84202). [#84297](https://github.com/ClickHouse/ClickHouse/pull/84297) ([Amos Bird](https://github.com/amosbird)). +* Fix `LOGICAL_ERROR` for queries with parallel replicas and multiple INNER joins followed by RIGHT join. Do not use parallel replicas for such queries. [#84299](https://github.com/ClickHouse/ClickHouse/pull/84299) ([Vladimir Cherkasov](https://github.com/vdimir)). +* Previously, `set` indexes didn't consider `Nullable` columns while checking if granules passed the filter (issue [#75485](https://github.com/ClickHouse/ClickHouse/issues/75485)). [#84305](https://github.com/ClickHouse/ClickHouse/pull/84305) ([Elmi Ahmadov](https://github.com/ahmadov)). +* Now ClickHouse read tables from Glue Catalog where table type specified in lower case. [#84316](https://github.com/ClickHouse/ClickHouse/pull/84316) ([alesapin](https://github.com/alesapin)). +* Do not try to substitute table functions to its cluster alternative in presence of a JOIN or subquery. [#84335](https://github.com/ClickHouse/ClickHouse/pull/84335) ([Konstantin Bogdanov](https://github.com/thevar1able)). +* Fix logger usage in `IAccessStorage`. [#84365](https://github.com/ClickHouse/ClickHouse/pull/84365) ([Konstantin Bogdanov](https://github.com/thevar1able)). +* Fixed a logical error in lightweight updates that update all columns in the table. [#84380](https://github.com/ClickHouse/ClickHouse/pull/84380) ([Anton Popov](https://github.com/CurtizJ)). +* Codec `DoubleDelta` codec can now only be applied to columns of numeric type. In particular `FixedString` columns can no longer be compressed using `DoubleDelta`. (fixes [#80220](https://github.com/ClickHouse/ClickHouse/issues/80220)). [#84383](https://github.com/ClickHouse/ClickHouse/pull/84383) ([Jimmy Aguilar Mena](https://github.com/Ergus)). +* The comparison against nan value was not using the correct ranges during `MinMax` index evaluation. [#84386](https://github.com/ClickHouse/ClickHouse/pull/84386) ([Elmi Ahmadov](https://github.com/ahmadov)). +* Fix reading Variant column with lazy materialization. [#84400](https://github.com/ClickHouse/ClickHouse/pull/84400) ([Pavel Kruglov](https://github.com/Avogar)). +* Make `zoutofmemory` hardware error, otherwise it will throw logical error. see https://github.com/clickhouse/clickhouse-core-incidents/issues/877. [#84420](https://github.com/ClickHouse/ClickHouse/pull/84420) ([Han Fei](https://github.com/hanfei1991)). +* Fixed server crash when a user created with `no_password` attempts to login after the server setting `allow_no_password` was changed to 0. [#84426](https://github.com/ClickHouse/ClickHouse/pull/84426) ([Shankar Iyer](https://github.com/shankar-iyer)). +* Fix out-of-order writes to Keeper changelog. Previously, we could have in-flight writes to changelog, but rollback could cause concurrent change of the destination file. This would lead to inconsistent logs, and possible data loss. [#84434](https://github.com/ClickHouse/ClickHouse/pull/84434) ([Antonio Andelic](https://github.com/antonio2368)). +* Now if all TTL are removed from table MergeTree will do nothing related to TTL. [#84441](https://github.com/ClickHouse/ClickHouse/pull/84441) ([alesapin](https://github.com/alesapin)). +* Parallel distributed INSERT SELECT with LIMIT was allowed which is not correct, it leads to data duplication in target table. [#84477](https://github.com/ClickHouse/ClickHouse/pull/84477) ([Igor Nikonov](https://github.com/devcrafter)). +* Fix pruning files by virtual column in data lakes. [#84520](https://github.com/ClickHouse/ClickHouse/pull/84520) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Fix leaks for keeper with rocksdb storage (iterators was not destroyed). [#84523](https://github.com/ClickHouse/ClickHouse/pull/84523) ([Azat Khuzhin](https://github.com/azat)). +* Fix ALTER MODIFY ORDER BY not validating TTL columns in sorting keys. TTL columns are now properly rejected when used in ORDER BY clauses during ALTER operations, preventing potential table corruption. [#84536](https://github.com/ClickHouse/ClickHouse/pull/84536) ([xiaohuanlin](https://github.com/xiaohuanlin)). +* Change pre-25.5 value of `allow_experimental_delta_kernel_rs` to `false` for compatibility. [#84587](https://github.com/ClickHouse/ClickHouse/pull/84587) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Stops taking schema from manifest files but stores relevant schemas for each snapshot independently. Infer relevant schema for each data file from its corresponding snapshot. Previous behaviour violated Iceberg specification for manifest files entries with existing status. [#84588](https://github.com/ClickHouse/ClickHouse/pull/84588) ([Daniil Ivanik](https://github.com/divanik)). +* Fixed issue where Keeper setting `rotate_log_storage_interval = 0` would cause ClickHouse to crash. (issue [#83975](https://github.com/ClickHouse/ClickHouse/issues/83975)). [#84637](https://github.com/ClickHouse/ClickHouse/pull/84637) ([George Larionov](https://github.com/george-larionov)). +* Fix logical error from S3Queue "Table is already registered". Closes [#84433](https://github.com/ClickHouse/ClickHouse/issues/84433). Broken after https://github.com/ClickHouse/ClickHouse/pull/83530. [#84677](https://github.com/ClickHouse/ClickHouse/pull/84677) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Lock 'mutex' when getting zookeeper from 'view' in RefreshTask. [#84699](https://github.com/ClickHouse/ClickHouse/pull/84699) ([Tuan Pham Anh](https://github.com/tuanpach)). +* Fix `CORRUPTED_DATA` error when lazy columns are used with external sort. [#84738](https://github.com/ClickHouse/ClickHouse/pull/84738) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)). +* Fix column pruning with delta-kernel in storage `DeltaLake`. Closes [#84543](https://github.com/ClickHouse/ClickHouse/issues/84543). [#84745](https://github.com/ClickHouse/ClickHouse/pull/84745) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Refresh credentials in delta-kernel in storage DeltaLake. [#84751](https://github.com/ClickHouse/ClickHouse/pull/84751) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Fix starting superfluous internal backups after connection problems. [#84755](https://github.com/ClickHouse/ClickHouse/pull/84755) ([Vitaly Baranov](https://github.com/vitlibar)). +* Fixed issue where querying a delayed remote source could result in vector out of bounds. [#84820](https://github.com/ClickHouse/ClickHouse/pull/84820) ([George Larionov](https://github.com/george-larionov)). +* The `ngram` and `no_op` tokenizers no longer crash the (experimental) text index for empty input tokens. [#84849](https://github.com/ClickHouse/ClickHouse/pull/84849) ([Robert Schulze](https://github.com/rschu1ze)). +* Fixed lightweight updates for tables with `ReplacingMergeTree` and `CollapsingMergeTree` engines. [#84851](https://github.com/ClickHouse/ClickHouse/pull/84851) ([Anton Popov](https://github.com/CurtizJ)). +* Correctly store all settings in table metadata for tables using object queue engine. [#84860](https://github.com/ClickHouse/ClickHouse/pull/84860) ([Antonio Andelic](https://github.com/antonio2368)). +* Fix total watches count returned by Keeper. [#84890](https://github.com/ClickHouse/ClickHouse/pull/84890) ([Antonio Andelic](https://github.com/antonio2368)). +* Fixed lightweight updates for tables with `ReplicatedMergeTree` engine created on servers with a version lower than 25.7. [#84933](https://github.com/ClickHouse/ClickHouse/pull/84933) ([Anton Popov](https://github.com/CurtizJ)). +* Fixed lightweight updates for tables with non-replicated `MergeTree` engine after running a `ALTER TABLE ... REPLACE PARTITION` query. [#84941](https://github.com/ClickHouse/ClickHouse/pull/84941) ([Anton Popov](https://github.com/CurtizJ)). +* Fixes column name generation for boolean literals to use "true"/"false" instead of "1"/"0", preventing column name conflicts between boolean and integer literals in queries. [#84945](https://github.com/ClickHouse/ClickHouse/pull/84945) ([xiaohuanlin](https://github.com/xiaohuanlin)). +* Fix memory tracking drift from background schedule pool and executor. [#84946](https://github.com/ClickHouse/ClickHouse/pull/84946) ([Azat Khuzhin](https://github.com/azat)). +* Fix potential inaccurate sorting issues in the Merge table engine. [#85025](https://github.com/ClickHouse/ClickHouse/pull/85025) ([Xiaozhe Yu](https://github.com/wudidapaopao)). +* Implement missing APIs for DiskEncrypted. [#85028](https://github.com/ClickHouse/ClickHouse/pull/85028) ([Azat Khuzhin](https://github.com/azat)). +* Add a check if a correlated subquery is used in a distributed context to avoid a crash. Fixes [#82205](https://github.com/ClickHouse/ClickHouse/issues/82205). [#85030](https://github.com/ClickHouse/ClickHouse/pull/85030) ([Dmitry Novik](https://github.com/novikd)). +* Now Iceberg doesn't try to cache relevant snapshot version between select queries and always try to resolve snapshot honestly. Earlier attempt to cache iceberg snapshot led to problems with usage of Iceberg table with time travel. [#85038](https://github.com/ClickHouse/ClickHouse/pull/85038) ([Daniil Ivanik](https://github.com/divanik)). +* Fixed double-free in `AzureIteratorAsync`. [#85064](https://github.com/ClickHouse/ClickHouse/pull/85064) ([Nikita Taranov](https://github.com/nickitat)). +* Improve error message on attempt to create user identified with JWT. [#85072](https://github.com/ClickHouse/ClickHouse/pull/85072) ([Konstantin Bogdanov](https://github.com/thevar1able)). +* Fixed cleanup of patch parts in `ReplicatedMergeTree`. Previously, the result of a lightweight update may temporarily not be visible on the replica until the merged or mutated part that materializes the patch parts is downloaded from another replica. [#85121](https://github.com/ClickHouse/ClickHouse/pull/85121) ([Anton Popov](https://github.com/CurtizJ)). +* Fixing illegal_type_of_argument in mv when types are different. [#85135](https://github.com/ClickHouse/ClickHouse/pull/85135) ([Sema Checherinda](https://github.com/CheSema)). +* Fix segfault in delta-kernel implementation. [#85160](https://github.com/ClickHouse/ClickHouse/pull/85160) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Fix recovering replicated databases when moving the metadata file takes a long time. [#85177](https://github.com/ClickHouse/ClickHouse/pull/85177) ([Tuan Pham Anh](https://github.com/tuanpach)). +* Fix `Not-ready Set` for `IN (subquery)` inside `additional_table_filters expression` setting. [#85210](https://github.com/ClickHouse/ClickHouse/pull/85210) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). +* Get rid of unnecessary `getStatus()` calls during SYSTEM DROP REPLICA queries. Fixes the case when a table is dropped in the background, and the `Shutdown for storage is called` exception is thrown. [#85220](https://github.com/ClickHouse/ClickHouse/pull/85220) ([Nikolay Degterinsky](https://github.com/evillique)). +* Fix race in `DeltaLake` engine delta-kernel implementation. [#85221](https://github.com/ClickHouse/ClickHouse/pull/85221) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Fix reading partitioned data with disabled delta-kernel in `DeltaLake` engine. It was broken in 25.7 (https://github.com/ClickHouse/ClickHouse/pull/81136). [#85223](https://github.com/ClickHouse/ClickHouse/pull/85223) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Added missing table name length checks in CREATE OR REPLACE and RENAME queries. [#85326](https://github.com/ClickHouse/ClickHouse/pull/85326) ([Michael Kolupaev](https://github.com/al13n321)). +* Fix the creation of RMV on a new replica of the Replicated database if DEFINER is dropped. [#85327](https://github.com/ClickHouse/ClickHouse/pull/85327) ([Nikolay Degterinsky](https://github.com/evillique)). +* Fix iceberg writes for complex types. [#85330](https://github.com/ClickHouse/ClickHouse/pull/85330) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Writing lower and upper bounds are not supported for complex types. [#85332](https://github.com/ClickHouse/ClickHouse/pull/85332) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Fix logical error while reading from object storage functions through Distributed table or remote table function. Fixes: [#84658](https://github.com/ClickHouse/ClickHouse/issues/84658), Fixes [#85173](https://github.com/ClickHouse/ClickHouse/issues/85173), Fixes [#52022](https://github.com/ClickHouse/ClickHouse/issues/52022). [#85359](https://github.com/ClickHouse/ClickHouse/pull/85359) ([alesapin](https://github.com/alesapin)). +* Fix backup of parts with broken projections. [#85362](https://github.com/ClickHouse/ClickHouse/pull/85362) ([Antonio Andelic](https://github.com/antonio2368)). +* Forbid using `_part_offset` column in projection in releases until it is stabilized. [#85372](https://github.com/ClickHouse/ClickHouse/pull/85372) ([Sema Checherinda](https://github.com/CheSema)). +* Fix crash and data corruption during ALTER UPDATE for JSON. [#85383](https://github.com/ClickHouse/ClickHouse/pull/85383) ([Pavel Kruglov](https://github.com/Avogar)). +* Queries with parallel replicas which uses reading reverse in order optimization can produce incorrect result. [#85406](https://github.com/ClickHouse/ClickHouse/pull/85406) ([Igor Nikonov](https://github.com/devcrafter)). +* Fix possible UB (crashes) in case of MEMORY_LIMIT_EXCEEDED during String deserialization. [#85440](https://github.com/ClickHouse/ClickHouse/pull/85440) ([Azat Khuzhin](https://github.com/azat)). +* Fix incorrect metrics KafkaAssignedPartitions and KafkaConsumersWithAssignment. [#85494](https://github.com/ClickHouse/ClickHouse/pull/85494) ([Ilya Golshtein](https://github.com/ilejn)). +* Fixed processed bytes stat being underestimated when PREWHERE (explicit or automatic) is used. [#85495](https://github.com/ClickHouse/ClickHouse/pull/85495) ([Michael Kolupaev](https://github.com/al13n321)). +* Fix early return condition for S3 request rate slowdown: require either s3_slow_all_threads_after_network_error or backup_slow_all_threads_after_retryable_s3_error to be true to enable slowdown behavior when all threads are paused due to a retryable error, instead of requiring both. [#85505](https://github.com/ClickHouse/ClickHouse/pull/85505) ([Julia Kartseva](https://github.com/jkartseva)). +* This pr fixes the metadata resolution when querying iceberg tables through rest catalog. ... [#85531](https://github.com/ClickHouse/ClickHouse/pull/85531) ([Saurabh Kumar Ojha](https://github.com/saurabhojha)). +* Fixed rare crash in asynchronous inserts that change settings `log_comment` or `insert_deduplication_token`. [#85540](https://github.com/ClickHouse/ClickHouse/pull/85540) ([Anton Popov](https://github.com/CurtizJ)). +* Arameters like date_time_input_format have been just ignored when http with multipart. [#85570](https://github.com/ClickHouse/ClickHouse/pull/85570) ([Sema Checherinda](https://github.com/CheSema)). +* Fix secrets masking in icebergS3Cluster and icebergAzureCluster table functions. [#85658](https://github.com/ClickHouse/ClickHouse/pull/85658) ([MikhailBurdukov](https://github.com/MikhailBurdukov)). +* Fix precision loss in `JSONExtract` when converting JSON numbers to Decimal types. Now numeric JSON values preserve their exact decimal representation, avoiding floating-point rounding errors. [#85665](https://github.com/ClickHouse/ClickHouse/pull/85665) ([ssive7b](https://github.com/ssive7b)). +* Fixed `LOGICAL_ERROR` when using `COMMENT COLUMN IF EXISTS` in the same `ALTER` statement after `DROP COLUMN`. The `IF EXISTS` clause now correctly skips the comment operation when the column has been dropped within the same statement. [#85688](https://github.com/ClickHouse/ClickHouse/pull/85688) ([xiaohuanlin](https://github.com/xiaohuanlin)). +* Fix reading count from cache for delta lake. [#85704](https://github.com/ClickHouse/ClickHouse/pull/85704) ([Kseniia Sumarokova](https://github.com/kssenii)). +* Fix coalescing merge tree segfault for large strings. This closes [#84582](https://github.com/ClickHouse/ClickHouse/issues/84582). [#85709](https://github.com/ClickHouse/ClickHouse/pull/85709) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Update metadata timestamp in iceberg writes. [#85711](https://github.com/ClickHouse/ClickHouse/pull/85711) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Using `distributed_depth` as an indicator of *Cluster function was incorrect and may lead to data duplication; use `client_info.collaborate_with_initiator` instead. [#85734](https://github.com/ClickHouse/ClickHouse/pull/85734) ([Konstantin Bogdanov](https://github.com/thevar1able)). +* Spark can't read position delete files. [#85762](https://github.com/ClickHouse/ClickHouse/pull/85762) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Fix send_logs_source_regexp (after async logging refactoring in [#85105](https://github.com/ClickHouse/ClickHouse/issues/85105)). [#85797](https://github.com/ClickHouse/ClickHouse/pull/85797) ([Azat Khuzhin](https://github.com/azat)). +* Fix possible inconsistency for dictionaries with update_field on MEMORY_LIMIT_EXCEEDED errors. [#85807](https://github.com/ClickHouse/ClickHouse/pull/85807) ([Azat Khuzhin](https://github.com/azat)). +* Support global constants from `WITH` statement for the parallel distributed `INSERT SELECT` with the `Distributed` destination table. Before, the query could throw an `Unknown expression identifier` error. [#85811](https://github.com/ClickHouse/ClickHouse/pull/85811) ([Nikolai Kochetov](https://github.com/KochetovNicolai)). +* Mask credentials for `deltaLakeAzure`, `deltaLakeCluster`, `icebergS3Cluster` and `icebergAzureCluster`. [#85889](https://github.com/ClickHouse/ClickHouse/pull/85889) ([Julian Maicher](https://github.com/jmaicher)). +* Fix logical error on attempt to `CREATE ... AS (SELECT * FROM s3Cluster(...))` with `DatabaseReplicated`. [#85904](https://github.com/ClickHouse/ClickHouse/pull/85904) ([Konstantin Bogdanov](https://github.com/thevar1able)). +* Fixes HTTP requests made by the `url()` table function to properly include port numbers in the Host header when accessing non-standard ports. This resolves authentication failures when using presigned URLs with S3-compatible services like MinIO running on custom ports, which is common in development environments. (Fixes [#85898](https://github.com/ClickHouse/ClickHouse/issues/85898)). [#85921](https://github.com/ClickHouse/ClickHouse/pull/85921) ([Tom Quist](https://github.com/tomquist)). +* Now unity catalog will ignore schemas with weird data types in case of non-delta tables. Fixes [#85699](https://github.com/ClickHouse/ClickHouse/issues/85699). [#85950](https://github.com/ClickHouse/ClickHouse/pull/85950) ([alesapin](https://github.com/alesapin)). +* Fix nullability of fields in iceberg. [#85977](https://github.com/ClickHouse/ClickHouse/pull/85977) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Fixed a bug in `Replicated` database recovery: if a table name contains the `%` symbol, it could re-create the table with a different name during recovery. [#85987](https://github.com/ClickHouse/ClickHouse/pull/85987) ([Alexander Tokmakov](https://github.com/tavplubix)). +* Fix backup restores failing due to `BACKUP_ENTRY_NOT_FOUND` error when restoring an empty `Memory` table. [#86012](https://github.com/ClickHouse/ClickHouse/pull/86012) ([Julia Kartseva](https://github.com/jkartseva)). +* Add checks for sharding_key during ALTER of the Distributed table. Previously incorrect ALTER would break the table definition and server restart. [#86015](https://github.com/ClickHouse/ClickHouse/pull/86015) ([Nikolay Degterinsky](https://github.com/evillique)). +* Don't create empty iceberg delete file. [#86061](https://github.com/ClickHouse/ClickHouse/pull/86061) ([Konstantin Vedernikov](https://github.com/scanhex12)). +* Fix large setting values breaking S3Queue tables and replica restart. [#86074](https://github.com/ClickHouse/ClickHouse/pull/86074) ([Nikolay Degterinsky](https://github.com/evillique)). + +#### Build/Testing/Packaging Improvement +* Use encrypted disks for tests with S3 by default. [#59898](https://github.com/ClickHouse/ClickHouse/pull/59898) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)). +* Use `clickhouse` binary in integrations tests to get unstripped debug symbols. [#83779](https://github.com/ClickHouse/ClickHouse/pull/83779) ([Mikhail f. Shiryaev](https://github.com/Felixoid)). +* Bumped the internal libxml2 from 2.14.4 to 2.14.5. [#84230](https://github.com/ClickHouse/ClickHouse/pull/84230) ([Robert Schulze](https://github.com/rschu1ze)). +* Bumped internal curl from 8.14.0 to 8.15.0. [#84231](https://github.com/ClickHouse/ClickHouse/pull/84231) ([Robert Schulze](https://github.com/rschu1ze)). +* Now we use less memory for caches in CI and have better tests for eviction. [#84676](https://github.com/ClickHouse/ClickHouse/pull/84676) ([alesapin](https://github.com/alesapin)). + + ### ClickHouse release 25.7, 2025-07-24 {#257} #### Backward Incompatible Change diff --git a/docs/whats-new/roadmap.md b/docs/whats-new/roadmap.md index 7ea4f22cbc3..bd96443545e 100644 --- a/docs/whats-new/roadmap.md +++ b/docs/whats-new/roadmap.md @@ -3,7 +3,7 @@ title: 'Roadmap' slug: /whats-new/roadmap sidebar_position: 50 description: 'Present and past ClickHouse road maps' -doc_type: 'reference' +doc_type: 'landing-page' --- ## Current roadmap {#current-roadmap} diff --git a/docs/whats-new/security-changelog.md b/docs/whats-new/security-changelog.md index d7c6123a1cf..20e9e44e0ff 100644 --- a/docs/whats-new/security-changelog.md +++ b/docs/whats-new/security-changelog.md @@ -4,7 +4,7 @@ sidebar_position: 20 sidebar_label: 'Security changelog' title: 'Security changelog' description: 'Security changelog detailing security related updates and changes' -doc_type: 'reference' +doc_type: 'changelog' --- # Security changelog diff --git a/i18n/jp/docusaurus-plugin-content-docs/current/about-us/beta-and-experimental-features.md b/i18n/jp/docusaurus-plugin-content-docs/current/about-us/beta-and-experimental-features.md index 4949a706f0b..acf78abdcf1 100644 --- a/i18n/jp/docusaurus-plugin-content-docs/current/about-us/beta-and-experimental-features.md +++ b/i18n/jp/docusaurus-plugin-content-docs/current/about-us/beta-and-experimental-features.md @@ -44,110 +44,4 @@ The sections below explicitly describe the properties of **Beta** and **Experime --> -## Beta settings {#beta-settings} - -| Name | Default | -|------|--------| -| [geotoh3_argument_order](/operations/settings/settings#geotoh3_argument_order) | `lat_lon` | -| [allow_experimental_parallel_reading_from_replicas](/operations/settings/settings#allow_experimental_parallel_reading_from_replicas) | `0` | -| [parallel_replicas_mode](/operations/settings/settings#parallel_replicas_mode) | `read_tasks` | -| [parallel_replicas_count](/operations/settings/settings#parallel_replicas_count) | `0` | -| [parallel_replica_offset](/operations/settings/settings#parallel_replica_offset) | `0` | -| [parallel_replicas_custom_key](/operations/settings/settings#parallel_replicas_custom_key) | `` | -| [parallel_replicas_custom_key_range_lower](/operations/settings/settings#parallel_replicas_custom_key_range_lower) | `0` | -| [parallel_replicas_custom_key_range_upper](/operations/settings/settings#parallel_replicas_custom_key_range_upper) | `0` | -| [cluster_for_parallel_replicas](/operations/settings/settings#cluster_for_parallel_replicas) | `` | -| [parallel_replicas_allow_in_with_subquery](/operations/settings/settings#parallel_replicas_allow_in_with_subquery) | `1` | -| [parallel_replicas_for_non_replicated_merge_tree](/operations/settings/settings#parallel_replicas_for_non_replicated_merge_tree) | `0` | -| [parallel_replicas_min_number_of_rows_per_replica](/operations/settings/settings#parallel_replicas_min_number_of_rows_per_replica) | `0` | -| [parallel_replicas_prefer_local_join](/operations/settings/settings#parallel_replicas_prefer_local_join) | `1` | -| [parallel_replicas_mark_segment_size](/operations/settings/settings#parallel_replicas_mark_segment_size) | `0` | -| [parallel_replicas_local_plan](/operations/settings/settings#parallel_replicas_local_plan) | `1` | -| [parallel_replicas_index_analysis_only_on_coordinator](/operations/settings/settings#parallel_replicas_index_analysis_only_on_coordinator) | `1` | -| [parallel_replicas_only_with_analyzer](/operations/settings/settings#parallel_replicas_only_with_analyzer) | `1` | -| [parallel_replicas_insert_select_local_pipeline](/operations/settings/settings#parallel_replicas_insert_select_local_pipeline) | `1` | -| [parallel_replicas_connect_timeout_ms](/operations/settings/settings#parallel_replicas_connect_timeout_ms) | `300` | -| [session_timezone](/operations/settings/settings#session_timezone) | `` | -| [low_priority_query_wait_time_ms](/operations/settings/settings#low_priority_query_wait_time_ms) | `1000` | -| [max_limit_for_vector_search_queries](/operations/settings/settings#max_limit_for_vector_search_queries) | `1000` | -| [hnsw_candidate_list_size_for_search](/operations/settings/settings#hnsw_candidate_list_size_for_search) | `256` | -| [vector_search_filter_strategy](/operations/settings/settings#vector_search_filter_strategy) | `auto` | -| [vector_search_postfilter_multiplier](/operations/settings/settings#vector_search_postfilter_multiplier) | `1` | -| [allow_experimental_delta_kernel_rs](/operations/settings/settings#allow_experimental_delta_kernel_rs) | `1` | -| [allow_remote_fs_zero_copy_replication](/operations/settings/merge-tree-settings#allow_remote_fs_zero_copy_replication) | `0` | - - -## Experimental settings {#experimental-settings} - -| Name | Default | -|------|--------| -| [allow_experimental_kafka_offsets_storage_in_keeper](/operations/settings/settings#allow_experimental_kafka_offsets_storage_in_keeper) | `0` | -| [allow_experimental_correlated_subqueries](/operations/settings/settings#allow_experimental_correlated_subqueries) | `0` | -| [allow_experimental_materialized_postgresql_table](/operations/settings/settings#allow_experimental_materialized_postgresql_table) | `0` | -| [allow_experimental_funnel_functions](/operations/settings/settings#allow_experimental_funnel_functions) | `0` | -| [allow_experimental_nlp_functions](/operations/settings/settings#allow_experimental_nlp_functions) | `0` | -| [allow_experimental_hash_functions](/operations/settings/settings#allow_experimental_hash_functions) | `0` | -| [allow_experimental_object_type](/operations/settings/settings#allow_experimental_object_type) | `0` | -| [allow_experimental_time_series_table](/operations/settings/settings#allow_experimental_time_series_table) | `0` | -| [allow_experimental_vector_similarity_index](/operations/settings/settings#allow_experimental_vector_similarity_index) | `0` | -| [allow_experimental_codecs](/operations/settings/settings#allow_experimental_codecs) | `0` | -| [throw_on_unsupported_query_inside_transaction](/operations/settings/settings#throw_on_unsupported_query_inside_transaction) | `1` | -| [wait_changes_become_visible_after_commit_mode](/operations/settings/settings#wait_changes_become_visible_after_commit_mode) | `wait_unknown` | -| [implicit_transaction](/operations/settings/settings#implicit_transaction) | `0` | -| [grace_hash_join_initial_buckets](/operations/settings/settings#grace_hash_join_initial_buckets) | `1` | -| [grace_hash_join_max_buckets](/operations/settings/settings#grace_hash_join_max_buckets) | `1024` | -| [join_to_sort_minimum_perkey_rows](/operations/settings/settings#join_to_sort_minimum_perkey_rows) | `40` | -| [join_to_sort_maximum_table_rows](/operations/settings/settings#join_to_sort_maximum_table_rows) | `10000` | -| [allow_experimental_join_right_table_sorting](/operations/settings/settings#allow_experimental_join_right_table_sorting) | `0` | -| [allow_statistics_optimize](/operations/settings/settings#allow_statistics_optimize) | `0` | -| [allow_experimental_statistics](/operations/settings/settings#allow_experimental_statistics) | `0` | -| [allow_experimental_inverted_index](/operations/settings/settings#allow_experimental_inverted_index) | `0` | -| [allow_experimental_full_text_index](/operations/settings/settings#allow_experimental_full_text_index) | `0` | -| [allow_experimental_lightweight_update](/operations/settings/settings#allow_experimental_lightweight_update) | `0` | -| [allow_experimental_join_condition](/operations/settings/settings#allow_experimental_join_condition) | `0` | -| [allow_experimental_live_view](/operations/settings/settings#allow_experimental_live_view) | `0` | -| [live_view_heartbeat_interval](/operations/settings/settings#live_view_heartbeat_interval) | `15` | -| [max_live_view_insert_blocks_before_refresh](/operations/settings/settings#max_live_view_insert_blocks_before_refresh) | `64` | -| [allow_experimental_window_view](/operations/settings/settings#allow_experimental_window_view) | `0` | -| [window_view_clean_interval](/operations/settings/settings#window_view_clean_interval) | `60` | -| [window_view_heartbeat_interval](/operations/settings/settings#window_view_heartbeat_interval) | `15` | -| [wait_for_window_view_fire_signal_timeout](/operations/settings/settings#wait_for_window_view_fire_signal_timeout) | `10` | -| [stop_refreshable_materialized_views_on_startup](/operations/settings/settings#stop_refreshable_materialized_views_on_startup) | `0` | -| [allow_experimental_database_materialized_postgresql](/operations/settings/settings#allow_experimental_database_materialized_postgresql) | `0` | -| [allow_experimental_query_deduplication](/operations/settings/settings#allow_experimental_query_deduplication) | `0` | -| [allow_experimental_database_iceberg](/operations/settings/settings#allow_experimental_database_iceberg) | `0` | -| [allow_experimental_database_unity_catalog](/operations/settings/settings#allow_experimental_database_unity_catalog) | `0` | -| [allow_experimental_database_glue_catalog](/operations/settings/settings#allow_experimental_database_glue_catalog) | `0` | -| [allow_experimental_database_hms_catalog](/operations/settings/settings#allow_experimental_database_hms_catalog) | `0` | -| [allow_experimental_kusto_dialect](/operations/settings/settings#allow_experimental_kusto_dialect) | `0` | -| [allow_experimental_prql_dialect](/operations/settings/settings#allow_experimental_prql_dialect) | `0` | -| [enable_adaptive_memory_spill_scheduler](/operations/settings/settings#enable_adaptive_memory_spill_scheduler) | `0` | -| [make_distributed_plan](/operations/settings/settings#make_distributed_plan) | `0` | -| [distributed_plan_execute_locally](/operations/settings/settings#distributed_plan_execute_locally) | `0` | -| [distributed_plan_default_shuffle_join_bucket_count](/operations/settings/settings#distributed_plan_default_shuffle_join_bucket_count) | `8` | -| [distributed_plan_default_reader_bucket_count](/operations/settings/settings#distributed_plan_default_reader_bucket_count) | `8` | -| [distributed_plan_force_exchange_kind](/operations/settings/settings#distributed_plan_force_exchange_kind) | `` | -| [allow_experimental_ts_to_grid_aggregate_function](/operations/settings/settings#allow_experimental_ts_to_grid_aggregate_function) | `0` | -| [allow_experimental_replacing_merge_with_cleanup](/operations/settings/merge-tree-settings#allow_experimental_replacing_merge_with_cleanup) | `0` | -| [allow_experimental_reverse_key](/operations/settings/merge-tree-settings#allow_experimental_reverse_key) | `0` | -| [enable_replacing_merge_with_cleanup_for_min_age_to_force_merge](/operations/settings/merge-tree-settings#enable_replacing_merge_with_cleanup_for_min_age_to_force_merge) | `0` | -| [force_read_through_cache_for_merges](/operations/settings/merge-tree-settings#force_read_through_cache_for_merges) | `0` | -| [merge_selector_algorithm](/operations/settings/merge-tree-settings#merge_selector_algorithm) | `Simple` | -| [notify_newest_block_number](/operations/settings/merge-tree-settings#notify_newest_block_number) | `0` | -| [part_moves_between_shards_delay_seconds](/operations/settings/merge-tree-settings#part_moves_between_shards_delay_seconds) | `30` | -| [part_moves_between_shards_enable](/operations/settings/merge-tree-settings#part_moves_between_shards_enable) | `0` | -| [remote_fs_zero_copy_path_compatible_mode](/operations/settings/merge-tree-settings#remote_fs_zero_copy_path_compatible_mode) | `0` | -| [remote_fs_zero_copy_zookeeper_path](/operations/settings/merge-tree-settings#remote_fs_zero_copy_zookeeper_path) | `/clickhouse/zero_copy` | -| [remove_rolled_back_parts_immediately](/operations/settings/merge-tree-settings#remove_rolled_back_parts_immediately) | `1` | -| [shared_merge_tree_enable_coordinated_merges](/operations/settings/merge-tree-settings#shared_merge_tree_enable_coordinated_merges) | `0` | -| [shared_merge_tree_enable_keeper_parts_extra_data](/operations/settings/merge-tree-settings#shared_merge_tree_enable_keeper_parts_extra_data) | `0` | -| [shared_merge_tree_merge_coordinator_election_check_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_election_check_period_ms) | `30000` | -| [shared_merge_tree_merge_coordinator_factor](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_factor) | `2` | -| [shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms) | `10000` | -| [shared_merge_tree_merge_coordinator_max_merge_request_size](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_max_merge_request_size) | `20` | -| [shared_merge_tree_merge_coordinator_max_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_max_period_ms) | `10000` | -| [shared_merge_tree_merge_coordinator_merges_prepare_count](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_merges_prepare_count) | `100` | -| [shared_merge_tree_merge_coordinator_min_period_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_coordinator_min_period_ms) | `1` | -| [shared_merge_tree_merge_worker_fast_timeout_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_worker_fast_timeout_ms) | `100` | -| [shared_merge_tree_merge_worker_regular_timeout_ms](/operations/settings/merge-tree-settings#shared_merge_tree_merge_worker_regular_timeout_ms) | `10000` | diff --git a/scripts/categorizer.py b/scripts/categorizer.py index 0a1bfaf52b4..41642a783b8 100644 --- a/scripts/categorizer.py +++ b/scripts/categorizer.py @@ -1,6 +1,6 @@ #!/usr/bin/env python3 """ -Document Categorizer using Diataxis Framework +Document Categorizer using Custom Framework Automatically categorizes markdown documents and updates frontmatter with doc_type. """ @@ -21,23 +21,56 @@ MODEL = 'claude-3-haiku-20240307' MAX_CONTENT_LENGTH = 8000 BATCH_SIZE = 5 -RATE_LIMIT_DELAY = 1 +RATE_LIMIT_DELAY = 2 # Categorization prompt CATEGORIZATION_PROMPT = """ -Categorize this markdown document using the Diataxis framework. +Categorize this markdown document using the following framework. Categories: -- tutorial: Learning-oriented, step-by-step learning journey -- how-to: Task-oriented, problem-solving guides with procedures -- reference: Information-oriented, systematic lookup material (APIs, tables, indexes) -- explanation: Understanding-oriented, conceptual background and context +- guide: Task-oriented content with actionable steps, procedures, or learning paths that users follow to accomplish something +- reference: Information-oriented material that users look up for specific facts, including technical specifications and lookup data +- landing-page: Navigation pages that primarily link to other documents (index pages, TOCs, directory listings with minimal content per item) +- changelog: Version history, release notes, change logs, what's new pages -Guidelines: -- Index/TOC pages with tables of links → reference -- Step-by-step guides with procedures → how-to -- Conceptual overviews and FAQs → explanation -- Learning journeys for beginners → tutorial +Key distinctions: + +GUIDE vs REFERENCE: +- Guide: "How to do X" - Users follow steps to accomplish a task or learn a skill + * Installation instructions, tutorials, walkthroughs, setup procedures + * Configuration guides with specific steps and code examples + * Decision-making frameworks ("How to choose the right engine") + * Learning paths with exercises or examples to follow along + * Step-by-step processes, workflows, procedures + * Migration guides, troubleshooting procedures + * Case studies and success stories that demonstrate implementation approaches + * Documents that show "how to configure/implement/set up/use" something + * Examples: "Getting Started Tutorial", "How to Create Tables", "Setting Up Replication", "Migrating from PostgreSQL", "Defining Ordering Keys", "Creative Use Cases" + +- Reference: Pure lookup material users consult for technical information + * API documentation, function definitions, configuration parameter lists + * Engine specifications, data type references, SQL syntax documentation + * Pure technical specifications without implementation guidance + * Adopters lists, error code references, parameter tables + * Architecture overviews that explain concepts without showing implementation steps + * Function syntax, data type definitions, specification documents + * Examples: "SQL Functions Reference", "MergeTree Engine Specification", "Configuration Parameters List", "Data Types Documentation", "ClickHouse Adopters" + +REFERENCE vs LANDING-PAGE: +- Reference: Contains substantial technical information that users look up +- Landing-page: Primarily navigation with minimal content per item (lists of links, table of contents, directory pages) + +Decision framework: +1. Does it document version changes, release notes, or what's new? → changelog +2. Is it primarily navigation with minimal content per item? → landing-page +3. Does it provide step-by-step instructions, procedures, or implementation guidance (including case studies)? → guide +4. Does it contain technical specifications or information users look up? → reference + +Examples by category: +- Guide: "Installing ClickHouse", "Creating Your First Dashboard", "Migration from MySQL Tutorial", "Setting Up Authentication", "Creative Use Cases" +- Reference: "SQL Functions", "MergeTree Engine Documentation", "Configuration Parameters", "Data Types", "ClickHouse Architecture", "Adopters List" +- Landing-page: "Documentation Home", "Table of Contents", "Available Integrations", "Function Categories" +- Changelog: "Release Notes v22.8", "What's New", "Version History", "Breaking Changes" Filename: {filename} Title: {title} @@ -45,13 +78,14 @@ Content: {content} -IMPORTANT: Respond with ONLY one word: tutorial, how-to, reference, or explanation +IMPORTANT: Respond with ONLY one word: guide, reference, landing-page, or changelog """ class DocumentCategorizer: - def __init__(self, api_key: str, dry_run: bool = False): + def __init__(self, api_key: str, dry_run: bool = False, force: bool = False): self.api_key = api_key self.dry_run = dry_run + self.force = force self.session = None self.results = [] @@ -121,25 +155,25 @@ async def categorize_document(self, content: str, filename: str, frontmatter: Di raw_response = result['content'][0]['text'].strip().lower() # Extract category from response - valid_categories = {'tutorial', 'how-to', 'reference', 'explanation'} + valid_categories = {'guide', 'reference', 'landing-page', 'changelog'} # Look for exact matches first for category in valid_categories: if category in raw_response: return category - # Fallback patterns - if 'tutorial' in raw_response or 'learning' in raw_response: - return 'tutorial' - elif 'how-to' in raw_response or 'how to' in raw_response or 'step-by-step' in raw_response: - return 'how-to' - elif 'reference' in raw_response or 'lookup' in raw_response or 'api' in raw_response: - return 'reference' + # Fallback patterns with updated logic + if any(term in raw_response for term in ['changelog', 'change log', 'release notes', 'version history', 'what\'s new']): + return 'changelog' + elif any(term in raw_response for term in ['tutorial', 'how-to', 'how to', 'step-by-step', 'learning', 'guide', 'installation', 'setup']): + return 'guide' + elif any(term in raw_response for term in ['index', 'toc', 'table of contents', 'navigation', 'directory', 'links to']): + return 'landing-page' else: - return 'explanation' + return 'reference' def add_doc_type_to_frontmatter(self, file_path: Path, category: str) -> bool: - """Add doc_type to existing frontmatter without reformatting.""" + """Add or update doc_type to existing frontmatter without reformatting.""" try: with open(file_path, 'r', encoding='utf-8') as f: content = f.read() @@ -154,8 +188,23 @@ def add_doc_type_to_frontmatter(self, file_path: Path, category: str) -> bool: frontmatter_end = match.group(3) # "\n---\n" body = match.group(4) # Rest of document - # Add doc_type as the last line in frontmatter - new_frontmatter_content = frontmatter_content + f"\ndoc_type: '{category}'" + # Check if doc_type already exists and update it, otherwise add it + doc_type_pattern = r'^doc_type:\s*.*$' + lines = frontmatter_content.split('\n') + + doc_type_updated = False + for i, line in enumerate(lines): + if re.match(doc_type_pattern, line.strip()): + lines[i] = f"doc_type: '{category}'" + doc_type_updated = True + break + + if not doc_type_updated: + # Add doc_type as the last line in frontmatter + new_frontmatter_content = frontmatter_content + f"\ndoc_type: '{category}'" + else: + new_frontmatter_content = '\n'.join(lines) + new_content = f"{frontmatter_start}{new_frontmatter_content}{frontmatter_end}{body}" if not self.dry_run: @@ -183,8 +232,8 @@ async def process_document(self, file_path: Path) -> Dict: 'reason': 'no_frontmatter' } - # Skip if already categorized - if has_doc_type: + # Skip if already categorized (unless force is enabled) + if has_doc_type and not self.force: return { 'file': str(file_path), 'status': 'skipped', @@ -229,6 +278,8 @@ async def process_directory(self, directory: Path, pattern: str = "*.md") -> Non print(f"Found {total_files} markdown files") if self.dry_run: print("DRY RUN MODE - No files will be modified") + if self.force: + print("FORCE MODE - Re-categorizing documents that already have doc_type") processed = 0 @@ -286,9 +337,10 @@ def print_summary(self) -> None: print(f" ... and {len(error_results) - 10} more") async def main(): - parser = argparse.ArgumentParser(description='Categorize markdown documents using Diataxis framework') + parser = argparse.ArgumentParser(description='Categorize markdown documents using custom framework') parser.add_argument('directory', help='Directory containing markdown files') parser.add_argument('--pattern', default='*.md', help='File pattern to match (default: *.md)') + parser.add_argument('--force', action='store_true', help='Re-categorize documents that already have doc_type') parser.add_argument('--dry-run', action='store_true', help='Show what would be done without making changes') parser.add_argument('--output-log', help='Save results to JSON file') @@ -304,7 +356,7 @@ async def main(): print("Get your API key from: https://console.anthropic.com/") return 1 - async with DocumentCategorizer(ANTHROPIC_API_KEY, args.dry_run) as categorizer: + async with DocumentCategorizer(ANTHROPIC_API_KEY, args.dry_run, args.force) as categorizer: try: await categorizer.process_directory(directory, args.pattern) categorizer.print_summary() @@ -316,6 +368,7 @@ async def main(): 'directory': str(directory), 'pattern': args.pattern, 'dry_run': args.dry_run, + 'force': args.force, 'results': categorizer.results }, f, indent=2) print(f"Results saved to {args.output_log}") From 0386b8f614f876a9606138c682defa47bde3a9a5 Mon Sep 17 00:00:00 2001 From: Dominic Tran Date: Tue, 9 Sep 2025 12:24:59 -0500 Subject: [PATCH 5/6] categorizing new files, fixes --- docs/cloud-index.md | 2 +- docs/cloud/features/02_integrations.md | 1 + .../06_security/03_connectivity/01_private-link-overview.md | 1 + docs/cloud/guides/best_practices/index.md | 1 + docs/cloud/guides/best_practices/usagelimits.md | 1 + docs/cloud/onboard/01_discover/01_what_is.md | 1 + docs/cloud/onboard/01_discover/02_use_cases/00_overview.md | 1 + .../onboard/01_discover/02_use_cases/01_real-time-analytics.md | 1 + docs/cloud/onboard/01_discover/02_use_cases/02_observability.md | 1 + .../onboard/01_discover/02_use_cases/03_data_warehousing.md | 1 + .../04_machine_learning_and_genAI/01_machine_learning.md | 1 + .../04_machine_learning_and_genAI/02_agent_facing_analytics.md | 1 + .../02_migrate/01_migration_guides/04_snowflake/01_overview.md | 1 + .../04_snowflake/03_sql_translation_reference.md | 1 + .../02_migrate/01_migration_guides/05_elastic/01_overview.md | 1 + .../02_migrate/01_migration_guides/06_redshift/01_overview.md | 1 + .../01_migration_guides/06_redshift/02_migration_guide.md | 1 + .../06_redshift/03_sql_translation_reference.md | 1 + docs/cloud/onboard/03_tune/resource_tour.md | 1 + docs/cloud/onboard/index.md | 1 + docs/cloud/reference/01_changelog/02_release_notes/index.md | 1 + docs/cloud/reference/03_billing/03_clickpipes_billing.md | 1 + .../example-datasets/hacker-news-vector-search.md | 1 + docs/managing-data/core-concepts/parts.md | 1 + 24 files changed, 24 insertions(+), 1 deletion(-) diff --git a/docs/cloud-index.md b/docs/cloud-index.md index f277bba83e2..7699a0217f8 100644 --- a/docs/cloud-index.md +++ b/docs/cloud-index.md @@ -1,5 +1,5 @@ --- -slug: /cloud/overview +slug: /cloud/about-us keywords: ['AWS', 'Cloud', 'serverless'] title: 'Overview' hide_title: true diff --git a/docs/cloud/features/02_integrations.md b/docs/cloud/features/02_integrations.md index d30fb71e7e1..3f1b5fd135b 100644 --- a/docs/cloud/features/02_integrations.md +++ b/docs/cloud/features/02_integrations.md @@ -3,6 +3,7 @@ sidebar_label: 'Integrations' slug: /manage/integrations title: 'Integrations' description: 'Integrations for ClickHouse' +doc_type: 'landing-page' --- import Kafkasvg from '@site/static/images/integrations/logos/kafka.svg'; diff --git a/docs/cloud/features/06_security/03_connectivity/01_private-link-overview.md b/docs/cloud/features/06_security/03_connectivity/01_private-link-overview.md index ad104f8c759..4744e5a78f4 100644 --- a/docs/cloud/features/06_security/03_connectivity/01_private-link-overview.md +++ b/docs/cloud/features/06_security/03_connectivity/01_private-link-overview.md @@ -3,6 +3,7 @@ sidebar_label: 'Private link overview' slug: /cloud/security/private-link-overview title: 'Private link overview' description: 'Landing page for private link' +doc_type: 'landing-page' --- # Private link overview diff --git a/docs/cloud/guides/best_practices/index.md b/docs/cloud/guides/best_practices/index.md index 4719ea2750a..86f6a53df8b 100644 --- a/docs/cloud/guides/best_practices/index.md +++ b/docs/cloud/guides/best_practices/index.md @@ -4,6 +4,7 @@ keywords: ['Cloud', 'Best Practices', 'Bulk Inserts', 'Asynchronous Inserts', 'A title: 'Overview' hide_title: true description: 'Landing page for Best Practices section in ClickHouse Cloud' +doc_type: 'landing-page' --- import TableOfContents from '@site/docs/best-practices/_snippets/_table_of_contents.md'; diff --git a/docs/cloud/guides/best_practices/usagelimits.md b/docs/cloud/guides/best_practices/usagelimits.md index af49f5956be..78f5743adcf 100644 --- a/docs/cloud/guides/best_practices/usagelimits.md +++ b/docs/cloud/guides/best_practices/usagelimits.md @@ -3,6 +3,7 @@ slug: /cloud/bestpractices/usage-limits sidebar_label: 'Service limits' title: 'Usage limits' description: 'Describes the recommended usage limits in ClickHouse Cloud' +doc_type: 'reference' --- While ClickHouse is known for its speed and reliability, optimal performance is diff --git a/docs/cloud/onboard/01_discover/01_what_is.md b/docs/cloud/onboard/01_discover/01_what_is.md index 37a515a551f..98c7a5abf6c 100644 --- a/docs/cloud/onboard/01_discover/01_what_is.md +++ b/docs/cloud/onboard/01_discover/01_what_is.md @@ -4,6 +4,7 @@ title: 'Introduction' description: 'Learn what ClickHouse Cloud is, its benefits over open-source, and key features of the fully managed analytics platform' keywords: ['clickhouse cloud', 'what is clickhouse cloud', 'clickhouse cloud overview', 'clickhouse cloud features'] hide_title: true +doc_type: 'guide' --- ## What is ClickHouse Cloud? {#what-is-clickhouse-cloud} diff --git a/docs/cloud/onboard/01_discover/02_use_cases/00_overview.md b/docs/cloud/onboard/01_discover/02_use_cases/00_overview.md index 8bbd22c0914..79fa15dc2bc 100644 --- a/docs/cloud/onboard/01_discover/02_use_cases/00_overview.md +++ b/docs/cloud/onboard/01_discover/02_use_cases/00_overview.md @@ -4,6 +4,7 @@ title: 'Building on ClickHouse Cloud' description: 'Explore ClickHouse Cloud use cases including real-time analytics, observability, data lake & warehouse, and machine learning applications' keywords: ['use cases', 'Cloud'] sidebar_label: 'Overview' +doc_type: 'landing-page' --- ClickHouse Cloud is suitable for use as both a **primary data store** and as an **analytics diff --git a/docs/cloud/onboard/01_discover/02_use_cases/01_real-time-analytics.md b/docs/cloud/onboard/01_discover/02_use_cases/01_real-time-analytics.md index 67aa054a4b0..abff368feac 100644 --- a/docs/cloud/onboard/01_discover/02_use_cases/01_real-time-analytics.md +++ b/docs/cloud/onboard/01_discover/02_use_cases/01_real-time-analytics.md @@ -4,6 +4,7 @@ title: 'Real-time analytics' description: 'Learn how to build real-time analytics applications with ClickHouse Cloud for instant insights and data-driven decision making' keywords: ['use cases', 'real-time analytics'] sidebar_label: 'Real-time analytics' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/onboard/01_discover/02_use_cases/02_observability.md b/docs/cloud/onboard/01_discover/02_use_cases/02_observability.md index 97bfb5b263f..367c7bfdbce 100644 --- a/docs/cloud/onboard/01_discover/02_use_cases/02_observability.md +++ b/docs/cloud/onboard/01_discover/02_use_cases/02_observability.md @@ -4,6 +4,7 @@ title: 'Observability' description: 'Use ClickHouse Cloud for observability, monitoring, logging, and system performance analysis in distributed applications' keywords: ['use cases', 'observability'] sidebar_label: 'Observability' +doc_type: 'guide' --- diff --git a/docs/cloud/onboard/01_discover/02_use_cases/03_data_warehousing.md b/docs/cloud/onboard/01_discover/02_use_cases/03_data_warehousing.md index 3b2e325161c..b2460585065 100644 --- a/docs/cloud/onboard/01_discover/02_use_cases/03_data_warehousing.md +++ b/docs/cloud/onboard/01_discover/02_use_cases/03_data_warehousing.md @@ -4,6 +4,7 @@ title: 'Data Lakehouse' description: 'Build modern data warehousing architectures with ClickHouse Cloud combining the flexibility of data lakes with database performance' keywords: ['use cases', 'data lake and warehouse'] sidebar_label: 'Data warehousing' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/01_machine_learning.md b/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/01_machine_learning.md index 8f05907fe07..598255938ed 100644 --- a/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/01_machine_learning.md +++ b/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/01_machine_learning.md @@ -4,6 +4,7 @@ title: 'Machine learning' description: 'Learn how ClickHouse powers machine learning applications across the ML pipeline.' keywords: ['use cases', 'Machine Learning', 'Generative AI'] sidebar_label: 'Machine learning' +doc_type: 'guide' --- import machine_learning_data_layer from '@site/static/images/cloud/onboard/discover/use_cases/ml_data_layer.png' diff --git a/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/02_agent_facing_analytics.md b/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/02_agent_facing_analytics.md index 518c78c700e..40e825a3c48 100644 --- a/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/02_agent_facing_analytics.md +++ b/docs/cloud/onboard/01_discover/02_use_cases/04_machine_learning_and_genAI/02_agent_facing_analytics.md @@ -4,6 +4,7 @@ title: 'Agent facing analytics' description: 'Build agent-facing analytics systems with ClickHouse Cloud for AI agents and autonomous systems requiring real-time data access' keywords: ['use cases', 'Machine Learning', 'Generative AI', 'agent facing analytics', 'agents'] sidebar_label: 'Agent facing analytics' +doc_type: 'guide' --- import Image from '@theme/IdealImage'; diff --git a/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/01_overview.md b/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/01_overview.md index 6139ff66887..f23b6ecebca 100644 --- a/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/01_overview.md +++ b/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/01_overview.md @@ -5,6 +5,7 @@ description: 'Migrating from Snowflake to ClickHouse' keywords: ['Snowflake'] title: 'Migrate from Snowflake to ClickHouse' show_related_blogs: true +doc_type: 'guide' --- import snowflake_architecture from '@site/static/images/cloud/onboard/discover/use_cases/snowflake_architecture.png'; diff --git a/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/03_sql_translation_reference.md b/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/03_sql_translation_reference.md index 04d7462d0a4..22b00f8c876 100644 --- a/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/03_sql_translation_reference.md +++ b/docs/cloud/onboard/02_migrate/01_migration_guides/04_snowflake/03_sql_translation_reference.md @@ -5,6 +5,7 @@ description: 'SQL translation reference' keywords: ['Snowflake'] title: 'Migrating from Snowflake to ClickHouse' show_related_blogs: true +doc_type: 'guide' --- # Snowflake SQL translation guide diff --git a/docs/cloud/onboard/02_migrate/01_migration_guides/05_elastic/01_overview.md b/docs/cloud/onboard/02_migrate/01_migration_guides/05_elastic/01_overview.md index 2104a173b02..1e78d10a3b3 100644 --- a/docs/cloud/onboard/02_migrate/01_migration_guides/05_elastic/01_overview.md +++ b/docs/cloud/onboard/02_migrate/01_migration_guides/05_elastic/01_overview.md @@ -5,6 +5,7 @@ description: 'Migrating from Snowflake to ClickHouse' keywords: ['Snowflake'] title: 'Migrate from Snowflake to ClickHouse' show_related_blogs: true +doc_type: 'landing-page' --- # Elasticsearch to ClickHouse migration diff --git a/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/01_overview.md b/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/01_overview.md index 785eba5d98a..e233884bc5c 100644 --- a/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/01_overview.md +++ b/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/01_overview.md @@ -4,6 +4,7 @@ slug: /migrations/redshift-overview description: 'Migrating from Amazon Redshift to ClickHouse' keywords: ['Redshift'] title: 'Comparing ClickHouse Cloud and Amazon Redshift' +doc_type: 'guide' --- # Amazon Redshift to ClickHouse migration diff --git a/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/02_migration_guide.md b/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/02_migration_guide.md index 506c9957e58..cfb41fe1d4f 100644 --- a/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/02_migration_guide.md +++ b/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/02_migration_guide.md @@ -4,6 +4,7 @@ slug: /migrations/redshift/migration-guide description: 'Migrating from Amazon Redshift to ClickHouse' keywords: ['Redshift'] title: 'Amazon Redshift to ClickHouse migration guide' +doc_type: 'guide' --- import MigrationGuide from '@site/docs/integrations/data-ingestion/redshift/_snippets/_migration_guide.md' diff --git a/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/03_sql_translation_reference.md b/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/03_sql_translation_reference.md index 67585e4ea72..e87e5a7e301 100644 --- a/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/03_sql_translation_reference.md +++ b/docs/cloud/onboard/02_migrate/01_migration_guides/06_redshift/03_sql_translation_reference.md @@ -4,6 +4,7 @@ slug: /migrations/redshift/sql-translation-reference description: 'SQL translation reference for Amazon Redshift to ClickHouse' keywords: ['Redshift'] title: 'Amazon Redshift SQL translation guide' +doc_type: 'reference' --- # Amazon Redshift SQL translation guide diff --git a/docs/cloud/onboard/03_tune/resource_tour.md b/docs/cloud/onboard/03_tune/resource_tour.md index 09217a392f9..c17b862dfac 100644 --- a/docs/cloud/onboard/03_tune/resource_tour.md +++ b/docs/cloud/onboard/03_tune/resource_tour.md @@ -4,6 +4,7 @@ title: 'Resource tour' description: 'Overview of ClickHouse Cloud documentation resources for query optimization, scaling strategies, monitoring, and best practices' keywords: ['clickhouse cloud'] hide_title: true +doc_type: 'guide' --- import TableOfContentsBestPractices from '@site/docs/best-practices/_snippets/_table_of_contents.md'; diff --git a/docs/cloud/onboard/index.md b/docs/cloud/onboard/index.md index 742a9c87254..8d04bc07b97 100644 --- a/docs/cloud/onboard/index.md +++ b/docs/cloud/onboard/index.md @@ -3,6 +3,7 @@ slug: /cloud/get-started title: 'Get started with ClickHouse Cloud' description: 'Complete guide to getting started with ClickHouse Cloud - from discovering features to deployment and optimization' hide_title: true +doc_type: 'guide' --- # Get started with ClickHouse Cloud diff --git a/docs/cloud/reference/01_changelog/02_release_notes/index.md b/docs/cloud/reference/01_changelog/02_release_notes/index.md index ab87960c306..b147678fe10 100644 --- a/docs/cloud/reference/01_changelog/02_release_notes/index.md +++ b/docs/cloud/reference/01_changelog/02_release_notes/index.md @@ -2,6 +2,7 @@ slug: /cloud/reference/changelogs/release-notes title: 'Cloud Release Notes' description: 'Landing page for Cloud release notes' +doc_type: 'changelog' ---