ClickHouse/docs/fr/sql-reference/statements/misc.md
2020-10-13 20:23:29 +03:00

15 KiB
Raw Blame History

machine_translated machine_translated_rev toc_priority toc_title
true 72537a2d52 41 Autre

Diverses Requêtes

ATTACH

Cette requête est exactement la même que CREATE, mais

  • Au lieu de la parole CREATE il utilise le mot ATTACH.
  • La requête ne crée pas de données sur le disque, mais suppose que les données sont déjà aux endroits appropriés, et ajoute simplement des informations sur la table au serveur. Après avoir exécuté une requête ATTACH, le serveur connaîtra l'existence de la table.

Si la table a été précédemment détachée (DETACH), ce qui signifie que sa structure est connue, vous pouvez utiliser un raccourci sans définir la structure.

ATTACH TABLE [IF NOT EXISTS] [db.]name [ON CLUSTER cluster]

Cette requête est utilisée lors du démarrage du serveur. Le serveur stocke les métadonnées de la table sous forme de fichiers avec ATTACH requêtes, qu'il exécute simplement au lancement (à l'exception des tables système, qui sont explicitement créées sur le serveur).

CHECK TABLE

Vérifie si les données de la table sont corrompues.

CHECK TABLE [db.]name

Le CHECK TABLE requête compare réelle des tailles de fichier avec les valeurs attendues qui sont stockés sur le serveur. Si le fichier tailles ne correspondent pas aux valeurs stockées, cela signifie que les données sont endommagées. Cela peut être causé, par exemple, par un plantage du système lors de l'exécution de la requête.

La réponse de la requête contient result colonne avec une seule ligne. La ligne a une valeur de Booléen type:

  • 0 - les données de la table sont corrompues.
  • 1 - les données maintiennent l'intégrité.

Le CHECK TABLE query prend en charge les moteurs de table suivants:

Effectué sur les tables avec un autre moteur de table provoque une exception.

Les moteurs de la *Log la famille ne fournit pas de récupération automatique des données en cas d'échec. L'utilisation de la CHECK TABLE requête pour suivre la perte de données en temps opportun.

Pour MergeTree moteurs de la famille, le CHECK TABLE query affiche un État de vérification pour chaque partie de données individuelle d'une table sur le serveur local.

Si les données sont corrompues

Si la table est corrompue, vous pouvez copier les données non corrompues dans une autre table. Pour ce faire:

  1. Créez une nouvelle table avec la même structure que la table endommagée. Pour ce faire exécutez la requête CREATE TABLE <new_table_name> AS <damaged_table_name>.
  2. Définir le max_threads la valeur 1 pour traiter la requête suivante dans un seul thread. Pour ce faire, exécutez la requête SET max_threads = 1.
  3. Exécuter la requête INSERT INTO <new_table_name> SELECT * FROM <damaged_table_name>. Cette demande copie les données non corrompues de la table endommagée vers une autre table. Seules les données avant la partie corrompue seront copiées.
  4. Redémarrez l' clickhouse-client pour réinitialiser l' max_threads valeur.

DESCRIBE TABLE

DESC|DESCRIBE TABLE [db.]table [INTO OUTFILE filename] [FORMAT format]

Renvoie ce qui suit String les colonnes de type:

  • name — Column name.
  • type— Column type.
  • default_type — Clause that is used in expression par défaut (DEFAULT, MATERIALIZED ou ALIAS). Column contient une chaîne vide, si l'expression par défaut n'est pas spécifiée.
  • default_expression — Value specified in the DEFAULT clause.
  • comment_expression — Comment text.

Les structures de données imbriquées sont sorties dans “expanded” format. Chaque colonne est affichée séparément, avec le nom après un point.

DETACH

Supprime les informations sur le name table du serveur. Le serveur cesse de connaître l'existence de la table.

DETACH TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster]

Cela ne supprime pas les données ou les métadonnées de la table. Lors du prochain lancement du serveur, le serveur Lira les métadonnées et découvrira à nouveau la table. De même, un “detached” tableau peut être re-attaché en utilisant le ATTACH requête (à l'exception des tables système, qui n'ont pas de stocker les métadonnées pour eux).

Il n'y a pas de DETACH DATABASE requête.

DROP

Cette requête a deux types: DROP DATABASE et DROP TABLE.

DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster]

