All Products
Search
Document Center

Lindorm:Menghubungkan ke dan menggunakan mesin tabel lebar dengan Lindorm-cli

Last Updated:Jul 15, 2026

Lindorm-cli adalah antarmuka baris perintah (CLI) ringan yang disediakan oleh Lindorm untuk menghubungkan dan mengelola database Lindorm. Gunakan Lindorm-cli untuk menjalankan operasi SQL dasar seperti membuat tabel, mengkueri data, menulis data, dan mengekspor data. Topik ini menjelaskan cara menghubungkan ke dan menggunakan mesin tabel lebar Lindorm dengan Lindorm-cli.

Prasyarat

Kami mendefinisikan lingkungan tempat Anda menjalankan lindorm-cli sebagai lingkungan client. Sebelum menggunakan lindorm-cli untuk mengakses mesin tabel lebar Lindorm, pastikan hal-hal berikut:

  • Tambahkan alamat IP client ke daftar putih Lindorm. Untuk informasi lebih lanjut, lihat Mengonfigurasi daftar putih.

  • Tentukan jenis jaringan antara lingkungan client dan Lindorm.

    Jenis jaringan berikut didukung saat menghubungkan ke mesin tabel lebar dengan lindorm-cli:

    Jenis jaringan

    Deskripsi

    Virtual private cloud (VPC) (disarankan)

    Virtual private cloud (VPC) adalah jaringan pribadi Anda di cloud. VPC yang berbeda terisolasi secara logis pada layer 2, sehingga memberikan keamanan tinggi. Saat Anda men-deploy lindorm-cli pada Instance ECS, menghubungkan ke mesin tabel lebar Lindorm melalui VPC memberikan keamanan lebih tinggi dan latensi jaringan lebih rendah.

    Jaringan publik

    Jaringan publik mengacu pada Internet. Saat Anda perlu menguji atau mengelola mesin tabel lebar Lindorm dari perangkat lokal, deploy lindorm-cli pada perangkat lokal tersebut dan hubungkan ke mesin tabel lebar Lindorm melalui jaringan publik.

    Catatan
    • Menghubungkan melalui jaringan publik tidak dikenai biaya trafik tetapi menimbulkan risiko keamanan. Kami merekomendasikan penggunaan VPC untuk keamanan yang lebih tinggi.

    • Anda harus mengaktifkan titik akhir publik di Konsol. Untuk informasi lebih lanjut, lihat Prosedur.

Instalasi

  1. Unduh paket instalasi Lindorm-cli yang sesuai dengan sistem operasi Anda. Tautan unduhan tercantum dalam tabel berikut.

    Catatan

    Checksum SHA256 dalam tabel dapat digunakan untuk memverifikasi integritas dan keaslian paket Lindorm-cli yang diunduh.

    Sistem operasi

    Tautan unduhan

    Checksum SHA256

    Linux

    lindorm-cli untuk linux

    Perintah unduh langsung:

    wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz

    3a9ee33e24769cf47b3a90c3a1bba29d26f8aede7a64dbc13ea1f4f5426f04e4

    Linux-arm64

    lindorm-cli untuk linux-arm64

    Perintah unduh langsung:

    wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz

    bc723d4a3a14a85c973c7082a56bb4934a40d2b9cccd72b5767352b8c334ce19

    Mac (chip Intel)

    lindorm-cli untuk mac

    34efd3f43a700e1fea72ee5e5933b9df3cf624569bcf59a2f8a6752dc7faab6c

    Mac (chip Arm)

    lindorm-cli untuk mac

    0be9b346404a37d953714377b59f06b6492ff9c4e46dba4d5bf07c390ee284ad

    Windows

    lindorm-cli untuk windows-x64

    54a447f263b93b158533f7ccd542cbf52e42fb66ce287d38065a798b7801fc48

  2. Ekstrak paket Lindorm-cli.

    Gunakan metode ekstraksi standar untuk sistem operasi Anda guna mengekstrak paket yang telah diunduh.

    Untuk Linux, jalankan perintah berikut untuk mengekstrak paket. Setelah diekstrak, Anda akan mendapatkan file lindorm-cli. File yang dapat dieksekusi ini dapat dijalankan langsung di terminal shell tanpa langkah instalasi tambahan.

    tar zxvf lindorm-cli-linux-latest.tar.gz

