DBAccessCfg

O que é o

O é uma ferramenta de linha de comando multiplataforma (Windows e Linux, 32 e 64 bits) que permite configurar ambientes de conexão e outros parâmetros do .

Por ser uma ferramenta de linha de comando, ela não depende de interface gráfica e permite a automatização do processo de configuração do .

O  não exige conexão com o , apenas que esteja na mesma pasta que o arquivo .

A ferramenta irá gravar as informações no arquivo , que utilizará essas informações ao iniciar e/ou conectar com um SGBD.

  • A ferramenta está disponível a partir da versão 18.2.1.0 do .
  • O  não testa a conexão criada.

Como utilizar

Ao executar o binário do  sem parâmetro algum, é possível visualizar quais são os parâmetros esperados pela ferramenta:

Quando o  consegue gravar o conteúdo com sucesso é apresentada a mensagem "Ini file successfully generated".

Parâmetros

ParâmetroTipoDescriçãoObrigatórioObservação
-ustringNeste parâmetro deve ser informado o nome do usuário da conexão com o SGBD.SimO nome do usuário deve ser informado de forma literal e sem aspas duplas ao redor.
-pstring

Neste parâmetro deve ser informado a senha do usuário da conexão com o SGBD.

Sim

A senha deve ser informada de forma literal, sem aspas duplas ao redor, e será criptografada ao gravar no arquivo .

-d

string

Neste parâmetro deve ser informado qual é o SGBD da conexão que está sendo configurada.

Os valores válidos para esse parâmetros são:

  • MSSQL (Microsoft SQL Server)
  • ORACLE
  • POSTGRES (PostgreSQL)
  • INFORMIX
  • DB2
  • OPENEDGE (Apenas Windows)
  • ODBC (Conexão ODBC Genérica)
Sim
  • O valor deve ser informado sem aspas duplas ao redor.
  • Verifique sempre se existe suporte ao SGBD pretendido no  que fará a conexão.


-astring

Neste parâmetro deve ser informado o nome da conexão que será criada no .

SimEsse nome deve ser o mesmo nome configurado na janela de ODBC (Windows), ou no arquivo odbc.ini (Linux), ou no arquivo tnsnames.ora (Oracle OCI).
-ostring

Neste parâmetro são informadas as chaves e valores extras que vão na seção da conexão criada.

O padrão do valor passado nesse parâmetro é "Chave=Valor".

Caso queira passar mais de uma chave, deve-se colocar ponto e vírgula ( ; ) antes do nome da próxima chave.

NãoOs valores passados devem ser colocados entre aspas duplas ( " " ).
-cstring

Neste parâmetro é informado o nome da biblioteca que será carregada para realizar as operações com um SGBD.

Esse parâmetro é utilizado em Windows para SGBD Oracle com conexão por OCI e em Linux, para passar o caminho da unixODBC (conexões ODBC) ou da OCI (conexão Oracle por OCI).


Não
  • Os valores passados devem ser colocados entre aspas duplas ( " " ).
  • Deve ser informado o caminho completo do arquivo na máquina do .
-gstring

Neste parâmetro são informadas as chaves e valores que vão na seção General do arquivo .

O padrão do valor passado nesse parâmetro é "Chave=Valor".

Caso queira passar mais de uma chave, deve-se colocar ponto e vírgula ( ; ) antes do nome da próxima chave.

Não
  • Os valores passados devem ser colocados entre aspas duplas ( " " ).
  • Caso a chave passada seja password ou guestpassword, o valor da chave será criptografado ao gravar.



Exemplos de utilização

Microsoft SQL Server

Criação de um ambiente de conexão com o MS SQL Server Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.

dbaccesscfg -d MSSQL -a P12PRODUCAO -u protheus -p protheuspwd
[MSSQL/P12PRODUCAO]
user=protheus
password=Žïô¸½½°Ÿì
Tablespace=
IndexSpace=

[MSSQL]
environments=P12PRODUCAO


Microsoft SQL Server com Client Library

Criação de um ambiente de conexão com o MS SQL Server Linux chamada P12PRODUCAO, usuário protheus, senha protheuspwd, usando unixODBC em /usr/lib64/libodbc.so.

dbaccesscfg -d MSSQL -a P12PRODUCAO -u protheus -p protheuspwd -c "/usr/lib64/libodbc.so"
[MSSQL/P12PRODUCAO]
user=protheus
password=Žïô¸½½°Ÿì
Tablespace=
IndexSpace=

[MSSQL]
environments=P12PRODUCAO
ClientLibrary=/usr/lib64/libodbc.so


Oracle com client OCI e definição de TableSpace e IndexSpace

Criação de um ambiente de conexão Oracle OCI Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd, OCI em c:\oracle\x64\instantclient_12_2\oci.dll, TableSpace com valor HOMOLOG_DATA e IndexSpace com valor HOMOLOG_IDX.

dbaccesscfg -d ORACLE -a P12PRODUCAO -u protheus -p protheuspwd -c "c:\oracle\x64\instantclient_12_2\oci.dll" -o "TableSpace=HOMOLOG_DATA;IndexSpace=HOMOLOG_IDX"
[ORACLE/P12PRODUCAO]
user=protheus
password=Žïô¸½½°Ÿì
Tablespace=HOMOLOG_DATA
IndexSpace=HOMOLOG_IDX

[ORACLE]
environments=P12PRODUCAO
ClientLibrary=c:\oracle\x64\instantclient_12_2\oci.dll


Oracle com client ODBC

Criação de um ambiente de conexão Oracle ODBC Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.

dbaccesscfg -d ORACLE -a P12PRODUCAO -u protheus -p protheuspwd -o "OracleODBC=1"
[ORACLE/P12PRODUCAO]
user=protheus
password=Žïô¸½½°Ÿì
Tablespace=
IndexSpace=
OracleODBC=1

[ORACLE]
environments=P12PRODUCAO


PostgreSQL e License Server

Criação de um ambiente de conexão PostgreSQL Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd, e configurando IP e porta do License Server que será utilizado pelo .

dbaccesscfg -d POSTGRES -a P12PRODUCAO -u protheus -p protheuspwd -g "LicenseServer=192.168.0.100;LicensePort=5555"
[GENERAL]
LicenseServer=192.168.0.100
LicensePort=5555

[POSTGRES/P12PRODUCAO]
user=protheus
password=Žïô¸½½°Ÿì
Tablespace=
IndexSpace=

[POSTGRES]
environments=P12PRODUCAO



Veja também