You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by mo...@apache.org on 2025/11/05 01:46:34 UTC
(doris-website) branch master updated: [Update] doc 4.0 part4 (#3048)
This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 84f76f8122a [Update] doc 4.0 part4 (#3048)
84f76f8122a is described below
commit 84f76f8122a4dc39c4473121c72f357760b429a0
Author: zhuwei <33...@users.noreply.github.com>
AuthorDate: Wed Nov 5 09:46:28 2025 +0800
[Update] doc 4.0 part4 (#3048)
This is the forth pr to add 4.0 docs. Details at
https://github.com/apache/doris-website/pull/3004
Co-authored-by: zhuwei <zh...@gmail.com>
---
.github/workflows/build-check.yml | 14 +-
.../version-4.x.json | 798 ++++++
.../version-4.x/admin-manual/audit-plugin.md | 69 +
.../auth/authentication-and-authorization.md | 381 +++
.../admin-manual/auth/authentication/federation.md | 201 ++
.../admin-manual/auth/authentication/internal.md | 149 ++
.../admin-manual/auth/authorization/data.md | 53 +
.../admin-manual/auth/authorization/internal.md | 115 +
.../admin-manual/auth/authorization/ranger.md | 267 ++
.../version-4.x/admin-manual/auth/certificate.md | 94 +
.../admin-manual/auth/encryption-function.md | 20 +
.../admin-manual/auth/fe-certificate.md | 30 +
.../aws-authentication-and-authorization.md | 615 +++++
.../admin-manual/auth/integrations/aws-iam-role.md | 81 +
.../version-4.x/admin-manual/auth/ldap.md | 264 ++
.../version-4.x/admin-manual/auth/ranger.md | 284 ++
.../admin-manual/auth/security-overview.md | 32 +
.../cluster-management/elastic-expansion.md | 122 +
.../admin-manual/cluster-management/fqdn.md | 95 +
.../cluster-management/load-balancing.md | 595 +++++
.../admin-manual/cluster-management/time-zone.md | 226 ++
.../admin-manual/cluster-management/upgrade.md | 225 ++
.../version-4.x/admin-manual/config/be-config.md | 1346 ++++++++++
.../version-4.x/admin-manual/config/config-dir.md | 30 +
.../admin-manual/config/fe-config-template.md | 120 +
.../version-4.x/admin-manual/config/fe-config.md | 2768 ++++++++++++++++++++
.../admin-manual/config/user-property.md | 52 +
.../data-admin/backup-restore/backup.md | 245 ++
.../data-admin/backup-restore/overview.md | 69 +
.../data-admin/backup-restore/restore.md | 128 +
.../admin-manual/data-admin/ccr/config.md | 44 +
.../admin-manual/data-admin/ccr/feature.md | 256 ++
.../admin-manual/data-admin/ccr/manual.md | 337 +++
.../admin-manual/data-admin/ccr/overview.md | 88 +
.../admin-manual/data-admin/ccr/performance.md | 59 +
.../admin-manual/data-admin/ccr/quickstart.md | 78 +
.../admin-manual/data-admin/overview.md | 49 +
.../admin-manual/data-admin/recyclebin.md | 46 +
.../admin-manual/log-management/be-log.md | 136 +
.../admin-manual/log-management/fe-log.md | 171 ++
.../maint-monitor/automatic-service-start.md | 321 +++
.../admin-manual/maint-monitor/disk-capacity.md | 154 ++
.../admin-manual/maint-monitor/metrics.md | 333 +++
.../admin-manual/maint-monitor/monitor-alert.md | 287 ++
.../maint-monitor/tablet-repair-and-balance.md | 764 ++++++
.../admin-manual/open-api/be-http/be-vlog.md | 41 +
.../open-api/be-http/check-rpc-channel.md | 52 +
.../open-api/be-http/check-tablet-segment.md | 54 +
.../admin-manual/open-api/be-http/checksum.md | 43 +
.../open-api/be-http/compaction-run.md | 119 +
.../open-api/be-http/compaction-status.md | 98 +
.../admin-manual/open-api/be-http/config.md | 84 +
.../admin-manual/open-api/be-http/download.md | 38 +
.../admin-manual/open-api/be-http/health.md | 34 +
.../admin-manual/open-api/be-http/meta.md | 52 +
.../admin-manual/open-api/be-http/metrics.md | 48 +
.../admin-manual/open-api/be-http/pad-rowset.md | 47 +
.../open-api/be-http/reset-rpc-channel.md | 49 +
.../admin-manual/open-api/be-http/snapshot.md | 41 +
.../open-api/be-http/tablet-distribution.md | 71 +
.../admin-manual/open-api/be-http/tablet-info.md | 57 +
.../open-api/be-http/tablet-migration.md | 90 +
.../admin-manual/open-api/be-http/tablet-reload.md | 44 +
.../open-api/be-http/tablet-restore.md | 44 +
.../admin-manual/open-api/be-http/version-info.md | 58 +
.../open-api/fe-http/backends-action.md | 49 +
.../open-api/fe-http/bootstrap-action.md | 107 +
.../open-api/fe-http/cancel-load-action.md | 80 +
.../open-api/fe-http/check-decommission-action.md | 63 +
.../open-api/fe-http/check-storage-type-action.md | 63 +
.../open-api/fe-http/cluster-action.md | 68 +
.../open-api/fe-http/colocate-meta-action.md | 38 +
.../admin-manual/open-api/fe-http/config-action.md | 64 +
.../open-api/fe-http/connection-action.md | 61 +
.../open-api/fe-http/debug-point-action.md | 307 +++
.../open-api/fe-http/extra-basepath-action.md | 37 +
.../open-api/fe-http/fe-version-info-action.md | 80 +
.../open-api/fe-http/get-ddl-stmt-action.md | 71 +
.../open-api/fe-http/get-load-info-action.md | 73 +
.../open-api/fe-http/get-load-state.md | 77 +
.../open-api/fe-http/get-log-file-action.md | 90 +
.../open-api/fe-http/get-small-file.md | 80 +
.../open-api/fe-http/get-wal-size-action.md | 0
.../admin-manual/open-api/fe-http/ha-action.md | 74 +
.../open-api/fe-http/hardware-info-action.md | 61 +
.../admin-manual/open-api/fe-http/health-action.md | 40 +
.../admin-manual/open-api/fe-http/help-action.md | 40 +
.../admin-manual/open-api/fe-http/import-action.md | 32 +
.../admin-manual/open-api/fe-http/log-action.md | 77 +
.../admin-manual/open-api/fe-http/login-action.md | 49 +
.../admin-manual/open-api/fe-http/logout-action.md | 37 +
.../admin-manual/open-api/fe-http/meta-action.md | 37 +
.../open-api/fe-http/meta-info-action-V2.md | 51 +
.../open-api/fe-http/meta-info-action.md | 211 ++
.../open-api/fe-http/meta-replay-state-action.md | 40 +
.../open-api/fe-http/metrics-action.md | 34 +
.../admin-manual/open-api/fe-http/node-action.md | 737 ++++++
.../open-api/fe-http/profile-action.md | 176 ++
.../open-api/fe-http/query-detail-action.md | 95 +
.../fe-http/query-profile-action-controller.md | 87 +
.../open-api/fe-http/query-profile-action.md | 499 ++++
.../open-api/fe-http/query-schema-action.md | 85 +
.../open-api/fe-http/query-stats-action.md | 77 +
.../open-api/fe-http/row-count-action.md | 63 +
.../open-api/fe-http/session-action.md | 103 +
.../open-api/fe-http/set-config-action.md | 128 +
.../open-api/fe-http/show-data-action.md | 90 +
.../open-api/fe-http/show-meta-info-action.md | 117 +
.../open-api/fe-http/show-proc-action.md | 83 +
.../open-api/fe-http/show-runtime-info-action.md | 63 +
.../open-api/fe-http/show-table-data-action.md | 142 +
.../open-api/fe-http/statement-execution-action.md | 80 +
.../open-api/fe-http/statistic-action.md | 37 +
.../admin-manual/open-api/fe-http/system-action.md | 72 +
.../open-api/fe-http/table-query-plan-action.md | 92 +
.../open-api/fe-http/table-row-count-action.md | 67 +
.../open-api/fe-http/table-schema-action.md | 134 +
.../admin-manual/open-api/fe-http/upload-action.md | 138 +
.../version-4.x/admin-manual/open-api/overview.md | 28 +
.../admin-manual/plugin-development-manual.md | 299 +++
.../version-4.x/admin-manual/small-file-mgr.md | 116 +
.../information_schema/active_queries.md | 31 +
.../information_schema/backend_active_tasks.md | 33 +
.../information_schema/backend_configuration.md | 26 +
.../information_schema/backend_tablets.md | 58 +
.../catalog_meta_cache_statistics.md | 57 +
.../information_schema/character_sets.md | 25 +
.../system-tables/information_schema/collations.md | 27 +
.../information_schema/column_privileges.md | 28 +
.../information_schema/column_statistics.md | 25 +
.../system-tables/information_schema/columns.md | 46 +
.../system-tables/information_schema/engines.md | 27 +
.../system-tables/information_schema/events.md | 45 +
.../information_schema/file_cache_statistics.md | 97 +
.../system-tables/information_schema/files.md | 59 +
.../information_schema/global_variables.md | 25 +
.../information_schema/key_column_usage.md | 33 +
.../information_schema/metadata_name_ids.md | 27 +
.../system-tables/information_schema/parameters.md | 37 +
.../system-tables/information_schema/partitions.md | 60 +
.../information_schema/processlist.md | 35 +
.../system-tables/information_schema/profiling.md | 39 +
.../information_schema/referential_constraints.md | 32 +
.../information_schema/routine_load_job.md | 39 +
.../system-tables/information_schema/routines.md | 44 +
.../system-tables/information_schema/rowsets.md | 34 +
.../information_schema/schema_privileges.md | 27 +
.../system-tables/information_schema/schemata.md | 27 +
.../information_schema/session_variables.md | 25 +
.../system-tables/information_schema/statistics.md | 37 +
.../information_schema/table_constraints.md | 27 +
.../information_schema/table_options.md | 30 +
.../information_schema/table_privileges.md | 27 +
.../information_schema/table_properties.md | 26 +
.../system-tables/information_schema/tables.md | 42 +
.../system-tables/information_schema/triggers.md | 43 +
.../information_schema/user_privileges.md | 25 +
.../system-tables/information_schema/views.md | 31 +
.../workload_group_privileges.md | 25 +
.../workload_group_resource_usage.md | 27 +
.../information_schema/workload_groups.md | 38 +
.../information_schema/workload_policy.md | 29 +
.../system-tables/internal_schema/audit_log.md | 56 +
.../internal_schema/column_statistics.md | 35 +
.../internal_schema/partition_statistics.md | 35 +
.../admin-manual/system-tables/mysql/props_priv.md | 29 +
.../admin-manual/system-tables/mysql/user.md | 53 +
.../admin-manual/system-tables/overview.md | 36 +
.../trouble-shooting/compaction-principles.md | 145 +
.../admin-manual/trouble-shooting/compaction.md | 112 +
.../trouble-shooting/frontend-lock-manager.md | 108 +
.../memory-analysis/doris-cache-memory-analysis.md | 130 +
.../memory-analysis/global-memory-analysis.md | 69 +
.../heap-profile-memory-analysis.md | 24 +
.../memory-analysis/jemalloc-memory-analysis.md | 109 +
.../memory-analysis/load-memory-analysis.md | 32 +
.../memory-analysis/memory-log-analysis.md | 77 +
.../memory-analysis/metadata-memory-analysis.md | 51 +
.../memory-analysis/oom-crash-analysis.md | 60 +
...uery-cancelled-after-process-memory-exceeded.md | 97 +
.../query-cancelled-after-query-memory-exceeded.md | 51 +
.../memory-analysis/query-memory-analysis.md | 121 +
.../memory-feature/memory-control-strategy.md | 78 +
.../memory-feature/memory-tracker.md | 90 +
.../memory-management/memory-issue-faq.md | 84 +
.../trouble-shooting/memory-management/overview.md | 144 +
.../trouble-shooting/metadata-operation.md | 328 +++
.../trouble-shooting/repairing-data.md | 33 +
.../trouble-shooting/tablet-local-debug.md | 207 ++
.../trouble-shooting/tablet-meta-tool.md | 129 +
.../workload-management/analysis-diagnosis.md | 138 +
.../workload-management/compute-group.md | 143 +
.../concurrency-control-and-queuing.md | 84 +
.../workload-management/job-scheduler.md | 205 ++
.../admin-manual/workload-management/kill-query.md | 156 ++
.../workload-management/resource-group.md | 157 ++
.../admin-manual/workload-management/spill-disk.md | 327 +++
.../workload-management/sql-blocking.md | 341 +++
.../workload-group-bind-compute-group.md | 75 +
.../workload-management/workload-group.md | 693 +++++
.../workload-management-summary.md | 40 +
.../version-4.x/ai/ai-function-overview.md | 279 ++
.../version-4.x/ai/text-search/custom-analyzer.md | 281 ++
.../version-4.x/ai/text-search/overview.md | 237 ++
.../version-4.x/ai/text-search/scoring.md | 105 +
.../version-4.x/ai/text-search/search-function.md | 264 ++
.../version-4.x/ai/text-search/search-operators.md | 79 +
.../version-4.x/ai/vector-search.md | 386 +++
.../version-4.x/benchmark/ssb.md | 559 ++++
.../version-4.x/benchmark/tpcds.md | 263 ++
.../version-4.x/benchmark/tpch.md | 854 ++++++
.../compute-storage-decoupled/before-deployment.md | 131 +
.../compilation-and-deployment.md | 309 +++
.../file-cache/file-cache-internals.md | 115 +
.../file-cache/file-cache.md | 310 +++
.../managing-compute-cluster.md | 151 ++
.../managing-storage-vault.md | 229 ++
.../compute-storage-decoupled/overview.md | 74 +
.../compute-storage-decoupled/recycler.md | 285 ++
.../file-cache-rw-compute-group-best-practice.md | 164 ++
.../rw/read-write-separation.md | 196 ++
.../compute-storage-decoupled/upgrade.md | 229 ++
.../data-operate/delete/atomicity-replace.md | 45 +
.../data-operate/delete/batch-delete-manual.md | 177 ++
.../data-operate/delete/delete-manual.md | 192 ++
.../data-operate/delete/delete-overview.md | 63 +
.../data-operate/delete/table-temp-partition.md | 217 ++
.../data-operate/delete/truncate-manual.md | 38 +
.../data-operate/export/export-best-practice.md | 96 +
.../data-operate/export/export-manual.md | 387 +++
.../data-operate/export/export-overview.md | 125 +
.../data-operate/export/export-with-mysql-dump.md | 32 +
.../version-4.x/data-operate/export/outfile.md | 287 ++
.../data-operate/import/cdc-load-manual-sample.md | 7 +
.../data-operate/import/complex-types/array.md | 118 +
.../data-operate/import/complex-types/bitmap.md | 129 +
.../data-operate/import/complex-types/hll.md | 72 +
.../data-operate/import/complex-types/json.md | 133 +
.../data-operate/import/complex-types/map.md | 118 +
.../data-operate/import/complex-types/struct.md | 122 +
.../data-operate/import/complex-types/variant.md | 216 ++
.../data-operate/import/data-source/aliyun-oss.md | 187 ++
.../data-operate/import/data-source/amazon-s3.md | 172 ++
.../import/data-source/azure-storage.md | 185 ++
.../data-operate/import/data-source/bigquery.md | 205 ++
.../data-operate/import/data-source/flink.md | 65 +
.../import/data-source/google-cloud-storage.md | 171 ++
.../data-operate/import/data-source/hdfs.md | 163 ++
.../data-operate/import/data-source/huawei-obs.md | 171 ++
.../data-operate/import/data-source/kafka.md | 410 +++
.../data-operate/import/data-source/local-file.md | 229 ++
.../data-source/migrate-data-from-other-olap.md | 21 +
.../data-source/migrate-data-from-other-oltp.md | 162 ++
.../data-operate/import/data-source/minio.md | 193 ++
.../data-operate/import/data-source/redshift.md | 208 ++
.../import/data-source/s3-compatible.md | 177 ++
.../data-operate/import/data-source/snowflake.md | 210 ++
.../data-operate/import/data-source/tencent-cos.md | 171 ++
.../data-operate/import/file-format/csv.md | 468 ++++
.../data-operate/import/file-format/json.md | 441 ++++
.../data-operate/import/file-format/orc.md | 61 +
.../data-operate/import/file-format/parquet.md | 58 +
.../data-operate/import/group-commit-manual.md | 710 +++++
.../data-operate/import/handling-messy-data.md | 185 ++
.../import/import-way/broker-load-manual.md | 864 ++++++
.../import/import-way/insert-into-manual.md | 377 +++
.../import/import-way/insert-into-values-manual.md | 271 ++
.../import/import-way/mysql-load-manual.md | 254 ++
.../import/import-way/routine-load-manual.md | 1768 +++++++++++++
.../import/import-way/stream-load-manual.md | 1031 ++++++++
.../data-operate/import/load-best-practices.md | 43 +
.../data-operate/import/load-data-convert.md | 1116 ++++++++
.../data-operate/import/load-high-availability.md | 103 +
.../import/load-internals/load-internals.md | 211 ++
.../load-internals/routine-load-internals.md | 166 ++
.../version-4.x/data-operate/import/load-manual.md | 50 +
.../version-4.x/data-operate/transaction.md | 486 ++++
.../update/unique-update-concurrent-control.md | 250 ++
.../data-operate/update/unique-update.md | 121 +
.../update/update-of-aggregate-model.md | 62 +
.../data-operate/update/update-of-unique-model.md | 460 ++++
.../data-operate/update/update-overview.md | 253 ++
.../db-connect/arrow-flight-sql-connect.md | 699 +++++
.../version-4.x/db-connect/database-connect.md | 104 +
.../version-4.x/ecosystem/automq-load.md | 109 +
.../version-4.x/ecosystem/bi/apache-superset.md | 65 +
.../version-4.x/ecosystem/bi/clouddm.md | 63 +
.../version-4.x/ecosystem/bi/datagrip.md | 70 +
.../version-4.x/ecosystem/bi/dbeaver.md | 108 +
.../version-4.x/ecosystem/bi/finebi.md | 76 +
.../version-4.x/ecosystem/bi/powerbi.md | 83 +
.../version-4.x/ecosystem/bi/quickbi.md | 26 +
.../version-4.x/ecosystem/bi/quicksight.md | 35 +
.../version-4.x/ecosystem/bi/smartbi.md | 32 +
.../version-4.x/ecosystem/bi/tableau.md | 136 +
.../version-4.x/ecosystem/cloudcanal.md | 63 +
.../version-4.x/ecosystem/datax.md | 327 +++
.../version-4.x/ecosystem/dbt-doris-adapter.md | 520 ++++
.../version-4.x/ecosystem/doris-kafka-connector.md | 591 +++++
.../doris-operator/doris-operator-overview.md | 86 +
.../ecosystem/doris-operator/on-alibaba.md | 136 +
.../version-4.x/ecosystem/doris-operator/on-aws.md | 76 +
.../version-4.x/ecosystem/doris-streamloader.md | 215 ++
.../version-4.x/ecosystem/ecosystem-overview.md | 7 +
.../version-4.x/ecosystem/flink-doris-connector.md | 1126 ++++++++
.../version-4.x/ecosystem/hive-bitmap-udf.md | 145 +
.../version-4.x/ecosystem/hive-hll-udf.md | 228 ++
.../version-4.x/ecosystem/kettle.md | 63 +
.../version-4.x/ecosystem/kyuubi.md | 92 +
.../version-4.x/ecosystem/observability/beats.md | 357 +++
.../ecosystem/observability/fluentbit.md | 351 +++
.../ecosystem/observability/logstash.md | 411 +++
.../ecosystem/observability/opentelemetry.md | 365 +++
.../version-4.x/ecosystem/seatunnel.md | 304 +++
.../version-4.x/ecosystem/spark-doris-connector.md | 576 ++++
.../version-4.x/ecosystem/spark-load.md | 492 ++++
.../version-4.x/faq/bi-faq.md | 46 +
.../version-4.x/faq/correctness-faq.md | 32 +
.../version-4.x/faq/data-faq.md | 165 ++
.../version-4.x/faq/install-faq.md | 317 +++
.../version-4.x/faq/lakehouse-faq.md | 373 +++
.../version-4.x/faq/load-faq.md | 121 +
.../version-4.x/faq/sql-faq.md | 77 +
.../alternatives/alternative-to-clickhouse.mdx | 252 ++
.../alternatives/alternative-to-elasticsearch.mdx | 210 ++
.../alternatives/alternative-to-trino.mdx | 185 ++
.../gettingStarted/demo-block/demo-block.css | 394 +++
.../gettingStarted/demo-block/latest.tsx | 68 +
.../gettingStarted/demo-block/page-hero-1.tsx | 60 +
.../gettingStarted/demo-block/page-hero-2.tsx | 60 +
.../gettingStarted/demo-block/page-hero.tsx | 59 +
.../version-4.x/gettingStarted/quick-start.mdx | 251 ++
.../gettingStarted/what-is-apache-doris.md | 152 ++
.../integrated-storage-compute-deploy-manually.md | 306 +++
.../separating-storage-compute-deploy-manually.md | 344 +++
.../install/deploy-on-cloud/doris-on-aws.md | 111 +
.../integrated-storage-compute/access-cluster.md | 140 +
.../cluster-operation.md | 437 +++
.../install-config-cluster.md | 1027 ++++++++
.../install-doris-cluster.md | 53 +
.../install-doris-operator.md | 51 +
.../separating-storage-compute/config-cg.md | 204 ++
.../separating-storage-compute/config-cluster.md | 277 ++
.../separating-storage-compute/config-fe.md | 270 ++
.../separating-storage-compute/config-ms.md | 121 +
.../install-doris-cluster.md | 137 +
.../separating-storage-compute/install-fdb.md | 125 +
.../install/preparation/cluster-planning.md | 50 +
.../install/preparation/env-checking.md | 122 +
.../version-4.x/install/preparation/os-checking.md | 140 +
.../lakehouse/best-practices/doris-aws-emr.md | 242 ++
.../lakehouse/best-practices/doris-aws-s3tables.md | 201 ++
.../lakehouse/best-practices/doris-dlf-paimon.md | 150 ++
.../lakehouse/best-practices/doris-hudi.md | 295 +++
.../lakehouse/best-practices/doris-iceberg.md | 454 ++++
.../lakehouse/best-practices/doris-maxcompute.md | 109 +
.../lakehouse/best-practices/doris-paimon.md | 250 ++
.../lakehouse/best-practices/optimization.md | 70 +
.../version-4.x/lakehouse/best-practices/tpcds.md | 158 ++
.../version-4.x/lakehouse/best-practices/tpch.md | 127 +
.../version-4.x/lakehouse/catalog-overview.md | 267 ++
.../lakehouse/catalogs/bigquery-catalog.md | 141 +
.../lakehouse/catalogs/delta-lake-catalog.md | 140 +
.../version-4.x/lakehouse/catalogs/es-catalog.md | 509 ++++
.../lakehouse/catalogs/hive-catalog.mdx | 1090 ++++++++
.../version-4.x/lakehouse/catalogs/hudi-catalog.md | 228 ++
.../lakehouse/catalogs/iceberg-catalog.mdx | 1990 ++++++++++++++
.../lakehouse/catalogs/jdbc-catalog-overview.md | 464 ++++
.../lakehouse/catalogs/jdbc-clickhouse-catalog.md | 90 +
.../lakehouse/catalogs/jdbc-ibmdb2-catalog.md | 80 +
.../lakehouse/catalogs/jdbc-mysql-catalog.md | 291 ++
.../lakehouse/catalogs/jdbc-oceanbase-catalog.md | 46 +
.../lakehouse/catalogs/jdbc-oracle-catalog.md | 73 +
.../lakehouse/catalogs/jdbc-pg-catalog.md | 94 +
.../lakehouse/catalogs/jdbc-saphana-catalog.md | 70 +
.../lakehouse/catalogs/jdbc-sqlserver-catalog.md | 118 +
.../version-4.x/lakehouse/catalogs/kudu-catalog.md | 132 +
.../lakehouse/catalogs/maxcompute-catalog.md | 220 ++
.../lakehouse/catalogs/paimon-catalog.mdx | 1152 ++++++++
.../version-4.x/lakehouse/compute-node.md | 95 +
.../version-4.x/lakehouse/data-cache.md | 113 +
.../version-4.x/lakehouse/file-analysis.md | 216 ++
.../version-4.x/lakehouse/file-formats/orc.md | 70 +
.../version-4.x/lakehouse/file-formats/parquet.md | 64 +
.../version-4.x/lakehouse/file-formats/text.md | 89 +
.../version-4.x/lakehouse/lakehouse-overview.md | 158 ++
.../version-4.x/lakehouse/meta-cache.md | 364 +++
.../version-4.x/lakehouse/metastores/aliyun-dlf.md | 91 +
.../version-4.x/lakehouse/metastores/aws-glue.md | 245 ++
.../version-4.x/lakehouse/metastores/filesystem.md | 10 +
.../metastores/google-dataproc-metastore.md | 13 +
.../lakehouse/metastores/hive-metastore.md | 242 ++
.../lakehouse/metastores/iceberg-rest.md | 199 ++
.../lakehouse/sql-convertor/clickhouse-guide.md | 9 +
.../lakehouse/sql-convertor/hive-guide.md | 9 +
.../lakehouse/sql-convertor/pg-guide.md | 9 +
.../lakehouse/sql-convertor/presto-trino-guide.md | 9 +
.../sql-convertor/sql-convertor-overview.md | 217 ++
.../version-4.x/lakehouse/statistics.md | 11 +
.../version-4.x/lakehouse/storages/aliyun-oss.md | 116 +
.../version-4.x/lakehouse/storages/azure-blob.md | 51 +
.../version-4.x/lakehouse/storages/baidu-bos.md | 8 +
.../version-4.x/lakehouse/storages/gcs.md | 9 +
.../version-4.x/lakehouse/storages/hdfs.md | 203 ++
.../version-4.x/lakehouse/storages/huawei-obs.md | 56 +
.../version-4.x/lakehouse/storages/minio.md | 57 +
.../version-4.x/lakehouse/storages/s3.md | 154 ++
.../version-4.x/lakehouse/storages/tencent-cos.md | 55 +
.../version-4.x/log-storage-analysis.md | 543 ++++
.../observability/log-storage-analysis.md | 462 ++++
.../version-4.x/observability/log.md | 492 ++++
.../version-4.x/observability/overview.mdx | 134 +
.../version-4.x/observability/trace.md | 234 ++
.../query-acceleration/colocation-join.md | 424 +++
.../query-acceleration/condition-cache.md | 103 +
.../version-4.x/query-acceleration/dictionary.md | 662 +++++
.../bitmap-precise-deduplication.md | 148 ++
.../hll-approximate-deduplication.md | 155 ++
.../high-concurrent-point-query.md | 184 ++
.../query-acceleration/hints/distribute-hint.md | 120 +
.../query-acceleration/hints/hints-overview.md | 88 +
.../query-acceleration/hints/leading-hint.md | 488 ++++
.../async-materialized-view/faq.md | 484 ++++
.../functions-and-demands.md | 1272 +++++++++
.../async-materialized-view/overview.md | 218 ++
.../async-materialized-view/use-advice.md | 155 ++
.../async-materialized-view/use-guide.md | 880 +++++++
.../materialized-view/overview.md | 54 +
.../materialized-view/sync-materialized-view.md | 604 +++++
.../pipeline-execution-engine.md | 77 +
.../query-optimizer.md | 56 +
.../runtime-filter.md | 410 +++
.../statistics.md | 479 ++++
.../topn-optimization.md | 141 +
.../performance-tuning-overview/analysis-tools.md | 148 ++
.../diagnostic-tools.md | 88 +
.../performance-tuning-overview/tuning-overview.md | 17 +
.../performance-tuning-overview/tuning-process.md | 57 +
.../query-acceleration/sql-cache-manual.md | 220 ++
.../tuning/parallelism-tuning.md | 65 +
.../adjustment-of-runtimefilter-wait-time.md | 100 +
.../tuning/tuning-execution/data-skew-handling.md | 84 +
.../tuning/tuning-execution/parallelism-tuning.md | 135 +
.../query-acceleration/tuning/tuning-parameters.md | 14 +
.../accelerating-queries-with-sql-cache.md | 24 +
.../tuning/tuning-plan/adjusting-join-shuffle.md | 81 +
.../tuning-plan/controlling-hints-with-cbo-rule.md | 69 +
.../tuning/tuning-plan/dml-tuning-plan.md | 10 +
.../optimizing-join-with-colocate-group.md | 15 +
.../tuning/tuning-plan/optimizing-table-index.md | 78 +
.../tuning-plan/optimizing-table-scanning.md | 63 +
.../tuning/tuning-plan/optimizing-table-schema.md | 106 +
.../reordering-join-with-leading-hint.md | 223 ++
.../transparent-rewriting-with-async-mv.md | 149 ++
.../transparent-rewriting-with-sync-mv.md | 77 +
.../version-4.x/query-data/complex-type.md | 12 +
.../version-4.x/query-data/cte.md | 50 +
.../version-4.x/query-data/join.md | 423 +++
.../version-4.x/query-data/lateral-view.md | 80 +
.../query-data/multi-dimensional-analytics.md | 533 ++++
.../version-4.x/query-data/mysql-compatibility.md | 270 ++
.../version-4.x/query-data/subquery.md | 314 +++
.../version-4.x/query-data/udf/alias-function.md | 53 +
.../query-data/udf/java-user-defined-function.md | 519 ++++
.../version-4.x/query-data/window-function.md | 690 +++++
.../version-4.x/releasenotes/all-release.md | 97 +
.../version-4.x/releasenotes/v1.1/release-1.1.0.md | 374 +++
.../version-4.x/releasenotes/v1.1/release-1.1.1.md | 62 +
.../version-4.x/releasenotes/v1.1/release-1.1.2.md | 71 +
.../version-4.x/releasenotes/v1.1/release-1.1.3.md | 70 +
.../version-4.x/releasenotes/v1.1/release-1.1.4.md | 50 +
.../version-4.x/releasenotes/v1.1/release-1.1.5.md | 49 +
.../version-4.x/releasenotes/v1.2/release-1.2.0.md | 602 +++++
.../version-4.x/releasenotes/v1.2/release-1.2.1.md | 174 ++
.../version-4.x/releasenotes/v1.2/release-1.2.2.md | 241 ++
.../version-4.x/releasenotes/v1.2/release-1.2.3.md | 92 +
.../version-4.x/releasenotes/v1.2/release-1.2.4.md | 158 ++
.../version-4.x/releasenotes/v1.2/release-1.2.5.md | 181 ++
.../version-4.x/releasenotes/v1.2/release-1.2.6.md | 115 +
.../version-4.x/releasenotes/v1.2/release-1.2.7.md | 27 +
.../version-4.x/releasenotes/v1.2/release-1.2.8.md | 28 +
.../version-4.x/releasenotes/v2.0/release-2.0.0.md | 203 ++
.../version-4.x/releasenotes/v2.0/release-2.0.1.md | 139 +
.../releasenotes/v2.0/release-2.0.10.md | 36 +
.../releasenotes/v2.0/release-2.0.11.md | 42 +
.../releasenotes/v2.0/release-2.0.12.md | 33 +
.../releasenotes/v2.0/release-2.0.13.md | 38 +
.../releasenotes/v2.0/release-2.0.14.md | 36 +
.../releasenotes/v2.0/release-2.0.15.md | 73 +
.../version-4.x/releasenotes/v2.0/release-2.0.2.md | 191 ++
.../version-4.x/releasenotes/v2.0/release-2.0.3.md | 276 ++
.../version-4.x/releasenotes/v2.0/release-2.0.4.md | 41 +
.../version-4.x/releasenotes/v2.0/release-2.0.5.md | 48 +
.../version-4.x/releasenotes/v2.0/release-2.0.6.md | 34 +
.../version-4.x/releasenotes/v2.0/release-2.0.7.md | 53 +
.../version-4.x/releasenotes/v2.0/release-2.0.8.md | 52 +
.../version-4.x/releasenotes/v2.0/release-2.0.9.md | 49 +
.../version-4.x/releasenotes/v2.1/release-2.1.0.md | 872 ++++++
.../version-4.x/releasenotes/v2.1/release-2.1.1.md | 223 ++
.../releasenotes/v2.1/release-2.1.10.md | 123 +
.../releasenotes/v2.1/release-2.1.11.md | 98 +
.../version-4.x/releasenotes/v2.1/release-2.1.2.md | 97 +
.../version-4.x/releasenotes/v2.1/release-2.1.3.md | 174 ++
.../version-4.x/releasenotes/v2.1/release-2.1.4.md | 271 ++
.../version-4.x/releasenotes/v2.1/release-2.1.5.md | 394 +++
.../version-4.x/releasenotes/v2.1/release-2.1.6.md | 515 ++++
.../version-4.x/releasenotes/v2.1/release-2.1.7.md | 163 ++
.../version-4.x/releasenotes/v2.1/release-2.1.8.md | 179 ++
.../version-4.x/releasenotes/v2.1/release-2.1.9.md | 100 +
.../version-4.x/releasenotes/v3.0/release-3.0.0.md | 433 +++
.../version-4.x/releasenotes/v3.0/release-3.0.1.md | 574 ++++
.../version-4.x/releasenotes/v3.0/release-3.0.2.md | 322 +++
.../version-4.x/releasenotes/v3.0/release-3.0.3.md | 208 ++
.../version-4.x/releasenotes/v3.0/release-3.0.4.md | 209 ++
.../version-4.x/releasenotes/v3.0/release-3.0.5.md | 207 ++
.../version-4.x/releasenotes/v3.0/release-3.0.6.md | 192 ++
.../version-4.x/releasenotes/v3.0/release-3.0.7.md | 179 ++
.../version-4.x/releasenotes/v3.0/release-3.0.8.md | 94 +
.../version-4.x/releasenotes/v3.1/release-3.1.0.md | 646 +++++
.../version-4.x/releasenotes/v3.1/release-3.1.1.md | 241 ++
.../version-4.x/releasenotes/v4.0/release-4.0.0.md | 665 +++++
.../sql-manual/basic-element/comments.md | 33 +
.../basic-element/literal/date-literal.md | 63 +
.../basic-element/literal/numeric-literal.md | 32 +
.../basic-element/literal/string-literal.md | 47 +
.../version-4.x/sql-manual/basic-element/nulls.md | 41 +
.../sql-manual/basic-element/object-identifiers.md | 58 +
.../operators/arithmetic-operators.mdx | 104 +
.../operators/assignment-operators.md | 16 +
.../basic-element/operators/bitwise-operators.md | 19 +
.../boolean-testing-operators.md | 18 +
.../conditional-operators/comparison-operators.md | 21 +
.../conditional-operators/exists-operators.md | 16 +
.../full-text-search-operators.md | 27 +
.../conditional-operators/in-operators.md | 17 +
.../conditional-operators/logical-operators.md | 42 +
.../pattern-matching-operators.md | 89 +
.../basic-element/operators/operator-precedence.md | 29 +
.../sql-manual/basic-element/reserved-keywords.md | 191 ++
.../sql-data-types/aggregate/AGG-STATE.md | 75 +
.../sql-data-types/aggregate/BITMAP.md | 56 +
.../basic-element/sql-data-types/aggregate/HLL.md | 29 +
.../sql-data-types/aggregate/QUANTILE-STATE.md | 52 +
.../sql-data-types/binary-type/VARBINARY.md | 19 +
.../sql-data-types/conversion/array-conversion.md | 141 +
.../conversion/boolean-conversion.md | 141 +
.../sql-data-types/conversion/cast-expr.md | 121 +
.../sql-data-types/conversion/cast-to-string.md | 390 +++
.../sql-data-types/conversion/date-conversion.md | 493 ++++
.../conversion/datetime-conversion.md | 570 ++++
.../conversion/decimal-conversion.md | 274 ++
.../conversion/float-double-conversion.md | 352 +++
.../sql-data-types/conversion/int-conversion.md | 334 +++
.../sql-data-types/conversion/ip-conversion.md | 235 ++
.../sql-data-types/conversion/json-conversion.md | 383 +++
.../sql-data-types/conversion/map-conversion.md | 144 +
.../sql-data-types/conversion/overview.md | 110 +
.../sql-data-types/conversion/struct-conversion.md | 259 ++
.../sql-data-types/conversion/time-conversion.md | 329 +++
.../sql-data-types/data-type-overview.md | 92 +
.../basic-element/sql-data-types/date-time/DATE.md | 46 +
.../sql-data-types/date-time/DATETIME.md | 60 +
.../basic-element/sql-data-types/date-time/TIME.md | 44 +
.../basic-element/sql-data-types/ip/IPV4.md | 59 +
.../basic-element/sql-data-types/ip/IPV6.md | 57 +
.../basic-element/sql-data-types/numeric/BIGINT.md | 15 +
.../sql-data-types/numeric/BOOLEAN.md | 15 +
.../sql-data-types/numeric/DECIMAL.md | 906 +++++++
.../sql-data-types/numeric/FLOATING-POINT.md | 191 ++
.../basic-element/sql-data-types/numeric/INT.md | 15 +
.../sql-data-types/numeric/LARGEINT.md | 14 +
.../sql-data-types/numeric/SMALLINT.md | 15 +
.../sql-data-types/numeric/TINYINT.md | 15 +
.../sql-data-types/semi-structured/ARRAY.md | 270 ++
.../sql-data-types/semi-structured/GEO.md | 378 +++
.../sql-data-types/semi-structured/JSON.md | 1098 ++++++++
.../sql-data-types/semi-structured/MAP.md | 213 ++
.../sql-data-types/semi-structured/STRUCT.md | 203 ++
.../sql-data-types/semi-structured/VARIANT.md | 503 ++++
.../sql-data-types/string-type/CHAR.md | 16 +
.../sql-data-types/string-type/STRING.md | 21 +
.../sql-data-types/string-type/VARCHAR.md | 18 +
.../sql-manual/basic-element/variables.md | 209 ++
.../sql-functions/aggregate-functions/ai-agg.md | 129 +
.../sql-functions/aggregate-functions/any-value.md | 113 +
.../aggregate-functions/approx-count-distinct.md | 136 +
.../aggregate-functions/approx-top-k.md | 7 +
.../aggregate-functions/approx-top-sum.md | 7 +
.../sql-functions/aggregate-functions/array-agg.md | 68 +
.../aggregate-functions/avg-weighted.md | 107 +
.../sql-functions/aggregate-functions/avg.md | 174 ++
.../aggregate-functions/bitmap-agg.md | 87 +
.../aggregate-functions/bitmap-intersect.md | 76 +
.../aggregate-functions/bitmap-union-count.md | 71 +
.../aggregate-functions/bitmap-union-int.md | 69 +
.../aggregate-functions/bitmap-union.md | 68 +
.../sql-functions/aggregate-functions/bool-and.md | 146 ++
.../sql-functions/aggregate-functions/bool-or.md | 145 +
.../sql-functions/aggregate-functions/bool-xor.md | 145 +
.../aggregate-functions/collect-list.md | 72 +
.../aggregate-functions/collect-set.md | 71 +
.../aggregate-functions/corr-welford.md | 83 +
.../sql-functions/aggregate-functions/corr.md | 84 +
.../aggregate-functions/count-by-enum.md | 142 +
.../sql-functions/aggregate-functions/count.md | 111 +
.../aggregate-functions/covar-samp.md | 75 +
.../sql-functions/aggregate-functions/covar.md | 82 +
.../aggregate-functions/group-array-intersect.md | 66 +
.../aggregate-functions/group-array-union.md | 79 +
.../aggregate-functions/group-bit-and.md | 68 +
.../aggregate-functions/group-bit-or.md | 67 +
.../aggregate-functions/group-bit-xor.md | 68 +
.../aggregate-functions/group-bitmap-xor.md | 73 +
.../aggregate-functions/group-concat.md | 118 +
.../sql-functions/aggregate-functions/histogram.md | 135 +
.../aggregate-functions/hll-raw-agg.md | 74 +
.../aggregate-functions/hll-union-agg.md | 72 +
.../aggregate-functions/intersect-count.md | 74 +
.../sql-functions/aggregate-functions/kurt.md | 81 +
.../aggregate-functions/linear-histogram.md | 86 +
.../sql-functions/aggregate-functions/map-agg.md | 81 +
.../sql-functions/aggregate-functions/max-by.md | 70 +
.../sql-functions/aggregate-functions/max.md | 105 +
.../sql-functions/aggregate-functions/median.md | 74 +
.../sql-functions/aggregate-functions/min-by.md | 70 +
.../sql-functions/aggregate-functions/min.md | 105 +
.../percentile-approx-weighted.md | 108 +
.../aggregate-functions/percentile-approx.md | 105 +
.../aggregate-functions/percentile-array.md | 101 +
.../aggregate-functions/percentile.md | 102 +
.../aggregate-functions/percentile_reservoir.md | 91 +
.../aggregate-functions/quantile-union.md | 92 +
.../aggregate-functions/regr-intercept.md | 83 +
.../aggregate-functions/regr-slope.md | 80 +
.../sql-functions/aggregate-functions/retention.md | 164 ++
.../aggregate-functions/sequence-count.md | 186 ++
.../aggregate-functions/sequence-match.md | 184 ++
.../sql-functions/aggregate-functions/skew.md | 92 +
.../aggregate-functions/stddev-samp.md | 59 +
.../sql-functions/aggregate-functions/stddev.md | 64 +
.../sql-functions/aggregate-functions/sum.md | 59 +
.../sql-functions/aggregate-functions/sum0.md | 63 +
.../aggregate-functions/topn-array.md | 78 +
.../aggregate-functions/topn-weighted.md | 81 +
.../sql-functions/aggregate-functions/topn.md | 78 +
.../sql-functions/aggregate-functions/var-samp.md | 67 +
.../sql-functions/aggregate-functions/variance.md | 64 +
.../aggregate-functions/window-funnel.md | 287 ++
.../sql-functions/ai-functions/ai-classify.md | 77 +
.../sql-functions/ai-functions/ai-extract.md | 77 +
.../sql-functions/ai-functions/ai-filter.md | 80 +
.../sql-functions/ai-functions/ai-fixgrammar.md | 76 +
.../sql-functions/ai-functions/ai-function.md | 154 ++
.../sql-functions/ai-functions/ai-generate.md | 76 +
.../sql-functions/ai-functions/ai-mask.md | 79 +
.../sql-functions/ai-functions/ai-sentiment.md | 80 +
.../sql-functions/ai-functions/ai-similarity.md | 86 +
.../sql-functions/ai-functions/ai-summarize.md | 77 +
.../sql-functions/ai-functions/ai-translate.md | 77 +
.../distance-functions/cosine-distance.md | 41 +
.../ai-functions/distance-functions/embed.md | 170 ++
.../distance-functions/inner-product.md | 41 +
.../ai-functions/distance-functions/l1-distance.md | 41 +
.../ai-functions/distance-functions/l2-distance.md | 41 +
.../sql-functions/combinators/foreach.md | 57 +
.../sql-manual/sql-functions/combinators/merge.md | 27 +
.../sql-manual/sql-functions/combinators/state.md | 27 +
.../sql-manual/sql-functions/combinators/union.md | 27 +
.../array-functions/array-apply.md | 180 ++
.../scalar-functions/array-functions/array-avg.md | 147 ++
.../array-functions/array-compact.md | 173 ++
.../array-functions/array-concat.md | 199 ++
.../array-functions/array-contains.md | 214 ++
.../array-functions/array-contains_all.md | 64 +
.../array-functions/array-count.md | 231 ++
.../array-functions/array-cum-sum.md | 175 ++
.../array-functions/array-difference.md | 175 ++
.../array-functions/array-distinct.md | 167 ++
.../array-functions/array-enumerate-uniq.md | 151 ++
.../array-functions/array-enumerate.md | 129 +
.../array-functions/array-except.md | 218 ++
.../array-functions/array-exists.md | 169 ++
.../array-functions/array-filter.md | 256 ++
.../array-functions/array-first-index.md | 161 ++
.../array-functions/array-first.md | 158 ++
.../array-functions/array-flatten.md | 46 +
.../array-functions/array-intersect.md | 145 +
.../scalar-functions/array-functions/array-join.md | 164 ++
.../array-functions/array-last-index.md | 158 ++
.../scalar-functions/array-functions/array-last.md | 146 ++
.../scalar-functions/array-functions/array-map.md | 144 +
.../array-functions/array-match-all.md | 59 +
.../array-functions/array-match-any.md | 65 +
.../scalar-functions/array-functions/array-max.md | 161 ++
.../scalar-functions/array-functions/array-min.md | 161 ++
.../array-functions/array-popback.md | 143 +
.../array-functions/array-popfront.md | 147 ++
.../array-functions/array-position.md | 165 ++
.../array-functions/array-product.md | 136 +
.../array-functions/array-pushback.md | 157 ++
.../array-functions/array-pushfront.md | 157 ++
.../array-functions/array-range.md | 71 +
.../array-functions/array-remove.md | 45 +
.../array-functions/array-repeat.md | 81 +
.../array-functions/array-reverse-sort.md | 39 +
.../array-functions/array-reverse-split.md | 52 +
.../array-functions/array-shuffle.md | 40 +
.../scalar-functions/array-functions/array-size.md | 35 +
.../array-functions/array-slice.md | 54 +
.../scalar-functions/array-functions/array-sort.md | 39 +
.../array-functions/array-sortby.md | 48 +
.../array-functions/array-split.md | 52 +
.../scalar-functions/array-functions/array-sum.md | 72 +
.../array-functions/array-union.md | 94 +
.../array-functions/array-with-constant.md | 82 +
.../scalar-functions/array-functions/array-zip.md | 81 +
.../scalar-functions/array-functions/array.md | 137 +
.../array-functions/arrays-overlap.md | 153 ++
.../scalar-functions/array-functions/countequal.md | 44 +
.../binary-functions/from-base64-binary.md | 71 +
.../scalar-functions/binary-functions/from_hex.md | 71 +
.../binary-functions/sub-binary.md | 107 +
.../binary-functions/to-base64-binary.md | 55 +
.../scalar-functions/binary-functions/to_hex.md | 75 +
.../bitmap-functions/bitmap-and-count.md | 78 +
.../bitmap-functions/bitmap-and-not-count.md | 58 +
.../bitmap-functions/bitmap-and-not.md | 82 +
.../bitmap-functions/bitmap-and.md | 67 +
.../bitmap-functions/bitmap-contains.md | 55 +
.../bitmap-functions/bitmap-count.md | 52 +
.../bitmap-functions/bitmap-empty.md | 50 +
.../bitmap-functions/bitmap-from-array.md | 65 +
.../bitmap-functions/bitmap-from-base64.md | 77 +
.../bitmap-functions/bitmap-from-string.md | 91 +
.../bitmap-functions/bitmap-has-all.md | 79 +
.../bitmap-functions/bitmap-has-any.md | 77 +
.../bitmap-functions/bitmap-hash.md | 84 +
.../bitmap-functions/bitmap-hash64.md | 59 +
.../bitmap-functions/bitmap-max.md | 75 +
.../bitmap-functions/bitmap-min.md | 75 +
.../bitmap-functions/bitmap-not.md | 74 +
.../bitmap-functions/bitmap-or-count.md | 111 +
.../scalar-functions/bitmap-functions/bitmap-or.md | 143 +
.../bitmap-functions/bitmap-remove.md | 64 +
.../bitmap-functions/bitmap-subset-in-range.md | 94 +
.../bitmap-functions/bitmap-subset-limit.md | 105 +
.../bitmap-functions/bitmap-to-array.md | 93 +
.../bitmap-functions/bitmap-to-base64.md | 100 +
.../bitmap-functions/bitmap-to-string.md | 93 +
.../bitmap-functions/bitmap-xor-count.md | 129 +
.../bitmap-functions/bitmap-xor.md | 112 +
.../bitmap-functions/sub-bitmap.md | 93 +
.../scalar-functions/bitmap-functions/to-bitmap.md | 106 +
.../bitwise-functions/bit-length.md | 47 +
.../scalar-functions/bitwise-functions/bit-test.md | 57 +
.../scalar-functions/bitwise-functions/bitand.md | 48 +
.../scalar-functions/bitwise-functions/bitcount.md | 46 +
.../scalar-functions/bitwise-functions/bitnot.md | 46 +
.../scalar-functions/bitwise-functions/bitor.md | 48 +
.../bitwise-functions/bitshiftleft.md | 47 +
.../bitwise-functions/bitshiftright.md | 51 +
.../scalar-functions/bitwise-functions/xor.md | 45 +
.../conditional-functions/coalesce.md | 62 +
.../conditional-functions/greatest.md | 77 +
.../scalar-functions/conditional-functions/if.md | 71 +
.../conditional-functions/ifnull.md | 64 +
.../conditional-functions/least.md | 79 +
.../conditional-functions/not-null-or-empty.md | 35 +
.../conditional-functions/null-or-empty.md | 35 +
.../conditional-functions/nullif.md | 62 +
.../date-time-functions/convert-tz.md | 102 +
.../date-time-functions/curdate.md | 39 +
.../date-time-functions/current-timestamp.md | 58 +
.../date-time-functions/curtime.md | 65 +
.../date-time-functions/date-add.md | 125 +
.../date-time-functions/date-ceil.md | 139 +
.../date-time-functions/date-floor.md | 108 +
.../date-time-functions/date-format.md | 173 ++
.../date-time-functions/date-sub.md | 122 +
.../date-time-functions/date-trunc.md | 111 +
.../scalar-functions/date-time-functions/date.md | 59 +
.../date-time-functions/datediff.md | 79 +
.../date-time-functions/day-ceil.md | 145 +
.../date-time-functions/day-floor.md | 132 +
.../scalar-functions/date-time-functions/day.md | 66 +
.../date-time-functions/dayname.md | 198 ++
.../date-time-functions/dayofweek.md | 72 +
.../date-time-functions/dayofyear.md | 74 +
.../date-time-functions/extract.md | 101 +
.../date-time-functions/from-days.md | 62 +
.../date-time-functions/from-iso8601-date.md | 96 +
.../date-time-functions/from-microsecond.md | 74 +
.../date-time-functions/from-millisecond.md | 75 +
.../date-time-functions/from-second.md | 65 +
.../date-time-functions/from-unixtime.md | 103 +
.../date-time-functions/get-format.md | 113 +
.../date-time-functions/hour-ceil.md | 144 +
.../date-time-functions/hour-floor.md | 126 +
.../scalar-functions/date-time-functions/hour.md | 91 +
.../date-time-functions/hours-add.md | 83 +
.../date-time-functions/hours-diff.md | 83 +
.../date-time-functions/hours-sub.md | 77 +
.../date-time-functions/last-day.md | 80 +
.../date-time-functions/localtime.md | 59 +
.../date-time-functions/makedate.md | 78 +
.../date-time-functions/maketime.md | 98 +
.../date-time-functions/microsecond-timestamp.md | 79 +
.../date-time-functions/microsecond.md | 78 +
.../date-time-functions/microseconds-add.md | 76 +
.../date-time-functions/microseconds-diff.md | 78 +
.../date-time-functions/microseconds-sub.md | 76 +
.../date-time-functions/millisecond-timestamp.md | 89 +
.../date-time-functions/milliseconds-add.md | 118 +
.../date-time-functions/milliseconds-diff.md | 85 +
.../date-time-functions/milliseconds-sub.md | 73 +
.../date-time-functions/minute-ceil.md | 135 +
.../date-time-functions/minute-floor.md | 131 +
.../scalar-functions/date-time-functions/minute.md | 75 +
.../date-time-functions/minutes-add.md | 83 +
.../date-time-functions/minutes-diff.md | 86 +
.../date-time-functions/minutes-sub.md | 87 +
.../date-time-functions/month-ceil.md | 135 +
.../date-time-functions/month-floor.md | 130 +
.../scalar-functions/date-time-functions/month.md | 67 +
.../date-time-functions/monthname.md | 194 ++
.../date-time-functions/months-add.md | 94 +
.../date-time-functions/months-between.md | 103 +
.../date-time-functions/months-diff.md | 109 +
.../date-time-functions/months-sub.md | 95 +
.../date-time-functions/next-day.md | 103 +
.../scalar-functions/date-time-functions/now.md | 51 +
.../date-time-functions/quarter-ceil.md | 138 +
.../date-time-functions/quarter-floor.md | 134 +
.../date-time-functions/quarter.md | 85 +
.../date-time-functions/quarters-add.md | 99 +
.../date-time-functions/quarters-diff.md | 42 +
.../date-time-functions/quarters-sub.md | 102 +
.../date-time-functions/sec-to-time.md | 95 +
.../date-time-functions/second-ceil.md | 122 +
.../date-time-functions/second-floor.md | 117 +
.../date-time-functions/second-timestamp.md | 86 +
.../scalar-functions/date-time-functions/second.md | 83 +
.../date-time-functions/seconds-add.md | 91 +
.../date-time-functions/seconds-diff.md | 77 +
.../date-time-functions/seconds-sub.md | 89 +
.../date-time-functions/str-to-date.md | 125 +
.../date-time-functions/time-to-sec.md | 107 +
.../scalar-functions/date-time-functions/time.md | 39 +
.../date-time-functions/timediff.md | 98 +
.../date-time-functions/timestamp.md | 62 +
.../date-time-functions/timestampadd.md | 99 +
.../date-time-functions/timestampdiff.md | 111 +
.../date-time-functions/to-date.md | 55 +
.../date-time-functions/to-days.md | 43 +
.../date-time-functions/to-iso8601.md | 66 +
.../date-time-functions/to-monday.md | 82 +
.../date-time-functions/unix-timestamp.md | 141 +
.../date-time-functions/utc-timestamp.md | 34 +
.../date-time-functions/week-ceil.md | 136 +
.../date-time-functions/week-floor.md | 139 +
.../scalar-functions/date-time-functions/week.md | 109 +
.../date-time-functions/weekday.md | 66 +
.../date-time-functions/weekofyear.md | 93 +
.../date-time-functions/weeks-add.md | 85 +
.../date-time-functions/weeks-diff.md | 111 +
.../date-time-functions/weeks-sub.md | 82 +
.../date-time-functions/year-ceil.md | 143 +
.../date-time-functions/year-floor.md | 166 ++
.../date-time-functions/year-of-week.md | 106 +
.../scalar-functions/date-time-functions/year.md | 58 +
.../date-time-functions/years-add.md | 99 +
.../date-time-functions/years-diff.md | 94 +
.../date-time-functions/years-sub.md | 86 +
.../date-time-functions/yearweek.md | 94 +
.../encrypt-digest-functions/aes-decrypt.md | 91 +
.../encrypt-digest-functions/aes-encrypt.md | 79 +
.../encrypt-digest-functions/crc32.md | 37 +
.../encrypt-digest-functions/md5.md | 54 +
.../encrypt-digest-functions/md5sum.md | 39 +
.../encrypt-digest-functions/murmur-hash3-32.md | 46 +
.../encrypt-digest-functions/murmur-hash3-64-v2.md | 46 +
.../encrypt-digest-functions/murmur-hash3-64.md | 46 +
.../encrypt-digest-functions/sha.md | 59 +
.../encrypt-digest-functions/sha2.md | 92 +
.../encrypt-digest-functions/sm3.md | 54 +
.../encrypt-digest-functions/sm3sum.md | 39 +
.../encrypt-digest-functions/sm4-decrypt.md | 92 +
.../encrypt-digest-functions/sm4-encrypt.md | 73 +
.../encrypt-digest-functions/xxhash-32.md | 69 +
.../encrypt-digest-functions/xxhash-64.md | 72 +
.../hll-functions/hll-cardinality.md | 40 +
.../scalar-functions/hll-functions/hll-empty.md | 34 +
.../hll-functions/hll-from-base64.md | 72 +
.../scalar-functions/hll-functions/hll-hash.md | 43 +
.../hll-functions/hll-to-base64.md | 95 +
.../scalar-functions/ip-functions/cut-ipv6.md | 80 +
.../scalar-functions/ip-functions/cut_ipv6.md | 108 +
.../scalar-functions/ip-functions/inet-aton.md | 98 +
.../scalar-functions/ip-functions/inet-ntoa.md | 87 +
.../scalar-functions/ip-functions/inet6-aton.md | 80 +
.../scalar-functions/ip-functions/inet6-ntoa.md | 69 +
.../ip-functions/ipv4-cidr-to-range.md | 78 +
.../ip-functions/ipv4-num-to-string.md | 52 +
.../ip-functions/ipv4-string-to-num-or-default.md | 83 +
.../ip-functions/ipv4-string-to-num-or-null.md | 51 +
.../ip-functions/ipv4-string-to-num.md | 98 +
.../scalar-functions/ip-functions/ipv4-to-ipv6.md | 83 +
.../ip-functions/ipv4_cidr_to_range.md | 102 +
.../ip-functions/ipv6-cidr-to-range.md | 79 +
.../ip-functions/ipv6-num-to-string.md | 39 +
.../ip-functions/ipv6-string-to-num-or-default.md | 79 +
.../ip-functions/ipv6-string-to-num-or-null.md | 39 +
.../ip-functions/ipv6-string-to-num.md | 71 +
.../ip-functions/ipv6_cidr_to_range.md | 95 +
.../ip-functions/is-ip-address-in-range.md | 122 +
.../ip-functions/is-ipv4-compat.md | 84 +
.../ip-functions/is-ipv4-mapped.md | 81 +
.../ip-functions/is-ipv4-string.md | 87 +
.../ip-functions/is-ipv6-string.md | 88 +
.../ip-functions/to-ipv4-or-default.md | 66 +
.../ip-functions/to-ipv4-or-null.md | 66 +
.../scalar-functions/ip-functions/to-ipv4.md | 58 +
.../ip-functions/to-ipv6-or-default.md | 66 +
.../ip-functions/to-ipv6-or-null.md | 66 +
.../scalar-functions/ip-functions/to-ipv6.md | 60 +
.../json-functions/get-json-bigint.md | 10 +
.../json-functions/get-json-double.md | 10 +
.../json-functions/get-json-int.md | 10 +
.../json-functions/get-json-string.md | 10 +
.../json-functions/json-array-ignore-null.md | 86 +
.../scalar-functions/json-functions/json-array.md | 97 +
.../json-functions/json-contains.md | 95 +
.../json-functions/json-exists-path.md | 70 +
.../json-functions/json-extract-bigint.md | 86 +
.../json-functions/json-extract-bool.md | 86 +
.../json-functions/json-extract-double.md | 86 +
.../json-functions/json-extract-int.md | 86 +
.../json-functions/json-extract-isnull.md | 82 +
.../json-functions/json-extract-largeint.md | 86 +
.../json-functions/json-extract-string.md | 100 +
.../json-functions/json-extract.md | 186 ++
.../scalar-functions/json-functions/json-hash.md | 171 ++
.../scalar-functions/json-functions/json-insert.md | 124 +
.../scalar-functions/json-functions/json-keys.md | 119 +
.../scalar-functions/json-functions/json-length.md | 120 +
.../scalar-functions/json-functions/json-object.md | 163 ++
.../json-functions/json-parse-error-to-null.md | 9 +
.../json-functions/json-parse-error-to-value.md | 9 +
.../scalar-functions/json-functions/json-parse.md | 159 ++
.../scalar-functions/json-functions/json-quote.md | 94 +
.../scalar-functions/json-functions/json-remove.md | 70 +
.../json-functions/json-replace.md | 90 +
.../scalar-functions/json-functions/json-search.md | 153 ++
.../scalar-functions/json-functions/json-set.md | 80 +
.../scalar-functions/json-functions/json-type.md | 99 +
.../json-functions/json-unquote.md | 101 +
.../scalar-functions/json-functions/json-valid.md | 60 +
.../normalize-json-numbers-to-double.md | 145 +
.../json-functions/sort-json-object-keys.md | 107 +
.../json-functions/strip-null-value.md | 69 +
.../scalar-functions/json-functions/to-json.md | 268 ++
.../map-functions/map-contains-entry.md | 70 +
.../map-functions/map-contains-key.md | 48 +
.../map-functions/map-contains-value.md | 61 +
.../scalar-functions/map-functions/map-entries.md | 46 +
.../scalar-functions/map-functions/map-keys.md | 46 +
.../scalar-functions/map-functions/map-size.md | 50 +
.../scalar-functions/map-functions/map-values.md | 52 +
.../scalar-functions/map-functions/map.md | 80 +
.../scalar-functions/map-functions/str-to-map.md | 44 +
.../scalar-functions/numeric-functions/abs.md | 76 +
.../scalar-functions/numeric-functions/acos.md | 122 +
.../scalar-functions/numeric-functions/acosh.md | 121 +
.../scalar-functions/numeric-functions/asin.md | 122 +
.../scalar-functions/numeric-functions/asinh.md | 108 +
.../scalar-functions/numeric-functions/atan.md | 148 ++
.../scalar-functions/numeric-functions/atan2.md | 201 ++
.../scalar-functions/numeric-functions/atanh.md | 109 +
.../scalar-functions/numeric-functions/bin.md | 77 +
.../scalar-functions/numeric-functions/cbrt.md | 106 +
.../scalar-functions/numeric-functions/ceil.md | 120 +
.../scalar-functions/numeric-functions/conv.md | 92 +
.../scalar-functions/numeric-functions/cos.md | 105 +
.../scalar-functions/numeric-functions/cosh.md | 98 +
.../scalar-functions/numeric-functions/cot.md | 96 +
.../scalar-functions/numeric-functions/csc.md | 95 +
.../scalar-functions/numeric-functions/degrees.md | 86 +
.../scalar-functions/numeric-functions/e.md | 27 +
.../scalar-functions/numeric-functions/even.md | 103 +
.../scalar-functions/numeric-functions/exp.md | 72 +
.../scalar-functions/numeric-functions/floor.md | 119 +
.../scalar-functions/numeric-functions/fmod.md | 67 +
.../numeric-functions/format-round.md | 116 +
.../scalar-functions/numeric-functions/gcd.md | 98 +
.../scalar-functions/numeric-functions/isinf.md | 87 +
.../scalar-functions/numeric-functions/isnan.md | 85 +
.../scalar-functions/numeric-functions/lcm.md | 105 +
.../scalar-functions/numeric-functions/ln.md | 97 +
.../scalar-functions/numeric-functions/log.md | 129 +
.../scalar-functions/numeric-functions/log10.md | 71 +
.../scalar-functions/numeric-functions/log2.md | 91 +
.../scalar-functions/numeric-functions/mod.md | 55 +
.../numeric-functions/money-format.md | 66 +
.../scalar-functions/numeric-functions/negative.md | 81 +
.../numeric-functions/normal-cdf.md | 71 +
.../scalar-functions/numeric-functions/pi.md | 34 +
.../scalar-functions/numeric-functions/pmod.md | 80 +
.../scalar-functions/numeric-functions/positive.md | 78 +
.../scalar-functions/numeric-functions/pow.md | 106 +
.../scalar-functions/numeric-functions/radians.md | 66 +
.../scalar-functions/numeric-functions/random.md | 80 +
.../numeric-functions/round-bankers.md | 149 ++
.../scalar-functions/numeric-functions/round.md | 133 +
.../scalar-functions/numeric-functions/sec.md | 95 +
.../scalar-functions/numeric-functions/sign.md | 98 +
.../scalar-functions/numeric-functions/signbit.md | 96 +
.../scalar-functions/numeric-functions/sin.md | 123 +
.../scalar-functions/numeric-functions/sinh.md | 104 +
.../scalar-functions/numeric-functions/sqrt.md | 134 +
.../scalar-functions/numeric-functions/tan.md | 81 +
.../scalar-functions/numeric-functions/tanh.md | 79 +
.../scalar-functions/numeric-functions/truncate.md | 69 +
.../scalar-functions/numeric-functions/uniform.md | 161 ++
.../numeric-functions/uuid_numeric.md | 34 +
.../numeric-functions/width-bucket.md | 140 +
.../scalar-functions/other-functions/convert-to.md | 67 +
.../scalar-functions/other-functions/esquery.md | 60 +
.../scalar-functions/other-functions/field.md | 95 +
.../scalar-functions/other-functions/g.md | 7 +
.../other-functions/grouping-id.md | 99 +
.../scalar-functions/other-functions/grouping.md | 79 +
.../quantile-functions/quantile-percent.md | 62 +
.../quantile-functions/quantile-state-empty.md | 36 +
.../quantile-functions/to-quantile-state.md | 60 +
.../spatial-functions/st-angle-sphere.md | 145 +
.../scalar-functions/spatial-functions/st-angle.md | 145 +
.../spatial-functions/st-area-square-km.md | 169 ++
.../spatial-functions/st-area-square-meters.md | 169 ++
.../spatial-functions/st-asbinary.md | 123 +
.../spatial-functions/st-astext.md | 127 +
.../spatial-functions/st-azimuth.md | 134 +
.../spatial-functions/st-circle.md | 95 +
.../spatial-functions/st-contains.md | 170 ++
.../spatial-functions/st-disjoint.md | 190 ++
.../spatial-functions/st-distance-sphere.md | 109 +
.../spatial-functions/st-geometryfromtext.md | 186 ++
.../spatial-functions/st-geometryfromwkb.md | 134 +
.../spatial-functions/st-intersects.md | 260 ++
.../spatial-functions/st-linefromtext.md | 94 +
.../scalar-functions/spatial-functions/st-point.md | 91 +
.../spatial-functions/st-polygon.md | 94 +
.../spatial-functions/st-touches.md | 260 ++
.../scalar-functions/spatial-functions/st-x.md | 103 +
.../scalar-functions/spatial-functions/st-y.md | 99 +
.../append-trailing-char-if-absent.md | 95 +
.../scalar-functions/string-functions/ascii.md | 142 +
.../string-functions/auto-partition-name.md | 112 +
.../string-functions/char-length.md | 87 +
.../scalar-functions/string-functions/char.md | 81 +
.../scalar-functions/string-functions/compress.md | 80 +
.../scalar-functions/string-functions/concat-ws.md | 166 ++
.../scalar-functions/string-functions/concat.md | 136 +
.../string-functions/count_substrings.md | 121 +
.../cut-to-first-significant-subdomain.md | 67 +
.../string-functions/digital-masking.md | 93 +
.../string-functions/domain-without-www.md | 40 +
.../scalar-functions/string-functions/domain.md | 40 +
.../scalar-functions/string-functions/elt.md | 139 +
.../scalar-functions/string-functions/ends-with.md | 161 ++
.../string-functions/export-set.md | 157 ++
.../string-functions/extract-url-parameter.md | 47 +
.../string-functions/find-in-set.md | 162 ++
.../first-significant-subdomain.md | 40 +
.../string-functions/format-number.md | 86 +
.../scalar-functions/string-functions/format.md | 95 +
.../string-functions/from-base64.md | 161 ++
.../scalar-functions/string-functions/hex.md | 151 ++
.../scalar-functions/string-functions/initcap.md | 161 ++
.../scalar-functions/string-functions/instr.md | 162 ++
.../string-functions/int-to-uuid.md | 54 +
.../scalar-functions/string-functions/is-uuid.md | 98 +
.../scalar-functions/string-functions/lcase.md | 123 +
.../scalar-functions/string-functions/length.md | 150 ++
.../scalar-functions/string-functions/locate.md | 164 ++
.../scalar-functions/string-functions/lpad.md | 150 ++
.../scalar-functions/string-functions/ltrim-in.md | 70 +
.../scalar-functions/string-functions/ltrim.md | 161 ++
.../scalar-functions/string-functions/make-set.md | 114 +
.../string-functions/mask-first-n.md | 184 ++
.../string-functions/mask-last-n.md | 184 ++
.../scalar-functions/string-functions/mask.md | 186 ++
.../string-functions/multi-match-any.md | 35 +
.../string-functions/multi-search-all-positions.md | 100 +
.../string-functions/ngram-search.md | 92 +
.../scalar-functions/string-functions/overlay.md | 100 +
.../scalar-functions/string-functions/overview.md | 125 +
.../string-functions/parse-data-size.md | 131 +
.../scalar-functions/string-functions/parse-url.md | 60 +
.../scalar-functions/string-functions/position.md | 164 ++
.../scalar-functions/string-functions/printf.md | 69 +
.../scalar-functions/string-functions/protocol.md | 58 +
.../scalar-functions/string-functions/quote.md | 106 +
.../string-functions/random_bytes.md | 93 +
.../string-functions/regexp-count.md | 251 ++
.../string-functions/regexp-extract-all.md | 204 ++
.../string-functions/regexp-extract-or-null.md | 230 ++
.../string-functions/regexp-extract.md | 204 ++
.../string-functions/regexp-replace-one.md | 184 ++
.../string-functions/regexp-replace.md | 184 ++
.../scalar-functions/string-functions/regexp.md | 194 ++
.../scalar-functions/string-functions/repeat.md | 161 ++
.../string-functions/replace-empty.md | 99 +
.../scalar-functions/string-functions/replace.md | 154 ++
.../scalar-functions/string-functions/reverse.md | 156 ++
.../scalar-functions/string-functions/rpad.md | 163 ++
.../scalar-functions/string-functions/rtrim-in.md | 121 +
.../scalar-functions/string-functions/rtrim.md | 162 ++
.../scalar-functions/string-functions/soundex.md | 148 ++
.../scalar-functions/string-functions/space.md | 80 +
.../string-functions/split-by-regexp.md | 164 ++
.../string-functions/split-by-string.md | 161 ++
.../string-functions/split-part.md | 162 ++
.../string-functions/starts-with.md | 160 ++
.../scalar-functions/string-functions/strcmp.md | 70 +
.../scalar-functions/string-functions/strleft.md | 152 ++
.../scalar-functions/string-functions/strright.md | 153 ++
.../string-functions/sub-replace.md | 124 +
.../string-functions/substring-index.md | 150 ++
.../scalar-functions/string-functions/substring.md | 182 ++
.../scalar-functions/string-functions/to-base64.md | 147 ++
.../scalar-functions/string-functions/tokenize.md | 7 +
.../string-functions/top-level-domain.md | 68 +
.../scalar-functions/string-functions/translate.md | 162 ++
.../scalar-functions/string-functions/trim-in.md | 112 +
.../scalar-functions/string-functions/trim.md | 124 +
.../scalar-functions/string-functions/ucase.md | 135 +
.../string-functions/uncompress.md | 62 +
.../scalar-functions/string-functions/unhex.md | 156 ++
.../string-functions/url-decode.md | 41 +
.../string-functions/url-encode.md | 42 +
.../string-functions/uuid-to-int.md | 109 +
.../scalar-functions/string-functions/uuid.md | 55 +
.../string-functions/xpath-string.md | 146 ++
.../struct-functions/named-struct.md | 110 +
.../struct-functions/struct-element.md | 106 +
.../scalar-functions/struct-functions/struct.md | 97 +
.../system-functions/connection-id.md | 36 +
.../system-functions/current-catalog.md | 35 +
.../system-functions/current-user.md | 51 +
.../scalar-functions/system-functions/database.md | 44 +
.../system-functions/last-query-id.md | 34 +
.../system-functions/session-user.md | 35 +
.../scalar-functions/system-functions/user.md | 38 +
.../system-functions/version-function.md | 35 +
.../variant-functions/element-at.md | 111 +
.../variant-functions/variant-type.md | 59 +
.../table-functions/explode-bitmap-outer.md | 85 +
.../table-functions/explode-bitmap.md | 74 +
.../explode-json-array-double-outer.md | 99 +
.../table-functions/explode-json-array-double.md | 87 +
.../explode-json-array-int-outer.md | 82 +
.../table-functions/explode-json-array-int.md | 89 +
.../explode-json-array-json-outer.md | 82 +
.../table-functions/explode-json-array-json.md | 70 +
.../explode-json-array-string-outer.md | 83 +
.../table-functions/explode-json-array-string.md | 71 +
.../table-functions/explode-json-object-outer.md | 93 +
.../table-functions/explode-json-object.md | 82 +
.../table-functions/explode-map-outer.md | 82 +
.../sql-functions/table-functions/explode-map.md | 74 +
.../table-functions/explode-numbers-outer.md | 76 +
.../table-functions/explode-numbers.md | 75 +
.../sql-functions/table-functions/explode-outer.md | 99 +
.../table-functions/explode-split-outer.md | 110 +
.../sql-functions/table-functions/explode-split.md | 102 +
.../sql-functions/table-functions/explode.md | 91 +
.../table-functions/posexplode-outer.md | 94 +
.../sql-functions/table-functions/posexplode.md | 91 +
.../table-valued-functions/backends.md | 67 +
.../table-valued-functions/catalogs.md | 69 +
.../sql-functions/table-valued-functions/file.md | 106 +
.../table-valued-functions/frontends.md | 60 +
.../table-valued-functions/frontends_disks.md | 79 +
.../sql-functions/table-valued-functions/hdfs.md | 125 +
.../table-valued-functions/hudi-meta.md | 74 +
.../table-valued-functions/iceberg-meta.md | 69 +
.../sql-functions/table-valued-functions/jobs.md | 91 +
.../sql-functions/table-valued-functions/local.md | 147 ++
.../table-valued-functions/mv_infos.md | 68 +
.../table-valued-functions/numbers.md | 67 +
.../table-valued-functions/partition-values.md | 74 +
.../table-valued-functions/partitions.md | 98 +
.../sql-functions/table-valued-functions/query.md | 89 +
.../sql-functions/table-valued-functions/s3.md | 597 +++++
.../sql-functions/table-valued-functions/tasks.md | 102 +
.../sql-functions/window-functions/cume-dist.md | 68 +
.../sql-functions/window-functions/dense-rank.md | 43 +
.../sql-functions/window-functions/first-value.md | 74 +
.../sql-functions/window-functions/lag.md | 53 +
.../sql-functions/window-functions/last-value.md | 95 +
.../sql-functions/window-functions/lead.md | 58 +
.../sql-functions/window-functions/nth-value.md | 71 +
.../sql-functions/window-functions/ntile.md | 58 +
.../sql-functions/window-functions/overview.md | 152 ++
.../sql-functions/window-functions/percent-rank.md | 108 +
.../sql-functions/window-functions/rank.md | 52 +
.../sql-functions/window-functions/row-number.md | 44 +
.../account-management/ALTER-ROLE.md | 42 +
.../account-management/ALTER-USER.md | 114 +
.../account-management/CREATE-ROLE.md | 51 +
.../account-management/CREATE-USER.md | 135 +
.../sql-statements/account-management/DROP-ROLE.md | 43 +
.../sql-statements/account-management/DROP-USER.md | 39 +
.../sql-statements/account-management/GRANT-TO.md | 213 ++
.../account-management/REFRESH-LDAP.md | 63 +
.../account-management/REVOKE-FROM.md | 174 ++
.../account-management/SET-LDAP_ADMIN_PASSWORD.md | 37 +
.../account-management/SET-PASSWORD.md | 60 +
.../account-management/SET-PROPERTY.md | 118 +
.../account-management/SHOW-CREATE-USER.md | 47 +
.../account-management/SHOW-GRANTS.md | 103 +
.../account-management/SHOW-PRIVILEGES.md | 52 +
.../account-management/SHOW-PROPERTY.md | 125 +
.../account-management/SHOW-ROLES.md | 51 +
.../sql-statements/catalog/ALTER-CATALOG.md | 87 +
.../sql-statements/catalog/CREATE-CATALOG.md | 170 ++
.../sql-statements/catalog/DROP-CATALOG.md | 35 +
.../sql-manual/sql-statements/catalog/REFRESH.md | 67 +
.../sql-statements/catalog/SHOW-CATALOG.md | 59 +
.../sql-statements/catalog/SHOW-CATALOGS.md | 74 +
.../sql-statements/catalog/SHOW-CREATE-CATALOG.md | 51 +
.../sql-statements/character-set/SHOW-CHARSET.md | 40 +
.../sql-statements/character-set/SHOW-COLLATION.md | 50 +
.../compute-management/ALTER-RESOURCE.md | 56 +
.../compute-management/ALTER-WORKLOAD-GROUP.md | 44 +
.../compute-management/ALTER-WORKLOAD-POLICY.md | 38 +
.../compute-management/CREATE-RESOURCE.md | 227 ++
.../compute-management/CREATE-WORKLOAD-GROUP.md | 46 +
.../compute-management/CREATE-WORKLOAD-POLICY.md | 57 +
.../compute-management/DROP-RESOURCE.md | 28 +
.../compute-management/DROP-WORKLOAD-GROUP.md | 25 +
.../compute-management/DROP-WORKLOAD-POLICY.md | 32 +
.../compute-management/SHOW-COMPUTE-GROUPS.md | 47 +
.../compute-management/SHOW-RESOURCES.md | 59 +
.../compute-management/SHOW-WORKLOAD-GROUPS.md | 52 +
.../instance-management/ADD-BACKEND.md | 74 +
.../instance-management/ADD-BROKER.md | 49 +
.../instance-management/ADD-FOLLOWER.md | 49 +
.../instance-management/ADD-OBSERVER.md | 48 +
.../ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md | 43 +
.../CANCEL-DECOMMISSION-BACKEND.md | 71 +
.../instance-management/DECOMMISSION-BACKEND.md | 74 +
.../instance-management/DROP-BACKEND.md | 77 +
.../instance-management/DROP-BROKER.md | 55 +
.../instance-management/DROP-FOLLOWER.md | 49 +
.../instance-management/DROP-OBSERVER.md | 47 +
.../instance-management/MODIFY-BACKEND.md | 87 +
.../MODIFY-FRONTEND-HOSTNAME.md | 39 +
.../instance-management/SET-FRONTEND-CONFIG.md | 46 +
.../instance-management/SHOW-BACKEND-CONFIG.md | 95 +
.../instance-management/SHOW-BACKENDS.md | 76 +
.../instance-management/SHOW-BROKER.md | 45 +
.../instance-management/SHOW-CONFIG.md | 52 +
.../instance-management/SHOW-FRONTEND-CONFIG.md | 52 +
.../instance-management/SHOW-FRONTENDS-DISKS.md | 65 +
.../instance-management/SHOW-FRONTENDS.md | 70 +
.../storage-management/ALTER-STORAGE-POLICY.md | 48 +
.../storage-management/ALTER-STORAGE-VAULT.md | 66 +
.../storage-management/CANCEL-WARM-UP.md | 66 +
.../storage-management/CREATE-STORAGE-POLICY.md | 62 +
.../storage-management/CREATE-STORAGE-VAULT.md | 226 ++
.../storage-management/DROP-STORAGE-POLICY.md | 40 +
.../SET-DEFAULT-STORAGE-VAULT.md | 34 +
.../storage-management/SHOW-CACHE-HOTSPOT.md | 49 +
.../SHOW-STORAGE-POLICY-USING.md | 52 +
.../storage-management/SHOW-STORAGE-POLICY.md | 75 +
.../storage-management/SHOW-STORAGE-VAULTS.md | 36 +
.../storage-management/SHOW-WARM-UP-JOB.md | 41 +
.../UNSET-DEFAULT-STORAGE-VAULT.md | 28 +
.../storage-management/WARM-UP.md | 58 +
.../data-governance/ALTER-SQL_BLOCK_RULE.md | 48 +
.../data-governance/CREATE-ROW-POLICY.md | 65 +
.../data-governance/CREATE-SQL_BLOCK_RULE.md | 159 ++
.../data-governance/DROP-ROW-POLICY.md | 56 +
.../data-governance/DROP-SQL_BLOCK_RULE.md | 38 +
.../data-governance/SHOW-ROW-POLICY.md | 50 +
.../data-governance/SHOW-SQL_BLOCK_RULE.md | 58 +
.../sql-statements/data-modification/DML/DELETE.md | 181 ++
.../data-modification/DML/INSERT-OVERWRITE.md | 292 +++
.../sql-statements/data-modification/DML/INSERT.md | 210 ++
.../data-modification/DML/MERGE-INTO.md | 201 ++
.../data-modification/DML/SHOW-DELETE.md | 56 +
.../data-modification/DML/SHOW-LAST-INSERT.md | 52 +
.../sql-statements/data-modification/DML/UPDATE.md | 156 ++
.../data-modification/backup-and-restore/BACKUP.md | 109 +
.../backup-and-restore/CANCEL-BACKUP.md | 31 +
.../backup-and-restore/CANCEL-RESTORE.md | 35 +
.../backup-and-restore/CREATE-REPOSITORY.md | 147 ++
.../backup-and-restore/DROP-REPOSITORY.md | 37 +
.../backup-and-restore/RESTORE.md | 129 +
.../backup-and-restore/SHOW-BACKUP.md | 60 +
.../backup-and-restore/SHOW-CREATE-REPOSITORY.md | 28 +
.../backup-and-restore/SHOW-REPOSITORIES.md | 44 +
.../backup-and-restore/SHOW-RESTORE.md | 57 +
.../backup-and-restore/SHOW-SNAPSHOT.md | 61 +
.../load-and-export/ALTER-ROUTINE-LOAD.md | 105 +
.../load-and-export/BROKER-LOAD.md | 448 ++++
.../load-and-export/CANCEL-EXPORT.md | 77 +
.../load-and-export/CANCEL-LOAD.md | 80 +
.../load-and-export/CLEAN-LABEL.md | 53 +
.../load-and-export/CREATE-ROUTINE-LOAD.md | 601 +++++
.../load-and-export/CREATE-SYNC-JOB.md | 121 +
.../data-modification/load-and-export/EXPORT.md | 384 +++
.../load-and-export/MYSQL-LOAD.md | 175 ++
.../data-modification/load-and-export/OUTFILE.md | 394 +++
.../load-and-export/PAUSE-ROUTINE-LOAD.md | 55 +
.../load-and-export/PAUSE-SYNC-JOB.md | 37 +
.../load-and-export/RESUME-ROUTINE-LOAD.md | 56 +
.../load-and-export/RESUME-SYNC-JOB.md | 36 +
.../load-and-export/SHOW-CREATE-LOAD.md | 43 +
.../load-and-export/SHOW-CREATE-ROUTINE-LOAD.md | 47 +
.../load-and-export/SHOW-EXPORT.md | 98 +
.../load-and-export/SHOW-LOAD-WARNINGS.md | 57 +
.../data-modification/load-and-export/SHOW-LOAD.md | 113 +
.../load-and-export/SHOW-ROUTINE-LOAD-TASK.md | 60 +
.../load-and-export/SHOW-ROUTINE-LOAD.md | 122 +
.../load-and-export/SHOW-STREAM-LOAD.md | 76 +
.../load-and-export/SHOW-SYNC-JOB.md | 40 +
.../load-and-export/STOP-ROUTINE-LOAD.md | 54 +
.../load-and-export/STOP-SYNC-JOB.md | 35 +
.../data-modification/load-and-export/SYNC.md | 28 +
.../sql-statements/data-query/EXPLAIN.md | 401 +++
.../sql-manual/sql-statements/data-query/SELECT.md | 391 +++
.../sql-statements/database/ALTER-DATABASE.md | 94 +
.../sql-statements/database/CREATE-DATABASE.md | 86 +
.../sql-statements/database/DROP-DATABASE.md | 47 +
.../database/SHOW-CREATE-DATABASE.md | 71 +
.../sql-statements/database/SHOW-DATABASE-ID.md | 52 +
.../sql-statements/database/SHOW-DATABASES.md | 84 +
.../sql-statements/function/CREATE-FUNCTION.md | 126 +
.../sql-statements/function/DESC-FUNCTION.md | 42 +
.../sql-statements/function/DROP-FUNCTION.md | 65 +
.../function/SHOW-CREATE-FUNCTION.md | 77 +
.../sql-statements/function/SHOW-FUNCTIONS.md | 139 +
.../sql-manual/sql-statements/job/CANCEL-TASK.md | 38 +
.../sql-manual/sql-statements/job/CREATE-JOB.md | 147 ++
.../sql-manual/sql-statements/job/DROP-JOB.md | 37 +
.../sql-manual/sql-statements/job/PAUSE-JOB.md | 38 +
.../sql-manual/sql-statements/job/RESUME-JOB.md | 36 +
.../sql-statements/plugin/INSTALL-PLUGIN.md | 67 +
.../sql-statements/plugin/SHOW-PLUGINS.md | 55 +
.../sql-statements/plugin/UNINSTALL-PLUGIN.md | 41 +
.../recycle/DROP-CATALOG-RECYCLE-BIN.md | 66 +
.../sql-manual/sql-statements/recycle/RECOVER.md | 140 +
.../recycle/SHOW-CATALOG-RECYCLE-BIN.md | 68 +
.../sql-statements/security/CREATE-ENCRYPTKEY.md | 82 +
.../sql-statements/security/CREATE-FILE.md | 101 +
.../sql-statements/security/DROP-ENCRYPTKEY.md | 51 +
.../sql-statements/security/DROP-FILE.md | 68 +
.../sql-statements/security/SHOW-ENCRYPTKEY.md | 90 +
.../sql-statements/security/SHOW-FILE.md | 71 +
.../session/connection/KILL-CONNECTION.md | 50 +
.../session/context/SWITCH-CATALOG.md | 37 +
.../session/context/USE-COMPUTE-GROUP.md | 72 +
.../sql-statements/session/context/USE-DATABASE.md | 72 +
.../session/queries/CLEAN-ALL-PROFILE.md | 33 +
.../session/queries/CLEAN-ALL-QUERY-STATS.md | 68 +
.../sql-statements/session/queries/KILL-QUERY.md | 86 +
.../session/queries/PLAN-REPLAYER-DUMP.md | 78 +
.../session/queries/PLAN-REPLAYER-PLAY.md | 31 +
.../session/queries/SHOW-PROCESSLIST.md | 76 +
.../session/queries/SHOW-QUERY-STATS.md | 198 ++
.../session/variable/SET-VARIABLE.md | 67 +
.../session/variable/SHOW-VARIABLES.md | 76 +
.../session/variable/UNSET-VARIABLE.md | 63 +
.../sql-statements/statistics/ALTER-STATS.md | 87 +
.../sql-statements/statistics/ANALYZE.md | 73 +
.../sql-statements/statistics/DROP-ANALYZE-JOB.md | 36 +
.../sql-statements/statistics/DROP-STATS.md | 54 +
.../sql-statements/statistics/KILL-ANALYZE-JOB.md | 44 +
.../sql-statements/statistics/SHOW-ANALYZE.md | 103 +
.../sql-statements/statistics/SHOW-STATS.md | 94 +
.../sql-statements/statistics/SHOW-TABLE-STATS.md | 65 +
.../statistics/SHOW_QUEUED_ANALYZE_JOBS.md | 79 +
.../system-info-and-help/SHOW-PROC.md | 279 ++
.../ALTER-ASYNC-MATERIALIZED-VIEW.md | 78 +
.../CANCEL-MATERIALIZED-VIEW-TASK.md | 49 +
.../CREATE-ASYNC-MATERIALIZED-VIEW.md | 307 +++
.../DROP-ASYNC-MATERIALIZED-VIEW.md | 43 +
.../PAUSE-MATERIALIZED-VIEW-JOB.md | 50 +
.../REFRESH-MATERIALIZED-VIEW.md | 84 +
.../RESUME-MATERIALIZED-VIEW-JOB.md | 48 +
.../SHOW-CREATE-ASYNC-MATERIALIZED-VIEW.md | 45 +
.../ADMIN-CHECK-TABLET.md | 57 +
.../ADMIN-COPY-TABLET.md | 112 +
.../ADMIN-SET-REPLICA-STATUS.md | 71 +
.../ADMIN-SET-REPLICA-VERSION.md | 69 +
.../CANCEL-REBALANCE-DISK.md | 57 +
.../CANCEL-REPAIR-TABLE.md | 65 +
.../data-and-status-management/CLEAN-TRASH.md | 45 +
.../data-and-status-management/COMPACT-TABLE.md | 59 +
.../data-and-status-management/DIAGNOSE-TABLET.md | 96 +
.../data-and-status-management/REBALANCE-DISK.md | 58 +
.../data-and-status-management/REPAIR-TABLE.md | 75 +
.../SET-TABLE-PARTITION-VERSION.md | 38 +
.../data-and-status-management/SET-TABLE-STATUS.md | 90 +
.../data-and-status-management/SHOW-DATA-SKEW.md | 173 ++
.../data-and-status-management/SHOW-DATA.md | 161 ++
.../SHOW-REPLICA-DISTRIBUTION.md | 107 +
.../SHOW-REPLICA-STATUS.md | 137 +
.../SHOW-TABLET-DIAGNOSIS.md | 73 +
.../SHOW-TABLET-STORAGE-FORMAT.md | 73 +
.../data-and-status-management/SHOW-TABLET.md | 65 +
.../SHOW-TABLETS-BELONG.md | 75 +
.../data-and-status-management/SHOW-TRASH.md | 48 +
.../table-and-view/index/BUILD-INDEX.md | 89 +
.../table-and-view/index/CANCEL-BUILD-INDEX.md | 72 +
.../table-and-view/index/CREATE-INDEX.md | 93 +
.../table-and-view/index/DROP-INDEX.md | 43 +
.../table-and-view/index/SHOW-BUILD-INDEX.md | 105 +
.../table-and-view/index/SHOW-INDEX.md | 67 +
.../CREATE-MATERIALIZED-VIEW.md | 115 +
.../DROP-MATERIALIZED-VIEW.md | 44 +
.../SHOW-ALTER-TABLE-MATERIALIZED-VIEW.md | 38 +
.../SHOW-CREATE-MATERIALIZED-VIEW.md | 50 +
.../table-and-view/table/ALTER-COLOCATE-GROUP.md | 63 +
.../table/ALTER-TABLE-ADD-GENERATED-COLUMN.md | 46 +
.../table-and-view/table/ALTER-TABLE-COLUMN.md | 285 ++
.../table-and-view/table/ALTER-TABLE-COMMENT.md | 55 +
.../table-and-view/table/ALTER-TABLE-PARTITION.md | 162 ++
.../table-and-view/table/ALTER-TABLE-PROPERTY.md | 277 ++
.../table-and-view/table/ALTER-TABLE-RENAME.md | 91 +
.../table-and-view/table/ALTER-TABLE-REPLACE.md | 71 +
.../table-and-view/table/ALTER-TABLE-ROLLUP.md | 114 +
.../table-and-view/table/CANCEL-ALTER-TABLE.md | 96 +
.../table-and-view/table/CREATE-TABLE.md | 736 ++++++
.../table-and-view/table/DESC-TABLE.md | 132 +
.../table-and-view/table/DROP-TABLE.md | 79 +
.../table-and-view/table/SHOW-ALTER-TABLE.md | 74 +
.../table-and-view/table/SHOW-COLUMNS.md | 78 +
.../SHOW-CONVERT-LIGHT-SCHEMA-CHANGE-PROCESS.md | 47 +
.../table-and-view/table/SHOW-CREATE-TABLE.md | 67 +
.../table/SHOW-DYNAMIC-PARTITION-TABLES.md | 81 +
.../table-and-view/table/SHOW-PARTITION-ID.md | 42 +
.../table-and-view/table/SHOW-PARTITION.md | 44 +
.../table-and-view/table/SHOW-PARTITIONS.md | 140 +
.../table-and-view/table/SHOW-TABLE-ID.md | 55 +
.../table-and-view/table/SHOW-TABLE-STATUS.md | 90 +
.../table-and-view/table/SHOW-TABLES.md | 98 +
.../table-and-view/table/TRUNCATE-TABLE.md | 77 +
.../table-and-view/view/ALTER-VIEW.md | 69 +
.../table-and-view/view/CREATE-VIEW.md | 90 +
.../table-and-view/view/DROP-VIEW.md | 47 +
.../table-and-view/view/SHOW-CREATE-VIEW.md | 57 +
.../table-and-view/view/SHOW-VIEW.md | 30 +
.../sql-manual/sql-statements/transaction/BEGIN.md | 42 +
.../sql-statements/transaction/COMMIT.md | 43 +
.../sql-statements/transaction/ROLLBACK.md | 43 +
.../sql-statements/transaction/SHOW-TRANSACTION.md | 83 +
.../sql-statements/types/SHOW-DATA-TYPES.md | 69 +
.../sql-statements/types/SHOW-TYPECAST.md | 85 +
.../version-4.x/table-design/auto-increment.md | 467 ++++
.../version-4.x/table-design/best-practice.md | 525 ++++
.../version-4.x/table-design/column-compression.md | 92 +
.../table-design/data-model/aggregate.md | 172 ++
.../table-design/data-model/duplicate.md | 78 +
.../table-design/data-model/overview.md | 64 +
.../version-4.x/table-design/data-model/tips.md | 171 ++
.../version-4.x/table-design/data-model/unique.md | 122 +
.../data-partitioning/auto-partitioning.md | 289 ++
.../data-partitioning/basic-concepts.mdx | 367 +++
.../data-partitioning/common-issues.md | 44 +
.../data-partitioning/data-bucketing.md | 194 ++
.../data-partitioning/data-distribution.md | 104 +
.../data-partitioning/dynamic-partitioning.md | 214 ++
.../data-partitioning/manual-partitioning.md | 209 ++
.../version-4.x/table-design/data-type.md | 64 +
.../version-4.x/table-design/index/bitmap-index.md | 72 +
.../version-4.x/table-design/index/bloomfilter.md | 117 +
.../table-design/index/index-overview.md | 62 +
.../table-design/index/inverted-index/overview.md | 808 ++++++
.../table-design/index/ngram-bloomfilter-index.md | 226 ++
.../version-4.x/table-design/index/prefix-index.md | 89 +
.../version-4.x/table-design/overview.md | 38 +
.../version-4.x/table-design/row-store.md | 107 +
.../version-4.x/table-design/schema-change.md | 322 +++
.../version-4.x/table-design/temporary-table.md | 43 +
.../table-design/tiered-storage/overview.md | 16 +
.../table-design/tiered-storage/remote-storage.md | 221 ++
.../table-design/tiered-storage/tiered-ssd-hdd.md | 98 +
.../aws-authentication-and-authorization.md | 513 ----
.../data-admin/backup-restore/backup.md | 246 --
.../version-4.0/ai/search/text-search.md | 270 --
.../version-4.0/ai/search/vector-search.md | 382 ---
.../data-operate/export/export-best-practice.md | 91 -
.../version-4.0/ecosystem/doris-kafka-connector.md | 590 -----
versioned_docs/version-4.0/faq/lakehouse-faq.md | 331 ---
.../lakehouse/best-practices/doris-lakesoul.md | 322 ---
.../lakehouse/best-practices/doris-maxcompute.md | 96 -
.../version-4.0/lakehouse/catalog-overview.md | 267 --
.../lakehouse/catalogs/hive-catalog.mdx | 1052 --------
.../lakehouse/catalogs/iceberg-catalog.mdx | 1966 --------------
.../lakehouse/catalogs/lakesoul-catalog.md | 103 -
.../lakehouse/catalogs/maxcompute-catalog.md | 183 --
.../lakehouse/catalogs/paimon-catalog.mdx | 1130 --------
.../version-4.0/lakehouse/storages/azure-blob.md | 9 -
.../tuning/tuning-execution/parallelism-tuning.md | 119 -
.../version-4.0/releasenotes/v3.1/release-3.1.0.md | 679 -----
.../encrypt-digest-functions/murmur-hash3-64.md | 45 -
.../encrypt-digest-functions/xxhash-64.md | 68 -
.../scalar-functions/json-functions/json-object.md | 153 --
.../scalar-functions/json-functions/json-remove.md | 70 -
.../append-trailing-char-if-absent.md | 41 -
.../scalar-functions/string-functions/ascii.md | 40 -
.../string-functions/auto-partition-name.md | 100 -
.../string-functions/char-length.md | 46 -
.../scalar-functions/string-functions/char.md | 57 -
.../scalar-functions/string-functions/compress.md | 54 -
.../scalar-functions/string-functions/concat-ws.md | 171 --
.../scalar-functions/string-functions/concat.md | 44 -
.../string-functions/count_substrings.md | 121 -
.../string-functions/digital-masking.md | 40 -
.../scalar-functions/string-functions/elt.md | 45 -
.../scalar-functions/string-functions/ends-with.md | 45 -
.../string-functions/find-in-set.md | 48 -
.../string-functions/format-number.md | 64 -
.../scalar-functions/string-functions/format.md | 65 -
.../string-functions/from-base64.md | 44 -
.../scalar-functions/string-functions/hex.md | 57 -
.../scalar-functions/string-functions/initcap.md | 40 -
.../scalar-functions/string-functions/instr.md | 45 -
.../string-functions/int-to-uuid.md | 40 -
.../scalar-functions/string-functions/lcase.md | 57 -
.../scalar-functions/string-functions/length.md | 40 -
.../scalar-functions/string-functions/locate.md | 42 -
.../scalar-functions/string-functions/lpad.md | 52 -
.../scalar-functions/string-functions/ltrim.md | 55 -
.../scalar-functions/string-functions/make-set.md | 100 -
.../string-functions/mask-first-n.md | 69 -
.../string-functions/mask-last-n.md | 69 -
.../scalar-functions/string-functions/mask.md | 83 -
.../string-functions/multi-search-all-positions.md | 35 -
.../string-functions/ngram-search.md | 48 -
.../scalar-functions/string-functions/overlay.md | 83 -
.../string-functions/parse-data-size.md | 80 -
.../scalar-functions/string-functions/position.md | 49 -
.../scalar-functions/string-functions/quote.md | 28 -
.../string-functions/random_bytes.md | 50 -
.../scalar-functions/string-functions/repeat.md | 55 -
.../string-functions/replace-empty.md | 76 -
.../scalar-functions/string-functions/replace.md | 44 -
.../scalar-functions/string-functions/reverse.md | 54 -
.../scalar-functions/string-functions/rpad.md | 71 -
.../scalar-functions/string-functions/rtrim-in.md | 71 -
.../scalar-functions/string-functions/rtrim.md | 56 -
.../scalar-functions/string-functions/soundex.md | 102 -
.../scalar-functions/string-functions/space.md | 55 -
.../string-functions/split-by-regexp.md | 56 -
.../string-functions/split-by-string.md | 56 -
.../string-functions/split-part.md | 57 -
.../string-functions/starts-with.md | 55 -
.../scalar-functions/string-functions/strcmp.md | 70 -
.../scalar-functions/string-functions/strleft.md | 85 -
.../scalar-functions/string-functions/strright.md | 85 -
.../string-functions/sub-replace.md | 55 -
.../string-functions/substring-index.md | 83 -
.../scalar-functions/string-functions/substring.md | 140 -
.../scalar-functions/string-functions/to-base64.md | 55 -
.../scalar-functions/string-functions/translate.md | 96 -
.../scalar-functions/string-functions/trim-in.md | 73 -
.../scalar-functions/string-functions/trim.md | 60 -
.../scalar-functions/string-functions/ucase.md | 50 -
.../string-functions/uncompress.md | 62 -
.../scalar-functions/string-functions/unhex.md | 83 -
.../scalar-functions/string-functions/uuid.md | 33 -
.../string-functions/xpath-string.md | 95 -
.../index/inverted-index/custom-analyzer.md | 183 --
.../table-design/index/inverted-index/scoring.md | 107 -
.../index/inverted-index/search-function.md | 220 --
.../admin-manual/audit-plugin.md | 0
.../auth/authentication-and-authorization.md | 0
.../admin-manual/auth/authentication/federation.md | 0
.../admin-manual/auth/authentication/internal.md | 0
.../admin-manual/auth/authorization/data.md | 0
.../admin-manual/auth/authorization/internal.md | 0
.../admin-manual/auth/authorization/ranger.md | 0
.../admin-manual/auth/certificate.md | 0
.../admin-manual/auth/encryption-function.md | 0
.../admin-manual/auth/fe-certificate.md | 0
.../aws-authentication-and-authorization.md | 596 +++++
.../admin-manual/auth/integrations/aws-iam-role.md | 0
.../admin-manual/auth/ldap.md | 0
.../admin-manual/auth/ranger.md | 0
.../admin-manual/auth/security-overview.md | 0
.../admin-manual/auth/user-privilege.md | 0
.../cluster-management/elastic-expansion.md | 0
.../admin-manual/cluster-management/fqdn.md | 0
.../cluster-management/load-balancing.md | 0
.../admin-manual/cluster-management/time-zone.md | 0
.../admin-manual/cluster-management/upgrade.md | 0
.../admin-manual/config/be-config.md | 0
.../admin-manual/config/config-dir.md | 0
.../admin-manual/config/fe-config-template.md | 0
.../admin-manual/config/fe-config.md | 0
.../admin-manual/config/user-property.md | 0
.../data-admin/backup-restore/backup.md | 244 ++
.../data-admin/backup-restore/overview.md | 0
.../data-admin/backup-restore/restore.md | 0
.../admin-manual/data-admin/ccr/config.md | 0
.../admin-manual/data-admin/ccr/feature.md | 0
.../admin-manual/data-admin/ccr/manual.md | 0
.../admin-manual/data-admin/ccr/overview.md | 0
.../admin-manual/data-admin/ccr/performance.md | 0
.../admin-manual/data-admin/ccr/quickstart.md | 0
.../admin-manual/data-admin/overview.md | 0
.../admin-manual/data-admin/recyclebin.md | 0
.../admin-manual/log-management/be-log.md | 0
.../admin-manual/log-management/fe-log.md | 0
.../maint-monitor/automatic-service-start.md | 0
.../admin-manual/maint-monitor/disk-capacity.md | 0
.../admin-manual/maint-monitor/metrics.md | 0
.../admin-manual/maint-monitor/monitor-alert.md | 0
.../maint-monitor/tablet-repair-and-balance.md | 0
.../admin-manual/open-api/be-http/be-vlog.md | 0
.../open-api/be-http/check-rpc-channel.md | 0
.../open-api/be-http/check-tablet-segment.md | 0
.../admin-manual/open-api/be-http/checksum.md | 0
.../open-api/be-http/compaction-run.md | 0
.../open-api/be-http/compaction-status.md | 0
.../admin-manual/open-api/be-http/config.md | 0
.../admin-manual/open-api/be-http/download.md | 0
.../admin-manual/open-api/be-http/health.md | 0
.../admin-manual/open-api/be-http/meta.md | 0
.../admin-manual/open-api/be-http/metrics.md | 0
.../admin-manual/open-api/be-http/pad-rowset.md | 0
.../open-api/be-http/reset-rpc-channel.md | 0
.../admin-manual/open-api/be-http/snapshot.md | 0
.../open-api/be-http/tablet-distribution.md | 0
.../admin-manual/open-api/be-http/tablet-info.md | 0
.../open-api/be-http/tablet-migration.md | 0
.../admin-manual/open-api/be-http/tablet-reload.md | 0
.../open-api/be-http/tablet-restore.md | 0
.../admin-manual/open-api/be-http/version-info.md | 0
.../open-api/fe-http/backends-action.md | 0
.../open-api/fe-http/bootstrap-action.md | 0
.../open-api/fe-http/cancel-load-action.md | 0
.../open-api/fe-http/check-decommission-action.md | 0
.../open-api/fe-http/check-storage-type-action.md | 0
.../open-api/fe-http/cluster-action.md | 0
.../open-api/fe-http/colocate-meta-action.md | 0
.../admin-manual/open-api/fe-http/config-action.md | 0
.../open-api/fe-http/connection-action.md | 0
.../open-api/fe-http/debug-point-action.md | 0
.../open-api/fe-http/extra-basepath-action.md | 0
.../open-api/fe-http/fe-version-info-action.md | 0
.../open-api/fe-http/get-ddl-stmt-action.md | 0
.../open-api/fe-http/get-load-info-action.md | 0
.../open-api/fe-http/get-load-state.md | 0
.../open-api/fe-http/get-log-file-action.md | 0
.../open-api/fe-http/get-small-file.md | 0
.../open-api/fe-http/get-wal-size-action.md | 0
.../admin-manual/open-api/fe-http/ha-action.md | 0
.../open-api/fe-http/hardware-info-action.md | 0
.../admin-manual/open-api/fe-http/health-action.md | 0
.../admin-manual/open-api/fe-http/help-action.md | 0
.../admin-manual/open-api/fe-http/import-action.md | 0
.../admin-manual/open-api/fe-http/log-action.md | 0
.../admin-manual/open-api/fe-http/login-action.md | 0
.../admin-manual/open-api/fe-http/logout-action.md | 0
.../admin-manual/open-api/fe-http/meta-action.md | 0
.../open-api/fe-http/meta-info-action-V2.md | 0
.../open-api/fe-http/meta-info-action.md | 0
.../open-api/fe-http/meta-replay-state-action.md | 0
.../open-api/fe-http/metrics-action.md | 0
.../admin-manual/open-api/fe-http/node-action.md | 0
.../open-api/fe-http/profile-action.md | 0
.../open-api/fe-http/query-detail-action.md | 0
.../fe-http/query-profile-action-controller.md | 0
.../open-api/fe-http/query-profile-action.md | 0
.../open-api/fe-http/query-schema-action.md | 0
.../open-api/fe-http/query-stats-action.md | 0
.../open-api/fe-http/row-count-action.md | 0
.../open-api/fe-http/session-action.md | 0
.../open-api/fe-http/set-config-action.md | 0
.../open-api/fe-http/show-data-action.md | 0
.../open-api/fe-http/show-meta-info-action.md | 0
.../open-api/fe-http/show-proc-action.md | 0
.../open-api/fe-http/show-runtime-info-action.md | 0
.../open-api/fe-http/show-table-data-action.md | 0
.../open-api/fe-http/statement-execution-action.md | 0
.../open-api/fe-http/statistic-action.md | 0
.../admin-manual/open-api/fe-http/system-action.md | 0
.../open-api/fe-http/table-query-plan-action.md | 0
.../open-api/fe-http/table-row-count-action.md | 0
.../open-api/fe-http/table-schema-action.md | 0
.../admin-manual/open-api/fe-http/upload-action.md | 0
.../admin-manual/open-api/overview.md | 0
.../admin-manual/plugin-development-manual.md | 0
.../admin-manual/small-file-mgr.md | 0
.../information_schema/active_queries.md | 0
.../information_schema/backend_active_tasks.md | 0
.../information_schema/backend_configuration.md | 0
.../information_schema/backend_tablets.md | 0
.../catalog_meta_cache_statistics.md | 0
.../information_schema/character_sets.md | 0
.../system-tables/information_schema/collations.md | 0
.../information_schema/column_privileges.md | 0
.../information_schema/column_statistics.md | 0
.../system-tables/information_schema/columns.md | 0
.../system-tables/information_schema/engines.md | 0
.../system-tables/information_schema/events.md | 0
.../information_schema/file_cache_statistics.md | 0
.../system-tables/information_schema/files.md | 0
.../information_schema/global_variables.md | 0
.../information_schema/key_column_usage.md | 0
.../information_schema/metadata_name_ids.md | 0
.../system-tables/information_schema/parameters.md | 0
.../system-tables/information_schema/partitions.md | 0
.../information_schema/processlist.md | 0
.../system-tables/information_schema/profiling.md | 0
.../information_schema/referential_constraints.md | 0
.../information_schema/routine_load_job.md | 0
.../system-tables/information_schema/routines.md | 0
.../system-tables/information_schema/rowsets.md | 0
.../information_schema/schema_privileges.md | 0
.../system-tables/information_schema/schemata.md | 0
.../information_schema/session_variables.md | 0
.../system-tables/information_schema/statistics.md | 0
.../information_schema/table_constraints.md | 0
.../information_schema/table_options.md | 0
.../information_schema/table_privileges.md | 0
.../information_schema/table_properties.md | 0
.../system-tables/information_schema/tables.md | 0
.../system-tables/information_schema/triggers.md | 0
.../information_schema/user_privileges.md | 0
.../system-tables/information_schema/views.md | 0
.../workload_group_privileges.md | 0
.../workload_group_resource_usage.md | 0
.../information_schema/workload_groups.md | 0
.../information_schema/workload_policy.md | 0
.../system-tables/internal_schema/audit_log.md | 0
.../internal_schema/column_statistics.md | 0
.../internal_schema/partition_statistics.md | 0
.../admin-manual/system-tables/mysql/props_priv.md | 0
.../admin-manual/system-tables/mysql/user.md | 0
.../admin-manual/system-tables/overview.md | 0
.../trouble-shooting/compaction-principles.md | 0
.../admin-manual/trouble-shooting/compaction.md | 0
.../trouble-shooting/frontend-lock-manager.md | 0
.../memory-analysis/doris-cache-memory-analysis.md | 0
.../memory-analysis/global-memory-analysis.md | 0
.../heap-profile-memory-analysis.md | 0
.../memory-analysis/jemalloc-memory-analysis.md | 0
.../memory-analysis/load-memory-analysis.md | 0
.../memory-analysis/memory-log-analysis.md | 0
.../memory-analysis/metadata-memory-analysis.md | 0
.../memory-analysis/oom-crash-analysis.md | 0
...uery-cancelled-after-process-memory-exceeded.md | 0
.../query-cancelled-after-query-memory-exceeded.md | 0
.../memory-analysis/query-memory-analysis.md | 0
.../memory-feature/memory-control-strategy.md | 0
.../memory-feature/memory-tracker.md | 0
.../memory-management/memory-issue-faq.md | 0
.../trouble-shooting/memory-management/overview.md | 0
.../trouble-shooting/metadata-operation.md | 0
.../trouble-shooting/repairing-data.md | 0
.../trouble-shooting/tablet-local-debug.md | 0
.../trouble-shooting/tablet-meta-tool.md | 0
.../workload-management/analysis-diagnosis.md | 0
.../workload-management/compute-group.md | 0
.../concurrency-control-and-queuing.md | 0
.../workload-management/job-scheduler.md | 0
.../admin-manual/workload-management/kill-query.md | 0
.../workload-management/resource-group.md | 0
.../admin-manual/workload-management/spill-disk.md | 0
.../workload-management/sql-blocking.md | 0
.../workload-group-bind-compute-group.md | 0
.../workload-management/workload-group.md | 0
.../workload-management-summary.md | 0
.../ai/ai-function-overview.md | 0
.../version-4.x/ai/text-search/custom-analyzer.md | 183 ++
.../version-4.x/ai/text-search/overview.md | 271 ++
.../version-4.x/ai/text-search/scoring.md | 106 +
.../version-4.x/ai/text-search/search-function.md | 264 ++
.../ai/text-search}/search-operators.md | 0
versioned_docs/version-4.x/ai/vector-search.md | 409 +++
.../{version-4.0 => version-4.x}/benchmark/ssb.md | 0
.../benchmark/tpcds.md | 0
.../{version-4.0 => version-4.x}/benchmark/tpch.md | 0
.../compute-storage-decoupled/before-deployment.md | 0
.../compilation-and-deployment.md | 0
.../file-cache/file-cache-internals.md | 0
.../file-cache/file-cache.md | 0
.../managing-compute-cluster.md | 0
.../managing-storage-vault.md | 0
.../compute-storage-decoupled/overview.md | 0
.../compute-storage-decoupled/recycler.md | 0
.../file-cache-rw-compute-group-best-practice.md | 0
.../rw/read-write-separation.md | 0
.../compute-storage-decoupled/upgrade.md | 0
.../data-operate/delete/atomicity-replace.md | 0
.../data-operate/delete/batch-delete-manual.md | 0
.../data-operate/delete/delete-manual.md | 0
.../data-operate/delete/delete-overview.md | 0
.../data-operate/delete/table-temp-partition.md | 0
.../data-operate/delete/truncate-manual.md | 0
.../data-operate/export/export-best-practice.md | 95 +
.../data-operate/export/export-manual.md | 0
.../data-operate/export/export-overview.md | 0
.../data-operate/export/export-with-mysql-dump.md | 0
.../data-operate/export/outfile.md | 0
.../data-operate/import/cdc-load-manual-sample.md | 0
.../data-operate/import/complex-types/array.md | 0
.../data-operate/import/complex-types/bitmap.md | 0
.../data-operate/import/complex-types/hll.md | 0
.../data-operate/import/complex-types/json.md | 0
.../data-operate/import/complex-types/map.md | 0
.../data-operate/import/complex-types/struct.md | 0
.../data-operate/import/complex-types/variant.md | 0
.../data-operate/import/data-source/aliyun-oss.md | 0
.../data-operate/import/data-source/amazon-s3.md | 0
.../import/data-source/azure-storage.md | 0
.../data-operate/import/data-source/bigquery.md | 0
.../data-operate/import/data-source/flink.md | 0
.../import/data-source/google-cloud-storage.md | 0
.../data-operate/import/data-source/hdfs.md | 0
.../data-operate/import/data-source/huawei-obs.md | 0
.../data-operate/import/data-source/kafka.md | 0
.../data-operate/import/data-source/local-file.md | 0
.../data-source/migrate-data-from-other-olap.md | 0
.../data-source/migrate-data-from-other-oltp.md | 0
.../data-operate/import/data-source/minio.md | 0
.../data-operate/import/data-source/redshift.md | 0
.../import/data-source/s3-compatible.md | 0
.../data-operate/import/data-source/snowflake.md | 0
.../data-operate/import/data-source/tencent-cos.md | 0
.../data-operate/import/file-format/csv.md | 0
.../data-operate/import/file-format/json.md | 0
.../data-operate/import/file-format/orc.md | 0
.../data-operate/import/file-format/parquet.md | 0
.../data-operate/import/group-commit-manual.md | 0
.../data-operate/import/handling-messy-data.md | 0
.../import/import-way/broker-load-manual.md | 0
.../import/import-way/insert-into-manual.md | 0
.../import/import-way/insert-into-values-manual.md | 0
.../import/import-way/mysql-load-manual.md | 0
.../import/import-way/routine-load-manual.md | 0
.../import/import-way/stream-load-manual.md | 0
.../data-operate/import/load-best-practices.md | 0
.../data-operate/import/load-data-convert.md | 0
.../data-operate/import/load-high-availability.md | 0
.../import/load-internals/load-internals.md | 0
.../load-internals/routine-load-internals.md | 0
.../data-operate/import/load-manual.md | 0
.../data-operate/scheduler/job-scheduler.md | 0
.../data-operate/transaction.md | 0
.../update/unique-update-concurrent-control.md | 0
.../data-operate/update/unique-update.md | 0
.../update/update-of-aggregate-model.md | 0
.../data-operate/update/update-of-unique-model.md | 0
.../data-operate/update/update-overview.md | 0
.../db-connect/arrow-flight-sql-connect.md | 0
.../db-connect/database-connect.md | 0
.../ecosystem/automq-load.md | 0
.../ecosystem/bi/apache-superset.md | 0
.../ecosystem/bi/clouddm.md | 0
.../ecosystem/bi/datagrip.md | 0
.../ecosystem/bi/dbeaver.md | 0
.../ecosystem/bi/finebi.md | 0
.../ecosystem/bi/powerbi.md | 0
.../ecosystem/bi/quickbi.md | 0
.../ecosystem/bi/quicksight.md | 0
.../ecosystem/bi/smartbi.md | 0
.../ecosystem/bi/tableau.md | 0
.../ecosystem/cloudcanal.md | 0
.../ecosystem/datax.md | 0
.../ecosystem/dbt-doris-adapter.md | 0
.../version-4.x/ecosystem/doris-kafka-connector.md | 590 +++++
.../doris-operator/doris-operator-overview.md | 0
.../ecosystem/doris-operator/on-alibaba.md | 0
.../ecosystem/doris-operator/on-aws.md | 0
.../ecosystem/doris-streamloader.md | 0
.../ecosystem/ecosystem-overview.md | 0
.../ecosystem/flink-doris-connector.md | 0
.../ecosystem/hive-bitmap-udf.md | 0
.../ecosystem/hive-hll-udf.md | 0
.../ecosystem/kettle.md | 0
.../ecosystem/kyuubi.md | 0
.../ecosystem/observability/beats.md | 0
.../ecosystem/observability/fluentbit.md | 0
.../ecosystem/observability/logstash.md | 0
.../ecosystem/observability/opentelemetry.md | 0
.../ecosystem/seatunnel.md | 0
.../ecosystem/spark-doris-connector.md | 0
.../ecosystem/spark-load.md | 0
.../{version-4.0 => version-4.x}/faq/bi-faq.md | 0
.../faq/correctness-faq.md | 0
.../{version-4.0 => version-4.x}/faq/data-faq.md | 0
.../faq/install-faq.md | 0
versioned_docs/version-4.x/faq/lakehouse-faq.md | 340 +++
.../{version-4.0 => version-4.x}/faq/load-faq.md | 0
.../{version-4.0 => version-4.x}/faq/sql-faq.md | 0
.../alternatives/alternative-to-clickhouse.mdx | 0
.../alternatives/alternative-to-elasticsearch.mdx | 0
.../alternatives/alternative-to-trino.mdx | 0
.../alternatives/demo-block/demo-block.css | 0
.../alternatives/demo-block/latest.tsx | 0
.../alternatives/demo-block/page-hero-1.tsx | 0
.../alternatives/demo-block/page-hero-2.tsx | 0
.../alternatives/demo-block/page-hero.tsx | 0
.../gettingStarted/quick-start.mdx | 0
.../gettingStarted/what-is-apache-doris.md | 0
.../integrated-storage-compute-deploy-manually.md | 0
.../separating-storage-compute-deploy-manually.md | 0
.../install/deploy-on-cloud/doris-on-aws.md | 0
.../integrated-storage-compute/access-cluster.md | 0
.../cluster-operation.md | 0
.../helm-chart-deploy.md | 0
.../install-config-cluster.md | 0
.../install-doris-cluster.md | 0
.../install-doris-operator.md | 0
.../separating-storage-compute/config-cg.md | 0
.../separating-storage-compute/config-cluster.md | 0
.../separating-storage-compute/config-fe.md | 0
.../separating-storage-compute/config-ms.md | 0
.../install-doris-cluster.md | 0
.../separating-storage-compute/install-fdb.md | 0
.../install/preparation/cluster-planning.md | 0
.../install/preparation/env-checking.md | 0
.../install/preparation/os-checking.md | 0
.../lakehouse/best-practices/doris-aws-s3tables.md | 0
.../lakehouse/best-practices/doris-dlf-paimon.md | 0
.../lakehouse/best-practices/doris-hudi.md | 0
.../lakehouse/best-practices/doris-iceberg.md | 0
.../lakehouse/best-practices/doris-maxcompute.md | 109 +
.../lakehouse/best-practices/doris-paimon.md | 0
.../lakehouse/best-practices/optimization.md | 70 +
.../lakehouse/best-practices/tpcds.md | 0
.../lakehouse/best-practices/tpch.md | 0
.../version-4.x/lakehouse/catalog-overview.md | 267 ++
.../lakehouse/catalogs/bigquery-catalog.md | 0
.../lakehouse/catalogs/delta-lake-catalog.md | 0
.../lakehouse/catalogs/es-catalog.md | 0
.../lakehouse/catalogs/hive-catalog.mdx | 1074 ++++++++
.../lakehouse/catalogs/hudi-catalog.md | 0
.../lakehouse/catalogs/iceberg-catalog.mdx | 1981 ++++++++++++++
.../lakehouse/catalogs/jdbc-catalog-overview.md | 0
.../lakehouse/catalogs/jdbc-clickhouse-catalog.md | 0
.../lakehouse/catalogs/jdbc-ibmdb2-catalog.md | 0
.../lakehouse/catalogs/jdbc-mysql-catalog.md | 0
.../lakehouse/catalogs/jdbc-oceanbase-catalog.md | 0
.../lakehouse/catalogs/jdbc-oracle-catalog.md | 0
.../lakehouse/catalogs/jdbc-pg-catalog.md | 0
.../lakehouse/catalogs/jdbc-saphana-catalog.md | 0
.../lakehouse/catalogs/jdbc-sqlserver-catalog.md | 0
.../lakehouse/catalogs/kudu-catalog.md | 0
.../lakehouse/catalogs/maxcompute-catalog.md | 218 ++
.../lakehouse/catalogs/paimon-catalog.mdx | 1155 ++++++++
.../lakehouse/compute-node.md | 0
.../lakehouse/data-cache.md | 0
.../lakehouse/file-analysis.md | 0
.../lakehouse/file-formats/orc.md | 0
.../lakehouse/file-formats/parquet.md | 0
.../lakehouse/file-formats/text.md | 0
.../lakehouse/lakehouse-overview.md | 0
.../lakehouse/meta-cache.md | 0
.../lakehouse/metastores/aliyun-dlf.md | 0
.../lakehouse/metastores/aws-glue.md | 0
.../lakehouse/metastores/filesystem.md | 0
.../metastores/google-dataproc-metastore.md | 0
.../lakehouse/metastores/hive-metastore.md | 0
.../lakehouse/metastores/iceberg-rest.md | 0
.../lakehouse/sql-convertor/clickhouse-guide.md | 0
.../lakehouse/sql-convertor/hive-guide.md | 0
.../lakehouse/sql-convertor/pg-guide.md | 0
.../lakehouse/sql-convertor/presto-trino-guide.md | 0
.../sql-convertor/sql-convertor-overview.md | 0
.../lakehouse/statistics.md | 0
.../lakehouse/storages/aliyun-oss.md | 0
.../version-4.x/lakehouse/storages/azure-blob.md | 51 +
.../lakehouse/storages/baidu-bos.md | 0
.../lakehouse/storages/gcs.md | 0
.../lakehouse/storages/hdfs.md | 0
.../lakehouse/storages/huawei-obs.md | 0
.../lakehouse/storages/minio.md | 0
.../lakehouse/storages/s3.md | 0
.../lakehouse/storages/tencent-cos.md | 0
.../log-storage-analysis.md | 0
.../observability/log.md | 0
.../observability/overview.mdx | 0
.../observability/trace.md | 0
.../query-acceleration/colocation-join.md | 0
.../query-acceleration/condition-cache.md | 0
.../query-acceleration/dictionary.md | 0
.../bitmap-precise-deduplication.md | 0
.../hll-approximate-deduplication.md | 0
.../high-concurrent-point-query.md | 0
.../query-acceleration/hints/distribute-hint.md | 0
.../query-acceleration/hints/hints-overview.md | 0
.../query-acceleration/hints/leading-hint.md | 0
.../async-materialized-view/faq.md | 0
.../functions-and-demands.md | 0
.../async-materialized-view/overview.md | 0
.../async-materialized-view/use-advice.md | 0
.../async-materialized-view/use-guide.md | 0
.../materialized-view/overview.md | 0
.../materialized-view/sync-materialized-view.md | 0
.../pipeline-execution-engine.md | 0
.../query-optimizer.md | 0
.../runtime-filter.md | 0
.../statistics.md | 0
.../topn-optimization.md | 0
.../performance-tuning-overview/analysis-tools.md | 0
.../diagnostic-tools.md | 0
.../performance-tuning-overview/tuning-overview.md | 0
.../performance-tuning-overview/tuning-process.md | 0
.../query-acceleration/sql-cache-manual.md | 0
.../adjustment-of-runtimefilter-wait-time.md | 0
.../tuning/tuning-execution/data-skew-handling.md | 0
.../tuning/tuning-execution/parallelism-tuning.md | 135 +
.../query-acceleration/tuning/tuning-parameters.md | 0
.../accelerating-queries-with-sql-cache.md | 0
.../tuning/tuning-plan/adjusting-join-shuffle.md | 0
.../tuning-plan/controlling-hints-with-cbo-rule.md | 0
.../tuning/tuning-plan/dml-tuning-plan.md | 0
.../optimizing-join-with-colocate-group.md | 0
.../tuning/tuning-plan/optimizing-table-index.md | 0
.../tuning-plan/optimizing-table-scanning.md | 0
.../tuning/tuning-plan/optimizing-table-schema.md | 0
.../reordering-join-with-leading-hint.md | 0
.../transparent-rewriting-with-async-mv.md | 0
.../transparent-rewriting-with-sync-mv.md | 0
.../query-data/complex-type.md | 0
.../{version-4.0 => version-4.x}/query-data/cte.md | 0
.../query-data/join.md | 0
.../query-data/lateral-view.md | 0
.../query-data/multi-dimensional-analytics.md | 0
.../query-data/mysql-compatibility.md | 0
.../query-data/subquery.md | 0
.../query-data/udf/alias-function.md | 0
.../query-data/udf/java-user-defined-function.md | 0
.../query-data/window-function.md | 0
.../releasenotes/all-release.md | 0
.../releasenotes/v1.1/release-1.1.0.md | 0
.../releasenotes/v1.1/release-1.1.1.md | 0
.../releasenotes/v1.1/release-1.1.2.md | 0
.../releasenotes/v1.1/release-1.1.3.md | 0
.../releasenotes/v1.1/release-1.1.4.md | 0
.../releasenotes/v1.1/release-1.1.5.md | 0
.../releasenotes/v1.2/release-1.2.0.md | 0
.../releasenotes/v1.2/release-1.2.1.md | 0
.../releasenotes/v1.2/release-1.2.2.md | 0
.../releasenotes/v1.2/release-1.2.3.md | 0
.../releasenotes/v1.2/release-1.2.4.md | 0
.../releasenotes/v1.2/release-1.2.5.md | 0
.../releasenotes/v1.2/release-1.2.6.md | 0
.../releasenotes/v1.2/release-1.2.7.md | 0
.../releasenotes/v1.2/release-1.2.8.md | 0
.../releasenotes/v2.0/release-2.0.0.md | 0
.../releasenotes/v2.0/release-2.0.1.md | 0
.../releasenotes/v2.0/release-2.0.10.md | 0
.../releasenotes/v2.0/release-2.0.11.md | 0
.../releasenotes/v2.0/release-2.0.12.md | 0
.../releasenotes/v2.0/release-2.0.13.md | 0
.../releasenotes/v2.0/release-2.0.14.md | 0
.../releasenotes/v2.0/release-2.0.15.md | 0
.../releasenotes/v2.0/release-2.0.2.md | 0
.../releasenotes/v2.0/release-2.0.3.md | 0
.../releasenotes/v2.0/release-2.0.4.md | 0
.../releasenotes/v2.0/release-2.0.5.md | 0
.../releasenotes/v2.0/release-2.0.6.md | 0
.../releasenotes/v2.0/release-2.0.7.md | 0
.../releasenotes/v2.0/release-2.0.8.md | 0
.../releasenotes/v2.0/release-2.0.9.md | 0
.../releasenotes/v2.1/release-2.1.0.md | 0
.../releasenotes/v2.1/release-2.1.1.md | 0
.../releasenotes/v2.1/release-2.1.10.md | 0
.../releasenotes/v2.1/release-2.1.11.md | 0
.../releasenotes/v2.1/release-2.1.2.md | 0
.../releasenotes/v2.1/release-2.1.3.md | 0
.../releasenotes/v2.1/release-2.1.4.md | 0
.../releasenotes/v2.1/release-2.1.5.md | 0
.../releasenotes/v2.1/release-2.1.6.md | 0
.../releasenotes/v2.1/release-2.1.7.md | 0
.../releasenotes/v2.1/release-2.1.8.md | 0
.../releasenotes/v2.1/release-2.1.9.md | 0
.../releasenotes/v3.0/release-3.0.0.md | 0
.../releasenotes/v3.0/release-3.0.1.md | 0
.../releasenotes/v3.0/release-3.0.2.md | 0
.../releasenotes/v3.0/release-3.0.3.md | 0
.../releasenotes/v3.0/release-3.0.4.md | 0
.../releasenotes/v3.0/release-3.0.5.md | 0
.../releasenotes/v3.0/release-3.0.6.md | 0
.../releasenotes/v3.0/release-3.0.7.md | 0
.../releasenotes/v3.0/release-3.0.8.md | 0
.../version-4.x/releasenotes/v3.1/release-3.1.0.md | 679 +++++
.../releasenotes/v3.1/release-3.1.1.md | 0
.../releasenotes/v4.0/release-4.0.0.md | 0
.../sql-manual/basic-element/comments.md | 0
.../basic-element/literal/date-literal.md | 0
.../basic-element/literal/numeric-literal.md | 0
.../basic-element/literal/string-literal.md | 0
.../sql-manual/basic-element/nulls.md | 0
.../sql-manual/basic-element/object-identifiers.md | 0
.../operators/arithmetic-operators.mdx | 0
.../operators/assignment-operators.md | 0
.../basic-element/operators/bitwise-operators.md | 0
.../boolean-testing-operators.md | 0
.../conditional-operators/comparison-operators.md | 0
.../conditional-operators/exists-operators.md | 0
.../full-text-search-operators.md | 0
.../conditional-operators/in-operators.md | 0
.../conditional-operators/logical-operators.md | 0
.../pattern-matching-operators.md | 0
.../basic-element/operators/operator-precedence.md | 0
.../sql-manual/basic-element/reserved-keywords.md | 0
.../sql-data-types/aggregate/AGG-STATE.md | 0
.../sql-data-types/aggregate/BITMAP.md | 0
.../basic-element/sql-data-types/aggregate/HLL.md | 0
.../sql-data-types/aggregate/QUANTILE-STATE.md | 0
.../sql-data-types/binary-type/VARBINARY.md | 0
.../sql-data-types/conversion/array-conversion.md | 0
.../conversion/boolean-conversion.md | 0
.../sql-data-types/conversion/cast-expr.md | 0
.../sql-data-types/conversion/cast-to-string.md | 375 +++
.../sql-data-types/conversion/date-conversion.md | 0
.../conversion/datetime-conversion.md | 0
.../conversion/decimal-conversion.md | 0
.../conversion/float-double-conversion.md | 0
.../sql-data-types/conversion/int-conversion.md | 0
.../sql-data-types/conversion/ip-conversion.md | 0
.../sql-data-types/conversion/json-conversion.md | 0
.../sql-data-types/conversion/map-conversion.md | 0
.../sql-data-types/conversion/overview.md | 0
.../sql-data-types/conversion/struct-conversion.md | 0
.../sql-data-types/conversion/time-conversion.md | 0
.../sql-data-types/data-type-overview.md | 0
.../basic-element/sql-data-types/date-time/DATE.md | 0
.../sql-data-types/date-time/DATETIME.md | 0
.../basic-element/sql-data-types/date-time/TIME.md | 0
.../basic-element/sql-data-types/ip/IPV4.md | 0
.../basic-element/sql-data-types/ip/IPV6.md | 0
.../basic-element/sql-data-types/numeric/BIGINT.md | 0
.../sql-data-types/numeric/BOOLEAN.md | 0
.../sql-data-types/numeric/DECIMAL.md | 0
.../sql-data-types/numeric/FLOATING-POINT.md | 0
.../basic-element/sql-data-types/numeric/INT.md | 0
.../sql-data-types/numeric/LARGEINT.md | 0
.../sql-data-types/numeric/SMALLINT.md | 0
.../sql-data-types/numeric/TINYINT.md | 0
.../sql-data-types/semi-structured/ARRAY.md | 0
.../sql-data-types/semi-structured/GEO.md | 0
.../sql-data-types/semi-structured/JSON.md | 0
.../sql-data-types/semi-structured/MAP.md | 0
.../sql-data-types/semi-structured/STRUCT.md | 0
.../sql-data-types/semi-structured/VARIANT.md | 0
.../semi-structured/semi-structured-overview.md | 0
.../sql-data-types/string-type/CHAR.md | 0
.../sql-data-types/string-type/STRING.md | 0
.../sql-data-types/string-type/VARCHAR.md | 0
.../sql-manual/basic-element/variables.md | 0
.../sql-functions/aggregate-functions/ai-agg.md | 0
.../sql-functions/aggregate-functions/any-value.md | 0
.../aggregate-functions/approx-count-distinct.md | 0
.../aggregate-functions/approx-top-k.md | 0
.../aggregate-functions/approx-top-sum.md | 0
.../sql-functions/aggregate-functions/array-agg.md | 0
.../aggregate-functions/avg-weighted.md | 0
.../sql-functions/aggregate-functions/avg.md | 0
.../aggregate-functions/bitmap-agg.md | 0
.../aggregate-functions/bitmap-intersect.md | 0
.../aggregate-functions/bitmap-union-count.md | 0
.../aggregate-functions/bitmap-union-int.md | 0
.../aggregate-functions/bitmap-union.md | 0
.../sql-functions/aggregate-functions/bool-and.md | 0
.../sql-functions/aggregate-functions/bool-or.md | 0
.../sql-functions/aggregate-functions/bool-xor.md | 0
.../aggregate-functions/collect-list.md | 0
.../aggregate-functions/collect-set.md | 0
.../aggregate-functions/corr-welford.md | 0
.../sql-functions/aggregate-functions/corr.md | 0
.../aggregate-functions/count-by-enum.md | 0
.../sql-functions/aggregate-functions/count.md | 0
.../aggregate-functions/covar-samp.md | 0
.../sql-functions/aggregate-functions/covar.md | 0
.../aggregate-functions/group-array-intersect.md | 0
.../aggregate-functions/group-array-union.md | 81 +
.../aggregate-functions/group-bit-and.md | 0
.../aggregate-functions/group-bit-or.md | 0
.../aggregate-functions/group-bit-xor.md | 0
.../aggregate-functions/group-bitmap-xor.md | 0
.../aggregate-functions/group-concat.md | 0
.../sql-functions/aggregate-functions/histogram.md | 0
.../aggregate-functions/hll-raw-agg.md | 0
.../aggregate-functions/hll-union-agg.md | 0
.../aggregate-functions/intersect-count.md | 0
.../sql-functions/aggregate-functions/kurt.md | 0
.../aggregate-functions/linear-histogram.md | 0
.../sql-functions/aggregate-functions/map-agg.md | 0
.../sql-functions/aggregate-functions/max-by.md | 0
.../sql-functions/aggregate-functions/max.md | 0
.../sql-functions/aggregate-functions/median.md | 0
.../sql-functions/aggregate-functions/min-by.md | 0
.../sql-functions/aggregate-functions/min.md | 0
.../percentile-approx-weighted.md | 0
.../aggregate-functions/percentile-approx.md | 0
.../aggregate-functions/percentile-array.md | 0
.../aggregate-functions/percentile.md | 0
.../aggregate-functions/percentile_reservoir.md | 89 +
.../aggregate-functions/quantile-union.md | 0
.../aggregate-functions/regr-intercept.md | 0
.../aggregate-functions/regr-slope.md | 0
.../sql-functions/aggregate-functions/retention.md | 0
.../aggregate-functions/sequence-count.md | 0
.../aggregate-functions/sequence-match.md | 0
.../sql-functions/aggregate-functions/skew.md | 0
.../aggregate-functions/stddev-samp.md | 0
.../sql-functions/aggregate-functions/stddev.md | 0
.../sql-functions/aggregate-functions/sum.md | 0
.../sql-functions/aggregate-functions/sum0.md | 0
.../aggregate-functions/topn-array.md | 0
.../aggregate-functions/topn-weighted.md | 0
.../sql-functions/aggregate-functions/topn.md | 0
.../sql-functions/aggregate-functions/var-samp.md | 0
.../sql-functions/aggregate-functions/variance.md | 0
.../aggregate-functions/window-funnel.md | 0
.../sql-functions/ai-functions/ai-classify.md | 0
.../sql-functions/ai-functions/ai-extract.md | 0
.../sql-functions/ai-functions/ai-filter.md | 0
.../sql-functions/ai-functions/ai-fixgrammar.md | 0
.../sql-functions/ai-functions/ai-function.md | 0
.../sql-functions/ai-functions/ai-generate.md | 0
.../sql-functions/ai-functions/ai-mask.md | 0
.../sql-functions/ai-functions/ai-sentiment.md | 0
.../sql-functions/ai-functions/ai-similarity.md | 0
.../sql-functions/ai-functions/ai-summarize.md | 0
.../sql-functions/ai-functions/ai-translate.md | 0
.../distance-functions/cosine-distance.md | 0
.../ai-functions/distance-functions/embed.md | 0
.../distance-functions/inner-product.md | 0
.../ai-functions/distance-functions/l1-distance.md | 0
.../ai-functions/distance-functions/l2-distance.md | 0
.../sql-functions/combinators/foreach.md | 0
.../sql-manual/sql-functions/combinators/merge.md | 0
.../sql-manual/sql-functions/combinators/state.md | 0
.../sql-manual/sql-functions/combinators/union.md | 0
.../array-functions/array-apply.md | 0
.../scalar-functions/array-functions/array-avg.md | 0
.../array-functions/array-compact.md | 0
.../array-functions/array-concat.md | 0
.../array-functions/array-contains.md | 0
.../array-functions/array-contains_all.md | 0
.../array-functions/array-count.md | 0
.../array-functions/array-cum-sum.md | 0
.../array-functions/array-difference.md | 0
.../array-functions/array-distinct.md | 0
.../array-functions/array-enumerate-uniq.md | 0
.../array-functions/array-enumerate.md | 0
.../array-functions/array-except.md | 0
.../array-functions/array-exists.md | 0
.../array-functions/array-filter.md | 0
.../array-functions/array-first-index.md | 0
.../array-functions/array-first.md | 0
.../array-functions/array-flatten.md | 0
.../array-functions/array-intersect.md | 0
.../scalar-functions/array-functions/array-join.md | 0
.../array-functions/array-last-index.md | 0
.../scalar-functions/array-functions/array-last.md | 0
.../scalar-functions/array-functions/array-map.md | 0
.../array-functions/array-match-all.md | 0
.../array-functions/array-match-any.md | 0
.../scalar-functions/array-functions/array-max.md | 0
.../scalar-functions/array-functions/array-min.md | 0
.../array-functions/array-popback.md | 0
.../array-functions/array-popfront.md | 0
.../array-functions/array-position.md | 0
.../array-functions/array-product.md | 0
.../array-functions/array-pushback.md | 0
.../array-functions/array-pushfront.md | 0
.../array-functions/array-range.md | 0
.../array-functions/array-remove.md | 0
.../array-functions/array-repeat.md | 0
.../array-functions/array-reverse-sort.md | 0
.../array-functions/array-reverse-split.md | 0
.../array-functions/array-shuffle.md | 0
.../scalar-functions/array-functions/array-size.md | 0
.../array-functions/array-slice.md | 0
.../scalar-functions/array-functions/array-sort.md | 0
.../array-functions/array-sortby.md | 0
.../array-functions/array-split.md | 0
.../scalar-functions/array-functions/array-sum.md | 0
.../array-functions/array-union.md | 0
.../array-functions/array-with-constant.md | 0
.../scalar-functions/array-functions/array-zip.md | 0
.../scalar-functions/array-functions/array.md | 0
.../array-functions/arrays-overlap.md | 0
.../scalar-functions/array-functions/countequal.md | 0
.../binary-functions/from-base64-binary.md | 72 +
.../scalar-functions/binary-functions/from_hex.md | 0
.../binary-functions/sub-binary.md | 108 +
.../binary-functions/to-base64-binary.md | 55 +
.../scalar-functions/binary-functions/to_hex.md | 0
.../bitmap-functions/bitmap-and-count.md | 0
.../bitmap-functions/bitmap-and-not-count.md | 0
.../bitmap-functions/bitmap-and-not.md | 0
.../bitmap-functions/bitmap-and.md | 0
.../bitmap-functions/bitmap-contains.md | 0
.../bitmap-functions/bitmap-count.md | 0
.../bitmap-functions/bitmap-empty.md | 0
.../bitmap-functions/bitmap-from-array.md | 0
.../bitmap-functions/bitmap-from-base64.md | 0
.../bitmap-functions/bitmap-from-string.md | 0
.../bitmap-functions/bitmap-has-all.md | 0
.../bitmap-functions/bitmap-has-any.md | 0
.../bitmap-functions/bitmap-hash.md | 0
.../bitmap-functions/bitmap-hash64.md | 0
.../bitmap-functions/bitmap-max.md | 0
.../bitmap-functions/bitmap-min.md | 0
.../bitmap-functions/bitmap-not.md | 0
.../bitmap-functions/bitmap-or-count.md | 0
.../scalar-functions/bitmap-functions/bitmap-or.md | 0
.../bitmap-functions/bitmap-remove.md | 0
.../bitmap-functions/bitmap-subset-in-range.md | 0
.../bitmap-functions/bitmap-subset-limit.md | 0
.../bitmap-functions/bitmap-to-array.md | 0
.../bitmap-functions/bitmap-to-base64.md | 0
.../bitmap-functions/bitmap-to-string.md | 0
.../bitmap-functions/bitmap-xor-count.md | 0
.../bitmap-functions/bitmap-xor.md | 0
.../bitmap-functions/sub-bitmap.md | 0
.../scalar-functions/bitmap-functions/to-bitmap.md | 0
.../bitwise-functions/bit-length.md | 0
.../scalar-functions/bitwise-functions/bit-test.md | 0
.../scalar-functions/bitwise-functions/bitand.md | 0
.../scalar-functions/bitwise-functions/bitcount.md | 0
.../scalar-functions/bitwise-functions/bitnot.md | 0
.../scalar-functions/bitwise-functions/bitor.md | 0
.../bitwise-functions/bitshiftleft.md | 0
.../bitwise-functions/bitshiftright.md | 0
.../scalar-functions/bitwise-functions/xor.md | 0
.../conditional-functions/coalesce.md | 0
.../conditional-functions/greatest.md | 0
.../scalar-functions/conditional-functions/if.md | 0
.../conditional-functions/ifnull.md | 0
.../conditional-functions/least.md | 0
.../conditional-functions/not-null-or-empty.md | 0
.../conditional-functions/null-or-empty.md | 0
.../conditional-functions/nullif.md | 0
.../date-time-functions/convert-tz.md | 0
.../date-time-functions/curdate.md | 0
.../date-time-functions/current-timestamp.md | 0
.../date-time-functions/curtime.md | 0
.../date-time-functions/date-add.md | 0
.../date-time-functions/date-ceil.md | 0
.../date-time-functions/date-floor.md | 0
.../date-time-functions/date-format.md | 0
.../date-time-functions/date-sub.md | 0
.../date-time-functions/date-trunc.md | 0
.../scalar-functions/date-time-functions/date.md | 0
.../date-time-functions/datediff.md | 0
.../date-time-functions/day-ceil.md | 0
.../date-time-functions/day-floor.md | 0
.../scalar-functions/date-time-functions/day.md | 0
.../date-time-functions/dayname.md | 0
.../date-time-functions/dayofweek.md | 0
.../date-time-functions/dayofyear.md | 0
.../date-time-functions/extract.md | 0
.../date-time-functions/from-days.md | 0
.../date-time-functions/from-iso8601-date.md | 0
.../date-time-functions/from-microsecond.md | 0
.../date-time-functions/from-millisecond.md | 0
.../date-time-functions/from-second.md | 0
.../date-time-functions/from-unixtime.md | 0
.../date-time-functions/get-format.md | 0
.../date-time-functions/hour-ceil.md | 0
.../date-time-functions/hour-floor.md | 0
.../scalar-functions/date-time-functions/hour.md | 0
.../date-time-functions/hours-add.md | 0
.../date-time-functions/hours-diff.md | 0
.../date-time-functions/hours-sub.md | 0
.../date-time-functions/last-day.md | 0
.../date-time-functions/localtime.md | 0
.../date-time-functions/makedate.md | 0
.../date-time-functions/maketime.md | 99 +
.../date-time-functions/microsecond-timestamp.md | 0
.../date-time-functions/microsecond.md | 0
.../date-time-functions/microseconds-add.md | 0
.../date-time-functions/microseconds-diff.md | 0
.../date-time-functions/microseconds-sub.md | 0
.../date-time-functions/millisecond-timestamp.md | 0
.../date-time-functions/milliseconds-add.md | 0
.../date-time-functions/milliseconds-diff.md | 0
.../date-time-functions/milliseconds-sub.md | 0
.../date-time-functions/minute-ceil.md | 0
.../date-time-functions/minute-floor.md | 0
.../scalar-functions/date-time-functions/minute.md | 0
.../date-time-functions/minutes-add.md | 0
.../date-time-functions/minutes-diff.md | 0
.../date-time-functions/minutes-sub.md | 0
.../date-time-functions/month-ceil.md | 0
.../date-time-functions/month-floor.md | 0
.../scalar-functions/date-time-functions/month.md | 0
.../date-time-functions/monthname.md | 0
.../date-time-functions/months-add.md | 0
.../date-time-functions/months-between.md | 0
.../date-time-functions/months-diff.md | 0
.../date-time-functions/months-sub.md | 0
.../date-time-functions/next-day.md | 0
.../scalar-functions/date-time-functions/now.md | 0
.../date-time-functions/quarter-ceil.md | 0
.../date-time-functions/quarter-floor.md | 0
.../date-time-functions/quarter.md | 0
.../date-time-functions/quarters-add.md | 0
.../date-time-functions/quarters-diff.md | 0
.../date-time-functions/quarters-sub.md | 0
.../date-time-functions/sec-to-time.md | 0
.../date-time-functions/second-ceil.md | 0
.../date-time-functions/second-floor.md | 0
.../date-time-functions/second-timestamp.md | 0
.../scalar-functions/date-time-functions/second.md | 0
.../date-time-functions/seconds-add.md | 0
.../date-time-functions/seconds-diff.md | 0
.../date-time-functions/seconds-sub.md | 0
.../date-time-functions/str-to-date.md | 0
.../date-time-functions/time-to-sec.md | 0
.../scalar-functions/date-time-functions/time.md | 0
.../date-time-functions/timediff.md | 0
.../date-time-functions/timestamp.md | 0
.../date-time-functions/timestampadd.md | 0
.../date-time-functions/timestampdiff.md | 0
.../date-time-functions/to-date.md | 0
.../date-time-functions/to-days.md | 0
.../date-time-functions/to-iso8601.md | 0
.../date-time-functions/to-monday.md | 0
.../date-time-functions/unix-timestamp.md | 0
.../date-time-functions/utc-timestamp.md | 0
.../date-time-functions/week-ceil.md | 0
.../date-time-functions/week-floor.md | 0
.../scalar-functions/date-time-functions/week.md | 0
.../date-time-functions/weekday.md | 0
.../date-time-functions/weekofyear.md | 0
.../date-time-functions/weeks-add.md | 0
.../date-time-functions/weeks-diff.md | 0
.../date-time-functions/weeks-sub.md | 0
.../date-time-functions/year-ceil.md | 0
.../date-time-functions/year-floor.md | 0
.../date-time-functions/year-of-week.md | 0
.../scalar-functions/date-time-functions/year.md | 0
.../date-time-functions/years-add.md | 0
.../date-time-functions/years-diff.md | 0
.../date-time-functions/years-sub.md | 0
.../date-time-functions/yearweek.md | 0
.../encrypt-digest-functions/aes-decrypt.md | 0
.../encrypt-digest-functions/aes-encrypt.md | 0
.../encrypt-digest-functions/crc32.md | 0
.../encrypt-digest-functions/md5.md | 0
.../encrypt-digest-functions/md5sum.md | 0
.../encrypt-digest-functions/murmur-hash3-32.md | 0
.../encrypt-digest-functions/murmur-hash3-64-v2.md | 46 +
.../encrypt-digest-functions/murmur-hash3-64.md | 47 +
.../encrypt-digest-functions/sha.md | 0
.../encrypt-digest-functions/sha2.md | 0
.../encrypt-digest-functions/sm3.md | 0
.../encrypt-digest-functions/sm3sum.md | 0
.../encrypt-digest-functions/sm4-decrypt.md | 0
.../encrypt-digest-functions/sm4-encrypt.md | 0
.../encrypt-digest-functions/xxhash-32.md | 0
.../encrypt-digest-functions/xxhash-64.md | 72 +
.../hll-functions/hll-cardinality.md | 0
.../scalar-functions/hll-functions/hll-empty.md | 0
.../hll-functions/hll-from-base64.md | 0
.../scalar-functions/hll-functions/hll-hash.md | 0
.../hll-functions/hll-to-base64.md | 0
.../scalar-functions/ip-functions/cut-ipv6.md | 0
.../scalar-functions/ip-functions/inet-aton.md | 0
.../scalar-functions/ip-functions/inet-ntoa.md | 0
.../scalar-functions/ip-functions/inet6-aton.md | 0
.../scalar-functions/ip-functions/inet6-ntoa.md | 0
.../ip-functions/ipv4-cidr-to-range.md | 0
.../ip-functions/ipv4-num-to-string.md | 0
.../ip-functions/ipv4-string-to-num-or-default.md | 0
.../ip-functions/ipv4-string-to-num-or-null.md | 0
.../ip-functions/ipv4-string-to-num.md | 0
.../scalar-functions/ip-functions/ipv4-to-ipv6.md | 0
.../ip-functions/ipv6-cidr-to-range.md | 0
.../ip-functions/ipv6-num-to-string.md | 0
.../ip-functions/ipv6-string-to-num-or-default.md | 0
.../ip-functions/ipv6-string-to-num-or-null.md | 0
.../ip-functions/ipv6-string-to-num.md | 0
.../ip-functions/is-ip-address-in-range.md | 0
.../ip-functions/is-ipv4-compat.md | 0
.../ip-functions/is-ipv4-mapped.md | 0
.../ip-functions/is-ipv4-string.md | 0
.../ip-functions/is-ipv6-string.md | 0
.../ip-functions/to-ipv4-or-default.md | 0
.../ip-functions/to-ipv4-or-null.md | 0
.../scalar-functions/ip-functions/to-ipv4.md | 0
.../ip-functions/to-ipv6-or-default.md | 0
.../ip-functions/to-ipv6-or-null.md | 0
.../scalar-functions/ip-functions/to-ipv6.md | 0
.../json-functions/get-json-bigint.md | 0
.../json-functions/get-json-double.md | 0
.../json-functions/get-json-int.md | 0
.../json-functions/get-json-string.md | 0
.../json-functions/json-array-ignore-null.md | 0
.../scalar-functions/json-functions/json-array.md | 0
.../json-functions/json-contains.md | 0
.../json-functions/json-exists-path.md | 0
.../json-functions/json-extract-bigint.md | 0
.../json-functions/json-extract-bool.md | 0
.../json-functions/json-extract-double.md | 0
.../json-functions/json-extract-int.md | 0
.../json-functions/json-extract-isnull.md | 0
.../json-functions/json-extract-largeint.md | 0
.../json-functions/json-extract-string.md | 0
.../json-functions/json-extract.md | 0
.../scalar-functions/json-functions/json-hash.md | 0
.../scalar-functions/json-functions/json-insert.md | 0
.../scalar-functions/json-functions/json-keys.md | 0
.../scalar-functions/json-functions/json-length.md | 0
.../scalar-functions/json-functions/json-object.md | 164 ++
.../json-functions/json-parse-error-to-null.md | 0
.../json-functions/json-parse-error-to-value.md | 0
.../scalar-functions/json-functions/json-parse.md | 0
.../scalar-functions/json-functions/json-quote.md | 0
.../scalar-functions/json-functions/json-remove.md | 70 +
.../json-functions/json-replace.md | 0
.../scalar-functions/json-functions/json-search.md | 0
.../scalar-functions/json-functions/json-set.md | 0
.../scalar-functions/json-functions/json-type.md | 0
.../json-functions/json-unquote.md | 0
.../scalar-functions/json-functions/json-valid.md | 0
.../normalize-json-numbers-to-double.md | 0
.../json-functions/sort-json-object-keys.md | 0
.../json-functions/strip-null-value.md | 69 +
.../scalar-functions/json-functions/to-json.md | 0
.../map-functions/map-contains-entry.md | 0
.../map-functions/map-contains-key.md | 0
.../map-functions/map-contains-value.md | 0
.../scalar-functions/map-functions/map-entries.md | 0
.../scalar-functions/map-functions/map-keys.md | 0
.../scalar-functions/map-functions/map-size.md | 0
.../scalar-functions/map-functions/map-values.md | 0
.../scalar-functions/map-functions/map.md | 0
.../scalar-functions/map-functions/str-to-map.md | 0
.../scalar-functions/numeric-functions/abs.md | 0
.../scalar-functions/numeric-functions/acos.md | 0
.../scalar-functions/numeric-functions/acosh.md | 0
.../scalar-functions/numeric-functions/asin.md | 0
.../scalar-functions/numeric-functions/asinh.md | 0
.../scalar-functions/numeric-functions/atan.md | 0
.../scalar-functions/numeric-functions/atan2.md | 0
.../scalar-functions/numeric-functions/atanh.md | 0
.../scalar-functions/numeric-functions/bin.md | 0
.../scalar-functions/numeric-functions/cbrt.md | 0
.../scalar-functions/numeric-functions/ceil.md | 0
.../scalar-functions/numeric-functions/conv.md | 0
.../scalar-functions/numeric-functions/cos.md | 0
.../scalar-functions/numeric-functions/cosh.md | 0
.../scalar-functions/numeric-functions/cot.md | 0
.../scalar-functions/numeric-functions/csc.md | 0
.../scalar-functions/numeric-functions/degrees.md | 0
.../scalar-functions/numeric-functions/e.md | 0
.../scalar-functions/numeric-functions/even.md | 0
.../scalar-functions/numeric-functions/exp.md | 0
.../scalar-functions/numeric-functions/floor.md | 0
.../scalar-functions/numeric-functions/fmod.md | 0
.../numeric-functions/format-round.md | 0
.../scalar-functions/numeric-functions/gcd.md | 0
.../scalar-functions/numeric-functions/isinf.md | 0
.../scalar-functions/numeric-functions/isnan.md | 0
.../scalar-functions/numeric-functions/lcm.md | 0
.../scalar-functions/numeric-functions/ln.md | 0
.../scalar-functions/numeric-functions/log.md | 0
.../scalar-functions/numeric-functions/log10.md | 0
.../scalar-functions/numeric-functions/log2.md | 0
.../scalar-functions/numeric-functions/mod.md | 0
.../numeric-functions/money-format.md | 0
.../scalar-functions/numeric-functions/negative.md | 0
.../numeric-functions/normal-cdf.md | 0
.../scalar-functions/numeric-functions/pi.md | 0
.../scalar-functions/numeric-functions/pmod.md | 0
.../scalar-functions/numeric-functions/positive.md | 0
.../scalar-functions/numeric-functions/pow.md | 0
.../scalar-functions/numeric-functions/radians.md | 0
.../scalar-functions/numeric-functions/random.md | 0
.../numeric-functions/round-bankers.md | 0
.../scalar-functions/numeric-functions/round.md | 0
.../scalar-functions/numeric-functions/sec.md | 0
.../scalar-functions/numeric-functions/sign.md | 0
.../scalar-functions/numeric-functions/signbit.md | 0
.../scalar-functions/numeric-functions/sin.md | 0
.../scalar-functions/numeric-functions/sinh.md | 0
.../scalar-functions/numeric-functions/sqrt.md | 0
.../scalar-functions/numeric-functions/tan.md | 0
.../scalar-functions/numeric-functions/tanh.md | 0
.../scalar-functions/numeric-functions/truncate.md | 0
.../scalar-functions/numeric-functions/uniform.md | 0
.../numeric-functions/uuid_numeric.md | 0
.../numeric-functions/width-bucket.md | 0
.../scalar-functions/numeric-functions/xor.md | 0
.../scalar-functions/other-functions/convert-to.md | 0
.../scalar-functions/other-functions/esquery.md | 0
.../scalar-functions/other-functions/field.md | 0
.../scalar-functions/other-functions/g.md | 0
.../other-functions/grouping-id.md | 0
.../scalar-functions/other-functions/grouping.md | 0
.../quantile-functions/quantile-percent.md | 0
.../quantile-functions/quantile-state-empty.md | 0
.../quantile-functions/to-quantile-state.md | 0
.../spatial-functions/st-angle-sphere.md | 0
.../scalar-functions/spatial-functions/st-angle.md | 0
.../spatial-functions/st-area-square-km.md | 0
.../spatial-functions/st-area-square-meters.md | 0
.../spatial-functions/st-asbinary.md | 0
.../spatial-functions/st-astext.md | 0
.../spatial-functions/st-azimuth.md | 0
.../spatial-functions/st-circle.md | 0
.../spatial-functions/st-contains.md | 0
.../spatial-functions/st-disjoint.md | 0
.../spatial-functions/st-distance-sphere.md | 0
.../spatial-functions/st-geometryfromtext.md | 0
.../spatial-functions/st-geometryfromwkb.md | 0
.../spatial-functions/st-intersects.md | 0
.../spatial-functions/st-linefromtext.md | 0
.../scalar-functions/spatial-functions/st-point.md | 0
.../spatial-functions/st-polygon.md | 0
.../spatial-functions/st-touches.md | 0
.../scalar-functions/spatial-functions/st-x.md | 0
.../scalar-functions/spatial-functions/st-y.md | 0
.../append-trailing-char-if-absent.md | 95 +
.../scalar-functions/string-functions/ascii.md | 142 +
.../string-functions/auto-partition-name.md | 112 +
.../string-functions/char-length.md | 87 +
.../scalar-functions/string-functions/char.md | 81 +
.../scalar-functions/string-functions/compress.md | 80 +
.../scalar-functions/string-functions/concat-ws.md | 167 ++
.../scalar-functions/string-functions/concat.md | 136 +
.../string-functions/count_substrings.md | 134 +
.../cut-to-first-significant-subdomain.md | 0
.../scalar-functions/string-functions/date.md | 0
.../string-functions/digital-masking.md | 93 +
.../string-functions/domain-without-www.md | 0
.../scalar-functions/string-functions/domain.md | 0
.../scalar-functions/string-functions/elt.md | 139 +
.../scalar-functions/string-functions/ends-with.md | 161 ++
.../string-functions/export-set.md | 0
.../string-functions/extract-url-parameter.md | 0
.../string-functions/find-in-set.md | 162 ++
.../first-significant-subdomain.md | 0
.../string-functions/format-number.md | 86 +
.../scalar-functions/string-functions/format.md | 95 +
.../string-functions/from-base64.md | 101 +
.../string-functions/from-iso8601-date.md | 0
.../scalar-functions/string-functions/hex.md | 103 +
.../scalar-functions/string-functions/initcap.md | 89 +
.../scalar-functions/string-functions/instr.md | 90 +
.../string-functions/int-to-uuid.md | 54 +
.../scalar-functions/string-functions/is-uuid.md | 99 +
.../scalar-functions/string-functions/lcase.md | 75 +
.../scalar-functions/string-functions/length.md | 78 +
.../scalar-functions/string-functions/locate.md | 80 +
.../scalar-functions/string-functions/lpad.md | 78 +
.../scalar-functions/string-functions/ltrim-in.md | 0
.../scalar-functions/string-functions/ltrim.md | 77 +
.../scalar-functions/string-functions/make-set.md | 114 +
.../string-functions/mask-first-n.md | 165 ++
.../string-functions/mask-last-n.md | 165 ++
.../scalar-functions/string-functions/mask.md | 167 ++
.../string-functions/multi-match-any.md | 0
.../string-functions/multi-search-all-positions.md | 100 +
.../string-functions/ngram-search.md | 92 +
.../scalar-functions/string-functions/overlay.md | 101 +
.../scalar-functions/string-functions/overview.md | 0
.../string-functions/parse-data-size.md | 131 +
.../scalar-functions/string-functions/parse-url.md | 0
.../scalar-functions/string-functions/position.md | 207 ++
.../scalar-functions/string-functions/printf.md | 0
.../scalar-functions/string-functions/protocol.md | 0
.../scalar-functions/string-functions/quote.md | 106 +
.../string-functions/random_bytes.md | 93 +
.../string-functions/regexp-count.md | 0
.../string-functions/regexp-extract-all.md | 0
.../string-functions/regexp-extract-or-null.md | 0
.../string-functions/regexp-extract.md | 0
.../string-functions/regexp-replace-one.md | 0
.../string-functions/regexp-replace.md | 0
.../scalar-functions/string-functions/regexp.md | 0
.../scalar-functions/string-functions/repeat.md | 210 ++
.../string-functions/replace-empty.md | 72 +
.../scalar-functions/string-functions/replace.md | 106 +
.../scalar-functions/string-functions/reverse.md | 204 ++
.../scalar-functions/string-functions/rpad.md | 164 ++
.../scalar-functions/string-functions/rtrim-in.md | 123 +
.../scalar-functions/string-functions/rtrim.md | 135 +
.../scalar-functions/string-functions/soundex.md | 153 ++
.../scalar-functions/string-functions/space.md | 83 +
.../string-functions/split-by-regexp.md | 168 ++
.../string-functions/split-by-string.md | 165 ++
.../string-functions/split-part.md | 157 ++
.../string-functions/starts-with.md | 165 ++
.../scalar-functions/string-functions/strcmp.md | 74 +
.../scalar-functions/string-functions/strleft.md | 137 +
.../scalar-functions/string-functions/strright.md | 149 ++
.../string-functions/sub-replace.md | 119 +
.../string-functions/substring-index.md | 154 ++
.../scalar-functions/string-functions/substring.md | 168 ++
.../scalar-functions/string-functions/timestamp.md | 0
.../scalar-functions/string-functions/to-base64.md | 151 ++
.../string-functions/to-iso8601.md | 0
.../scalar-functions/string-functions/tokenize.md | 0
.../string-functions/top-level-domain.md | 0
.../scalar-functions/string-functions/translate.md | 154 ++
.../scalar-functions/string-functions/trim-in.md | 125 +
.../scalar-functions/string-functions/trim.md | 134 +
.../scalar-functions/string-functions/ucase.md | 139 +
.../string-functions/uncompress.md | 66 +
.../scalar-functions/string-functions/unhex.md | 135 +
.../string-functions/url-decode.md | 0
.../string-functions/url-encode.md | 0
.../string-functions/uuid-to-int.md | 113 +
.../scalar-functions/string-functions/uuid.md | 59 +
.../scalar-functions/string-functions/week-ceil.md | 0
.../string-functions/week-floor.md | 0
.../string-functions/xpath-string.md | 99 +
.../struct-functions/named-struct.md | 0
.../struct-functions/struct-element.md | 0
.../scalar-functions/struct-functions/struct.md | 0
.../system-functions/connection-id.md | 0
.../system-functions/current-catalog.md | 0
.../system-functions/current-user.md | 0
.../scalar-functions/system-functions/database.md | 0
.../system-functions/last-query-id.md | 0
.../system-functions/session-user.md | 0
.../scalar-functions/system-functions/user.md | 0
.../system-functions/version-function.md | 0
.../variant-functions/element-at.md | 0
.../variant-functions/variant-type.md | 0
.../table-functions/explode-bitmap-outer.md | 0
.../table-functions/explode-bitmap.md | 0
.../explode-json-array-double-outer.md | 0
.../table-functions/explode-json-array-double.md | 0
.../explode-json-array-int-outer.md | 0
.../table-functions/explode-json-array-int.md | 0
.../explode-json-array-json-outer.md | 0
.../table-functions/explode-json-array-json.md | 0
.../explode-json-array-string-outer.md | 0
.../table-functions/explode-json-array-string.md | 0
.../table-functions/explode-json-object-outer.md | 0
.../table-functions/explode-json-object.md | 0
.../table-functions/explode-map-outer.md | 0
.../sql-functions/table-functions/explode-map.md | 0
.../table-functions/explode-numbers-outer.md | 0
.../table-functions/explode-numbers.md | 0
.../sql-functions/table-functions/explode-outer.md | 0
.../table-functions/explode-split-outer.md | 0
.../sql-functions/table-functions/explode-split.md | 0
.../sql-functions/table-functions/explode.md | 0
.../table-functions/posexplode-outer.md | 0
.../sql-functions/table-functions/posexplode.md | 0
.../table-valued-functions/backends.md | 0
.../table-valued-functions/catalogs.md | 0
.../sql-functions/table-valued-functions/file.md | 0
.../table-valued-functions/frontends.md | 0
.../table-valued-functions/frontends_disks.md | 0
.../sql-functions/table-valued-functions/hdfs.md | 0
.../table-valued-functions/hudi-meta.md | 0
.../table-valued-functions/iceberg-meta.md | 0
.../sql-functions/table-valued-functions/jobs.md | 0
.../sql-functions/table-valued-functions/local.md | 0
.../table-valued-functions/mv_infos.md | 0
.../table-valued-functions/numbers.md | 0
.../table-valued-functions/partition-values.md | 0
.../table-valued-functions/partitions.md | 0
.../sql-functions/table-valued-functions/query.md | 0
.../sql-functions/table-valued-functions/s3.md | 0
.../sql-functions/table-valued-functions/tasks.md | 0
.../sql-functions/window-functions/cume-dist.md | 0
.../sql-functions/window-functions/dense-rank.md | 0
.../sql-functions/window-functions/first-value.md | 0
.../sql-functions/window-functions/lag.md | 0
.../sql-functions/window-functions/last-value.md | 0
.../sql-functions/window-functions/lead.md | 0
.../sql-functions/window-functions/nth-value.md | 0
.../sql-functions/window-functions/ntile.md | 0
.../sql-functions/window-functions/overview.md | 0
.../sql-functions/window-functions/percent-rank.md | 0
.../sql-functions/window-functions/rank.md | 0
.../sql-functions/window-functions/row-number.md | 0
.../account-management/ALTER-ROLE.md | 45 +
.../account-management/ALTER-USER.md | 112 +
.../account-management/CREATE-ROLE.md | 50 +
.../account-management/CREATE-USER.md | 134 +
.../sql-statements/account-management/DROP-ROLE.md | 42 +
.../sql-statements/account-management/DROP-USER.md | 38 +
.../sql-statements/account-management/GRANT-TO.md | 214 ++
.../account-management/REFRESH-LDAP.md | 63 +
.../account-management/REVOKE-FROM.md | 174 ++
.../account-management/SET-LDAP_ADMIN_PASSWORD.md | 37 +
.../account-management/SET-PASSWORD.md | 61 +
.../account-management/SET-PROPERTY.md | 106 +
.../account-management/SHOW-CREATE-USER.md | 49 +
.../account-management/SHOW-GRANTS.md | 103 +
.../account-management/SHOW-PRIVILEGES.md | 52 +
.../account-management/SHOW-PROPERTY.md | 124 +
.../account-management/SHOW-ROLES.md | 50 +
.../sql-statements/catalog/ALTER-CATALOG.md | 92 +
.../sql-statements/catalog/CREATE-CATALOG.md | 163 ++
.../sql-statements/catalog/DROP-CATALOG.md | 37 +
.../sql-manual/sql-statements/catalog/REFRESH.md | 66 +
.../sql-statements/catalog/SHOW-CATALOG.md | 59 +
.../sql-statements/catalog/SHOW-CATALOGS.md | 74 +
.../sql-statements/catalog/SHOW-CREATE-CATALOG.md | 54 +
.../sql-statements/character-set/SHOW-CHARSET.md | 40 +
.../sql-statements/character-set/SHOW-COLLATION.md | 50 +
.../compute-management/ALTER-RESOURCE.md | 63 +
.../compute-management/ALTER-WORKLOAD-GROUP.md | 45 +
.../compute-management/ALTER-WORKLOAD-POLICY.md | 42 +
.../compute-management/CREATE-RESOURCE.md | 230 ++
.../compute-management/CREATE-WORKLOAD-GROUP.md | 46 +
.../compute-management/CREATE-WORKLOAD-POLICY.md | 49 +
.../compute-management/DROP-RESOURCE.md | 28 +
.../compute-management/DROP-WORKLOAD-GROUP.md | 24 +
.../compute-management/DROP-WORKLOAD-POLICY.md | 33 +
.../compute-management/SHOW-COMPUTE-GROUPS.md | 47 +
.../compute-management/SHOW-RESOURCES.md | 59 +
.../compute-management/SHOW-WORKLOAD-GROUPS.md | 50 +
.../instance-management/ADD-BACKEND.md | 74 +
.../instance-management/ADD-BROKER.md | 48 +
.../instance-management/ADD-FOLLOWER.md | 49 +
.../instance-management/ADD-OBSERVER.md | 47 +
.../ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md | 45 +
.../CANCEL-DECOMMISSION-BACKEND.md | 71 +
.../instance-management/DECOMMISSION-BACKEND.md | 74 +
.../instance-management/DROP-BACKEND.md | 77 +
.../instance-management/DROP-BROKER.md | 53 +
.../instance-management/DROP-FOLLOWER.md | 49 +
.../instance-management/DROP-OBSERVER.md | 47 +
.../instance-management/MODIFY-BACKEND.md | 87 +
.../MODIFY-FRONTEND-HOSTNAME.md | 42 +
.../instance-management/SET-FRONTEND-CONFIG.md | 44 +
.../instance-management/SHOW-BACKEND-CONFIG.md | 94 +
.../instance-management/SHOW-BACKENDS.md | 75 +
.../instance-management/SHOW-BROKER.md | 46 +
.../instance-management/SHOW-FRONTEND-CONFIG.md | 53 +
.../instance-management/SHOW-FRONTENDS-DISKS.md | 65 +
.../instance-management/SHOW-FRONTENDS.md | 70 +
.../storage-management/ALTER-STORAGE-POLICY.md | 57 +
.../storage-management/ALTER-STORAGE-VAULT.md | 63 +
.../storage-management/CANCEL-WARM-UP.md | 63 +
.../storage-management/CREATE-STORAGE-POLICY.md | 61 +
.../storage-management/CREATE-STORAGE-VAULT.md | 228 ++
.../storage-management/DROP-STORAGE-POLICY.md | 37 +
.../SET-DEFAULT-STORAGE-VAULT.md | 34 +
.../storage-management/SHOW-CACHE-HOTSPOT.md | 51 +
.../SHOW-STORAGE-POLICY-USING.md | 52 +
.../storage-management/SHOW-STORAGE-POLICY.md | 76 +
.../storage-management/SHOW-STORAGE-VAULTS.md | 36 +
.../storage-management/SHOW-WARM-UP-JOB.md | 41 +
.../UNSET-DEFAULT-STORAGE-VAULT.md | 27 +
.../storage-management/WARM-UP.md | 58 +
.../data-governance/ALTER-SQL_BLOCK_RULE.md | 50 +
.../data-governance/CREATE-ROW-POLICY.md | 76 +
.../data-governance/CREATE-SQL_BLOCK_RULE.md | 165 ++
.../data-governance/DROP-ROW-POLICY.md | 65 +
.../data-governance/DROP-SQL_BLOCK_RULE.md | 38 +
.../data-governance/SHOW-ROW-POLICY.md | 54 +
.../data-governance/SHOW-SQL_BLOCK_RULE.md | 57 +
.../sql-statements/data-modification/DML/DELETE.md | 186 ++
.../data-modification/DML/INSERT-OVERWRITE.md | 294 +++
.../sql-statements/data-modification/DML/INSERT.md | 209 ++
.../data-modification/DML/MERGE-INTO.md | 202 ++
.../data-modification/DML/SHOW-DELETE.md | 57 +
.../data-modification/DML/SHOW-LAST-INSERT.md | 53 +
.../sql-statements/data-modification/DML/UPDATE.md | 158 ++
.../data-modification/backup-and-restore/BACKUP.md | 109 +
.../backup-and-restore/CANCEL-BACKUP.md | 30 +
.../backup-and-restore/CANCEL-RESTORE.md | 35 +
.../backup-and-restore/CREATE-REPOSITORY.md | 147 ++
.../backup-and-restore/DROP-REPOSITORY.md | 39 +
.../backup-and-restore/RESTORE.md | 131 +
.../backup-and-restore/SHOW-BACKUP.md | 55 +
.../backup-and-restore/SHOW-CREATE-REPOSITORY.md | 28 +
.../backup-and-restore/SHOW-REPOSITORIES.md | 46 +
.../backup-and-restore/SHOW-RESTORE.md | 58 +
.../backup-and-restore/SHOW-SNAPSHOT.md | 61 +
.../load-and-export/ALTER-ROUTINE-LOAD.md | 104 +
.../load-and-export/BROKER-LOAD.md | 446 ++++
.../load-and-export/CANCEL-EXPORT.md | 78 +
.../load-and-export/CANCEL-LOAD.md | 78 +
.../load-and-export/CLEAN-LABEL.md | 52 +
.../load-and-export/CREATE-ROUTINE-LOAD.md | 597 +++++
.../load-and-export/CREATE-SYNC-JOB.md | 114 +
.../data-modification/load-and-export/EXPORT.md | 383 +++
.../load-and-export/MYSQL-LOAD.md | 174 ++
.../data-modification/load-and-export/OUTFILE.md | 391 +++
.../load-and-export/PAUSE-ROUTINE-LOAD.md | 55 +
.../load-and-export/PAUSE-SYNC-JOB.md | 38 +
.../load-and-export/RESUME-ROUTINE-LOAD.md | 56 +
.../load-and-export/RESUME-SYNC-JOB.md | 40 +
.../load-and-export/SHOW-CREATE-LOAD.md | 42 +
.../load-and-export/SHOW-CREATE-ROUTINE-LOAD.md | 46 +
.../load-and-export/SHOW-EXPORT.md | 97 +
.../load-and-export/SHOW-LOAD-WARNINGS.md | 56 +
.../data-modification/load-and-export/SHOW-LOAD.md | 113 +
.../load-and-export/SHOW-ROUTINE-LOAD-TASK.md | 60 +
.../load-and-export/SHOW-ROUTINE-LOAD.md | 121 +
.../load-and-export/SHOW-STREAM-LOAD.md | 75 +
.../load-and-export/SHOW-SYNC-JOB.md | 42 +
.../load-and-export/STOP-ROUTINE-LOAD.md | 54 +
.../load-and-export/STOP-SYNC-JOB.md | 40 +
.../data-modification/load-and-export/SYNC.md | 29 +
.../sql-statements/data-query/EXPLAIN.md | 639 +++++
.../sql-manual/sql-statements/data-query/SELECT.md | 392 +++
.../sql-statements/database/ALTER-DATABASE.md | 94 +
.../sql-statements/database/CREATE-DATABASE.md | 86 +
.../sql-statements/database/DROP-DATABASE.md | 47 +
.../database/SHOW-CREATE-DATABASE.md | 71 +
.../sql-statements/database/SHOW-DATABASE-ID.md | 51 +
.../sql-statements/database/SHOW-DATABASES.md | 84 +
.../sql-statements/function/CREATE-FUNCTION.md | 137 +
.../sql-statements/function/DESC-FUNCTION.md | 44 +
.../sql-statements/function/DROP-FUNCTION.md | 65 +
.../function/SHOW-CREATE-FUNCTION.md | 77 +
.../sql-statements/function/SHOW-FUNCTIONS.md | 139 +
.../sql-manual/sql-statements/job/CANCEL-TASK.md | 43 +
.../sql-manual/sql-statements/job/CREATE-JOB.md | 145 +
.../sql-manual/sql-statements/job/DROP-JOB.md | 37 +
.../sql-manual/sql-statements/job/PAUSE-JOB.md | 37 +
.../sql-manual/sql-statements/job/RESUME-JOB.md | 36 +
.../sql-statements/plugin/INSTALL-PLUGIN.md | 67 +
.../sql-statements/plugin/SHOW-PLUGINS.md | 55 +
.../sql-statements/plugin/UNINSTALL-PLUGIN.md | 41 +
.../recycle/DROP-CATALOG-RECYCLE-BIN.md | 66 +
.../sql-manual/sql-statements/recycle/RECOVER.md | 140 +
.../recycle/SHOW-CATALOG-RECYCLE-BIN.md | 67 +
.../sql-statements/security/CREATE-ENCRYPTKEY.md | 84 +
.../sql-statements/security/CREATE-FILE.md | 109 +
.../sql-statements/security/DROP-ENCRYPTKEY.md | 50 +
.../sql-statements/security/DROP-FILE.md | 66 +
.../sql-statements/security/SHOW-ENCRYPTKEY.md | 89 +
.../sql-statements/security/SHOW-FILE.md | 71 +
.../session/connection/KILL-CONNECTION.md | 50 +
.../session/context/SWITCH-CATALOG.md | 35 +
.../session/context/USE-COMPUTE-GROUP.md | 75 +
.../sql-statements/session/context/USE-DATABASE.md | 73 +
.../session/queries/CLEAN-ALL-PROFILE.md | 33 +
.../session/queries/CLEAN-ALL-QUERY-STATS.md | 68 +
.../sql-statements/session/queries/KILL-QUERY.md | 86 +
.../session/queries/PLAN-REPLAYER-DUMP.md | 79 +
.../session/queries/PLAN-REPLAYER-PLAY.md | 32 +
.../session/queries/SHOW-PROCESSLIST.md | 79 +
.../session/queries/SHOW-QUERY-STATS.md | 198 ++
.../session/variable/SET-VARIABLE.md | 70 +
.../session/variable/SHOW-VARIABLES.md | 78 +
.../session/variable/UNSET-VARIABLE.md | 61 +
.../sql-statements/statistics/ALTER-STATS.md | 92 +
.../sql-statements/statistics/ANALYZE.md | 72 +
.../sql-statements/statistics/DROP-ANALYZE-JOB.md | 38 +
.../sql-statements/statistics/DROP-STATS.md | 57 +
.../sql-statements/statistics/KILL-ANALYZE-JOB.md | 45 +
.../sql-statements/statistics/SHOW-ANALYZE.md | 103 +
.../statistics/SHOW-QUEUED-ANZLYZE-JOBS.md | 78 +
.../sql-statements/statistics/SHOW-STATS.md | 94 +
.../sql-statements/statistics/SHOW-TABLE-STATS.md | 65 +
.../system-info-and-help/SHOW-PROC.md | 280 ++
.../ALTER-ASYNC-MATERIALIZED-VIEW.md | 73 +
.../CANCEL-MATERIALIZED-VIEW-TASK.md | 46 +
.../CREATE-ASYNC-MATERIALIZED-VIEW.md | 300 +++
.../DROP-ASYNC-MATERIALIZED-VIEW.md | 43 +
.../PAUSE-MATERIALIZED-VIEW-JOB.md | 49 +
.../REFRESH-MATERIALIZED-VIEW.md | 83 +
.../RESUME-MATERIALIZED-VIEW-JOB.md | 47 +
.../SHOW-CREATE-ASYNC-MATERIALIZED-VIEW.md | 45 +
.../ADMIN-CHECK-TABLET.md | 58 +
.../ADMIN-COPY-TABLET.md | 113 +
.../ADMIN-SET-REPLICA-STATUS.md | 74 +
.../ADMIN-SET-REPLICA-VERSION.md | 70 +
.../CANCEL-REBALANCE-DISK.md | 58 +
.../CANCEL-REPAIR-TABLE.md | 65 +
.../data-and-status-management/CLEAN-TRASH.md | 46 +
.../data-and-status-management/COMPACT-TABLE.md | 66 +
.../data-and-status-management/DIAGNOSE-TABLET.md | 123 +
.../data-and-status-management/REBALANCE-DISK.md | 59 +
.../data-and-status-management/REPAIR-TABLE.md | 74 +
.../SET-TABLE-PARTITION-VERSION.md | 44 +
.../data-and-status-management/SET-TABLE-STATUS.md | 90 +
.../data-and-status-management/SHOW-DATA-SKEW.md | 174 ++
.../data-and-status-management/SHOW-DATA.md | 161 ++
.../SHOW-REPLICA-DISTRIBUTION.md | 112 +
.../SHOW-REPLICA-STATUS.md | 137 +
.../SHOW-TABLET-DIAGNOSIS.md | 73 +
.../SHOW-TABLET-STORAGE-FORMAT.md | 74 +
.../data-and-status-management/SHOW-TABLET.md | 65 +
.../SHOW-TABLETS-BELONG.md | 75 +
.../data-and-status-management/SHOW-TRASH.md | 50 +
.../table-and-view/index/BUILD-INDEX.md | 84 +
.../table-and-view/index/CANCEL-BUILD-INDEX.md | 71 +
.../table-and-view/index/CREATE-INDEX.md | 98 +
.../table-and-view/index/DROP-INDEX.md | 43 +
.../table-and-view/index/SHOW-BUILD-INDEX.md | 103 +
.../table-and-view/index/SHOW-INDEX.md | 65 +
.../CREATE-MATERIALIZED-VIEW.md | 114 +
.../DROP-MATERIALIZED-VIEW.md | 46 +
.../SHOW-ALTER-TABLE-MATERIALIZED-VIEW.md | 39 +
.../SHOW-CREATE-MATERIALIZED-VIEW.md | 51 +
.../table-and-view/table/ALTER-COLOCATE-GROUP.md | 59 +
.../table/ALTER-TABLE-ADD-GENERATED-COLUMN.md | 45 +
.../table-and-view/table/ALTER-TABLE-COLUMN.md | 286 ++
.../table-and-view/table/ALTER-TABLE-COMMENT.md | 55 +
.../table-and-view/table/ALTER-TABLE-PARTITION.md | 152 ++
.../table-and-view/table/ALTER-TABLE-PROPERTY.md | 269 ++
.../table-and-view/table/ALTER-TABLE-RENAME.md | 99 +
.../table-and-view/table/ALTER-TABLE-REPLACE.md | 72 +
.../table-and-view/table/ALTER-TABLE-ROLLUP.md | 115 +
.../table-and-view/table/CANCEL-ALTER-TABLE.md | 96 +
.../table-and-view/table/CREATE-TABLE.md | 737 ++++++
.../table-and-view/table/DESC-TABLE.md | 99 +
.../table-and-view/table/DROP-TABLE.md | 79 +
.../table-and-view/table/SHOW-ALTER-TABLE.md | 74 +
.../table-and-view/table/SHOW-COLUMNS.md | 77 +
.../SHOW-CONVERT-LIGHT-SCHEMA-CHANGE-PROCESS.md | 47 +
.../table-and-view/table/SHOW-CREATE-TABLE.md | 67 +
.../table/SHOW-DYNAMIC-PARTITION-TABLES.md | 81 +
.../table-and-view/table/SHOW-PARTITION-ID.md | 39 +
.../table-and-view/table/SHOW-PARTITION.md | 45 +
.../table-and-view/table/SHOW-PARTITIONS.md | 140 +
.../table-and-view/table/SHOW-TABLE-ID.md | 53 +
.../table-and-view/table/SHOW-TABLE-STATUS.md | 91 +
.../table-and-view/table/SHOW-TABLES.md | 99 +
.../table-and-view/table/TRUNCATE-TABLE.md | 78 +
.../table-and-view/view/ALTER-VIEW.md | 67 +
.../table-and-view/view/CREATE-VIEW.md | 87 +
.../table-and-view/view/DROP-VIEW.md | 44 +
.../table-and-view/view/SHOW-CREATE-VIEW.md | 54 +
.../table-and-view/view/SHOW-VIEW.md | 31 +
.../sql-manual/sql-statements/transaction/BEGIN.md | 42 +
.../sql-statements/transaction/COMMIT.md | 43 +
.../sql-statements/transaction/ROLLBACK.md | 43 +
.../sql-statements/transaction/SHOW-TRANSACTION.md | 82 +
.../sql-statements/types/SHOW-DATA-TYPES.md | 70 +
.../sql-statements/types/SHOW-TYPECAST.md | 82 +
.../table-design/auto-increment.md | 0
.../table-design/best-practice.md | 0
.../table-design/column-compression.md | 0
.../table-design/data-model/aggregate.md | 0
.../table-design/data-model/duplicate.md | 0
.../table-design/data-model/overview.md | 0
.../table-design/data-model/tips.md | 0
.../table-design/data-model/unique.md | 0
.../data-partitioning/auto-partitioning.md | 0
.../data-partitioning/basic-concepts.mdx | 0
.../data-partitioning/common-issues.md | 0
.../data-partitioning/data-bucketing.md | 0
.../data-partitioning/data-distribution.md | 0
.../data-partitioning/dynamic-partitioning.md | 0
.../data-partitioning/manual-partitioning.md | 0
.../table-design/data-type.md | 0
.../table-design/index/bitmap-index.md | 0
.../table-design/index/bloomfilter.md | 0
.../table-design/index/index-overview.md | 0
.../table-design/index/inverted-index.md | 0
.../table-design/index/inverted-index/overview.md | 0
.../table-design/index/ngram-bloomfilter-index.md | 0
.../table-design/index/prefix-index.md | 0
.../table-design/overview.md | 0
.../table-design/row-store.md | 0
.../table-design/schema-change.md | 0
.../table-design/temporary-table.md | 0
.../table-design/tiered-storage/overview.md | 0
.../table-design/tiered-storage/remote-storage.md | 0
.../table-design/tiered-storage/tiered-ssd-hdd.md | 0
versioned_sidebars/version-4.x-sidebars.json | 2584 ++++++++++++++++++
versions.json | 2 +-
3074 files changed, 240485 insertions(+), 13283 deletions(-)
diff --git a/.github/workflows/build-check.yml b/.github/workflows/build-check.yml
index b8801984eb5..ac609902a5c 100644
--- a/.github/workflows/build-check.yml
+++ b/.github/workflows/build-check.yml
@@ -70,10 +70,10 @@ jobs:
exit 1
fi
- - name: Build
- run: |
- npm install -g yarn
- yarn cache clean
- export NODE_OPTIONS=--max-old-space-size=8192
- yarn && yarn build
- rm -rf build
+ # - name: Build
+ # run: |
+ # npm install -g yarn
+ # yarn cache clean
+ # export NODE_OPTIONS=--max-old-space-size=8192
+ # yarn && yarn build
+ # rm -rf build
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x.json b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x.json
new file mode 100644
index 00000000000..fc78b93187f
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x.json
@@ -0,0 +1,798 @@
+{
+ "version.label": {
+ "message": "4.x",
+ "description": "The label for version current"
+ },
+ "sidebar.docs.category.Getting Started": {
+ "message": "快速开始",
+ "description": "The label for category Getting Started in sidebar docs"
+ },
+ "sidebar.docs.category.Tech Alternatives": {
+ "message": "技术对比",
+ "description": "The label for category Getting Started in sidebar docs"
+ },
+ "sidebar.docs.category.Guides": {
+ "message": "使用指南",
+ "description": "The label for category Guides in sidebar docs"
+ },
+ "sidebar.docs.category.Management": {
+ "message": "管理指南",
+ "description": "The label for category Management in sidebar docs"
+ },
+ "sidebar.docs.category.Reference": {
+ "message": "SQL 手册",
+ "description": "The label for category Reference in sidebar docs"
+ },
+ "sidebar.docs.category.Releases": {
+ "message": "版本发布",
+ "description": "The label for category Releases in sidebar docs"
+ },
+ "sidebar.docs.category.Tutorials": {
+ "message": "使用教程",
+ "description": "The label for category Tutorials in sidebar docs"
+ },
+ "sidebar.docs.category.Lakehouse Best Practices": {
+ "message": "湖仓一体最佳实践",
+ "description": "The label for category Lakehouse Best Practices in sidebar docs"
+ },
+ "sidebar.docs.category.Quick Start": {
+ "message": "快速体验",
+ "description": "The label for category Quick Start in sidebar docs"
+ },
+ "sidebar.docs.category.Installation and Deployment": {
+ "message": "安装部署",
+ "description": "The label for category Installation and Deployment in sidebar docs"
+ },
+ "sidebar.docs.category.Cluster Deployment": {
+ "message": "集群部署",
+ "description": "The label for category Cluster Deployment in sidebar docs"
+ },
+ "sidebar.docs.category.Deploying on Kubernetes": {
+ "message": "在 Kubernetes 部署",
+ "description": "The label for category Deploying on Kubernetes in sidebar docs"
+ },
+ "sidebar.docs.category.Integrated Storage Compute": {
+ "message": "部署存算一体集群",
+ "description": "The label for category Deploying on Kubernetes in sidebar docs"
+ },
+ "sidebar.docs.category.Separating Storage Compute": {
+ "message": "部署存算分离集群",
+ "description": "The label for category Deploying on Kubernetes in sidebar docs"
+ },
+ "sidebar.docs.category.Installation Preparation": {
+ "message": "部署前准备",
+ "description": "The label for category Installation Preparation in sidebar docs"
+ },
+ "sidebar.docs.category.Cluster Deployment Manually": {
+ "message": "手动部署集群",
+ "description": "The label for category Cluster Deployment Manually in sidebar docs"
+ },
+ "sidebar.docs.category.Deploying on Cloud": {
+ "message": "云上部署集群",
+ "description": "The label for category Deploying on Cloud in sidebar docs"
+ },
+ "sidebar.docs.category.Database Connection": {
+ "message": "数据库连接",
+ "description": "The label for category Database Connection in sidebar docs"
+ },
+ "sidebar.docs.category.Data Table Design": {
+ "message": "数据表设计",
+ "description": "The label for category Data Table Design in sidebar docs"
+ },
+ "sidebar.docs.category.Table Types": {
+ "message": "表类型",
+ "description": "The label for category Table Types in sidebar docs"
+ },
+ "sidebar.docs.category.Data Partitioning": {
+ "message": "数据划分",
+ "description": "The label for category Data Partitioning in sidebar docs"
+ },
+ "sidebar.docs.category.Table Indexes": {
+ "message": "表索引",
+ "description": "The label for category Table Index in sidebar docs"
+ },
+ "sidebar.docs.category.Text Search": {
+ "message": "文本搜索",
+ "description": "The label for category Text Search in sidebar docs"
+ },
+ "sidebar.docs.category.Inverted Index": {
+ "message": "倒排索引",
+ "description": "The label for category Inverted Index in sidebar docs"
+ },
+ "sidebar.docs.category.Data Manipulation": {
+ "message": "数据操作",
+ "description": "The label for category Data Manipulation in sidebar docs"
+ },
+ "sidebar.docs.category.Loading Data": {
+ "message": "数据导入",
+ "description": "The label for category Loading Data in sidebar docs"
+ },
+ "sidebar.docs.category.Data Update and Delete": {
+ "message": "数据更新与删除",
+ "description": "The label for category Data Update and Delete in sidebar docs"
+ },
+ "sidebar.docs.category.Complex Type": {
+ "message": "复杂类型",
+ "description": "The label for category Complex Type in sidebar docs"
+ },
+ "sidebar.docs.category.Data Source": {
+ "message": "数据源",
+ "description": "The label for category Data Source in sidebar docs"
+ },
+ "sidebar.docs.category.Loading Methods": {
+ "message": "导入方式",
+ "description": "The label for category Loading Methods in sidebar docs"
+ },
+ "sidebar.docs.category.File Formats": {
+ "message": "文件格式",
+ "description": "The label for category File Formats in sidebar docs"
+ },
+ "sidebar.docs.category.Complex Data Types": {
+ "message": "复杂数据类型",
+ "description": "The label for category Complex Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.Load Internals": {
+ "message": "导入原理",
+ "description": "The label for category Load Internals in sidebar docs"
+ },
+ "sidebar.docs.category.Updating Data": {
+ "message": "数据更新",
+ "description": "The label for category Update in sidebar docs"
+ },
+ "sidebar.docs.category.Deleting Data": {
+ "message": "数据删除",
+ "description": "The label for category Delete in sidebar docs"
+ },
+ "sidebar.docs.category.Exporting Data": {
+ "message": "数据导出",
+ "description": "The label for category Export in sidebar docs"
+ },
+ "sidebar.docs.category.Job Scheduler": {
+ "message": "作业调度",
+ "description": "The label for category job scheduler in sidebar docs"
+ },
+ "sidebar.releasenotes.category.Previous Release": {
+ "message": "历史版本",
+ "description": "The label for category Release notes in sidebar docs"
+ },
+ "sidebar.docs.category.Data Lakehouse": {
+ "message": "湖仓一体",
+ "description": "The label for category Data Lakehouse in sidebar docs"
+ },
+ "sidebar.docs.category.Data Catalogs": {
+ "message": "数据目录",
+ "description": "The label for category Data Catalogs in sidebar docs"
+ },
+ "sidebar.docs.category.Metastores": {
+ "message": "元数据服务",
+ "description": "The label for category Metastores in sidebar docs"
+ },
+ "sidebar.docs.category.Storages": {
+ "message": "存储服务",
+ "description": "The label for category Storages in sidebar docs"
+ },
+ "sidebar.docs.category.File Format": {
+ "message": "开放文件格式",
+ "description": "The label for category File Format in sidebar docs"
+ },
+ "sidebar.docs.category.SQL Dialect Convertor": {
+ "message": "SQL 方言转换",
+ "description": "The label for category SQL Dialect Convertor in sidebar docs"
+ },
+ "sidebar.docs.category.Data Queries": {
+ "message": "数据查询",
+ "description": "The label for category Data Queries in sidebar docs"
+ },
+ "sidebar.docs.category.User Defined Functions": {
+ "message": "自定义函数",
+ "description": "The label for category User Defined Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Queries Acceleration": {
+ "message": "查询加速",
+ "description": "The label for category Queries Acceleration in sidebar docs"
+ },
+ "sidebar.docs.category.Performance Tuning Overview": {
+ "message": "查询调优概述",
+ "description": "The label for category Performance Tuning Overview in sidebar docs"
+ },
+ "sidebar.docs.category.Materialize View": {
+ "message": "物化视图",
+ "description": "The label for category View and Materialize View in sidebar docs"
+ },
+ "sidebar.docs.category.Async-Materialized View": {
+ "message": "异步物化视图",
+ "description": "The label for category View and Materialize View in sidebar docs"
+ },
+ "sidebar.docs.category.Distincting Counts": {
+ "message": "高效去重",
+ "description": "The label for category Distincting Counts in sidebar docs"
+ },
+ "sidebar.docs.category.Hints": {
+ "message": "Hints",
+ "description": "The label for category Hints in sidebar docs"
+ },
+ "sidebar.docs.category.Tuning": {
+ "message": "查询优化实践",
+ "description": "The label for category Tuning in sidebar docs"
+ },
+ "sidebar.docs.category.Tuning Plan": {
+ "message": "计划调优",
+ "description": "The label for category Tuning Plan in sidebar docs"
+ },
+ "sidebar.docs.category.Tuning Execution": {
+ "message": "执行调优",
+ "description": "The label for category Tuning Execution in sidebar docs"
+ },
+ "sidebar.docs.category.Optimization Technology Principle": {
+ "message": "优化技术原理",
+ "description": "The label for category Optimization Technology Principle in sidebar docs"
+ },
+ "sidebar.docs.category.Security": {
+ "message": "安全合规",
+ "description": "The label for category Security in sidebar docs"
+ },
+ "sidebar.docs.category.Security Overview": {
+ "message": "安全概述",
+ "description": "The label for category Security Overview in sidebar docs"
+ },
+ "sidebar.docs.category.Encryption in Transit": {
+ "message": "传输加密",
+ "description": "The label for category Encryption in Transit in sidebar docs"
+ },
+ "sidebar.docs.category.Authentication and Authorization": {
+ "message": "认证与鉴权",
+ "description": "The label for category Authentication and Authorization in sidebar docs"
+ },
+ "sidebar.docs.category.Data Encryption": {
+ "message": "数据加密",
+ "description": "The label for category Data Encryption in sidebar docs"
+ },
+ "sidebar.docs.category.Authentication": {
+ "message": "身份认证",
+ "description": "The label for category Authentication in sidebar docs"
+ },
+ "sidebar.docs.category.Authorization": {
+ "message": "鉴权管控",
+ "description": "The label for category Authorization in sidebar docs"
+ },
+ "sidebar.docs.category.Alter Table": {
+ "message": "表结构变更",
+ "description": "The label for category Alter Table in sidebar docs"
+ },
+ "sidebar.docs.category.Doris Partition": {
+ "message": "Doris 表分区",
+ "description": "The label for category Doris Partition in sidebar docs"
+ },
+ "sidebar.docs.category.Best Practice": {
+ "message": "最佳实践",
+ "description": "The label for category Best Practice in sidebar docs"
+ },
+ "sidebar.docs.category.Ecosystem": {
+ "message": "生态扩展",
+ "description": "The label for category Ecosystem in sidebar docs"
+ },
+ "sidebar.docs.category.Doris Operator": {
+ "message": "Doris Operator",
+ "description": "The label for category Doris Operator in sidebar docs"
+ },
+ "sidebar.docs.category.BI and Database IDE": {
+ "message": "BI 与数据库 IDE",
+ "description": "The label for category BI and Database IDE in sidebar docs"
+ },
+ "sidebar.docs.category.Doris Manager": {
+ "message": "Doris Manager",
+ "description": "The label for category Doris Manager in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Doris": {
+ "message": "管理指南",
+ "description": "The label for category Managing Doris in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Cluster": {
+ "message": "集群管理",
+ "description": "The label for category Managing Cluster in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Disaster Recovery": {
+ "message": "容灾管理",
+ "description": "The label for category Managing Disaster Recovery in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Workload": {
+ "message": "负载管理",
+ "description": "The label for category Managing Workload in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Resource": {
+ "message": "资源管理",
+ "description": "The label for category Managing Resource in sidebar docs"
+ },
+ "sidebar.docs.category.Resource Isolation": {
+ "message": "资源隔离",
+ "description": "The label for category Resource Isolation in sidebar docs"
+ },
+ "sidebar.docs.category.Managing User Privilege": {
+ "message": "安全管理",
+ "description": "The label for category Managing User Privilege in sidebar docs"
+ },
+ "sidebar.docs.category.Trouble Shooting": {
+ "message": "故障诊断处理",
+ "description": "The label for category Trouble Shooting in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Memory": {
+ "message": "内存管理",
+ "description": "The label for category Managing Memory in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Memory Analysis": {
+ "message": "内存分析",
+ "description": "The label for category Managing Memory Analysis in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Memory Feature": {
+ "message": "内存特性",
+ "description": "The label for category Managing Memory Feature in sidebar docs"
+ },
+ "sidebar.docs.category.Log Management": {
+ "message": "日志管理",
+ "description": "The label for category Log Management in sidebar docs"
+ },
+ "sidebar.docs.category.Maintenance": {
+ "message": "运维监控",
+ "description": "The label for category Maintenance in sidebar docs"
+ },
+ "sidebar.docs.category.Managing Configuration": {
+ "message": "配置管理",
+ "description": "The label for category Config in sidebar docs"
+ },
+ "sidebar.docs.category.System Tables": {
+ "message": "系统表",
+ "description": "The label for category System Table in sidebar docs"
+ },
+ "sidebar.docs.category.information_schema": {
+ "message": "information_schema",
+ "description": "The label for category System Table in sidebar docs"
+ },
+ "sidebar.docs.category.mysql": {
+ "message": "mysql",
+ "description": "The label for category System Table in sidebar docs"
+ },
+ "sidebar.docs.category.__internal_schema": {
+ "message": "__internal_schema",
+ "description": "The label for category System Table in sidebar docs"
+ },
+ "sidebar.docs.category.OPEN API": {
+ "message": "OPEN API",
+ "description": "The label for category OPEN API in sidebar docs"
+ },
+ "sidebar.docs.category.FE HTTP API": {
+ "message": "FE HTTP API",
+ "description": "The label for category FE HTTP API in sidebar docs"
+ },
+ "sidebar.docs.category.BE HTTP API": {
+ "message": "BE HTTP API",
+ "description": "The label for category BE HTTP API in sidebar docs"
+ },
+ "sidebar.docs.category.Monitor Metrics": {
+ "message": "监控",
+ "description": "The label for category Monitor in sidebar docs"
+ },
+ "sidebar.docs.category.SQL Reference": {
+ "message": "SQL 手册",
+ "description": "The label for category SQL Manual in sidebar docs"
+ },
+ "sidebar.docs.category.SQL Functions": {
+ "message": "SQL 函数",
+ "description": "The label for category SQL Functions in sidebar docs"
+ },
+ "sidebar.docs.category.SQL Statements": {
+ "message": "SQL 语句",
+ "description": "The label for category SQL Statements in sidebar docs"
+ },
+ "sidebar.docs.category.Data Modification": {
+ "message": "数据修改",
+ "description": "The label for category Data Modification in sidebar docs"
+ },
+ "sidebar.docs.category.Load and Export": {
+ "message": "导入导出",
+ "description": "The label for category Load and Export in sidebar docs"
+ },
+ "sidebar.docs.category.Backup and Restore": {
+ "message": "备份恢复",
+ "description": "The label for category Backup and Restore in sidebar docs"
+ },
+ "sidebar.docs.category.Account Management": {
+ "message": "账户、角色和权限",
+ "description": "The label for category Account Management in sidebar docs"
+ },
+ "sidebar.docs.category.Session": {
+ "message": "会话",
+ "description": "The label for category Session in sidebar docs"
+ },
+ "sidebar.docs.category.Context": {
+ "message": "上下文",
+ "description": "The label for category Context in sidebar docs"
+ },
+ "sidebar.docs.category.Variable": {
+ "message": "变量",
+ "description": "The label for category Variable in sidebar docs"
+ },
+ "sidebar.docs.category.Query": {
+ "message": "查询",
+ "description": "The label for category Session in sidebar docs"
+ },
+ "sidebar.docs.category.Connection": {
+ "message": "连接",
+ "description": "The label for category Connection in sidebar docs"
+ },
+ "sidebar.docs.category.Transaction": {
+ "message": "事务",
+ "description": "The label for category Transaction in sidebar docs"
+ },
+ "sidebar.docs.category.Data Catalog": {
+ "message": "数据目录",
+ "description": "The label for category Catalog in sidebar docs"
+ },
+ "sidebar.docs.category.Database": {
+ "message": "数据库",
+ "description": "The label for category Database in sidebar docs"
+ },
+ "sidebar.docs.category.Table and Views": {
+ "message": "表和视图",
+ "description": "The label for category Table and Views in sidebar docs"
+ },
+ "sidebar.docs.category.Table": {
+ "message": "表",
+ "description": "The label for category Table in sidebar docs"
+ },
+ "sidebar.docs.category.Index": {
+ "message": "索引",
+ "description": "The label for category Index in sidebar docs"
+ },
+ "sidebar.docs.category.View": {
+ "message": "视图",
+ "description": "The label for category View in sidebar docs"
+ },
+ "sidebar.docs.category.Synchronous Materialized View": {
+ "message": "同步物化视图",
+ "description": "The label for category Materialized View in sidebar docs"
+ },
+ "sidebar.docs.category.Asynchronous Materialized View": {
+ "message": "异步物化视图",
+ "description": "The label for category Materialized View in sidebar docs"
+ },
+ "sidebar.docs.category.Data and Status Management": {
+ "message": "表数据和状态管理",
+ "description": "The label for category Data and Status Management in sidebar docs"
+ },
+ "sidebar.docs.category.Recycle": {
+ "message": "回收站",
+ "description": "The label for category DataRecyclebase in sidebar docs"
+ },
+ "sidebar.docs.category.Function": {
+ "message": "函数",
+ "description": "The label for category Function in sidebar docs"
+ },
+ "sidebar.docs.category.Statistics": {
+ "message": "统计信息",
+ "description": "The label for category Statistics in sidebar docs"
+ },
+ "sidebar.docs.category.Cluster Management": {
+ "message": "集群管理",
+ "description": "The label for category Statistics in sidebar docs"
+ },
+ "sidebar.docs.category.Instance Management": {
+ "message": "物理实例管理",
+ "description": "The label for category Instance in sidebar docs"
+ },
+ "sidebar.docs.category.Compute Management": {
+ "message": "计算资源管理",
+ "description": "The label for category Compute in sidebar docs"
+ },
+ "sidebar.docs.category.Storage Management": {
+ "message": "存储资源管理",
+ "description": "The label for category Storage in sidebar docs"
+ },
+ "sidebar.docs.category.Data Governance": {
+ "message": "数据治理",
+ "description": "The label for category Governance in sidebar docs"
+ },
+ "sidebar.docs.category.Job": {
+ "message": "后台任务",
+ "description": "The label for category Job in sidebar docs"
+ },
+ "sidebar.docs.category.Plugin": {
+ "message": "插件",
+ "description": "The label for category Plugin in sidebar docs"
+ },
+ "sidebar.docs.category.Character Set": {
+ "message": "字符集",
+ "description": "The label for category Character Set in sidebar docs"
+ },
+ "sidebar.docs.category.Types": {
+ "message": "类型",
+ "description": "The label for category Types in sidebar docs"
+ },
+ "sidebar.docs.category.Info System and Help": {
+ "message": "系统信息和帮助",
+ "description": "The label for category Info System and Help in sidebar docs"
+ },
+ "sidebar.docs.category.Basic Elements": {
+ "message": "基础元素",
+ "description": "The label for category Basic Elements in sidebar docs"
+ },
+ "sidebar.docs.category.SQL Data Types": {
+ "message": "SQL 类型",
+ "description": "The label for category SQL Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.AI Functions": {
+ "message": "AI 函数",
+ "description": "The label for category AI functions in sidebar docs"
+ },
+ "sidebar.docs.category.Scalar Functions": {
+ "message": "标量函数",
+ "description": "The label for category Scalar Functions in sidebar docs"
+ },
+ "sidebar.docs.category.String Functions": {
+ "message": "字符串函数",
+ "description": "The label for category String Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Date Functions": {
+ "message": "时间日期函数",
+ "description": "The label for category Date Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Numeric Functions": {
+ "message": "数值函数",
+ "description": "The label for category Numeric Functions in sidebar docs"
+ },
+ "sidebar.docs.category.GIS Functions": {
+ "message": "地理位置函数",
+ "description": "The label for category GIS Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Encryption Functions": {
+ "message": "加密和信息摘要函数",
+ "description": "The label for category Encryption Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Vector Distance Functions": {
+ "message": "向量函数",
+ "description": "The label for category vector distance functions in sidebar docs"
+ },
+ "sidebar.docs.category.LLM Functions": {
+ "message": "LLM 函数",
+ "description": "The label for category llm functions in sidebar docs"
+ },
+ "sidebar.docs.category.Bitwise Functions": {
+ "message": "位处理函数",
+ "description": "The label for category Bitwise Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Array Functions": {
+ "message": "ARRAY 函数",
+ "description": "The label for category Array Functions in sidebar docs"
+ },
+ "sidebar.docs.category.MAP Functions": {
+ "message": "MAP 函数",
+ "description": "The label for category MAP Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Struct Functions": {
+ "message": "STRUCT 函数",
+ "description": "The label for category Struct Functions in sidebar docs"
+ },
+ "sidebar.docs.category.JSON Functions": {
+ "message": "JSON 函数",
+ "description": "The label for category JSON Functions in sidebar docs"
+ },
+ "sidebar.docs.category.VARIANT Functions": {
+ "message": "VARIANT 函数",
+ "description": "The label for category VARIANT Functions in sidebar docs"
+ },
+ "sidebar.docs.category.IP Functions": {
+ "message": "IP 函数",
+ "description": "The label for category IP Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Bitmap Functions": {
+ "message": "BITMAP 函数",
+ "description": "The label for category Bitmap Functions in sidebar docs"
+ },
+ "sidebar.docs.category.HLL Functions": {
+ "message": "HLL 函数",
+ "description": "The label for category HLL Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Binary Functions": {
+ "message": "Binary 函数",
+ "description": "The label for category Binary Functions in sidebar docs"
+ },
+ "sidebar.docs.category.System Functions": {
+ "message": "系统函数",
+ "description": "The label for category System Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Other Functions": {
+ "message": "其他函数",
+ "description": "The label for category Other Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Quantile Functions": {
+ "message": "QUANTILE 函数",
+ "description": "The label for category Quantile Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Conditional Functions": {
+ "message": "条件函数",
+ "description": "The label for category Conditional Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Aggregate Functions": {
+ "message": "聚合函数",
+ "description": "The label for category Aggregate Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Combinators": {
+ "message": "函数 Combinators",
+ "description": "The label for category Combinators in sidebar docs"
+ },
+ "sidebar.docs.category.Table Functions": {
+ "message": "表函数",
+ "description": "The label for category Table Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Table Valued Functions": {
+ "message": "表值函数",
+ "description": "The label for category Table Valued Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Analytic (Window) Functions": {
+ "message": "分析函数 (窗口函数)",
+ "description": "The label for category Analytic(Window) Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Debug Functions": {
+ "message": "调试函数",
+ "description": "The label for category Debug Functions in sidebar docs"
+ },
+ "sidebar.docs.category.Cluster management": {
+ "message": "集群管理",
+ "description": "The label for category Cluster management in sidebar docs"
+ },
+ "sidebar.docs.category.DDL": {
+ "message": "DDL",
+ "description": "The label for category DDL in sidebar docs"
+ },
+ "sidebar.docs.category.Alter": {
+ "message": "Alter",
+ "description": "The label for category Alter in sidebar docs"
+ },
+ "sidebar.docs.category.Create": {
+ "message": "Create",
+ "description": "The label for category Create in sidebar docs"
+ },
+ "sidebar.docs.category.Drop": {
+ "message": "Drop",
+ "description": "The label for category Drop in sidebar docs"
+ },
+ "sidebar.docs.category.DML": {
+ "message": "DML",
+ "description": "The label for category DML in sidebar docs"
+ },
+ "sidebar.docs.category.Load": {
+ "message": "Load",
+ "description": "The label for category Load in sidebar docs"
+ },
+ "sidebar.docs.category.Manipulation": {
+ "message": "操作",
+ "description": "The label for category Manipulation in sidebar docs"
+ },
+ "sidebar.docs.category.Database Administration": {
+ "message": "数据库管理",
+ "description": "The label for category Database Administration in sidebar docs"
+ },
+ "sidebar.docs.category.Show": {
+ "message": "Show",
+ "description": "The label for category Show in sidebar docs"
+ },
+ "sidebar.docs.category.Aggregation Data Type": {
+ "message": "聚合类型",
+ "description": "The label for category Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.Datetime Data Type": {
+ "message": "日期类型",
+ "description": "The label for category Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.String Data Type": {
+ "message": "字符串类型",
+ "description": "The label for category Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.Numeric Data Type": {
+ "message": "数值类型",
+ "description": "The label for category Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.Semi-Structured Data Type": {
+ "message": "半结构化类型",
+ "description": "The label for category Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.IP Data Type": {
+ "message": "IP 类型",
+ "description": "The label for Data Types' conversion in sidebar docs"
+ },
+ "sidebar.docs.category.Conversion": {
+ "message": "类型转换",
+ "description": "The label for category Data Types in sidebar docs"
+ },
+ "sidebar.docs.category.Literal": {
+ "message": "字面量",
+ "description": "The label for category Literal in sidebar docs"
+ },
+ "sidebar.docs.category.Operators": {
+ "message": "操作符",
+ "description": "The label for category Operators in sidebar docs"
+ },
+ "sidebar.docs.category.Conditional Operators": {
+ "message": "条件操作符",
+ "description": "The label for category Conditional Operators in sidebar docs"
+ },
+ "sidebar.docs.category.Utility": {
+ "message": "辅助命令",
+ "description": "The label for category Utility in sidebar docs"
+ },
+ "sidebar.docs.category.FAQ": {
+ "message": "常见问题",
+ "description": "The label for category FAQ in sidebar docs"
+ },
+ "sidebar.docs.category.Benchmark": {
+ "message": "性能测试",
+ "description": "The label for category Benchmark in sidebar docs"
+ },
+ "sidebar.docs.category.Release notes": {
+ "message": "版本发布",
+ "description": "The label for category Release notes in sidebar docs"
+ },
+ "sidebar.docs.category.cluster management": {
+ "message": "集群管理",
+ "description": "The label for category cluster management in sidebar docs"
+ },
+ "sidebar.docs.category.System Table": {
+ "message": "System Table",
+ "description": "The label for category System Table in sidebar docs"
+ },
+ "sidebar.docs.category.HTTP API": {
+ "message": "HTTP API",
+ "description": "The label for category HTTP API in sidebar docs"
+ },
+ "sidebar.docs.category.Cloud Service Authentication": {
+ "message": "云服务认证接入",
+ "description": "The label for category Lakehouse.Cloud Service Authentication in sidebar docs"
+ },
+ "sidebar.docs.category.External Table": {
+ "message": "外部表",
+ "description": "The label for category Lakehouse.External Table in sidebar docs"
+ },
+ "sidebar.docs.category.Observability": {
+ "message": "可观测性",
+ "description": "Observability"
+ },
+ "sidebar.docs.category.Compute-Storage Decoupled": {
+ "message": "存算分离",
+ "description": "Compute-Storage Decoupled"
+ },
+ "sidebar.docs.category.File Cache": {
+ "message": "文件缓存",
+ "description": "File Cache"
+ },
+ "sidebar.ecosystem.category.BI and Database IDE": {
+ "message": "BI 与数据库 IDE",
+ "description": "The label for category BI and Database IDE in sidebar docs"
+ },
+ "sidebar.get-starting.category.Tutorials": {
+ "message": "使用教程",
+ "description": "The label for category Tutorials in sidebar docs"
+ },
+ "sidebar.get-starting.category.Building lakehouse": {
+ "message": "数据湖构建",
+ "description": "The label for category Building lakehouse in sidebar docs"
+ },
+ "sidebar.docs.category.Cross Cluster Replication": {
+ "message": "跨集群复制",
+ "description": "The label for category Cross Cluster Replication in sidebar docs"
+ },
+ "sidebar.docs.category.Tiered Storage": {
+ "message": "冷热数据分层",
+ "description": "The label for category Tiered Storage in sidebar docs"
+ },
+ "sidebar.docs.category.Business Continuity & Data Recovery": {
+ "message": "业务连续性和数据恢复",
+ "description": "The label for category Business Continuity & Data Recovery in sidebar docs"
+ },
+ "sidebar.docs.category.Backup & Restore": {
+ "message": "备份与恢复",
+ "description": "The label for category Backup & Restore in sidebar docs"
+ },
+ "sidebar.docs.category.Integrations": {
+ "message": "集成",
+ "description": "The label for category Integrations in sidebar docs"
+ }
+}
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/audit-plugin.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/audit-plugin.md
new file mode 100644
index 00000000000..01892ce9541
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/audit-plugin.md
@@ -0,0 +1,69 @@
+---
+{
+ "title": "审计日志",
+ "language": "zh-CN"
+}
+---
+
+Doris 提供了对于数据库操作的审计能力,可以记录用户对数据库的登陆、查询、修改操作。在 Doris 中,可以直接通过内置系统表查询审计日志,也可以直接查看 Doris 的审计日志文件。
+
+## 开启审计日志
+
+通过全局变量 `enable_audit_plugin` 可以随时开启或关闭审计日志插件(默认为关闭状态),如:
+
+`set global enable_audit_plugin = true;`
+
+开启后,Doris 会将开启后的审计日志写入 `audit_log` 表。
+
+可以随时关闭审计日志插件:
+
+`set global enable_audit_plugin = false;`
+
+关闭后,Doris 将会停止 `audit_log` 表的写入。已写入的审计日志不会变化。
+
+## 查看审计日志表
+
+:::caution 注意
+
+在 2.1.8 版本之前,随着系统版本的升级,审计日志字段会有增加,在升级后需要根据审计日志表中的字段,通过 `ALTER TALBE` 命令为 `audit_log` 表增加字段。
+
+:::
+
+从 Doris 2.1 版本开始,Doirs 可以通过开启审计日志功能,将用户行为操作写入到 `__internal_schema` 库的 [`audit_log`](../admin-manual/system-tables/internal_schema/audit_log) 表中。
+
+审计日志表是一张动态分区表,按天进行分区,默认保留最近 30 天的数据。可以通过 ALTER TABLE 语句修改动态分区的 `dynamic_partition.start` 属性调整动态分区的保留天数。
+
+## 审计日志文件
+
+在 fe.conf 中,`LOG_DIR` 定义了 FE 日志的存储路径。在 `${LOG_DIR}/fe.audit.log` 中记录了这台 FE 节点执行的所有数据库操作。如果需要查看集群所有的操作,需要遍历每一台 FE 的审计日志。
+
+## 审计日志格式
+
+在 3.0.7 之前的版本的版本中,用户执行语句中的 `\n`, `\t`, `\r` 符号会把替换成 `\\n`, `\\t`, `\\r`。之后存储在 `fe.audit.log` 日志和 `audit_log` 表中。
+
+3.0.7 开始,对于 `fe.audit.log` 日志,用户执行语句中仅 `\n` 会被替换成 `\\n`。而 `audit_log` 表存储的是原始的语句格式。
+
+## 审计日志相关配置
+
+**全局变量:**
+
+可以通过 `set [global] <var_name> = <var_value>` 修改审计日志变量。
+
+| 变量 | 默认值 | 说明 |
+| ------------------------------------- | ----- | ---------------- |
+| `audit_plugin_max_batch_interval_sec` | 60 秒 | 审计日志表的最大写入间隔。 |
+| `audit_plugin_max_batch_bytes` | 50MB | 审计日志表每批次最大写入数据量 |
+| `audit_plugin_max_sql_length` | 4096 | 审计日志表里记录的语句的最大长度 |
+| `audit_plugin_load_timeout` | 600 秒 | 审计日志导入作业的默认超时时间 |
+| `audit_plugin_max_insert_stmt_length` | Int.MAX | 针对 `INSERT` 语句最大长度限制。如果大于 `audit_plugin_max_sql_length`,则使用 `audit_plugin_max_sql_length` 的值。该参数自 3.0.6 支持。 |
+
+因为某些 `INSERT INTO VALUES` 语句可能过长切提交频繁,导致设计日志膨胀。因此,Doris 在 3.0.6 版本新增了 `audit_plugin_max_insert_stmt_length` 用于单独限制 `INSERT` 语句的审计长度。避免审计日志膨胀,同时可以保证 SQL 语句被完整审计。
+
+**FE 配置项:**
+
+通过修改 fe.conf 目录可以修改 FE 配置项。
+
+| 配置项 | 说明 |
+| ---------------------- | ---------------------------------------------------------------------------- |
+| `skip_audit_user_list` | 如果不希望某些用户的操作被审计日志记录,可以通过这个配置修改(自 3.0.01 支持)。如通过以下配置屏蔽 user1 与 user2 的审计日志记录: `skip_audit_user_list=user1,user2`|
+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication-and-authorization.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication-and-authorization.md
new file mode 100644
index 00000000000..8df42d28ceb
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication-and-authorization.md
@@ -0,0 +1,381 @@
+---
+{
+ "title": "认证与鉴权概述",
+ "language": "zh-CN"
+}
+---
+
+Doris 的权限管理系统参照了 MySQL 的权限管理机制,做到了行级别细粒度的权限控制,基于角色的权限访问控制,并且支持白名单机制。
+
+## 名词解释
+
+1. 用户标识 User Identity
+
+ 在权限系统中,一个用户被识别为一个 User Identity(用户标识)。用户标识由两部分组成:`username` 和 `host`。其中 `username` 为用户名,由英文大小写组成。`host` 表示该用户链接来自的 IP。User Identity 以 `username@'host'` 的方式呈现,表示来自 `host` 的 `username`。
+
+ User Identity 的另一种表现方式为 `username@['domain']`,其中 `domain` 为域名,可以通过 DNS 解析为一组 IP。最终表现为一组 `username@'host'`,所以后面我们统一使用 `username@'host'` 来表示。
+
+2. 权限 Privilege
+
+ 权限作用的对象是节点、数据目录、数据库或表。不同的权限代表不同的操作许可。
+
+3. 角色 Role
+
+ Doris 可以创建自定义命名的角色。角色可以被看做是一组权限的集合。新创建的用户可以被赋予某一角色,则自动被赋予该角色所拥有的权限。后续对角色的权限变更,也会体现在所有属于该角色的用户权限上。
+
+4. 用户属性 User Property
+
+ 用户属性直接附属于某一用户,而不是用户标识。即 `user@'192.%'` 和 `user@['domain']` 都拥有同一组用户属性,该属性属于用户 `user`,而不是 `user@'192.%'` 或 `user@['domain']`。
+
+ 用户属性包括但不限于:用户最大连接数、导入集群配置等等。
+
+## 认证和鉴权框架
+
+用户登录 Apache Doris 的过程,分为**认证**和**鉴权**两部分。
+
+- 认证:根据用户提供的凭据(如用户名、客户 IP、密码)等,进行身份验证。验证通过后,会将用户个体映射到系统内的用户标识(User Identity)上。
+- 鉴权:基于获取到的用户标识,根据用户标识所对应的权限,检查用户是否有相应操作的权限。
+
+## 认证
+
+Doris 支持内置认证方案和以及 LDAP 的认证方案。
+
+### Doris 内置认证方案
+
+基于 Doris 自身存储的用户名,密码等信息来认证。
+
+管理员通过 `CREATE USER` 命令来创建用户,通过 `SHOW ALL GRANTS` 来查看创建的所有用户。
+
+用户登录时,会判断用户名,密码及客户端的 IP 地址是否正确。
+
+#### 密码策略
+
+Doris 支持以下密码策略,可以帮助用户更好的进行密码管理。
+
+1. `PASSWORD_HISTORY`
+
+ 是否允许当前用户重置密码时使用历史密码。如 `PASSWORD_HISTORY 10` 表示禁止使用过去 10 次设置过的密码为新密码。如果设置为 `PASSWORD_HISTORY DEFAULT`,则会使用全局变量 `password_history` 中的值。0 表示不启用这个功能。默认为 0。
+
+ 示例:
+
+ - 设置全局变量:`SET GLOBAL password_history = 10`
+ - 为用户设置:`ALTER USER user1@'ip' PASSWORD_HISTORY 10`
+
+2. `PASSWORD_EXPIRE`
+
+ 设置当前用户密码的过期时间。如 `PASSWORD_EXPIRE INTERVAL 10 DAY` 表示密码会在 10 天后过期。`PASSWORD_EXPIRE NEVER` 表示密码不过期。如果设置为 `PASSWORD_EXPIRE DEFAULT`,则会使用全局变量 `default_password_lifetime` 中的值(单位为 天)。默认为 NEVER(或 0),表示不会过期。
+
+ 示例:
+
+ - 设置全局变量:`SET GLOBAL default_password_lifetime = 1`
+ - 为用户设置:`ALTER USER user1@'ip' PASSWORD_EXPIRE INTERVAL 10 DAY`
+
+3. `FAILED_LOGIN_ATTEMPTS` 和 `PASSWORD_LOCK_TIME`
+
+ 设置当前用户登录时,如果使用错误的密码登录 n 次后,账户将被锁定,并设置锁定时间。如 `FAILED_LOGIN_ATTEMPTS 3 PASSWORD_LOCK_TIME 1 DAY` 表示如果 3 次错误登录,则账户会被锁定一天。管理员可以通过 `ALTER USER` 语句主动解锁被锁定的账户。
+
+ 示例:
+
+ - 为用户设置:`ALTER USER user1@'ip' FAILED_LOGIN_ATTEMPTS 3 PASSWORD_LOCK_TIME 1 DAY`
+
+4. 密码强度
+
+ 该功能由全局变量 `validate_password_policy` 控制。默认为 `NONE/0`,即不检查密码强度。如果设置为 `STRONG/2`,则密码必须包含“大写字母”,“小写字母”,“数字”和“特殊字符”中的 3 项,并且长度必须大于等于 8。
+
+ 示例:
+
+ - `SET validate_password_policy=STRONG`
+
+更多帮助,请参阅[ALTER USER](../../sql-manual/sql-statements/account-management/ALTER-USER)。
+
+### 基于 LDAP 的认证方案
+
+请参阅[基于 LDAP 的认证方案](./ldap.md)。
+
+## 鉴权
+
+### 权限操作
+
+- 创建用户:[CREATE USER](../../sql-manual/sql-statements/account-management/CREATE-USER)
+- 修改用户:[ALTER USER](../../sql-manual/sql-statements/account-management/ALTER-USER)
+- 删除用户:[DROP USER](../../sql-manual/sql-statements/account-management/DROP-USER)
+- 授权/分配角色:[GRANT](../../sql-manual/sql-statements/account-management/GRANT-TO)
+- 撤权/撤销角色:[REVOKE](../../sql-manual/sql-statements/account-management/REVOKE-FROM)
+- 创建角色:[CREATE ROLE](../../sql-manual/sql-statements/account-management/CREATE-ROLE)
+- 删除角色:[DROP ROLE](../../sql-manual/sql-statements/account-management/DROP-ROLE)
+- 修改角色:[ALTER ROLE](../../sql-manual/sql-statements/account-management/ALTER-ROLE)
+- 查看当前用户权限和角色:[SHOW GRANTS](../../sql-manual/sql-statements/account-management/SHOW-GRANTS)
+- 查看所有用户权限和角色:[SHOW ALL GRANTS](../../sql-manual/sql-statements/account-management/SHOW-GRANTS)
+- 查看已创建的角色:[SHOW ROLES](../../sql-manual/sql-statements/account-management/SHOW-ROLES)
+- 设置用户属性:[SET PROPERTY](../../sql-manual/sql-statements/account-management/SET-PROPERTY)
+- 查看用户属性:[SHOW PROPERTY](../../sql-manual/sql-statements/account-management/SHOW-PROPERTY)
+- 修改密码:[SET PASSWORD](../../sql-manual/sql-statements/account-management/SET-PASSWORD)
+- 查看支持的所有权限项:[SHOW PRIVILEGES]
+- 查看行权限策略 [SHOW ROW POLICY]
+- 创建行权限策略 [CREATE ROW POLICY]
+
+### 权限类型
+
+Doris 目前支持以下几种权限
+
+1. `Node_priv`
+
+ 节点变更权限。包括 FE、BE、BROKER 节点的添加、删除、下线等操作。
+
+ Root 用户默认拥有该权限。同时拥有 `Grant_priv` 和 `Node_priv` 的用户,可以将该权限赋予其他用户。
+
+ 该权限只能赋予 Global 级别。
+
+2. `Grant_priv`
+
+ 权限变更权限。允许执行包括授权、撤权、添加/删除/变更 用户/角色 等操作。
+
+ 给其他用户/角色授权时,2.1.2 版本之前,当前用户只需要相应层级的 `Grant_priv` 权限,2.1.2 版本之后当前用户也要有想要授权的资源的权限。
+
+ 给其他用户分配角色时,要有 Global 级别的 `Grant_priv` 权限。
+
+3. `Select_priv`
+
+ 对数据目录、数据库、表的只读权限。
+
+4. `Load_priv`
+
+ 对数据目录、数据库、表的写权限。包括 Load、Insert、Delete 等。
+
+5. `Alter_priv`
+
+ 对数据目录、数据库、表的更改权限。包括重命名 库/表、添加/删除/变更 列、添加/删除 分区等操作。
+
+6. `Create_priv`
+
+ 创建数据目录、数据库、表、视图的权限。
+
+7. `Drop_priv`
+
+ 删除数据目录、数据库、表、视图的权限。
+
+8. `Usage_priv`
+
+ Resource 和 Workload Group 的使用权限。
+
+9. `Show_view_priv`
+
+ 执行 `SHOW CREATE VIEW` 的权限。
+
+### 权限层级
+
+#### 全局权限
+
+即通过 GRANT 语句授予的 `*.*.*` 上的权限。被授予的权限适用于任意 Catalog 中的任意库表。
+
+#### 数据目录(Catalog)权限
+
+即通过 GRANT 语句授予的 `ctl.*.*` 上的权限。被授予的权限适用于指定 Catalog 中的任意库表。
+
+#### 库级权限
+
+即通过 GRANT 语句授予的 `ctl.db.*` 上的权限。被授予的权限适用于指定数据库中的任意表。
+
+#### 表级权限
+
+即通过 GRANT 语句授予的 `ctl.db.tbl` 上的权限。被授予的权限适用于指定表的任意列。
+
+#### 列级权限
+
+列权限主要用于限制用户对数据表中某些列的访问权限。具体来说,列权限允许管理员设定某些列的查看、编辑等权限,以控制用户对特定列数据的访问和操作。
+
+可以通过 `GRANT Select_priv(col1,col2) ON ctl.db.tbl TO user1` 授予的指定表的部分列的权限。
+
+目前列权限仅支持 `Select_priv`。
+
+#### 行级权限
+
+行权限(Row Policy)使得管理员能够基于数据的某些字段来定义访问策略,从而控制哪些用户可以访问哪些数据行。
+
+具体来说,Row Policy 允许管理员创建规则,这些规则可以基于存储在数据中的实际值来过滤或限制用户对行的访问。
+
+从 1.2 版本开始,可以通过 `CREATE ROW POLICY` 命令创建行级权限。
+
+从 2.1.2 版本开始,支持通过 Apache Ranger 的 `Row Level Filter` 来设置行权限。
+
+#### 使用权限
+
+- Resource 权限
+
+ Resource 权限是为 Resource 单独设置的权限,和库表等权限没有关系,只能分配 `Usage_priv` 和 `Grant_priv` 权限。
+
+ 给所有 Resource 分配权限可以通过 `GRANT USAGE_PRIV ON RESOURCE '%' TO user1` 语句。
+
+- Workload Group 权限
+
+ Workload Group 权限是为 Workload Group 单独设置的权限,和库表等权限没有关系,只能分配 `Usage_priv` 和 `Grant_priv` 权限。
+
+ 给所有 Workload Group 分配权限可以通过 `GRANT USAGE_PRIV ON WORKLOAD GROUP '%' TO user1` 语句。
+
+### 数据脱敏
+
+数据脱敏是一种保护敏感数据的方法,它通过对原始数据进行修改、替换或隐藏,使得脱敏后的数据在保持一定格式和特性的同时,不再包含敏感信息。
+
+例如,管理员可以选择将信用卡号、身份证号等敏感字段的部分或全部数字替换为星号 `*` 或其他字符,或者将真实姓名替换为假名。
+
+从 2.1.2 版本开始,支持通过 Apache Ranger 的 Data Masking 来为某些列设置脱敏策略,目前仅支持通过 [Apache Ranger](./ranger.md) 来设置。
+
+### Doris 内置的鉴权方案
+
+Doris 权限设计基于 RBAC(Role-Based Access Control)的权限管理模型,用户和角色关联,角色和权限关联,用户通过角色间接和权限关联。
+
+当角色被删除时,用户自动失去该角色的所有权限。
+
+当用户和角色取消关联,用户自动失去角色的所有权限。
+
+当角色的权限被增加或删除,用户的权限也会随之变更。
+
+```
+┌────────┐ ┌────────┐ ┌────────┐
+│ user1 ├────┬───► role1 ├────┬────► priv1 │
+└────────┘ │ └────────┘ │ └────────┘
+ │ │
+ │ │
+ │ ┌────────┐ │
+ │ │ role2 ├────┤
+┌────────┐ │ └────────┘ │ ┌────────┐
+│ user2 ├────┘ │ ┌─► priv2 │
+└────────┘ │ │ └────────┘
+ ┌────────┐ │ │
+ ┌──────► role3 ├────┘ │
+ │ └────────┘ │
+ │ │
+ │ │
+┌────────┐ │ ┌────────┐ │ ┌────────┐
+│ userN ├─┴──────► roleN ├───────┴─► privN │
+└────────┘ └────────┘ └────────┘
+```
+
+如上图所示:
+
+user1 和 user2 都是通过 role1 拥有了 priv1 的权限。
+
+userN 通过 role3 拥有了 priv1 的权限,通过 roleN 拥有了 priv2 和 privN 的权限,因此 userN 同时拥有 priv1,priv2 和 privN 的权限。
+
+为了方便用户操作,是可以直接给用户授权的,底层实现上,是为每个用户创建了一个专属于该用户的默认角色,当给用户授权时,实际上是在给该用户的默认角色授权。
+
+默认角色不能被删除,不能被分配给其他人,删除用户时,默认角色也自动删除。
+
+### 基于 Apache Ranger 的鉴权方案
+
+请参阅[基于 Apache Ranger 的鉴权方案](./ranger.md)
+
+## 常见问题
+
+### 权限项说明
+
+1. 拥有 ADMIN 权限,或 GLOBAL 层级的 GRANT 权限的用户可以进行以下操作:
+
+ - CREATE USER
+ - DROP USER
+ - ALTER USER
+ - SHOW GRANTS
+ - CREATE ROLE
+ - DROP ROLE
+ - ALTER ROLE
+ - SHOW ROLES
+ - SHOW PROPERTY FOR USER
+
+2. GRANT/REVOKE
+
+ - 拥有 ADMIN 权限,可以授予或撤销任意用户的权限。
+ - 拥有 ADMIN 或 GLOBAL 层级 GRANT 权限可以把角色分配给用户。
+ - 同时拥有相应层级的 GRANT 权限和要分配的权限,可以把权限分配给用户/角色。
+
+3. SET PASSWORD
+
+ - 拥有 ADMIN 权限,或者 GLOBAL 层级 GRANT 权限的用户,可以设置非 ROOT 用户的密码。
+ - 普通用户可以设置自己对应的 User Identity 的密码。自己对应的 User Identity 可以通过 `SELECT CURRENT_USER()` 命令查看。
+ - ROOT 用户可以修改自己的密码。
+
+### 其他说明
+
+1. Doris 初始化时,会自动创建如下用户和角色:
+
+ - operator 角色:该角色拥有 `Node_priv` 和 `Admin_priv`,即对 Doris 的所有权限。
+ - admin 角色:该角色拥有 `Admin_priv`,即除节点变更以外的所有权限。
+ - root@'%':root 用户,允许从任意节点登陆,角色为 operator。
+ - admin@'%':admin 用户,允许从任意节点登陆,角色为 admin。
+
+2. 不支持删除或更改默认创建的用户,角色或用户的权限。
+ - 不支持删除 root@'%' 和 admin@'%' 用户,但是允许创建和删除 root@'xxx' 和 admin@'xxx' 用户(xxx 指的是除了 % 之外的 host)(Doris 会把这些用户视为普通用户)
+ - 不支持撤销 root@'%' 和 admin@'%' 的默认角色
+ - 不支持删除角色 operator 和 admin
+ - 不支持操作角色 operator 和 admin 的权限
+
+3. operator 角色的用户有且只有一个,即 Root。admin 角色的用户可以创建多个。
+
+4. 一些可能产生冲突的操作说明
+
+ 1. 域名与 ip 冲突:
+
+ 假设创建了如下用户:
+
+ `CREATE USER user1@['domain'];`
+
+ 并且授权:
+
+ `GRANT SELECT_PRIV ON *.* TO user1@['domain']`
+
+ 该 domain 被解析为两个 IP:ip1 和 ip2。
+
+ 假设之后,我们对 `user1@'ip1'` 进行一次单独授权:
+
+ `GRANT ALTER_PRIV ON . TO user1@'ip1';`
+
+ 则 `user1@'ip1'` 的权限会被修改为 Select_priv 和 Alter_priv。并且当我们再次变更 `user1@['domain']` 的权限时,`user1@'ip1'` 也不会跟随改变。
+
+ 2. 重复 ip 冲突:
+
+ 假设创建了如下用户:
+
+ ```
+ CREATE USER user1@'%' IDENTIFIED BY "12345";
+ CREATE USER user1@'192.%' IDENTIFIED BY "abcde";
+ ```
+
+ 在优先级上,`'192.%'` 优先于 `'%'`,因此,当用户 `user1` 从 `192.168.1.1` 这台机器尝试使用密码 `'12345'` 登陆 Doris 会被拒绝。
+
+5. 忘记密码
+
+ 如果忘记了密码无法登陆 Doris,可以在 FE 的 config 文件中添加 `skip_localhost_auth_check=true` 参数,并且重启 FE,从而无密码在本机通过 root 登陆 Doris。
+
+ 登陆后,可以通过 `SET PASSWORD` 命令重置密码。
+
+6. 任何用户都不能重置 root 用户的密码,除了 root 用户自己。
+
+7. `Admin_priv` 权限只能在 GLOBAL 层级授予或撤销。
+
+8. `current_user()` 和 `user()`
+
+ 用户可以通过 `SELECT current_user()` 和 `SELECT user()` 分别查看 `current_user` 和 `user`。其中 `current_user` 表示当前用户是以哪种身份通过认证系统的,而 `user` 则是用户当前实际的 User Identity。
+
+ 举例说明:
+
+ 假设创建了 `user1@'192.%'` 这个用户,然后以为来自 `192.168.10.1` 的用户 `user1` 登陆了系统,则此时的 `current_user` 为 `user1@'192.%'`,而 `user` 为 `user1@'192.168.10.1'`。
+
+ 所有的权限都是赋予某一个 `current_user` 的,真实用户拥有对应的 `current_user` 的所有权限。
+
+## 最佳实践
+
+这里举例一些 Doris 权限系统的使用场景。
+
+1. 场景一
+
+ Doris 集群的使用者分为管理员(Admin)、开发工程师(RD)和用户(Client)。其中管理员拥有整个集群的所有权限,主要负责集群的搭建、节点管理等。开发工程师负责业务建模,包括建库建表、数据的导入和修改等。用户访问不同的数据库和表来获取数据。
+
+ 在这种场景下,可以为管理员赋予 ADMIN 权限或 GRANT 权限。对 RD 赋予对任意或指定数据库表的 CREATE、DROP、ALTER、LOAD、SELECT 权限。对 Client 赋予对任意或指定数据库表 SELECT 权限。同时,也可以通过创建不同的角色,来简化对多个用户的授权操作。
+
+2. 场景二
+
+ 一个集群内有多个业务,每个业务可能使用一个或多个数据。每个业务需要管理自己的用户。在这种场景下。管理员用户可以为每个数据库创建一个拥有 DATABASE 层级 GRANT 权限的用户。该用户仅可以对用户进行指定的数据库的授权。
+
+3. 黑名单
+
+ Doris 本身不支持黑名单,只有白名单功能,但我们可以通过某些方式来模拟黑名单。假设先创建了名为 `user@'192.%'` 的用户,表示允许来自 `192.*` 的用户登录。此时如果想禁止来自 `192.168.10.1` 的用户登录。则可以再创建一个用户 `cmy@'192.168.10.1'` 的用户,并设置一个新的密码。因为 `192.168.10.1` 的优先级高于 `192.%`,所以来自 `192.168.10.1` 将不能再使用旧密码进行登录。
+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication/federation.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication/federation.md
new file mode 100644
index 00000000000..2f98b77da0e
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication/federation.md
@@ -0,0 +1,201 @@
+---
+{
+"title": "联邦认证",
+"language": "zh-CN"
+}
+---
+
+## LDAP
+接入第三方 LDAP 服务为 Doris 提供验证登录和组授权服务。
+### LDAP 验证登录
+LDAP 验证登录指的是接入 LDAP 服务的密码验证来补充 Doris 的验证登录。Doris 优先使用 LDAP 验证用户密码,如果 LDAP 服务中不存在该用户则继续使用 Doris 验证密码,如果 LDAP 密码正确但是 Doris 中没有对应账户则创建临时用户登录 Doris。
+
+开启 LDAP 后,用户在 Doris 和 LDAP 中存在以下几种情况:
+
+| LDAP 用户 | Doris 用户 | 密码 | 登录情况 | 登录 Doris 的用户 |
+| -------- | --------- | --------- | -------- | --------------- |
+| 存在 | 存在 | LDAP 密码 | 登录成功 | Doris 用户 |
+| 存在 | 存在 | Doris 密码 | 登录失败 | 无 |
+| 不存在 | 存在 | Doris 密码 | 登录成功 | Doris 用户 |
+| 存在 | 不存在 | LDAP 密码 | 登录成功 | Ldap 临时用户 |
+
+开启 LDAP 后,用户使用 mysql client 登录时,Doris 会先通过 LDAP 服务验证用户密码,如果 LDAP 存在用户且密码正确,Doris 则使用该用户登录;此时 Doris 若存在对应账户则直接登录该账户,如果不存在对应账户则为用户创建临时账户并登录该账户。临时账户具有具有相应对权限(参见 LDAP 组授权),仅对当前连接有效,doris 不会创建该用户,也不会产生创建用户对元数据。
+如果 LDAP 服务中不存在登录用户,则使用 Doris 进行密码认证。
+
+以下假设已开启 LDAP 认证,配置 ldap_user_filter = (&(uid={login})),且其他配置项都正确,客户端设置环境变量 LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN=1
+
+例如:
+
+1. Doris 和 LDAP 中都存在账户:
+
+ 存在 Doris 账户:`jack@'172.10.1.10'`,密码:`123456`
+
+ LDAP 用户节点存在属性:`uid: jack` 用户密码:`abcdef`
+
+ 使用以下命令登录 Doris 可以登录 `jack@'172.10.1.10'` 账户:
+
+ ```sql
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p abcdef
+ ```
+
+ 使用以下命令将登录失败:
+
+ ```sql
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p 123456
+ ```
+
+2. LDAP 中存在用户,Doris 中不存在对应账户:
+
+ LDAP 用户节点存在属性:`uid: jack` 用户密码:`abcdef`
+
+ 使用以下命令创建临时用户并登录 jack@'%',临时用户具有基本权限 DatabasePrivs:Select_priv,用户退出登录后 Doris 将删除该临时用户:
+
+ ```sql
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p abcdef
+ ```
+
+3. LDAP 不存在用户:
+
+ 存在 Doris 账户:`jack@'172.10.1.10'`,密码:`123456`
+
+ 使用 Doris 密码登录账户,成功:
+
+ ```sql
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p 123456
+ ```
+### LDAP 组授权
+DLAP 用户 dn 是 LDAP 组节点的“member”属性则 Doris 认为用户属于该组。LDAP 组授权是将 LDAP 中的 group 映射到 Doris 中的 role,并将所有对应的 role 权限授予登录用户,用户退出登录后 Doris 会撤销对应的 role 权限。在使用 LDAP 组授权前应该在 Doris 中创建相应的 role,并为 role 授权。
+
+登录用户权限跟 Doris 用户和组权限有关,见下表:
+
+| LDAP 用户 | Doris 用户 | 登录用户的权限 |
+| -------- | --------- | -------------------------- |
+| 存在 | 存在 | LDAP 组权限 + Doris 用户权限 |
+| 不存在 | 存在 | Doris 用户权限 |
+| 存在 | 不存在 | LDAP 组权限 |
+
+如果登录的用户为临时用户,且不存在组权限,则该用户默认具有 information_schema 的 select_priv 权限
+
+举例:
+
+LDAP 用户 dn 是 LDAP 组节点的 `member` 属性则认为用户属于该组,Doris 会截取组 dn 的第一个 Rdn 作为组名。
+
+例如用户 dn 为 `uid=jack,ou=aidp,dc=domain,dc=com`,组信息如下:
+
+```text
+dn: cn=doris_rd,ou=group,dc=domain,dc=com
+objectClass: groupOfNames
+member: uid=jack,ou=aidp,dc=domain,dc=com
+```
+
+则组名为 `doris_rd`。
+
+假如 jack 还属于 LDAP 组 `doris_qa`、`doris_pm`;Doris 存在 role:`doris_rd`、`doris_qa`、`doris_pm`,在使用 LDAP 验证登录后,用户不但具有该账户原有的权限,还将获得 role `doris_rd`、`doris_qa` 和 `doris_pm` 的权限。
+
+>注意:
+>
+> user 属于哪个 group 和 LDAP 树的组织结构无关,示例部分的 user2 并不一定属于 group2
+> 若想让 user2 属于 group2,需要在 group2 的 member 属性中添加 user2
+### LDAP 示例
+#### 更改 Doris 配置
+1. 在 fe/conf/fe.conf 文件中配置认证方式为 ldap authentication_type=ldap。
+2. 在 fe/conf/ldap.conf 文件中配置 LDAP 基本信息,
+3. 设置 LDAP 管理员密码:配置好 ldap.conf 文件后启动 fe,使用 root 或 admin 账号登录 Doris,执行 sql
+
+```sql
+set ldap_admin_password = password('ldap_admin_password');
+```
+#### 使用 mysql 客户端登录
+ ```sql
+ mysql -hDORIS_HOST -PDORIS_PORT -u user -p --enable-cleartext-plugin
+ 输入 ldap 密码
+ ```
+注:使用其它客户端登录可以参考下文中 客户端如何使用明文登录
+### LDAP 信息缓存
+
+为了避免频繁访问 LDAP 服务,Doris 会将 LDAP 信息缓存到内存中,可以通过 ldap.conf 中的 ldap_user_cache_timeout_s 配置项指定 LDAP 用户的缓存时间,默认为 12 小时;在修改了 LDAP 服务中的信息或者修改了 Doris 中 LDAP 用户组对应的 Role 权限后,可能因为缓存而没有及时生效,可以通过 refresh ldap 语句刷新缓存,详细查看[REFRESH-LDAP](../../../sql-manual/sql-statements/account-management/REFRESH-LDAP)。
+
+### LDAP 验证的局限
+- 目前 Doris 的 LDAP 功能只支持明文密码验证,即用户登录时,密码在 client 与 fe 之间、fe 与 LDAP 服务之间以明文的形式传输。
+
+### 常见问题
+- 怎么判断 LDAP 用户在 doris 中有哪些角色?
+
+ 使用 LDAP 用户在 doris 中登录,`show grants;`能查看当前用户有哪些角色。其中 ldapDefaultRole 是每个 ldap 用户在 doris 中都有的默认角色。
+
+- LDAP 用户在 doris 中的角色比预期少怎么排查?
+
+ 1. 通过`show roles;`查看预期的角色在 doris 中是否存在,如果不存在,需要通过` CREATE ROLE rol_name;`创建角色。
+ 2. 检查预期的 group 是否在`ldap_group_basedn`对应的组织结构下。
+ 3. 检查预期 group 是否包含 member 属性。
+ 4. 检查预期 group 的 member 属性是否包含当前用户。
+### LDAP 相关概念
+在 LDAP 中,数据是按照树型结构组织的。
+
+#### 示例(下文的介绍都将根据这个例子进行展开)
+
+```
+- dc=example,dc=com
+ - ou = ou1
+ - cn = group1
+ - cn = user1
+ - ou = ou2
+ - cn = group2
+ - cn = user2
+ - cn = user3
+```
+
+#### LDAP 名词解释
+
+- dc(Domain Component): 可以理解为一个组织的域名,作为树的根结点
+- dn(Distinguished Name): 相当于唯一名称,例如 user1 的 dn 为 cn=user1,ou=ou1,dc=example,dc=com user2 的 dn 为 cn=user2,cn=group2,ou=ou2,dc=example,dc=com
+- rdn(Relative Distinguished Name): dn 的一部分,user1 的四个 rdn 为 cn=user1 ou=ou1 dc=example 和 dc=com
+- ou(Organization Unit): 可以理解为子组织,user 可以放在 ou 中,也可以直接放在 example.com 域中
+- cn(common name):名字
+- group: 组,可以理解为 doris 的角色
+- user: 用户,和 doris 的用户等价
+- objectClass:可以理解为每行数据的类型,比如怎么区分 group1 是 group 还是 user,每种类型的数据下面要求有不同的属性,比如 group 要求有 cn 和 member(user 列表),user 要求有 cn,password,uid 等
+### 客户端如何使用明文登录
+#### MySql Client
+客户端使用 LDAP 验证需要启用 mysql 客户端明文验证插件,使用命令行登录 Doris 可以使用下面两种方式之一启用 mysql 明文验证插件:
+
+- 设置环境变量 `LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN` 值 1
+
+ 例如在 linux 或者 mac 环境中可以使用:
+
+ ```shell
+ echo "export LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN=1" >> ~/.bash_profile && source ~/.bash_profile
+ ```
+
+- 每次登录 Doris 时添加参数 `--enable-cleartext-plugin`
+
+ ```shell
+ mysql -hDORIS_HOST -PDORIS_PORT -u user -p --enable-cleartext-plugin
+
+ 输入 ldap 密码
+ ```
+#### Jdbc Client
+
+使用 Jdbc Client 登录 Doris 时,需要自定义 plugin。
+
+首先,创建一个名为 MysqlClearPasswordPluginWithoutSSL 的类,继承自 MysqlClearPasswordPlugin。在该类中,重写 requiresConfidentiality() 方法,并返回 false。
+
+``` java
+public class MysqlClearPasswordPluginWithoutSSL extends MysqlClearPasswordPlugin {
+@Override
+public boolean requiresConfidentiality() {
+ return false;
+ }
+}
+```
+在获取数据库连接时,需要将自定义的 plugin 配置到属性中
+
+即(xxx 为自定义类的包名)
+- authenticationPlugins=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL
+- defaultAuthenticationPlugin=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL
+- disabledAuthenticationPlugins=com.mysql.jdbc.authentication.MysqlClearPasswordPlugin
+
+eg:
+```sql
+ jdbcUrl = "jdbc:mysql://localhost:9030/mydatabase?authenticationPlugins=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL&defaultAuthenticationPlugin=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL&disabledAuthenticationPlugins=com.mysql.jdbc.authentication.MysqlClearPasswordPlugin";
+```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication/internal.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication/internal.md
new file mode 100644
index 00000000000..d1eb716fc99
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authentication/internal.md
@@ -0,0 +1,149 @@
+---
+{
+"title": "内置认证",
+"language": "zh-CN"
+}
+---
+
+## 关键概念
+### 用户
+
+在 Doris 中,一个 user_identity 唯一标识一个用户。user_identity 由两部分组成,user_name 和 host,其中 username 为用户名。host 标识用户端连接所在的主机地址。host 部分可以使用 % 进行模糊匹配。如果不指定 host,默认为 '%',即表示该用户可以从任意 host 连接到 Doris。
+
+#### 用户属性
+
+用户属性直接附属于 user_name,而不是 user_identity,即 user@'192.%' 和 user@['domain'] 都拥有同一组用户属性。该属性属于 user,而不是 user@'192.%' 或 user@['domain']。
+
+用户属性包括但不限于:用户最大连接数、导入集群配置等等。
+
+#### 内置用户
+
+内置用户是 Doris 默认创建的用户,并默认拥有一定的权限,包括 root 和 admin。初始密码都为空,fe 启动后,可以通过修改密码命令进行修改。不支持删除默认用户。
+
+- root@'%':root 用户,允许从任意节点登录,角色为 operator。
+- admin@'%':admin 用户,允许从任意节点登录,角色为 admin。
+
+### 密码
+
+用户登录的凭据,管理员创建用户时设置,也可以创建后由用户自己更改密码。
+
+#### 密码策略
+
+Doris 支持以下密码策略,可以帮助用户更好的进行密码管理。
+
+- `PASSWORD_HISTORY`
+
+ 是否允许当前用户重置密码时使用历史密码。如 `PASSWORD_HISTORY` 10 表示禁止使用过去 10 次设置过的密码为新密码。如果设置为 `PASSWORD_HISTORY DEFAULT`,则会使用全局变量 `password_history` 中的值。0 表示不启用这个功能。默认为 0。
+
+ 示例:
+
+ - 设置全局变量:`SET GLOBAL password_history = 10`
+ - 为用户设置:`ALTER USER user1@'ip' PASSWORD_HISTORY 10`
+
+- `PASSWORD_EXPIRE`
+
+ 设置当前用户密码的过期时间。如 `PASSWORD_EXPIRE INTERVAL 10 DAY` 表示密码会在 10 天后过期。`PASSWORD_EXPIRE NEVER` 表示密码不过期。如果设置为 `PASSWORD_EXPIRE DEFAULT`,则会使用全局变量 `default_password_lifetime` 中的值(单位为 天)。默认为 NEVER(或 0),表示不会过期。
+
+ 示例:
+
+ - 设置全局变量:`SET GLOBAL default_password_lifetime = 1`
+ - 为用户设置:`ALTER USER user1@'ip' PASSWORD_EXPIRE INTERVAL 10 DAY`
+
+- `FAILED_LOGIN_ATTEMPTS` 和 `PASSWORD_LOCK_TIME`
+
+ 设置当前用户登录时,如果使用错误的密码登录 n 次后,账户将被锁定,并设置锁定时间。如 `FAILED_LOGIN_ATTEMPTS 3 PASSWORD_LOCK_TIME 1 DAY` 表示如果 3 次错误登录,则账户会被锁定一天。管理员可以通过 ALTER USER 语句主动解锁被锁定的账户。
+
+ 示例:
+
+ - 为用户设置:`ALTER USER user1@'ip' FAILED_LOGIN_ATTEMPTS 3 PASSWORD_LOCK_TIME 1 DAY`
+
+- 密码强度
+
+ 该功能由全局变量 `validate_password_policy` 控制。默认为 NONE/0,即不检查密码强度。如果设置为 STRONG/2,则密码必须包含“大写字母”,“小写字母”,“数字”和“特殊字符”中的 3 项,并且长度必须大于等于 8。
+
+ 示例:
+
+ - `SET validate_password_policy=STRONG`
+
+以上策略设置后,可以通过如下命令查看:
+
+```sql
+SHOW PROC "/auth/'<user>'@'<host>'";
+```
+
+注意,需要使用单引号分别包裹 user 和 host 部分。比如:
+
+```
+SHOW PROC "/auth/'root'@'%'";
+SHOW PROC "/auth/'user1'@'127.0.0.1'";
+```
+
+## 认证机制
+
+1. 客户端认证信息发送:客户端将用户的信息(如用户名、密码、数据库等)打包发送给 Doris 服务器。这些信息用于证明客户端的身份和请求访问的数据库。
+
+2. 服务器认证:Doris 收到客户端的认证信息后,会进行验证。如果用户名、密码以及客户端的 IP 正确,并且该用户具有访问所选数据库的权限,则认证成功,Doris 会将用户个体映射到系统内的用户标识(User Identity)上。否则,认证失败,并返回相应的错误消息给客户端。
+
+## 黑白名单
+
+Doris 本身不支持黑名单,只有白名单功能,但我们可以通过某些方式来模拟黑名单。假设先创建了名为 `user@'192.%'` 的用户,表示允许来自 `192.*` 的用户登录。此时如果想禁止来自 `192.168.10.1` 的用户登录,则可以再创建一个用户 `cmy@'192.168.10.1'`,并设置一个新的密码。因为 `192.168.10.1` 的优先级高于 `192.%`,所以来自 `192.168.10.1` 的用户将不能再使用旧密码进行登录。
+
+## 相关命令
+
+- 创建用户:[CREATE USER](../../../sql-manual/sql-statements/account-management/CREATE-USER)
+- 查看用户:[SHOW ALL GRANTS](../../../sql-manual/sql-statements/account-management/SHOW-GRANTS)
+- 修改用户:[ALTER USER](../../../sql-manual/sql-statements/account-management/ALTER-USER)
+- 修改密码:[SET PASSWORD](../../../sql-manual/sql-statements/account-management/SET-PASSWORD)
+- 删除用户:[DROP USER](../../../sql-manual/sql-statements/account-management/DROP-USER)
+- 设置用户属性:[SET PROPERTY](../../../sql-manual/sql-statements/account-management/SET-PROPERTY)
+- 查看用户属性:[SHOW PROPERTY](../../../sql-manual/sql-statements/account-management/SHOW-PROPERTY)
+
+## 其它说明
+
+1. 登录时 user_identity 优先级选择问题
+
+ 如上文介绍,`user_identity` 由 `user_name` 和 `host` 组成,但是用户登录的时候,只需要输入 `user_name`,所以由 Doris 根据客户端的 IP 来匹配相应的 `host`,从而决定使用哪个 `user_identity` 登录。
+
+ 如果 根据 客户端 ip 只能匹配到一个 `user_identity`,那么毫无疑问会匹配到这个 `user_identity`,但是当能够匹配到多个 `user_identity` 时,就会有如下的优先级问题。
+
+ 1. 域名与 ip 的优先级:
+
+ 假设创建了如下用户:
+
+ ```sql
+ CREATE USER user1@['domain1'] IDENTIFIED BY "12345";
+ CREATE USER user1@'ip1'IDENTIFIED BY "abcde";
+ ```
+
+ domain1 被解析为两个 IP:ip1 和 ip2。
+
+ 在优先级上,ip 优先于 域名,因此,当用户 user1 从 ip1 这台机器尝试使用密码 '12345' 登录 Doris 会被拒绝。
+
+ 2. 具体 ip 和 范围 ip 的优先级:
+
+ 假设创建了如下用户:
+
+ ```sql
+ CREATE USER user1@'%' IDENTIFIED BY "12345";
+ CREATE USER user1@'192.%' IDENTIFIED BY "abcde";
+ ```
+
+ 在优先级上,'192.%' 优先于 '%',因此,当用户 user1 从 192.168.1.1 这台机器尝试使用密码 '12345' 登录 Doris 会被拒绝。
+
+2. 忘记密码
+
+ 如果忘记了密码无法登录 Doris,可以在 FE 的 config 文件中添加 skip_localhost_auth_check=true 参数,并且重启 FE,从而无密码在 Fe 本机通过 root 登录 Doris。
+
+ 登录后,可以通过 SET PASSWORD 命令重置密码。
+
+3. 任何用户都不能重置 root 用户的密码,除了 root 用户自己。
+
+4. `current_user()` 和 `user()`
+
+ 用户可以通过 `SELECT current_user()` 和 `SELECT user()` 分别查看 `current_user` 和 `user`。其中 `current_user` 表示当前用户是以哪种身份通过认证系统的,而 `user` 则是用户当前实际的 User Identity。
+
+ 举例说明:
+
+ 假设创建了 `user1@'192.%'` 这个用户,然后以为来自 `192.168.10.1` 的用户 `user1` 登录了系统,则此时的 `current_user` 为 `user1@'192.%'`,而 `user` 为 `user1@'192.168.10.1'`。
+
+ 所有的权限都是赋予某一个 `current_user` 的,真实用户拥有对应的 `current_user` 的所有权限。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/data.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/data.md
new file mode 100644
index 00000000000..91399b68f47
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/data.md
@@ -0,0 +1,53 @@
+---
+{
+"title": "数据访问控制",
+"language": "zh-CN"
+}
+---
+
+## 行权限
+
+使用 Doris 中的行级策略,您可以对敏感数据进行精细访问控制。您可以根据在表级别定义的安全策略,来决定哪些用户或角色可以访问表中数据的特定记录。
+
+### 机制
+
+相当于为配置了 Row Policy 的用户在查询时自动加上 Row Policy 中设置的谓词
+
+### 限制
+
+不能为默认用户 root 和 admin 设置 Row Policy
+
+### 相关命令
+- 查看行权限策略 [SHOW ROW POLICY](../../../sql-manual/sql-statements/data-governance/SHOW-ROW-POLICY)
+- 创建行权限策略 [CREATE ROW POLICY](../../../sql-manual/sql-statements/data-governance/CREATE-ROW-POLICY)
+### 行权限示例
+1. 限制 test 用户仅能查询 table1 表中 c1='a' 的数据
+
+```sql
+CREATE ROW POLICY test_row_policy_1 ON test.table1
+AS RESTRICTIVE TO test USING (c1 = 'a');
+```
+## 列权限
+使用 Doris 中的列权限,您可以对表进行精细访问控制。您可以只授予一个表中特定列的权限,来决定哪些用户或角色可以访问表的特定列
+
+目前列权限仅支持 Select_priv
+
+### 相关命令
+- 授权:[GRANT](../../../sql-manual/sql-statements/account-management/GRANT-TO)
+- 回收权限: [REVOKE](../../../sql-manual/sql-statements/account-management/REVOKE-FROM)
+
+### 列权限示例
+
+1. 授权 user1 查询 tbl 表的列:col1,col2.
+```sql
+GRANT Select_priv(col1,col2) ON ctl.db.tbl TO user1
+```
+
+## 数据脱敏
+数据脱敏是一种保护敏感数据的方法,它通过对原始数据进行修改、替换或隐藏,使得脱敏后的数据在保持一定格式和特性的同时,不再包含敏感信息。
+
+例如,管理员可以选择将信用卡号、身份证号等敏感字段的部分或全部数字替换为星号 * 或其他字符,或者将真实姓名替换为假名。
+
+从 2.1.2 版本开始,支持通过 Apache Ranger 的 Data Masking 来为某些列设置脱敏策略,目前仅支持通过 [Apache Ranger](./ranger)来设置
+
+> 为 admin/root 用户设置数据脱敏不会生效
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/internal.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/internal.md
new file mode 100644
index 00000000000..17fe64b17f6
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/internal.md
@@ -0,0 +1,115 @@
+---
+{
+"title": "内置鉴权",
+"language": "zh-CN"
+}
+---
+
+## 关键概念
+
+鉴权是指根据用户身份限制其访问和操作 Doris 资源的机制。
+
+Doris 基于 RBAC(Role-Based Access Control)的权限管理模型进行权限控制。
+
+### 权限
+
+权限作用的对象是节点、数据目录、数据库或表。不同的权限代表不同的操作许可。
+
+#### 所有权限
+
+| 权限 | 对象类型 | 描述 |
+|----------------| --------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Admin_priv | Global | 超管权限。 |
+| Node_priv | Global | 节点变更权限。包括 FE、BE、BROKER 节点的添加、删除、下线等操作。 |
+| Grant_priv | Global,Catalog,Db,Table,Resource,Workload Group | 权限变更权限。允许执行包括授权、撤权、添加/删除/变更 用户/角色 等操作。<br>给其他用户/角色授权时,2.1.2 版本之前,当前用户只需要相应层级的 Grant_priv 权限,2.1.2 版本之后当前用户也要有想要授权的资源的权限。<br>给其他用户分配角色时,要有 Global 级别的 Grant_priv 权限。 |
+| Select_priv | Global,Catalog,Db,Table,Column | 对数据目录、数据库、表、列的只读权限。 |
+| Load_priv | Global,Catalog,Db,Table | 对数据目录、数据库、表的写权限。包括 Load、Insert、Delete 等。 |
+| Alter_priv | Global,Catalog,Db,Table | 对数据目录、数据库、表的更改权限。包括重命名 库/表、添加/删除/变更 列、添加/删除 分区等操作。 |
+| Create_priv | Global,Catalog,Db,Table | 创建数据目录、数据库、表、视图的权限。 |
+| Drop_priv | Global,Catalog,Db,Table | 删除数据目录、数据库、表、视图的权限。 |
+| Usage_priv | Resource,Workload Group | Resource 和 Workload Group 的使用权限。 |
+| Show_view_priv | Global,Catalog,Db,Table | 执行 SHOW CREATE VIEW 的权限。 |
+
+### 角色
+
+Doris 可以创建自定义命名的角色。角色可以被看做是一组权限的集合。新创建的用户可以被赋予某一角色,则自动被赋予该角色所拥有的权限。后续对角色的权限变更,也会体现在所有属于该角色的用户权限上。
+
+#### 内置角色
+
+内置角色是 Doris 默认创建的角色,并默认拥有一定的权限,包括 operator 和 admin。
+
+- operator : 拥有 Admin_priv 和 Node_priv
+- admin: 拥有 Admin_priv
+
+### 用户
+
+在 Doris 中,一个 user_identity 唯一标识一个用户。user_identity 由两部分组成,user_name 和 host,其中 username 为用户名。host 标识用户端连接所在的主机地址。
+
+## 鉴权机制
+
+Doris 权限设计基于 RBAC(Role-Based Access Control)的权限管理模型,用户和角色关联,角色和权限关联,用户通过角色间接和权限关联。
+
+当角色被删除时,用户自动失去该角色的所有权限。
+
+当用户和角色取消关联,用户自动失去角色的所有权限。
+
+当角色的权限被增加或删除,用户的权限也会随之变更。
+
+```
+┌────────┐ ┌────────┐ ┌────────┐
+│ user1 ├────┬───► role1 ├────┬────► priv1 │
+└────────┘ │ └────────┘ │ └────────┘
+ │ │
+ │ │
+ │ ┌────────┐ │
+ │ │ role2 ├────┤
+┌────────┐ │ └────────┘ │ ┌────────┐
+│ user2 ├────┘ │ ┌─► priv2 │
+└────────┘ │ │ └────────┘
+ ┌────────┐ │ │
+ ┌──────► role3 ├────┘ │
+ │ └────────┘ │
+ │ │
+ │ │
+┌────────┐ │ ┌────────┐ │ ┌────────┐
+│ userN ├─┴──────► roleN ├───────┴─► privN │
+└────────┘ └────────┘ └────────┘
+```
+
+如上图所示:
+
+user1 和 user2 都是通过 role1 拥有了 priv1 的权限。
+
+userN 通过 role3 拥有了 priv1 的权限,通过 roleN 拥有了 priv2 和 privN 的权限,因此 userN 同时拥有 priv1,priv2 和 privN 的权限。
+
+
+### 注意事项
+
+- 为了方便用户操作,是可以直接给用户授权的,底层实现上,是为每个用户创建了一个专属于该用户的默认角色,当给用户授权时,实际上是在给该用户的默认角色授权。
+- 默认角色不能被删除,不能被分配给其他人,删除用户时,默认角色也自动删除。
+
+## 相关命令
+- 授权/分配角色:[GRANT](../../../sql-manual/sql-statements/account-management/GRANT-TO)
+- 撤权/撤销角色:[REVOKE](../../../sql-manual/sql-statements/account-management/REVOKE-FROM)
+- 创建角色:[CREATE ROLE](../../../sql-manual/sql-statements/account-management/CREATE-ROLE)
+- 删除角色:[DROP ROLE](../../../sql-manual/sql-statements/account-management/DROP-ROLE)
+- 修改角色:[ALTER ROLE](../../../sql-manual/sql-statements/account-management/ALTER-ROLE)
+- 查看当前用户权限和角色:[SHOW GRANTS](../../../sql-manual/sql-statements/account-management/SHOW-GRANTS)
+- 查看所有用户权限和角色:[SHOW ALL GRANTS](../../../sql-manual/sql-statements/account-management/SHOW-GRANTS)
+- 查看已创建的角色:[SHOW ROLES](../../../sql-manual/sql-statements/account-management/SHOW-ROLES)
+- 查看支持的所有权限项:[SHOW PRIVILEGES](../../../sql-manual/sql-statements/account-management/SHOW-PRIVILEGES)
+
+## 最佳实践
+
+这里举例一些 Doris 权限系统的使用场景。
+
+1. 场景一
+
+ Doris 集群的使用者分为管理员(Admin)、开发工程师(RD)和用户(Client)。其中管理员拥有整个集群的所有权限,主要负责集群的搭建、节点管理等。开发工程师负责业务建模,包括建库建表、数据的导入和修改等。用户访问不同的数据库和表来获取数据。
+
+ 在这种场景下,可以为管理员赋予 ADMIN 权限或 GRANT 权限。对 RD 赋予对任意或指定数据库表的 CREATE、DROP、ALTER、LOAD、SELECT 权限。对 Client 赋予对任意或指定数据库表 SELECT 权限。同时,也可以通过创建不同的角色,来简化对多个用户的授权操作。
+
+2. 场景二
+
+ 一个集群内有多个业务,每个业务可能使用一个或多个数据。每个业务需要管理自己的用户。在这种场景下。管理员用户可以为每个数据库创建一个拥有 DATABASE 层级 GRANT 权限的用户。该用户仅可以对用户进行指定的数据库的授权。
+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/ranger.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/ranger.md
new file mode 100644
index 00000000000..2774cc4aa0e
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/authorization/ranger.md
@@ -0,0 +1,267 @@
+---
+{
+"title": "Ranger 鉴权",
+"language": "zh-CN"
+}
+---
+
+Apache Ranger 是一个用来在 Hadoop 平台上进行监控,启用服务,以及全方位数据安全访问管理的安全框架。
+使用 ranger 后,会通过在 Ranger 侧配置权限代替在 Doris 中执行 Grant 语句授权。
+Ranger 的安装和配置见下文:安装和配置 Doris Ranger 插件
+
+## Ranger 示例
+### 更改 Doris 配置
+1. 在 fe/conf/fe.conf 文件中配置鉴权方式为 ranger access_controller_type=ranger-doris
+2. 在所有 FE 的 conf 目录创建 `ranger-doris-security.xml` 文件,内容如下:
+
+ ```
+ <?xml version="1.0" encoding="UTF-8"?>
+ <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
+ <configuration>
+ <property>
+ <name>ranger.plugin.doris.policy.cache.dir</name>
+ <value>/path/to/ranger/cache/</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.pollIntervalMs</name>
+ <value>30000</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.rest.client.connection.timeoutMs</name>
+ <value>60000</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.rest.client.read.timeoutMs</name>
+ <value>60000</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.rest.url</name>
+ <value>http://172.21.0.32:6080</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.source.impl</name>
+ <value>org.apache.ranger.admin.client.RangerAdminRESTClient</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.service.name</name>
+ <value>doris</value>
+ </property>
+ </configuration>
+ ```
+
+ 其中需要将 `ranger.plugin.doris.policy.cache.dir` 和 `ranger.plugin.doris.policy.rest.url` 改为实际值。
+3. 启动集群
+### 权限示例
+1. 在 Doris 中创建 `user1`。
+2. 在 Doris 中,先使用 `admin` 用户创建一个 Catalog:`hive`。
+3. 在 Ranger 中创建 `user1`。
+
+#### 全局权限
+相当于 Doris 内部授权语句的 `grant select_priv on *.*.* to user1`;
+- catalog 同级下拉框可以找到 global 选项
+- 输入框里只能输入 `*`
+
+ 
+
+#### Catalog 权限
+相当于 Doris 内部授权语句的 `grant select_priv on hive.*.* to user1`;
+
+
+
+#### Database 权限
+相当于 Doris 内部授权语句的 `grant select_priv on hive.tpch.* to user1`;
+
+
+
+#### Table 权限
+> 这里的table泛指 表/视图/异步物化视图
+
+相当于 Doris 内部授权语句的 `grant select_priv on hive.tpch.user to user1`;
+
+
+
+#### 列权限
+相当于 Doris 内部授权语句的 `grant select_priv(name,age) on hive.tpch.user to user1`;
+
+
+
+#### Resource 权限
+相当于 Doris 内部授权语句的 `grant usage_priv on resource 'resource1' to user1`;
+- catalog 同级下拉框可以找到 resource 选项
+
+
+
+#### Workload Group 权限
+相当于 Doris 内部授权语句的 `grant usage_priv on workload group 'group1' to user1`;
+- catalog 同级下拉框可以找到 workload group 选项
+
+
+
+#### Compute Group 权限
+
+> 3.0.6 版本支持
+
+相当于 Doris 内部授权语句的 `grant usage_priv on compute group 'group1' to user1`;
+- catalog 同级下拉框可以找到 compute group 选项
+
+
+
+#### Storage Vault 权限
+
+> 3.0.6 版本支持
+
+相当于 Doris 内部授权语句的 `grant usage_priv on storage vault 'vault1' to user1`;
+- catalog 同级下拉框可以找到 storage vault 选项
+
+
+
+### 行权限示例
+
+> 2.1.3 版本支持
+
+1. 参考 权限示例 给 user1 分配 internal.db1.user 表的 select 权限。
+2. 在 Ranger 中添加一个 Row Level Filter policy
+
+ 
+
+3. 使用 user1 登录 Doris。执行 `select * from internal.db1.user`,只能看到满足 `id > 3` 且 `age = 2` 的数据。
+
+### 数据脱敏示例
+
+> 2.1.3 版本支持
+
+1. 参考 权限示例 给 user1 分配 internal.db1.user 表的 select 权限。
+2. 在 Ranger 中添加一个 Masking policy
+
+ 
+
+3. 使用 user1 登录 Doris。执行 `select * from internal.db1.user`,看到的 phone 是按照指定规则脱敏后的数据。
+## 常见问题
+1. ranger 访问失败,怎么查看日志
+
+ 在所有 FE 的 conf 目录创建 log4j.properties 文件,内容如下:
+
+ ```
+ log4j.rootLogger = warn,stdout,D
+
+ log4j.appender.stdout = org.apache.log4j.ConsoleAppender
+ log4j.appender.stdout.Target = System.out
+ log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
+ log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
+
+ log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
+ log4j.appender.D.File = /path/to/fe/log/ranger.log
+ log4j.appender.D.Append = true
+ log4j.appender.D.Threshold = INFO
+ log4j.appender.D.layout = org.apache.log4j.PatternLayout
+ log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
+ ```
+
+ 其中 `log4j.appender.D.File` 改为实际值,用于存放 Ranger 插件的日志。
+2. 配置了 Row Level Filter policy ,但是用户查询时报没有权限
+
+ Row Level Filter policy 仅用来限制用户访问表中数据的特定记录, 仍需通过 ACCESS POLICY 为用户授权
+3. 创建服务后,默认仅 `admin` 用户有权限, `root` 用户没有权限
+
+ 如图所示,创建服务的时候,添加配置 `default.policy.users` ,如需配置多个用户拥有全部权限,用 `,` 分隔
+ 
+
+4. 使用 ranger 鉴权后,内部授权还有用么?
+
+ 不能用,也不能创建/删除角色
+
+## 安装和配置 Doris Ranger 插件
+### 安装插件
+
+1. 下载以下文件
+
+ - [ranger-doris-plugin-3.0.0-SNAPSHOT.jar](https://selectdb-doris-1308700295.cos.ap-beijing.myqcloud.com/ranger/ranger-doris-plugin-3.0.0-SNAPSHOT.jar)
+ - [mysql-connector-java-8.0.25.jar](https://selectdb-doris-1308700295.cos.ap-beijing.myqcloud.com/release/jdbc_driver/mysql-connector-java-8.0.25.jar)
+
+2. 将下载好的文件放到 Ranger 服务的 `ranger-plugins/doris` 目录下,如:
+
+ ```
+ /usr/local/service/ranger/ews/webapp/WEB-INF/classes/ranger-plugins/doris/ranger-doris-plugin-3.0.0-SNAPSHOT.jar
+ /usr/local/service/ranger/ews/webapp/WEB-INF/classes/ranger-plugins/doris/mysql-connector-java-8.0.25.jar
+ ```
+
+3. 重启 Ranger 服务。
+
+4. 下载 [ranger-servicedef-doris.json](https://github.com/morningman/ranger/blob/doris-plugin/agents-common/src/main/resources/service-defs/ranger-servicedef-doris.json)
+
+5. 执行以下命令上传定义文件到 Ranger 服务:
+
+ ```
+ curl -u user:password -X POST \
+ -H "Accept: application/json" \
+ -H "Content-Type: application/json" \
+ http://172.21.0.32:6080/service/plugins/definitions \
+ -d@ranger-servicedef-doris.json
+ ```
+
+ 其中用户名密码是登录 Ranger WebUI 所使用的用户名密码。
+
+ 服务地址端口可以再 `ranger-admin-site.xml` 配置文件的 `ranger.service.http.port` 配置项查看。
+
+ 如执行成功,会返回 Json 格式的服务定义,如:
+
+ ```
+ {
+ "id": 207,
+ "guid": "d3ff9e41-f9dd-4217-bb5f-3fa9996454b6",
+ "isEnabled": true,
+ "createdBy": "Admin",
+ "updatedBy": "Admin",
+ "createTime": 1705817398112,
+ "updateTime": 1705817398112,
+ "version": 1,
+ "name": "doris",
+ "displayName": "Apache Doris",
+ "implClass": "org.apache.ranger.services.doris.RangerServiceDoris",
+ "label": "Doris",
+ "description": "Apache Doris",
+ "options": {
+ "enableDenyAndExceptionsInPolicies": "true"
+ },
+ ...
+ }
+ ```
+
+ 如想重新创建,则可以使用以下命令删除服务定义后,再重新上传:
+
+ ```
+ curl -v -u user:password -X DELETE \
+ http://172.21.0.32:6080/service/plugins/definitions/207
+ ```
+
+ 其中 `207` 是创建时返回的 id。删除前,需在 Ranger WebUI 界面删除已创建的 Doris 服务。
+
+ 也可以通过以下命令列举当前已添加的服务定义,以便获取 id:
+
+ ```
+ curl -v -u user:password -X GET \
+ http://172.21.0.32:6080/service/plugins/definitions/
+ ```
+### 配置插件
+
+安装完毕后,打开 Ranger WebUI,可以再 Service Manger 界面中看到 Apache Doris 插件:
+
+
+
+点击插件旁边的 `+` 号添加一个 Doris 服务:
+
+
+
+Config Properties 部分参数含义如下:
+
+- `Username`/`Pasword`:Doris 集群的用户名密码,这里建议使用 Admin 用户。
+- `jdbc.driver_class`:连接 Doris 使用的 JDBC 驱动。`com.mysql.cj.jdbc.Driver`
+- `jdbc.url`:Doris 集群的 JDBC url 连接串。`jdbc:mysql://172.21.0.101:9030?useSSL=false`
+- 额外参数:
+ - `resource.lookup.timeout.value.in.ms`:获取元信息的超时时间,建议填写 `10000`,即 10 秒。
+
+可以点击 `Test Connection` 检查是否可以联通。
+
+之后点击 `Add` 添加服务。
+
+之后,可以在 Service Manger 界面的 Apache Doris 插件中看到创建的服务,点击服务,即可开始配置 Ranger。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/certificate.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/certificate.md
new file mode 100644
index 00000000000..1a9a166cb8f
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/certificate.md
@@ -0,0 +1,94 @@
+---
+{
+ "title": "MySQL 安全传输",
+ "language": "zh-CN"
+}
+---
+
+## 加密连接 FE
+
+Doris支持基于SSL的加密连接,当前支持TLS1.2,TLS1.3协议,可以通过以下配置开启Doris的SSL模式:
+修改FE配置文件`conf/fe.conf`,添加`enable_ssl = true`即可。
+
+接下来通过`mysql`客户端连接Doris,mysql支持三种SSL模式:
+
+1.`mysql -uroot -P9030 -h127.0.0.1`与`mysql --ssl-mode=PREFERRED -uroot -P9030 -h127.0.0.1`一样,都是一开始试图建立SSL加密连接,如果失败,则尝试使用普通连接。
+
+2.`mysql --ssl-mode=DISABLE -uroot -P9030 -h127.0.0.1`,不使用SSL加密连接,直接使用普通连接。
+
+3.`mysql --ssl-mode=REQUIRED -uroot -P9030 -h127.0.0.1`,强制使用SSL加密连接。
+
+>注意:
+>`--ssl-mode`参数是mysql5.7.11版本引入的,低于此版本的mysql客户端请参考[这里](https://dev.mysql.com/doc/connector-j/8.0/en/connector-j-connp-props-security.html)。
+Doris开启SSL加密连接需要密钥证书文件验证,默认的密钥证书文件位于`Doris/fe/mysql_ssl_default_certificate/certificate.p12`,默认密码为`doris`,您可以通过修改FE配置文件`conf/fe.conf`,添加`mysql_ssl_default_certificate = /path/to/your/certificate`修改密钥证书文件,同时也可以通过`mysql_ssl_default_certificate_password = your_password`添加对应您自定义密钥书文件的密码。
+
+Doris还支持mTLS:
+修改FE配置文件`conf/fe.conf`,添加`ssl_force_client_auth=true`即可。
+
+接下来可以通过`mysql`客户端连接Doris:
+
+`mysql -ssl-mode=VERIFY_CA -uroot -P9030 -h127.0.0.1 --tls-version=TLSv1.2 --ssl-ca=/path/to/your/ca --ssl-cert=/path/to/your/cert --ssl-key=/path/to/your/key`
+
+默认的ca,cert,key文件位于`Doris/conf/mysql_ssl_default_certificate/client_certificate/`,分别叫做`ca.pem`,`client-cert.pem`,`client-key.pem`。
+
+你也可以通过openssl或者keytool生成自己的证书文件。
+
+## SSL密钥证书配置
+
+Doris 开启 SSL 功能需要配置 CA 密钥证书和 Server 端密钥证书,如需开启双向认证,还需生成 Client 端密钥证书:
+
+* 默认的 CA 密钥证书文件位于`Doris/fe/mysql_ssl_default_certificate/ca_certificate.p12`,默认密码为`doris`,您可以通过修改 FE 配置文件`conf/fe.conf`,添加`mysql_ssl_default_ca_certificate = /path/to/your/certificate`修改 CA 密钥证书文件,同时也可以通过`mysql_ssl_default_ca_certificate_password = your_password`添加对应您自定义密钥证书文件的密码。
+
+* 默认的 Server 端密钥证书文件位于`Doris/fe/mysql_ssl_default_certificate/server_certificate.p12`,默认密码为`doris`,您可以通过修改 FE 配置文件`conf/fe.conf`,添加`mysql_ssl_default_server_certificate = /path/to/your/certificate`修改 Server 端密钥证书文件,同时也可以通过`mysql_ssl_default_server_certificate_password = your_password`添加对应您自定义密钥证书文件的密码。
+
+* 默认生成了一份 Client 端的密钥证书,分别存放在`Doris/fe/mysql_ssl_default_certificate/client-key.pem`和`Doris/fe/mysql_ssl_default_certificate/client_certificate/`。
+
+## 自定义密钥证书文件
+
+除了 Doris 默认的证书文件,您也可以通过`openssl`生成自定义的证书文件。步骤参考[MySQL 生成 SSL 证书](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-files-using-openssl.html)
+具体如下:
+
+1. 生成 CA、Server 端和 Client 端的密钥和证书
+
+```shell
+# 生成 CA certificate
+openssl genrsa 2048 > ca-key.pem
+openssl req -new -x509 -nodes -days 3600 \
+ -key ca-key.pem -out ca.pem
+
+# 生成 server certificate, 并用上述 CA 签名
+# server-cert.pem = public key, server-key.pem = private key
+openssl req -newkey rsa:2048 -days 3600 \
+ -nodes -keyout server-key.pem -out server-req.pem
+openssl rsa -in server-key.pem -out server-key.pem
+openssl x509 -req -in server-req.pem -days 3600 \
+ -CA ca.pem -CAkey ca-key.pem -set_serial 01 -out server-cert.pem
+
+# 生成 client certificate, 并用上述 CA 签名
+# client-cert.pem = public key, client-key.pem = private key
+openssl req -newkey rsa:2048 -days 3600 \
+ -nodes -keyout client-key.pem -out client-req.pem
+openssl rsa -in client-key.pem -out client-key.pem
+openssl x509 -req -in client-req.pem -days 3600 \
+ -CA ca.pem -CAkey ca-key.pem -set_serial 01 -out client-cert.pem
+```
+
+2. 验证创建的证书。
+
+```shell
+openssl verify -CAfile ca.pem server-cert.pem client-cert.pem
+```
+
+3. 将您的 CA 密钥和证书和 Server 端密钥和证书分别合并到 PKCS#12 (P12) 包中。您也可以指定某个证书格式,默认 PKCS12,可以通过修改 conf/fe.conf 配置文件,添加参数 ssl_trust_store_type 指定证书格式
+
+```shell
+# 打包 CA 密钥和证书
+openssl pkcs12 -inkey ca-key.pem -in ca.pem -export -out ca_certificate.p12
+
+# 打包 Server 端密钥和证书
+openssl pkcs12 -inkey server-key.pem -in server-cert.pem -export -out server_certificate.p12
+```
+
+:::info Note
+[参考文档](https://www.ibm.com/docs/en/api-connect/2018.x?topic=overview-generating-self-signed-certificate-using-openssl)
+:::
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/encryption-function.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/encryption-function.md
new file mode 100644
index 00000000000..afa26f8dce9
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/encryption-function.md
@@ -0,0 +1,20 @@
+---
+{
+ "title": "加密和脱敏函数",
+ "language": "zh-CN"
+}
+---
+
+Doris 内置了如下加密和脱敏函数。详细用法请参考 SQL 手册。
+
+- [AES_ENCRYPT](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/aes-encrypt)
+- [AES_DECRYPT](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/aes-decrypt)
+- [SM4_ENCRYPT](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/sm4-encrypt)
+- [SM4_DECRYPT](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/sm4-decrypt)
+- [MD5](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/md5)
+- [MD5SUM](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/md5sum)
+- [SM3](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/sm3)
+- [SM3SUM](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/sm3sum)
+- [SHA](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/sha)
+- [SHA2](../../sql-manual/sql-functions/scalar-functions/encrypt-digest-functions/sha2)
+- [DIGITAL_MASKING](../../sql-manual/sql-functions/scalar-functions/string-functions/digital-masking)
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/fe-certificate.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/fe-certificate.md
new file mode 100644
index 00000000000..5ea03f58f90
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/fe-certificate.md
@@ -0,0 +1,30 @@
+---
+{
+ "title": "HTTP 安全传输",
+ "language": "zh-CN"
+}
+---
+
+:::tip
+
+从 2.0 版本开始,Doris 支持 SSL 密钥和证书配置
+:::
+
+
+Doris FE 接口开启 SSL 功能需要配置密钥证书,步骤如下:
+
+1. 购买或生成自签名 SSL 证书,生产环境建议使用 CA 颁发的证书
+
+2. 将 SSL 证书复制到指定路径下,默认路径为 `${DORIS_HOME}/conf/ssl/`,用户也可以自己指定路径
+
+3. 修改 FE 配置文件 `conf/fe.conf`,注意以下参数与购买或生成的 SSL 证书保持一致
+
+ - 设置 `enable_https = true` 开启 https 功能,默认为 `false`
+
+ - 设置证书路径 `key_store_path`,默认为 `${DORIS_HOME}/conf/ssl/doris_ssl_certificate.keystore`
+
+ - 设置证书密码 `key_store_password`,默认为空
+
+ - 设置证书类型 `key_store_type` ,默认为 `JKS`
+
+ - 设置证书别名 `key_store_alias`,默认为 `doris_ssl_certificate`
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/integrations/aws-authentication-and-authorization.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/integrations/aws-authentication-and-authorization.md
new file mode 100644
index 00000000000..47af802b810
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/integrations/aws-authentication-and-authorization.md
@@ -0,0 +1,615 @@
+---
+{
+ "title": "AWS 认证和鉴权",
+ "language": "zh-CN"
+}
+---
+
+Doris 支持两种 AWS 认证、鉴权方式访问 AWS 服务,`IAM User`和`Assumed Role`,本文介绍如何配置这两种认证、鉴权方式的 AWS 安全凭证并通过安全凭证使用 Doris 相关的功能来访问 AWS 的服务资源。
+
+## 认证方式介绍
+
+### IAM User 认证鉴权
+
+Doris 支持通过 配置`AWS IAM User`的方式来实现对外部数据源的访问(即`access_key`和`secret_key`密钥的方式),详细的配置步骤如下 (更详细的介绍请参见 AWS 官网文档 [IAM users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html)):
+
+#### Step1 登录 AWS 控制台创建 IAM User 并配置 IAM 策略
+
+1. 登录 `AWS控制台` 选择 `Create user` 按钮
+
+
+
+2. 填写好 IAM user 名字后,在`Set pemissions`部分选择直接附加策略
+
+
+
+3. 在策略编辑器中填入对应的 AWS 资源策略,下文以访问 S3 Bucket 资源为例列出了读/写策略的常见模板
+
+
+
+S3 Bucket 读策略模版,适用于只需读取和列出 bucket 中对象的 Doris 功能,比如 S3 Load,TVF,External Catalog 等
+
+**注意: **
+
+1. **替换对应的 bucket name 和 prefix 路径**
+
+2. **不要添加多余的“/”分割符**
+
+```json
+{
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:GetObject",
+ "s3:GetObjectVersion",
+ ],
+ "Resource": "arn:aws:s3:::<your-bucket>/your-prefix/*"
+ },
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:ListBucket",
+ "s3:GetBucketLocation"
+ ],
+ "Resource": "arn:aws:s3:::<your-bucket>"
+ }
+ ]
+}
+```
+
+S3 Bucket 写策略模板,适用于需要读取、列出和写入 bucket 对象的 Doris 功能,比如 Export,Storage Vault,Resource,Repository 等
+
+**注意: **
+
+1. **替换对应的 bucket name 和 prefix 路径**
+
+2. **不要添加多余的“/”分割符**
+
+```json
+{
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:PutObject",
+ "s3:GetObject",
+ "s3:GetObjectVersion",
+ "s3:DeleteObject",
+ "s3:DeleteObjectVersion",
+ "s3:AbortMultipartUpload",
+ "s3:ListMultipartUploadParts"
+ ],
+ "Resource": "arn:aws:s3:::<your-bucket>/<your-prefix>/*"
+ },
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:ListBucket",
+ "s3:GetBucketLocation",
+ "s3:GetBucketVersioning",
+ "s3:GetLifecycleConfiguration"
+ ],
+ "Resource": "arn:aws:s3:::<your-bucket>"
+ }
+ ]
+}
+```
+
+4. 创建 IAM User 成功后,创建 access/secret key 密钥
+
+
+
+#### Step2 通过访问密钥和 SQL 语句使用 Doris 对应功能
+
+完成上述 Step1 中的所有配置后,可获得`access_key`和`secret_key`访问密钥,通过访问密钥可以使用 Doris 对应的功能,具体例子如下:
+
+**S3 Load**
+
+```sql
+ LOAD LABEL s3_load_2022_04_01
+ (
+ DATA INFILE("s3://your_bucket_name/s3load_example.csv")
+ INTO TABLE test_s3load
+ COLUMNS TERMINATED BY ","
+ FORMAT AS "CSV"
+ (user_id, name, age)
+ )
+ WITH S3
+ (
+ "provider" = "S3",
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.access_key" = "<your-access-key>",
+ "s3.secret_key" = "<your-secrety-key>"
+ )
+ PROPERTIES
+ (
+ "timeout" = "3600"
+ );
+```
+
+**TVF**
+
+```sql
+ SELECT * FROM S3 (
+ 'uri' = 's3://your_bucket/path/to/tvf_test/test.parquet',
+ 'format' = 'parquet',
+ 's3.endpoint' = 's3.us-east-1.amazonaws.com',
+ 's3.region' = 'us-east-1',
+ "s3.access_key" = "<your-access-key>",
+ "s3.secret_key"="<your-secret-key>"
+ )
+```
+
+**External Catalog**
+
+```sql
+ CREATE CATALOG iceberg_catalog PROPERTIES (
+ 'type' = 'iceberg',
+ 'iceberg.catalog.type' = 'hadoop',
+ 'warehouse' = 's3://your_bucket/dir/key',
+ 's3.endpoint' = 's3.us-east-1.amazonaws.com',
+ 's3.region' = 'us-east-1',
+ "s3.access_key" = "<your-access-key>",
+ "s3.secret_key"="<your-secret-key>"
+ );
+```
+
+**Storage Vault**
+
+```sql
+CREATE STORAGE VAULT IF NOT EXISTS s3_demo_vault
+PROPERTIES (
+ "type" = "S3",
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.bucket" = "<your-bucket>",
+ "s3.access_key" = "<your-access-key>",
+ "s3.secret_key"="<your-secret-key>",
+ "s3.root.path" = "s3_demo_vault_prefix",
+ "provider" = "S3",
+ "use_path_style" = "false"
+);
+```
+
+**Export**
+
+```sql
+EXPORT TABLE s3_test TO "s3://your_bucket/a/b/c"
+PROPERTIES (
+ "column_separator"="\\x07",
+ "line_delimiter" = "\\x07"
+) WITH S3 (
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.access_key" = "<your-access-key>",
+ "s3.secret_key"="<your-secret-key>",
+)
+```
+
+**Repository**
+
+```sql
+CREATE REPOSITORY `s3_repo`
+WITH S3
+ON LOCATION "s3://your_bucket/s3_repo"
+PROPERTIES
+(
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.access_key" = "<your-access-key>",
+ "s3.secret_key"="<your-secret-key>"
+);
+```
+
+**Resource**
+
+```sql
+CREATE RESOURCE "remote_s3"
+PROPERTIES
+(
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.bucket" = "<your-bucket>",
+ "s3.access_key" = "<your-access-key>",
+ "s3.secret_key"="<your-secret-key>"
+);
+```
+
+
+您可以在不同业务逻辑里指定不同的 IAM User 的 `access_key` 和 `secret_key`,从而实现外部数据的访问控制。
+
+### Assumed Role 认证鉴权
+
+Assumed Role 支持通过担任 AWS IAM Role 来实现对外部数据源的访问认证和鉴权 (详细的介绍请参见 AWS 官网文档 [代入角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html)),下图列出了 Assumed Role 所需要配置的简要流程:
+
+
+
+名词介绍:
+
+`源账户(Source Account)`: 发起 Assume Role 的 AWS 账户 (本例中是 Doris FE/BE EC2 机器所属账户);
+
+`目标账户(Target Account)`: 拥有目标 S3 Bucket 的 AWS 账户;
+
+`ec2_role`: 源账户创建的 Role,并且需要绑定到每一个部署 Doris FE/BE 部署 EC2 机器上;
+
+`bucket_role`: 目标账户创建的 Role,并且需要关联目标 bucket 权限;
+
+**注意: **
+
+1. **源账户和目标账户可以是同一个 AWS 账户;**
+2. **请确保所有 Doris FE/BE 部署所在的 EC2 机器都绑定到了`ec_role`上,尤其是扩容的时候。**
+
+操作演示 Demo 如下:
+
+<a href="https://www.bilibili.com/video/BV1U3uezjEPW/?vd_source=20479f0462e74fcf98f1df731639610f">
+ <img src="/zh-CN/images/iam-role-doris-demo.png" alt="AWS IAM Role" />
+</a>
+
+更详细的配置步骤如下:
+
+#### Step1 准备工作
+
+1. 请确保源账户创建了一个`ec2_role`,Doris FE/BE 部署的 EC2 机器都绑定到了新创建的`ec2_role`;
+
+2. 请确保目标账户创建了一个`bucket_role`和对应的 bucket;
+
+EC2 机器绑定`ec2_role`成功后, `role_arn`查询如下图所示:
+
+
+
+#### Step2 配置源账户 IAM 角色 ( EC2 实例关联角色) 权限策略
+
+1. 登录 [AWS IAM 控制台](https://us-east-1.console.aws.amazon.com/iamv2/home#/home),在左侧导航栏选择 `Access management > Roles`;
+2. 找到 `EC2` 实例关联角色,单击角色名称;
+3. 在角色详情页的 `Permissions` 区域,单击 `Add permissions` 并选择 `Create inline policy`;
+4. 在 `Specify permissions` 步骤,单击 JSON 页签,然后填入如下策略,最后,单击 `Review policy`;
+
+
+
+```JSON
+{
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Action": ["sts:AssumeRole"],
+ "Resource": "*"
+ }
+ ]
+}
+```
+
+#### Step3 配置目标账户 IAM 角色信任策略和权限策略
+
+1. 登录 [AWS IAM 控制台](https://us-east-1.console.aws.amazon.com/iamv2/home#/home),在左侧导航栏选择 `Access management > Roles` 找到 `Assumed Target Role`,单击角色名称 在角色详情页上;
+2. 单击 `Trust relationships` 页签,然后在 `Trust relationships` 页签上单击 `Edit trust policy`。在 `Edit trust policy` 页面中填入如下 JSON。最后,单击 `Update policy`(需要把下面策略中的 `<ec2_iam_role_arn>` 替换为 EC2 实例关联角色的 ARN);
+
+
+
+**注意:Condition 部分中的 ExternalId 是可选的字符串配置,用于区分需要使用多个源用户 assume 同一个 role 的情况,如果配置了请在对应 doris sql 语句中填入该配置,关于 ExternalId 的详细介绍,请参照[aws 官方文档](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)**
+
+```JSON
+{
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Principal": {
+ "AWS": "<ec2_iam_role_arn>"
+ },
+ "Action": "sts:AssumeRole",
+ "Condition": {
+ "StringEquals": {
+ "sts:ExternalId": "1001"
+ }
+ }
+ }
+ ]
+}
+```
+
+3. 在角色详情页的 `Permissions` 区域,单击 `Add permissions` 并选择 `Create inline policy`,在 Specify permissions 步骤,单击 JSON 页签,输入如下 JSON 策略配置; 最后,单击 Review policy;
+
+
+
+S3 Bucket 读策略模版,适用于只需读取和 List bucket 中对象的 Doris 功能,比如 S3 Load,TVF,External Catalog 等
+
+**注意: **
+
+1. **替换对应的 bucket name 和 prefix 路径**
+
+2. **不要添加多余的“/”分割符**
+
+```json
+{
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:GetObject",
+ "s3:GetObjectVersion"
+ ],
+ "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
+ },
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:ListBucket",
+ "s3:GetBucketLocation"
+ ],
+ "Resource": "arn:aws:s3:::<bucket>",
+ }
+ ]
+}
+```
+
+S3 Bucket 写策略模板,适用于需要往 bucket 中读取和写入对象的 Doris 功能,比如 Export,Storage Vault,Resource,Repository 等
+
+**注意: **
+
+1. **替换对应的 bucket name 和 prefix 路径**
+
+2. **不要添加多余的“/”分割符**
+
+```json
+{
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:PutObject",
+ "s3:GetObject",
+ "s3:GetObjectVersion",
+ "s3:DeleteObject",
+ "s3:DeleteObjectVersion",
+ "s3:AbortMultipartUpload",
+ "s3:ListMultipartUploadParts"
+ ],
+ "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
+ },
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:ListBucket",
+ "s3:GetBucketLocation"
+ ],
+ "Resource": "arn:aws:s3:::<bucket>"
+ }
+ ]
+}
+```
+
+#### Step4 通过`role_arn`和`external_id`字段使用 Doris 对应 SQL 功能
+
+通过上述配置步骤完成 assume role 需要的权限配置后,可得到一个目标账户的`role_arn`信息和`external_id` (如有),
+
+接下来分别介绍如何通过`arn_role`和`external_id`字段使用 Doris 对应功能的 sql 语法,主要关注如下两个字段:
+
+```sql
+"s3.role_arn" = "<your-bucket-role-arn>",
+"s3.external_id" = "<your-external-id>" -- 可选参数
+```
+
+#### S3 Load
+```sql
+ LOAD LABEL s3_load_2022_04_01
+ (
+ DATA INFILE("s3://your_bucket_name/s3load_example.csv")
+ INTO TABLE test_s3load
+ COLUMNS TERMINATED BY ","
+ FORMAT AS "CSV"
+ (user_id, name, age)
+ )
+ WITH S3
+ (
+ "provider" = "S3",
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.role_arn" = "<your-bucket-role-arn>",
+ "s3.external_id" = "<your-external-id>" -- 可选参数
+ )
+ PROPERTIES
+ (
+ "timeout" = "3600"
+ );
+```
+
+**TVF**
+
+```sql
+ SELECT * FROM S3 (
+ "uri" = "s3://your_bucket/path/to/tvf_test/test.parquet",
+ "format" = "parquet",
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.role_arn" = "<your-bucket-role-arn>",
+ "s3.external_id" = "<your-external-id>" -- 可选参数
+ )
+```
+
+**External Catalog**
+
+```sql
+ CREATE CATALOG iceberg_catalog PROPERTIES (
+ "type" = "iceberg",
+ "iceberg.catalog.type" = "hadoop",
+ "warehouse" = "s3://your_bucket/dir/key",
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.role_arn" = "<your-bucket-role-arn>",
+ "s3.external_id" = "<your-external-id>" -- 可选参数
+ );
+```
+
+**Storage Vault**
+
+```sql
+CREATE STORAGE VAULT IF NOT EXISTS s3_demo_vault
+PROPERTIES (
+ "type" = "S3",
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.bucket" = "<your-bucket>",
+ "s3.role_arn" = "<your-bucket-role-arn>",
+ "s3.external_id" = "<your-external-id>", -- 可选参数
+ "s3.root.path" = "s3_demo_vault_prefix",
+ "provider" = "S3",
+ "use_path_style" = "false"
+);
+```
+
+**Export**
+
+```sql
+EXPORT TABLE s3_test TO "s3://your_bucket/a/b/c"
+PROPERTIES (
+ "column_separator"="\\x07",
+ "line_delimiter" = "\\x07"
+) WITH S3 (
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.role_arn" = "<your-bucket-role-arn>",
+ "s3.external_id" = "<your-external-id>"
+)
+```
+
+**Repository**
+
+```sql
+CREATE REPOSITORY `s3_repo`
+WITH S3
+ON LOCATION "s3://your_bucket/s3_repo"
+PROPERTIES
+(
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.role_arn" = "<your-bucket-role-arn>",
+ "s3.external_id" = "<your-external-id>"
+);
+```
+
+**Resource**
+
+```sql
+CREATE RESOURCE "remote_s3"
+PROPERTIES
+(
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1",
+ "s3.bucket" = "<your-bucket>",
+ "s3.role_arn" = "<your-bucket-role-arn>",
+ "s3.external_id" = "<your-external-id>"
+);
+```
+
+### AWS EKS集群中IAM Role认证鉴权
+
+对于在 Amazon EKS 集群中运行的应用(例如 Apache Doris),要授予其 AWS Identity and Access Management(IAM)权限,Amazon EKS 提供了以下两种主要方式:
+
+**1. 服务账户的 IAM 角色 (IRSA)**
+
+**2. EKS 容器组身份 (Pod Identity)**
+
+这两种方式均需在 EKS 集群中正确配置IAM Role和对应的信任策略、IAM策略, 具体配置方法请参阅AWS官方文档:
+
+[Granting AWS Identity and Access Management permissions to workloads on Amazon Elastic Kubernetes Service clusters](https://docs.aws.amazon.com/eks/latest/userguide/service-accounts.html#service-accounts-iam)
+
+Doris FE/BE自动通过`AWSCredentialsProviderChain`获取凭证
+
+### Bucket Policy 认证鉴权
+
+对于IAM Role部署的Doris机器,导入、导出、TVF的场景也支持使用 Amazon S3 存储桶策略来保护对AWS S3存储桶中的对象进行访问,
+这样可以限制只有EC2机器所属用户才能访问对象存储桶,具体步骤如下:
+
+1、设置目标存储桶的Bucket Policy
+
+```json
+{
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Principal": {
+ "AWS": [
+ "arn:aws:iam::111122223333:root"
+ ]
+ },
+ "Action": [
+ "s3:PutObject",
+ "s3:GetObject",
+ "s3:GetObjectVersion",
+ "s3:DeleteObject",
+ "s3:DeleteObjectVersion",
+ "s3:AbortMultipartUpload",
+ "s3:ListMultipartUploadParts"
+ ],
+ "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
+ },
+ {
+ "Effect": "Allow",
+ "Principal": {
+ "AWS": [
+ "arn:aws:iam::111122223333:root"
+ ]
+ },
+ "Action": [
+ "s3:ListBucket",
+ "s3:GetBucketLocation"
+ ],
+ "Resource": "arn:aws:s3:::<bucket>",
+ }
+ ]
+}
+```
+
+请将`arn:aws:iam::111122223333:root` 替换为ec2机器所绑定的账户或者Role的ARN
+
+2、使用对应功能的SQL语法进行数据访问,不需要ak/sk,arn等信息
+
+```sql
+ SELECT * FROM S3 (
+ "uri" = "s3://your_bucket/path/to/tvf_test/test.parquet",
+ "format" = "parquet",
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com",
+ "s3.region" = "us-east-1"
+ )
+```
+
+Doris FE/BE自动通过`AWSCredentialsProviderChain`获取凭证
+
+参考文档:[Bucket Policy](https://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/example-bucket-policies.html)
+
+### 鉴权方式最佳实践
+| 鉴权方式 | 适用场景 | 优 点 | 缺 点 |
+| :-------------------------------------------- | :----------------------------------------- | ----------------------- | -------- |
+| AK/SK 鉴权方式 | 私有化部署安全性可控或非AWS S3的对象存储的导入/导出/StorageVault场景 | 配置简单,支持兼容AWS S3的对象存储 | 存在密钥泄漏风险,需要手动进行密钥轮换 |
+| IAM Role 鉴权方式 | AWS S3公有云安全性要求较高的导入/导出/StorageVault场景 | 安全性高,自动轮换AWS凭证, 权限配置集中| 配置Bucket Policy/Trust流程复杂 |
+| Bucket Policy 鉴权方式 | AWS S3公有云,bucket数量较少的导入/导出/StorageVault场景 | 配置流程复杂度适中,遵循最小权限原则,自动探测AWS凭证 | 权限配置分散在各个bucket policy中 |
+
+### FAQ
+
+#### 1. 如何设置`BE`和`Recycler`的Aws Sdk DEBUG级别日志?
+be.conf和doris_cloud.conf配置aws_log_level=5,并重启进程生效
+* 类型:int32
+* 描述:AWS SDK 的日志级别
+ ```
+ Off = 0,
+ Fatal = 1,
+ Error = 2,
+ Warn = 3,
+ Info = 4,
+ Debug = 5,
+ Trace = 6
+ ```
+* 默认值:2
+
+#### 2.设置Aws Sdk DEBUG级别日志后,be.log/recycler.log报如下错误:
+`OpenSSL SSL_connect: Connection reset by peer in connection to sts.me-south-1.amazonaws.com:443 `
+
+请检查aws vpc网络配置或者防火墙端口配置是否存在问题,导致无法访问aws对应region的sts服务(可通过telnet host:port确认)
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/integrations/aws-iam-role.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/integrations/aws-iam-role.md
new file mode 100644
index 00000000000..cd65e1fab7e
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/integrations/aws-iam-role.md
@@ -0,0 +1,81 @@
+---
+{
+ "title": "Apache Doris IAM Assume Role工作原理",
+ "language": "zh-CN"
+}
+---
+
+# Apache Doris IAM Assume Role工作原理
+
+## 一、传统AK/SK方式访问AWS资源存在的问题
+
+### 密钥管理困境:
+- **长期暴露风险**:静态AK/SK需硬编码于配置文件中,一旦因代码泄露、误提交或恶意窃取导致密钥扩散,攻击者可永久获得等同于密钥所有者的完整权限,引发持续性的数据泄露、资源篡改及资金损失风险;
+- **审计盲区**:多用户/多服务共享同一组密钥时,云操作日志仅记录密钥身份而无法关联具体使用者,无法追溯真实责任人或业务模块;
+- **运维成本高**:密钥轮换灾难,需手动轮换业务模块密钥,容易出错触发服务中断;
+- **权限管理失控**:账户级粗放授权无法满足服务/实例级的最小权限管控需求。
+
+## 二、AWS IAM ASSUME ROLE机制介绍
+
+### AWS IAM Assume Role 是什么?
+AWS Assume Role 是一种安全身份切换机制,允许一个可信实体(如IAM用户、EC2实例或外部账号)通过STS(安全令牌服务)临时获取目标角色的权限,其运作流程如下:
+
+
+
+### 使用AWS IAM Assume Role方式访问的优点:
+- 动态令牌机制(15分钟~12小时有效期)替代永久密钥
+- 通过 External ID 实现跨账号安全隔离,并且可通过AWS后台服务进行审计
+- 基于角色的最小权限原则(Principle of Least Privilege)
+
+### AWS IAM Assume Role访问S3 Bucket的鉴权过程:
+
+
+
+#### 阶段1: 源用户身份验证
+1. **权限策略检查**
+ - 源用户发起AssumeRole请求时,源账户的IAM策略引擎首先验证:该用户是否被授权调用sts:AssumeRole操作?
+ - 检查依据:附着在源用户身份上的IAM Permissions Policies
+
+2. **信任关系校验**
+ - 通过STS服务向目标账户发起请求:
+ - 源用户是否在目标角色的信任策略白名单中?
+ - 检查依据:目标角色绑定的IAM Trust Relationships Policies(明确允许哪些账号/用户担任该角色)
+
+#### 阶段2: 目标角色权限激活
+3. **临时凭证生成**
+ 若信任关系验证通过,STS生成三要素临时凭证
+ ```json
+ {
+ "AccessKeyId": "***",
+ "SecretAccessKey": "***",
+ "SessionToken": "***" // 有效期15min-12h
+ }
+ ```
+
+4. **目标角色权限验证**
+ - 目标角色使用临时凭证访问S3前,目标账户的IAM策略引擎校验:该角色是否被授权执行请求的S3操作?(如s3:GetObject、s3:PutObject等)
+ - 检查依据:附着在目标角色上的IAM Permissions Policies(定义角色能做什么)
+
+#### 阶段3: 资源操作执行
+5. **访问存储桶**
+ 全部验证通过后,目标角色才可执行S3 API操作
+
+## 三、Doris如何应用AWS IAM Assume Role鉴权机制
+1. Doris通过将FE、BE进程所部署的AWS EC2 Instances绑定到Source Account来使用AWS IAM Assume Role功能,主要流程如下图所示:
+
+
+
+2. 完成配置后Doris FE/BE进程会自动获取EC2 Instance的Profile执行Assume Role操作访问Bucket。扩容时BE节点会自动检测新EC2 Instance是否成功绑定IAM Role,防止漏配;
+
+3. Doris的S3 Load、TVF、Export、Resource、Repository、Storage Vault等功能在3.0.6+版本均支持AWS Assume Role方式,执行SQL相关功能时会进行连通性检测:
+ ```sql
+ CREATE REPOSITORY `s3_repo`
+ WITH S3 ON LOCATION "s3://bucket/path/"
+ PROPERTIES (
+ "s3.role_arn" = "arn:aws:iam::1234567890:role/doris-s3-role",
+ "s3.external_id" = "doris-external-id",
+ "timeout" = "3600"
+ );
+ ```
+其中"s3.role_arn" 对应填入AWS IAM Account2下的Iam role2的arn值,"s3.external_id"对应填入Trust Relationships Policies中配置的externalId的值(可选配置), 更多功能SQL语句功能详细参考:
+[AWS 认证和鉴权](../../../admin-manual/auth/integrations/aws-authentication-and-authorization.md#assumed-role-authentication).
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/ldap.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/ldap.md
new file mode 100644
index 00000000000..f8fd74ee575
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/ldap.md
@@ -0,0 +1,264 @@
+---
+{
+ "title": "基于 LDAP 的用户认证",
+ "language": "zh-CN"
+}
+---
+
+# LDAP
+
+接入第三方 LDAP 服务为 Doris 提供验证登录和组授权服务。
+
+LDAP 验证登录指的是接入 LDAP 服务的密码验证来补充 Doris 的验证登录。Doris 优先使用 LDAP 验证用户密码,如果 LDAP 服务中不存在该用户则继续使用 Doris 验证密码,如果 LDAP 密码正确但是 Doris 中没有对应账户则创建临时用户登录 Doris。
+
+LDAP 组授权是将 LDAP 中的 group 映射到 Doris 中的 Role,如果用户在 LDAP 中属于多个用户组,登录 Doris 后用户将获得所有组对应 Role 的权限,要求组名与 Role 名字相同。
+
+## 名词解释
+
+- LDAP:轻量级目录访问协议,能够实现账号密码的集中管理。
+- 权限 Privilege:权限作用的对象是节点、数据库或表。不同的权限代表不同的操作许可。
+- 角色 Role:Doris 可以创建自定义命名的角色。角色可以被看做是一组权限的集合。
+
+## LDAP 相关概念
+
+在 LDAP 中,数据是按照树型结构组织的。
+
+### 示例(下文的介绍都将根据这个例子进行展开)
+
+```
+- dc=example,dc=com
+ - ou = ou1
+ - cn = group1
+ - cn = user1
+ - ou = ou2
+ - cn = group2
+ - cn = user2
+ - cn = user3
+```
+
+### LDAP 名词解释
+
+- dc(Domain Component): 可以理解为一个组织的域名,作为树的根结点
+- dn(Distinguished Name): 相当于唯一名称,例如 user1 的 dn 为 cn=user1,ou=ou1,dc=example,dc=com user2 的 dn 为 cn=user2,cn=group2,ou=ou2,dc=example,dc=com
+- rdn(Relative Distinguished Name): dn 的一部分,user1 的四个 rdn 为 cn=user1 ou=ou1 dc=example 和 dc=com
+- ou(Organization Unit): 可以理解为子组织,user 可以放在 ou 中,也可以直接放在 example.com 域中
+- cn(common name):名字
+- group: 组,可以理解为 doris 的角色
+- user: 用户,和 doris 的用户等价
+- objectClass:可以理解为每行数据的类型,比如怎么区分 group1 是 group 还是 user,每种类型的数据下面要求有不同的属性,比如 group 要求有 cn 和 member(user 列表),user 要求有 cn,password,uid 等
+
+## 启用 LDAP 认证
+
+### server 端配置
+
+在 `fe/conf/fe.conf` 文件中配置认证方式为 ldap `authentication_type=ldap`。
+
+在 `fe/conf/ldap.conf` 文件中配置 LDAP 基本信息,
+
+另有 LDAP 管理员密码需要使用 sql 语句进行设置。
+
+#### 配置 `fe/conf/ldap.conf` 文件
+
+- `ldap_host = 127.0.0.1`
+
+ LDAP 服务 ip。
+
+- `ldap_port = 389`
+
+ LDAP 服务端口,默认明文传输端口为 389,目前 Doris 的 LDAP 功能仅支持明文密码传输。
+
+- `ldap_admin_name = cn=admin,dc=domain,dc=com`
+
+ LDAP 管理员账户“Distinguished Name”。当用户使用 LDAP 身份验证 Doris 时,Doris 会绑定该管理员账户在 LDAP 中搜索用户信息。
+
+- `ldap_user_basedn = ou=people,dc=domain,dc=com`
+
+ Doris 在 LDAP 中搜索用户信息时的 base dn,例如只允许上例中的 user2 登陆 Doris,此处配置为 ou=ou2,dc=example,dc=com 如果允许上例中的 user1,user2,user3 都能登陆 Doris,此处配置为 dc=example,dc=com
+
+- `ldap_user_filter = (&(uid={login}))`
+
+ Doris 在 LDAP 中搜索用户信息时的过滤条件,占位符 `{login}` 会被替换为登录用户名。必须保证通过该过滤条件搜索的用户唯一,否则 Doris 无法通过 LDAP 验证密码,登录时会出现 `ERROR 5081 (42000): user is not unique in LDAP server.` 的错误信息。
+
+ 例如使用 LDAP 用户节点 uid 属性作为登录 Doris 的用户名可以配置该项为:
+
+ `ldap_user_filter = (&(uid={login}))`
+
+ 使用 LDAP 用户邮箱前缀作为用户名可配置该项:
+
+ `ldap_user_filter = (&(mail={login}@baidu.com))`
+
+- `ldap_group_basedn = ou=group,dc=domain,dc=com`
+
+ Doris 在 LDAP 中搜索组信息时的 base dn。如果不配置该项,将不启用 LDAP 组授权。同 `ldap_user_basedn` 类似,限制 doris 搜索 group 时的范围。
+
+#### 设置 LDAP 管理员密码
+
+配置好 ldap.conf 文件后启动 fe,使用 root 或 admin 账号登录 Doris,执行 sql:
+
+```sql
+set ldap_admin_password = password('ldap_admin_password');
+```
+
+### Client 端配置
+
+#### MySql Client
+
+客户端使用 LDAP 验证需要启用 mysql 客户端明文验证插件,使用命令行登录 Doris 可以使用下面两种方式之一启用 mysql 明文验证插件:
+
+- 设置环境变量 `LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN` 值 1
+
+ 例如在 linux 或者 mac 环境中可以使用:
+
+ ```shell
+ echo "export LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN=1" >> ~/.bash_profile && source ~/.bash_profile
+ ```
+
+- 每次登录 Doris 时添加参数 `--enable-cleartext-plugin`
+
+ ```shell
+ mysql -hDORIS_HOST -PDORIS_PORT -u user -p --enable-cleartext-plugin
+
+ 输入 ldap 密码
+ ```
+#### Jdbc Client
+
+使用 Jdbc Client 登录 Doris 时,需要自定义 plugin。
+
+首先,创建一个名为 MysqlClearPasswordPluginWithoutSSL 的类,继承自 MysqlClearPasswordPlugin。在该类中,重写 requiresConfidentiality() 方法,并返回 false。
+
+``` java
+public class MysqlClearPasswordPluginWithoutSSL extends MysqlClearPasswordPlugin {
+@Override
+public boolean requiresConfidentiality() {
+ return false;
+ }
+}
+```
+在获取数据库连接时,需要将自定义的 plugin 配置到属性中
+
+即(xxx 为自定义类的包名)
+- authenticationPlugins=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL
+- defaultAuthenticationPlugin=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL
+- disabledAuthenticationPlugins=com.mysql.jdbc.authentication.MysqlClearPasswordPlugin
+
+eg:
+```sql
+ jdbcUrl = "jdbc:mysql://localhost:9030/mydatabase?authenticationPlugins=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL&defaultAuthenticationPlugin=xxx.xxx.xxx.MysqlClearPasswordPluginWithoutSSL&disabledAuthenticationPlugins=com.mysql.jdbc.authentication.MysqlClearPasswordPlugin";
+
+```
+
+## LDAP 认证详解
+
+LDAP 密码验证和组授权是 Doris 密码验证和授权的补充,开启 LDAP 功能并不能完全替代 Doris 的密码验证和授权,而是与 Doris 密码验证和授权并存。
+
+### LDAP 验证登录详解
+
+开启 LDAP 后,用户在 Doris 和 LDAP 中存在以下几种情况:
+
+| LDAP 用户 | Doris 用户 | 密码 | 登录情况 | 登录 Doris 的用户 |
+| -------- | --------- | --------- | -------- | --------------- |
+| 存在 | 存在 | LDAP 密码 | 登录成功 | Doris 用户 |
+| 存在 | 存在 | Doris 密码 | 登录失败 | 无 |
+| 不存在 | 存在 | Doris 密码 | 登录成功 | Doris 用户 |
+| 存在 | 不存在 | LDAP 密码 | 登录成功 | Ldap 临时用户 |
+
+开启 LDAP 后,用户使用 mysql client 登录时,Doris 会先通过 LDAP 服务验证用户密码,如果 LDAP 存在用户且密码正确,Doris 则使用该用户登录;此时 Doris 若存在对应账户则直接登录该账户,如果不存在对应账户则为用户创建临时账户并登录该账户。临时账户具有具有相应对权限(参见 LDAP 组授权),仅对当前连接有效,Doris 不会创建该用户,也不会产生创建用户对元数据。
+如果 LDAP 服务中不存在登录用户,则使用 Doris 进行密码认证。
+
+以下假设已开启 LDAP 认证,配置 ldap_user_filter = (&(uid={login})),且其他配置项都正确,客户端设置环境变量 LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN=1
+
+例如:
+
+1. Doris 和 LDAP 中都存在账户:
+
+ 存在 Doris 账户:`jack@'172.10.1.10'`,密码:`123456`
+
+ LDAP 用户节点存在属性:`uid: jack` 用户密码:`abcdef`
+
+ 使用以下命令登录 Doris 可以登录 `jack@'172.10.1.10'` 账户:
+
+ ```shell
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p abcdef
+ ```
+
+ 使用以下命令将登录失败:
+
+ ```shell
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p 123456
+ ```
+
+2. LDAP 中存在用户,Doris 中不存在对应账户:
+
+ LDAP 用户节点存在属性:`uid: jack` 用户密码:`abcdef`
+
+ 使用以下命令创建临时用户并登录 jack@'%',临时用户具有基本权限 DatabasePrivs:Select_priv,用户退出登录后 Doris 将删除该临时用户:
+
+ ```shell
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p abcdef
+ ```
+
+3. LDAP 不存在用户:
+
+ 存在 Doris 账户:`jack@'172.10.1.10'`,密码:`123456`
+
+ 使用 Doris 密码登录账户,成功:
+
+ ```shell
+ mysql -hDoris_HOST -PDoris_PORT -ujack -p 123456
+ ```
+
+### LDAP 组授权详解
+
+LDAP 用户 dn 是 LDAP 组节点的“member”属性则 Doris 认为用户属于该组。LDAP 组授权是将 LDAP 中的 group 映射到 Doris 中的 role,并将所有对应的 role 权限授予登录用户,用户退出登录后 Doris 会撤销对应的 role 权限。在使用 LDAP 组授权前应该在 Doris 中创建相应的 role,并为 role 授权。
+
+登录用户权限跟 Doris 用户和组权限有关,见下表:
+
+| LDAP 用户 | Doris 用户 | 登录用户的权限 |
+| -------- | --------- | -------------------------- |
+| 存在 | 存在 | LDAP 组权限 + Doris 用户权限 |
+| 不存在 | 存在 | Doris 用户权限 |
+| 存在 | 不存在 | LDAP 组权限 |
+
+如果登录的用户为临时用户,且不存在组权限,则该用户默认具有 information_schema 的 select_priv 权限
+
+举例:
+
+LDAP 用户 dn 是 LDAP 组节点的 `member` 属性则认为用户属于该组,Doris 会截取组 dn 的第一个 Rdn 作为组名。
+
+例如用户 dn 为 `uid=jack,ou=aidp,dc=domain,dc=com`,组信息如下:
+
+```text
+dn: cn=doris_rd,ou=group,dc=domain,dc=com
+objectClass: groupOfNames
+member: uid=jack,ou=aidp,dc=domain,dc=com
+```
+
+则组名为 `doris_rd`。
+
+假如 jack 还属于 LDAP 组 `doris_qa`、`doris_pm`;Doris 存在 role:`doris_rd`、`doris_qa`、`doris_pm`,在使用 LDAP 验证登录后,用户不但具有该账户原有的权限,还将获得 role `doris_rd`、`doris_qa` 和 `doris_pm` 的权限。
+
+>注意:
+>
+> user 属于哪个 group 和 LDAP 树的组织结构无关,示例部分的 user2 并不一定属于 group2
+> 若想让 user2 属于 group2,需要在 group2 的 member 属性中添加 user2
+
+### LDAP 信息缓存
+
+为了避免频繁访问 LDAP 服务,Doris 会将 LDAP 信息缓存到内存中,可以通过 ldap.conf 中的`ldap_user_cache_timeout_s`配置项指定 LDAP 用户的缓存时间,默认为 12 小时;在修改了 LDAP 服务中的信息或者修改了 Doris 中 LDAP 用户组对应的 Role 权限后,可能因为缓存而没有及时生效,可以通过 refresh ldap 语句刷新缓存,详细查看[REFRESH-LDAP](../../sql-manual/sql-statements/account-management/REFRESH-LDAP)。
+
+## LDAP 验证的局限
+
+- 目前 Doris 的 LDAP 功能只支持明文密码验证,即用户登录时,密码在 client 与 fe 之间、fe 与 LDAP 服务之间以明文的形式传输。
+
+## 常见问题
+
+- 怎么判断 LDAP 用户在 Doris 中有哪些角色?
+
+ 使用 LDAP 用户在 doris 中登录,`show grants;`能查看当前用户有哪些角色。其中 ldapDefaultRole 是每个 ldap 用户在 doris 中都有的默认角色。
+
+- LDAP 用户在 Doris 中的角色比预期少怎么排查?
+
+ 1. 通过`show roles;`查看预期的角色在 doris 中是否存在,如果不存在,需要通过` CREATE ROLE role_name;`创建角色。
+ 2. 检查预期的 group 是否在`ldap_group_basedn`对应的组织结构下。
+ 3. 检查预期 group 是否包含 member 属性。
+ 4. 检查预期 group 的 member 属性是否包含当前用户。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/ranger.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/ranger.md
new file mode 100644
index 00000000000..ed7b247e92f
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/ranger.md
@@ -0,0 +1,284 @@
+---
+{
+ "title": "基于 Apache Ranger 的鉴权管理",
+ "language": "zh-CN"
+}
+---
+
+Apache Ranger 是一个用来在 Hadoop 平台上进行监控,启用服务,以及全方位的数据安全访问管理的安全框架。
+
+在 2.1.0 版本中,Doris 支持通过集成 Apache Ranger,进行统一的权限管理。
+
+> 注意:
+>
+> - 目前该功能是实验性功能,在 Ranger 中可配置的资源对象和权限可能会在之后的版本中有所变化。
+>
+> - Apache Ranger 版本需在 2.4.0 以上。
+
+## 安装步骤
+
+### 安装 Doris Ranger 插件
+
+1. 下载以下文件
+
+ - [ranger-doris-plugin-3.0.0-SNAPSHOT.jar](https://selectdb-doris-1308700295.cos.ap-beijing.myqcloud.com/ranger/ranger-doris-plugin-3.0.0-SNAPSHOT.jar)
+ - [mysql-connector-java-8.0.25.jar](https://selectdb-doris-1308700295.cos.ap-beijing.myqcloud.com/release/jdbc_driver/mysql-connector-java-8.0.25.jar)
+
+2. 将下载好的文件放到 Ranger 服务的 `ranger-plugins/doris` 目录下,如:
+
+ ```
+ /usr/local/service/ranger/ews/webapp/WEB-INF/classes/ranger-plugins/doris/ranger-doris-plugin-3.0.0-SNAPSHOT.jar
+ /usr/local/service/ranger/ews/webapp/WEB-INF/classes/ranger-plugins/doris/mysql-connector-java-8.0.25.jar
+ ```
+
+3. 重启 Ranger 服务。
+
+4. 下载 [ranger-servicedef-doris.json](https://github.com/morningman/ranger/blob/doris-plugin/agents-common/src/main/resources/service-defs/ranger-servicedef-doris.json)
+
+5. 执行以下命令上传定义文件到 Ranger 服务:
+
+ ```
+ curl -u user:password -X POST \
+ -H "Accept: application/json" \
+ -H "Content-Type: application/json" \
+ http://172.21.0.32:6080/service/plugins/definitions \
+ -d@ranger-servicedef-doris.json
+ ```
+
+ 其中用户名密码是登录 Ranger WebUI 所使用的用户名密码。
+
+ 服务地址端口可以再 `ranger-admin-site.xml` 配置文件的 `ranger.service.http.port` 配置项查看。
+
+ 如执行成功,会返回 Json 格式的服务定义,如:
+
+ ```
+ {
+ "id": 207,
+ "guid": "d3ff9e41-f9dd-4217-bb5f-3fa9996454b6",
+ "isEnabled": true,
+ "createdBy": "Admin",
+ "updatedBy": "Admin",
+ "createTime": 1705817398112,
+ "updateTime": 1705817398112,
+ "version": 1,
+ "name": "doris",
+ "displayName": "Apache Doris",
+ "implClass": "org.apache.ranger.services.doris.RangerServiceDoris",
+ "label": "Doris",
+ "description": "Apache Doris",
+ "options": {
+ "enableDenyAndExceptionsInPolicies": "true"
+ },
+ ...
+ }
+ ```
+
+ 如想重新创建,则可以使用以下命令删除服务定义后,再重新上传:
+
+ ```
+ curl -v -u user:password -X DELETE \
+ http://172.21.0.32:6080/service/plugins/definitions/207
+ ```
+
+ 其中 `207` 是创建时返回的 id。删除前,需在 Ranger WebUI 界面删除已创建的 Doris 服务。
+
+ 也可以通过以下命令列举当前已添加的服务定义,以便获取 id:
+
+ ```
+ curl -v -u user:password -X GET \
+ http://172.21.0.32:6080/service/plugins/definitions/
+ ```
+
+### 配置 Doris Ranger 插件
+
+安装完毕后,打开 Ranger WebUI,可以再 Service Manger 界面中看到 Apache Doris 插件:
+
+
+
+点击插件旁边的 `+` 号添加一个 Doris 服务:
+
+
+
+Config Properties 部分参数含义如下:
+
+- `Username`/`Pasword`:Doris 集群的用户名密码,这里建议使用 Admin 用户。
+- `jdbc.driver_class`:连接 Doris 使用的 JDBC 驱动。`com.mysql.cj.jdbc.Driver`
+- `jdbc.url`:Doris 集群的 JDBC url 连接串。`jdbc:mysql://172.21.0.101:9030?useSSL=false`
+- 额外参数:
+ - `resource.lookup.timeout.value.in.ms`:获取元信息的超时时间,建议填写 `10000`,即 10 秒。
+
+可以点击 `Test Connection` 检查是否可以联通。
+
+之后点击 `Add` 添加服务。
+
+之后,可以在 Service Manger 界面的 Apache Doris 插件中看到创建的服务,点击服务,即可开始配置 Ranger。
+
+### 配置 Doris 集群
+
+1. 在所有 FE 的 conf 目录创建 `ranger-doris-security.xml` 文件,内容如下:
+
+ ```
+ <?xml version="1.0" encoding="UTF-8"?>
+ <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
+ <configuration>
+ <property>
+ <name>ranger.plugin.doris.policy.cache.dir</name>
+ <value>/path/to/ranger/cache/</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.pollIntervalMs</name>
+ <value>30000</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.rest.client.connection.timeoutMs</name>
+ <value>60000</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.rest.client.read.timeoutMs</name>
+ <value>60000</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.rest.url</name>
+ <value>http://172.21.0.32:6080</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.policy.source.impl</name>
+ <value>org.apache.ranger.admin.client.RangerAdminRESTClient</value>
+ </property>
+ <property>
+ <name>ranger.plugin.doris.service.name</name>
+ <value>doris</value>
+ </property>
+ </configuration>
+ ```
+
+ 其中需要将 `ranger.plugin.doris.policy.cache.dir` 和 `ranger.plugin.doris.policy.rest.url` 改为实际值。
+
+2. 在所有 FE 的 conf 目录创建 `ranger-doris-audit.xml` 文件,内容如下:
+
+ ```
+ <?xml version="1.0" encoding="UTF-8"?>
+ <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
+ <configuration>
+ </configuration>
+ ```
+
+3. 在所有 FE 的 conf 目录创建 `log4j.properties` 文件,内容如下:
+
+ ```
+ log4j.rootLogger = warn,stdout,D
+
+ log4j.appender.stdout = org.apache.log4j.ConsoleAppender
+ log4j.appender.stdout.Target = System.out
+ log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
+ log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
+
+ log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
+ log4j.appender.D.File = /path/to/fe/log/ranger.log
+ log4j.appender.D.Append = true
+ log4j.appender.D.Threshold = INFO
+ log4j.appender.D.layout = org.apache.log4j.PatternLayout
+ log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
+ ```
+
+ 其中 `log4j.appender.D.File` 改为实际值,用于存放 Ranger 插件的日志。
+
+4. 在所有 FE 的 fe.conf 中添加配置:
+
+ `access_controller_type=ranger-doris`
+
+5. 重启所有 FE 节点即可。
+
+## 资源和权限
+
+1. 目前 Ranger 中支持的 Doris 资源包括:
+
+ - `Catalog`
+ - `Database`
+ - `Table`
+ - `Column`
+ - `Resource`
+ - `Workload Group`
+
+2. 目前 Ranger 中支持的 Doris 权限包括:
+
+ - `SHOW`
+ - `SHOW_VIEW`
+ - `SHOW_RESOURCES`
+ - `SHOW_WORKLOAD_GROUP`
+ - `LOAD`
+ - `ALTER`
+ - `CREATE`
+ - `ALTER_CREATE`
+ - `ALTER_CREATE_DROP`
+ - `DROP`
+ - `SELECT`
+ - `USAGE`
+
+## 最佳实践
+
+### 配置权限
+1. 在 Doris 中创建 `user1`。
+2. 在 Doris 中,先使用 `admin` 用户创建一个 Catalog:`hive`。
+3. 在 Ranger 中创建 `user1`。
+
+#### 全局权限
+相当于 Doris 内部授权语句的 `grant select_priv on *.*.* to user1`;
+- catalog 同级下拉框可以找到 global 选项
+- 输入框里只能输入 `*`
+
+ 
+
+#### Catalog 权限
+相当于 Doris 内部授权语句的 `grant select_priv on hive.*.* to user1`;
+
+ 
+
+#### Database 权限
+相当于 Doris 内部授权语句的 `grant select_priv on hive.tpch.* to user1`;
+
+
+
+#### Table 权限
+相当于 Doris 内部授权语句的 `grant select_priv on hive.tpch.user to user1`;
+
+
+
+#### Column 权限
+相当于 Doris 内部授权语句的 `grant select_priv(name,age) on hive.tpch.user to user1`;
+
+
+
+#### Resource 权限
+相当于 Doris 内部授权语句的 `grant usage_priv on resource 'resource1' to user1`;
+- catalog 同级下拉框可以找到 resource 选项
+
+
+
+#### Workload Group 权限
+相当于 Doris 内部授权语句的 `grant usage_priv on workload group 'group1' to user1`;
+- catalog 同级下拉框可以找到 workload group 选项
+
+
+
+### Row Policy 示例
+
+> 2.1.3 版本支持
+
+1. 参考 配置权限 给 user1 分配 internal.db1.user 表的 select 权限。
+2. 在 Ranger 中添加一个 Row Level Filter policy
+
+ 
+
+3. 使用 user1 登录 Doris。执行 `select * from internal.db1.user`,只能看到满足 `id > 3` 且 `age = 2` 的数据。
+
+### Data Mask 示例
+
+> 2.1.3 版本支持
+
+1. 参考 配置权限 给 user1 分配 internal.db1.user 表的 select 权限。
+2. 在 Ranger 中添加一个 Masking policy
+
+ 
+
+3. 使用 user1 登录 Doris。执行 `select * from internal.db1.user`,看到的 phone 是按照指定规则脱敏后的数据。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/security-overview.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/security-overview.md
new file mode 100644
index 00000000000..e159dab733d
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/auth/security-overview.md
@@ -0,0 +1,32 @@
+---
+{
+ "title": "安全概览",
+ "language": "zh-CN"
+}
+---
+
+Doris 提供以下机制管理数据安全:
+
+身份认证:Doris 支持用户名/密码与 LDAP 认证方式。
+
+- 内置认证:Doris 内置了用户名/密码的认证方式,可以自定义密码策略;
+
+- LDAP 认证:Doris 可以通过 LDAP 服务集中管理用户凭证,简化访问控制并增强系统的安全性。
+
+权限管控:Doris 支持基于角色的访问控制或继承 Ranger 实现集中化的权限管理。
+
+- 基于角色的访问控制(RBAC),Doris 可以根据用户角色与权限,限制其对数据库资源的访问与操作;
+
+- Ranger 权限管理:Doris 可以通过集成 Ranger 实现集中化的权限管理,允许管理员为不同的用户和组设置细粒度的访问控制策略。
+
+审计与日志记录:Doris 可以开启审计日志,记录用户的所有操作行为,包括登录,查询,数据修改等行为,便于事后审计与问题追踪;
+
+数据加密与脱敏:Doris 支持对表中的数据进行加密与脱敏,防止未授权的访问造成敏感数据泄漏;
+
+数据传输加密:Doris 支持 SSL 加密协议,确保客户端与 Doris 服务器之间的数据传输安全,防止数据在传输过程中被窃取或篡改;
+
+细粒度访问控制:Doris 中可以基于规则配置数据行/列管控用户访问权限。
+
+JAVA-UDF安全:Doris 支持用户自定义函数功能,所以需要Root 管理员审查用户 UDF 的实现,确保实现逻辑的操作安全,防止在 UDF 中执行高危操作,例如删除数据和破坏系统等。
+
+第三方包:在使用 Doris 的 JDBC Catalog、UDF 等功能时,如需引入第三方包,管理员需自行确保这些包来源安全可信。建议仅使用来自官方渠道或受信任社区的依赖包,以降低安全风险。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/elastic-expansion.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/elastic-expansion.md
new file mode 100644
index 00000000000..c5bcd3be4f3
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/elastic-expansion.md
@@ -0,0 +1,122 @@
+---
+{
+ "title": "弹性扩缩容",
+ "language": "zh-CN"
+}
+
+---
+
+Doris 支持在线弹性扩容,通过动态添加或移除节点,用户无需中断服务即可满足业务增长需求或降低空闲资源的浪费。扩缩容 BE 节点时,不影响集群可用性,但会涉及到数据搬迁,建议在业务闲时进行扩缩容操作。
+
+## 扩缩容 FE 集群
+
+Doris 的 FE 节点分为以下三种角色,每一个 FE 节点都有全量的元数据信息:
+
+* Master 节点:负责元数据的读写操作,当 Master 的元数据发生变化,会通过 BDB JE 协议同步到非 Master 节点中,同一集群中只能有一个 Master FE 节点;
+
+* Follower 节点:负责元数据的读取操作,当 Master 节点发生故障时,Follower 节点会发起选主操作,选举出一个新的 Master 节点。在集群内,Master 与 Follower 节点总和建议为奇数个;
+
+* Observer 节点:负责元数据的读取操作,不参与选主操作。用于扩展 FE 的读服务能力。
+
+一般情况下,每台 FE 节点可以负责 10-20 台 BE 节点的负载操作,3 个 FE 节点可以满足大部分的业务需求。
+
+### 扩容 FE 集群
+
+:::info 提示:
+
+在新添加 FE 节点时,需要注意以下事项:
+
+* 新添加的 FE http_port 要与原集群中所有 FE 节点相同;
+
+* 如果添加 Follower 节点,同一级群内 Master 与 Follower 节点数量总和建议为奇数个
+
+* 通过 `show frontends` 命令可以看到当前集群内节点的端口及角色信息
+
+:::
+
+1. 启动 FE 节点:
+
+ ```bash
+ fe/bin/start_fe.sh --helper <leader_fe_host>:<edit_log_port> --daemon
+ ```
+
+ * 注册 FE 节点:
+
+ * 将节点注册为 Follower FE:
+
+ ```sql
+ ALTER SYSTEM ADD FOLLOWER "<follower_host>:<edit_log_port>";
+ ```
+
+ * 将节点注册为 Observer FE:
+
+ ```sql
+ ALTER SYSTEM ADD OBSERVER "<observer_host>:<edit_log_port>";
+ ```
+
+ * 查看新添加的 FE 节点状态:
+
+ ```sql
+ show frontends;
+ ```
+
+### 缩容 FE 集群
+
+在缩容 FE 节点时,也要保证最终集群内 Master 与 Follower 节点总和为奇数个,通过以下命令可以缩容节点:
+
+```sql
+ALTER SYSTEM DROP FOLLOWER[OBSERVER] "<fe_host>:<edit_log_port>";
+```
+在缩容后,需要手动删除 FE 目录下的文件。
+
+## 扩缩容 BE 集群
+
+### 扩容 BE 集群
+
+1. 启动 BE 进程:
+
+ ```sql
+ be/bin/start_be.sh
+ ```
+
+2. 注册 BE 节点:
+
+ ```sql
+ ALTER SYSTEM ADD backend '<be_host>:<be_heartbeat_service_port>';
+ ```
+
+### 缩容 BE 集群
+
+在缩容 BE 节点时,可以选择 DROP 或 DECOMMISSION 两种方案:
+
+| | DROP | DECOMMISSION |
+| -------- | ----------------- | ------------------------------------------- |
+| 下线原理 | 直接下线节点,删除掉 BE 节点。 | 发起命令后,会尝试将该 BE 数据迁移到其他节点上,当迁移完成后,BE 节点自动下线。 |
+| 生效周期 | 执行后立即生效。 | 待数据搬迁完成后,删除命令生效。根据集群现有数据量,可能在小时到 1 天不等时间内。 |
+| 一副本表处理方案 | 可能会造成数据丢失。 | 不会造成数据丢失。 |
+| 同时下线多个节点 | 可能会造成数据丢失。 | 不会造成数据丢失。 |
+| 生产推荐 | 不建议生产环境使用。 | 推荐在生产环境使用。 |
+
+* 通过以下命令,可以使用 DROP 方式删除 BE 节点:
+
+ ```sql
+ ALTER SYSTEM DROP backend "<be_host>:<be_heartbeat_service_port>";
+ ```
+
+* 通过以下命令,可以使用 DECOMMISSION 方式删除 BE 节点:
+
+ ```sql
+ ALTER SYSTEM DECOMMISSION backend "<be_host>:<be_heartbeat_service_port>";
+ ```
+
+DECOMMISSION 命令说明:
+
+- DECOMMISSION 是一个异步操作。执行后,可以通过 SHOW backends; 看到该 BE 节点的 SystemDecommissioned 状态为 true。表示该节点正在进行下线;
+
+- DECOMMISSION 命令可能会执行失败,如剩余 BE 存储空间不足以容纳下线 BE 上的数据,或者剩余机器数量不满足最小副本数时,该命令都无法完成,并且 BE 会一直处于 SystemDecommissioned 为 true 的状态;
+
+- DECOMMISSION 的进度,可以通过 SHOW PROC '/backends'; 中的 TabletNum 查看,如果正在进行,TabletNum 将不断减少;
+
+- 可以通过 CANCEL DECOMMISSION BACKEND "be_host:be_heartbeat_service_port"; 命令取消。取消后,该 BE 上的数据将维持当前剩余的数据量。后续 Doris 重新进行负载均衡;
+
+- 可以调整 balance_slot_num_per_path 参数调整数据搬迁速率。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/fqdn.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/fqdn.md
new file mode 100644
index 00000000000..e190444316c
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/fqdn.md
@@ -0,0 +1,95 @@
+---
+{
+ "title": "FQDN",
+ "language": "zh-CN"
+}
+---
+
+本文介绍如何启用基于 FQDN(Fully Qualified Domain Name,完全限定域名)使用 Apache Doris。FQDN 是 Internet 上特定计算机或主机的完整域名。
+
+Doris 支持 FQDN 之后,各节点之间通信完全基于 FQDN。添加各类节点时应直接指定 FQDN,例如添加 BE 节点的命令为`ALTER SYSTEM ADD BACKEND "be_host:heartbeat_service_port"`,
+
+`be_host` 此前是 BE 节点的 IP,启动 FQDN 后,`be_host` 应指定 BE 节点的 FQDN。
+
+## 前置条件
+
+1. fe.conf 文件 设置 `enable_fqdn_mode = true`。
+
+2. 集群中的所有机器都必须配置有主机名。
+
+3. 必须在集群中每台机器的 `/etc/hosts` 文件中指定集群中其他机器对应的 IP 地址和 FQDN。
+
+4. `/etc/hosts` 文件中不能有重复的 IP 地址。
+
+## 最佳实践
+
+### 新集群启用 FQDN
+
+1. 准备机器,例如想部署 3FE 3BE 的集群,可以准备 6 台机器。
+
+2. 每台机器执行`host`返回结果都唯一,假设六台机器的执行结果分别为 fe1,fe2,fe3,be1,be2,be3。
+
+3. 在 6 台机器的`/etc/hosts` 中配置 6 个 FQDN 对应的真实 IP,例如:
+ ```
+ 172.22.0.1 fe1
+ 172.22.0.2 fe2
+ 172.22.0.3 fe3
+ 172.22.0.4 be1
+ 172.22.0.5 be2
+ 172.22.0.6 be3
+ ```
+
+4. 验证:可以在 FE1 上 `ping fe2` 等,能解析出正确的 IP 并且能 Ping 通,代表网络环境可用。
+
+5. 每个 FE 节点的 fe.conf 设置 `enable_fqdn_mode = true`。
+
+6. 参考[手动部署](../../install/deploy-manually/integrated-storage-compute-deploy-manually)
+
+7. 按需在六台机器上选择几台机器部署 broker,执行`ALTER SYSTEM ADD BROKER broker_name "fe1:8000","be1:8000",...;`。
+
+### K8s 部署 Doris
+
+Pod 意外重启后,K8s 不能保证 Pod 的 IP 不发生变化,但是能保证域名不变,基于这一特性,Doris 开启 FQDN 时,能保证 Pod 意外重启后,还能正常提供服务。
+
+K8s 部署 Doris 的方法请参考[K8s 部署 Doris](../../install/deploy-on-kubernetes/integrated-storage-compute/install-doris-cluster)
+
+### 服务器变更 IP
+
+按照'新集群启用 FQDN'部署好集群后,如果想变更机器的 IP,无论是切换网卡,或者是更换机器,只需要更改各机器的`/etc/hosts`即可。
+
+### 旧集群启用 FQDN
+
+前提条件:当前程序支持`ALTER SYSTEM MODIFY FRONTEND "<fe_ip>:<edit_log_port>" HOSTNAME "<fe_hostname>"`语法,
+如果不支持,需要升级到支持该语法的版本
+
+:::caution
+注意:
+
+至少有三台 follower 才能进行如下操作,否则会造成集群无法正常启动
+:::
+
+接下来按照如下步骤操作:
+
+**1. 逐一对 Follower、Observer 节点进行以下操作 (最后操作 Master 节点):**
+
+1. 停止节点。
+
+2. 检查节点是否停止。通过 MySQL 客户端执行`show frontends`,查看该 FE 节点的 Alive 状态直至变为 false
+
+3. 为节点设置 FQDN: `ALTER SYSTEM MODIFY FRONTEND "<fe_ip>:<edit_log_port>" HOSTNAME "<fe_hostname>"`(停掉 master 后,会选举出新的 master 节点,用新的 master 节点来执行 sql 语句)
+
+4. 修改节点配置。修改 FE 根目录中的`conf/fe.conf`文件,添加配置:`enable_fqdn_mode = true`。如果在刚停止的节点对应 fe.conf 添加了配置后无法正常启动,请在所有 fe.conf 中添加配置`enable_fqdn_mode = true`后再启动刚刚停止的 fe 节点
+
+5. 启动节点。
+
+
+**2. BE 节点启用 FQDN 只需要通过 MySQL 执行以下命令,不需要对 BE 执行重启操作。**
+
+`ALTER SYSTEM MODIFY BACKEND "<backend_ip>:<HeartbeatPort>" HOSTNAME "<be_hostname>"`,如果你不知道端口 HeartbeatPort 是多少,请使用 show backends 命令来帮助寻找此端口;
+
+
+## 常见问题
+
+- 配置项 enable_fqdn_mode 可以随意更改么?
+
+ 不能随意更改,更改该配置要按照'旧集群启用 FQDN'进行操作。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/load-balancing.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/load-balancing.md
new file mode 100644
index 00000000000..f567c36d3a9
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/load-balancing.md
@@ -0,0 +1,595 @@
+---
+{
+ "title": "负载均衡",
+ "language": "zh-CN"
+}
+
+---
+
+用户通过 FE 的查询端口(`query_port`,默认 9030)使用 MySQL 协议连接 Doris。当部署多个 FE 节点时,用户可以在多个 FE 之上部署负载均衡层来实现 Doris 查询的高可用。
+
+本文档介绍多种适用于 Doris 的负载均衡方案,并介绍如何通过 Proxy Protocol 实现客户端 IP 透传。
+
+## 负载均衡
+
+本文使用以下三个 FE 节点作为示例进行步骤演示:
+
+```text
+192.168.1.101:9030
+192.168.1.102:9030
+192.168.1.103:9030
+```
+
+代理服务器所在节点:
+
+```text
+192.168.1.100
+```
+
+### 01 JDBC URL
+
+使用 JDBC URL 中自带的负载均衡配置。
+
+```text
+jdbc:mysql:loadbalance://192.168.1.101:9030,192.168.1.102:9030,192.168.1.103:9030/test_db
+```
+
+详细可以参考 [MySQL 官网文档](https://dev.mysql.com/doc/connector-j/en/connector-j-usagenotes-j2ee-concepts-managing-load-balanced-connections.html)
+
+### 02 Nginx
+
+使用 [Nginx](https://nginx.org/) TCP 反向代理实现 Doris 的负载均衡。
+
+#### 安装 Nginx
+
+请参看 [Nginx](https://nginx.org/en/docs/install.html) 官网正确安装 Nginx,这里以 Ubuntu 系统中安装 Nginx 1.18.0 版本为例展示 Nginx 的编译安装步骤。
+
+1. 安装编译依赖
+
+ ```shell
+ sudo apt-get install build-essential
+ sudo apt-get install libpcre3 libpcre3-dev
+ sudo apt-get install zlib1g-dev
+ sudo apt-get install openssl libssl-dev
+ ```
+
+2. 安装 Nginx
+
+ ```shell
+ sudo wget http://nginx.org/download/nginx-1.18.0.tar.gz
+ sudo tar zxvf nginx-1.18.0.tar.gz
+ cd nginx-1.18.0
+ sudo ./configure --prefix=/usr/local/nginx --with-stream --with-http_ssl_module --with-http_gzip_static_module --with-http_stub_status_module
+ sudo make && make install
+ ```
+
+#### 配置反向代理
+
+新建配置文件:
+
+```shell
+vim /usr/local/nginx/conf/default.conf
+```
+
+内容如下:
+
+```text
+events {
+worker_connections 1024;
+}
+stream {
+ upstream mysqld {
+ hash $remote_addr consistent;
+ server 192.168.1.101:9030 weight=1 max_fails=2 fail_timeout=60s;
+ server 192.168.1.102:9030 weight=1 max_fails=2 fail_timeout=60s;
+ server 192.168.1.103:9030 weight=1 max_fails=2 fail_timeout=60s;
+ }
+ server {
+ # Proxy port
+ listen 6030;
+ proxy_connect_timeout 300s;
+ proxy_timeout 300s;
+ proxy_pass mysqld;
+ }
+}
+```
+
+#### 启动 Nginx
+
+指定配置文件启动:
+
+```shell
+cd /usr/local/nginx
+/usr/local/nginx/sbin/nginx -c conf.d/default.conf
+```
+
+#### 验证
+
+使用代理端口进行连接:
+
+```shell
+mysql -uroot -P6030 -h192.168.1.100
+
+mysql> show databases;
++--------------------+
+| Database |
++--------------------+
+| information_schema |
+| mysql |
+| test |
++--------------------+
+2 rows in set (0.00 sec)
+```
+
+### 03 HAProxy
+
+[HAProxy](https://www.haproxy.org/) 是一个使用 C 语言编写高性能 TCP/HTTP 负载均衡器。
+
+#### 安装 HAProxy
+
+1. 下载 HAProxy
+
+ 下载地址:https://src.fedoraproject.org/repo/pkgs/haproxy/
+
+2. 解压
+
+ ```shell
+ tar -zxvf haproxy-2.6.15.tar.gz -C /opt/
+ mv haproxy-2.6.15 haproxy
+ cd haproxy
+ ```
+
+3. 编译
+
+ ```shell
+ yum install gcc gcc-c++ -y
+ make TARGET=linux-glibc PREFIX=/usr/local/haproxy
+ make install PREFIX=/usr/local/haproxy
+ ```
+
+#### 配置 HAProxy
+
+1. 配置 haproxy.conf 文件
+
+ 打开配置文件:
+
+ ```shell
+ vim /etc/rsyslog.d/haproxy.conf
+ ```
+
+ 内容如下:
+
+ ```text
+ $ModLoad imudp
+ $UDPServerRun 514
+ local0.* /usr/local/haproxy/logs/haproxy.log
+ &~
+ ```
+
+2. 开启远程日志
+
+ ```shell
+ vim /etc/sysconfig/rsyslog
+ ```
+
+ 添加内容:
+
+ ```text
+ SYSLOGD_OPTIONS="-c 2 -r -m 0"
+ ```
+
+ 参数说明:
+
+ - `-c 2`:使用兼容模式,默认是 `-c 5`。
+ - `-r`:开启远程日志。
+ - ·-m 0`:标记时间戳。单位是分钟,为 0 时,表示禁用该功能。
+
+ 使修改生效:
+
+ `systemctl restart rsyslog`
+
+3. 编辑负载均衡文件
+
+ ```shell
+ vim /usr/local/haproxy/haproxy.cfg
+ ```
+
+ ```text
+ global
+ maxconn 2000
+ ulimit-n 40075
+ log 127.0.0.1 local0 info
+ uid 200
+ gid 200
+ chroot /var/empty
+ daemon
+ group haproxy
+ user haproxy
+
+ defaults
+ log global
+ mode http
+ retries 3
+ option redispatch
+
+ timeout connect 5000
+ timeout client 5000
+ timeout server 5000
+ timeout check 2000
+
+ frontend agent-front
+ bind *:6030
+ mode tcp
+ default_backend forward-fe
+
+ backend forward-fe
+ mode tcp
+ balance roundrobin
+ server fe-1 192.168.1.101:9030 weight 1 check inter 3000 rise 2 fall 3
+ server fe-2 192.168.1.102:9030 weight 1 check inter 3000 rise 2 fall 3
+ server fe-3 192.168.1.103:9030 weight 1 check inter 3000 rise 2 fall 3
+ ```
+
+#### 启动 HAProxy
+
+1. 启动服务
+
+ `/opt/haproxy/haproxy -f /usr/local/haproxy/haproxy.cfg`
+
+2. 查看服务状态
+
+ `netstat -lnatp | grep -i haproxy`
+
+#### 验证
+
+`mysql -h 192.168.1.100 -uroot -P6030 -p`
+
+### 04 ProxySQL
+
+[ProxySQL](https://proxysql.com/) 是基于 MySQL 的开源数据库代理软件,用 C 语言编写。能实现连接管理、读写分离、负载均衡、故障切换等功能,具有高性能、可配置、动态管理等优势,常用于 Web 服务、大数据平台、云数据库等场景。
+
+#### 安装 ProxySQL
+
+请参考 [官方文档](https://proxysql.com/documentation/installing-proxysql/) 正确安装 ProxySQL。
+
+#### 配置 ProxySQL
+
+ProxySQL 包含配置文件 `/etc/proxysql.cnf` 与配置数据库文件 `/var/lib/proxysql/proxysql.db`。
+
+需特别注意,若 `/var/lib/proxysql` 目录下存在 `"proxysql.db"` 文件,ProxySQL 服务仅在首次启动时读取并解析 `proxysql.cnf`,后续启动不再读取。
+
+若要使 `proxysql.cnf` 配置在重启后生效,需先删除 `/var/lib/proxysql/proxysql.db` 再重启服务,这相当于初始化启动,会生成新的 `proxysql.db` 文件,原配置规则将被清除。
+
+以下是配置文件 `proxysql.cnf` 的主要内容:
+
+```text
+datadir="/var/lib/proxysql" #数据目录
+admin_variables=
+{
+ admin_credentials="admin:admin" # Admin databse username and password.
+ mysql_ifaces="0.0.0.0:6032" # Admin database port, used for connecting admin database of ProxySQL
+}
+mysql_variables=
+{
+ threads=4
+ max_connections=2048
+ default_query_delay=0
+ default_query_timeout=36000000
+ have_compress=true
+ poll_timeout=2000
+ interfaces="0.0.0.0:6030"
+ default_schema="information_schema"
+ stacksize=1048576
+ server_version="5.7.99"
+ connect_timeout_server=3000
+ monitor_username="monitor"
+ monitor_password="monitor"
+ monitor_history=600000
+ monitor_connect_interval=60000
+ monitor_ping_interval=10000
+ monitor_read_only_interval=1500
+ monitor_read_only_timeout=500
+ ping_interval_server_msec=120000
+ ping_timeout_server=500
+ commands_stats=true
+ sessions_sort=true
+ connect_retries_on_failure=10
+}
+mysql_servers =
+(
+)
+mysql_users:
+(
+)
+mysql_query_rules:
+(
+)
+scheduler=
+(
+)
+mysql_replication_hostgroups=
+(
+)
+```
+
+#### 连接 ProxySQL 管理数据库
+
+```shell
+mysql -uadmin -padmin -P6032 -hdoris01
+```
+
+```sql
+ProxySQL > show databases;
++-----+---------------+-------------------------------------+
+| seq | name | file |
++-----+---------------+-------------------------------------+
+| 0 | main | |
+| 2 | disk | /var/lib/proxysql/proxysql.db |
+| 3 | stats | |
+| 4 | monitor | |
+| 5 | stats_history | /var/lib/proxysql/proxysql_stats.db |
++-----+---------------+-------------------------------------+
+5 rows in set (0.000 sec)
+ProxySQL > use main;
+
+ProxySQL > show tables;
++--------------------------------------------+
+| tables |
++--------------------------------------------+
+| global_variables |
+| mysql_collations |
+| mysql_group_replication_hostgroups |
+| mysql_query_rules |
+| mysql_query_rules_fast_routing |
+| mysql_replication_hostgroups |
+| mysql_servers |
+| mysql_users |
+| proxysql_servers |
+| runtime_checksums_values |
+| runtime_global_variables |
+| runtime_mysql_group_replication_hostgroups |
+| runtime_mysql_query_rules |
+| runtime_mysql_query_rules_fast_routing |
+| runtime_mysql_replication_hostgroups |
+| runtime_mysql_servers |
+| runtime_mysql_users |
+| runtime_proxysql_servers |
+| runtime_scheduler |
+| scheduler |
++--------------------------------------------+
+20 rows in set (0.000 sec)
+```
+
+#### ProxySQL 配置后端 Doris FE
+
+使用 INSERT 语句将需要被代理的 FE 节点和端口添加到 `mysql_servers` 表中。
+
+其中:`hostgroup_id` 为 `10` 表示写组,为 `20` 表示读组。我们这里不需要读写分离,所以可以任意设置。
+
+```shell
+mysql -uadmin -padmin -P6032 -h127.0.0.1
+```
+
+```sql
+ProxySQL > insert into mysql_servers(hostgroup_id,hostname,port) values(10,'192.168.0.101',9030);
+Query OK, 1 row affected (0.000 sec)
+
+ProxySQL > insert into mysql_servers(hostgroup_id,hostname,port) values(10,'192.168.0.102',9030);
+Query OK, 1 row affected (0.000 sec)
+
+ProxySQL > insert into mysql_servers(hostgroup_id,hostname,port) values(10,'192.168.0.103',9030);
+Query OK, 1 row affected (0.000 sec)
+```
+
+查看结果:
+
+```sql
+ProxySQL > select hostgroup_id,hostname,port,status,weight from mysql_servers;
++--------------+---------------+------+--------+--------+
+| hostgroup_id | hostname | port | status | weight |
++--------------+---------------+------+--------+--------+
+| 10 | 192.168.0.101 | 9030 | ONLINE | 1 |
+| 20 | 192.168.0.102 | 9030 | ONLINE | 1 |
+| 20 | 192.168.0.103 | 9030 | ONLINE | 1 |
++--------------+---------------+------+--------+--------+
+3 rows in set (0.000 sec)
+```
+
+如果在插入过程中,出现报错:
+
+```text
+ERROR 1045 (#2800): UNIQUE constraint failed: mysql_servers.hostgroup_id, mysql_servers.hostname, mysql_servers.port
+```
+
+说明可能之前就已经定义了其他配置,可以清空这张表,或者删除对应 host 的配置:
+
+```sql
+ProxySQL > select * from mysql_servers;
+ProxySQL > delete from mysql_servers;
+Query OK, 6 rows affected (0.000 sec)
+```
+
+保存信息:
+
+```sql
+ProxySQL > load mysql servers to runtime;
+Query OK, 0 rows affected (0.006 sec)
+
+ProxySQL > save mysql servers to disk;
+Query OK, 0 rows affected (0.348 sec)
+```
+
+#### 监控 Doris FE 节点配置
+
+添加 Doris FE 节点之后,还需要监控这些后端节点。
+
+首先在 Doris 中创建一个用于监控的用户名:
+
+```shell
+mysql -uroot -P9030 -h192.168.0.101
+```
+
+```sql
+Doris > create user monitor@'192.168.0.100' identified by 'P@ssword1!';
+Query OK, 0 rows affected (0.03 sec)
+
+Doris > grant ADMIN_PRIV on *.* to monitor@'192.168.0.100';
+Query OK, 0 rows affected (0.02 sec)
+```
+
+然后回到 ProxySQL 代理层节点上配置监控
+
+
+```shell
+mysql -uadmin -padmin -P6032 -h127.0.0.1
+```
+
+```sql
+ProxySQL > set mysql-monitor_username='monitor';
+Query OK, 1 row affected (0.000 sec)
+
+ProxySQL > set mysql-monitor_password='P@ssword1!';
+Query OK, 1 row affected (0.000 sec)
+```
+
+保存配置并退出:
+
+```sql
+ProxySQL > load mysql servers to runtime;
+Query OK, 0 rows affected (0.006 sec)
+
+ProxySQL > save mysql servers to disk;
+Query OK, 0 rows affected (0.348 sec)
+```
+
+验证监控结果。
+
+ProxySQL 监控模块的指标都保存在 `monitor.log` 表中。
+
+连接监控:
+
+```sql
+ProxySQL > select * from mysql_server_connect_log;
++---------------+------+------------------+-------------------------+---------------+
+| hostname | port | time_start_us | connect_success_time_us | connect_error |
++---------------+------+------------------+-------------------------+---------------+
+| 192.168.0.101 | 9030 | 1548665195883957 | 762 | NULL |
+| 192.168.0.102 | 9030 | 1548665195894099 | 399 | NULL |
+| 192.168.0.103 | 9030 | 1548665195904266 | 483 | NULL |
+| 192.168.0.101 | 9030 | 1548665255883715 | 824 | NULL |
+| 192.168.0.102 | 9030 | 1548665255893942 | 656 | NULL |
+| 192.168.0.101 | 9030 | 1548665495884125 | 615 | NULL |
+| 192.168.0.102 | 9030 | 1548665495894254 | 441 | NULL |
+| 192.168.0.103 | 9030 | 1548665495904479 | 638 | NULL |
+| 192.168.0.101 | 9030 | 1548665512917846 | 487 | NULL |
+| 192.168.0.102 | 9030 | 1548665512928071 | 994 | NULL |
+| 192.168.0.103 | 9030 | 1548665512938268 | 613 | NULL |
++---------------+------+------------------+-------------------------+---------------+
+20 rows in set (0.000 sec)
+```
+
+心跳监控:
+
+```sql
+ProxySQL > select * from mysql_server_ping_log;
++---------------+------+------------------+----------------------+------------+
+| hostname | port | time_start_us | ping_success_time_us | ping_error |
++---------------+------+------------------+----------------------+------------+
+| 192.168.0.101 | 9030 | 1548665195883407 | 98 | NULL |
+| 192.168.0.102 | 9030 | 1548665195885128 | 119 | NULL |
+...........
+| 192.168.0.102 | 9030 | 1548665415889362 | 106 | NULL |
+| 192.168.0.103 | 9030 | 1548665562898295 | 97 | NULL |
++---------------+------+------------------+----------------------+------------+
+110 rows in set (0.001 sec)
+```
+
+## 客户端 IP 透传
+
+多数情况下,通过代理服务连接到后端 Doris 服务后,客户端 IP 信息会丢失,Doris 服务端只能获取到代理服务器的 IP 地址信息。
+
+自 2.1.1 版本开始,Doris 支持 [Proxy Protocol](https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) 协议。利用这个协议,可以是实现客户端 IP 透传,从而在经过负载均衡后,Doris 依然可以获取客户端的真实 IP,实现白名单等权限控制。
+
+下面分别介绍如何在 Nginx 和 Haproxy 中开启 Proxy Protocol。
+
+### Doris 开启 Proxy Protocol 支持
+
+在 FE 的 `fe.conf` 中添加:
+
+```text
+enable_proxy_protocol = true
+```
+
+:::notice
+
+1. 仅支持 Proxy Protocol V1。
+
+2. 仅支持并作用于 MySQL 协议端口,不支持和影响 HTTP、ADBC 等其他协议端口。
+
+3. 在 Doris 3.1 版本之前,开启后,必须使用 Proxy Protocol 协议进行连接,否则连接失败。3.1 版本开始,开启 Proxy Protocol 后,依然可以使用标准的 MySQL 连接协议进行连接。
+
+:::
+
+### 01 Nginx
+
+在配置文件的 `server` 部分新增:`proxy_protocol on;`:
+
+```text
+events {
+worker_connections 1024;
+}
+stream {
+ upstream mysqld {
+ hash $remote_addr consistent;
+ server 192.168.1.101:9030 weight=1 max_fails=2 fail_timeout=60s;
+ server 192.168.1.102:9030 weight=1 max_fails=2 fail_timeout=60s;
+ server 192.168.1.103:9030 weight=1 max_fails=2 fail_timeout=60s;
+ }
+ server {
+ # Proxy port
+ listen 6030;
+ proxy_connect_timeout 300s;
+ proxy_timeout 300s;
+ proxy_pass mysqld;
+ # Enable Proxy Protocol to the upstream server
+ proxy_protocol on;
+ }
+}
+```
+
+### 02 HAProxy
+
+在 `haproxy.cfg` 的 `backend` 部分新增 `send-proxy` 参数:
+
+```text
+backend forward-fe
+ mode tcp
+ balance roundrobin
+ server fe-1 192.168.1.101:9030 weight 1 check inter 3000 rise 2 fall 3 send-proxy
+ server fe-2 192.168.1.102:9030 weight 1 check inter 3000 rise 2 fall 3 send-proxy
+ server fe-3 192.168.1.103:9030 weight 1 check inter 3000 rise 2 fall 3 send-proxy
+```
+
+### 验证 IP 透传是否成功
+
+通过代理连接 Doris:
+
+```sql
+mysql -uroot -P6030 -h192.168.1.100
+```
+
+验证
+
+```sql
+mysql> show processlist;
++------------------+------+------+-------------------+---------------------+----------+------+---------+------+-------+-----------------------------------+------------------+
+| CurrentConnected | Id | User | Host | LoginTime | Catalog | Db | Command | Time | State | QueryId | Info |
++------------------+------+------+-------------------+---------------------+----------+------+---------+------+-------+-----------------------------------+------------------+
+| Yes | 1 | root | 192.168.1.101:34390 | 2024-03-17 16:32:22 | internal | | Query | 0 | OK | 82edc460d93f4e28-8bbed058a068e259 | show processlist |
++------------------+------+------+-------------------+---------------------+----------+------+---------+------+-------+-----------------------------------+------------------+
+1 row in set (0.00 sec)
+```
+
+如果在 `Host` 列看到的真实的客户端 IP,则说明验证成功。否则,只能看到代理服务的 IP 地址。
+
+同时,在 fe.audit.log 中也会记录真实的客户端 IP。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/time-zone.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/time-zone.md
new file mode 100644
index 00000000000..f2898c92641
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/time-zone.md
@@ -0,0 +1,226 @@
+---
+{
+ "title": "时区管理",
+ "language": "zh-CN"
+}
+---
+
+Doris 支持自定义时区设置
+
+## 基本概念
+
+Doris 内部存在以下两个时区相关参数:
+
+- system_time_zone : 当服务器启动时,系统会根据机器设置时区自动设置,设置后不可修改。
+
+- time_zone : 集群当前时区,可以修改。集群启动时,该变量会设置为与 `system_time_zone` 相同,之后不再变动,除非用户手动修改。
+
+## 具体操作
+
+1. `show variables like '%time_zone%'`
+
+ 查看当前时区相关配置
+
+2. `SET [global] time_zone = 'Asia/Shanghai'`
+
+ 该命令可以设置 Session 级别的时区,如使用 `global` 关键字,则 Doris FE 会将参数持久化,之后对所有新 Session 生效。
+
+## 数据来源
+
+时区数据包含时区名、对应时间偏移量、夏令时变化情况等。在 BE 所在机器上,其数据来源为 `TZDIR` 命令返回的目录,如不支持该命令,则为 `/usr/share/zoneinfo` 目录。
+
+## 时区的影响
+
+### 1. 函数
+
+包括 `NOW()` 或 `CURTIME()` 等时间函数显示的值,也包括 `show load`, `show backends` 中的时间值。
+
+但不会影响 `create table` 中时间类型分区列的 less than 值,也不会影响存储为 `date/datetime` 类型的值的显示。
+
+受时区影响的函数:
+
+- `FROM_UNIXTIME`:给定一个 UTC 时间戳,返回其在 Doris session `time_zone` 指定时区的日期时间,如`time_zone`为`CST`时`FROM_UNIXTIME(0)`返回`1970-01-01 08:00:00`。
+
+- `UNIX_TIMESTAMP`:给定一个日期时间,返回其在 Doris session `time_zone` 指定时区下的 UTC 时间戳,如`time_zone`为`CST`时`UNIX_TIMESTAMP('1970-01-01 08:00:00')`返回`0`。
+
+- `CURTIME`:返回当前 Doris session `time_zone` 指定时区的时间。
+
+- `NOW`:返回当前 Doris session `time_zone` 指定时区的日期时间。
+
+- `CONVERT_TZ`:将一个日期时间从一个指定时区转换到另一个指定时区。
+
+### 2. 时间类型的值
+
+对于`DATE`、`DATETIME`类型,我们支持导入数据时对时区进行转换。
+
+- 如果数据带有时区,如 "2020-12-12 12:12:12+08:00",而 Stream Load 指定的 Header `timezone` 为 `+00:00` ,则数据导入 Doris 得到实际值为 "2020-12-12 04:12:12"。
+
+- 如果数据不带有时区,如 "2020-12-12 12:12:12",则认为该时间为绝对时间,不发生任何转换。
+
+### 3. 夏令时
+
+夏令时的本质是具名时区的实际时间偏移量,在一定日期内发生改变。
+
+例如,`America/Los_Angeles`时区包含一次夏令时调整,起止时间为约为每年 3 月至 11 月。即,三月份夏令时开始时,`America/Los_Angeles`实际时区偏移由`-08:00`变为`-07:00`,11 月夏令时结束时,又从`-07:00`变为`-08:00`。
+如果不希望开启夏令时,则应设定 `time_zone` 为 `-08:00` 而非 `America/Los_Angeles`。
+
+## 使用方式
+
+时区值可以使用多种格式给出,以下是 Doris 中完善支持的标准格式:
+
+1. 标准具名时区格式,如 "Asia/Shanghai", "America/Los_Angeles"。此类格式来源于[本机所带时区数据](#数据来源),如 "Etc/GMT+3" 等亦属此列。
+
+2. 标准偏移格式,如 "+02:30", "-10:00"(不支持诸如 "+12:03" 等特殊偏移)
+
+3. 缩写时区格式,当前仅支持:
+
+ 1. "GMT", "UTC",等同于 "+00:00" 时区
+
+ 2. "CST", 等同于 "Asia/Shanghai" 时区
+
+4. 单字母 Z,代表 Zulu 时区,等同于 "+00:00" 时区
+
+此外,对任何字母的解析不区分大小写。
+
+注意:由于实现方式的不同,当前 Doris 存在部分其他格式在部分导入方式中得到了支持。**生产环境不应当依赖这些未列于此的格式,它们的行为随时可能发生变化**,请关注版本更新时的相关 changelog。
+
+## 最佳实践
+
+### 时区敏感数据
+
+时区问题主要涉及三个影响因素:
+
+1. session variable `time_zone` —— 集群时区
+
+2. Stream Load、Broker Load 等导入时指定的 header `timezone` —— 导入时区
+
+3. 时区类型字面量 "2023-12-12 08:00:00+08:00" 中的 "+08:00" —— 数据时区
+
+我们可以做如下理解:
+
+Doris 目前兼容各时区下的数据向 Doris 中进行导入。而由于 Doris 自身 `DATETIME` 等各个时间类型本身不内含时区信息,且数据在导入后不会随时区变化而变更,因此时间数据导入 Doris 时,可分为如下两类:
+
+1. 绝对时间
+
+ 绝对时间是指,它所关联的数据场景与时区无关。对于这类数据,在导入时应该不带有任何时区后缀,它们将被原样存储。
+
+2. 特定时区下的时间
+
+ 某个特定时区下的时间是指,它所关联的数据场景与时区有关。对于这类数据,在导入时应该带有具体时区后缀,导入时它们将被转化至 Doris 集群 `time_zone` 时区或 Stream Load/Broker Load 中指定的 header `timezone`。
+
+ 这类数据在导入后即被转化至导入时指定时区下的绝对时间存储,故后续导入和查询应当保持此时区,以免数据意义发生紊乱。
+
+ * 对于 Insert 语句,我们可以通过以下例子来说明:
+
+ ```sql
+ Doris > select @@time_zone;
+ +---------------+
+ | @@time_zone |
+ +---------------+
+ | Asia/Shanghai |
+ +---------------+
+
+ Doris > insert into dt values('2020-12-12 12:12:12+02:00'); --- 导入的数据中指定了时区为 +02:00
+
+ Doris > select * from dt;
+ +---------------------+
+ | dt |
+ +---------------------+
+ | 2020-12-12 18:12:12 | --- 被转换为 Doris 集群时区 Asia/Shanghai,后续导入和查询应当保持此时区。
+ +---------------------+
+
+ Doris > set time_zone = 'America/Los_Angeles';
+
+ Doris > select * from dt;
+ +---------------------+
+ | dt |
+ +---------------------+
+ | 2020-12-12 18:12:12 | --- 如果修改 time_zone,时间值不会随之改变,其查询时的意义发生紊乱。
+ +---------------------+
+ ```
+
+ * 对于 Stream Load、Broker Load 等导入方式,我们可以通过指定 header `timezone` 来实现。例如,对于 Stream Load,我们可以通过以下例子来说明:
+
+ ```shell
+ cat dt.csv
+ 2020-12-12 12:12:12+02:00
+
+ curl --location-trusted -u root: \
+ -H "Expect:100-continue" \
+ -H "strict_mode: true" \
+ -H "timezone: Asia/Shanghai" \
+ -T dt.csv -XPUT \
+ http://127.0.0.1:8030/api/test/dt/_stream_load
+ ```
+
+ ```sql
+ Doris > select @@time_zone;
+ +---------------+
+ | @@time_zone |
+ +---------------+
+ | Asia/Shanghai |
+ +---------------+
+
+ Doris > select * from dt;
+ +---------------------+
+ | dt |
+ +---------------------+
+ | 2020-12-12 18:12:12 | --- 被转换为 Doris 集群时区 Asia/Shanghai,后续导入和查询应当保持此时区。
+ +---------------------+
+ ```
+
+ :::tip
+ * Stream Load、Broker Load 等导入方式中,header `timezone` 会覆盖 Doris 集群 `time_zone`,因此在导入时应当保持一致。
+ * Stream Load、Broker Load 等导入方式中,header `timezone` 会影响导入转换中使用的函数。
+ * 如果导入时未指定 header `timezone`,则默认使用东八区。
+ :::
+
+**综上所述,处理时区问题最佳的实践是:**
+:::info 最佳实践
+1. 在使用前确认该集群所表征的时区并设置 `time_zone`,在此之后不再更改。
+
+2. 在导入时设定 header `timezone` 同集群 `time_zone` 一致。
+
+3. 对于绝对时间,导入时不带时区后缀;对于有时区的时间,导入时带具体时区后缀,导入后将被转化至 Doris `time_zone` 时区。
+:::
+
+### 夏令时
+
+夏令时的起讫时间来自[当前时区数据源](#数据来源),不一定与当年度时区所在地官方实际确认时间完全一致。该数据由 ICANN 进行维护。如果需要确保夏令时表现与当年度实际规定一致,请保证 Doris 所选择的数据源为最新的 ICANN 所公布时区数据,下载途径见下文。
+
+### 信息更新
+
+真实世界中的时区与夏令时相关数据,将会因各种原因而不定期发生变化。IANA 会定期记录这些变化并更新相应时区文件。如果希望 Doris 中的时区信息与最新的 IANA 数据保持一致,请采取下列方式进行更新:
+
+1. 使用包管理器更新
+
+根据当前操作系统使用的包管理器,用户可以使用对应的命令直接更新时区数据:
+
+```shell
+# yum
+> sudo yum update tzdata
+# apt
+> sudo apt update tzdata
+```
+
+该方式更新的数据位于系统 `$TZDIR` 下(一般为 `usr/share/zoneinfo`)。
+
+2. 直接拉取 IANA 时区数据库(推荐)
+
+大多数 Linux 发行版的包管理器,tzdata 的同步并不及时。如果对时区数据准确性要求较高,可以直接拉取 IANA 定期公布的数据:
+
+```shell
+wget https://www.iana.org/time-zones/repository/tzdb-latest.tar.lz
+```
+
+然后根据解压后文件夹中的 README 文件,生成具体的 zoneinfo 数据。生成的数据应当拷贝并覆盖 `$TZDIR` 目录。
+
+请注意,以上所有操作在 BE 所在机器上完成后,都**必须重启**对应 BE 才能生效。
+
+## 拓展阅读
+
+- 时区格式列表:[List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
+
+- IANA 时区数据库:[IANA Time Zone Database](https://www.iana.org/time-zones)
+
+- ICANN 时区数据库:[The tz-announce Archives](https://mm.icann.org/pipermail/tz-announce/)
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/upgrade.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/upgrade.md
new file mode 100644
index 00000000000..029ab0bc33a
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/cluster-management/upgrade.md
@@ -0,0 +1,225 @@
+---
+{
+ "title": "集群升级",
+ "language": "zh-CN"
+}
+---
+
+Doris 提供了滚动升级的能力,在升级过程中逐步对 FE 与 BE 节点进行升级,减少停机时间,确保在升级过程中系统能够保持正常运行。
+
+## 版本兼容性说明
+
+Doris 版本号由三维组成,第一位表示重大里程碑版本,第二位表示功能版本,第三位表示 bug 修复,不在三位版本中发布新的功能。如 Doris 2.1.3 版本,其中 2 表示第 2 个里程碑版本,1 表示该里程碑下的功能版本,3 表示该功能版本下的第三个 bug fix 版本。
+
+在版本升级时,遵循以下规则:
+
+* 三位版本:二位版本相同时,可以跨三位版本升级,如 2.1.3 版本可以直接升级到 2.1.7 版本;
+
+* 二位版本及一位版本:不建议跨二位版本升级,考虑到兼容性问题,建议按照二位版本号依次升级,如 3.0 版本升级到 3.3 版本,需要按照 3.0 -> 3.1 -> 3.2 -> 3.3 的执行路径升级。
+
+详细版本说明可以参考[版本规则](https://doris.apache.org/zh-CN/community/release-versioning)。
+
+## 升级注意事项
+
+在升级时,需要注意以下事项:
+
+* 版本间行为变更:在升级前需要查看 Release Note 中的行为变更以确定版本间的兼容性。
+
+* 对集群内的任务添加重试机制:升级时节点需要依次重启,对于查询任务,Stream Load 导入作业需要添加重试机制,否则会导致任务失败;在 Routine Load 作业,通过 flink-doris-connector 或 spark-doris-connector 导入的作业,已经在代码中实现了重试机制,无需添加重试逻辑;
+
+* 关闭副本修复与均衡功能:在升级时需要关闭副本修复与均衡功能,无论升级是否成功,升级后都需要再次打开副本修复与均衡功能。
+
+
+## 元数据兼容性测试
+
+:::caution 注意
+
+在生产环境中,建议保持 3 个以上的 FE 做高可用配置。如果只有 1 个 FE 节点,需要先做元数据兼容性测试后,再进行升级操作。元数据兼容非常重要,如果因为元数据不兼容导致的升级失败,能会导致数据丢失。建议每次升级前都进行元数据兼容性测试,在做元数据兼容性测试时,注意以下几点:
+
+* 建议在开发机或 BE 节点上做元数据兼容性测试,尽量避免在 FE 节点上做兼容性测试
+
+* 如果只能在 FE 节点上做兼容性测试,建议选择非 Master 节点,并停止原有 FE 进程
+:::
+
+在升级前,建议进行元数据兼容性测试,防止升级过程中元数据不兼容导致的升级失败。
+
+1. 备份元数据信息:
+
+ 在开始升级工作前,需要备份 Master FE 节点的元数据信息。
+
+ 通过 `show frontends` 中 `IsMaster` 列可以判断 Master FE 节点。在备份 FE 元信息时,无需停止 FE 节点,可以直接热备份元信息。默认情况下,FE 元数据在 `fe/doris-meta` 目录下,可以通过 `fe.conf` 文件中 `meta_dir` 参数确定元数据目录。
+
+2. 修改测试用的 FE 的配置文件 fe.conf
+
+ ```bash
+ vi ${DORIS_NEW_HOME}/conf/fe.conf
+ ```
+
+ 修改以下端口信息,将所有端口设置为与线上不同,同时修改 clusterID 参数:
+ ```
+ ...
+ ## modify port
+ http_port = 18030
+ rpc_port = 19020
+ query_port = 19030
+ arrow_flight_sql_port = 19040
+ edit_log_port = 19010
+
+ ## modify clusterIP
+ clusterId=<a_new_clusterID, such as 123456>
+ ...
+ ```
+
+3. 将备份的 Master FE 元数据拷贝到新的兼容性测试环境中
+
+ ```bash
+ cp ${DORIS_OLD_HOME}/fe/doris-meta/* ${DORIS_NEW_HOME}/fe/doris-meta
+ ```
+
+4. 将拷贝的元数据目文件中的 VERSION 文件中的 cluster\_id 修改为新的 cluster ID,如在上例中修改为 123456:
+
+ ```bash
+ vi ${DORIS_NEW_HOME}/fe/doris-meta/image/VERSION
+ clusterId=123456
+ ```
+
+5. 在测试环境中启动 FE 进程
+
+ ```bash
+ sh ${DORIS_NEW_HOME}/bin/start_fe.sh --daemon --metadata_failure_recovery
+ ```
+
+ 在 2.0.2 之前的版本,需要在 fe.conf 文件中加入 `metadata_failure_recovery` 后在启动 FE 进程:
+ ```bash
+ echo "metadata_failure_recovery=true" >> ${DORIS_NEW_HOME}/conf/fe.conf
+ sh ${DORIS_NEW_HOME}/bin/start_fe.sh --daemon
+ ```
+
+6. 验证 FE 启动成功,通过 mysql 命令链接当前 FE,如上文中使用 query port 为 19030:
+
+ ```bash
+ mysql -uroot -P19030 -h127.0.0.1
+ ```
+
+## 升级步骤
+
+升级过程具体流程如下:
+
+1. 关闭副本修复与均衡功能
+
+2. 升级 BE 节点
+
+3. 升级 FE 节点
+
+4. 打开副本修复与均衡功能
+
+升级过程中,要遵循先升级 BE、在升级 FE 的原则。在升级 FE 时,先升级 Observer FE 与 Follower FE 节点,再升级 Master FE 节点。
+
+:::caution 注意
+
+Doris 只需要升级 FE 目录下的 `/bin` 和 `/lib` 以及 BE 目录下的 `/bin` 和 `/lib`
+
+在 2.0.2 及之后的版本,FE 和 BE 部署路径下新增了 `custom_lib/` 目录(如没有可以手动创建)。`custom_lib/` 目录用于存放一些用户自定义的第三方 jar 包,如 `hadoop-lzo-*.jar`,`orai18n.jar` 等。这个目录在升级时不需要替换。
+
+:::
+
+### 第 1 步:关闭副本修复与均衡功能
+
+在升级过程中会有节点重启,可能会触发不必要的集群均衡和副本修复逻辑,先通过以下命令关闭:
+
+```sql
+admin set frontend config("disable_balance" = "true");
+admin set frontend config("disable_colocate_balance" = "true");
+admin set frontend config("disable_tablet_scheduler" = "true");
+```
+
+### 第 2 步:升级 BE 节点
+
+:::info 备注:
+
+为了保证您的数据安全,请使用 3 副本来存储您的数据,以避免升级误操作或失败导致的数据丢失问题。
+:::
+1. 在多副本的集群中,可以选择一台 BE 节点停止进程,进行灰度升级:
+
+ ```bash
+ sh ${DORIS_OLD_HOME}/be/bin/stop_be.sh
+ ```
+
+2. 重命名 BE 目录下的 `/bin`,`/lib` 目录:
+
+ ```bash
+ mv ${DORIS_OLD_HOME}/be/bin ${DORIS_OLD_HOME}/be/bin_back
+ mv ${DORIS_OLD_HOME}/be/lib ${DORIS_OLD_HOME}/be/lib_back
+ ```
+
+3. 复制新版本的 `/bin`,`/lib` 目录到原 BE 目录下:
+
+ ```bash
+ cp -r ${DORIS_NEW_HOME}/be/bin ${DORIS_OLD_HOME}/be/bin
+ cp -r ${DORIS_NEW_HOME}/be/lib ${DORIS_OLD_HOME}/be/lib
+ ```
+
+4. 启动该 BE 节点:
+
+ ```bash
+ sh ${DORIS_OLD_HOME}/be/bin/start_be.sh --daemon
+ ```
+
+5. 连接集群,查看该节点信息:
+
+ ```sql
+ show backends\G
+ ```
+
+ 若该 BE 节点 `alive` 状态为 `true`,且 `Version` 值为新版本,则该节点升级成功。
+
+### 第 3 步:升级 FE 节点
+
+1. 多个 FE 节点情况下,选择一个非 Master 节点进行升级,先停止运行:
+
+ ```bash
+ sh ${DORIS_OLD_HOME}/fe/bin/stop_fe.sh
+ ```
+
+2. 重命名 FE 目录下的 `/bin`,`/lib`,`/mysql_ssl_default_certificate` 目录:
+
+ ```bash
+ mv ${DORIS_OLD_HOME}/fe/bin ${DORIS_OLD_HOME}/fe/bin_back
+ mv ${DORIS_OLD_HOME}/fe/lib ${DORIS_OLD_HOME}/fe/lib_back
+ mv ${DORIS_OLD_HOME}/fe/mysql_ssl_default_certificate ${DORIS_OLD_HOME}/fe/mysql_ssl_default_certificate_back
+ ```
+
+3. 复制新版本的 `/bin`,`/lib`,`/mysql_ssl_default_certificate` 目录到原 FE 目录下:
+
+ ```bash
+ cp -r ${DORIS_NEW_HOME}/fe/bin ${DORIS_OLD_HOME}/fe/bin
+ cp -r ${DORIS_NEW_HOME}/fe/lib ${DORIS_OLD_HOME}/fe/lib
+ cp -r ${DORIS_NEW_HOME}/fe/mysql_ssl_default_certificate ${DORIS_OLD_HOME}/fe/mysql_ssl_default_certificate
+ ```
+
+4. 启动该 FE 节点:
+
+ ```sql
+ sh ${DORIS_OLD_HOME}/fe/bin/start_fe.sh --daemon
+ ```
+
+5. 连接集群,查看该节点信息:
+
+ ```sql
+ show frontends\G
+ ```
+
+ 若该 FE 节点 `alive` 状态为 `true`,且 `Version` 值为新版本,则该节点升级成功。
+
+6. 依次完成其他 FE 节点升级,最后完成 Master 节点的升级
+
+### 第 4 步:打开副本修复与均衡功能
+
+升级完成,并且所有 BE 节点状态变为 `Alive` 后,打开集群副本修复和均衡功能:
+
+```sql
+admin set frontend config("disable_balance" = "false");
+admin set frontend config("disable_colocate_balance" = "false");
+admin set frontend config("disable_tablet_scheduler" = "false");
+```
+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/be-config.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/be-config.md
new file mode 100644
index 00000000000..b5061831ff1
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/be-config.md
@@ -0,0 +1,1346 @@
+---
+{
+ "title": "BE 配置项",
+ "language": "zh-CN",
+ "toc_min_heading_level": 2,
+ "toc_max_heading_level": 4
+}
+---
+
+<!-- Please sort the configuration alphabetically -->
+
+
+
+该文档主要介绍 BE 的相关配置项。
+
+BE 的配置文件 `be.conf` 通常存放在 BE 部署路径的 `conf/` 目录下。而在 0.14 版本中会引入另一个配置文件 `be_custom.conf`。该配置文件用于记录用户在运行时动态配置并持久化的配置项。
+
+BE 进程启动后,会先读取 `be.conf` 中的配置项,之后再读取 `be_custom.conf` 中的配置项。`be_custom.conf` 中的配置项会覆盖 `be.conf` 中相同的配置项。
+
+## 查看配置项
+
+有两种方式能够查看 BE 配置项:
+
+1. 通过 BE 前端页面查看
+
+ 在浏览器中打开 BE 前端页面:`http://be_host:be_webserver_port/varz`
+
+2. 通过命令行查看
+
+ 可以在 MySQL 客户端中,通过以下命令查看 BE 的配置项,具体语法参照[SHOW-CONFIG](../../sql-manual/sql-statements/cluster-management/instance-management/SHOW-CONFIG):
+
+ `SHOW BACKEND CONFIG;`
+
+ 结果中各列含义如下:
+
+ 1. BackendId: backend 节点 ID。
+ 2. Host: backend 节点 IP。
+ 3. Key: 配置项名称。
+ 4. Value: 配置项的值。
+ 5. Type: 配置项值类型,如整型、字符串。
+ 6. 是否可以动态配置。如果为 true,表示该配置项可以在运行时进行动态配置。如果 false,则表示该配置项只能在 `be.conf` 中配置并且重启 FE 后生效。
+
+## 设置配置项
+
+BE 的配置项有两种方式进行配置:
+
+1. 静态配置
+
+在 `conf/be.conf` 文件中添加和设置配置项。`be.conf` 中的配置项会在 BE 进行启动时被读取。没有在 `be.conf` 中的配置项将使用默认值。
+
+2. 动态配置
+
+BE 启动后,可以通过以下命令动态设置配置项。
+
+ ```
+ curl -X POST http://{be_ip}:{be_http_port}/api/update_config?{key}={value}
+ ```
+
+在 0.13 版本及之前,通过该方式修改的配置项将在 BE 进程重启后失效。在 0.14 及之后版本中,可以通过以下命令持久化修改后的配置。修改后的配置项存储在 `be_custom.conf` 文件中。
+
+ ```
+ curl -X POST http://{be_ip}:{be_http_port}/api/update_config?{key}={value}\&persist=true
+ ```
+
+## 应用举例
+
+1. 静态方式修改 `max_base_compaction_threads`
+
+通过在 `be.conf` 文件中添加:
+
+```max_base_compaction_threads=5```
+
+之后重启 BE 进程以生效该配置。
+
+2. 动态方式修改 `streaming_load_max_mb`
+
+BE 启动后,通过下面命令动态设置配置项 `streaming_load_max_mb`:
+
+```curl -X POST http://{be_ip}:{be_http_port}/api/update_config?streaming_load_max_mb=1024```
+
+返回值如下,则说明设置成功。
+
+ ```
+ {
+ "status": "OK",
+ "msg": ""
+ }
+ ```
+
+BE 重启后该配置将失效。如果想持久化修改结果,使用如下命令:
+
+ ```
+ curl -X POST http://{be_ip}:{be_http_port}/api/update_config?streaming_load_max_mb=1024\&persist=true
+ ```
+
+## 配置项列表
+
+### 服务
+
+#### `be_port`
+
+* 类型:int32
+* 描述:BE 上 Thrift Server 的端口号,用于接收来自 FE 的请求
+* 默认值:9060
+
+#### `heartbeat_service_port`
+
+* 类型:int32
+* 描述:BE 上心跳服务端口(Thrift),用于接收来自 FE 的心跳
+* 默认值:9050
+
+#### `webserver_port`
+
+* 类型:int32
+* 描述:BE 上的 HTTP Server 的服务端口
+* 默认值:8040
+
+#### `brpc_port`
+
+* 类型:int32
+* 描述:BE 上的 brpc 的端口,用于 BE 之间通讯
+* 默认值:8060
+
+#### `arrow_flight_sql_port`
+
+* 类型:int32
+* 描述:FE 上的 Arrow Flight SQL Server 的端口,用于从 Arrow Flight Client 和 BE 之间通讯
+* 默认值:-1
+
+#### `enable_https`
+
+* 类型:bool
+* 描述:是否支持 https. 如果是,需要在 be.conf 中配置`ssl_certificate_path`和`ssl_private_key_path`
+* 默认值:false
+
+#### `priority_networks`
+
+* 描述:为那些有很多 ip 的服务器声明一个选择策略。请注意,最多应该有一个 ip 与此列表匹配。这是一个以分号分隔格式的列表,用 CIDR 表示法,例如 10.10.10.0/24,如果没有匹配这条规则的 ip,会随机选择一个。
+* 默认值:空
+
+#### `storage_root_path`
+
+* 类型:string
+
+* 描述:BE 数据存储的目录,多目录之间用英文状态的分号`;`分隔。可以通过路径区别存储目录的介质,HDD 或 SSD。可以添加容量限制在每个路径的末尾,通过英文状态逗号`,`隔开。如果用户不是 SSD 和 HDD 磁盘混合使用的情况,不需要按照如下示例一和示例二的配置方法配置,只需指定存储目录即可;也不需要修改 FE 的默认存储介质配置
+
+ 示例 1 如下:
+
+ **注意:如果是 SSD 磁盘要在目录后面加上`.SSD`,HDD 磁盘在目录后面加`.HDD`**
+
+ `storage_root_path=/home/disk1/doris.HDD;/home/disk2/doris.SSD;/home/disk2/doris`
+
+ **说明**
+
+ - /home/disk1/doris.HDD,表示存储介质是HDD;
+ - /home/disk2/doris.SSD,表示存储介质是SSD;
+ - /home/disk2/doris,存储介质默认为HDD
+
+ 示例 2 如下:
+
+ **注意:不论 HHD 磁盘目录还是 SSD 磁盘目录,都无需添加后缀,storage_root_path 参数里指定 medium 即可**
+
+ `storage_root_path=/home/disk1/doris,medium:hdd;/home/disk2/doris,medium:ssd`
+
+ **说明**
+
+ - /home/disk1/doris,medium:hdd,表示存储介质是HHD;
+ - /home/disk2/doris,medium:ssd,表示存储介质是SSD;
+
+
+* 默认值:${DORIS_HOME}/storage
+
+#### `heartbeat_service_thread_count`
+
+* 类型:int32
+* 描述:执行 BE 上心跳服务的线程数,默认为 1,不建议修改
+* 默认值:1
+
+#### `ignore_broken_disk`
+
+* 类型:bool
+* 描述:当 BE 启动时,会检查``storage_root_path`` 配置下的所有路径。
+
+ - `ignore_broken_disk=true`
+
+ 如果路径不存在或路径下无法进行读写文件 (坏盘),将忽略此路径,如果有其他可用路径则不中断启动。
+
+ - `ignore_broken_disk=false`
+
+ 如果路径不存在或路径下无法进行读写文件 (坏盘),将中断启动失败退出。
+
+* 默认值:false
+
+#### `mem_limit`
+
+* 类型:string
+* 描述:限制 BE 进程使用服务器最大内存百分比。用于防止 BE 内存挤占太多的机器内存,该参数必须大于 0,当百分大于 100% 之后,该值会默认为 100%。
+* 默认值:90%
+
+#### `cluster_id`
+
+* 类型:int32
+* 描述:配置 BE 的所属于的集群 id。
+ - 该值通常由 FE 通过心跳向 BE 下发,不需要额外进行配置。当确认某 BE 属于某一个确定的 Doris 集群时,可以进行配置,同时需要修改数据目录下的 cluster_id 文件,使二者相同。
+* 默认值:-1
+
+#### `custom_config_dir`
+
+* 描述:配置 `be_custom.conf` 文件的位置。默认为 `conf/` 目录下。
+ - 在某些部署环境下,`conf/`目录可能因为系统的版本升级被覆盖掉。这会导致用户在运行是持久化修改的配置项也被覆盖。这时,我们可以将 `be_custom.conf` 存储在另一个指定的目录中,以防止配置文件被覆盖。
+* 默认值:空
+
+#### `trash_file_expire_time_sec`
+
+* 描述:回收站清理的间隔,24 个小时,当磁盘空间不足时,trash 下的文件保存期可不遵守这个参数
+* 默认值:86400
+
+#### `es_http_timeout_ms`
+
+* 描述:通过 http 连接 ES 的超时时间,默认是 5 秒
+* 默认值:5000 (ms)
+
+#### `es_scroll_keepalive`
+
+* 描述:es scroll keep-alive 保持时间,默认 5 分钟
+* 默认值:5 (m)
+
+#### `external_table_connect_timeout_sec`
+
+* 类型:int32
+* 描述:和外部表建立连接的超时时间。
+* 默认值:5 秒
+
+#### `pipeline_status_report_interval`
+
+* 描述:配置文件报告之间的间隔;单位:秒
+* 默认值:5
+
+#### `brpc_max_body_size`
+
+* 描述:这个配置主要用来修改 brpc 的参数 `max_body_size`。
+
+ - 有时查询失败,在 BE 日志中会出现 `body_size is too large` 的错误信息。这可能发生在 SQL 模式为 multi distinct + 无 group by + 超过 1T 数据量的情况下。这个错误表示 brpc 的包大小超过了配置值。此时可以通过调大该配置避免这个错误。
+
+#### `brpc_socket_max_unwritten_bytes`
+
+* 描述:这个配置主要用来修改 brpc 的参数 `socket_max_unwritten_bytes`。
+
+ - 有时查询失败,BE 日志中会出现 `The server is overcrowded` 的错误信息,表示连接上有过多的未发送数据。当查询需要发送较大的 bitmap 字段时,可能会遇到该问题,此时可能通过调大该配置避免该错误。
+
+#### `transfer_large_data_by_brpc`
+
+* 类型:bool
+* 描述:该配置用来控制是否在 Tuple/Block data 长度大于 1.8G 时,将 protoBuf request 序列化后和 Tuple/Block data 一起嵌入到 controller attachment 后通过 http brpc 发送。为了避免 protoBuf request 的长度超过 2G 时的错误:Bad request, error_text=[E1003]Fail to compress request。在过去的版本中,曾将 Tuple/Block data 放入 attachment 后通过默认的 baidu_std brpc 发送,但 attachment 超过 2G 时将被截断,通过 http brpc 发送不存在 2G 的限制。
+* 默认值:true
+
+#### `brpc_num_threads`
+
+* 描述:该配置主要用来修改 brpc 中 bthreads 的数量。该配置的默认值被设置为 -1, 这意味着 bthreads 的数量将被设置为机器的 cpu 核数。
+
+ - 用户可以将该配置的值调大来获取更好的 QPS 性能。更多的信息可以参考 `https://github.com/apache/doris/blob/master/extension/DataX/doriswriter/doc/doriswriter.md`。
+* 默认值:-1
+
+#### `thrift_rpc_timeout_ms`
+
+* 描述:Thrift 默认超时时间
+* 默认值:60000
+
+#### `thrift_client_retry_interval_ms`
+
+* 类型:int64
+* 描述:用来为 be 的 thrift 客户端设置重试间隔,避免 FE 的 Thrift Server 发生雪崩问题,单位为 ms。
+* 默认值:1000
+
+#### `thrift_connect_timeout_seconds`
+
+* 描述:默认 Thrift 客户端连接超时时间
+* 默认值:3 (s)
+
+#### `thrift_server_type_of_fe`
+
+* 类型:string
+* 描述:该配置表示 FE 的 Thrift 服务使用的服务模型,类型为 string, 大小写不敏感,该参数需要和 FE 的 thrift_server_type 参数的设置保持一致。目前该参数的取值有两个,`THREADED`和`THREAD_POOL`。
+
+ - 若该参数为`THREADED`, 该模型为非阻塞式 I/O 模型,
+
+ - 若该参数为`THREAD_POOL`, 该模型为阻塞式 I/O 模型。
+
+#### `thrift_max_message_size`
+
+默认值:100MB
+
+Thrift 服务器接收请求消息的大小(字节数)上限。如果客户端发送的消息大小超过该值,那么 Thrift 服务器会拒绝该请求并关闭连接,这种情况下,client 会遇到错误:“connection has been closed by peer”,使用者可以尝试增大该参数以绕过上述限制。
+
+#### `txn_commit_rpc_timeout_ms`
+
+* 描述:txn 提交 rpc 超时
+* 默认值:60000 (ms)
+
+#### `txn_map_shard_size`
+
+* 描述:txn_map_lock 分片大小,取值为 2^n,n=0,1,2,3,4。这是一项增强功能,可提高管理 txn 的性能
+* 默认值:128
+
+#### `txn_shard_size`
+
+* 描述:txn_lock 分片大小,取值为 2^n,n=0,1,2,3,4,这是一项增强功能,可提高提交和发布 txn 的性能
+* 默认值:1024
+
+#### `unused_rowset_monitor_interval`
+
+* 描述:清理过期 Rowset 的时间间隔
+* 默认值:30 (s)
+
+#### `max_client_cache_size_per_host`
+
+* 描述:每个主机的最大客户端缓存数,BE 中有多种客户端缓存,但目前我们使用相同的缓存大小配置。如有必要,使用不同的配置来设置不同的客户端缓存。
+* 默认值:10
+
+#### `string_type_length_soft_limit_bytes`
+
+* 类型:int32
+* 描述:String 类型最大长度的软限,单位是字节
+* 默认值:1048576
+
+#### `big_column_size_buffer`
+
+* 类型:int64
+* 描述:当使用 odbc 外表时,如果 odbc 源表的某一列类型为 HLL, CHAR 或者 VARCHAR,并且列值长度超过该值,则查询报错'column value length longer than buffer length'. 可增大该值
+* 默认值:65535
+
+#### `small_column_size_buffer`
+
+* 类型:int64
+* 描述:当使用 odbc 外表时,如果 odbc 源表的某一列类型不是 HLL, CHAR 或者 VARCHAR,并且列值长度超过该值,则查询报错'column value length longer than buffer length'. 可增大该值
+* 默认值:100
+
+### 查询
+
+#### `fragment_mgr_asynic_work_pool_queue_size`
+
+* 描述:单节点上异步任务的队列上限
+* 默认值:4096
+
+#### `fragment_mgr_asynic_work_pool_thread_num_min`
+
+* 描述:处理异步任务的线程数,默认最小启动 16 个线程。
+* 默认值:16
+
+#### `fragment_mgr_asynic_work_pool_thread_num_max`
+
+* 描述:根据后续任务动态创建线程,最大创建 512 个线程。
+* 默认值:512
+
+#### `doris_scanner_row_num`
+
+* 描述:每个扫描线程单次执行最多返回的数据行数
+* 默认值:16384
+
+#### `doris_scanner_row_bytes`
+
+* 描述:每个扫描线程单次执行最多返回的数据字节
+ - 说明:如果表的列数太多,遇到 `select *` 卡主,可以调整这个配置
+* 默认值:10485760
+
+#### `doris_scanner_thread_pool_queue_size`
+
+* 类型:int32
+* 描述:Scanner 线程池的队列长度。在 Doris 的扫描任务之中,每一个 Scanner 会作为一个线程 Task 提交到线程池之中等待被调度,而提交的任务数目超过线程池队列的长度之后,后续提交的任务将阻塞直到队列之中有新的空缺。
+* 默认值:102400
+
+#### `doris_scanner_thread_pool_thread_num`
+
+* 类型:int32
+* 描述:Scanner 线程池线程数目。在 Doris 的扫描任务之中,每一个 Scanner 会作为一个线程 Task 提交到线程池之中等待被调度,该参数决定了 Scanner 线程池的大小。
+* 默认值:取决于 CPU 核心数量。等于 `max(48, num_of_cpu_cores)`
+
+#### `doris_max_remote_scanner_thread_pool_thread_num`
+
+* 类型:int32
+* 描述:Remote scanner thread pool 的最大线程数。Remote scanner thread pool 用于除内表外的所有 scan 任务的执行。
+* 默认值:512
+
+#### `exchg_node_buffer_size_bytes`
+
+* 类型:int32
+* 描述:ExchangeNode 节点 Buffer 队列的大小,单位为 byte。来自 Sender 端发送的数据量大于 ExchangeNode 的 Buffer 大小之后,后续发送的数据将阻塞直到 Buffer 腾出可写入的空间。
+* 默认值:10485760
+
+#### `doris_scan_range_max_mb`
+
+* 类型:int32
+* 描述:每个 OlapScanner 读取的最大数据量
+* 默认值:1024
+
+### compaction
+
+#### `disable_auto_compaction`
+
+* 类型:bool
+* 描述:关闭自动执行 compaction 任务
+ - 一般需要为关闭状态,当调试或测试环境中想要手动操作 compaction 任务时,可以对该配置进行开启
+* 默认值:false
+
+#### `enable_vertical_compaction`
+
+* 类型:bool
+* 描述:是否开启列式 compaction
+* 默认值:true
+
+#### `vertical_compaction_num_columns_per_group`
+
+* 类型:int32
+* 描述:在列式 compaction 中,组成一个合并组的列个数
+* 默认值:5
+
+#### `vertical_compaction_max_row_source_memory_mb`
+
+* 类型:int32
+* 描述:在列式 compaction 中,row_source_buffer 能使用的最大内存,单位是 MB。
+* 默认值:200
+
+#### `vertical_compaction_max_segment_size`
+
+* 类型:int32
+* 描述:在列式 compaction 中,输出的 segment 文件最大值,单位是 m 字节。
+* 默认值:268435456
+
+#### `enable_ordered_data_compaction`
+
+* 类型:bool
+* 描述:是否开启有序数据的 compaction
+* 默认值:true
+
+#### `ordered_data_compaction_min_segment_size`
+
+* 类型:int32
+* 描述:在有序数据 compaction 中,满足要求的最小 segment 大小,单位是 m 字节。
+* 默认值:10485760
+
+#### `max_base_compaction_threads`
+
+* 类型:int32
+* 描述:Base Compaction 线程池中线程数量的最大值,-1 表示每个磁盘一个线程。
+* 默认值:4
+
+#### `generate_compaction_tasks_interval_ms`
+
+* 描述:生成 compaction 作业的最小间隔时间
+* 默认值:10(ms)
+
+#### `base_compaction_min_rowset_num`
+
+* 描述:BaseCompaction 触发条件之一:Cumulative 文件数目要达到的限制,达到这个限制之后会触发 BaseCompaction
+* 默认值:5
+
+#### `base_compaction_min_data_ratio`
+
+* 描述:BaseCompaction 触发条件之一:Cumulative 文件大小达到 Base 文件的比例。
+* 默认值:0.3(30%)
+
+#### `total_permits_for_compaction_score`
+
+* 类型:int64
+* 描述:被所有的 compaction 任务所能持有的 "permits" 上限,用来限制 compaction 占用的内存。
+* 默认值:10000
+* 可动态修改:是
+
+#### `compaction_promotion_size_mbytes`
+
+* 类型:int64
+* 描述:cumulative compaction 的输出 rowset 总磁盘大小超过了此配置大小,该 rowset 将用于 base compaction。单位是 m 字节。
+ - 一般情况下,配置在 2G 以内,为了防止 cumulative compaction 时间过长,导致版本积压。
+* 默认值:1024
+
+#### `compaction_promotion_ratio`
+
+* 类型:double
+* 描述:cumulative compaction 的输出 rowset 总磁盘大小超过 base 版本 rowset 的配置比例时,该 rowset 将用于 base compaction。
+ - 一般情况下,建议配置不要高于 0.1,低于 0.02。
+* 默认值:0.05
+
+#### `compaction_promotion_min_size_mbytes`
+
+* 类型:int64
+* 描述:Cumulative compaction 的输出 rowset 总磁盘大小低于此配置大小,该 rowset 将不进行 base compaction,仍然处于 cumulative compaction 流程中。单位是 m 字节。
+ - 一般情况下,配置在 512m 以内,配置过大会导致 base 版本早期的大小过小,一直不进行 base compaction。
+* 默认值:128
+
+#### `compaction_min_size_mbytes`
+
+* 类型:int64
+* 描述:cumulative compaction 进行合并时,选出的要进行合并的 rowset 的总磁盘大小大于此配置时,才按级别策略划分合并。小于这个配置时,直接执行合并。单位是 m 字节。
+ - 一般情况下,配置在 128m 以内,配置过大会导致 cumulative compaction 写放大较多。
+* 默认值:64
+
+#### `default_rowset_type`
+
+* 类型:string
+* 描述:标识 BE 默认选择的存储格式,可配置的参数为:"**ALPHA**", "**BETA**"。主要起以下两个作用
+ - 当建表的 storage_format 设置为 Default 时,通过该配置来选取 BE 的存储格式。
+ - 进行 Compaction 时选择 BE 的存储格式
+* 默认值:BETA
+
+#### `cumulative_compaction_min_deltas`
+
+* 描述:cumulative compaction 策略:最小增量文件的数量
+* 默认值:5
+
+#### `cumulative_compaction_max_deltas`
+
+* 描述:cumulative compaction 策略:最大增量文件的数量
+* 默认值:1000
+
+#### `base_compaction_trace_threshold`
+
+* 类型:int32
+* 描述:打印 base compaction 的 trace 信息的阈值,单位秒
+* 默认值:10
+
+base compaction 是一个耗时较长的后台操作,为了跟踪其运行信息,可以调整这个阈值参数来控制 trace 日志的打印。打印信息如下:
+
+```
+W0610 11:26:33.804431 56452 storage_engine.cpp:552] execute base compaction cost 0.00319222
+BaseCompaction:546859:
+ - filtered_rows: 0
+ - input_row_num: 10
+ - input_rowsets_count: 10
+ - input_rowsets_data_size: 2.17 KB
+ - input_segments_num: 10
+ - merge_rowsets_latency: 100000.510ms
+ - merged_rows: 0
+ - output_row_num: 10
+ - output_rowset_data_size: 224.00 B
+ - output_segments_num: 1
+0610 11:23:03.727535 (+ 0us) storage_engine.cpp:554] start to perform base compaction
+0610 11:23:03.728961 (+ 1426us) storage_engine.cpp:560] found best tablet 546859
+0610 11:23:03.728963 (+ 2us) base_compaction.cpp:40] got base compaction lock
+0610 11:23:03.729029 (+ 66us) base_compaction.cpp:44] rowsets picked
+0610 11:24:51.784439 (+108055410us) compaction.cpp:46] got concurrency lock and start to do compaction
+0610 11:24:51.784818 (+ 379us) compaction.cpp:74] prepare finished
+0610 11:26:33.359265 (+101574447us) compaction.cpp:87] merge rowsets finished
+0610 11:26:33.484481 (+125216us) compaction.cpp:102] output rowset built
+0610 11:26:33.484482 (+ 1us) compaction.cpp:106] check correctness finished
+0610 11:26:33.513197 (+ 28715us) compaction.cpp:110] modify rowsets finished
+0610 11:26:33.513300 (+ 103us) base_compaction.cpp:49] compaction finished
+0610 11:26:33.513441 (+ 141us) base_compaction.cpp:56] unused rowsets have been moved to GC queue
+```
+
+#### `cumulative_compaction_trace_threshold`
+
+* 类型:int32
+* 描述:打印 cumulative compaction 的 trace 信息的阈值,单位秒
+ - 与 base_compaction_trace_threshold 类似。
+* 默认值:2
+
+#### `compaction_task_num_per_disk`
+
+* 类型:int32
+* 描述:每个磁盘(HDD)可以并发执行的 compaction 任务数量。
+* 默认值:4
+
+#### `compaction_task_num_per_fast_disk`
+
+* 类型:int32
+* 描述:每个高速磁盘(SSD)可以并发执行的 compaction 任务数量。
+* 默认值:8
+
+#### `cumulative_compaction_rounds_for_each_base_compaction_round`
+
+* 类型:int32
+* 描述:Compaction 任务的生产者每次连续生产多少轮 cumulative compaction 任务后生产一轮 base compaction。
+* 默认值:9
+
+#### `max_cumu_compaction_threads`
+
+* 类型:int32
+* 描述:Cumulative Compaction 线程池中线程数量的最大值,-1 表示每个磁盘一个线程。
+* 默认值:-1
+
+#### `enable_segcompaction`
+
+* 类型:bool
+* 描述:在导入时进行 segment compaction 来减少 segment 数量,以避免出现写入时的 -238 错误
+* 默认值:true
+
+#### `segcompaction_batch_size`
+
+* 类型:int32
+* 描述:当 segment 数量超过此阈值时触发 segment compaction,该配置也限制了单个 segment compaction 任务中的最大原始 segment 数量。
+* 默认值:10
+
+#### `segcompaction_candidate_max_rows`
+
+* 类型:int32
+* 描述:当 segment 的行数超过此大小时则会在 segment compaction 时被 compact,否则跳过
+* 默认值:1048576
+
+#### `segcompaction_candidate_max_rows`
+
+* 类型:int32
+* 描述:segment compaction 任务中允许的单个原始 segment 行数,过大的 segment 将被跳过。
+* 默认值:1048576
+
+#### `segcompaction_candidate_max_bytes`
+
+* 类型:int64
+* 描述:segment compaction 任务中允许的单个原始 segment 大小(字节),过大的 segment 将被跳过。
+* 默认值:104857600
+
+#### `segcompaction_task_max_rows`
+
+* 类型:int32
+* 描述:单个 segment compaction 任务中允许的原始 segment 总行数。
+* 默认值:1572864
+
+#### `segcompaction_task_max_bytes`
+
+* 类型:int64
+* 描述:单个 segment compaction 任务中允许的原始 segment 总大小(字节)。
+* 默认值:157286400
+
+#### `segcompaction_num_threads`
+
+* 类型:int32
+* 描述:segment compaction 线程池大小。
+* 默认值:5
+
+#### `disable_compaction_trace_log`
+
+* 类型:bool
+* 描述:关闭 compaction 的 trace 日志
+ - 如果设置为 true,`cumulative_compaction_trace_threshold` 和 `base_compaction_trace_threshold` 将不起作用。并且 trace 日志将关闭。
+* 默认值:true
+
+#### `pick_rowset_to_compact_interval_sec`
+
+* 类型:int64
+* 描述:选取 rowset 去合并的时间间隔,单位为秒
+* 默认值:86400
+
+#### `max_single_replica_compaction_threads`
+
+* 类型:int32
+* 描述:Single Replica Compaction 线程池中线程数量的最大值,-1 表示每个磁盘一个线程。
+* 默认值:-1
+
+#### `update_replica_infos_interval_seconds`
+
+* 描述:更新 peer replica infos 的最小间隔时间
+* 默认值:60(s)
+
+
+### 导入
+
+#### `enable_stream_load_record`
+
+* 类型:bool
+* 描述:是否开启 stream load 操作记录,默认是不启用
+* 默认值:false
+
+#### `load_data_reserve_hours`
+
+* 描述:用于 mini load。mini load 数据文件将在此时间后被删除
+* 默认值:4(h)
+
+#### `push_worker_count_high_priority`
+
+* 描述:导入线程数,用于处理 HIGH 优先级任务
+* 默认值:3
+
+#### `push_worker_count_normal_priority`
+
+* 描述:导入线程数,用于处理 NORMAL 优先级任务
+* 默认值:3
+
+#### `enable_single_replica_load`
+
+* 描述:是否启动单副本数据导入功能
+* 默认值:true
+
+#### `load_error_log_reserve_hours`
+
+* 描述:load 错误日志将在此时间后删除
+* 默认值:48(h)
+
+#### `load_error_log_limit_bytes`
+
+* 描述:load 错误日志大小超过此值将被截断
+* 默认值:209715200 (byte)
+
+#### `load_process_max_memory_limit_percent`
+
+* 描述:单节点上所有的导入线程占据的内存上限比例
+ - 将这些默认值设置得很大,因为我们不想在用户升级 Doris 时影响负载性能。如有必要,用户应正确设置这些配置。
+* 默认值:50(%)
+
+#### `load_process_soft_mem_limit_percent`
+
+* 描述:soft limit 是指站单节点导入内存上限的比例。例如所有导入任务导入的内存上限是 20GB,则 soft limit 默认为该值的 50%,即 10GB。导入内存占用超过 soft limit 时,会挑选占用内存最大的作业进行下刷以提前释放内存空间。
+* 默认值:50(%)
+
+#### `slave_replica_writer_rpc_timeout_sec`
+
+* 类型:int32
+* 描述:单副本数据导入功能中,Master 副本和 Slave 副本之间通信的 RPC 超时时间。
+* 默认值:60
+
+#### `max_segment_num_per_rowset`
+
+* 类型:int32
+* 描述:用于限制导入时,新产生的 rowset 中的 segment 数量。如果超过阈值,导入会失败并报错 -238。过多的 segment 会导致 compaction 占用大量内存引发 OOM 错误。
+* 默认值:200
+
+#### `high_priority_flush_thread_num_per_store`
+
+* 类型:int32
+* 描述:每个存储路径所分配的用于高优导入任务的 flush 线程数量。
+* 默认值:1
+
+#### `routine_load_consumer_pool_size`
+
+* 类型:int32
+* 描述:routine load 所使用的 data consumer 的缓存数量。
+* 默认值:10
+
+#### `multi_table_batch_plan_threshold`
+
+* 类型:int32
+* 描述:一流多表使用该配置,表示攒多少条数据再进行规划。过小的值会导致规划频繁,多大的值会增加内存压力和导入延迟。
+* 默认值:200
+
+#### `multi_table_max_wait_tables`
+
+* 类型:int32
+* 描述:一流多表使用该配置,如果等待执行的表的数量大于此阈值,将请求并执行所有相关表的计划。该参数旨在避免一次同时请求和执行过多的计划。将导入过程的多表进行小批处理,可以减少单次 rpc 的压力,同时可以提高导入数据处理的实时性。
+* 默认值:5
+
+#### `single_replica_load_download_num_workers`
+* 类型:int32
+* 描述:单副本数据导入功能中,Slave 副本通过 HTTP 从 Master 副本下载数据文件的工作线程数。导入并发增大时,可以适当调大该参数来保证 Slave 副本及时同步 Master 副本数据。必要时也应相应地调大`webserver_num_workers`来提高 IO 效率。
+* 默认值:64
+
+#### `load_task_high_priority_threshold_second`
+
+* 类型:int32
+* 描述:当一个导入任务的超时时间小于这个阈值是,Doris 将认为他是一个高优任务。高优任务会使用独立的 flush 线程池。
+* 默认:120
+
+#### `min_load_rpc_timeout_ms`
+
+* 类型:int32
+* 描述:load 作业中各个 rpc 的最小超时时间。
+* 默认:20
+
+#### `kafka_api_version_request`
+
+* 类型:bool
+* 描述:如果依赖的 kafka 版本低于 0.10.0.0, 该值应该被设置为 false。
+* 默认:true
+
+#### `kafka_broker_version_fallback`
+
+* 描述:如果依赖的 kafka 版本低于 0.10.0.0, 当 kafka_api_version_request 值为 false 的时候,将使用回退版本 kafka_broker_version_fallback 设置的值,有效值为:0.9.0.x、0.8.x.y。
+* 默认:0.10.0
+
+#### `max_consumer_num_per_group`
+
+* 描述:一个数据消费者组中的最大消费者数量,用于 routine load。
+* 默认:3
+
+#### `streaming_load_max_mb`
+
+* 类型:int64
+* 描述:用于限制数据格式为 csv 的一次 Stream load 导入中,允许的最大数据量。
+ - Stream Load 一般适用于导入几个 GB 以内的数据,不适合导入过大的数据。
+* 默认值:10240(MB)
+* 可动态修改:是
+
+#### `streaming_load_json_max_mb`
+
+* 类型:int64
+* 描述:用于限制数据格式为 json 的一次 Stream load 导入中,允许的最大数据量。单位 MB。
+ - 一些数据格式,如 JSON,无法进行拆分处理,必须读取全部数据到内存后才能开始解析,因此,这个值用于限制此类格式数据单次导入最大数据量。
+* 默认值:100
+* 可动态修改:是
+
+#### `olap_table_sink_send_interval_microseconds`.
+
+* 描述:数据导入时,Coordinator 的 sink 节点有一个轮询线程持续向对应 BE 发送数据。该线程将每隔 `olap_table_sink_send_interval_microseconds` 微秒检查是否有数据要发送。
+* 默认值:1000
+
+#### `olap_table_sink_send_interval_auto_partition_factor`.
+
+* 描述:如果我们向一个启用了自动分区的表导入数据,那么 `olap_table_sink_send_interval_microseconds` 的时间间隔就会太慢。在这种情况下,实际间隔将乘以该系数。
+* 默认值:0.001
+
+
+
+### 线程
+
+#### `delete_worker_count`
+
+* 描述:执行数据删除任务的线程数
+* 默认值:3
+
+#### `clear_transaction_task_worker_count`
+
+* 描述:用于清理事务的线程数
+* 默认值:1
+
+#### `clone_worker_count`
+
+* 描述:用于执行克隆任务的线程数
+* 默认值:3
+
+#### `be_service_threads`
+
+* 类型:int32
+* 描述:BE 上 Thrift Server Service 的执行线程数,代表可以用于执行 FE 请求的线程数。
+* 默认值:64
+
+#### `download_worker_count`
+
+* 描述:下载线程数
+* 默认值:1
+
+#### `drop_tablet_worker_count`
+
+* 描述:删除 tablet 的线程数
+* 默认值:3
+
+#### `flush_thread_num_per_store`
+
+* 描述:每个 store 用于刷新内存表的线程数
+* 默认值:2
+
+#### `publish_version_worker_count`
+
+* 描述:生效版本的线程数
+* 默认值:8
+
+#### `upload_worker_count`
+
+* 描述:上传文件最大线程数
+* 默认值:1
+
+#### `webserver_num_workers`
+
+* 描述:webserver 默认工作线程数
+* 默认值:48
+
+#### `send_batch_thread_pool_thread_num`
+
+* 类型:int32
+* 描述:SendBatch 线程池线程数目。在 NodeChannel 的发送数据任务之中,每一个 NodeChannel 的 SendBatch 操作会作为一个线程 Task 提交到线程池之中等待被调度,该参数决定了 SendBatch 线程池的大小。
+* 默认值:64
+
+#### `send_batch_thread_pool_queue_size`
+
+* 类型:int32
+* 描述:SendBatch 线程池的队列长度。在 NodeChannel 的发送数据任务之中,每一个 NodeChannel 的 SendBatch 操作会作为一个线程 Task 提交到线程池之中等待被调度,而提交的任务数目超过线程池队列的长度之后,后续提交的任务将阻塞直到队列之中有新的空缺。
+* 默认值:102400
+
+#### `make_snapshot_worker_count`
+
+* 描述:制作快照的线程数
+* 默认值:5
+
+#### `release_snapshot_worker_count`
+
+* 描述:释放快照的线程数
+* 默认值:5
+
+### 内存
+
+#### `max_memory_sink_batch_count`
+
+* 描述:最大外部扫描缓存批次计数,表示缓存 max_memory_cache_batch_count * batch_size row,默认为 20,batch_size 的默认值为 1024,表示将缓存 20 * 1024 行。
+* 默认值:20
+
+#### `memtable_mem_tracker_refresh_interval_ms`
+
+* 描述:memtable 主动下刷时刷新内存统计的周期(毫秒)
+* 默认值:100
+
+#### `zone_map_row_num_threshold`
+
+* 类型:int32
+* 描述:如果一个 page 中的行数小于这个值就不会创建 zonemap,用来减少数据膨胀。
+* 默认值:20
+
+#### `memory_mode`
+
+* 类型:string
+* 描述:控制 tcmalloc 的回收。如果配置为 performance,内存使用超过 mem_limit 的 90% 时,doris 会释放 tcmalloc cache 中的内存,如果配置为 compact,内存使用超过 mem_limit 的 50% 时,doris 会释放 tcmalloc cache 中的内存。
+* 默认值:performance
+
+#### `max_sys_mem_available_low_water_mark_bytes`
+
+* 类型:int64
+* 描述:系统`/proc/meminfo/MemAvailable` 的最大低水位线,单位字节,默认 1.6G,实际低水位线=min(1.6G,MemTotal * 10%),避免在大于 16G 的机器上浪费过多内存。调大 max,在大于 16G 内存的机器上,将为 Full GC 预留更多的内存 buffer;反之调小 max,将尽可能充分使用内存。
+* 默认值:1717986918
+
+#### `memory_limitation_per_thread_for_schema_change_bytes`
+
+* 描述:单个 schema change 任务允许占用的最大内存。
+* 默认值:2147483648 (2GB)
+
+#### `mem_tracker_consume_min_size_bytes`
+
+* 类型:int32
+* 描述:TCMalloc Hook consume/release MemTracker 时的最小长度,小于该值的 consume size 会持续累加,避免频繁调用 MemTracker 的 consume/release,减小该值会增加 consume/release 的频率,增大该值会导致 MemTracker 统计不准,理论上一个 MemTracker 的统计值与真实值相差 = (mem_tracker_consume_min_size_bytes * 这个 MemTracker 所在的 BE 线程数)。
+* 默认值:1048576
+
+#### `min_buffer_size`
+
+* 描述:最小读取缓冲区大小
+* 默认值:1024 (byte)
+
+#### `write_buffer_size`
+
+* 描述:刷写前缓冲区的大小
+ - 导入数据在 BE 上会先写入到一个内存块,当这个内存块达到阈值后才会写回磁盘。默认大小是 100MB。过小的阈值可能导致 BE 上存在大量的小文件。可以适当提高这个阈值减少文件数量。但过大的阈值可能导致 RPC 超时
+* 默认值:104857600
+
+#### `remote_storage_read_buffer_mb`
+
+* 类型:int32
+* 描述:读取 hdfs 或者对象存储上的文件时,使用的缓存大小。
+ - 增大这个值,可以减少远端数据读取的调用次数,但会增加内存开销。
+* 默认值:16MB
+
+#### `path_gc_check`
+
+* 类型:bool
+* 描述:是否启用回收扫描数据线程检查
+* 默认值:true
+
+#### `path_gc_check_interval_second`
+
+* 描述:回收扫描数据线程检查时间间隔
+* 默认值:86400 (s)
+
+#### `path_gc_check_step`
+
+* 默认值:1000
+
+#### `path_gc_check_step_interval_ms`
+
+* 默认值:10 (ms)
+
+#### `scan_context_gc_interval_min`
+
+* 描述:此配置用于上下文 gc 线程调度周期
+* 默认值:5 (分钟)
+
+### 存储
+
+#### `default_num_rows_per_column_file_block`
+
+* 类型:int32
+* 描述:配置单个 RowBlock 之中包含多少行的数据。
+* 默认值:1024
+
+#### `disable_storage_page_cache`
+
+* 类型:bool
+* 描述:是否进行使用 page cache 进行 index 的缓存,该配置仅在 BETA 存储格式时生效
+* 默认值:false
+
+#### `disk_stat_monitor_interval`
+
+* 描述:磁盘状态检查时间间隔。
+* 默认值:5(s)
+
+#### `max_garbage_sweep_interval`
+
+* 描述:磁盘进行垃圾清理的最大间隔。
+* 默认值:3600 (s)
+
+#### `max_percentage_of_error_disk`
+
+* 类型:int32
+* 描述:存储引擎允许存在损坏硬盘的百分比,损坏硬盘超过改比例后,BE 将会自动退出。
+* 默认值:0
+
+#### `min_garbage_sweep_interval`
+
+* 描述:磁盘进行垃圾清理的最小间隔
+* 默认值:180 (s)
+
+#### `pprof_profile_dir`
+
+* 描述:pprof profile 保存目录。
+* 默认值:${DORIS_HOME}/log
+
+#### `small_file_dir`
+
+* 描述:用于保存 SmallFileMgr 下载的文件的目录。
+* 默认值:${DORIS_HOME}/lib/small_file/
+
+#### `user_function_dir`
+
+* 描述:udf 函数目录。
+* 默认值:${DORIS_HOME}/lib/udf
+
+#### `storage_flood_stage_left_capacity_bytes`
+
+* 描述:数据目录应该剩下的最小存储空间,默认 1G。
+* 默认值:1073741824
+
+
+#### `storage_flood_stage_usage_percent`
+
+* 描述:storage_flood_stage_usage_percent 和 storage_flood_stage_left_capacity_bytes 两个配置限制了数据目录的磁盘容量的最大使用。如果这两个阈值都达到,则无法将更多数据写入该数据目录。数据目录的最大已用容量百分比
+* 默认值:90(90%)
+
+#### `storage_medium_migrate_count`
+
+* 描述:要克隆的线程数。
+* 默认值:1
+
+#### `storage_page_cache_limit`
+
+* 描述:缓存存储页大小。
+* 默认值:20%
+
+#### `storage_page_cache_shard_size`
+
+* 描述:StoragePageCache 的分片大小,值为 2^n (n=0,1,2,...)。建议设置为接近 BE CPU 核数的值,可减少 StoragePageCache 的锁竞争。
+* 默认值:16
+
+#### `index_page_cache_percentage`
+
+* 类型:int32
+* 描述:索引页缓存占总页面缓存的百分比,取值为[0, 100]。
+* 默认值:10
+
+#### `segment_cache_capacity`
+* Type: int32
+* Description: segment 元数据缓存(以 rowset id 为 key)的最大 rowset 个数。-1 代表向后兼容取值为 fd_number * 2/5
+* Default value: -1
+
+#### `storage_strict_check_incompatible_old_format`
+
+* 类型:bool
+* 描述:用来检查不兼容的旧版本格式时是否使用严格的验证方式。
+ - 配置用来检查不兼容的旧版本格式时是否使用严格的验证方式,当含有旧版本的 `hdr` 格式时,使用严谨的方式时,程序会打出 `fatal log` 并且退出运行;否则,程序仅打印 `warn log`.
+* 默认值:true
+* 可动态修改:否
+
+#### `sync_tablet_meta`
+
+* 描述:存储引擎是否开 sync 保留到磁盘上
+* 默认值:true
+
+#### `pending_data_expire_time_sec`
+
+* 描述:存储引擎保留的未生效数据的最大时长
+* 默认值:1800 (s)
+
+#### `create_tablet_worker_count`
+
+* 描述:BE 创建 tablet 的工作线程数
+* 默认值:3
+
+#### `check_consistency_worker_count`
+
+* 描述:计算 tablet 的校验和 (checksum) 的工作线程数
+* 默认值:1
+
+#### `max_tablet_version_num`
+
+* 类型:int
+* 描述:限制单个 tablet 最大 version 的数量。用于防止导入过于频繁,或 compaction 不及时导致的大量 version 堆积问题。当超过限制后,导入任务将被拒绝。
+* 默认值:2000
+
+#### `tablet_map_shard_size`
+
+* 描述:tablet_map_lock 分片大小,值为 2^n, n=0,1,2,3,4,这是为了更好地管理 tablet
+* 默认值:4
+
+#### `tablet_meta_checkpoint_min_interval_secs`
+
+* 描述:TabletMeta Checkpoint 线程轮询的时间间隔
+* 默认值:600 (s)
+
+#### `tablet_meta_checkpoint_min_new_rowsets_num`
+
+* 描述:TabletMeta Checkpoint 的最小 Rowset 数目
+* 默认值:10
+
+#### `tablet_rowset_stale_sweep_time_sec`
+
+* 类型:int64
+* 描述:用来表示清理合并版本的过期时间,当当前时间 now() 减去一个合并的版本路径中 rowset 最近创建创建时间大于 tablet_rowset_stale_sweep_time_sec 时,对当前路径进行清理,删除这些合并过的 rowset, 单位为 s。
+ - 当写入过于频繁,可能会引发 fe 查询不到已经合并过的版本,引发查询 -230 错误。可以通过调大该参数避免该问题。
+* 默认值:300
+
+#### `tablet_writer_open_rpc_timeout_sec`
+
+* 描述:在远程 BE 中打开 tablet writer 的 rpc 超时。操作时间短,可设置短超时时间
+ - 导入过程中,发送一个 Batch(1024 行)的 RPC 超时时间。默认 60 秒。因为该 RPC 可能涉及多个 分片内存块的写盘操作,所以可能会因为写盘导致 RPC 超时,可以适当调整这个超时时间来减少超时错误(如 send batch fail 错误)。同时,如果调大 write_buffer_size 配置,也需要适当调大这个参数
+* 默认值:60
+
+#### `tablet_writer_ignore_eovercrowded`
+
+* 类型:bool
+* 描述:写入时可忽略 brpc 的'[E1011]The server is overcrowded'错误。
+ - 当遇到'[E1011]The server is overcrowded'的错误时,可以调整配置项`brpc_socket_max_unwritten_bytes`,但这个配置项不能动态调整。所以可通过设置此项为`true`来临时避免写失败。注意,此配置项只影响写流程,其他的 rpc 请求依旧会检查是否 overcrowded。
+* 默认值:false
+
+#### `streaming_load_rpc_max_alive_time_sec`
+
+* 描述:TabletsChannel 的存活时间。如果此时通道没有收到任何数据,通道将被删除。
+* 默认值:1200
+
+#### `alter_tablet_worker_count`
+
+* 描述:进行 schema change 的线程数
+* 默认值:3
+
+### `alter_index_worker_count`
+
+* 描述:进行 index change 的线程数
+* 默认值:3
+
+#### `ignore_load_tablet_failure`
+
+* 类型:bool
+* 描述:用来决定在有 tablet 加载失败的情况下是否忽略错误,继续启动 be
+* 默认值:false
+
+BE 启动时,会对每个数据目录单独启动一个线程进行 tablet header 元信息的加载。默认配置下,如果某个数据目录有 tablet 加载失败,则启动进程会终止。同时会在 `be.INFO` 日志中看到如下错误信息:
+
+```
+load tablets from header failed, failed tablets size: xxx, path=xxx
+```
+
+表示该数据目录共有多少 tablet 加载失败。同时,日志中也会有加载失败的 tablet 的具体信息。此时需要人工介入来对错误原因进行排查。排查后,通常有两种方式进行恢复:
+
+1. tablet 信息不可修复,在确保其他副本正常的情况下,可以通过 `meta_tool` 工具将错误的 tablet 删除。
+2. 将 `ignore_load_tablet_failure` 设置为 true,则 BE 会忽略这些错误的 tablet,正常启动。
+
+#### `report_disk_state_interval_seconds`
+
+* 描述:代理向 FE 报告磁盘状态的间隔时间
+* 默认值:60 (s)
+
+#### `result_buffer_cancelled_interval_time`
+
+* 描述:结果缓冲区取消时间
+* 默认值:300 (s)
+
+#### `snapshot_expire_time_sec`
+
+* 描述:快照文件清理的间隔
+* 默认值:172800 (48 小时)
+
+### 日志
+
+#### `sys_log_dir`
+
+* 类型:string
+* 描述:BE 日志数据的存储目录
+* 默认值:${DORIS_HOME}/log
+
+#### `sys_log_level`
+
+* 描述:日志级别,INFO < WARNING < ERROR < FATAL
+* 默认值:INFO
+
+#### `sys_log_roll_mode`
+
+* 描述:日志拆分的大小,每 1G 拆分一个日志文件
+* 默认值:SIZE-MB-1024
+
+#### `sys_log_roll_num`
+
+* 描述:日志文件保留的数目
+* 默认值:10
+
+#### `sys_log_verbose_level`
+
+* 描述:日志显示的级别,用于控制代码中 VLOG 开头的日志输出
+* 默认值:10
+
+#### `sys_log_verbose_modules`
+
+* 描述:日志打印的模块,写 olap 就只打印 olap 模块下的日志
+* 默认值:空
+
+#### `aws_log_level`
+
+* 类型:int32
+* 描述:AWS SDK 的日志级别
+ ```
+ Off = 0,
+ Fatal = 1,
+ Error = 2,
+ Warn = 3,
+ Info = 4,
+ Debug = 5,
+ Trace = 6
+ ```
+* 默认值:3
+
+#### `log_buffer_level`
+
+* 描述:日志刷盘的策略,默认保持在内存中
+* 默认值:空
+
+### 其它
+
+#### `report_tablet_interval_seconds`
+
+* 描述:代理向 FE 报告 olap 表的间隔时间
+* 默认值:60 (s)
+
+#### `report_task_interval_seconds`
+
+* 描述:代理向 FE 报告任务签名的间隔时间
+* 默认值:10 (s)
+
+#### `enable_metric_calculator`
+
+* 描述:如果设置为 true,metric calculator 将运行,收集 BE 相关指标信息,如果设置成 false 将不运行
+* 默认值:true
+
+#### `enable_system_metrics`
+
+* 描述:用户控制打开和关闭系统指标
+* 默认值:true
+
+#### `enable_token_check`
+
+* 描述:用于向前兼容,稍后将被删除
+* 默认值:true
+
+#### `max_runnings_transactions_per_txn_map`
+
+* 描述:txn 管理器中每个 txn_partition_map 的最大 txns 数,这是一种自我保护,以避免在管理器中保存过多的 txns
+* 默认值:2000
+
+#### `max_download_speed_kbps`
+
+* 描述:最大下载速度限制
+* 默认值:50000(kb/s)
+
+#### `download_low_speed_time`
+
+* 描述:下载时间限制
+* 默认值:300 (s)
+
+#### `download_low_speed_limit_kbps`
+
+* 描述:下载最低限速
+* 默认值:50 (KB/s)
+
+#### `enable_batch_download`
+
+* 描述:是否允许批量下载文件,建议只在开启 binlog 的情况下打开
+* 默认值:false
+
+#### `priority_queue_remaining_tasks_increased_frequency`
+
+* 描述:BlockingPriorityQueue 中剩余任务的优先级频率增加
+* 默认值:512
+
+#### `jdbc_drivers_dir`
+
+* 描述:存放 jdbc driver 的默认目录。
+* 默认值:`${DORIS_HOME}/jdbc_drivers`
+
+#### `enable_simdjson_reader`
+
+* 描述:是否在导入 json 数据时用 simdjson 来解析。
+* 默认值:true
+
+#### `enable_query_memory_overcommit`
+
+* 描述:如果为 true,则当内存未超过 exec_mem_limit 时,查询内存将不受限制;当进程内存超过 exec_mem_limit 且大于 2GB 时,查询会被取消。如果为 false,则在使用的内存超过 exec_mem_limit 时取消查询。
+* 默认值:true
+
+#### `user_files_secure_path`
+
+* 描述:`local` 表函数查询的文件的存储目录。
+* 默认值:`${DORIS_HOME}`
+
+#### `brpc_streaming_client_batch_bytes`
+
+* 描述:brpc streaming 客户端发送数据时的攒批大小(字节)
+* 默认值:262144
+
+#### `grace_shutdown_wait_seconds`
+
+* 描述:在云原生的部署模式下,为了节省资源一个 BE 可能会被频繁的加入集群或者从集群中移除。如果在这个 BE 上有正在运行的 Query,那么这个 Query 会失败。用户可以使用 stop_be.sh --grace 的方式来关闭一个 BE 节点,此时 BE 会等待当前正在这个 BE 上运行的所有查询都结束才会退出。同时,在这个时间范围内 FE 也不会分发新的 query 到这个机器上。如果超过 grace_shutdown_wait_seconds 这个阈值,那么 BE 也会直接退出,防止一些查询长期不退出导致节点没法快速下掉的情况。
+* 默认值:120
+
+#### `enable_java_support`
+
+* 描述:BE 是否开启使用 java-jni,开启后允许 c++ 与 java 之间的相互调用。目前已经支持 hudi、java-udf、jdbc、max-compute、paimon、preload、avro
+* 默认值:true
+
+#### `group_commit_wal_path`
+
+* 描述:Group Commit 存放 WAL 文件的目录,请参考 [Group Commit](../../data-operate/import/group-commit-manual.md)
+* 默认值:默认在用户配置的`storage_root_path`的各个目录下创建一个名为`wal`的目录。配置示例:
+ ```
+ group_commit_wal_path=/data1/storage/wal;/data2/storage/wal;/data3/storage/wal
+ ```
+
+### 存算分离模式
+
+#### `deploy_mode`
+
+* 默认值:""
+
+* 描述:BE 运行的模式。`cloud` 表示算分离模式。
+
+#### `meta_service_endpoint`
+
+* 默认值:""
+
+* 描述:Meta Service 的端点应以 'host1:port,host2:port' 的格式指定。该值通常由 FE 通过心跳传递给 BE,无需配置。
+
+#### `enable_file_cache`
+
+* 默认值:在存算分离模式下为 true,在非存算分离模式下为 false。
+
+* 描述:是否使用文件缓存。
+
+#### `file_cache_path`
+
+* 默认值: [{"path":"${DORIS_HOME}/file_cache"}]
+
+* 描述:用于文件缓存的磁盘路径和其他参数,以数组形式表示,每个磁盘一个条目。`path` 指定磁盘路径,`total_size` 限制缓存的大小;-1 或 0 将使用整个磁盘空间。
+
+* 格式: [{"path":"/path/to/file_cache","total_size":21474836480},{"path":"/path/to/file_cache2","total_size":21474836480}]
+
+#### `time_series_max_tablet_version_num`
+
+* 类型:int
+* 描述:限制time series compaction 策略的 tablet 最大 version 的数量。用于防止导入过于频繁,或 compaction 不及时导致的大量 version 堆积问题。当超过限制后,导入任务将被拒绝。
+* 默认值:20000
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/config-dir.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/config-dir.md
new file mode 100644
index 00000000000..5b9cad3349e
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/config-dir.md
@@ -0,0 +1,30 @@
+---
+{
+ "title": "配置文件目录",
+ "language": "zh-CN"
+}
+---
+
+FE 和 BE 的配置文件目录为 `conf/`。这个目录除了存放默认的 fe.conf, be.conf 等文件外,也被用于公用的配置文件存放目录。
+
+用户可以在其中存放一些配置文件,系统会自动读取。
+
+:::note
+自 Doris 1.2 版本后支持该功能
+:::
+
+## hdfs-site.xml 和 hive-site.xml
+
+在 Doris 的一些功能中,需要访问 HDFS 上的数据,或者访问 Hive metastore。
+
+我们可以通过在功能相应的语句中,手动的填写各种 HDFS/Hive 的参数。
+
+但这些参数非常多,如果全部手动填写,非常麻烦。
+
+因此,用户可以将 HDFS 或 Hive 的配置文件 hdfs-site.xml/hive-site.xml 直接放置在 `conf/` 目录下。Doris 会自动读取这些配置文件。
+
+而用户在命令中填写的配置,会覆盖配置文件中的配置项。
+
+这样,用户仅需填写少量的配置,即可完成对 HDFS/Hive 的访问。
+
+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config-template.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config-template.md
new file mode 100644
index 00000000000..405d7dd71fd
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config-template.md
@@ -0,0 +1,120 @@
+---
+{
+ "title": "FE 配置项",
+ "language": "zh-CN",
+ "toc_min_heading_level": 2,
+ "toc_max_heading_level": 4
+}
+
+---
+
+# Doris FE 配置参数
+
+该文档主要介绍 FE 的相关配置项。
+
+FE 的配置文件 `fe.conf` 通常存放在 FE 部署路径的 `conf/` 目录下。而在 0.14 版本中会引入另一个配置文件 `fe_custom.conf`。该配置文件用于记录用户在运行时动态配置并持久化的配置项。
+
+FE 进程启动后,会先读取 `fe.conf` 中的配置项,之后再读取 `fe_custom.conf` 中的配置项。`fe_custom.conf` 中的配置项会覆盖 `fe.conf` 中相同的配置项。
+
+`fe_custom.conf` 文件的位置可以在 `fe.conf` 通过 `custom_config_dir` 配置项配置。
+
+## 注意事项
+
+**1.** 出于简化架构的目的,目前通过```mysql协议修改Config```的方式修改配置只会修改本地 FE 内存中的数据,而不会把变更同步到所有 FE。
+对于只会在 Master FE 生效的 Config 项,修改请求会自动转发到 Master 节点
+
+**2.** 需要注意```forward_to_master```选项会影响```show frontend config```的展示结果,如果```forward_to_master=true```,那么只会展示 Master 的配置(即使您此时连接的是 Follower FE 节点),这可能导致您无法看到对本地 FE 配置的修改;如果期望 show config 返回本地 FE 的配置项,那么执行命令```set forward_to_master=false```
+
+## 查看配置项
+
+FE 的配置项有两种方式进行查看:
+
+1. FE 前端页面查看
+
+ 在浏览器中打开 FE 前端页面 `http://fe_host:fe_http_port/Configure`。在 `Configure Info` 中可以看到当前生效的 FE 配置项。
+
+2. 通过命令查看
+
+ FE 启动后,可以在 MySQL 客户端中,通过以下命令查看 FE 的配置项:
+
+ `SHOW FRONTEND CONFIG;`
+
+ 结果中各列含义如下:
+
+ - Key:配置项名称。
+ - Value:当前配置项的值。
+ - Type:配置项值类型,如整型、字符串。
+ - IsMutable:是否可以动态配置。如果为 true,表示该配置项可以在运行时进行动态配置。如果 false,则表示该配置项只能在 `fe.conf` 中配置并且重启 FE 后生效。
+ - MasterOnly:是否为 Master FE 节点独有的配置项。如果为 true,则表示该配置项仅在 Master FE 节点有意义,对其他类型的 FE 节点无意义。如果为 false,则表示该配置项在所有 FE 节点中均有意义。
+ - Comment:配置项的描述。
+
+## 设置配置项
+
+FE 的配置项有两种方式进行配置:
+
+1. 静态配置
+
+ 在 `conf/fe.conf` 文件中添加和设置配置项。`fe.conf` 中的配置项会在 FE 进程启动时被读取。没有在 `fe.conf` 中的配置项将使用默认值。
+
+2. 通过 MySQL 协议动态配置
+
+ FE 启动后,可以通过以下命令动态设置配置项。该命令需要管理员权限。
+
+ `ADMIN SET FRONTEND CONFIG ("fe_config_name" = "fe_config_value");`
+
+ 不是所有配置项都支持动态配置。可以通过 `SHOW FRONTEND CONFIG;` 命令结果中的 `IsMutable` 列查看是否支持动态配置。
+
+ 如果是修改 `MasterOnly` 的配置项,则该命令会直接转发给 Master FE 并且仅修改 Master FE 中对应的配置项。
+
+ **通过该方式修改的配置项将在 FE 进程重启后失效。**
+
+ 更多该命令的帮助,可以通过 `HELP ADMIN SET CONFIG;` 命令查看。
+
+3. 通过 HTTP 协议动态配置
+
+ 具体请参阅 [Set Config Action](../../admin-manual/open-api/fe-http/set-config-action)
+
+ 该方式也可以持久化修改后的配置项。配置项将持久化在 `fe_custom.conf` 文件中,在 FE 重启后仍会生效。
+
+## 应用举例
+
+1. 修改 `async_pending_load_task_pool_size`
+
+ 通过 `SHOW FRONTEND CONFIG;` 可以查看到该配置项不能动态配置(`IsMutable` 为 false)。则需要在 `fe.conf` 中添加:
+
+ `async_pending_load_task_pool_size=20`
+
+ 之后重启 FE 进程以生效该配置。
+
+2. 修改 `dynamic_partition_enable`
+
+ 通过 `SHOW FRONTEND CONFIG;` 可以查看到该配置项可以动态配置(`IsMutable` 为 true)。并且是 Master FE 独有配置。则首先我们可以连接到任意 FE,执行如下命令修改配置:
+
+ ```text
+ ADMIN SET FRONTEND CONFIG ("dynamic_partition_enable" = "true");`
+ ```
+
+ 之后可以通过如下命令查看修改后的值:
+
+ ```text
+ set forward_to_master=true;
+ SHOW FRONTEND CONFIG;
+ ```
+
+ 通过以上方式修改后,如果 Master FE 重启或进行了 Master 切换,则配置将失效。可以通过在 `fe.conf` 中直接添加配置项,并重启 FE 后,永久生效该配置项。
+
+3. 修改 `max_distribution_pruner_recursion_depth`
+
+ 通过 `SHOW FRONTEND CONFIG;` 可以查看到该配置项可以动态配置(`IsMutable` 为 true)。并且不是 Master FE 独有配置。
+
+ 同样,我们可以通过动态修改配置的命令修改该配置。因为该配置不是 Master FE 独有配置,所以需要单独连接到不同的 FE,进行动态修改配置的操作,这样才能保证所有 FE 都使用了修改后的配置值
+
+## 配置项列表
+
+> 注:
+>
+> 以下内容由 `docs/generate-config-and-variable-doc.sh` 自动生成。
+>
+> 如需修改,请修改 `fe/fe-common/src/main/java/org/apache/doris/common/Config.java` 中的描述信息。
+
+<--DOC_PLACEHOLDER-->
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config.md
new file mode 100644
index 00000000000..d4a43e4bce6
--- /dev/null
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config.md
@@ -0,0 +1,2768 @@
+---
+{
+ "title": "FE 配置项",
+ "language": "zh-CN",
+ "toc_min_heading_level": 2,
+ "toc_max_heading_level": 4
+}
+
+---
+
+# Doris FE 配置参数
+
+该文档主要介绍 FE 的相关配置项。
+
+FE 的配置文件 `fe.conf` 通常存放在 FE 部署路径的 `conf/` 目录下。而在 0.14 版本中会引入另一个配置文件 `fe_custom.conf`。该配置文件用于记录用户在运行时动态配置并持久化的配置项。
+
+FE 进程启动后,会先读取 `fe.conf` 中的配置项,之后再读取 `fe_custom.conf` 中的配置项。`fe_custom.conf` 中的配置项会覆盖 `fe.conf` 中相同的配置项。
+
+`fe_custom.conf` 文件的位置可以在 `fe.conf` 通过 `custom_config_dir` 配置项配置。
+
+## 查看配置项
+
+FE 的配置项有两种方式进行查看:
+
+1. FE 前端页面查看
+
+ 在浏览器中打开 FE 前端页面 `http://fe_host:fe_http_port/variable`。在 `Configure Info` 中可以看到当前生效的 FE 配置项。
+
+2. 通过命令查看
+
+ FE 启动后,可以在 MySQL 客户端中,通过以下命令查看 FE 的配置项,具体语法参照[SHOW-CONFIG](../../sql-manual/sql-statements/cluster-management/instance-management/SHOW-CONFIG):
+
+ `SHOW FRONTEND CONFIG;`
+
+ 结果中各列含义如下:
+
+ - Key:配置项名称。
+ - Value:当前配置项的值。
+ - Type:配置项值类型,如整型、字符串。
+ - IsMutable:是否可以动态配置。如果为 true,表示该配置项可以在运行时进行动态配置。如果 false,则表示该配置项只能在 `fe.conf` 中配置并且重启 FE 后生效。
+ - MasterOnly:是否为 Master FE 节点独有的配置项。如果为 true,则表示该配置项仅在 Master FE 节点有意义,对其他类型的 FE 节点无意义。如果为 false,则表示该配置项在所有 FE 节点中均有意义。
+ - Comment:配置项的描述。
+
+## 设置配置项
+
+FE 的配置项有两种方式进行配置:
+
+1. 静态配置
+
+ 在 `conf/fe.conf` 文件中添加和设置配置项。`fe.conf` 中的配置项会在 FE 进程启动时被读取。没有在 `fe.conf` 中的配置项将使用默认值。
+
+2. 通过 MySQL 协议动态配置
+
+ FE 启动后,可以通过以下命令动态设置配置项。该命令需要管理员权限。
+
+ `ADMIN SET FRONTEND CONFIG ("fe_config_name" = "fe_config_value");`
+
+ 不是所有配置项都支持动态配置。可以通过 `SHOW FRONTEND CONFIG;` 命令结果中的 `IsMutable` 列查看是否支持动态配置。
+
+ 如果是修改 `MasterOnly` 的配置项,则该命令会直接转发给 Master FE 并且仅修改 Master FE 中对应的配置项。
+
+ **通过该方式修改的配置项将在 FE 进程重启后失效。**
+
+ 更多该命令的帮助,可以通过 `HELP ADMIN SET CONFIG;` 命令查看。
+
+3. 通过 HTTP 协议动态配置
+
+ 具体请参阅 [Set Config Action](../../admin-manual/open-api/fe-http/set-config-action)
+
+ 该方式也可以持久化修改后的配置项。配置项将持久化在 `fe_custom.conf` 文件中,在 FE 重启后仍会生效。
+
+## 应用举例
+
+1. 修改 `async_pending_load_task_pool_size`
+
+ 通过 `SHOW FRONTEND CONFIG;` 可以查看到该配置项不能动态配置(`IsMutable` 为 false)。则需要在 `fe.conf` 中添加:
+
+ `async_pending_load_task_pool_size=20`
+
+ 之后重启 FE 进程以生效该配置。
+
+2. 修改 `dynamic_partition_enable`
+
+ 通过 `SHOW FRONTEND CONFIG;` 可以查看到该配置项可以动态配置(`IsMutable` 为 true)。并且是 Master FE 独有配置。则首先我们可以连接到任意 FE,执行如下命令修改配置:
+
+ ```text
+ ADMIN SET FRONTEND CONFIG ("dynamic_partition_enable" = "true");`
+ ```
+
+ 之后可以通过如下命令查看修改后的值:
+
+ ```text
+ set forward_to_master=true;
+ SHOW FRONTEND CONFIG;
+ ```
+
+ 通过以上方式修改后,如果 Master FE 重启或进行了 Master 切换,则配置将失效。可以通过在 `fe.conf` 中直接添加配置项,并重启 FE 后,永久生效该配置项。
+
+3. 修改 `max_distribution_pruner_recursion_depth`
+
+ 通过 `SHOW FRONTEND CONFIG;` 可以查看到该配置项可以动态配置(`IsMutable` 为 true)。并且不是 Master FE 独有配置。
+
+ 同样,我们可以通过动态修改配置的命令修改该配置。因为该配置不是 Master FE 独有配置,所以需要单独连接到不同的 FE,进行动态修改配置的操作,这样才能保证所有 FE 都使用了修改后的配置值
+
+## 配置项列表
+
+### 元数据与集群管理
+
+#### `meta_dir`
+
+默认值:DorisFE.DORIS_HOME_DIR + "/doris-meta"
+
+Doris 元数据将保存在这里。强烈建议将此目录的存储为:
+
+1. 高写入性能(SSD)
+
+2. 安全(RAID)
+
+#### `catalog_try_lock_timeout_ms`
+
+默认值:5000(ms)
+
+是否可以动态配置:true
+
+元数据锁的 tryLock 超时配置。通常它不需要改变,除非你需要测试一些东西。
+
+#### `enable_bdbje_debug_mode`
+
+默认值:false
+
+如果设置为 true,FE 将在 BDBJE 调试模式下启动,在 Web 页面 `System->bdbje` 可以查看相关信息,否则不可以查看
+
+#### `max_bdbje_clock_delta_ms`
+
+默认值:5000(5 秒)
+
+设置非主 FE 到主 FE 主机之间的最大可接受时钟偏差。每当非主 FE 通过 BDBJE 建立到主 FE 的连接时,都会检查该值。如果时钟偏差大于此值,则放弃连接。
+
+#### `metadata_failure_recovery`
+
+默认值:false
+
+如果为 true,FE 将重置 bdbje 复制组(即删除所有可选节点信息)并应该作为 Master 启动。如果所有可选节点都无法启动,我们可以将元数据复制到另一个节点并将此配置设置为 true 以尝试重新启动 FE。
+
+#### `txn_rollback_limit`
+
+默认值:100
+
+尝试重新加入组时 bdbje 可以回滚的最大 txn 数
+
+#### `bdbje_replica_ack_timeout_second`
+
+默认值:10
+
+元数据会同步写入到多个 Follower FE,这个参数用于控制 Master FE 等待 Follower FE 发送 ack 的超时时间。当写入的数据较大时,可能 ack 时间较长,如果超时,会导致写元数据失败,FE 进程退出。此时可以适当调大这个参数。
+
+#### `grpc_threadmgr_threads_nums`
+
+默认值:4096
+
+在 grpc_threadmgr 中处理 grpc events 的线程数量。
+
+#### `bdbje_lock_timeout_second`
+
+默认值:5
+
+bdbje 操作的 lock timeout 如果 FE WARN 日志中有很多 LockTimeoutException,可以尝试增加这个值
+
+#### `bdbje_heartbeat_timeout_second`
+
+默认值:30
+
+master 和 follower 之间 bdbje 的心跳超时。默认为 30 秒,与 bdbje 中的默认值相同。如果网络遇到暂时性问题,一些意外的长 Java GC 使您烦恼,您可以尝试增加此值以减少错误超时的机会
+
+#### `replica_ack_policy`
+
+默认值:SIMPLE_MAJORITY
+
+选项:ALL, NONE, SIMPLE_MAJORITY
+
+bdbje 的副本 ack 策略。更多信息,请参见:<http://docs.oracle.com/cd/E17277_02/html/java/com/sleepycat/je/Durability.ReplicaAckPolicy.html>
+
+#### `replica_sync_policy`
+
+默认值:SYNC
+
+选项:SYNC, NO_SYNC, WRITE_NO_SYNC
+
+bdbje 的 Follower FE 同步策略。
+
+#### `master_sync_policy`
+
+默认值:SYNC
+
+选项:SYNC, NO_SYNC, WRITE_NO_SYNC
+
+Master FE 的 bdbje 同步策略。如果您只部署一个 Follower FE,请将其设置为“SYNC”。如果你部署了超过 3 个 Follower FE,你可以将这个和下面的 `replica_sync_policy` 设置为 WRITE_NO_SYNC。更多信息,参见:<http://docs.oracle.com/cd/E17277_02/html/java/com/sleepycat/je/Durability.SyncPolicy.html>
+
+#### `bdbje_reserved_disk_bytes`
+
+用于限制 bdbje 能够保留的文件的最大磁盘空间。
+
+默认值:1073741824
+
+是否可以动态配置:false
+
+是否为 Master FE 节点独有的配置项:false
+
+#### `ignore_meta_check`
+
+默认值:false
+
+是否可以动态配置:true
+
+如果为 true,非主 FE 将忽略主 FE 与其自身之间的元数据延迟间隙,即使元数据延迟间隙超过 `meta_delay_toleration_second`。
+非主 FE 仍将提供读取服务。当您出于某种原因尝试停止 Master FE 较长时间,但仍希望非 Master FE 可以提供读取服务时,这会很有帮助。
+
+#### `meta_delay_toleration_second`
+
+默认值:300(5 分钟)
+
+如果元数据延迟间隔超过 `meta_delay_toleration_second`,非主 FE 将停止提供服务
+
+#### `edit_log_port`
+
+默认值:9010
+
+bdbje 端口
+
+#### `edit_log_type`
+
+默认值:BDB
+
+编辑日志类型。
+BDB:将日志写入 bdbje
+LOCAL:已弃用。
+
+#### `edit_log_roll_num`
+
+默认值:50000
+
+是否可以动态配置:true
+
+是否为 Master FE 节点独有的配置项:true
+
+Master FE will save image every `edit_log_roll_num` meta journals.
+
+#### `force_do_metadata_checkpoint`
+
+默认值:false
+
+是否可以动态配置:true
+
+是否为 Master FE 节点独有的配置项:true
+
+如果设置为 true,则无论 jvm 内存使用百分比如何,检查点线程都会创建检查点
+
+#### `metadata_checkpoint_memory_threshold`
+
+默认值:60(60%)
+
+是否可以动态配置:true
+
+是否为 Master FE 节点独有的配置项:true
+
+如果 jvm 内存使用百分比(堆或旧内存池)超过此阈值,则检查点线程将无法工作以避免 OOM。
+
+#### `max_same_name_catalog_trash_num`
+
+用于设置回收站中同名元数据的最大个数,超过最大值时,最早删除的元数据将被彻底删除,不能再恢复。0 表示不保留同名对象。< 0 表示不做限制。
+
+注意:同名元数据的判断会局限在一定的范围内。比如同名 database 的判断会限定在相同 cluster 下,同名 table 的判断会限定在相同 database(指相同 database id)下,同名 partition 的判断会限定在相同 database(指相同 database id)并且相同 table(指相同 table id)下。
+
+默认值:3
+
+是否可以动态配置:true
+
+是否为 Master FE 节点独有的配置项:true
+
+#### `cluster_id`
+
+默认值:-1
+
+如果节点(FE 或 BE)具有相同的集群 id,则将认为它们属于同一个 Doris 集群。Cluster id 通常是主 FE 首次启动时生成的随机整数。您也可以指定一个。
+
+#### `heartbeat_mgr_blocking_queue_size`
+
+默认值:1024
+
+是否为 Master FE 节点独有的配置项:true
+
+在 heartbeat_mgr 中存储心跳任务的阻塞队列大小。
+
+#### `heartbeat_mgr_threads_num`
+
+默认值:8
+
+是否为 Master FE 节点独有的配置项:true
+
+heartbeat_mgr 中处理心跳事件的线程数。
+
+#### `disable_cluster_feature`
+
+默认值:true
+
+是否可以动态配置:true
+
+多集群功能将在 0.12 版本中弃用,将此配置设置为 true 将禁用与集群功能相关的所有操作,包括:
+
+1. 创建/删除集群
+2. 添加、释放 BE/将 BE 添加到集群/停用集群 balance
+3. 更改集群的后端数量
+4. 链接/迁移数据库
+
+#### `enable_fqdn_mode`
+
+此配置用于 k8s 部署环境。当 enable_fqdn_mode 为 true 时,将允许更改 be 的重建 pod 的 ip。
+
+默认值:false
+
+是否可以动态配置:false
+
+是否为 Master FE 节点独有的配置项:true
+
+#### `enable_token_check`
+
+默认值:true
+
+为了向前兼容,稍后将被删除。下载 image 文件时检查令牌。
+
+#### `enable_multi_tags`
+
+默认值:false
+
+是否可以动态配置:false
+
+是否为 Master FE 节点独有的配置项:true
+
+是否开启单 BE 的多标签功能
+
+#### `initial_root_password`
+
+设置 root 用户初始化 2 阶段 SHA-1 加密密码,默认为'',即不设置 root 密码。后续 root 用户的 `set password` 操作会将 root 初始化密码覆盖。
+
+示例:如要配置密码的明文是 `root@123`,可在 Doris 执行 SQL `select password('root@123')` 获取加密密码 `*A00C34073A26B40AB4307650BFB9309D6BFA6999`。
+
+默认值:空字符串
+
+是否可以动态配置:false
+
+是否为 Master FE 节点独有的配置项:true
+
+#### `enable_cooldown_replica_affinity`
+
+用户可以选择是否首先使用冷却副本进行扫描,默认为 true
+
+默认值:true
+
+是否可以动态配置:true
+
+是否为 Master FE 节点独有的配置项:false
+
+### 服务
+
+#### `query_port`
+
+默认值:9030
+
+Doris FE 通过 mysql 协议查询连接端口
+
+#### `arrow_flight_sql_port`
+
+默认值:-1
+
+Doris FE 通过 Arrow Flight SQL 协议查询连接端口
+
+#### `frontend_address`
+
+状态:已弃用,不建议使用。
+
+类型:string
+
+描述:显式配置 FE 的 IP 地址,不使用*InetAddress。getByName*获取 IP 地址。通常在*InetAddress 中。getByName*当无法获得预期结果时。只支持 IP 地址,不支持主机名。
+
+默认值:0.0.0.0
+
+#### `priority_networks`
+
+默认值:空
+
+为那些有很多 ip 的服务器声明一个选择策略。请注意,最多应该有一个 ip 与此列表匹配。这是一个以分号分隔格式的列表,用 CIDR 表示法,例如 10.10.10.0/24。如果没有匹配这条规则的 ip,会随机选择一个。
+
+#### `http_port`
+
+默认值:8030
+
+FE http 端口,当前所有 FE http 端口都必须相同
+
+#### `https_port`
+
+默认值:8050
+
+FE https 端口,当前所有 FE https 端口都必须相同
+
+#### `enable_https`
+
+默认值:false
+
+是否开启 FE https 的支持,false 表示支持 http,true 表示同时支持 http 与 https,并且会自动将 http 请求重定向到 https
+如果 enable_https 为 true,需要在 fe.conf 中配置 ssl 证书信息
+
+#### `enable_ssl`
+
+默认值:true
+
+如果设置为 true,doris 将与 mysql 服务 建立基于 SSL 协议的加密通道。
+
+#### `qe_max_connection`
+
+默认值:1024
+
+每个 FE 的最大连接数
+
+#### `check_java_version`
+
+默认值:true
+
+Doris 将检查已编译和运行的 Java 版本是否兼容,如果不兼容将抛出 Java 版本不匹配的异常信息,并终止启动
+
+#### `rpc_port`
+
+默认值:9020
+
+FE Thrift Server 的端口
+
+#### `thrift_server_type`
+
+该配置表示 FE 的 Thrift 服务使用的服务模型,类型为 string, 大小写不敏感。
+
+若该参数为 `SIMPLE`, 则使用 `TSimpleServer` 模型,该模型一般不适用于生产环境,仅限于测试使用。
+
+若该参数为 `THREADED`, 则使用 `TThreadedSelectorServer` 模型,该模型为非阻塞式 I/O 模型,即主从 Reactor 模型,该模型能及时响应大量的并发连接请求,在多数场景下有较好的表现。
+
+若该参数为 `THREAD_POOL`, 则使用 `TThreadPoolServer` 模型,该模型为阻塞式 I/O 模型,使用线程池处理用户连接,并发连接数受限于线程池的数量,如果能提前预估并发请求的数量,并且能容忍足够多的线程资源开销,该模型会有较好的性能表现,默认使用该服务模型
+
+#### `thrift_server_max_worker_threads`
+
+默认值:4096
+
+Thrift Server 最大工作线程数
+
+#### `thrift_backlog_num`
+
+默认值:1024
+
+thrift 服务器的 backlog_num 当你扩大这个 backlog_num 时,你应该确保它的值大于 linux `/proc/sys/net/core/somaxconn` 配置
+
+#### `thrift_client_timeout_ms`
+
+默认值:0
+
+thrift 服务器的连接超时和套接字超时配置
+
+thrift_client_timeout_ms 的默认值设置为零以防止读取超时
+
+#### `thrift_max_message_size`
+
+默认值:100MB
+
+thrift 服务器接收请求消息的大小(字节数)上限。如果客户端发送的消息大小超过该值,那么 thrift 服务器会拒绝该请求并关闭连接,这种情况下,client 会遇到错误:“connection has been closed by peer”,使用者可以尝试增大该参数以绕过上述限制。
+
+#### `use_compact_thrift_rpc`
+
+默认值:true
+
+是否使用压缩格式发送查询计划结构体。开启后,可以降低约 50% 的查询计划结构体大小,从而避免一些 "send fragment timeout" 错误。
+但是在某些高并发小查询场景下,可能会降低约 10% 的并发度。
+
+#### `grpc_max_message_size_bytes`
+
+默认值:1G
+
+用于设置 GRPC 客户端通道的初始流窗口大小,也用于设置最大消息大小。当结果集较大时,可能需要增大该值。
+
+#### `max_mysql_service_task_threads_num`
+
+默认值:4096
+
+mysql 中处理任务的最大线程数。
+
+#### `mysql_service_io_threads_num`
+
+默认值:4
+
+mysql 中处理 io 事件的线程数。
+
+#### `mysql_nio_backlog_num`
+
+默认值:1024
+
+mysql nio server 的 backlog_num 当你放大这个 backlog_num 时,你应该同时放大 linux `/proc/sys/net/core/somaxconn`文件中的值
+
+#### `broker_timeout_ms`
+
+默认值:10000(10 秒)
+
+Broker rpc 的默认超时时间
+
+#### `backend_rpc_timeout_ms`
+
+FE 向 BE 的 BackendService 发送 rpc 请求时的超时时间,单位:毫秒。
+
+默认值:60000
+
+是否可以动态配置:false
+
+是否为 Master FE 节点独有的配置项:true
+
+#### `drop_backend_after_decommission`
+
+默认值:false
+
+是否可以动态配置:true
... 263717 lines suppressed ...
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org