Metode koneksi

Lindorm-cli mendukung koneksi ke mesin tabel lebar Lindorm menggunakan protokol MySQL atau protokol Avatica. Kami merekomendasikan penggunaan protokol MySQL.

Penting

Hanya versi lindorm-cli 2.0.0 dan yang lebih baru yang mendukung koneksi ke mesin tabel lebar menggunakan protokol MySQL.

Menghubungkan ke mesin tabel lebar menggunakan protokol MySQL (disarankan)

Client di-deploy pada Linux atau Mac

  1. Buka direktori yang berisi Lindorm-cli.

    cd <direktori Lindorm-cli>
  2. Jalankan perintah berikut untuk menghubungkan ke mesin tabel lebar.

    ./lindorm-cli -url <mysql url> -username <username> -password <password>

    Deskripsi parameter

    Parameter

    Deskripsi

    mysql url

    Titik akhir kompatibel MySQL dari mesin tabel lebar Lindorm. Untuk detail konfigurasi koneksi lebih lanjut, lihat Konfigurasi koneksi.

    username

    Username untuk menghubungkan ke mesin tabel lebar Lindorm.

    password

    Password untuk menghubungkan ke mesin tabel lebar Lindorm.

    Penting
    • Jika Anda lupa password, Anda dapat mengatur ulang password pengguna di sistem manajemen kluster mesin tabel lebar Lindorm.

    • Setelah mengatur ulang password, restart engine di Konsol.

    Konfigurasi koneksi

    Konfigurasi koneksi yang didukung

    Deskripsi

    Header protokol mysql://

    Anda dapat menambahkan header protokol mysql:// di awal mysql url.

    Contoh: mysql://ld-8vbn68478unu8****-proxy-sql-lindorm.lindorm.rds.aliyuncs.com:33060.

    Parameter koneksi kustom sisi server

    Anda dapat menambahkan parameter koneksi kustom sisi server ke mysql url dalam format key1=value1&key2=value2.

    Parameter berikut saat ini didukung:

    operationTimeout: Menentukan periode timeout kueri. Formatnya adalah <mysql url>?operationTimeout=<timeout>, dengan satuan timeout dalam milidetik (ms). Contoh: ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000.

    Penting

    Hanya versi mesin tabel lebar 2.7.7 dan yang lebih baru yang mendukung parameter operationTimeout. Untuk informasi tentang cara melihat atau meningkatkan versi Anda saat ini, lihat Panduan versi mesin tabel lebar dan Pembaruan versi minor.

    Contoh koneksi

    ./lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test
    
    --Tambahkan header protokol mysql://
    ./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test
    
    --Tentukan timeout kueri
    ./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

    Koneksi yang berhasil mengembalikan hasil berikut:

    lindorm-cli version: 2.0.x

    Di sini, 2.0.x adalah nomor versi Lindorm-cli.

Client di-deploy pada Windows

Metode 1
  1. Buka Command Prompt (CMD) dan buka direktori yang berisi lindorm-cli.exe.

    cd <direktori lindorm-cli.exe>
  2. Jalankan perintah berikut di CMD untuk menghubungkan ke mesin tabel lebar.

    lindorm-cli -url <mysql url> -username <username> -password <password>

    Deskripsi parameter

    Parameter

    Nilai contoh

    Cara memperoleh

    mysql url

    ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060

    Titik akhir kompatibel MySQL dari mesin tabel lebar Lindorm. Untuk detail konfigurasi koneksi lebih lanjut, lihat Konfigurasi koneksi.

    username

    user

    Username untuk menghubungkan ke mesin tabel lebar Lindorm.

    password

    test

    Password untuk menghubungkan ke mesin tabel lebar Lindorm.

    Penting
    • Jika Anda lupa password, Anda dapat mengatur ulang password pengguna di sistem manajemen kluster mesin tabel lebar Lindorm.

    • Setelah mengatur ulang password, restart engine di Konsol.

    Konfigurasi koneksi

    Konfigurasi koneksi yang didukung

    Deskripsi

    Header protokol mysql://

    Anda dapat menambahkan header protokol mysql:// di awal mysql url.

    Contoh: mysql://ld-8vbn68478unu8****-proxy-sql-lindorm.lindorm.rds.aliyuncs.com:33060.

    Parameter koneksi kustom sisi server

    Anda dapat menambahkan parameter koneksi kustom sisi server ke mysql url dalam format key1=value1&key2=value2.

    Parameter yang didukung adalah sebagai berikut:

    operationTimeout: Menentukan periode timeout kueri. Formatnya adalah <mysql url>?operationTimeout=<timeout>, dengan satuan timeout dalam milidetik (ms). Contoh: ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000.

    Penting

    Hanya versi mesin tabel lebar 2.7.7 dan yang lebih baru yang mendukung parameter operationTimeout. Untuk informasi tentang cara melihat atau meningkatkan versi Anda saat ini, lihat Panduan versi mesin tabel lebar dan Pembaruan versi minor.

    Contoh koneksi

    lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test
    
    --Tambahkan header protokol mysql://
    lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test
    
    --Tentukan timeout kueri
    lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

    Koneksi yang berhasil mengembalikan hasil berikut:

    Connected to ld-bp187uwcx5f40****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com:33060
    lindorm-cli version: 2.0.x

    Di sini, 2.0.x adalah nomor versi Lindorm-cli.

