Documentação / O IDE

Banco de dados

Cliente de banco de dados para Oracle, SQL Server, MySQL, MariaDB, MongoDB e SQLite, com console SQL e PL/SQL, planos de execução e navegação código ↔ banco.

O Yuli traz um cliente de banco de dados integrado. Abra-o pelo trilho esquerdo, botão Banco de dados (Alt+Shift+D).

Bancos compatíveis

Banco Requisito
Oracle Oracle Instant Client 19c ou posterior (Basic ou Basic Light) no PATH.
SQL Server Nada adicional.
MySQL Nada adicional.
MariaDB Nada adicional.
MongoDB Nada adicional.
SQLite Nada adicional.

O PostgreSQL ainda não é suportado.

Se o Oracle Instant Client estiver faltando, o Yuli mostra “Para conectar ao Oracle é necessário o Oracle Instant Client” com os passos para o seu sistema.

Criar uma conexão

  1. No painel Banco de dados, clique em Nova conexão.
  2. Escolha o banco e preencha os dados do servidor.
  3. Atribua um Ambiente (por exemplo, desenvolvimento ou testes).
  4. Marque Somente leitura se não quiser permitir gravações.
  5. Defina o Acesso do agente. Veja Banco de dados seguro.
  6. Clique em Testar conexão e salve.

A senha é guardada no chaveiro do sistema, nunca no projeto. Para servidores internos com certificado próprio, marque Confiar no certificado do servidor.

Explorador de esquemas

  • Tabelas, views, pacotes, funções, procedimentos e triggers.
  • Código-fonte de pacotes, views, funções e triggers.
  • Dependências PL/SQL e o seu fluxo.
  • Diagrama ER das tabelas.

Console SQL e PL/SQL

Abra um em Ferramentas → Nova consulta SQL (Ctrl+Alt+Q).

  • Autocompletar com o esquema real.
  • Blocos PL/SQL.
  • Plano de execução em forma de árvore, com avisos.
  • Resultados completos exportáveis para CSV ou Excel.

O console tem um limite de 500 linhas por padrão, ampliável até 100.000.

Código ↔ banco de dados

  • Ctrl+Alt+J vai do código ao objeto do banco de dados: função, pacote ou tabela.
  • O diagrama Código ↔ BD, em Diagramas, mostra quais DAOs e repositórios chamam quais funções, pacotes e tabelas.
  • Nos mapeamentos do Hibernate, o Yuli valida tabelas e colunas com a conexão.

Depurar PL/SQL

O Yuli depura código PL/SQL do Oracle com DBMS_DEBUG. Requer o privilégio DEBUG CONNECT SESSION e objetos compilados com COMPILE DEBUG. Veja Executar e depurar.

Migrações

O botão Migrações gerencia os scripts de migração do projeto. Para o agente, as migrações e os arquivos .sql elevam o nível de risco e pedem confirmação.

Com o agente

O agente usa o banco de dados por meio das ferramentas do Yuli, nunca de clientes de linha de comando:

Ferramenta O que faz Requer
yuli_db_schema Lê o esquema e o código-fonte. Só consultas
yuli_db_query Executa um SELECT com limite de linhas. Só consultas
yuli_db_execute Executa instruções que gravam. Superpermissões e a sua aprovação

Peça coisas como:

  • “Por que esta função retorna NULL com estes parâmetros?”
  • “Explique o que o procedimento PKG_ORDERS.CLOSE grava.”
  • “Alinhe a entidade Order com as colunas reais da tabela.”