Конструктор строк подключения libSQL
Создавайте URL базы данных Turso или libSQL с токеном аутентификации для TypeScript, Python, Go и переменных окружения или вставьте готовый, чтобы увидеть хост, включён ли TLS и когда истекает срок действия токена. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений 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 Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для libSQL и других баз данных.