Metode 2

Klik ganda untuk membuka program Lindorm-cli.exe dan jalankan perintah berikut:

connect <mysql url> <username> <password>

Contoh koneksi

connect ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.aliyuncs.com:33060  user test

Koneksi yang berhasil tidak mengembalikan output apa pun.

Menghubungkan ke mesin tabel lebar menggunakan protokol Avatica

Client di-deploy pada Linux atau Mac

  1. Buka direktori yang berisi Lindorm-cli.

    cd <direktori Lindorm-cli>
  2. Jalankan perintah berikut untuk menghubungkan ke mesin tabel lebar.

    ./lindorm-cli -url <url> -username <username> -password <password>

    Deskripsi parameter

    Parameter

    Nilai contoh

    Cara memperoleh

    jdbc url

    jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060

    Titik akhir SQL tabel lebar dari mesin tabel lebar Lindorm.

    username

    user

    Username untuk menghubungkan ke mesin tabel lebar Lindorm.

    password

    test

    Password untuk menghubungkan ke mesin tabel lebar Lindorm.

    Penting
    • Jika Anda lupa password, Anda dapat mengatur ulang password pengguna di sistem manajemen kluster mesin tabel lebar Lindorm.

    • Setelah mengatur ulang password, restart engine di Konsol.

    Contoh koneksi

    ./lindorm-cli -url jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060 -username user -password test

    Koneksi yang berhasil mengembalikan hasil berikut:

    lindorm-cli version: 2.0.xx

    Di sini, 2.0.xx adalah nomor versi Lindorm-cli.

Client di-deploy pada Windows

Metode 1
  1. Buka Command Prompt (CMD) dan buka direktori yang berisi lindorm-cli.exe.

    cd <direktori lindorm-cli.exe>
  2. Jalankan perintah berikut di CMD untuk menghubungkan ke mesin tabel lebar.

    lindorm-cli -url <jdbc url> -username <username> -password <password>

    Deskripsi parameter

    Parameter

    Nilai contoh

    Cara memperoleh

    jdbc url

    jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060

    Titik akhir SQL tabel lebar dari mesin tabel lebar Lindorm.

    username

    user

    Username untuk menghubungkan ke mesin tabel lebar Lindorm.

    password

    test

    Password untuk menghubungkan ke mesin tabel lebar Lindorm.

    Penting
    • Jika Anda lupa password, Anda dapat mengatur ulang password pengguna di sistem manajemen kluster mesin tabel lebar Lindorm.

    • Setelah mengatur ulang password, restart engine di Konsol.

    Contoh koneksi

    lindorm-cli -url jdbc:lindorm:table:url=http://ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.aliyuncs.com:30060 -username user -password test

    Koneksi yang berhasil mengembalikan hasil berikut:

    Connected to jdbc:lindorm:table:url=http://ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060
    lindorm-cli version: 2.0.xx

    Di sini, 2.0.xx adalah nomor versi Lindorm-cli.

Metode 2

Klik ganda untuk membuka program Lindorm-cli.exe dan jalankan perintah berikut:

