FireDAC na Prática

Capítulo 1 - O primeiro acesso ao banco

Uma tela vazia não ajuda a entender uma biblioteca de acesso a dados. Por isso, começaremos com um resultado visível: uma aplicação Delphi abrirá um banco, executará uma consulta e mostrará produtos em um TDBGrid. O percurso é curto, mas não será um ritual de arrastar componentes sem compreender o que acontece. Ao final do capítulo, você saberá qual objeto abre a sessão, qual executa a instrução SQL, por que existe um TDataSource e em que ponto uma biblioteca cliente pode impedir o programa de iniciar.

O leitor deste livro já conhece os fundamentos de Delphi: projetos, formulários, propriedades, eventos e Object Pascal. Não é necessário conhecer FireDAC. Se você já o utiliza há anos, encontrará desde o início uma segunda camada de leitura, dedicada ao ciclo de vida da conexão, ao registro do driver, à arquitetura dos binários e ao diagnóstico. Essa combinação será mantida ao longo da obra: primeiro construímos um modelo mental seguro; depois examinamos as decisões que aparecem quando o sistema cresce ou falha.

Os exemplos completos estão no repositório público do livro: <https://github.com/regyssilveira/firedac-na-pratica-exemplos>. O manifesto informa se cada exemplo está planejado, implementado, compilado, executado ou revisado. Essa distinção importa: um trecho plausível não equivale a um programa testado.

FireDAC é a camada de acesso a dados incluída no Delphi. Ela oferece componentes e classes para conectar aplicações a diferentes sistemas gerenciadores de bancos de dados (SGBDs), executar comandos, transportar registros, editar conjuntos de dados e tratar recursos específicos de cada banco. Seu objetivo não é transformar todos os bancos em um banco imaginário idêntico. Ele fornece uma interface consistente e, quando necessário, permite chegar às capacidades particulares de Firebird, PostgreSQL, SQLite, MySQL e outros produtos.

No primeiro exemplo, quatro objetos formam a rota principal:

1. TFDConnection guarda os parâmetros e representa a conexão usada pela aplicação; 2. TFDQuery contém a instrução SQL e apresenta seu resultado como um dataset; 3. TDataSource liga um dataset aos controles visuais orientados a dados; 4. TDBGrid desenha as linhas e acompanha o registro corrente.

Dataset é a abstração de um conjunto de registros navegável. Um TFDQuery é um dataset, mas também sabe preparar e executar SQL. TDataSource, por sua vez, não consulta o banco. Ele funciona como mediador entre um dataset e controles como TDBGrid, TDBEdit e TDBNavigator. Separar esses papéis permite trocar a consulta ou compartilhar o mesmo dataset sem ensinar cada controle visual a conversar com o SGBD.

Há outras peças no caminho. O FireDAC precisa localizar um driver compatível e, em muitos bancos, esse driver carrega uma biblioteca cliente nativa. O Firebird usa normalmente fbclient.dll; PostgreSQL usa libpq.dll; MySQL usa uma biblioteca cliente própria. SQLite pode ser ligado estaticamente ao executável, dispensando uma DLL separada. Portanto, “o banco está funcionando” e “a aplicação consegue carregar o cliente correto” são verificações diferentes.

Para o primeiro contato, usaremos SQLite porque ele reduz a preparação da máquina. Em seguida, abriremos o mesmo catálogo no Firebird 5, que será o banco principal do FireStore, a aplicação evolutiva do livro.

As setas também indicam uma ordem de diagnóstico. Se o driver não foi registrado, não há motivo para investigar o TDBGrid. Se a query abriu e o grid permaneceu vazio, a conexão física já deixou de ser a primeira suspeita. Localizar a fronteira reduz o número de hipóteses que precisam ser testadas.

Antes de escrever eventos, defina o que significa “abriu corretamente”:

1. o perfil foi carregado sem segredo embutido no executável; 2. o driver e a biblioteca cliente correspondem à plataforma do processo; 3. a conexão abriu e alcançou o banco esperado; 4. o schema possui a versão mínima exigida; 5. a consulta devolveu as colunas previstas; 6. o grid recebeu o dataset correto; 7. o fechamento liberou cursor e conexão sem ocultar falhas.

Esse contrato parece maior que o clique no botão, mas evita celebrar uma conexão com o arquivo errado ou uma tela alimentada por dados de design time. Cada item terá uma evidência simples no laboratório e ganhará profundidade nos capítulos seguintes.

Antes de montar a tela, prepare o catálogo de laboratório com o bootstrap disponível no repositório público. Leia o README do exemplo e execute migrate e smoke com o mesmo caminho absoluto de banco que