tencent cloud

TencentDB for TcaplusDB

Notas de versão
Introdução do produto
Visão geral do produto
Benefícios
Casos de uso
Arquitetura
Visão geral das regiões
Guia de aquisição
Preços do produto
Pagamento em atraso
Introdução
Conceitos básicos
Criação de cluster
Criação de grupo de tabelas
Criação de tabela
Acessar o TcaplusDB
Guia de operação
Gerenciamento de cluster e grupo de tabelas
Gerenciamento de tabela
Monitoramento e alarmes
Gerenciamento de acesso
Tag
Lista de tarefas
Cliente do TcaplusDB
Acesso pela ferramenta do cliente
Comandos da ferramenta do cliente
Tutoriais Práticas
Práticas recomendadas para design de estrutura de tabela
Práticas recomendadas para interação de banco de dados
Perguntas frequentes
Funcionalidades do banco de dados
Uso do banco de dados
Princípios do banco de dados
Service Agreement
Service Level Agreement
Terms of Service
Glossário
Fale conosco

Acesso pela ferramenta do cliente

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2024-12-04 10:23:03
Este documento descreve como usar a ferramenta de cliente tcaplus_client para acessar dados.
Todas as instruções DML devem usar a cláusula WHERE que deve conter pelo menos um campo de chave primária. Se houver várias chaves primárias, separe-as utilizando o and.

Acesso do TcaplusDB por meio da ferramenta de cliente

A tcaplus_client é uma ferramenta de cliente usada para acessar tabelas do TcaplusDB e pode ser obtida no endereço de download na tabela abaixo.
O pacote de lançamento da TcaplusServiceAPI para Linux x86_64 contém a ferramenta tcaplus_client para Linux de 64 bits.
Versão
Data de lançamento
Sistema operacional
Endereço de download do pacote
3.46.0.199033
28/12/2020
Linux x86_64
Nota
As operações a seguir precisam ser realizadas na instância do CVM no mesmo VPC e sub-rede em sua conta do Tencent Cloud que seu cluster do TcaplusDB.
Você pode baixar a TcaplusServiceAPI v3.36.0.192960 aqui.

Instalação do cliente

Após baixar o pacote de instalação TcaplusServiceAPI, você pode usar a ferramenta de upload para carregá-lo na instância do CVM no mesmo VPC e sub-rede do cluster do TcaplusDB.
1. Após o upload, execute o seguinte comando para descompactar o pacote de instalação:
tar -xf TcaplusPbApi3.46.0.199033.x86_64_release_20201210.tar.gz -C tcaplus
2. Após a descompactação, entre no diretório bin em tcaplus e conceda a permissão executável da ferramenta:
cd tcaplus/release/x86_64/bin
chmod +x tcaplus_client
3. Execute o comando ./tcaplus_client, e o sistema solicitará que você insira as informações de parâmetro requeridas para a conexão do banco de dados. Você pode inseri-las com base nas informações do cluster.
Nota
No exemplo abaixo, app_id indica o ID de acesso do cluster, App indica o cluster e zone indica o grupo de tabelas.
## ./tcaplus_client
--------------------------------------------------------------------------------
invalid parameters, please start the client as following:

./tcaplus_client -a app_id -z zone_id -s signature -d dir_server_url [-t table_name] [-l log_file.xml] [-T tdr_file.tdr] [-e execute_command]

the params in [] are optional, and their order is not important.

-a(--ap_id) APP ID

-z(--zone_id) ZONE ID

-s(--signature) PASSWORD

-d(--dir) dir server addr

-t(--table) table to add

-l(--log) log file name that must be client_log.xml, and log class name be client

-T(--tdr) tdr filename

-e(--execute) SQL command need to execute, the content should be in quotes.

e.g. ./tcaplus_client -a 2 -z 3 -s "FE6533875C8385C3" -d 172.25.40.181:9999 -T table_test.tdr -e "select a, b from table where key = 1;"
--------------------------------------------------------------------------------

Conexão ao TcaplusDB (cenário padrão)

Execute o comando correspondente para se conectar ao TcaplusDB. As informações do ponto de acesso estão descritas no exemplo abaixo, e a tabela tb_online foi criada no grupo de tabelas cujo ID é 1:
ID de acesso ao cluster: 2
Senha de conexão: test@Password1
Endereço privado: porta privada: 10.125.32.21:9999
ID do grupo de tabelas: 1
./tcaplus_client -a 2 -z 1 -s "test@Password1" -d 10.125.32.21:9999
+------------------------------------------------------------------------------+
| tcaplus_client x86_64 build at Wed Jan 18 22:08:38 CST 2017 |
| |
| Welcome! |
+------------------------------------------------------------------------------+

tcaplus>
Digite help após o prompt e você poderá ver informações detalhadas de ajuda. Digite > help para ver como usar os comandos relacionados.
tcaplus>help
--------------------------------------------------------------------------------
help: show usage of commands, example: "help select;".
show: get server status related information. executing "help show;" for details.
exit/quit: exit the client.
count: print record number in the database.

