Lindorm:Conectar e usar o mecanismo de tabela larga com o Lindorm-cli

Conectar ao mecanismo de tabela larga usando o protocolo MySQL (recomendado)

connect <mysql url> <username> <password>

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

Conectar ao mecanismo de tabela larga usando o protocolo Avatica

connect <jdbc url> <username> <password>

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

Quando usar o modo HBase

Na maioria dos cenários, recomendamos o uso do protocolo MySQL (ou Avatica) para acessar o mecanismo de tabela larga via SQL: o SQL oferece suporte completo às capacidades da tabela larga (índices secundários, consultas multicolumna, agregação, paginação, entre outros), além de um ecossistema e conjunto de ferramentas mais ricos.

O modo HBase é recomendado apenas nas situações abaixo:

• Dados migrados do HBase open-source: Suas tabelas e dados estavam originalmente armazenados no HBase open-source e foram migrados para o mecanismo de tabela larga do Lindorm usando ferramentas como o LTS.

• Hábitos ou scripts existentes do HBase: Você já conhece a sintaxe de comandos do HBase Shell (create, put, get, scan, describe, etc.) e deseja utilizá-los diretamente sem precisar reescrevê-los em SQL.

• Gerenciamento de tabelas no estilo HBase: É necessário realizar operações como definir atributos de família de colunas ou gerenciar namespaces.

Método de conexão

O modo HBase utiliza o formato de URL dedicado hbase://<host>:<port>:

./lindorm-cli -url "hbase://<host>:30020" -username <username>

O prefixo hbase:// é obrigatório. Diferentemente do protocolo MySQL, onde o prefixo mysql:// é opcional, omitir o prefixo hbase:// faz com que a conexão seja interpretada como protocolo MySQL em vez de modo HBase.

A senha é opcional no modo HBase. Se a autenticação for necessária, passe-a através do parâmetro -password ou da variável de ambiente LINDORM_PASSWORD.

Após uma conexão bem-sucedida, você pode inserir comandos do HBase Shell diretamente na interface interativa. Os comandos do HBase não terminam com ponto e vírgula (;). Pressione Enter para executar cada comando.

Executar instruções SQL no modo interativo

Geralmente, inicia-se o lindorm-cli no modo interativo para operar o mecanismo de tabela larga. O fluxo de trabalho é o seguinte:

1. Iniciar o lindorm-cliApós conectar-se ao mecanismo de tabela larga do Lindorm usando qualquer protocolo descrito na seção anterior, seu terminal entra na interface interativa do lindorm-cli e aguarda novos comandos.

   Nota

   No Windows, clicar duas vezes no lindorm-cli.exe abre uma janela de terminal CMD. Isso inicia a interface interativa do lindorm-cli, mas não estabelece conexão com o mecanismo de tabela larga do Lindorm. É necessário usar o subcomando connect para estabelecer a conexão antes de executar instruções SQL. Para mais informações, consulte Cliente implantado em Windows e Método 2.

2. Inserir instruções SQL para acessar o mecanismo de tabela largaApós estabelecer a conexão e entrar na interface interativa, insira instruções SQL para acessar o mecanismo de tabela larga. Para sintaxe SQL suportada, consulte Referência SQL.

3. Sair do lindorm-cliApós concluir suas operações na interface interativa, saia do lindorm-cli executando o subcomando exit ou pressionando o atalho de teclado ctrl+d.

Executar instruções SQL no modo não interativo

Ao escrever scripts de O&M, para executar diretamente instruções SQL do Lindorm sem entrar na linha de comando interativa, utilize o modo não interativo do lindorm-cli para trabalhar com o LindormTable. Esse modo executa SQL diretamente via parâmetros de comando e retorna os resultados, sendo adequado para tarefas automatizadas, como consultas ou operações estatísticas.

Para executar uma instrução SQL no modo não interativo a partir de um terminal shell, anexe o parâmetro -execute seguido pela instrução SQL entre aspas simples ou duplas aos parâmetros de conexão (como endereço do host e porta) descritos em Métodos de conexão. Isso estabelece rapidamente uma conexão de curta duração e executa o comando. Exemplo:

lindorm-cli -url mysql://ld-xxxxxx-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password XXXX -execute "CREATE TABLE tb (id VARCHAR, name VARCHAR, address VARCHAR,  PRIMARY KEY(id, name));"

Também é possível exportar resultados de consultas da tabela larga para um arquivo CSV usando o modo não interativo.

lindorm-cli -url mysql://ld-xxxxxx-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password XXXX -format csv -output ~/result.csv -execute "SELECT * FROM tb;"

Cenários

O uso do lindorm-cli através de um AI Agent é adequado para os seguintes cenários:

• Consultas de dados em linguagem natural: Descreva sua intenção de consulta em linguagem natural. O Agent gera e executa instruções SQL e retorna resultados estruturados.

• Geração de scripts de O&M em lote: Permita que o Agent gere scripts que chamam o lindorm-cli com base nos seus requisitos para tarefas agendadas ou processamento de dados em lote.

• Exportação estruturada de resultados: Use o Agent para exportar resultados de consultas diretamente em formatos analisáveis por máquina, como JSON ou JSONL, para processamento posterior.

Instalar o Lindorm Agent Skill

O Lindorm Agent Skill fornece aos AI Agents o contexto necessário para chamar o lindorm-cli. Ele orienta o Agent a detectar automaticamente a instalação local do lindorm-cli, selecionar parâmetros apropriados e construir comandos.

Você pode baixar o Lindorm Agent Skill em: alibabacloud-lindorm-agent-skill

Após a instalação, o Agent pode chamar o lindorm-cli para acessar o mecanismo de tabela larga do Lindorm diretamente nas conversas. O Skill consolida as capacidades e parâmetros da CLI descritos abaixo, de modo que geralmente não é necessário inserir esses parâmetros manualmente.

Uso do Agent

Após instalar o Lindorm Agent Skill, basta descrever seus requisitos em linguagem natural. O Agent realiza automaticamente detecção, consultas, controles de segurança e injeção de credenciais sob a orientação do Skill.

Parâmetros de linha de comando

Ao iniciar o lindorm-cli em um terminal, você pode especificar os seguintes parâmetros de linha de comando:

Por que estou enfrentando tempos limite ou falhas de conexão?

Tempos limite ou falhas de conexão retornam erros como Failed to connect to <wide table endpoint> connection check failed ou connection timeout.

Possíveis causas e soluções estão listadas abaixo. Verifique-as em ordem:

Se nenhuma dessas soluções resolver seu problema, entre em contato com o suporte técnico do Lindorm (ID do DingTalk: s0s3eg3).