Á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 conexões 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
.

Inclusão de trecho
DBAccessCfg
DBAccessCfg
nopaneltrue
O DBACCESSCFG 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
    .
  • O DBACCESSCFG
    Inclusão de trecho
    DBAccessCfg
    DBAccessCfg
    nopaneltrue
     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:

Image RemovedImage Added

Quando o DBACCESSCFG

Inclusão de trecho
DBAccessCfg
DBAccessCfg
nopaneltrue
consegue gravar o conteúdo com sucesso é apresentado apresentada a mensagem "Ini file successfully generated".

Image RemovedImage Added

Parâmetros

obrigatórios

ParâmetroTipoDescriçãoObrigatórioObservação
-u
- Nome do usuário
stringNeste 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.
-p
- Senha do usuário
string

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

- SGBD

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)
note
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.

-a
- Alias
string

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).

Parâmetros opcionais

note

Os valores que serão passados nos parâmetros opcionais devem ser colocados entre aspas duplas ( " " ).

-ostring
-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
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
    .
-g
- Opções gerais
string

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.

note

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.



Exemplo

Exemplos de utilização

Microsoft SQL Server

Criação de um ambiente de

uma

conexão com o MS SQL Server Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.

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

uma

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 -
u
d 
protheus
MSSQL -
p
a 
protheuspwd
P12PRODUCAO -
d
u 
MSSQL
protheus -
a
p 
P12PRODUCAO
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

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.

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

uma

conexão Oracle ODBC Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.

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

uma

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 -
u
d 
protheus
POSTGRES -
p
a 
protheuspwd
P12PRODUCAO -
d
u 
POSTGRES
protheus -
a
p 
P12PRODUCAO
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