Gunakan Lindorm-cli untuk terhubung ke mesin tabel lebar - Lindorm

Lindorm-cli adalah antarmuka baris perintah sederhana yang disediakan oleh Lindorm untuk terhubung ke dan mengelola database Lindorm. Anda dapat menggunakan Lindorm-cli untuk menjalankan operasi SQL dasar, seperti membuat tabel, mengkueri data, menulis data, dan mengekspor data. Topik ini menjelaskan cara menggunakan Lindorm-cli untuk terhubung ke dan menggunakan Lindorm LindormTable.

Prasyarat

Alamat IP klien harus ditambahkan ke daftar putih instans Lindorm. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih.

Jenis jaringan

Anda dapat menggunakan jenis jaringan berikut untuk terhubung ke LindormTable.

Jenis jaringan	Deskripsi
Virtual private cloud (VPC) (Direkomendasikan)	Virtual private cloud (VPC) adalah jaringan pribadi yang didedikasikan untuk Akun Alibaba Cloud Anda. VPC secara logis terisolasi satu sama lain untuk memberikan keamanan tinggi. Ketika Lindorm-cli diterapkan pada Instance ECS, Anda dapat menggunakan Lindorm-cli untuk terhubung ke LindormTable melalui VPC. Hal ini memastikan keamanan tinggi dan mengurangi latensi jaringan.
Internet	Jika Anda ingin menggunakan perangkat lokal untuk menguji atau mengelola LindormTable, Anda dapat menerapkan Lindorm-cli pada perangkat tersebut dan menghubungkan perangkat ke LindormTable melalui Internet. Catatan Anda tidak dikenai biaya untuk Trafik yang dihasilkan saat mengakses LindormTable melalui Internet. Namun, koneksi tersebut mungkin terpapar risiko keamanan. Kami menyarankan agar Anda menggunakan VPC untuk terhubung ke LindormTable guna memastikan keamanan. Untuk menggunakan Titik akhir publik guna terhubung ke LindormTable, Anda harus mengaktifkan Titik akhir publik di Konsol. Untuk informasi selengkapnya tentang cara mengaktifkan Titik akhir publik, lihat bagian Prosedur dalam topik "Lihat titik akhir".

Terhubung menggunakan protokol MySQL (Direkomendasikan)

Langkah 1: Instal Lindorm-cli

Unduh paket instalasi Lindorm-cli untuk sistem operasi Anda. Tabel berikut menyediakan tautan unduhan.

Catatan

Anda dapat menggunakan checksum SHA256 dalam tabel berikut untuk memverifikasi integritas dan keaslian paket instalasi Lindorm-cli yang diunduh.

Sistem operasi	Tautan unduhan	Checksum SHA256
Linux	lindorm-cli untuk linux Anda juga dapat menjalankan perintah berikut untuk mengunduh paket: `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz`	21945c466e2de2c256edd16afdfbb2234301573feb649a673939471a3d882b1a
Linux-arm64	lindorm-cli untuk linux-arm64 Anda juga dapat menjalankan perintah berikut untuk mengunduh paket: `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz`	bcae4d8479201d69e4883105d1a7f933fa46d78e19c171e8e1ebfbee28f6d953
Mac (Chip Intel)	lindorm-cli untuk mac	e82cb1678ea5b263813ccb87fff0149526c36a2654082785efe5a6aaeb4eb24b
Mac (Chip Arm)	lindorm-cli untuk mac	538d5fef122b416ca2ab63fd7074b77ef25840e9feb8d3490405aae36a537a68
Windows	lindorm-cli untuk windows-x64	e61078108a72b85382363e9619b8820aa5245bad60dec79ffd4bf9fea976e280

