Lindorm:MySQLクライアントを使用してLindormTableに接続して使用する

前提条件

• インスタンスのLindormTableバージョンが 2.6.0以降であること。 LindormTableのバージョンを表示またはアップグレードする方法については、LindormTableのリリースノートおよびLindormインスタンスのマイナーエンジンバージョンのアップグレードをご参照ください。

• クライアントのIPアドレスがLindormインスタンスのホワイトリストに追加されていること。 詳細については、ホワイトリストの設定をご参照ください。

• インスタンスでMySQL互換機能が有効になっていること。 詳細については、MySQL互換機能の有効化をご参照ください。

• MySQL に基づく開発に関する注意事項を理解していること。詳細については、「MySQL を使用したアプリケーション開発における注意事項」をご参照ください。

使用方法に関する注意事項

• バージョン 8.0 以前の MySQL コマンドラインツールは、暗号化接続時にデフォルトで TLSv1.1 を使用します。一方、Lindorm は TLSv1.2 をサポートしています。このバージョンの不一致により、接続が失敗する可能性があります。これを回避するには、起動コマンドに --ssl-mode=DISABLED パラメーターを追加して、プレーンテキスト接続を強制してください。

  重要

  インターネット経由で暗号化されていない接続を確立する場合は注意してください。

• バージョン 8.0 以前の MySQL コマンドラインツールは、デフォルトで mysql_native_password 認証プロトコルを使用します。LindormTable の MySQL プロトコルに対するバージョン要件により、認証が失敗する可能性があります。また、これらのツールバージョンは caching_sha2_password 認証プロトコルをサポートしていません。そのため、起動コマンドに --enable_cleartext_plugin パラメーターを追加して、パスワードをプレーンテキストで送信する必要があります。

  重要

  パブリックネットワーク環境では、この方法の使用に十分ご注意ください。

手順

ツールのインストール

• Linux

  Linuxで使用する管理ツールに基づいて、次のコマンドのいずれかを実行します。

  • APT (Advanced Package Tool)

    sudo apt-get install mysql-client

  • Yum パッケージ管理ツール

    sudo yum install mysql

• macOS

  Homebrew パッケージ管理ツールを使用してインストールするには、以下のコマンドを実行します。

  brew install mysql-client

• Windows オペレーティングシステム

  詳細については、MySQLクライアントのインストールをご参照ください。

LindormTableに接続して使用する

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

   mysql --get-server-public-key -h<mysql url> -P33060 -u<Username> -p<Password> -D<Database>

   説明

   以下のエラーを回避するために、--get-server-public-key パラメーターを追加できます：Authentication plugin 'caching_sha2_password' reported error: Authentication requires secure connection.。

   各パラメーターの説明は以下のとおりです。

   パラメーター	例	取得方法
   mysql url	ld-uf6k8yqb741t3****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com	コンソールで Lindorm ワイドテーブルの SQL アドレス を取得し、末尾のコロンとポート番号を削除します。 重要 アプリケーションがElastic Compute Service（ECS）インスタンスにデプロイされている場合は、セキュリティを強化し、ネットワークレイテンシを低減するために、仮想プライベートクラウド（VPC）接続を使用してLindormインスタンスにアクセスすることをお勧めします。 ご利用のアプリケーションがローカル環境にデプロイされている場合、パブリックネットワーク経由で Lindorm インスタンスに接続する前に、コンソールでパブリックエンドポイントを有効にしてください。エンドポイントを有効にするには、ナビゲーションウィンドウで Database Connections > Wide Table Engine を選択します。Wide Table Engine タブで、Enable Public Endpoint をクリックします。
   Username	test	LindormTableへの接続に使用するユーザー名。
   Password	test	ユーザー名に対応するパスワード。
   Database	default	接続先の LindormTable データベース。データベースを指定しない場合、クライアントはデフォルトで default データベースに接続します。

2. LindormTableで操作を実行します。

   1. test1という名前のデータベースを作成します。

      CREATE DATABASE test1; 

   2. test1データベースを使用します。

      USE test1; 

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

      CREATE TABLE tb (id varchar, name varchar, address varchar,  primary key(id, name)) ; 
      UPSERT INTO tb (id, name, address) values ('001', 'jack',  'hz'); 

   4. tbテーブルのデータをクエリします。

      SELECT * FROM tb;

      次の結果が返されます。

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