Часто задаваемые вопросы

Как установить SQL Agent CLI?

Установка SQL Agent CLI — быстрый и простой процесс для Windows, macOS и Linux. Сначала скачайте подходящий установщик для Вашей операционной системы с нашей страницы загрузок. Для пользователей Windows запустите .exe-установщик и следуйте мастеру установки. Пользователи macOS могут установить через .pkg-установщик или Homebrew командой brew install sql-agent. Для Linux доступны DEB-пакеты для Debian/Ubuntu, RPM-пакеты для Fedora/CentOS или универсальный TAR-архив. После установки откройте терминал или командную строку и выполните sql-agent --help для проверки успешности установки и просмотра доступных команд. CLI — это автономный исполняемый файл без дополнительных зависимостей. Подробные инструкции по установке и устранению неполадок доступны на нашей странице документации.

Как активировать лицензию?

Активация лицензии SQL Agent CLI — это простой одноразовый процесс. После покупки подписки на нашей страницу с тарифами, Вы получите уникальный API-ключ лицензии по электронной почте и в Вашем личном кабинете. Откройте терминал или командную строку и выполните sql-agent login YOUR-LICENSE-KEY, заменив YOUR-LICENSE-KEY на Ваш реальный ключ. CLI безопасно сохранит учётные данные локально с использованием шифрования и проверит лицензию на наших серверах. Каждая лицензия допускает активацию на определённом количестве устройств в зависимости от тарифа (Free: 1 устройство, Personal: 2 устройства, Professional: 5 устройств, Enterprise: без ограничений). Вы можете просмотреть все активные устройства и деактивировать старые в панели личного кабинета. При проблемах с активацией убедитесь, что есть подключение к интернету для проверки лицензии, или свяжитесь с нашей службой поддержки.

Какие базы данных поддерживаются?

SQL Agent CLI обеспечивает комплексную поддержку трёх самых популярных реляционных СУБД: PostgreSQL, MySQL и SQLite. Поддержка PostgreSQL включает все современные версии (10+) с полной совместимостью с расширениями PostGIS и типами данных JSONB и массивами. Поддержка MySQL/MariaDB охватывает версии 5.7+ со всеми стандартными функциями SQL. Поддержка SQLite работает как с файловыми, так и с базами данных в памяти, что идеально для разработки, тестирования и лёгких приложений. Для подключения используйте стандартные URL-строки в формате postgresql://user:pass@host:port/dbname для PostgreSQL, mysql://user:pass@host:port/dbname для MySQL или sqlite:///path/to/database.db для SQLite. Преобразование естественного языка в SQL автоматически адаптируется к конкретному диалекту Вашей базы данных, обеспечивая корректный синтаксис и функции для каждой платформы.

Какие AI-провайдеры я могу использовать?

SQL Agent CLI предлагает гибкую поддержку ИИ-провайдеров, позволяя Вам выбрать LLM, наилучшим образом соответствующую Вашим потребностям и бюджету. Поддерживаемые провайдеры: OpenAI с моделями GPT-4 и GPT-3.5-turbo для лидирующей в отрасли точности, Anthropic Claude (Claude 3 Opus, Sonnet, Haiku) с мощными возможностями рассуждения, Groq для сверхбыстрого вывода, DeepSeek для экономичных решений и локальные модели Ollama для полностью офлайн-работы без внешних API-вызовов. Настройте предпочтительного провайдера командой sql-agent configuration llm.provider --value provider_name (варианты: openai, anthropic, groq, deepseek, ollama), затем укажите API-ключ через переменную окружения или команду конфигурации. Ollama с моделями Llama 2, Mistral или CodeLlama обеспечивает полностью офлайн-преобразование естественного языка в SQL без интернета и регулярных расходов на API. Каждый провайдер предлагает различные компромиссы между скоростью, стоимостью, точностью и конфиденциальностью, давая Вам полный контроль над инфраструктурой ИИ SQL-ассистента.

Могу ли я использовать лицензию на нескольких устройствах?