Ekstrak paket Lindorm-cli.
Sebagai contoh, pada sistem operasi Linux, jalankan perintah berikut untuk mengekstrak paket. Setelah paket diekstrak, Anda dapat menemukan file lindorm-cli.
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```

Langkah 2: Terhubung ke LindormTable

Penting

Hanya Lindorm-cli V2.0.0 atau yang lebih baru yang mendukung koneksi ke LindormTable menggunakan protokol MySQL.

Klien yang diterapkan pada Linux atau macOS

Buka direktori tempat Lindorm-cli berada.

cd <Direktori tempat Lindorm-cli berada>

Jalankan pernyataan berikut untuk terhubung ke LindormTable.

./lindorm-cli -url <mysql url> -username <Nama pengguna> -password <Kata sandi>

Parameter

Parameter	Deskripsi
mysql url	Titik akhir kompatibel MySQL dari LindormTable. Untuk informasi selengkapnya tentang konfigurasi koneksi, lihat Pengaturan koneksi.
Nama pengguna	Nama pengguna yang digunakan untuk terhubung ke LindormTable.
Kata sandi	Kata sandi yang digunakan untuk terhubung ke LindormTable. Penting Jika Anda lupa kata sandi, Anda dapat mengubah kata sandi pengguna di sistem manajemen kluster LindormTable. Setelah mengubah kata sandi, mulai ulang Mesin DPI di konsol.

Pengaturan koneksi

Pengaturan koneksi yang didukung

Deskripsi

Header protokol mysql://

Anda dapat menambahkan header protokol mysql:// sebelum mysql url.

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

Parameter koneksi kustom di sisi server

Anda dapat mengatur parameter koneksi kustom di sisi server setelah mysql url dalam format key1=value1&key2=value2.

Parameter berikut didukung:

operationTimeout: menentukan durasi waktu habis kueri. Format: <mysql url>?operationTimeout=<Durasi waktu habis>. Durasi waktu habis diukur dalam milidetik (ms). Contoh: ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000.

Penting

Parameter operationTimeout hanya dapat ditambahkan pada LindormTable V2.7.7 atau yang lebih baru. Untuk informasi selengkapnya tentang cara melihat atau meningkatkan versi saat ini, lihat Panduan versi LindormTable dan Pembaruan versi minor.

Contoh

./lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Terhubung ke instans dengan menambahkan header protokol mysql://.
./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Tentukan durasi waktu habis kueri.
./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

Jika koneksi berhasil, keluaran berikut dikembalikan:

lindorm-cli version: 2.0.x

Dalam keluaran tersebut, 2.0.x menunjukkan nomor versi Lindorm-cli.

Klien yang diterapkan pada Windows

Metode 1

Buka command prompt (CMD) dan buka direktori tempat lindorm-cli.exe berada.
```
cd <Direktori tempat lindorm-cli.exe berada>
```

Jalankan pernyataan berikut di CMD untuk terhubung ke LindormTable.

lindorm-cli -url <mysql url> -username <Nama pengguna> -password <Kata sandi>

Parameter

Parameter	Contoh	Cara mendapatkan
mysql url	ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060	Titik akhir kompatibel MySQL dari LindormTable. Untuk informasi selengkapnya tentang konfigurasi koneksi, lihat Pengaturan koneksi.
Nama pengguna	user	Nama pengguna yang digunakan untuk terhubung ke LindormTable.
Kata sandi	test	Kata sandi yang digunakan untuk terhubung ke LindormTable. Penting Jika Anda lupa kata sandi, Anda dapat mengubah kata sandi pengguna di sistem manajemen kluster LindormTable. Setelah mengubah kata sandi, mulai ulang Mesin DPI di konsol.

Pengaturan koneksi

Pengaturan koneksi yang didukung

Deskripsi

Header protokol mysql://

Anda dapat menambahkan header protokol mysql:// sebelum mysql url.

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

Parameter koneksi kustom di sisi server

Anda dapat mengatur parameter koneksi kustom di sisi server setelah mysql url dalam format key1=value1&key2=value2.

Parameter berikut didukung:

Penting

Contoh

lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Terhubung ke instans dengan menambahkan header protokol mysql://.
lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Tentukan durasi waktu habis kueri.
lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

Jika koneksi berhasil, keluaran berikut dikembalikan:

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

Dalam keluaran tersebut, 2.0.x menunjukkan nomor versi Lindorm-cli.

Metode 2

Klik ganda program lindorm-cli.exe dan jalankan pernyataan berikut:

connect <mysql url> <Nama pengguna> <Kata sandi>

Contoh

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

Jika koneksi berhasil, tidak ada keluaran yang dikembalikan.

Langkah 3: Gunakan LindormTable

Buat database

Jalankan pernyataan berikut untuk membuat database bernama test.
```
CREATE DATABASE test; 
```
Jalankan pernyataan berikut untuk menggunakan database test.
```
USE test; 
```

Buat tabel

Buat tabel data bernama tb di database test.

CREATE TABLE tb (id VARCHAR, name VARCHAR, address VARCHAR,  PRIMARY KEY(id, name)) ;

Tulis data

UPSERT INTO tb (id, name, address) VALUES ('001', 'jack',  'hz');

Kueri data

Data dapat ditampilkan dalam berbagai format, seperti keluaran tabel, keluaran format CSV, dan keluaran kolom vertikal untuk setiap baris. Anda dapat menjalankan perintah format untuk menyesuaikan format keluaran data. Setelah Anda mengubah format keluaran, data yang Anda kueri menggunakan pernyataan SELECT akan ditampilkan dalam format yang ditentukan. Jika Anda tidak menentukan format keluaran, data akan ditampilkan dalam bentuk tabel secara default.

Penting

Perintah format hanya didukung di alat Lindorm-cli.

Tentukan untuk menampilkan data yang dikembalikan sebagai tabel (default)

Berikut adalah contoh pernyataan pencarian:

format table;
SELECT * FROM tb;

Pernyataan ini memiliki efek yang sama dengan pernyataan berikut:

SELECT * FROM tb;

Keluaran berikut dikembalikan:

+-----+-------+---------+
| id  | name  | address |
+-----+-------+---------+
| 001 | jack  | hz      |
+-----+-------+---------+

Keluaran Format CSV

format csv;
SELECT * FROM tb;

Keluaran berikut dikembalikan:

id,name,address
001,jack,hz

Keluaran vertikal setiap baris

format vertical;
SELECT * FROM tb;

Keluaran berikut dikembalikan:

********************* 1. row *********************
id:      001
name:    jack
address: hz

Terhubung menggunakan protokol Avatica

Langkah 1: Instal Lindorm-cli

Unduh paket instalasi Lindorm-cli untuk sistem operasi Anda. Tabel berikut menyediakan tautan unduhan.

Catatan

Anda dapat menggunakan checksum SHA256 dalam tabel berikut untuk memverifikasi integritas dan keaslian paket instalasi Lindorm-cli yang diunduh.

Sistem operasi	Tautan unduhan	Checksum SHA256
Linux	lindorm-cli untuk linux Anda juga dapat menjalankan perintah berikut untuk mengunduh paket: `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz`	21945c466e2de2c256edd16afdfbb2234301573feb649a673939471a3d882b1a
Linux-arm64	lindorm-cli untuk linux-arm64 Anda juga dapat menjalankan perintah berikut untuk mengunduh paket: `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz`	bcae4d8479201d69e4883105d1a7f933fa46d78e19c171e8e1ebfbee28f6d953
Mac (Chip Intel)	lindorm-cli untuk mac	e82cb1678ea5b263813ccb87fff0149526c36a2654082785efe5a6aaeb4eb24b
Mac (Chip Arm)	lindorm-cli untuk mac	538d5fef122b416ca2ab63fd7074b77ef25840e9feb8d3490405aae36a537a68
Windows	lindorm-cli untuk windows-x64	e61078108a72b85382363e9619b8820aa5245bad60dec79ffd4bf9fea976e280

Ekstrak paket Lindorm-cli.
Sebagai contoh, pada sistem operasi Linux, jalankan perintah berikut untuk mengekstrak paket. Setelah paket diekstrak, Anda dapat menemukan file lindorm-cli.
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```

