Lindorm-cli を使用した LindormTable への接続 - Lindorm - Alibaba Cloud ドキュメントセンター

Lindorm-cli は、Lindorm が提供する Lindorm データベースへの接続と管理を行うためのシンプルなコマンドラインインターフェイス (CLI) です。Lindorm-cli を使用して、テーブルの作成、データのクエリ、データの書き込み、データのエクスポートなどの基本的な SQL 操作を実行できます。このトピックでは、Lindorm-cli を使用して Lindorm LindormTable に接続し、使用する方法について説明します。

前提条件

ご利用のクライアントの IP アドレスを Lindorm のホワイトリストに追加する必要があります。詳細については、「ホワイトリストの設定」をご参照ください。

ネットワークタイプ

LindormTable への接続には、以下のネットワークタイプを使用できます。

ネットワークタイプ	説明
VPC (推奨)	Virtual Private Cloud (VPC) は、クラウド上のプライベートネットワークです。異なる VPC 間はレイヤー 2 で論理的に隔離されており、高いセキュリティを確保します。Lindorm-cli を Elastic Compute Service (ECS) インスタンスにデプロイした場合、VPC 経由で LindormTable に接続すると、より高いセキュリティと低いネットワーク遅延が実現します。
パブリックネットワーク	パブリックネットワークはインターネットです。オンプレミスのデバイスから LindormTable をテストまたは管理するには、デバイスに Lindorm-cli をデプロイし、パブリックネットワーク経由で LindormTable に接続します。説明パブリックネットワーク経由の接続ではトラフィック料金は発生しませんが、セキュリティリスクが伴います。より高いセキュリティを確保するために、VPC 経由で接続してください。コンソールでパブリックエンドポイントを有効にする必要があります。詳細については、「操作手順」をご参照ください。

MySQL プロトコルを使用した接続 (推奨)

ステップ 1：Lindorm-cli のインストール

お使いのオペレーティングシステムに対応する Lindorm-cli インストールパッケージを次の表からダウンロードします。

説明

次の表の SHA256 チェックサムを使用して、ダウンロードした Lindorm-cli インストールパッケージの完全性と信頼性を検証できます。

オペレーティングシステム	ダウンロードリンク	SHA256 チェックサム
Linux	lindorm-cli for linux 直接ダウンロードコマンド： `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz`	0f4ccaf214b41fdf8d3dd5f0ed4f92f1d5e6b0a11da3d217c9df6d382f0080df
Linux (arm64)	lindorm-cli for linux-arm64 直接ダウンロードコマンド： `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz`	1bfb992853a26c703b2d9e2bd50e4d7e31f88992bcb7e70ac30331f5998c269e
Mac (Intel チップ)	lindorm-cli for mac	af8a78bfe8ef53d1df25df99b5803ef3f55da7e943d730a1a6d44cd918f28842
Mac (Arm チップ)	lindorm-cli for mac	5bdc8600055432a9275a0d52e5d26e6c2cfc7a553961c09681d0388a5a5e9a62
Windows	lindorm-cli for windows-x64	7721748744edc551d43fec6bb19ab40eb514bb6043a3d21afa38f353833259ce