Supprime toutes les tables à l'intérieur de la db la base de données, puis supprime le db la base de données elle-même. Si IF EXISTS est spécifié, il ne renvoie pas d'erreur si la base de données n'existe pas.

DROP [TEMPORARY] TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster]

Supprime la table. Si IF EXISTS est spécifié, il ne renvoie pas d'erreur si la table n'existe pas ou si la base de données n'existe pas.

DROP DICTIONARY [IF EXISTS] [db.]name

Delets le dictionnaire. Si IF EXISTS est spécifié, il ne renvoie pas d'erreur si la table n'existe pas ou si la base de données n'existe pas.

DROP USER

Supprime un utilisateur.

Syntaxe

DROP USER [IF EXISTS] name [,...] [ON CLUSTER cluster_name]

DROP ROLE

Supprime un rôle.

Le rôle supprimé est révoqué de toutes les entités où il a été accordé.

Syntaxe

DROP ROLE [IF EXISTS] name [,...] [ON CLUSTER cluster_name]

DROP ROW POLICY

Supprime une stratégie de ligne.

La stratégie de ligne supprimée est révoquée de toutes les entités sur lesquelles elle a été affectée.

Syntaxe

DROP [ROW] POLICY [IF EXISTS] name [,...] ON [database.]table [,...] [ON CLUSTER cluster_name]

DROP QUOTA

Supprime un quota.

Le quota supprimé est révoqué de toutes les entités où il a été affecté.

Syntaxe

DROP QUOTA [IF EXISTS] name [,...] [ON CLUSTER cluster_name]

DROP SETTINGS PROFILE

Supprime un quota.

Le quota supprimé est révoqué de toutes les entités où il a été affecté.

Syntaxe

DROP [SETTINGS] PROFILE [IF EXISTS] name [,...] [ON CLUSTER cluster_name]

EXISTS

EXISTS [TEMPORARY] [TABLE|DICTIONARY] [db.]name [INTO OUTFILE filename] [FORMAT format]

Renvoie un seul UInt8- type colonne, qui contient la valeur unique 0 si la table ou base de données n'existe pas, ou 1 si la table existe dans la base de données spécifiée.

KILL QUERY

KILL QUERY [ON CLUSTER cluster]
  WHERE <where expression to SELECT FROM system.processes query>
  [SYNC|ASYNC|TEST]
  [FORMAT format]

Tente de mettre fin de force aux requêtes en cours d'exécution. Les requêtes à terminer sont sélectionnées dans le système.processus en utilisant les critères définis dans le WHERE la clause de la KILL requête.

Exemple:

-- Forcibly terminates all queries with the specified query_id:
KILL QUERY WHERE query_id='2-857d-4a57-9ee0-327da5d60a90'

-- Synchronously terminates all queries run by 'username':
KILL QUERY WHERE user='username' SYNC

Les utilisateurs en lecture seule peuvent uniquement arrêter leurs propres requêtes.

Par défaut, la version asynchrone des requêtes est utilisé (ASYNC), qui n'attend pas la confirmation que les requêtes se sont arrêtées.

La version synchrone (SYNC) attend que toutes les requêtes d'arrêter et affiche des informations sur chaque processus s'arrête. La réponse contient l' kill_status la colonne, qui peut prendre les valeurs suivantes:

  1. finished The query was terminated successfully.
  2. waiting Waiting for the query to end after sending it a signal to terminate.
  3. The other values explain why the query can't be stopped.

Une requête de test (TEST) vérifie uniquement les droits de l'utilisateur et affiche une liste de requêtes à arrêter.

KILL MUTATION

KILL MUTATION [ON CLUSTER cluster]
  WHERE <where expression to SELECT FROM system.mutations query>
  [TEST]
  [FORMAT format]

Essaie d'annuler et supprimer mutation actuellement en cours d'exécution. Les Mutations à annuler sont sélectionnées parmi system.mutations tableau à l'aide du filtre spécifié par le WHERE la clause de la KILL requête.

Une requête de test (TEST) vérifie uniquement les droits de l'utilisateur et affiche une liste de requêtes à arrêter.

Exemple:

-- Cancel and remove all mutations of the single table:
KILL MUTATION WHERE database = 'default' AND table = 'table'

-- Cancel the specific mutation:
KILL MUTATION WHERE database = 'default' AND table = 'table' AND mutation_id = 'mutation_3.txt'

