Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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 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 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 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:

Image RemovedImage Added

Quando o DBACCESSCFG 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

NotaOs valores que serão passados nos parâmetros opcionais devem ser colocados entre aspas duplas ( " "
).
-o
- Opções do SGBD
string

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ão
-c - Client Library
Os 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

  • 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
    
    
  • 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
    
    
  • 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
    
    
  • 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
    
    
  • 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