Lindorm-cli パッケージを解凍します。
例えば、Linux オペレーティングシステムでは、次のコマンドを実行してパッケージを解凍します。解凍後、lindorm-cli ファイルが作成されます。
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```

ステップ 2：LindormTable への接続

重要

Lindorm-cli バージョン 2.0.0 以降のみが、MySQL プロトコルを使用した LindormTable への接続をサポートしています。

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

Lindorm-cli があるフォルダに移動します。
```
cd <folder_of_Lindorm-cli>
```

次の文を実行して LindormTable に接続します。

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

パラメーターの説明

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

接続設定

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

説明

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

mysql url の先頭に mysql:// プロトコルヘッダーを追加します。

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

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

mysql url の後に、key1=value1&key2=value2 の形式でサーバー側のカスタム接続パラメーターを設定します。

以下のパラメーターがサポートされています：

operationTimeout：クエリタイムアウト期間。形式は <mysql url>?operationTimeout=<timeout_period> です。タイムアウト期間はミリ秒 (ms) 単位です。例：ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000

重要

LindormTable エンジンバージョン 2.7.7 以降のみが operationTimeout パラメーターをサポートしています。現在のバージョンを表示またはアップグレードするには、「LindormTable バージョンガイド」および「マイナーバージョンの更新」をご参照ください。

接続例

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

接続が成功すると、次の結果が返されます：

lindorm-cli version: 2.0.x

出力の 2.0.x は Lindorm-cli のバージョン番号です。

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

方法 1

コマンドプロンプト (CMD) を開き、lindorm-cli.exe があるフォルダに移動します。
```
cd <folder_of_lindorm-cli.exe>
```

CMD で、次の文を実行して LindormTable に接続します。

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

パラメーターの説明

パラメーター	例	取得方法
mysql url	ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060	LindormTable の MySQL 互換エンドポイント。接続設定の詳細については、「接続設定」をご参照ください。
username	user	LindormTable に接続するためのユーザー名。
password	test	LindormTable に接続するためのパスワード。重要パスワードを忘れた場合は、LindormTable クラスター管理システムでユーザーパスワードを変更してください。パスワードを変更した後、コンソールでエンジンを再起動してください。

接続設定

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

説明

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

mysql url の先頭に mysql:// プロトコルヘッダーを追加します。

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

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

mysql url の後に、key1=value1&key2=value2 の形式でサーバー側のカスタム接続パラメーターを設定します。

以下のパラメーターがサポートされています：

重要

接続例

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

接続が成功すると、次の結果が返されます：

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> <username> <password>

接続例

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

接続が成功してもメッセージは返されません。

ステップ 3：LindormTable の使用

データベースの作成

次の文を実行して、test という名前のデータベースを作成します。
```
CREATE DATABASE test; 
```
次の文を実行して、test データベースに切り替えます。
```
USE test; 
```

テーブルの作成

test データベースに tb という名前のデータテーブルを作成します。

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

データの書き込み

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

データのクエリ

データは、テーブル出力、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 プロトコルによる接続

ステップ 1：Lindorm-cli のインストール

お使いのオペレーティングシステムに対応する Lindorm-cli インストールパッケージを次の表からダウンロードします。

説明

次の表の SHA256 チェックサムを使用して、ダウンロードした Lindorm-cli インストールパッケージの完全性と信頼性を検証できます。

オペレーティングシステム	ダウンロードリンク	SHA256 チェックサム
Linux	lindorm-cli for linux 直接ダウンロードコマンド： `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz`	0f4ccaf214b41fdf8d3dd5f0ed4f92f1d5e6b0a11da3d217c9df6d382f0080df
Linux (arm64)	lindorm-cli for linux-arm64 直接ダウンロードコマンド： `wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz`	1bfb992853a26c703b2d9e2bd50e4d7e31f88992bcb7e70ac30331f5998c269e
Mac (Intel チップ)	lindorm-cli for mac	af8a78bfe8ef53d1df25df99b5803ef3f55da7e943d730a1a6d44cd918f28842
Mac (Arm チップ)	lindorm-cli for mac	5bdc8600055432a9275a0d52e5d26e6c2cfc7a553961c09681d0388a5a5e9a62
Windows	lindorm-cli for windows-x64	7721748744edc551d43fec6bb19ab40eb514bb6043a3d21afa38f353833259ce

Lindorm-cli パッケージを解凍します。
例えば、Linux オペレーティングシステムでは、次のコマンドを実行してパッケージを解凍します。解凍後、lindorm-cli ファイルが作成されます。
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```

ステップ 2：ワイドテーブルエンジンへの接続

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

Lindorm-cli が含まれるディレクトリに移動します。
```
cd <directory_of_Lindorm-cli>
```

