Notes:

• Hex-Rays support is always compiled in and detected at runtime. If Hex-Rays is unavailable, decompiler-backed tables/functions are simply not registered.
• HTTP REST support is always compiled in; use --http from the CLI or .http start from the REPL/plugin CLI.
• IDAPython SQL execution is compiled in but disabled by default at runtime. Enable it per session with PRAGMA idasql.enable_idapython = 1;.
• IDASQL_WITH_MCP=ON fetches fastmcpp; OFF removes MCP support and the --mcp / .mcp commands.
• XSQL_WITH_THINCLIENT is forced ON, and HTTPLIB_USE_OPENSSL_IF_AVAILABLE is forced OFF because IDASQL uses local plain HTTP.

Available Tables

30+ virtual tables covering functions, strings, types, cross-references, disassembly, decompilation, and more.

Core

Strings & Bytes

Decompiler

Types

Annotations

Search

Database Info

Storage

Analysis

SQL Functions

Unified Entity Search

Use the grep table for composable SQL searches over named functions, labels, segments, types, and members.```sql -- Search anything starting with "Create" SELECT name, kind, printf('0x%X', addr) as addr FROM grep WHERE pattern = 'Create%' LIMIT 20;

-- Search anywhere in name (plain text performs a contains search) SELECT name, kind, full_name FROM grep WHERE pattern = 'File' AND kind IN ('function', 'import') LIMIT 20;

-- Find struct members SELECT name, parent_name, full_name FROM grep WHERE pattern = 'dw%' AND kind = 'member';

-- Pagination SELECT name, kind, full_name FROM grep WHERE pattern = 'Create%' ORDER BY kind, name LIMIT 20 OFFSET 20;

Входной текст для перевода отсутствует.```bash curl http://localhost:8080/status curl -X POST http://localhost:8080/query -d "SELECT name FROM funcs LIMIT 5" curl -X POST http://localhost:8080/query -d "SELECT * FROM binary; SELECT COUNT(*) FROM funcs;"

По умолчанию используется режим fail-fast; передайте continue_on_error=true (например, ?continue_on_error=1), чтобы выполнять все операторы независимо от более ранних ошибок. Каждый results[i].error является каноническим для ошибок по каждому оператору; first_error_index указывает на самую раннюю ошибку или равен null. При сбое разбиения (например, незакрытая кавычка) ответ имеет вид success:false, statement_count:0, results:[] плюс верхнеуровневый parse_error.

Для нескольких баз данных запускайте отдельные экземпляры:```bash idasql -s malware.i64 --http 8080 idasql -s kernel.i64 --http 8082

В плагине IDA (неблокирующий):``` idasql> .http start HTTP server started on port 8142 idasql> .http stop HTTP server stopped

После закрепления повторное открытие базы данных автоматически запускает сервер — вы увидите это в окне вывода IDA при загрузке:``` IDASQL v0.0.18: Query engine initialized IDASQL CLI: Installed IDASQL: autostart -> IDASQL HTTP server: http://127.0.0.1:8099 Type '.http stop' to stop the server.

• Автозапуск при загрузке происходит только в плагине IDA. Сама команда .pin работает и в CLI, и в плагине (CLI просто читает/записывает пины).
• .http start / .mcp start без явного указания порта повторно используют закреплённые хост/порт.
• Из CLI изменения .pin сохраняются только при запуске с -w/--write (как и любые другие изменения IDB).

MCP-сервер

Для клиентов, совместимых с MCP (Model Context Protocol, стандарт для интеграции ИИ-инструментов):

--mcp и .mcp доступны при сборке с -DIDASQL_WITH_MCP=ON, что является значением по умолчанию. Собирайте с -DIDASQL_WITH_MCP=OFF, чтобы исключить поддержку MCP.```bash

Standalone mode

idasql -s database.i64 --mcp idasql -s database.i64 --mcp 9500 # specific port

Or in interactive mode

idasql -s database.i64 -i .mcp start

Инструменты: idasql_query (прямой SQL-запрос или скрипт, разделённый точкой с запятой)

Семейство xsql

IDASQL является частью семейства инструментов, которые предоставляют доступ к различным платформам бинарного анализа и отладочной информации через одну и ту же SQL-поверхность и построены на общей платформе виртуальных таблиц libxsql. Запрос, освоенный в одном инструменте, в значительной степени переносится на остальные — например, тот же SELECT name, size FROM funcs ORDER BY size DESC LIMIT 10 работает везде.

Платформы реверс-инжиниринга

• bnsql — базы данных Binary Ninja в виде SQL.
• ghidrasql — базы данных Ghidra в виде SQL.

Отладочная информация и данные компилятора

• pdbsql — файлы символов Windows PDB в виде SQL.
• dwarfsql — отладочная информация DWARF в виде SQL.
• clangsql — AST Clang в виде SQL.

Ядро

• libxsql — платформа виртуальных таблиц C++ SQLite, на которой построен каждый из перечисленных выше инструментов.

Используемые технологии

• libxsql - Библиотека C++17 только с заголовочными файлами (header-only) для представления структур данных C++ в виде виртуальных таблиц SQLite. Предоставляет fluent builder API для определения таблиц, проталкивание ограничений (constraint pushdown) и поддержку тонкого HTTP-клиента.

• fastmcpp - Опциональная реализация MCP-сервера, используемая при сборке с -DIDASQL_WITH_MCP=ON.

Лицензия и условия использования

Кратко: вы можете читать, собирать, оценивать, тестировать производительность, упаковывать и использовать немодифицированную версию idasql, в том числе в коммерческих целях, при условии сохранения уведомлений и соблюдения условий лицензии. Вы можете форкать или патчить её для подготовки исправлений ошибок, оптимизаций, новых функций, тестов или улучшений документации с целью обратного внесения в проект в рамках предусмотренных лицензией целей внесения вклада.

Вы не можете поддерживать расходящийся частный форк, порт, ребрендинг, клон, API-совместимую замену, конкурирующую реализацию или использовать idasql в качестве входных данных для ИИ с целью воссоздания или улучшения производной реализации без предварительного письменного разрешения Элиаса Бачаалани (Elias Bachaalany). Независимые реализации, которые не скопированы из idasql, не являются её материально производными и не в значительной степени основаны на ней в смысле, определённом лицензией, не запрещены.

Запросы на разрешение: откройте issue на GitHub в allthingsida/idasql/issues.

Если idasql в материальной степени влияет на распространяемый проект, сохраняйте указание на человеческое происхождение: заметно указывайте idasql и Элиаса Бачаалани в вашем README/документации и, когда применимо, в интерфейсе About/credits. Лицензия включает раздел примеров/FAQ, описывающий распространённые разрешённые случаи использования и случаи, требующие разрешения. Сторонние зависимости (libxsql, IDA SDK и их транзитивные зависимости) остаются под действием своих собственных лицензий.

См. полный текст Human-Origin Source License v1.0.