Utilisez la commande SHOW VARIABLES pour inspecter la valeur actuelle des attributs système ou de table. Exécutez cette commande après une instruction CREATE TABLE ou ALTER TABLE afin de confirmer la prise en compte de vos modifications, ou pour vérifier l'activation des paramètres système tels que la journalisation des requêtes lentes ou l'authentification.
Prérequis
Avant de commencer, assurez-vous que :
La version de Lindorm SQL est 2.6.3.2 ou ultérieure. Pour vérifier votre version, consultez la rubrique Versions SQL
La version du moteur satisfait aux exigences minimales des fonctionnalités souhaitées. Consultez la section Moteurs et versions applicables
Moteurs et versions applicables
| Moteur | Version minimale | Notes |
|---|---|---|
| LindormTable | 2.6.2 | La portée TABLE nécessite LindormTable 2.6.3+ et Lindorm SQL 2.6.6+ |
| LindormTSDB | 3.4.35 | Seule la portée SYSTEM est prise en charge |
Pour afficher ou mettre à niveau la version de votre moteur, consultez les rubriques Notes de version de LindormTable, Notes de version de LindormTSDB et Mettre à niveau la version mineure du moteur d'une instance Lindorm.
Syntaxe
show_variables_statement ::= SHOW scope_expression VARIABLES
[ FROM table_identifier]
[ LIKE pattern_expression]
scop_expression ::= { SYSTEM | TABLE }Paramètres
scope_expression
Indique s'il faut afficher les attributs système ou les attributs de table.
| Valeur | LindormTable | LindormTSDB | Description |
|---|---|---|---|
SYSTEM |
Pris en charge | Pris en charge | Renvoie tous les attributs système modifiés |
TABLE |
Pris en charge (2.6.3+, Lindorm SQL 2.6.6+) | Non pris en charge | Renvoie les attributs de la table spécifiée dans la clause FROM |
SYSTEM renvoie uniquement les attributs explicitement définis. Si aucun attribut système n'a été modifié, le résultat est vide.
FROM table_identifier
Le mot-clé FROM n'est pris en charge que lorsque le paramètre scope_expression est défini sur TABLE ; il ne s'applique pas à SYSTEM.
LIKE pattern_expression
Filtre les résultats par nom d'attribut à l'aide d'un motif de chaîne. Deux caractères génériques sont pris en charge :
| Caractère générique | Correspondance |
|---|---|
% |
Zéro ou plusieurs caractères |
_ |
Exactement un caractère |
Résultats renvoyés
Portée SYSTEM : renvoie les attributs système modifiés. Si aucun attribut système n'a été modifié, aucun résultat n'est renvoyé. Pour obtenir la liste complète des attributs système configurables, consultez la rubrique Éléments de configuration pris en charge.
Portée TABLE : renvoie les attributs de table, y compris, mais sans s'y limiter, ceux configurables dans la syntaxe
CREATE TABLE. Pour obtenir la liste complète des attributs de table configurables, consultez la rubrique Options de table.
Exemples
Tous les exemples utilisent un ensemble de résultats à deux colonnes : Variable_name et Value.
Afficher tous les attributs système
SHOW SYSTEM VARIABLES;Résultat :
+--------------------------+-------+
| Variable_name | Value |
+--------------------------+-------+
| SLOW_QUERY_RECORD_ENABLE | true |
| FILE_FORMAT_VERSION | 5 |
+--------------------------+-------+Le résultat affiche uniquement les attributs explicitement définis. Si aucune modification n'a été apportée aux attributs système, le résultat est vide.
Afficher un attribut de table spécifique
L'exemple suivant utilise une table créée avec l'instruction suivante :
CREATE TABLE dt (p1 VARCHAR, c1 INTEGER, PRIMARY KEY(p1)) WITH (COMPRESSION = 'LZ4');Pour afficher l'algorithme de compression configuré pour la table dt :
SHOW TABLE VARIABLES FROM dt LIKE 'COMPRESSION';Résultat :
+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| COMPRESSION | LZ4 |
+---------------+-------+Filtrer les attributs système à l'aide de caractères génériques
Utilisez % pour faire correspondre un préfixe et renvoyer tous les attributs dont les noms commencent par FILE :
SHOW SYSTEM VARIABLES LIKE 'FILE%';Résultat :
+---------------------+-------+
| Variable_name | Value |
+---------------------+-------+
| FILE_FORMAT_VERSION | 5 |
+---------------------+-------+Utilisez un nom d'attribut exact avec LIKE pour renvoyer un seul attribut :
SHOW SYSTEM VARIABLES LIKE 'FILE_FORMAT_VERSION';Résultat :
+---------------------+-------+
| Variable_name | Value |
+---------------------+-------+
| FILE_FORMAT_VERSION | 5 |
+---------------------+-------+Étapes suivantes
ALTER SYSTEM — modifier les attributs au niveau du système
CREATE TABLE — configurer les attributs de table lors de la création
ALTER TABLE — modifier les attributs de table après la création