Да! Лицензии SQL Agent CLI поддерживают активацию на нескольких устройствах, позволяя использовать один лицензионный ключ на рабочем компьютере, ноутбуке, домашнем ПК и других машинах. Количество одновременных активаций зависит от Вашего тарифного плана (см. нашу страницу с тарифами для подробностей). Тариф Free позволяет 1 активное устройство, Personal поддерживает 2 устройства, Professional включает 5 активаций, а Enterprise предлагает неограниченное количество активаций для всей команды. Вы можете просмотреть все активированные устройства, время последнего подключения и удалённо деактивировать неиспользуемые устройства в Вашем личном кабинете. Деактивация устройства происходит мгновенно и освобождает слот для активации SQL Agent на новой машине. Гибкое управление устройствами упрощает смену оборудования, переключение между рабочим и личным компьютером или совместное использование лицензии Professional небольшой командой разработчиков без покупки нескольких подписок.

Работает ли SQL Agent офлайн?

SQL Agent может работать в ограниченном офлайн-режиме при правильной настройке. По умолчанию CLI требует подключения к интернету для двух целей: проверки лицензии на наших серверах и отправки запросов на естественном языке облачным ИИ-провайдерам, таким как OpenAI или Anthropic. Однако Вы можете включить офлайн-функциональность двумя способами. Во-первых, настройте «безопасный режим» командой sql-agent configuration license_fail_mode --value safe, которая позволяет CLI продолжать работу с предупреждением при неудачной проверке лицензии из-за сетевых проблем. Во-вторых, для полностью офлайн-работы без зависимости от интернета настройте SQL Agent на использование локального LLM-провайдера Ollama командой sql-agent configuration llm.provider --value ollama. Эта комбинация обеспечивает полностью офлайн-преобразование естественного языка в SQL и работу с базами данных — идеально для изолированных сред, защищённых корпоративных сетей или мест без надёжного доступа в интернет. Офлайн-режим сохраняет весь основной функционал, включая обнаружение схемы, генерацию запросов и операции чтения баз данных.

Как работают запросы на естественном языке?

Преобразование естественного языка в SQL в SQL Agent использует продвинутый ИИ для понимания Ваших вопросов к базам данных и автоматической генерации точных SQL-запросов. При подключении к базе данных ИИ-агент сначала анализирует полную схему: названия таблиц, столбцов, типы данных, связи первичных и внешних ключей, индексы и ограничения. Это понимание схемы позволяет ИИ контекстно интерпретировать Ваши вопросы на обычном языке. Просто введите вопросы, например «Покажи всех пользователей, созданных на этой неделе», «Какова средняя сумма заказа по категориям товаров?» или «Список 10 крупнейших клиентов по выручке» и нажмите Enter. ИИ обрабатывает Ваш запрос, определяет нужные таблицы и столбцы, вычисляет необходимые операции JOIN, применяет фильтры и агрегации и генерирует оптимизированные SQL SELECT-запросы. Сгенерированный SQL отображается для проверки перед выполнением, позволяя изучать шаблоны SQL-синтаксиса и проверять логику. Вы также можете писать SQL-код напрямую. Этот подход «текст в SQL» значительно сокращает время разработки запросов и делает исследование баз данных доступным каждому, кто может задать вопрос на своём родном языке.

Безопасны ли мои данные?

Безусловно! SQL Agent CLI разработан с приоритетом безопасности и конфиденциальности. Все конфиденциальные данные, включая строки подключения к базам данных, имена пользователей, пароли и API-ключи, зашифрованы с помощью стандартного шифрования Fernet и хранятся локально на Вашем компьютере в защищённой директории конфигурации с ограниченными правами доступа (0600). Ваши данные из баз данных, результаты запросов и параметры подключения никогда не передаются на наши серверы или третьим лицам. Единственная сетевая коммуникация SQL Agent включает две ограниченные операции: (1) проверка лицензионного ключа на наших серверах аутентификации для подтверждения статуса подписки, и (2) отправка текста Вашего вопроса на естественном языке (не Ваших данных) настроенному ИИ-провайдеру для генерации SQL. Важно: схемы таблиц и данные никогда не покидают Ваш локальный компьютер при генерации ИИ-запросов. SQL Agent работает как полностью локальное CLI-приложение без телеметрии, аналитики или сбора данных. Вы сохраняете полный контроль над учётными данными и можете запускать SQL Agent в полностью офлайн-режиме с локальными моделями Ollama, если Ваши требования безопасности запрещают внешний сетевой доступ.

Есть ли защита данных от изменений ИИ?

