Todos os produtos
Search
Central de documentação

Performance Testing:Configure JDBC request parameters

Última atualização: Sep 06, 2026

Para testar o desempenho de operações de banco de dados como consultas, inserções, atualizações ou exclusões, use uma API JDBC no Performance Testing (PTS) para enviar instruções SQL diretamente ao banco de dados sob carga simulada. Este tópico descreve como configurar a conexão com o banco de dados, as credenciais e as definições de SQL para um cenário de teste JDBC.

O PTS oferece suporte aos seguintes tipos de banco de dados: MySQL, PostgreSQL, MariaDB e SQL Server.

Pré-requisitos

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

  • Acesso ao console do PTS

  • O endpoint, a porta e o nome do banco de dados da instância de destino

  • Uma conta de banco de dados com as permissões necessárias para executar suas instruções SQL

Crie um cenário de teste JDBC

  1. Faça login no console do PTS.

  2. No painel de navegação à esquerda, escolha Performance Test > Create Scenario e clique em PTS.

  3. Exclua a API HTTP padrão e adicione uma API JDBC.

  4. Configure os parâmetros básicos da solicitação. Para obter descrições detalhadas, consulte a tabela de parâmetros abaixo.

    A tabela a seguir descreve os parâmetros.

    Parâmetro

    Descrição

    Exemplo

    API Name

    Nome que identifica a definição de service da API. Comprimento máximo: 20 caracteres.

    API-1

    Database Type

    Tipo de banco de dados para conexão. Valores válidos: MySQL, PostgreSQL, MariaDB e SQL Server.

    MySQL

    Database URL

    String de conexão do banco de dados no formato <host>:<port>/<database_name>. Consulte Formato da Database URL abaixo.

    rm-bp1xxxxxxx.mysql.rds.aliyuncs.com:3306/mydb

    Username

    Nome de usuário para autenticação no banco de dados.

    test_user

    Password

    Senha para autenticação no banco de dados.

    your_password

    SQL

    Instrução SQL a ser executada. Deve começar com SELECT, UPDATE, INSERT ou DELETE (não diferencia maiúsculas de minúsculas). Consulte Diretrizes para instruções SQL abaixo.

    select * from test_users;

    Timeout Duration

    Tempo máximo, em milissegundos, que o PTS aguarda uma resposta do servidor de banco de dados.

    5000

    limit

    Número máximo de linhas a serem lidas do conjunto de resultados. Aplica-se apenas a instruções SELECT. Valor máximo: 1.000.000.

    1000

Formato da Database URL

O campo Database URL combina o endereço do host, o número da porta e o nome do banco de dados em uma única string de conexão. Use o formato correspondente ao seu tipo de banco de dados:

Tipo de banco de dados

Porta padrão

URL de exemplo

MySQL

3306

rm-bp1xxxxxxx.mysql.rds.aliyuncs.com:3306/mydb

PostgreSQL

5432

pgm-bp1xxxxxxx.pg.rds.aliyuncs.com:5432/mydb

MariaDB

3306

rm-bp1xxxxxxx.mariadb.rds.aliyuncs.com:3306/mydb

SQL Server

1433

rm-bp1xxxxxxx.sqlserver.rds.aliyuncs.com:1433/mydb

Substitua os espaços reservados pelos valores reais:

Espaço reservado

Descrição

Exemplo

<host>

Endpoint ou endereço IP da instância de banco de dados

rm-bp1xxxxxxx.mysql.rds.aliyuncs.com

<port>

Número da porta (use a porta padrão ou uma porta personalizada, se configurada)

3306

<database_name>

Nome do banco de dados de destino

mydb

Nota: Os números de porta mostrados acima são os padrões. Se o banco de dados usar uma porta personalizada, substitua o número da porta adequadamente.

Diretrizes para instruções SQL

O campo SQL aceita instruções que começam com uma das seguintes palavras-chave (não diferencia maiúsculas de minúsculas):

Palavra-chave

Operação

Exemplo

SELECT

Consultar dados

select * from test_users where status = 'active';

INSERT

Adicionar registros

insert into test_users (name, email) values ('test', 'test@example.com');

UPDATE

Modificar registros

update test_users set email = 'new@example.com' where id = 1;

DELETE

Remover registros

delete from test_users where id = 1;

Considerações sobre testes de carga

  • Defina o parâmetro limit para instruções SELECT. Conjuntos de resultados grandes durante testes de carga consomem memória e podem distorcer as métricas de desempenho. Defina o limit com um valor adequado ao cenário de teste.

  • Use instruções SQL realistas. Escreva instruções que reflitam as consultas reais de produção, incluindo cláusulas WHERE e joins, para obter dados de desempenho significativos.

  • Monitore os valores de timeout. Se as instruções SQL envolverem tabelas grandes ou joins pesados, aumente a Timeout Duration para evitar falhas falsas durante os testes de carga.