// бесплатный инструмент

Конструктор строк подключения libSQL

Создавайте URL базы данных Turso или libSQL с токеном аутентификации для TypeScript, Python, Go и переменных окружения или вставьте готовый, чтобы увидеть хост, включён ли TLS и когда истекает срок действия токена. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

Открыть это подключение в SQLly

Открывает редактор подключений SQLly с заполненными полями.

Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.

Форматы строк подключения libSQL

К базе данных Turso можно обратиться по libsql://<database>-<organization>.turso.io URL плюс токен аутентификации (JWT). libsql:// означает TLS; свой собственный sqld на вашей машине обычно слушает обычный http://127.0.0.1:8080.

Декодер читает полезную нагрузку токена прямо в вашем браузере и показывает срок его действия и то, только ли для чтения этот токен. Подпись он не проверяет и никуда токен не отправляет.

URL базы данных Turso CLI, любой SDK libSQL

libsql://mydb-myorg.turso.io

URL с токеном аутентификации Go database/sql, @libsql/client, SQLly

libsql://mydb-myorg.turso.io?authToken=your_auth_token

Локальный sqld Самостоятельно размещённый сервер libSQL

http://127.0.0.1:8080

Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к libSQL: SQLly для libSQL.

Схемы и параметры URL libSQL

Из исходного кода @libsql/client и справочника SDK Turso.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
libsql:// - - TLS; клиент выбирает HTTPS или защищённые WebSockets.
https:// / wss:// - - TLS поверх конкретного транспортного протокола.
http:// / ws:// - - Простой текст, для локального sqld.
file: - - Локальный файл libSQL/SQLite (встроенный).
authToken - - Параметр запроса, содержащий токен аутентификации; либо передать authToken / auth_token в опциях клиента.
tls - 1 ?tls=0 выключает TLS для libsql://; требует явного указания порта.
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN - - Названия переменных окружения, которые используют быстрые стартеры Turso.

Распространённые ошибки подключения libSQL

401 Unauthorized

Почему: Токен аутентификации отсутствует, истёк, отозван или принадлежит другой базе данных или организации.

Исправлено: Создайте новый токен с turso db tokens create <database> и вставьте его в декодер, чтобы проверить срок действия.

Connection refused on 127.0.0.1:8080

Почему: Локальный sqld не запущен или слушает на другом порту.

Исправлено: Запустите sqld (например turso dev для локального сервера разработки) и используйте URL, который он выведет.

FAQ по строкам подключения libSQL

Что такое URL базы данных Turso?

libsql://<database>-<organization>.turso.io, указанный turso db show <database>. Используйте его вместе с токеном аутентификации из turso db tokens create <database>.

Безопасно ли использовать токен аутентификации в URL?

Это работает (?authToken=), но тогда URL становится секретом, который может попасть в логи и историю командной строки. Предпочтительно передавать токен отдельно, например в TURSO_AUTH_TOKEN переменная окружения.

Проверяет ли этот инструмент мой токен?

Он декодирует полезную нагрузку токена в вашем браузере, чтобы показать дату истечения срока действия и является ли он только для чтения. Он не проверяет подпись и никогда не отправляет токен куда-либо.

// вообще без строк подключения

Подключитесь один раз. А потом просто пишите SQL.

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для libSQL и других баз данных.