Connect to and use LindormTable by using the MySQL command line - Lindorm: Central de Documentação do Alibaba Cloud

Se sua aplicação já utiliza o ecossistema MySQL, conecte-se ao LindormTable pelo protocolo MySQL sem instalar drivers adicionais. Isso permite usar clientes MySQL padrão e o Lindorm SQL para criar bancos de dados, gerenciar tabelas e ler ou gravar dados.

Pré-requisitos

Antes de começar, verifique se você possui:

Uma instância do Lindorm executando o LindormTable 2.6.0 ou posterior. Para verificar ou atualizar a versão, consulte Notas de versão do LindormTable e Atualize a versão secundária do mecanismo de uma instância do Lindorm.
O endereço IP do cliente adicionado à lista de permissões da instância do Lindorm. Consulte Configurar listas de permissões.
O recurso de compatibilidade com MySQL ativado na instância. Consulte Ativar o recurso de compatibilidade com MySQL.
Conhecimento sobre os requisitos de desenvolvimento do protocolo MySQL. Consulte Notas de uso para desenvolvimento de aplicações com MySQL.

Instale um cliente MySQL

Linux

Execute um dos comandos abaixo conforme o seu gerenciador de pacotes:

APT (Advanced Package Tool):
```
sudo apt-get install mysql-client
```
yum:
```
sudo yum install mysql
```

macOS

Instale via Homebrew:

brew install mysql-client

Windows

Baixe e execute o instalador disponível em MySQL Downloads.

Conecte-se ao LindormTable

Etapa 1: Obtenha o endpoint de conexão

A URL do MySQL corresponde ao Lindorm Wide Table SQL Address exibido no console do Lindorm, excluindo os dois pontos e o número da porta ao final.

Tipo de conexão	Quando usar	Como obter o endpoint
VPC (recomendado)	Aplicação executada em uma instância do Elastic Compute Service (ecs)	Utilize diretamente o endpoint da VPC. Conexões via Virtual Private Cloud (VPC) oferecem menor latência e maior segurança.
Rede pública	Aplicação executada fora da Alibaba Cloud	No console, acesse Database Connections > Wide Table Engine. Na aba Wide Table Engine, clique em Enable Public Endpoint e utilize o endpoint público.

Etapa 2: Execute o comando de conexão

mysql --get-server-public-key -h<mysql-url> -P33060 -u<username> -p<password> -D<database>

Nota

O parâmetro --get-server-public-key evita o erro Authentication plugin 'caching_sha2_password' reported error: Authentication requires secure connection.

Substitua os espaços reservados pelos valores reais:

Parâmetro	Descrição	Exemplo
`<mysql-url>`	O Lindorm Wide Table SQL Address obtido no console, sem os dois pontos e o número da porta finais	`ld-uf6k8yqb741t3****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com`
`<username>`	Nome de usuário do LindormTable	`test`
`<password>`	Senha correspondente ao nome de usuário	`test`
`<database>`	Banco de dados de destino. Assume o valor `default` caso não seja especificado	`default`

Notas de compatibilidade para MySQL 8.0 e versões anteriores

As ferramentas de linha de comando do MySQL 8.0 e anteriores apresentam dois problemas de compatibilidade com o Lindorm. Aplique a correção adequada antes de estabelecer a conexão.

Incompatibilidade de versão TLS

Por padrão, o MySQL 8.0 e versões anteriores utilizam TLSv1.1 para conexões criptografadas. Como o Lindorm suporta TLSv1.2, pode ocorrer falha no handshake TLS. Adicione --ssl-mode=DISABLED para forçar uma conexão em texto simples:

mysql --ssl-mode=DISABLED --get-server-public-key -h<mysql-url> -P33060 -u<username> -p<password> -D<database>

Importante

Tenha cautela ao utilizar conexões em texto simples pela Internet.

Incompatibilidade de protocolo de autenticação

O MySQL 8.0 e versões anteriores usam mysql_native_password por padrão e não suportam caching_sha2_password. A autenticação pode falhar devido aos requisitos de versão do LindormTable para o protocolo MySQL. Inclua --enable_cleartext_plugin para transmitir a senha em texto simples:

mysql --enable_cleartext_plugin --get-server-public-key -h<mysql-url> -P33060 -u<username> -p<password> -D<database>

Importante

Tenha cautela ao transmitir senhas em texto simples pela Internet.

Execute operações básicas

Os exemplos a seguir utilizam o Lindorm SQL para criar um banco de dados, criar uma tabela, inserir dados e consultar informações.

Crie um banco de dados chamado test1:
```
CREATE DATABASE test1;
```
Mude para o banco de dados test1:
```
USE test1;
```

Crie uma tabela e insira uma linha:

CREATE TABLE tb (id varchar, name varchar, address varchar, PRIMARY KEY (id, name));
UPSERT INTO tb (id, name, address) VALUES ('001', 'jack', 'hz');

Consulte os dados:

SELECT * FROM tb;

Saída esperada:

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

Próximos passos

Notas de uso para desenvolvimento de aplicações com MySQL — conheça a sintaxe SQL suportada e as limitações conhecidas antes de escrever o código da aplicação.
Notas de versão do LindormTable — verifique os recursos mais recentes e os requisitos de versão.