desc: print table field name and type.
select: query records from database.
insert: insert a new record into database.
replace: replace a record into the database.
update: update a record in the database.
delete: delete record(s) from database.

dump: dump records from database.
load: load records into the database.
--------------------------------------------------------------------------------

Descrição do parâmetro

Parâmetro
Descrição
Obrigatório
-a
ID de acesso
Sim
-z
ID do grupo de tabelas
Sim
-s
Senha do cluster
Sim
-d
IP e porta do cluster
Sim
-t
Nome da tabela
Não
-l
A configuração de saída dos arquivos de log. O nome do arquivo deve ser "client_log.xml".
Não
-T
Caminho do arquivo TDR
Não
-e
As instruções SQL a serem executadas
Não
-v
A versão a ser consultada
Não
<
Redirecione as instruções SQL ao cliente para executar.
Não

Conexão ao TcaplusDB (usando o TDR)

Para se conectar ao TcaplusDB via TDR, você deve usar os parâmetros de ativação do cliente para especificar o caminho do arquivo TDR. Você pode usar a ferramenta TDR para converter várias bases de metadados XML em formato binário. Se houver dependências entre vários arquivos XML, o arquivo XML dependente deve ser colocado na frente da lista de parâmetros.
Exemplo:
[root@test-PC0 /opt]# ./tcaplus_client -a 2 -z 3 -s C12901752D0D3347 -d 8.x.x.8:9999 -T /mnt/e/tdr/2.3.table_list.tdr

====== Welcome to use tcaplus_client, use "help" to show usage ======
tcaplus > exit

[root@test-PC0 /opt]# ./tcaplus_client -a 2 -z 3 -s C12901752D0D3347 -d 8.x.x.8:9999 -T /mnt/e/tdr/2.3.table_list.tdr -e "show tables;"
-------------------------------------------
| Table Name Type |
-------------------------------------------
| MTownRoleInfo GENERIC |
| table_generic GENERIC |
| table_generic_xiahuaxian GENERIC |
| table_list LIST |
| test_table GENERIC |
-------------------------------------------

Ferramenta TDR

Você precisa usar a ferramenta TDR para gerar um arquivo TDR, que é gerado principalmente pelo arquivo de definição de dados (estrutura TDR em formato XML). Baixe a ferramenta aqui.
Exemplo:
tdr -B -o ov_res.tdr ov_res.xml
# Converta bases de metadados XML em bancos de dados binários TDR.
tdr -C -o ov_res.c --old_xml_tagset ov_res.xml
# Converta bases de metadados em formato XML antigo (usando o conjunto de tags antigo) em arquivos .c.
tdr -H -O "include" --add_custom_prefix="m_" --no_type_prefix
# Converta bases de metadados XML para arquivos .h que são salvos no diretório "include".
# Adicione o prefixo "m_" ao nome do membro de struct/union, mas não adicione um prefixo de tipo.
tdr -G -m Pkg -x ATTR -o Pkg.xml net_protocol.xml
# Gere um arquivo de configuração em formato XML com pacote (um pacote de estrutura de dados customizado pelo usuário).
tdr -T -u prefixfile
# Exporte a tabela de prefixos do membro de dados usado ao gerar o arquivo .h para o arquivo "prefixfile".
tdr -A --indent-size=8 net_protocol.xml
# Gere arquivos de classe ActionScript3 de acordo com o protocolo descrito em "net_protocol.xml". Os arquivos de classe gerados são todos recuados com 8 espaços.
tdr -P --indent-size=8 net_protocol.xml
# Gere arquivos de classe C++ de acordo com o protocolo descrito em "net_protocol.xml". Os arquivos de classe gerados são todos recuados com 8 espaços.
tdr -S --indent-size=8 net_protocol.xml
# Gere arquivos de classe C# de acordo com o protocolo descrito em "net_protocol.xml". Os arquivos de classe gerados são todos recuados com 8 espaços.
tdr -E 0x83010404
# Consulte as informações de erro do código de erro 0x83010404.

Ferramenta tdr2xml

A ferramenta tdr2xml pode descompilar o arquivo de metadados binários em um arquivo de metadados XML. Baixe a ferramenta aqui.
Sintaxe:
tdr2xml [-o --out_file=FILE] [-h --help] [-v --version] DRFILE
A descrição de cada parâmetro é como segue:
-o, --out_file=FILE: especifique o nome do arquivo de saída. Valor padrão: a.xml.
-h, --help: saída de ajuda.
-v, --version: saída das informações da versão.
Exemplo:
tdr2xml –o net_cs.xml net_cs.tdr
Converta o arquivo de descrição de metadados em formato binário personalizado salvo no arquivo "net_cs.tdr" em um arquivo de descrição em formato XML.

Ajuda e Suporte

Esta página foi útil?

comentários