Moteur de table SQLite - ClickHouse Documentation

Le moteur permet d’importer et d’exporter des données vers SQLite et prend en charge les requêtes sur des tables SQLite directement depuis ClickHouse.

Créer une table

    CREATE TABLE [IF NOT EXISTS] [db.]table_name
    (
        name1 [type1],
        name2 [type2], ...
    ) ENGINE = SQLite('db_path', 'table')

Paramètres du moteur

db_path — Chemin vers le fichier SQLite contenant une base de données.
table — Nom d’une table de la base de données SQLite, ou requête transmise telle quelle à SQLite (voir Passer une requête au lieu d’un nom de table).

Passer une requête au lieu d’un nom de table

Au lieu d’un nom de table, l’argument table peut être une requête SELECT transmise telle quelle à SQLite. La structure de la table est inférée à partir du résultat de la requête. La requête peut être écrite soit sous forme de sous-requête, soit encapsulée dans la fonction query :

CREATE TABLE sqlite_table ENGINE = SQLite('sqlite.db', (SELECT col1, col2 FROM table1 WHERE col2 > 1));
CREATE TABLE sqlite_table ENGINE = SQLite('sqlite.db', query('SELECT col1, col2 FROM table1 WHERE col2 > 1'));

Une telle table est en lecture seule : les opérations INSERT n’y sont pas autorisées. La même syntaxe est prise en charge par la fonction de table sqlite.

La forme de sous-requête (SELECT ...) est analysée par ClickHouse puis re-sérialisée avant d’être envoyée à SQLite. Elle doit donc être valide en SQL ClickHouse. Pour transmettre une syntaxe spécifique à SQLite que ClickHouse n’analyse pas, utilisez la forme query('...'), dont le texte est envoyé tel quel à SQLite.Tout WHERE, LIMIT, toute agrégation, etc. externe de la requête ClickHouse englobante n’est pas répercuté dans la requête transmise : ils sont appliqués dans ClickHouse après récupération du résultat complet de la requête. Pour restreindre les données lues depuis SQLite, placez le filtre dans la requête transmise. Avec external_table_strict_query = 1, un filtre externe qui ne peut pas être répercuté est rejeté avec une exception au lieu d’être appliqué localement.

Prise en charge des types de données

Lorsque vous spécifiez explicitement les types de colonnes ClickHouse dans la définition de la table, les types ClickHouse suivants peuvent être interprétés à partir de colonnes TEXT SQLite :

Date, Date32
DateTime, DateTime64
UUID
Enum8, Enum16
Decimal32, Decimal64, Decimal128, Decimal256
FixedString
Tous les types entiers (UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64)
Float32, Float64

Consultez le moteur de base de données SQLite pour la correspondance de types par défaut.

Exemple d’utilisation

Affiche une requête qui crée la table SQLite :

SHOW CREATE TABLE sqlite_db.table2;

CREATE TABLE SQLite.table2
(
    `col1` Nullable(Int32),
    `col2` Nullable(String)
)
ENGINE = SQLite('sqlite.db','table2');

Renvoie les données contenues dans la table :

SELECT * FROM sqlite_db.table2 ORDER BY col1;

┌─col1─┬─col2──┐
│    1 │ text1 │
│    2 │ text2 │
│    3 │ text3 │
└──────┴───────┘

Voir aussi

moteur SQLite
fonction de table sqlite

​Créer une table

​Passer une requête au lieu d’un nom de table

​Prise en charge des types de données

​Exemple d’utilisation

Créer une table

Passer une requête au lieu d’un nom de table

Prise en charge des types de données

Exemple d’utilisation