Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Utilização de excerpt-include da nomenclatura do produto
Extrair
hiddentrue

DBAccessCfg

O que é o

DBACCESSCFG

Inclusão de trecho
DBAccessCfg
DBAccessCfg
nopaneltrue

O

Inclusão de trecho
DBAccessCfg
DBAccessCfg
nopaneltrue

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 

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.

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 

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.

O DBACCESSCFG

Inclusão de trecho
DBAccessCfg
DBAccessCfg
nopaneltrue
não exige conexão com o 
Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
, apenas que esteja na mesma pasta que o arquivo
Inclusão de trecho
dbaccess.ini
dbaccess.ini
nopaneltrue
.

A ferramenta irá gravar as informações no arquivo

Inclusão de trecho
dbaccess.ini
dbaccess.ini
nopaneltrue
, que utilizará essas informações ao iniciar e/ou conectar com um SGBD.

Nota
titleObservação
  • A ferramenta está disponível a partir da versão 18.2.1.0 do 
    Inclusão de trecho
    dbaccess
    dbaccess
    nopaneltrue
    .
  • Inclusão de trecho
    DBAccessCfg
    DBAccessCfg
    nopaneltrue
     O DBACCESSCFG não testa a conexão criada.

Como utilizar

Ao executar o binário do DBACCESSCFG do 

Inclusão de trecho
DBAccessCfg
DBAccessCfg
nopaneltrue
sem parâmetro algum, é possível visualizar quais são os parâmetros esperados pela ferramenta:

Quando o DBACCESSCFG

Inclusão de trecho
DBAccessCfg
DBAccessCfg
nopaneltrue
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

Inclusão de trecho
dbaccess.ini
dbaccess.ini
nopaneltrue
.

-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 
    Inclusão de trecho
    dbaccess
    dbaccess
    nopaneltrue
     que fará a conexão.

-astring

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.

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
    Inclusão de trecho
    dbaccess
    dbaccess
    nopaneltrue
    .
-gstring

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

Inclusão de trecho
dbaccess.ini
dbaccess.ini
nopaneltrue
.

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.

Bloco de código
titleComando
dbaccesscfg -d MSSQL -a P12PRODUCAO -u protheus -p protheuspwd
Bloco de código
titleArquivo
[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.

Bloco de código
titleComando
dbaccesscfg -d MSSQL -a P12PRODUCAO -u protheus -p protheuspwd -c "/usr/lib64/libodbc.so"
Bloco de código
titleArquivo
[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.

Bloco de código
titleComando
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"
Bloco de código
titleArquivo
[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.

Bloco de código
titleComando
dbaccesscfg -d ORACLE -a P12PRODUCAO -u protheus -p protheuspwd -o "OracleODBC=1"
Bloco de código
titleArquivo
[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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.

Bloco de código
titleComando
dbaccesscfg -d POSTGRES -a P12PRODUCAO -u protheus -p protheuspwd -g "LicenseServer=192.168.0.100;LicensePort=5555"
Bloco de código
titleArquivo
[GENERAL]
LicenseServer=192.168.0.100
LicensePort=5555

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

[POSTGRES]
environments=P12PRODUCAO