Chuyển đến nội dung chính

Turso và libSQL client

Kết nối tới cơ sở dữ liệu Turso bằng URL và token, hoặc mở file libSQL, và query bằng cú pháp của SQLite.

Tóm tắt

Ngôn ngữ query
SQL
Driver
Tải về ở lần dùng đầuDùng chung với libSQL
Cách kết nối
API của dịch vụ

Kết nối tới Turso

Chọn Từ xa (Turso) (Remote (Turso)) trong Chế độ kết nối (Connection Mode), rồi dán HTTPS URL của cơ sở dữ liệu và API Token, được lưu trong macOS Keychain. Lấy cả hai từ dashboard hoặc CLI của Turso.

URL libsql:// khi import sẽ thành connection từ xa qua HTTPS, và mỗi URL chỉ tới một cơ sở dữ liệu. URL HTTP thường không được mã hóa, và không dùng được SSH tunnel.

Query và chỉnh sửa

libSQL dùng cú pháp của SQLite, nên việc duyệt dữ liệu, sơ đồ EXPLAIN QUERY PLAN và export hoạt động như trên SQLite.

Connection từ xa không chạy transaction: mỗi câu lệnh là một request HTTP riêng và tự commit, còn BEGIN báo lỗi “Transactions are not supported in this mode”. Transaction cần một file cục bộ, mở dưới dạng libSQL. Chế độ từ xa không nạp extension SQLite nào, vì cơ sở dữ liệu Turso chạy những extension mà server của nó được build kèm, và khi request bị giới hạn tần suất, thông báo lỗi cho biết cần chờ bao nhiêu giây.

Table, index và trigger

Tab Structure tạo table, thêm và xóa cột cùng index, và tạo, sửa, xóa trigger. Table, nhưng không phải view, có thể đổi tên từ sidebar.

Sắp lại cột hoặc đổi khóa ngoại trên connection từ xa sẽ tạo script dựng lại để bạn xem và chạy, vì TablePro không gộp được các HTTP request riêng vào một transaction.

Trang này chỉ nói về những gì riêng của Turso. Safe Mode, trợ lý AI, MCP server và phần còn lại của TablePro nằm ở các trang tính năng.

libSQL

Hãy chọn libSQL cho server sqld tự host, kết nối qua endpoint Hrana v2 pipeline của nó, hoặc cho file trên máy Mac này ở chế độ Tệp cục bộ (Local File). File cục bộ chạy được transaction, nạp extension SQLite và chạy script dựng lại sau khi bạn xác nhận, còn Backup Dump và Restore Dump chạy sqlite3 trên file đó.

Đừng bao giờ mở một file mà một ứng dụng đang chạy đồng bộ dưới dạng embedded replica của Turso: hai chương trình cùng truy cập có thể làm hỏng file.

Giới hạn
  • Backup Dump chỉ dùng được cho file libSQL cục bộ, không dùng cho cơ sở dữ liệu từ xa.

Ngoài ra

  • Di chuyển dữ liệu

    Export table hoặc kết quả query ra CSV, JSON, SQL, XLSX, Markdown, HTML và XML. Để nạp dữ liệu, hãy dùng Turso CLI hoặc tính năng import trên server sqld của bạn.

  • Giới hạn

    • Mỗi connection là một cơ sở dữ liệu. Không hỗ trợ đổi cơ sở dữ liệu và branch.
    • Không hỗ trợ embedded replica: file cục bộ được mở độc lập và không đồng bộ.
  • Nên chọn chế độ Từ xa hay Tệp cục bộ?

    Từ xa, cho cơ sở dữ liệu Turso hoặc server sqld mà bạn truy cập bằng URL. Tệp cục bộ, cho file libSQL trên máy Mac này; chế độ này còn cho bạn transaction, extension SQLite và sao lưu.

  • Tôi có cần cài Turso CLI không?

    Không. Dashboard của Turso cũng hiển thị URL của cơ sở dữ liệu và tạo token. CLI hữu ích khi bạn nạp dữ liệu từ terminal.

Tải TablePro

Mọi tính năng trên trang này đều miễn phí.