Lindorm-cli を使用して LindormTable に接続する - Lindorm - Alibaba Cloud ドキュメントセンター

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 に接続できます。これにより、高いセキュリティが確保され、ネットワーク遅延が軽減されます。
インターネット	オンプレミスデバイスを使用して LindormTable をテストまたは管理する場合、デバイスに Lindorm-cli をデプロイし、インターネット経由でデバイスを LindormTable に接続できます。説明インターネット経由で LindormTable にアクセスする際に発生するトラフィックについては課金されません。ただし、接続はセキュリティリスクにさらされる可能性があります。セキュリティを確保するために、VPC を使用して LindormTable に接続することをお勧めします。パブリックエンドポイントを使用して LindormTable に接続するには、Lindorm コンソールでパブリックエンドポイントを有効にします。詳細については、「エンドポイントの表示」トピックの手順セクションをご参照ください。

MySQL プロトコルを使用して LindormTable に接続する (推奨)

ステップ 1：Lindorm-cli をインストールする

クライアントのオペレーティングシステムに基づいて、Lindorm-cli クライアントパッケージをダウンロードします。次の表に、さまざまなオペレーティングシステムの Lindorm-cli クライアントパッケージのダウンロードリンクを示します。

オペレーティングシステム	ダウンロードリンク
Linux	lindorm-cli for linux コマンド `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz` を実行して直接ダウンロードすることもできます。
Linux-arm64	lindorm-cli for linux-arm64 コマンド `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz` を実行して直接ダウンロードすることもできます。
Mac (Intel チップ)	lindorm-cli for mac
Mac (Arm チップ)	lindorm-cli for mac
Windows	lindorm-cli for windows-x64

Lindorm-cli のインストールパッケージを解凍します。
次のコマンドを実行して、ダウンロードした Lindorm-cli クライアントパッケージを解凍します。その後、lindorm-cli ファイルを取得できます。
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```

ステップ 2： LindormTable に接続する

重要

この機能は、Lindorm-cli 2.0.0 以後 でのみサポートされています。

Linux または macOS にデプロイされたクライアント

次のコマンドを実行して、Lindorm-cli が配置されているパスに移動します。
```
cd <Lindorm-cli のパス>
```

次のコマンドを実行して、LindormTable に接続します。

./lindorm-cli -url <mysql url> -username <ユーザー名> -password <パスワード>

パラメーター

パラメーター	説明
mysql url	MySQL 用の LindormTable エンドポイント。接続構成の詳細については、「接続設定」をご参照ください。
ユーザー名	LindormTable に接続するために使用するユーザー名。
パスワード	LindormTable に接続するために使用するパスワード。重要パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動してパスワードを変更できます。パスワードを変更した後、Lindorm コンソールで LindormTable を再起動する必要があります。

接続設定

サポートされている接続設定

説明

mysql:// プロトコルヘッダー

MySQL 用 LindormTable エンドポイントの前に mysql:// プロトコルヘッダーを追加できます。

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

サーバー側のカスタムパラメーター

MySQL 用 LindormTable エンドポイントの後に、key1=value1&key2=value2 形式でサーバー側パラメーターを構成できます。

現在、構成できるのは operationTimeout パラメーターのみです。これは、ミリ秒単位のクエリタイムアウト期間を指定します。

形式：<MySQL 用エンドポイント>?operationTimeout=<タイムアウト期間>。

例：ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000。

重要

operationTimeout パラメーターは、LindormTable 2.7.7 以降でのみ設定できます。バージョンを確認またはアップグレードする方法の詳細については、「LindormTable のリリースノート」および「Lindorm インスタンスのマイナーエンジンバージョンをアップグレードする」をご参照ください。

例

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

-- mysql:// プロトコルヘッダーを追加します。
./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

-- クエリタイムアウト期間を指定します。
./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

クライアントが LindormTable に接続されている場合、次の結果が返されます。

lindorm-cli version: 2.0.x

結果の 2.0.x は、Lindorm-cli のバージョンを示します。

Windows にデプロイされたクライアント

方法 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 エンドポイント。接続構成の詳細については、「接続設定」をご参照ください。
ユーザー名	user	LindormTable に接続するために使用するユーザー名。
パスワード	test	LindormTable に接続するために使用するパスワード。重要パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動してパスワードを変更できます。パスワードを変更した後、Lindorm コンソールで LindormTable を再起動する必要があります。

接続設定

サポートされている接続設定

説明

mysql:// プロトコルヘッダー

MySQL 用 LindormTable エンドポイントの前に mysql:// プロトコルヘッダーを追加できます。

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

サーバー側のカスタム接続パラメーター

MySQL 用 LindormTable エンドポイントの後に、key1=value1&key2=value2 形式でサーバー側パラメーターを構成できます。

現在、構成できるのは operationTimeout パラメーターのみです。これは、ミリ秒単位のクエリタイムアウト期間を指定します。

形式：<MySQL 用エンドポイント>?operationTimeout=<タイムアウト期間>。

例：ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000。

重要

operationTimeout パラメーターは、LindormTable 2.7.7 以後のバージョンでのみ設定できます。バージョンを確認またはアップグレードする方法の詳細については、「LindormTable のリリースノート」と「Lindorm インスタンスのマイナーエンジンバージョンをアップグレードする」をご参照ください。

例

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

-- mysql:// プロトコルヘッダーを追加します。
lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

-- クエリタイムアウト期間を指定します。
lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

クライアントが LindormTable に接続されている場合、次の結果が返されます。

Connected to ld-bp187uwcx5f40****-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> <ユーザー名> <パスワード>

例

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

クライアントが 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 ファイルとして出力するように指定する

format csv;
SELECT * FROM tb;

次の結果が返されます。

id,name,address
001,jack,hz

返されるデータを垂直方向の列として出力するように指定する

format vertical;
SELECT * FROM tb;

次の結果が返されます。

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

Avatica プロトコルを使用して LindormTable に接続する

手順 1：Lindorm-cli をインストールする

オペレーティングシステム	ダウンロードリンク
Linux	lindorm-cli for linux 次のコマンドを実行して直接ダウンロードすることもできます。`wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz`.
Linux-arm64	lindorm-cli for linux-arm64 次のコマンドを実行して直接ダウンロードすることもできます。`wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz`.
Mac (Intel チップ)	Mac 用 lindorm-cli
Mac (Arm チップ)	lindorm-cli for mac
Windows	lindorm-cli for windows-x64

Lindorm-cli のインストールパッケージを解凍します。
次のコマンドを実行して、ダウンロードした Lindorm-cli クライアントパッケージを解凍します。その後、lindorm-cli ファイルを取得できます。
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```

