Configuração DBLink

Configurações do BD_Link
Nesta capítulo descritas as configurações a serem realizadas de
acordo com os seguintes procedimentos: para a configuração do
"Heterogeneous Services" no Oracle XE. Este procedimento deverá
ser realizado uma única vez.

Todas as ocorrências de ORACLE_HOME_DIR nos comandos

e instruções contidos no passo a passo a seguir devem ser
substituídas antes do seu uso pelo valor real no servidor.
ORACLE_HOME_DIR representa o diretório onde o software do
Oracle foi instalado no servidor. Para enfatizar essa necessidade,
ORACLE_HOME_DIR será sempre grifado em negrito.
Assim, por exemplo, se o documento consta para editar o
tnsnames.ora localizado em ORACLE_HOME_DIR\network\admin,
e o diretório ORACLE_HOME_DIR no servidor é
C:\oraclexe\app\oracle\product\10.2.0\server (o padrão no caso
do Oracle 10g XE) então o arquivo estará em
C:\oraclexe\app\oracle\product\10.2.0\server\network\admin .
Padrões para ORACLE_HOME do Oracle
 10GXE: C:\oraclexe\app\oracle\product\10.2.0\server
 10G : C:\oracle\product\10.2.0
 9i : C:\oracle\ora92
 8i: C:\oracle\ora81
Para a configuração do DB_LINK, será necessária a realização dos
seguintes procedimentos:
1. Criar uma fonte de dados ODBC do sistema (system data
source, SYSTEM DSN) para o SQL Server:
1.1. Para a criação da fonte de dados ODBC, o usuário deverá
utilizar a ferramenta “Painel de Controle”, de acordo com a
imagem abaixo:

Manual do Usuário Standard Template Configuração DBLink  291

 Figura 9- Caminho para criação da Fonte de Dados

Em seguida, o usuário deverá acionar o ícone , como

pode ser visualizado na figura abaixo:

292  Configuração DBLink Manual do Usuário Standard Template

 Figura 10 - Caminho para criação da Fonte de Dados

Quando o usuário acessar a tela Ferramentas Administrativas,

deverá realizar um duplo clique no ícone .

Figura 11 - Caminho para criação da Fonte de Dados

Sendo assim, será apresentada a tela “Administrador de Fontes de

Dados ODBC”, e o usuário deverá acessar a Aba Fontes de Dados
do Sistema, para iniciar a criação da fonte de dados.

Manual do Usuário Standard Template Configuração DBLink  293

 Figura 12 - Caminho para criação da Fonte de Dados

Abaixo serão exibidos os botões da tela que darão acesso as suas

funcionalidades:
Na Aba Fonte de Dados do Sistema, o usuário deverá acionar o
botão .

294  Configuração DBLink Manual do Usuário Standard Template

 Figura 13 - Caminho para criação da Fonte de Dados

Abaixo serão exibidos os botões da tela que darão acesso as suas

funcionalidades:

Após o clique no botão , será apresentada a tela “Criar

nova fonte de dados”.

Figura 14 - Caminho para criação da Fonte de Dados

Manual do Usuário Standard Template Configuração DBLink  295
 Será necessária a seleção do “driver” “SQL Server”, e
posteriormente acionar o botão .
Assim, será apresentada a tela para o cadastro da fonte de dados,
de acordo com a figura abaixo, onde:
O usuário deverá informar o Nome da nova fonte de dados
“MSSQLSVR”.
A descrição da fonte de dados é Livre. Na figura abaixo foi
digitado o Banco do Cardio.
No campo Servidor o usuário deverá selecionar o nome do
servidor do SQL Server.
Esse procedimento deve ser realizado para cada uma
das máquinas: teste e produção.

Figura 15- Tela para o cadastro da Fonte de Dados

Abaixo serão exibidos os botões da tela que darão acesso as suas

funcionalidades:
Para dar continuidade ao cadastro da fonte de dados, o usuário
deverá acionar o botão .

296  Configuração DBLink Manual do Usuário Standard Template

 Na tela abaixo, será necessário assinalar a opção “Com
autenticação do SQL Server usando ident. de logon e senha
inseridos pelo usuário”, informar a identificação de conexão e
senha do usuário no Banco de Dados do Cardio, e em
seguida, acionar o botão .

Figura 16 - Tela para criar uma nova Fonte de Dados

Na tela seguinte (abaixo), deverá ser assinalada a opção “Alterar o

banco de dados padrão para:”.

Figura 17 - Tela para criar uma nova Fonte de Dados

Manual do Usuário Standard Template Configuração DBLink  297

 E novamente acionar o botão .
Será apresentada uma nova tela, conforme figura abaixo, na qual o
usuário deverá manter a configuração apresentada.

Figura 18 - Tela para criar uma nova Fonte de Dados

Abaixo serão exibidos os botões da tela que darão acesso as suas

funcionalidades:

O usuário deverá acionar o botão para finalizar o