The query is useful when a mutation is stuck and cannot finish (e.g. if some function in the mutation query throws an exception when applied to the data contained in the table).

Les modifications déjà apportées par la mutation ne sont pas annulées.

OPTIMIZE

OPTIMIZE TABLE [db.]name [ON CLUSTER cluster] [PARTITION partition | PARTITION ID 'partition_id'] [FINAL] [DEDUPLICATE]

Cette requête tente d'initialiser une fusion non programmée de parties de données pour les tables avec un moteur de MergeTree famille.

Le OPTMIZE la requête est également prise en charge pour MaterializedView et la Tampon moteur. Les autres moteurs de table ne sont pas pris en charge.

Lorsque OPTIMIZE est utilisé avec le ReplicatedMergeTree famille de moteurs de table, ClickHouse crée une tâche pour la fusion et attend l'exécution sur tous les nœuds (si le replication_alter_partitions_sync paramètre est activé).

  • Si OPTIMIZE n'effectue pas de fusion pour une raison quelconque, il ne notifie pas le client. Pour activer les notifications, utilisez optimize_throw_if_noop paramètre.
  • Si vous spécifiez un PARTITION, seule la partition spécifiée est optimisé. Comment définir l'expression de la partition.
  • Si vous spécifiez FINAL, l'optimisation est effectuée, même lorsque toutes les données sont déjà dans une partie.
  • Si vous spécifiez DEDUPLICATE, alors des lignes complètement identiques seront dédupliquées (toutes les colonnes sont comparées), cela n'a de sens que pour le moteur MergeTree.

!!! warning "Avertissement" OPTIMIZE ne peut pas réparer le “Too many parts” erreur.

RENAME

Renomme une ou plusieurs tables.

RENAME TABLE [db11.]name11 TO [db12.]name12, [db21.]name21 TO [db22.]name22, ... [ON CLUSTER cluster]

Toutes les tables sont renommées sous verrouillage global. Renommer des tables est une opération légère. Si vous avez indiqué une autre base de données après TO, la table sera déplacée vers cette base de données. Cependant, les répertoires contenant des bases de données doivent résider dans le même système de fichiers (sinon, une erreur est renvoyée).

SET

SET param = value

Assigner value à l' param paramètre pour la session en cours. Vous ne pouvez pas modifier les paramètres du serveur de cette façon.

Vous pouvez également définir toutes les valeurs de certains paramètres de profil dans une seule requête.

SET profile = 'profile-name-from-the-settings-file'

Pour plus d'informations, voir Paramètre.

SET ROLE

Active les rôles pour l'utilisateur actuel.

Syntaxe

SET ROLE {DEFAULT | NONE | role [,...] | ALL | ALL EXCEPT role [,...]}

SET DEFAULT ROLE

Définit les rôles par défaut à un utilisateur.

Les rôles par défaut sont automatiquement activés lors de la connexion de l'utilisateur. Vous pouvez définir par défaut uniquement les rôles précédemment accordés. Si le rôle n'est pas accordé à un utilisateur, ClickHouse lève une exception.

Syntaxe

SET DEFAULT ROLE {NONE | role [,...] | ALL | ALL EXCEPT role [,...]} TO {user|CURRENT_USER} [,...]

Exemple

Définir plusieurs rôles par défaut à un utilisateur:

SET DEFAULT ROLE role1, role2, ... TO user

Définissez tous les rôles accordés par défaut sur un utilisateur:

SET DEFAULT ROLE ALL TO user

Purger les rôles par défaut d'un utilisateur:

SET DEFAULT ROLE NONE TO user

Définissez tous les rôles accordés par défaut à l'exception de certains d'entre eux:

SET DEFAULT ROLE ALL EXCEPT role1, role2 TO user

TRUNCATE

TRUNCATE TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster]

Supprime toutes les données d'une table. Lorsque la clause IF EXISTS est omis, la requête renvoie une erreur si la table n'existe pas.

Le TRUNCATE la requête n'est pas prise en charge pour Vue, Fichier, URL et NULL table des moteurs.

USE

USE db

Vous permet de définir la base de données actuelle pour la session. La base de données actuelle est utilisée pour rechercher des tables si la base de données n'est pas explicitement définie dans la requête avec un point avant le nom de la table. Cette requête ne peut pas être faite lors de l'utilisation du protocole HTTP, car il n'y a pas de concept de session.

Article Original