次の文を実行してワイドテーブルエンジンに接続します。

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

パラメーターの説明

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

接続例

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

接続が成功すると、次の結果が返されます：

lindorm-cli version: 2.0.xx

結果の 2.0.xx は Lindorm-cli のバージョン番号です。

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

方法 1

コマンドプロンプト (CMD) を開き、lindorm-cli.exe が含まれるディレクトリに移動します。
```
cd <directory_of_lindorm-cli.exe>
```

コマンドプロンプトで、次の文を実行してワイドテーブルエンジンに接続します。

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

パラメーターの説明

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

接続例

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

接続が成功すると、次の結果が返されます：

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

結果の 2.0.xx は Lindorm-cli のバージョン番号です。

方法 2

Lindorm-cli.exe ファイルをダブルクリックし、次の文を実行します：

connect <jdbc url> <username> <password>

接続例

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

接続が成功しても出力は生成されません。

ステップ 3：ワイドテーブルエンジンの使用

データベースの作成

次の文を実行して、test という名前のデータベースを作成します。
```
CREATE DATABASE test; 
```
次の文を実行して、test データベースに切り替えます。
```
USE test; 
```

テーブルの作成

test データベースに tb という名前のデータテーブルを作成します。

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

データの書き込み

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

データのクエリ

重要

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

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

Lindorm-cli の共通コマンド

!help：ヘルプコマンドを表示します。
!connect：サーバーに接続します。
exit、quit、および ctrl+d：現在の接続を終了します。

よくある質問

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

接続タイムアウトまたは失敗は、Failed to connect to <wide table endpoint> connection check failed や connection timeout のようなエラーメッセージを返すことがあります。

問題を解決するために、次の考えられる原因を確認してください：

原因	解決策
パブリックネットワーク接続用のパブリック IP アドレスがホワイトリストに追加されていません。	クライアントのパブリック IP アドレスを Lindorm ホワイトリストに追加します。クライアントのパブリック IP アドレスは、次のいずれかの方法で見つけることができます： Windows のコマンドプロンプト (CMD) で `curl ipinfo.io/ip` または `curl ifconfig.me` を入力します。オンプレミスのデバイスで IP クエリサイトにアクセスします。
パブリック IP アドレスをホワイトリストに追加した後も接続がタイムアウトします。	ネットワーク環境が不安定である可能性があります。Virtual Private Cloud (VPC) 接続に切り替えることを推奨します。
ECS インスタンスの IP アドレスが Lindorm ホワイトリストに追加されていません。	ECS インスタンスの IP アドレスを取得し、Lindorm ホワイトリストに追加します。
正しいエンドポイントが使用されていません。	Lindorm は、VPC アクセスとパブリックネットワークアクセス用に異なるエンドポイントを提供します。ご利用のネットワーク環境に適した正しいエンドポイントを使用していることを確認してください。

問題が解決しない場合は、DingTalk で Lindorm のテクニカルサポートにご連絡ください。DingTalk ID は s0s3eg3 です。

Lindorm:Lindorm-cli を使用した LindormTable への接続と使用

前提条件

ネットワークタイプ

MySQL プロトコルを使用した接続 (推奨)

ステップ 1：Lindorm-cli のインストール

ステップ 2：LindormTable への接続

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

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

方法 1

方法 2

ステップ 3：LindormTable の使用

データベースの作成

テーブルの作成

データの書き込み

データのクエリ

テーブル出力 (デフォルト)

CSV 形式の出力

各行の列の垂直出力

Avatica プロトコルによる接続

ステップ 1：Lindorm-cli のインストール

ステップ 2：ワイドテーブルエンジンへの接続

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

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

方法 1

方法 2

ステップ 3：ワイドテーブルエンジンの使用

データベースの作成

テーブルの作成

データの書き込み

データのクエリ

テーブル出力 (デフォルト)

CSV 形式の出力

各行の列の垂直出力

Lindorm-cli の共通コマンド

よくある質問

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

関連ドキュメント