connect <jdbc url> <username> <password>

Contoh koneksi

connect jdbc:lindorm:table:url=http://ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.aliyuncs.com:30060 user test

Koneksi yang berhasil tidak mengembalikan output apa pun.

Penggunaan

Lindorm-cli mendukung mode interaktif dan non-interaktif untuk mengeksekusi pernyataan SQL terhadap mesin tabel lebar.

Menjalankan pernyataan SQL dalam mode interaktif

Dalam kebanyakan kasus, Anda memulai lindorm-cli dalam mode interaktif untuk mengoperasikan mesin tabel lebar. Alur kerjanya sebagai berikut:

  1. Memulai lindorm-cli
    Setelah menghubungkan ke mesin tabel lebar Lindorm menggunakan protokol apa pun yang dijelaskan di bagian sebelumnya, terminal Anda masuk ke antarmuka interaktif lindorm-cli dan menunggu perintah selanjutnya.

    Catatan

    Pada Windows, klik ganda lindorm-cli.exe membuka jendela terminal CMD. Ini memulai antarmuka interaktif lindorm-cli tetapi tidak membangun koneksi ke mesin tabel lebar Lindorm. Anda harus menggunakan subperintah connect untuk membangun koneksi sebelum menjalankan pernyataan SQL. Untuk informasi lebih lanjut, lihat Client di-deploy pada Windows dan Metode 2.

  2. Masukkan pernyataan SQL untuk mengakses mesin tabel lebar
    Setelah membangun koneksi dan memasuki antarmuka interaktif, masukkan pernyataan SQL untuk mengakses mesin tabel lebar. Untuk sintaks SQL yang didukung, lihat Referensi SQL.

  3. Keluar dari lindorm-cli
    Setelah menyelesaikan operasi Anda di antarmuka interaktif, keluar dari lindorm-cli dengan menjalankan subperintah exit atau menekan pintasan keyboard ctrl+d.

Catatan

Setelah memulai lindorm-cli dalam mode interaktif dan berhasil menghubungkan ke mesin tabel lebar, client mempertahankan sesi dengan engine hingga Anda keluar. Semua operasi SQL selama periode ini dijalankan dalam sesi yang sama. Perhatikan bahwa jika sesi tidak aktif terlalu lama, sistem secara otomatis memutus koneksi untuk membebaskan sumber daya.

Menjalankan pernyataan SQL dalam mode non-interaktif

Saat menulis skrip O&M, untuk langsung mengeksekusi pernyataan SQL Lindorm tanpa memasuki baris perintah interaktif, Anda dapat menggunakan mode non-interaktif lindorm-cli untuk bekerja dengan LindormTable. Mode ini langsung menjalankan SQL melalui parameter perintah dan mengembalikan hasilnya, sehingga cocok untuk tugas otomatis seperti menjalankan kueri atau operasi statistik.

Untuk mengeksekusi pernyataan SQL dalam mode non-interaktif dari terminal shell, tambahkan parameter -execute diikuti pernyataan SQL yang diapit tanda kutip tunggal atau ganda ke parameter koneksi (seperti alamat host dan port) yang dijelaskan di Metode koneksi. Ini dengan cepat membangun koneksi singkat dan mengeksekusi perintah. Contoh:

lindorm-cli -url mysql://ld-xxxxxx-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password XXXX -execute "CREATE TABLE tb (id VARCHAR, name VARCHAR, address VARCHAR,  PRIMARY KEY(id, name));"

Anda juga dapat mengekspor hasil kueri tabel lebar ke file CSV menggunakan mode non-interaktif.

Penting

Mengekspor ke CSV memerlukan lindorm-cli versi 2.2.0 atau yang lebih baru. Untuk memeriksa versi Anda saat ini:

  • Jalankan lindorm-cli -version di baris perintah.

  • Periksa versi yang ditampilkan dalam pesan selamat datang saat memasuki mode interaktif.

lindorm-cli -url mysql://ld-xxxxxx-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password XXXX -format csv -output ~/result.csv -execute "SELECT * FROM tb;"
Catatan
  • Koneksi singkat: Dalam mode non-interaktif, lindorm-cli membangun koneksi baru untuk setiap pernyataan SQL dan segera menutupnya setelah eksekusi.

  • Kontrol output: Hasil dicetak ke layar terminal (stdout) secara default. Untuk mengarahkan output ke file, gunakan parameter -output.