Langkah 2: Terhubung ke LindormTable

Klien yang diterapkan pada Linux atau macOS

Buka direktori tempat Lindorm-cli berada.

cd <Direktori tempat Lindorm-cli berada>

Jalankan pernyataan berikut untuk terhubung ke LindormTable.

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

Parameter

Parameter	Contoh	Cara mendapatkan
jdbc url	jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060	Titik akhir SQL LindormTable.
Nama pengguna	user	Nama pengguna yang digunakan untuk terhubung ke LindormTable.
Kata sandi	test	Kata sandi yang digunakan untuk terhubung ke LindormTable. Penting Jika Anda lupa kata sandi, Anda dapat mengubah kata sandi pengguna di sistem manajemen kluster LindormTable. Setelah mengubah kata sandi, mulai ulang Mesin DPI di konsol.

Contoh

./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

Dalam keluaran tersebut, 2.0.xx merepresentasikan nomor versi Lindorm-cli.

Klien yang diterapkan di Windows

Metode 1

Buka command prompt (CMD) dan buka direktori tempat lindorm-cli.exe berada.
```
cd <Direktori tempat lindorm-cli.exe berada>
```

Jalankan pernyataan berikut di CMD untuk terhubung ke LindormTable.

lindorm-cli -url <jdbc url> -username <Nama pengguna> -password <Kata sandi>

Parameter

