system.documentation

Table système qui regroupe, dans une seule table, la documentation embarquée des composants du système documentés de manière uniforme (fonctions, moteurs de table, types de données, etc.), avec la documentation de référence rendue en Markdown.

Description

Collecte dans une seule table la documentation embarquée des composants uniformes du système. Chaque ligne correspond à une entité (une fonction, un moteur de table, un type de données, etc.) et contient la documentation de référence de cette entité au format Markdown — le même contenu que celui publié sur le site web et exposé par les tables system.* propres à chaque type.

La description est construite à partir des parties structurées de la documentation embarquée (description, syntax, arguments, exemples, etc.), de sorte qu’une seule colonne contient la documentation complète d’une entité. Les alias sont présentés sous la forme d’un bref renvoi vers l’entité canonique, par ex. Alias of `trunc`.

Cette table regroupe, d’une certaine manière, les informations disponibles dans les tables de documentation propres à chaque type (system.functions, system.table_engines, system.data_type_families, entre autres). Elle est notamment conçue pour servir de base à une commande help interactive dans le client, mais elle est également utile à elle seule.

Les types d’entités suivants sont collectés (la valeur de la colonne type est indiquée entre parenthèses) :

• Fonctions (Function)
• Fonctions d’agrégat (Aggregate Function)
• Fonctions de table (Table Function)
• Moteurs de table (Table Engine)
• Moteurs de base de données (Database Engine)
• Types de données (Data Type)
• Structures de dictionnaire (Dictionary Layout)
• Sources de dictionnaire (Dictionary Source)
• Combinateurs de fonctions d’agrégat (Aggregate Function Combinator)
• Types d’index de saut de données (Data Skipping Index)
• Types de disque (Disk Type)
• Paramètres (Setting)
• Paramètres MergeTree (MergeTree Setting)
• Paramètres du serveur (Server Setting)
• Formats (Format)

Pour les paramètres, la documentation correspond à leur description ; les paramètres obsolètes ne sont pas exposés.

Colonnes

• name (String) — Le nom de l’entité, par ex. domainWithoutWWW ou MergeTree.
• type (Enum8(‘Function’ = 1, ‘Aggregate Function’ = 2, ‘Table Function’ = 3, ‘Table Engine’ = 4, ‘Database Engine’ = 5, ‘Data Type’ = 6, ‘Dictionary Layout’ = 7, ‘Dictionary Source’ = 8, ‘Aggregate Function Combinator’ = 9, ‘Data Skipping Index’ = 10, ‘Disk Type’ = 11, ‘Setting’ = 12, ‘MergeTree Setting’ = 13, ‘Server Setting’ = 14, ‘Format’ = 15)) — Le type de l’entité, par ex. Function ou Table Engine.
• description (String) — La documentation de référence de l’entité, au format Markdown, est générée à partir de la documentation embarquée (le même contenu que celui publié sur le site web), y compris la syntaxe, les exemples et d’autres parties structurées, le cas échéant.

Exemple

Consultez la documentation d’une entité donnée :

Query

SELECT description
FROM system.documentation
WHERE type = 'Table Engine' AND name = 'MergeTree'
FORMAT TSVRaw;

Le même nom peut désigner plusieurs types d’entités (par exemple, il existe à la fois une fonction de table file et une source de dictionnaire file) ; il est donc pratique de rechercher un nom dans tous les types :

Query

SELECT type, name
FROM system.documentation
WHERE name = 'file'
ORDER BY type;

Comptez les entités documentées de chaque type :

Query

SELECT type, count()
FROM system.documentation
GROUP BY type
ORDER BY count() DESC;

Voir aussi

• system.functions — Fonctions standard et d’agrégation.
• system.table_functions — Fonctions de table.
• system.table_engines — Moteurs de table.
• system.database_engines — Moteurs de base de données.
• system.data_type_families — Types de données.
• system.disk_types — Types de disques.
• system.settings — Paramètres.
• system.merge_tree_settings — Paramètres MergeTree.
• system.server_settings — Paramètres du serveur.
• system.formats — Formats.