Menggunakan lindorm-cli dengan AI Agent

Selain mode interaktif dan non-interaktif, lindorm-cli juga dapat dipanggil oleh AI Agent. Saat Anda ingin menggunakan bahasa alami agar AI Agent secara otomatis melakukan kueri data Lindorm, analisis hasil, atau pembuatan skrip O&M, Anda dapat menggabungkan Lindorm Agent Skill dengan lindorm-cli.

Catatan

Kemampuan berorientasi AI Agent yang dijelaskan di bawah ini memerlukan lindorm-cli versi 2.3.0 atau yang lebih baru.

Skenario

Menggunakan lindorm-cli melalui AI Agent cocok untuk skenario berikut:

  • Kueri data dengan bahasa alami: Jelaskan maksud kueri Anda dalam bahasa alami. Agent menghasilkan dan mengeksekusi pernyataan SQL serta mengembalikan hasil terstruktur.

  • Pembuatan skrip O&M batch: Biarkan Agent menghasilkan skrip yang memanggil lindorm-cli berdasarkan kebutuhan Anda untuk tugas terjadwal atau pemrosesan data batch.

  • Ekspor hasil terstruktur: Gunakan Agent untuk mengekspor hasil kueri langsung dalam format yang dapat diurai mesin seperti JSON atau JSONL untuk pemrosesan downstream.

Instal Lindorm Agent Skill

Lindorm Agent Skill menyediakan konteks yang dibutuhkan AI Agent untuk memanggil lindorm-cli. Skill ini membimbing Agent untuk secara otomatis mendeteksi instalasi lindorm-cli lokal, memilih parameter yang sesuai, dan menyusun perintah.

Anda dapat mengunduh Lindorm Agent Skill dari: alibabacloud-lindorm-agent-skill

Setelah instalasi, Agent dapat memanggil lindorm-cli untuk mengakses mesin tabel lebar Lindorm langsung dalam percakapan. Skill ini mengunci kemampuan dan parameter CLI yang dijelaskan di bawah, sehingga Anda biasanya tidak perlu memasukkan parameter tersebut secara manual.

Penggunaan Agen

Setelah menginstal Lindorm Agent Skill, Anda hanya perlu menjelaskan kebutuhan Anda dalam bahasa alami. Agent secara otomatis melakukan deteksi, kueri, kontrol keamanan, dan injeksi kredensial di bawah panduan Skill.

Agent secara otomatis mendeteksi kemampuan lindorm-cli

Sebelum panggilan pertama, Agent mendeteksi versi lindorm-cli, protokol yang didukung, format output, dan definisi kode keluar di lingkungan saat ini. Hal ini memungkinkan Agent memilih metode pemanggilan yang benar berdasarkan lingkungan aktual daripada mengandalkan asumsi yang dikodekan keras.

Catatan

Perilaku ini tertanam dalam Lindorm Agent Skill dan sesuai dengan parameter --capabilities lindorm-cli.

Agent mengembalikan hasil dalam format terstruktur

Saat Agent mengeksekusi kueri, Agent meminta lindorm-cli untuk mengeluarkan hasil dalam format JSON atau JSONL. Hanya data hasil kueri yang dikirim ke stdout; pesan status dan peringatan dikirim ke stderr. Kedua aliran tersebut diisolasi untuk memudahkan penguraian oleh Agent.

Untuk set hasil besar, Agent menggunakan format JSONL untuk mengonsumsi hasil baris demi baris, menghindari pemuatan semua data sekaligus.

Catatan

Perilaku ini tertanam dalam Lindorm Agent Skill dan sesuai dengan parameter -format json dan -format jsonl lindorm-cli.

Agent mengaktifkan pembatas keamanan

Lindorm Agent Skill mengaktifkan safe mode secara default, mencegat operasi tulis berisiko tinggi seperti DROP TABLE, TRUNCATE TABLE, dan DELETE FROM di sisi client untuk mencegah Agent secara tidak sengaja mengeksekusi SQL destruktif. Skill ini juga membatasi jumlah maksimum baris yang dikembalikan per kueri untuk mencegah set hasil besar menghabiskan jendela konteks Agent.

