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

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

Установка SQL Agent CLI — быстрый и простой процесс для Windows, macOS и Linux. Сначала скачайте подходящий установщик для Вашей операционной системы с нашей страницы загрузок. Для пользователей Windows запустите .exe-установщик и следуйте мастеру установки. Пользователи macOS могут установить через .pkg-установщик. Для 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 offers flexible AI provider support, allowing you to choose the LLM that best fits your needs and budget. Supported providers include OpenAI with GPT-5.5 and GPT-5.4-mini models for industry-leading accuracy, Anthropic Claude 4 models (Opus 4.7, Sonnet 4.6, Haiku 4.5) known for their strong reasoning capabilities, xAI Grok 4.3 for fast frontier reasoning, Google Gemini 3.5 Flash and 3.1 Pro for multimodal workloads, Alibaba Qwen 3.7 Max for open-weights flexibility, and local Ollama models for completely offline, private operation with no external API calls. To configure your preferred provider, run sql-agent configuration llm.provider --value provider_name, then set your API key with the appropriate environment variable or configuration command. Using Ollama with models like Llama 3.3, Mistral, or CodeLlama enables fully offline natural language to SQL conversion without internet connectivity or recurring API costs. Each provider offers different trade-offs between speed, cost, accuracy, and privacy, giving you complete control over your AI SQL assistant infrastructure.

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

Да! Лицензии 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 учётные данные и история остаются на вашем компьютере, а Ollama позволяет работать с ИИ полностью локально. Выберите интерфейс под свои требования безопасности и проверяйте сгенерированный SQL перед выполнением.

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

Да. SQL Agent по умолчанию работает в режиме только для чтения и блокирует изменяющие запросы INSERT, UPDATE, DELETE, DROP, TRUNCATE и ALTER до выполнения. В веб-приложении доступ на запись включается отдельно для каждого профиля подключения. В CLI при необходимости записи переподключитесь с флагом --write. По возможности оставляйте производственные подключения в режиме только для чтения.

Нужно ли что-то устанавливать, чтобы пользоваться SQL Agent?

Нет. Помимо CLI, каждая лицензия SQL Agent включает браузерную веб-рабочую область — того же ИИ-агента без какой-либо установки. Войдите с любого компьютера, сохраните профили подключений к вашим базам PostgreSQL, MySQL или SQLite и выполняйте запросы на естественном языке прямо в браузере — с визуальным обозревателем схемы, историей запросов, сохранёнными запросами и экспортом в CSV/JSON/XLSX. CLI остаётся доступным для тех, кто предпочитает терминал или работает офлайн с локальными моделями Ollama, и обе среды открываются одним лицензионным ключом — включая 14-дневную пробную лицензию, создаваемую при регистрации. Подробнее на странице веб-рабочей области или попробуйте без регистрации живую демоверсию.

Безопасно ли хранится пароль моей базы данных в веб-рабочей области?

Yes. When you save a connection profile in the Web Workspace, the database password (or connection URL) is encrypted with industry-standard Fernet encryption before it is stored — plaintext credentials never reach the database or backups. The password is decrypted only inside an isolated background worker at the moment a query job actually runs, is never written to logs, and is never displayed again in the interface after saving; you only ever see a masked placeholder. If you prefer credentials to never leave your machine at all, the CLI stores them locally with the same encryption approach instead.

Может ли веб-агент изменять данные в моей базе?

Нет, если вы явно этого не разрешите. Каждый профиль подключения в веб-рабочей области по умолчанию работает только на чтение: INSERT, UPDATE, DELETE, DROP, TRUNCATE и другие изменяющие операторы блокируются валидатором запросов до выполнения — ровно те же правила безопасности, что и в CLI. Если для конкретной базы нужен доступ на запись, включите опцию записи в настройках этого профиля; остальные профили останутся только для чтения. Независимо от режима действуют дополнительные защиты: предпросмотр результатов ограничен по числу строк, запросы выполняются с тайм-аутами, а в истории фиксируется, какой именно SQL был выполнен. Благодаря этому веб-рабочую область безопасно направлять на продакшен-реплики и открывать неинженерам.

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

Поддержка доступна пользователям веб-приложения и CLI на любом тарифе. По вопросам технической помощи, ошибок, новых функций, подключений или настройки ИИ-провайдера посетите нашу страницу контактов. Укажите, какой интерфейс вы используете, тип базы данных и сведения об ошибке. Для проблем с CLI также приложите вывод команды sql-agent --version. Обычно мы отвечаем в течение 24 часов в рабочие дни.

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

Преобразование естественного языка в SQL превращает обычные вопросы в запросы к базе данных. Спросите, например: «Покажи всех клиентов из Нью-Йорка» или «Какими были продажи в прошлом месяце?», и SQL Agent создаст соответствующий SQL. Один и тот же ИИ-помощник доступен в веб-приложении и CLI.

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

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

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

Да. SQL Agent умеет создавать JOIN, подзапросы, CTE, оконные функции, агрегации, UNION и вложенные SELECT. ИИ анализирует структуру и связи таблиц как в веб-приложении, так и в CLI. Особенно сложные запросы следует проверять и тестировать перед использованием в производственной среде.

Поддерживает ли 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?

Безусловно! 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 подходит всем — от новичков в SQL до опытных разработчиков баз данных. Наглядное веб-приложение упрощает изучение схем и выполнение запросов без опыта работы с терминалом, а CLI поддерживает автоматизацию и локальные модели. Оба интерфейса ускоряют разработку запросов и помогают разобраться в незнакомых схемах.

Как 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 совместно со специализированными инструментами мониторинга баз данных. Комбинация быстрых ИИ-генерированных запросов и ручной оптимизации обеспечивает лучшие результаты для рабочих нагрузок баз данных.