手順 2：LindormTable に接続する

Linux または macOS にデプロイされたクライアント

次のコマンドを実行して、Lindorm-cli が配置されているパスに移動します。
```
cd <Lindorm-cli のパス>
```

次のコマンドを実行して、LindormTable に接続します。

./lindorm-cli -url <url> -username <ユーザー名> -password <パスワード>

パラメーター

パラメーター	例	パラメーター値の取得方法
jdbc url	jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060	LindormTable に接続するために使用する SQL エンドポイント。
ユーザー名	user	LindormTable に接続するために使用するユーザー名。
パスワード	test	LindormTable に接続するために使用するパスワード。重要パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動して、パスワードを変更できます。パスワードを変更した後、Lindorm コンソールで LindormTable を再起動する必要があります。

例

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

クライアントが LindormTable に接続されている場合、次の結果が返されます。

lindorm-cli version: 2.0.xx

結果の 2.0.xx は、Lindorm-cli のバージョンを示します。

Windows にデプロイされたクライアント

方法 1

コマンドプロンプトで次のコマンドを実行して、lindorm-cli.exe が配置されているパスに移動します。
```
cd <lindorm-cli.exe のパス>
```

コマンドプロンプトで次のコマンドを実行して、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	LindormTable に接続するために使用する SQL エンドポイント。
ユーザー名	user	LindormTable に接続するために使用するユーザー名。
パスワード	test	LindormTable に接続するために使用するパスワード。重要パスワードを忘れた場合は、LindormTable のクラスタ管理システムに移動して、パスワードを変更できます。パスワードを変更した後、Lindorm コンソールで LindormTable を再起動する必要があります。

例

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

クライアントが LindormTable に接続されている場合、次の結果が返されます。

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

結果の 2.0.xx は Lindorm-cli のバージョンを示します。

方法 2

lindorm-cli.exe をダブルクリックしてクライアントを開き、次のコマンドを実行します。

connect <jdbc url> <ユーザー名> <パスワード>

例

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

クライアントが 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 ファイルとして出力するように指定する

format csv;
SELECT * FROM tb;

次の結果が返されます。

id,name,address
001,jack,hz

返されるデータを垂直方向の列として出力するように指定する

format vertical;
SELECT * FROM tb;

次の結果が返されます。

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

Lindorm-cli で使用される一般的なコマンド

!help: このコマンドを実行して、ヘルプ情報を表示できます。
!connect: このコマンドを実行して、サーバーに接続できます。
exit、quit、および ctrl+d: これらのコマンドのいずれかを実行して、現在の接続を終了できます。

FAQ

接続がタイムアウトまたは失敗するのはなぜですか？

接続がタイムアウトまたは失敗した場合、Failed to connect to <LindormTable endpoint> connection check failed または connection timeout エラーメッセージが表示されます。

次の表に、考えられる原因と解決策を示します。

原因	解決策
インターネット経由で LindormTable に接続していますが、パブリック IP アドレスがホワイトリストに追加されていません。	クライアントのパブリック IP アドレスを Lindorm ホワイトリストに追加します。クライアントのパブリック IP アドレスを照会するには、次のいずれかの方法を使用できます。 Windows コマンドプロンプトで `curl ipinfo.io/ip` または `curl ifconfig.me` と入力します。オンプレミスデバイスで [IPアドレス照会ウェブサイト] にアクセスします。
パブリック IP アドレスはホワイトリストに追加されていますが、接続はまだタイムアウトしています。	これは、ネットワークが不安定なことが原因である可能性があります。VPC 経由で LindormTable に接続することをお勧めします。
ECS インスタンスを使用して LindormTable に接続していますが、ECS インスタンスの IP アドレスが Lindorm ホワイトリストに追加されていません。	ECS インスタンスの IP アドレスを取得し、Lindorm ホワイトリストに追加します。
エンドポイントが無効です。	Lindorm は非公開エンドポイントとパブリックエンドポイントを提供します。ネットワーク環境に基づいて正しいエンドポイントを使用してください。

上記の解決策で問題が解決しない場合は、Lindorm テクニカルサポート（DingTalk ID：s0s3eg3）に連絡してください。

リファレンス

LindormTable でサポートされている SQL 構文の詳細については、「SQL リファレンス」をご参照ください。
その他の接続方法の詳細については、「MySQL クライアントを使用して LindormTable に接続して使用する」および「MySQL プロトコルを使用してアプリケーションを開発する（推奨）」をご参照ください。