Klien Turso dan libSQL untuk Mac

Pilih Turso dalam daftar jenis koneksi dan biarkan Connection Mode pada Remote (Turso). Tempel URL HTTPS database, yang berakhiran .turso.io, dan masukkan token pada bidang API Token, yang disimpan di Keychain macOS. Dashboard Turso menampilkan keduanya, demikian pula turso db show my-db --url dan turso db tokens create my-db.

URL libsql:// diubah menjadi HTTPS, dan mengimpornya membuat koneksi jarak jauh. Tidak ada bidang host, port, atau database karena URL menunjuk satu database. Koneksi terenkripsi jika URL menggunakan HTTPS, bukan HTTP tanpa enkripsi, dan tunnel SSH tidak tersedia.

libSQL menggunakan sintaks SQLite, sehingga penelusuran, diagram EXPLAIN QUERY PLAN, perubahan tertunda dengan Preview SQL, dan ekspor berperilaku seperti pada SQLite.

Koneksi jarak jauh tidak menjalankan transaksi. Setiap pernyataan adalah permintaan HTTP tersendiri dan melakukan commit sendiri, sementara BEGIN gagal dengan “Transactions are not supported in this mode”. Pekerjaan transaksional memerlukan berkas libSQL lokal, yang dijelaskan di bagian libSQL.

Mode jarak jauh tidak memuat ekstensi SQLite: database Turso menjalankan ekstensi yang disertakan saat server dikompilasi. Saat Turso membatasi koneksi, kesalahan menyebutkan berapa detik harus menunggu sebelum mencoba lagi.

Tab Structure membuat tabel, menambah dan menghapus kolom serta indeks, dan membuat, mengedit, serta menghapus trigger. Tabel, tetapi bukan view, dapat diganti namanya dari bilah samping.

Untuk mengurutkan ulang kolom atau mengubah foreign key pada database jarak jauh, TablePro menulis skrip pembangunan ulang untuk Anda baca dan jalankan sendiri. Aplikasi tidak dapat menjalankannya karena pembangunan ulang memerlukan satu transaksi di seluruh permintaan HTTP yang terpisah.

TablePro tidak menyediakan impor untuk Turso atau libSQL; muat data menggunakan CLI Turso atau impor pada server sqld Anda. Untuk mengambil data, ekspor tabel atau hasil kueri sebagai CSV, JSON, SQL, XLSX, Markdown, HTML dan XML.

Aplikasi iPhone dan iPad tidak memiliki driver Turso. Koneksi Turso yang disinkronkan dari Mac muncul dalam daftar tetapi tidak dapat dibuka.

Diunduh saat pertama kali digunakaniPhone dan iPad: Tidak terbuka

Pilih libSQL untuk server sqld yang Anda hosting sendiri atau berkas di Mac ini. Pada mode Remote, driver mengakses sqld apa pun yang menyediakan endpoint pipeline Hrana v2, termasuk yang berjalan di Mac ini dan menggunakan port default 8080. Kosongkan token untuk server yang dimulai tanpa --auth-jwt-key-file, atau masukkan JWT yang sesuai dengan kunci server.

Mode Local File membuka berkas libSQL dengan mesin SQLite bawaan driver, dan membuat jalur yang belum ada beserta foldernya. Berkas lokal menjalankan transaksi, memuat ekstensi SQLite dari daftar Extensions koneksi, dan menjalankan pembangunan ulang untuk pengurutan kolom atau foreign key setelah Anda mengonfirmasi.

Pernyataan yang hanya dipahami libSQL, seperti ALTER TABLE … ALTER COLUMN, gagal pada berkas lokal karena diterima mesin SQLite. Berkas libSQL terenkripsi tidak dapat dibuka. Jangan pernah membuka berkas yang sedang disinkronkan aplikasi aktif sebagai replika tertanam Turso: akses bersamaan dari dua program dapat merusaknya.

Backup Dump dan Restore Dump menjalankan sqlite3 pada berkas libSQL lokal.

Panduan pengaturan libSQL (bahasa Inggris)↗