cadastro da fonte de dados.

Após clicar no botão será exibida a tela abaixo

referente à conclusão da instalação do ODBC.

298  Configuração DBLink Manual do Usuário Standard Template

 Figura 19 - Tela conclusão da instalação ODBC

Abaixo serão exibidos os botões da tela que darão acesso as suas

funcionalidades:
O usuário deverá clicar no botão para finalizar esta etapa.

2. No servidor Oracle, conectar-se como SYS no SQL Plus e

digitar os comandos seguintes para habilitar o serviço no
banco de dados Oracle:

Iniciar -> Executar

Manual do Usuário Standard Template Configuração DBLink  299

 Figura 20 - Tela do caminho para conectar-se no SQL Plus

Após executar o caminho, o usuário deverá digitar o nome do programa: sqlplus

/nolog.

Figura 21 - Tela Executar

Abaixo serão exibidos os botões da tela que darão acesso as suas

funcionalidades:
O usuário deverá clicar no botão e será apresentada a
tela do DOS, apresentado o diretório do SQL. Nesta tela, o usuário
deverá executar o comando:

300  Configuração DBLink Manual do Usuário Standard Template

 conn sys/senha_do_sys@piramide as sysdba

Figura 22 - Tela do DOS

Após conectado no banco de dados, deverá executar o comando:

@ORACLE_HOME_DIR\RDBMS\ADMIN\caths.sql

O script caths.sql habilita o serviço heterogêneo no Oracle,

é ele quem fornece a comunicação entre os bancos de dados
Oracle e SQL Server. Caso o comando
@ORACLE_HOME_DIR\RDBMS\ADMIN\caths.sql não seja
executado, não será fornecida essa comunicação.

3. Configurar o tnsnames.ora do servidor no qual o DBLINK será

criado. Deve-se adicionar linhas referentes ao dblink deixando
as demais inalteradas.
3.1. Banco Pirâmide Produção:
Localização do arquivo:
ORACLE_HOME_DIR\network\admin\tnsnames.ora
Seguem abaixo as linhas a serem adicionadas. Lembrando que
é para adicioná-las no final de todo o texto do bloco de
notas do TSName. Depois de adicioná-las, ir ao Menu
ARQUIVO do bloco de notas do TSName e salvar a
alteração sobrepondo o arquivo existente:
DBL_PIR_CARDIO =
(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = <nome ou IP do servidor>)(PORT = 1521) )

)
(CONNECT_DATA =

Manual do Usuário Standard Template Configuração DBLink  301

 (SID = sqlsvrdb)
)
(HS = OK)
)

3.2. Banco Pirâmide Teste:

Localização do arquivo:
ORACLE_HOME_DIR\network\admin\tnsnames.ora linhas a serem
adicionadas:
DBL_PIR_CARDIO =
(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = <nome ou IP do servidor>)(PORT = 1521) )

)
(CONNECT_DATA =
(SID = sqlsvdbt)
)
(HS = OK)
)

4. Configurar o listener adicionando apenas o conteúdo marcado

em negrito (do trecho abaixo) à seção correspondente do
arquivo listener.ora original (não esquecer de substituir
também o valor do ORACLE_HOME_DIR).
4.1. Banco Pirâmide Produção

Localização do arquivo:
ORACLE_HOME_DIR\network\admin\listener.ora

SID_LIST_LISTENER =
(SID_LIST =
(SID_DESC =
(SID_NAME = PLSExtProc)
(ORACLE_HOME = ORACLE_HOME_DIR)
(PROGRAM = extproc)
)
(SID_DESC =

(SID_NAME = sqlsvrdb)

302  Configuração DBLink Manual do Usuário Standard Template

 (ORACLE_HOME = ORACLE_HOME_DIR)
(PROGRAM = hsodbc)
)
)

4.2. Banco Pirâmide Teste

Localização do arquivo:
ORACLE_HOME_DIR\network\admin\listener.ora

SID_LIST_LISTENER =
(SID_LIST =
(SID_DESC =
(SID_NAME = PLSExtProc)
(ORACLE_HOME = ORACLE_HOME_DIR)
(PROGRAM = extproc)
)
(SID_DESC =

(SID_NAME = sqlsvdbt)
(ORACLE_HOME = ORACLE_HOME_DIR)
(PROGRAM = hsodbc)
)
)

5. Configurar o arquivo de inicialização do HS. Caso o arquivo não

exista, deve-se criar um arquivo vazio.

5.1. Banco Pirâmide Produção

Localização do arquivo:
ORACLE_HOME_DIR\hs\admin\initsqlsvrdb.ora

Inserir as seguintes linhas ou modificar o arquivo caso as linhas já existam:

HS_FDS_CONNECT_INFO = MSSQLSVR
HS_FDS_TRACE_LEVEL = off
#insert com lista de colunas
SET IDENTITY_INSERT=ON

