Lindorm-cli は、Lindorm データベースに接続して管理するために使用されるシンプルなコマンドラインツールです。 Lindorm-cli を使用して、テーブルの作成、データのクエリ、データの書き込み、データのエクスポートなどの基本的な SQL 操作を実行できます。 このトピックでは、Lindorm-cli を使用して Lindorm ワイドテーブルエンジン (LindormTable) に接続して使用する方法について説明します。
前提条件
クライアントの IP アドレスが Lindorm インスタンスのホワイトリストに追加されていること。 詳細については、「ホワイトリストを構成する」をご参照ください。
LindormTable への接続に使用するネットワークのタイプ
[エンドポイント ネットワークタイプ] | 説明 |
VPC (推奨) | VPC は、Alibaba Cloud アカウント専用のプライベートネットワークです。 VPC は論理的に相互に分離されており、高いセキュリティを提供します。 Lindorm-cli が Elastic Compute Service (ECS) インスタンスにデプロイされている場合、VPC 経由で Lindorm-cli を使用して LindormTable に接続できます。 これにより、高いセキュリティが確保され、ネットワーク遅延が軽減されます。 詳細については、「ECS とは」をご参照ください。 |
インターネット | オンプレミスデバイスを使用して LindormTable をテストまたは管理する場合、デバイスに Lindorm-cli をデプロイし、インターネット経由でデバイスを LindormTable に接続できます。 説明
|
Lindorm-cli で使用される一般的なコマンド
LindormTable でサポートされている SQL 構文の詳細については、「LindormTable SQL」をご参照ください。
!help: このコマンドを実行して、ヘルプ情報を表示できます。
!connect: このコマンドを実行して、サーバーに接続できます。
exit、quit、および ctrl+d: これらのコマンドのいずれかを実行して、現在の接続を終了できます。
手順
手順 1: Lindorm-cli をインストールする
クライアントのオペレーティングシステムに基づいて、Lindorm-cli クライアントパッケージをダウンロードします。 次の表に、さまざまなオペレーティングシステムの Lindorm-cli クライアントパッケージのダウンロードリンクを示します。
オペレーティングシステム
ダウンロードリンク
Linux
Mac (Intel チップ)
Mac (Arm チップ)
Windows
Linux-arm64
Lindorm-cli のインストールパッケージを解凍します。
次のコマンドを実行して、ダウンロードした Lindorm-cli クライアントパッケージを解凍します。
tar zxvf lindorm-cli-linux-latest.tar.gz実行可能ファイル
lindorm-cli.exeは、lindorm-cli-linux-latestディレクトリにあります。
手順 2： LindormTable に接続する
MySQL プロトコルを使用して LindormTable に接続する c
この機能は、Lindorm-cli 2.0.0 以降でのみサポートされています。
Linux または macOS にデプロイされたクライアント
次のコマンドを実行して、
Lindorm-cliが配置されているパスに移動します。cd <Lindorm-cli のパス>次のコマンドを実行して、LindormTable に接続します。
./lindorm-cli -url <mysql url> -username <ユーザー名> -password <パスワード>パラメーター
パラメーター
例
パラメーター値の取得方法
mysql url
ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060
MySQL 用の LindormTable エンドポイント。 エンドポイントの取得方法については、「LindormTable に接続する」をご参照ください。 接続構成の詳細については、「接続設定」をご参照ください。
ユーザー名
user
LindormTable にアクセスするために使用されるユーザー名とパスワード。 パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動してパスワードをリセットできます。 詳細については、「ユーザーのパスワードを変更する」をご参照ください。
重要パスワードをリセットした後、Lindorm コンソールで LindormTable を再起動する必要があります。
パスワード
test
接続設定
MySQL 用の LindormTable エンドポイントを使用して LindormTable に接続する場合は、エンドポイントの前に
mysql://プロトコルヘッダーを追加します。 例:mysql://ld-8vbn68478unu8****-proxy-sql-lindorm.lindorm.rds.aliyuncs.com:33060。key1=value1&key2=value2形式を使用して、サーバー側でパラメーターを構成できます。 現在、構成できるのは operationTimeout パラメーターのみです。これは、ミリ秒単位のクエリタイムアウト期間を指定します。 形式:<mysql url>?operationTimeout=<タイムアウト期間>。 例:ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120。重要operationTimeout パラメーターは、LindormTable 2.7.7 以降でのみ構成できます。 バージョンの表示またはアップグレード方法の詳細については、「LindormTable のリリースノート」および「Lindorm インスタンスのマイナーエンジンバージョンをアップグレードする」をご参照ください。
クライアントが LindormTable に接続されている場合、次の結果が返されます。
lindorm-cli version: 2.0.x結果の 2.0.x は、Lindorm-cli のバージョンを示します。
Windows にデプロイされたクライアント
方法 1方法 1
コマンドプロンプトで次のコマンドを実行して、
lindorm-cli.exeが配置されているパスに移動します。cd <lindorm-cli.exe のパス>コマンドプロンプトで次のコマンドを実行して、LindormTable に接続します。
lindorm-cli -url <mysql url> -username <ユーザー名> -password <パスワード>パラメーター
パラメーター
例
パラメーター値の取得方法
mysql url
ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060
MySQL 用の LindormTable エンドポイント。 エンドポイントの取得方法については、「LindormTable に接続する」をご参照ください。 接続構成の詳細については、「接続設定」をご参照ください。
ユーザー名
user
LindormTable にアクセスするために使用されるユーザー名とパスワード。 パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動してパスワードをリセットできます。 詳細については、「ユーザーのパスワードを変更する」をご参照ください。
重要パスワードをリセットした後、Lindorm コンソールで LindormTable を再起動する必要があります。
パスワード
test
クライアントが LindormTable に接続されている場合、次の結果が返されます。
Connected to ld-bp173e6a9sr18****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com:33060 lindorm-cli version: 2.0.x結果の
2.0.xは、Lindorm-cli のバージョンを示します。
方法 2
lindorm-cli.exe をダブルクリックしてクライアントを開き、次のコマンドを実行します。
connect <mysql url> <ユーザー名> <パスワード>クライアントが LindormTable に接続されている場合、結果は返されません。
Avatica プロトコルを使用して LindormTable に接続する
Linux または macOS にデプロイされたクライアント
次のコマンドを実行して、
Lindorm-cli.exeが配置されているパスに移動します。cd <Lindorm-cli.exe のパス>次のコマンドを実行して、LindormTable に接続します。
./lindorm-cli -url <url> -username <ユーザー名> -password <パスワード>パラメーター
パラメーター
例
パラメーター値の取得方法
jdbc url
jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060
SQL を使用して LindormTable に接続して使用するときに必要なエンドポイント。 エンドポイントの取得方法については、「LindormTable に接続する」をご参照ください。
ユーザー名
user
LindormTable にアクセスするために使用されるユーザー名とパスワード。 パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動してパスワードをリセットできます。 詳細については、「ユーザーのパスワードを変更する」をご参照ください。
重要パスワードをリセットした後、Lindorm コンソールで LindormTable を再起動する必要があります。
パスワード
test
クライアントが LindormTable に接続されている場合、次の結果が返されます。
lindorm-cli version: 1.0.xx結果の
1.0.xxは、Lindorm-cli のバージョンを示します。
Windows にデプロイされたクライアント
方法 1方法 1
コマンドプロンプトで次のコマンドを実行して、
lindorm-cliが配置されているパスに移動します。cd <lindorm-cli のパス>コマンドプロンプトで次のコマンドを実行して、LindormTable に接続します。
lindorm-cli -url <jdbc url> -username <ユーザー名> -password <パスワード>パラメーター
パラメーター
例
パラメーター値の取得方法
jdbc url
jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060
SQL を使用して LindormTable に接続して使用するときに必要なエンドポイント。 エンドポイントの取得方法については、「LindormTable に接続する」をご参照ください。
ユーザー名
user
LindormTable にアクセスするために使用されるユーザー名とパスワード。 パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動してパスワードをリセットできます。 詳細については、「ユーザーのパスワードを変更する」をご参照ください。
重要パスワードをリセットした後、Lindorm コンソールで LindormTable を再起動する必要があります。
パスワード
test
クライアントが LindormTable に接続されている場合、次の結果が返されます。
Connected to jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060 lindorm-cli version: 1.0.xx結果の
1.0.xxは、Lindorm-cli のバージョンを示します。
方法 2
lindorm-cli.exe をダブルクリックしてクライアントを開き、次のコマンドを実行します。
connect <jdbc url> <ユーザー名> <パスワード>クライアントが LindormTable に接続されている場合、結果は返されません。
手順 3: LindormTable を使用して操作を実行する手順 3：LindormTable を使用して操作を実行する
データベースを作成する
次の文を実行して、test という名前のデータベースを作成します。
CREATE DATABASE test;次の文を実行して、test データベースを使用します。
USE test;
テーブルを作成する
test データベースに tb という名前のテーブルを作成します。
CREATE TABLE tb (id varchar, name varchar, address varchar, primary key(id, name)) ;LindormTable にデータを書き込む
UPSERT INTO tb (id, name, address) values ('001', 'jack', 'hz');LindormTable でデータをクエリする
返されるデータは、テーブル、CSV ファイル、垂直方向の列など、さまざまな形式で出力できます。 format コマンドを使用して、返されるデータの形式を指定できます。 SELECT 文によってクエリされたデータは、指定された形式で返されます。 デフォルトでは、データはテーブルとして返されます。
format コマンドは Lindorm-cli でのみサポートされています。
返されるデータをテーブルとして出力するように指定する
次のクエリ文を実行します。
format table;
SELECT * FROM tb;このクエリ文は、次の文と同じです。
SELECT * FROM tb;次の結果が返されます。
+-----+-------+---------+
| id | name | address |
+-----+-------+---------+
| 001 | jack | hz |
+-----+-------+---------+返されるデータを CSV ファイルとして出力するように指定するCSV ファイルとして返されるデータを出力するように指定する
format csv;
SELECT * FROM tb;次の結果が返されます。
id,name,address
001,jack,hz返されるデータを垂直方向の列として出力するように指定する返されたデータを出力形式を垂直方向の列に指定する
format vertical;
SELECT * FROM tb;次の結果が返されます。
********************* 1. row *********************
id: 001
name: jack
address: hz