Catatan

Perilaku ini tertanam dalam Lindorm Agent Skill dan sesuai dengan parameter --safe-mode dan --max-rows lindorm-cli.

Agent menginjeksi kredensial secara aman

Saat Agent memanggil lindorm-cli, Skill memprioritaskan injeksi username dan password melalui variabel lingkungan atau input standar, mencegah kredensial muncul dalam argumen baris perintah, riwayat Shell, atau daftar proses.

Catatan

Perilaku ini tertanam dalam Lindorm Agent Skill dan sesuai dengan injeksi kredensial variabel lingkungan dan parameter --password-stdin lindorm-cli.

Parameter baris perintah dan subperintah

Parameter baris perintah

Saat memulai lindorm-cli di terminal, Anda dapat menentukan parameter baris perintah berikut:

Nama parameter

Memerlukan nilai

Nilai

Deskripsi

url

Ya

Nama protokol + string koneksi SQL (termasuk port) untuk mesin tabel lebar Lindorm

Menentukan protokol dan string koneksi untuk lindorm-cli menghubungkan ke mesin tabel lebar.

username

Ya

Username untuk koneksi

Username yang ditentukan harus merupakan pengguna Lindorm yang sudah dibuat di mesin tabel lebar.

password

Ya

Password untuk username

-

database

Ya

Nama database untuk dihubungkan

Jika tidak ditentukan, database default digunakan. Jika ditentukan, database tersebut harus sudah ada di mesin tabel lebar.

execute

Ya

Pernyataan SQL untuk dieksekusi

Saat parameter execute ditentukan, lindorm-cli berjalan dalam mode non-interaktif. Bungkus pernyataan SQL dengan tanda kutip tunggal atau ganda.

Catatan

Saat menggunakan tanda kutip ganda untuk membungkus pernyataan SQL, escape tanda kutip ganda internal dengan backslash \. Tanda kutip tunggal tidak mendukung escaping.

output

Ya

Lokasi output untuk hasil eksekusi SQL dalam mode non-interaktif

Dalam mode non-interaktif, jika output tidak ditentukan, hasil dicetak ke output standar. Jika ditentukan, hasil ditulis ke file pada path yang diberikan. Jika file tidak ada, file tersebut akan dibuat.

format

Ya

Salah satu dari berikut:

horizontal, vertical, csv, json, column

Mengubah format hasil eksekusi SQL yang dikembalikan oleh mesin tabel lebar. Format default adalah column.

  • column: Menampilkan hasil dalam format tabel umum.

  • horizontal: Menampilkan data secara horizontal berdasarkan kolom.

  • vertical: Menampilkan data secara vertikal berdasarkan baris, mirip dengan format \G di baris perintah MySQL.

  • csv: Menampilkan hasil dalam format CSV tanpa batas tabel.

  • json: Menampilkan hasil dalam format JSON.

pretty

Tidak

-

Gunakan dengan format diatur ke JSON.

Saat diaktifkan, hasil dikeluarkan sebagai JSON pretty-printed. Secara default, hasil dikeluarkan sebagai JSON compact.

csvNoHeader

Tidak

-

Gunakan dengan format diatur ke CSV.

Saat diaktifkan, hasil dikeluarkan dalam format CSV tanpa header kolom.

nullString

Ya

String untuk menggantikan nilai NULL

Gunakan dengan format diatur ke CSV.

Saat ditentukan, nilai NULL dalam hasil kueri diganti dengan string yang diberikan.

Jika nullString tidak ditentukan, nilai NULL dikeluarkan sebagai berikut:

  • Saat terhubung melalui protokol MySQL, nilai NULL direpresentasikan sebagai \N.

  • Saat terhubung melalui protokol Avatica, nilai NULL direpresentasikan sebagai string kosong.

version

Tidak

-

Menampilkan informasi versi lindorm-cli. Lindorm-cli tidak dimulai atau masuk ke mode interaktif saat parameter ini digunakan.

format

Ya

Salah satu dari: horizontal, vertical, csv, json, jsonl, column