5.2. Banco Pirâmide Teste

Manual do Usuário Standard Template Configuração DBLink  303

 Localização do arquivo:
ORACLE_HOME_DIR\hs\admin\initsqlsvdbt.ora

Inserir as seguintes linhas ou modificar o arquivo caso as linhas já existam:

HS_FDS_CONNECT_INFO = MSSQLSVRT
HS_FDS_TRACE_LEVEL = off
#insert com lista de colunas
SET IDENTITY_INSERT=ON
6. Criar um database link para o SQL Server. Para isso, deve-se
abrir o SQL Plus, conectar-se com SYS e rodar os comandos
abaixo. Lembrando que devem ser alterados os itens em
negrito: a sa; a “senha_do_sqlserver” com a senha do
cliente onde as aspas permanecerão e <nome ou IP do
servidor> com o nome ou IP onde se encontra o banco
Oracle do cliente e os sinais < e > devem ser excluídos.
conn / as sysdba; (para isto, a variável de ambiente
ORACLE_SID deve estar apontando para o banco de
produção)
Conecta Banco Produção
CREATE PUBLIC DATABASE LINK DBL_PIR_CARDIO
CONNECT TO sa IDENTIFIED BY “senha_do_sqlserver” USING
'(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = <nome ou IP do servidor>)(PORT =

1521) )

)
(CONNECT_DATA =
(SID = sqlsvrdb)
)
(HS = OK)
)' ;

Quando utilizar Banco Teste e Produção

Conecta Banco Produção

conn / as sysdba; (para isto, a variável de ambiente
ORACLE_SID deve estar apontando para o banco de
produção)

304  Configuração DBLink Manual do Usuário Standard Template

 CREATE PUBLIC DATABASE LINK DBL_PIR_CARDIO
CONNECT TO sa IDENTIFIED BY “senha_do_sqlserver” USING
'(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = <nome ou IP do servidor>)(PORT =

1521) )

)
(CONNECT_DATA =
(SID = sqlsvrdb)
)
(HS = OK)
)' ;

Conecta Banco Teste

conn / as sysdba; (para isto, a variável de ambiente

ORACLE_SID deve estar apontando para o banco de teste)

CREATE PUBLIC DATABASE LINK DBL_PIR_CARDIO

CONNECT TO sa IDENTIFIED BY “senha_do_sqlserver” USING
'(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = <nome ou IP do servidor>)(PORT = 1521) )

)
(CONNECT_DATA =
(SID = sqlsvdbt)
)
(HS = OK)
)' ;

7. Testar o database link com algumas queries. Abaixo será

apresentado um exemplo para esclarecer o procedimento:
Select "RegionID","RegionDescription" from Region@Dbl_Pir_Cardio;
Select * from all_tables@Dbl_Pir_Cardio
Select * from cidadepais@dbl_pir_cardio

Manual do Usuário Standard Template Configuração DBLink  305

 Informações Importantes:
Quando o SQLServer estiver em um servidor diferente do
servidor Oracle, o listener do banco Oracle deverá ser
executado pelo usuário administrador da rede (ou outro que
tenha acesso administrativo ao servidor do SQL Server) e não
como LocalSystem.
Acesse o serviço do listener pelo Painel de Controle, na área
de Propriedades, aba logon e especifique o usuário através
do campo “Efetuar logon como esta conta”.
Caso seja necessário remover o database link, executar o
comando abaixo no SQL Plus como SYS:
conn / as sysdba;
drop public database link DBL_PIR_CARDIO;
(se não foi criado como “public”, retirar a palavra public do
comando).
8. Para evitar diferenças de valores na integração, o usuário
deverá realizar os seguintes procedimentos:
 No servidor Oracle o usuário deverá executar o comando
“rededit”, através do caminho -> Iniciar - Executar e
digitar Regedit conforme figura abaixo:

Figura 23 - Tela Executar

Informações Importantes:
O sistema disponibilizará a tela Editor de Registro na qual o
usuário deverá selecionar o seguinte menu:
HKEY_LOCL_MACHINE - SOFTWARE – ORACLE – Selecionar
a chave do Oracle home (OPÇÃO PODE VARIAR EM CADA
CLIENTE).

306  Configuração DBLink Manual do Usuário Standard Template

 Figura 24 - Tela caminho do Editor de Registro

Selecionar a chave do Oracle home, na figura acima seria a

pasta “HOME0”, onde o usuário deverá selecionar a opção
“NLS_LANG”.
Será disponibilizada a tela Editar seqüência com a informação
de Dados do Valor: AMERICAN_AMERICA.WE8ISO8859P1.

Figura 25 - Tela para editar Sequência

Após a execução desse procedimento, o usuário deverá

realizar a exclusão dos títulos gerados e processar
novamente a inclusão. Este procedimento é necessário
porque a integração já tinha enviado os títulos para o
Pirâmide.

Manual do Usuário Standard Template Configuração DBLink  307