Да! SQL Agent включает комплексную защиту от случайных изменений данных благодаря режиму только для чтения по умолчанию. При подключении к любой базе данных PostgreSQL, MySQL или SQLite SQL Agent автоматически работает в режиме только для чтения, который блокирует все опасные операции записи, включая INSERT, UPDATE, DELETE, DROP TABLE, TRUNCATE, ALTER TABLE и другие операторы изменения данных. Если ИИ случайно сгенерирует запрос на запись или Вы введёте его вручную, валидатор запросов отклонит его перед выполнением и отобразит предупреждение. Этот режим только для чтения по умолчанию делает SQL Agent безопасным для исследования рабочих баз данных, изучения SQL на реальных данных и выполнения анализа без риска повреждения или случайного удаления. Когда Вам явно необходимо изменить данные, включите операции записи при повторном подключении с флагом --write: sql-agent connect --url "your-db-url" --write. Даже в режиме записи деструктивные операции требуют подтверждения перед выполнением, обеспечивая дополнительный уровень безопасности для Ваших ценных данных.

Как получить поддержку?

Мы предоставляем комплексную поддержку всем пользователям SQL Agent CLI на всех уровнях подписки. По вопросам технической поддержки, отчётов об ошибках, запросов функций или общих вопросов о запросах на естественном языке в SQL, подключении к базам данных или настройке ИИ-провайдеров посетите нашу страницу контактов или свяжитесь с нами напрямую: info@fintechdocs.ru, +7 495 211 3513 или Telegram @FinTechDocs. Обычно мы отвечаем в течение 24 часов в рабочие дни (понедельник-пятница). Перед обращением в поддержку проверьте эту страницу FAQ: здесь есть ответы на частые вопросы по установке, активации лицензии, совместимости баз данных и устранению неполадок. Пользователи бесплатного тарифа получают поддержку сообщества по email. Подписчики Personal и Professional получают приоритетную поддержку по email с более быстрым временем ответа и подробной технической помощью. Клиенты Enterprise получают выделенную поддержку с возможностью звонков/видеоконференций, помощью в интеграции и гарантией ответа в тот же день. При сообщении о проблемах укажите версию SQL Agent (выполните sql-agent --version), операционную систему, тип базы данных и описание проблемы для быстрого решения.

Что такое преобразование естественного языка в SQL?

Преобразование естественного языка в SQL — это технология, которая конвертирует вопросы на обычном языке в SQL-запросы к базам данных. Вместо ручного написания сложного SQL-синтаксиса Вы можете задать вопрос, например «Покажи всех клиентов из Москвы» или «Каковы были продажи за прошлый месяц?», и ИИ SQL-ассистент автоматически сгенерирует соответствующие операторы SELECT, JOIN, WHERE и GROUP BY. Это преобразование текста в SQL делает работу с базами данных доступной для нетехнических пользователей и экономит время опытных разработчиков. SQL Agent CLI использует передовые модели ИИ от OpenAI, Anthropic и других провайдеров, чтобы понять Ваше намерение, проанализировать схему базы данных и создать точный, оптимизированный SQL-код, который извлекает именно те данные, которые Вам нужны.

Насколько точен SQL, сгенерированный ИИ?

SQL-запросы, сгенерированные ИИ в SQL Agent, достигают высокой точности благодаря анализу реальной схемы Вашей базы данных перед генерацией. ИИ-агент проверяет структуры таблиц, названия столбцов, типы данных, связи и ограничения для обеспечения синтаксической корректности и семантической осмысленности запросов. Для простых запросов вроде SELECT с простыми WHERE-условиями точность обычно превышает 95%. Сложные запросы с множественными JOIN, подзапросами или агрегациями могут потребовать незначительных корректировок, но ИИ обеспечивает надёжную основу, экономящую значительное время разработки. Исполнитель запросов включает встроенную валидацию для выявления потенциальных ошибок перед выполнением, а режим только для чтения защищает от случайных изменений данных. Пользователи могут просмотреть сгенерированный SQL перед выполнением и дать обратную связь для уточнения результатов. Точность повышается при использовании описательных названий таблиц и столбцов, чётко указывающих их назначение.

Может ли SQL Agent обрабатывать сложные SQL-запросы с JOIN?