Mengubah format hasil eksekusi SQL yang dikembalikan oleh mesin tabel lebar. Default adalah column.

  • column: Menampilkan hasil dalam format tabel standar.

  • horizontal: Menampilkan data secara horizontal berdasarkan kolom.

  • vertical: Menampilkan data secara vertikal berdasarkan baris.

  • csv: Menampilkan hasil dalam format CSV tanpa batas tabel.

  • json: Menampilkan hasil dalam format JSON untuk penguraian Agent.

  • jsonl: Satu objek JSON independen per baris, cocok untuk Agent mengonsumsi set hasil besar secara streaming.

capabilities

Tidak

-

Mengeluarkan deklarasi kemampuan JSON lindorm-cli, termasuk engine yang didukung, format, kode keluar, dan parameter. Dalam skenario AI Agent, ini dipanggil secara otomatis oleh Lindorm Agent Skill.

safe-mode

Tidak

-

Saat diaktifkan, client mencegat operasi tulis berisiko tinggi seperti DROP TABLE, TRUNCATE TABLE, dan DELETE FROM. Dalam skenario AI Agent, ini diaktifkan secara default oleh Lindorm Agent Skill.

max-rows

Ya

Bilangan bulat positif

Membatasi jumlah maksimum baris yang dikembalikan oleh client. Baris berlebih dipotong. Dalam skenario AI Agent, ini diatur secara default oleh Lindorm Agent Skill untuk mencegah set hasil besar menghabiskan jendela konteks Agent.

password-stdin

Tidak

-

Membaca password dari input standar untuk mencegahnya muncul dalam argumen baris perintah. Dalam skenario AI Agent, Lindorm Agent Skill memprioritaskan ini daripada parameter -password biasa.

Catatan

Semua parameter baris perintah lindorm-cli harus diawali dengan tanda hubung -.

Subperintah umum

Setelah memulai lindorm-cli dalam mode interaktif, Anda dapat menjalankan subperintah lindorm-cli di antarmuka interaktif untuk mengontrol perilakunya, selain mengirim pernyataan SQL ke mesin tabel lebar Lindorm. Subperintah umum tercantum di bawah ini:

Subcommand

Parameter

Deskripsi

connect

<url> <username> <password>

Saat lindorm-cli dimulai dalam mode interaktif tanpa koneksi, gunakan subperintah connect untuk membangun koneksi ke mesin tabel lebar Lindorm.

Parameter url, username, dan password memiliki makna yang sama dengan parameter baris perintah url, username, dan password.

format

Salah satu dari berikut:

horizontal, vertical, csv, json

Sama dengan parameter format.

help

Tidak ada

Menampilkan daftar subperintah umum.

history

Tidak ada

Menampilkan pernyataan SQL atau subperintah yang baru saja dieksekusi.

exit atau quit

Tidak ada

Keluar dari lindorm-cli dan memutus koneksi dari mesin tabel lebar Lindorm.

FAQ

Mengapa saya mengalami timeout koneksi atau kegagalan koneksi?

Timeout koneksi atau kegagalan koneksi mengembalikan error seperti Failed to connect to <titik akhir tabel lebar> connection check failed atau connection timeout.

Penyebab dan solusi yang mungkin tercantum di bawah ini. Periksa secara berurutan:

Penyebab

Solusi

Menggunakan koneksi jaringan publik tanpa menambahkan alamat IP publik ke daftar putih.

Tambahkan alamat IP publik client ke daftar putih Lindorm.

Untuk mengetahui alamat IP publik client Anda, jalankan curl ipinfo.io/ip atau curl ifconfig.me di Command Prompt (CMD) Windows.

Alamat IP publik sudah ditambahkan ke daftar putih, tetapi timeout koneksi masih terjadi.

Ketidakstabilan jaringan mungkin menjadi penyebabnya. Kami merekomendasikan beralih ke koneksi VPC.

Mengakses dari Instance ECS tanpa menambahkan alamat IP ECS ke daftar putih Lindorm.

Dapatkan alamat IP ECS dan tambahkan ke daftar putih Lindorm.

Menggunakan titik akhir yang salah.

Titik akhir Lindorm berbeda untuk koneksi VPC dan jaringan publik. Gunakan titik akhir yang benar berdasarkan lingkungan jaringan Anda.

Jika solusi di atas tidak menyelesaikan masalah Anda, hubungi dukungan teknis Lindorm (ID DingTalk: s0s3eg3).

Referensi