Данные и таблицы

Выполнить SQL-запрос к SQLite

Запускает SELECT к SQLite в режиме только чтения и выводит таблицу, CSV или JSON.

Python Windows macOS Linux Средний
Скачать sql_query.py
Описание

Что делает скрипт

Скрипт открывает базу через URI с mode=ro, поэтому случайная запись не пройдёт. SQL можно передать аргументом или прочитать из файла. Результат печатается таблицей либо сохраняется в CSV или JSON. Для изменения данных нужен явный флаг --allow-write.

Перед запуском
  • По умолчанию база открывается только для чтения. Запись включается флагом --allow-write.
Запуск

Быстрый старт

python sql_query.py --db app.db --sql 'SELECT id, email FROM users LIMIT 10'

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python sql_query.py --db app.db --file report.sql --format csv --output report.csv
  • python sql_query.py --db app.db --sql 'DELETE FROM logs WHERE id < 10' --allow-write
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

sql_query.py

#!/usr/bin/env python3
"""Выполнение SQL-запроса к SQLite с безопасным выводом."""
from __future__ import annotations

import argparse
import csv
import json
import sqlite3
from pathlib import Path


def render_table(columns: list[str], rows: list[tuple]) -> str:
    widths = [len(column) for column in columns]
    for row in rows:
        for index, value in enumerate(row):
            widths[index] = max(widths[index], len("" if value is None else str(value)))
    line = " | ".join(column.ljust(widths[index]) for index, column in enumerate(columns))
    separator = "-+-".join("-" * width for width in widths)
    output = [line, separator]
    for row in rows:
        output.append(" | ".join(("" if value is None else str(value)).ljust(widths[index])
                                 for index, value in enumerate(row)))
    return "\n".join(output)


def main() -> int:
    parser = argparse.ArgumentParser(description="SQL-запрос к SQLite")
    parser.add_argument("--db", type=Path, required=True, help="Файл базы")
    parser.add_argument("--sql", default="", help="SQL-запрос")
    parser.add_argument("--file", type=Path, help="Файл с SQL")
    parser.add_argument("--output", type=Path, help="Файл результата для csv или json")
    parser.add_argument("--format", choices=["table", "csv", "json"], default="table", help="Формат вывода")
    parser.add_argument("--allow-write", action="store_true", help="Разрешить изменение базы")
    parser.add_argument("--force", action="store_true", help="Перезаписать выходной файл")
    args = parser.parse_args()

    source = args.db.expanduser().resolve()
    if not source.is_file():
        parser.error(f"База не найдена: {source}")
    if bool(args.sql) == bool(args.file):
        parser.error("Укажите ровно одно: --sql или --file")

    if args.file:
        sql_path = args.file.expanduser().resolve()
        if not sql_path.is_file():
            parser.error(f"SQL-файл не найден: {sql_path}")
        sql = sql_path.read_text(encoding="utf-8")
    else:
        sql = args.sql
    if not sql.strip():
        parser.error("SQL-запрос пуст")

    target = args.output.expanduser().resolve() if args.output else None
    if args.format == "table" and target is None:
        pass
    elif target is None:
        target = Path(f"query.{args.format}").resolve()
    if target and source == target:
        parser.error("Выходной файл не должен совпадать с базой")
    if target and target.exists() and not args.force:
        parser.error(f"Файл уже существует: {target}. Добавьте --force")
    if args.format == "table" and args.output is None:
        target = None

    if args.allow_write:
        connection = sqlite3.connect(source)
    else:
        connection = sqlite3.connect(source.as_uri() + "?mode=ro", uri=True)

    try:
        cursor = connection.execute(sql)
        if cursor.description is None:
            if not args.allow_write:
                parser.error("Запрос не возвращает строки. Для изменения базы нужен --allow-write")
            connection.commit()
            print(f"Затронуто строк: {cursor.rowcount}")
            return 0
        columns = [item[0] for item in cursor.description]
        rows = cursor.fetchall()
    except sqlite3.Error as error:
        parser.error(f"Ошибка SQLite: {error}")
    finally:
        connection.close()

    if args.format == "table":
        text = render_table(columns, rows)
        if target:
            target.parent.mkdir(parents=True, exist_ok=True)
            target.write_text(text + "\n", encoding="utf-8")
            print(f"Результат: {target}")
        else:
            print(text)
    elif args.format == "csv":
        target.parent.mkdir(parents=True, exist_ok=True)
        with target.open("w", encoding="utf-8", newline="") as handle:
            writer = csv.writer(handle, lineterminator="\n")
            writer.writerow(columns)
            writer.writerows(rows)
        print(f"Результат: {target}")
    else:
        payload = [dict(zip(columns, row)) for row in rows]
        target.parent.mkdir(parents=True, exist_ok=True)
        target.write_text(json.dumps(payload, ensure_ascii=False, indent=2, default=str) + "\n", encoding="utf-8")
        print(f"Результат: {target}")

    print(f"Строк: {len(rows)}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get data-sql-query
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Данные и таблицы

CSV, JSON, SQLite, Excel, очистка, объединение и отчёты.