TOTVSTEC

Árvore de páginas

O que é o DBAccessCfg

O DBAccessCfg é 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 TOTVS | DBAccess.

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 TOTVS | DBAccess.

O DBAccessCfg não exige conexão com o TOTVS | DBAccess, apenas que esteja na mesma pasta que o arquivo dbaccess.ini.

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

Observação

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

Como utilizar

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

Quando o DBAccessCfg 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 dbaccess.ini.

-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 TOTVS | DBAccess que fará a conexão.


-astring

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

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 TOTVS | DBAccess.
-gstring

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

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.

Comando
dbaccesscfg -d MSSQL -a P12PRODUCAO -u protheus -p protheuspwd
Arquivo
[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.

Comando
dbaccesscfg -d MSSQL -a P12PRODUCAO -u protheus -p protheuspwd -c "/usr/lib64/libodbc.so"
Arquivo
[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.

Comando
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"
Arquivo
[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.

Comando
dbaccesscfg -d ORACLE -a P12PRODUCAO -u protheus -p protheuspwd -o "OracleODBC=1"
Arquivo
[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 TOTVS | DBAccess.

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

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

[POSTGRES]
environments=P12PRODUCAO



Veja também

  • Sem rótulos