Skip to main content

Descripción

Recopila en una sola tabla la documentación integrada de los componentes uniformes del sistema. Cada fila corresponde a una entidad (una función, un motor de tabla, un tipo de dato, etc.) y contiene la documentación de referencia de esa entidad en formato Markdown: el mismo contenido que se publica en el sitio web y que exponen las tablas system.* específicas de cada tipo. La description se compone a partir de las partes estructuradas de la documentación integrada (description, syntax, argumentos, ejemplos, etc.), de modo que una sola columna contiene la documentación completa de una entidad. Cuando la documentación integrada contiene en su description toda la página de referencia (como ocurre con los componentes cuyas páginas web se generan automáticamente a partir de ella: motores de tabla, motores de base de datos, tipos de datos, formatos y funciones de tabla), la página se publica tal cual, sin añadir secciones compuestas a partir de los campos de metadatos estructurados, ya que el cuerpo de la página ya cubre ese material. Los alias se muestran como una referencia breve a la entidad canónica; por ejemplo, Alias of `trunc`. Esta tabla, en cierto modo, recopila la información disponible en las tablas de documentación específicas de cada tipo (system.functions, system.table_engines, system.data_type_families y otras). Está pensada, en particular, como base para un comando help interactivo en el client, pero también es útil por sí sola. Se recopilan los siguientes tipos de entidades (el valor de la columna type se muestra entre paréntesis):
  • Funciones (Function)
  • Funciones de agregación (Aggregate Function)
  • Funciones de tabla (Table Function)
  • Motores de tabla (Table Engine)
  • Motores de base de datos (Database Engine)
  • Tipos de datos (Data Type)
  • Diseños de diccionario (Dictionary Layout)
  • Fuentes de diccionario (Dictionary Source)
  • Combinadores de funciones de agregación (Aggregate Function Combinator)
  • Tipos de índices de omisión de datos (Data Skipping Index)
  • Tipos de disco (Disk Type)
  • Ajustes (Setting)
  • Ajustes de MergeTree (MergeTree Setting)
  • Ajustes del servidor (Server Setting)
  • Formatos (Format)
  • Códecs de compresión (Compression Codec)
  • Eventos de perfil (Profile Event)
  • Métricas actuales (Current Metric)
  • Métricas asincrónicas (Asynchronous Metric)
  • Tablas del sistema (System Table)
En el caso de los ajustes (de cualquier tipo), la documentación es la descripción del ajuste, junto con su tipo y su valor predeterminado; los ajustes obsoletos no se exponen. En el caso de las tablas del sistema, la documentación es el comentario de la tabla junto con la lista de sus columnas (el nombre, el tipo y la descripción de cada una). La columna source contiene la ruta del archivo fuente donde se define la documentación de la entidad, relativa a la raíz del repositorio. Para la mayoría de las entidades, se captura automáticamente en el lugar donde se construye el objeto de documentación (el punto de registro del componente); para los tipos que se documentan cada uno en un único archivo fuente (como los ajustes, los eventos de perfil y las métricas actuales), ese archivo es el que se usa.

Columnas

Ejemplo

Consulta la documentación de una entidad concreta:
Query
El mismo nombre puede referirse a varios tipos de entidades (por ejemplo, existe tanto la función de tabla file como el origen del diccionario file), por lo que conviene buscar ese nombre en todos los tipos:
Query
Cuenta las entidades documentadas de cada tipo:
Query

Véase también

Last modified on July 23, 2026