Parameter	Contoh	Cara mendapatkan
jdbc url	jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060	Titik akhir SQL LindormTable.
Nama pengguna	user	Nama pengguna yang digunakan untuk terhubung ke LindormTable.
Kata sandi	test	Kata sandi yang digunakan untuk terhubung ke LindormTable. Penting Jika Anda lupa kata sandi, Anda dapat mengubah kata sandi pengguna di sistem manajemen kluster LindormTable. Setelah mengubah kata sandi, mulai ulang Mesin DPI di konsol.

Contoh

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

Dalam hasil yang dikembalikan, 2.0.xx menunjukkan nomor versi Lindorm-cli.

Metode 2

Klik ganda program lindorm-cli.exe dan jalankan pernyataan berikut:

connect <jdbc url> <Nama pengguna> <Kata sandi>

Contoh

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

Koneksi yang berhasil tidak mengembalikan hasil apa pun.

Langkah 3: Gunakan LindormTable

Buat database

Jalankan pernyataan berikut untuk membuat database bernama test.
```
CREATE DATABASE test; 
```
Jalankan pernyataan berikut untuk menggunakan database test.
```
USE test; 
```

Buat tabel

Buat tabel data bernama tb di database test.

CREATE TABLE tb (id VARCHAR, name VARCHAR, address VARCHAR,  PRIMARY KEY(id, name)) ;

Tulis data

UPSERT INTO tb (id, name, address) VALUES ('001', 'jack',  'hz');

Kueri data

Penting

Perintah format hanya didukung di alat Lindorm-cli.

Tentukan untuk menampilkan data yang dikembalikan sebagai tabel (default)

Berikut adalah contoh pernyataan pencarian:

format table;
SELECT * FROM tb;

Pernyataan ini memiliki efek yang sama dengan pernyataan berikut:

SELECT * FROM tb;

Keluaran berikut dikembalikan:

+-----+-------+---------+
| id  | name  | address |
+-----+-------+---------+
| 001 | jack  | hz      |
+-----+-------+---------+

Keluaran Format CSV

format csv;
SELECT * FROM tb;

Keluaran berikut dikembalikan:

id,name,address
001,jack,hz

Keluaran vertikal setiap baris

format vertical;
SELECT * FROM tb;

Keluaran berikut dikembalikan:

********************* 1. row *********************
id:      001
name:    jack
address: hz

Perintah umum Lindorm-cli

!help: Menampilkan perintah bantuan.
!connect: Terhubung ke server.
exit, quit, atau Ctrl+D: Keluar dari koneksi saat ini.

FAQ

Mengapa koneksi mengalami waktu habis atau gagal?

Jika koneksi mengalami waktu habis atau gagal, pesan kesalahan seperti Failed to connect to <Titik akhir LindormTable> connection check failed atau connection timeout dilaporkan.

Tabel berikut menjelaskan kemungkinan penyebab dan solusinya. Kami menyarankan agar Anda memeriksanya secara berurutan.

Penyebab	Solusi
Anda terhubung ke instans melalui Internet, tetapi Alamat IP publik klien tidak ada dalam daftar putih.	Tambahkan Alamat IP publik klien ke daftar putih Lindorm. Anda dapat mengambil Alamat IP publik klien Anda dengan salah satu cara berikut: Di command prompt Windows (CMD), jalankan `curl ipinfo.io/ip` atau `curl ifconfig.me`. Di perangkat lokal Anda, kunjungi situs web kueri IP.
Alamat IP publik sudah ada dalam daftar putih, tetapi koneksi tetap mengalami waktu habis.	Masalah ini mungkin disebabkan oleh jaringan yang tidak stabil. Kami menyarankan agar Anda menggunakan koneksi VPC.
Anda menggunakan Instance ECS untuk akses, tetapi alamat IP Instance ECS tidak ada dalam daftar putih Lindorm.	Dapatkan alamat IP Instance ECS dan tambahkan alamat IP tersebut ke daftar putih Lindorm.
Alamat koneksi yang digunakan salah.	Lindorm menyediakan titik akhir VPC dan publik. Gunakan titik akhir yang sesuai dengan jenis jaringan Anda.

Jika masalah tetap berlanjut, hubungi dukungan teknis Lindorm di DingTalk di s0s3eg3.

Referensi

Untuk informasi selengkapnya tentang sintaks SQL LindormTable, lihat Referensi SQL.
Untuk informasi tentang metode koneksi lainnya, lihat Terhubung ke dan gunakan mesin tabel lebar menggunakan baris perintah MySQL dan Gunakan protokol MySQL (Direkomendasikan).