Configurando

Dependendo do que você vai fazer com o libgda, pode ser que você tenha que mergulhar no código, mas não tenha medo, ele foi teito com facilidade de uso em mente.

Configurando para desenvolvimento

Se você quer desenvolver aplicação usando libgda, você deve instalar o pacote libgda-dev[el] se você está usando um sistema baseado em Debian ou RedHat. Se você mesmo compilou o programa, arquivos necessários para desenvolvimento já estão instalados no seu sistema.

O único coisa você que você precisa fazer para ver se tudo está instalado, é verificar se as bibliotecas e programas do libgda são vistas pelo sistema. Isto é, fazer com que o diretório bin/ do libgda esteja na variável de ambiente PATH, tão bem como o diretório lib/ esteja em LD_LIBRARY_PATH (ou no arquivo /etc/ld.so.conf).

Configuração para acessar um banco de dados

Se você quer acessar uma fonte de dados através de um provedor GDA, você precisa primeniramente ter acesso a este provedor e, mais importante, este provedor deve ter acesso a fonte de dados específica. Tenha então, antes de tudo, seu banco de dados rodando. Para isso, você deve pesquisar como fazê-lo na documentação do seu banco de dados ou na seção específica a este provedor na documentação do libgda.

Uma vez que tenha seu provedor GDA instalado, seja ele localmente ou em outra máquina via rede, você precisa configurar seu sistema para ter acesso ao provedor. Se você está fazendo um instalação local, uma vez que vocêtenha instalado o provedor GDA (compilando ou instalando através de um pacote RPM ou Debia, por exemplo), o provedor já está vizível na sua máquina. Isto é porque o pacote com o provedor fornece um arquivo .oafinfo na qual ele especifíca o lugar onde este está instalado e outras informações sobre si mesmo.

Se, pelo contrário, seu provedor está em uma outra máquina, você terá que criar um arquivo .oafinfo. Para isso, verifique a documentação de instalação do OAF.

Então, o próximo passo é configurar as fontes de dados que você quer disponíveis no seu sistema. Para fazer isso, você deve, por enquanto, usar o GNOME-DB, que é um 'frontend' do libgda do projeto GNOME. [1]

Ferramentas tipo linha-de-comando serão fornecidas com o libgda para fazer uso do Libgda atualmente, você precisa saber quais informações são necessárias para se configurar um fonte de dados.

Um dos problemas que GDA resolve é o processo de dar nomes as fontes de dados. Cada sistema de banco de dados tem a sua própria maneira de definir nomes para as fontes de dados. Por exemplo, MySQL usa o hostname, número da porta, e nome do banco de dados. Outros bancos de dados, como Solid, usam apenas o hostname e número da porta. Não há suporte há múltiplos bancos de dados por servidor. Já que o cliente não precisa de todos estes detalhes, a configuração do libgda define todas as informações de tal fonte de dados, de maneira que o servidor (de banco de dados) correto possa ser contactado. Esta informação é obtida pela biblioteca cliente e enviada ao provedor, que então, examina a informação e decide qual banco de dados o cliente deve se conectar. A informação armazenada para cada fonte de dados é a seguinte:
	       [vendas]
		  Provider=gda-mysql
		  DSN=DATABASE=teste;HOST=localhost;PORT=1111
		  Description=Banco de dados MySQL para testes em modo nativo
		  Configurator=None
	     

O provedor para este banco de dados é o gda-mysql. O valor deste campo é usado como ID do objeto para ativação por parte do OAF. Este campo é o mais importante. O valor deste campor é a string enviada ao provedor para que ela saiba que fonte de dados acessar. Como este valor é interpretado por um determinado provedor é descrito na seção relacionada ao mesmo. Este campo é uma breve descrição da fonte de dados. Ele existe por pura conveniência e não tem nenhuma outra função.

Informação específica a um Provedor

Esta seção traz informação específica a cada tipo de provedor disponível para libgda.

Notes

[1]

Seria um boa idéia acrescentar uma ferramento tipo linha-de-comando para controlar a configuração, como atualmente, usando GConf, não é uma questão simples como editar um arquivo de texto, como era antes, com a função gnome_config. A API para fazer isso já está disponível na biblioteca libgda-common, então isso seria muito fácil de ser feito. Voluntários?