O que é o DBACCESSCFG
O DBACCESSCFG é uma ferramenta de linha de comando multiplataforma (Windows e Linux, 32 e 64 bits) que permite configurar conexões 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 é apresentado a mensagem "Ini file successfully generated".
Parâmetros obrigatórios
-u - Nome do usuário
Neste parâmetro deve ser informado o nome do usuário da conexão com o SGBD. O nome do usuário deve ser informado de forma literal e sem aspas duplas ao redor.
-p - Senha do usuário
Neste parâmetro deve ser informado a senha do usuário da conexão com o SGBD. A senha deve ser informada de forma literal, sem aspas duplas ao redor, e será criptografada ao gravar no arquivo dbaccess.ini.
-d - SGBD
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)
Verifique sempre se existe suporte ao SGBD pretendido no TOTVS | DBAccess que fará a conexão.
-a - Alias
Neste parâmetro deve ser informado o nome da conexão que será criada no TOTVS | DBAccess.
Esse 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).
Parâmetros opcionais
Os valores que serão passados nos parâmetros opcionais devem ser colocados entre aspas duplas ( " " ).
-o - Opções do SGBD
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.
-c - Client Library
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).
Deve ser informado o caminho completo do arquivo na máquina do TOTVS | DBAccess.
-g - Opções gerais
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.
Caso a chave passada seja password ou guestpassword, o valor da chave será criptografado ao gravar.
Exemplo de utilização
Criação de uma conexão com o MS SQL Server Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.
Comandodbaccesscfg -u protheus -p protheuspwd -d MSSQL -a P12PRODUCAO
Arquivo[MSSQL/P12PRODUCAO] user=protheus password=Žïô¸½½°Ÿì Tablespace= IndexSpace= [MSSQL] environments=P12PRODUCAO
Criação de uma conexão com o MS SQL Server Linux chamada P12PRODUCAO, usuário protheus, senha protheuspwd, usando unixODBC em /usr/lib64/libodbc.so.
Comandodbaccesscfg -u protheus -p protheuspwd -d MSSQL -a P12PRODUCAO -c "/usr/lib64/libodbc.so"
Arquivo[MSSQL/P12PRODUCAO] user=protheus password=Žïô¸½½°Ÿì Tablespace= IndexSpace= [MSSQL] environments=P12PRODUCAO ClientLibrary=/usr/lib64/libodbc.so
Criação de uma 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.
Comandodbaccesscfg -u protheus -p protheuspwd -d ORACLE -a P12PRODUCAO -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
Criação de uma conexão Oracle ODBC Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.
Comandodbaccesscfg -u protheus -p protheuspwd -d ORACLE -a P12PRODUCAO -o "OracleODBC=1"
Arquivo[ORACLE/P12PRODUCAO] user=protheus password=Žïô¸½½°Ÿì Tablespace= IndexSpace= OracleODBC=1 [ORACLE] environments=P12PRODUCAO
Criação de uma 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.
Comandodbaccesscfg -u protheus -p protheuspwd -d POSTGRES -a P12PRODUCAO -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