Да! SQL Agent CLI может генерировать сложные SQL-запросы, включая INNER JOIN, LEFT JOIN, RIGHT JOIN, FULL OUTER JOIN и самосоединения между множеством таблиц. ИИ-агент анализирует связи внешних ключей и структуры таблиц для автоматического определения правильных условий соединения. Он также обрабатывает продвинутые SQL-функции: подзапросы, общие табличные выражения (CTE), оконные функции, агрегации с GROUP BY и HAVING, операции UNION и INTERSECT, вложенные SELECT-запросы. Например, Вы можете спросить «Покажи клиентов, оформивших заказы за последние 30 дней, с их общими расходами», и SQL Agent сгенерирует запрос с соединением таблиц клиентов и заказов, фильтрацией по дате и вычислением агрегатов. Хотя крайне сложные запросы с множеством вложенных уровней иногда могут потребовать ручной доработки, ИИ обеспечивает отличную основу, значительно сокращающую время разработки для аналитиков данных и разработчиков, работающих с реляционными базами данных.

Поддерживает ли SQL Agent хранимые процедуры?

В настоящее время SQL Agent CLI ориентирован на SELECT-запросы для извлечения данных и базовые операции INSERT, UPDATE и DELETE при включённом режиме записи. Хранимые процедуры, функции и триггеры не поддерживаются для создания или модификации через команды на естественном языке. Однако Вы можете выполнять существующие хранимые процедуры в PostgreSQL или MySQL, написав оператор CALL или EXEC непосредственно в CLI. ИИ-агент может помочь понять, какие параметры ожидает хранимая процедура, и правильно отформатировать команду выполнения. Если Ваша задача требует частой разработки хранимых процедур, мы рекомендуем использовать SQL Agent для исследовательских запросов и анализа данных, а для процедурного SQL переключаться на специализированные IDE для баз данных, такие как DBeaver или DataGrip. Мы изучаем возможности генерации хранимых процедур для будущих версий на основе отзывов и спроса пользователей.

Чем SQL Agent лучше ручного написания SQL?

SQL Agent значительно сокращает время написания SQL-запросов, особенно для пользователей, не являющихся экспертами в SQL. Хотя опытные разработчики баз данных могут вручную писать оптимизированные запросы, SQL Agent предлагает ряд преимуществ: мгновенная генерация запросов без запоминания синтаксиса, автоматическое обнаружение схемы без необходимости обращаться к документации, уменьшение синтаксических ошибок и опечаток, ускоренное исследование незнакомых баз данных. Для аналитиков данных и бизнес-пользователей с ограниченными знаниями SQL Agent делает работу с базами данных доступной без обширного обучения. Даже опытные разработчики ценят SQL Agent за быстрое прототипирование запросов, исследование новых схем и обработку повторяющихся паттернов. SQL-код, сгенерированный ИИ, читабелен, соответствует лучшим практикам и может быть сохранён для повторного использования. При этом для критически важных запросов, требующих экстремальной оптимизации производительности или сложной бизнес-логики, ручное написание SQL экспертом может быть предпочтительнее. SQL Agent лучше всего работает как инструмент продуктивности, дополняющий экспертизу человека, а не полностью заменяющий её.

Можно ли изучить SQL с помощью SQL Agent CLI?

Безусловно! SQL Agent — отличный образовательный инструмент для изучения программирования на SQL. Когда Вы задаёте вопрос на обычном языке, SQL Agent не только выполняет запрос, но и отображает сгенерированный SQL-код, позволяя увидеть, как Ваш запрос на естественном языке преобразуется в SQL-синтаксис. Эта мгновенная обратная связь помогает начинающим понять основы SQL, включая операторы SELECT, условия WHERE, операции JOIN, сортировку ORDER BY и агрегатные функции COUNT, SUM и AVG. Вы можете экспериментировать с разными формулировками и наблюдать, как меняется SQL, развивая интуицию для паттернов запросов к базам данных. SQL Agent работает с реальными базами данных (PostgreSQL, MySQL, SQLite), обеспечивая практический опыт вместо абстрактных упражнений. Для структурированного обучения мы рекомендуем использовать SQL Agent наряду с традиционными курсами SQL — используйте ИИ для быстрой проверки концепций, изучения вариаций синтаксиса и проверки понимания. Режим только для чтения обеспечивает безопасное экспериментирование без риска случайного изменения данных, что идеально для практики SQL и изучения работы баз данных.

Какие типы SQL-запросов может генерировать SQL Agent?

SQL Agent может генерировать широкий спектр типов SQL-запросов для баз данных PostgreSQL, MySQL и SQLite. Наиболее распространённые запросы включают: SELECT-запросы для извлечения данных с фильтрацией, сортировкой и пагинацией; запросы с JOIN для объединения данных из нескольких связанных таблиц; агрегатные запросы с COUNT, SUM, AVG, MIN, MAX и GROUP BY; фильтрацию по дате и времени для темпорального анализа данных; поиск по шаблону с LIKE и регулярными выражениями; подзапросы и вложенные SELECT; UNION и INTERSECT для объединения наборов результатов; DISTINCT для удаления дубликатов; LIMIT/OFFSET для пагинации. При включённом режиме записи с флагом --write SQL Agent также генерирует INSERT для добавления записей, UPDATE для изменения существующих данных и DELETE для удаления (со встроенным подтверждением безопасности). Генератор SQL-запросов на основе ИИ автоматически выбирает подходящие функции, операторы и конструкции SQL в зависимости от Вашего запроса на естественном языке и используемого диалекта базы данных, обеспечивая совместимость и оптимальную производительность.

Подходит ли SQL Agent для начинающих или опытных разработчиков?

SQL Agent CLI разработан для пользователей всех уровней подготовки — от полных новичков в SQL до старших разработчиков баз данных. Для начинающих и нетехнических пользователей — бизнес-аналитиков, продуктовых менеджеров или аналитиков данных с ограниченным опытом программирования — SQL Agent устраняет крутую кривую обучения SQL-синтаксиса, позволяя немедленно выполнять запросы к базам данных с помощью простых вопросов на обычном языке. Инструмент демократизирует доступ к базам данных без необходимости знания программирования или специального обучения SQL. Для опытных разработчиков и администраторов баз данных SQL Agent служит мощным инструментом продуктивности, ускоряющим разработку запросов, сокращающим шаблонный код и ускоряющим исследование незнакомых схем. Старшие разработчики ценят SQL Agent за быстрое прототипирование, документирование паттернов запросов и автоматизацию повторяющихся задач извлечения данных. Поддержка нескольких LLM-провайдеров (OpenAI, Anthropic, локальные модели Ollama) и продвинутые функции, такие как история запросов и режим только для чтения, делают его подходящим для профессиональных сред разработки, оставаясь доступным для новичков, изучающих основы баз данных.

Как SQL Agent повышает продуктивность работы с базами данных?

SQL Agent значительно повышает продуктивность при работе с базами данных, сокращая время разработки запросов с минут до секунд. Вместо ручного написания SQL-кода, обращения к документации и отладки синтаксических ошибок пользователи могут выражать потребности в данных на естественном языке и мгновенно получать работающие запросы. ИИ-ассистент для баз данных устраняет переключение контекста, позволяя работать в терминале без переключения между SQL-редакторами, документацией по схеме и вкладками браузера. Для команд, работающих с несколькими базами данных или частыми изменениями схемы, автоматическое обнаружение схемы SQL Agent означает, что Вам не нужно запоминать названия таблиц, столбцов или связи — ИИ анализирует структуру базы данных в реальном времени. Режим только для чтения предотвращает дорогостоящие ошибки и случайные изменения данных. Отслеживание истории запросов позволяет обращаться к предыдущим запросам без поиска в заметках или файлах. Для аналитиков данных SQL Agent может сэкономить часы в неделю. Команды разработчиков сообщают о 40-60% ускорении разработки SQL-запросов при использовании ИИ-инструментов по сравнению с ручным написанием SQL.

Может ли SQL Agent помочь с оптимизацией SQL-запросов?

SQL Agent генерирует запросы, следующие лучшим практикам SQL и использующие эффективные паттерны, но специализированная оптимизация запросов для высокопроизводительных систем требует дополнительных инструментов и экспертизы. ИИ-агент избегает распространённых анти-паттернов, таких как SELECT * когда нужны конкретные столбцы, использует подходящие типы JOIN и логически структурирует WHERE-условия. Однако SQL Agent пока не предоставляет анализ планов EXPLAIN, рекомендации по индексам или детальные метрики производительности. Для оптимизации запросов мы рекомендуем использовать SQL Agent для генерации начального рабочего запроса, а затем применять инструменты конкретных СУБД, такие как EXPLAIN ANALYZE в PostgreSQL, MySQL Query Profiler или планировщик запросов SQLite для выявления узких мест. Тарифы Professional и Enterprise включают функции анализа производительности с базовыми метриками запросов и отслеживанием времени выполнения. Для оптимизации медленных запросов на больших наборах данных рассмотрите использование SQL Agent совместно со специализированными инструментами мониторинга баз данных. Комбинация быстрых ИИ-генерированных запросов и ручной оптимизации обеспечивает лучшие результаты для рабочих нагрузок баз данных.