Gerenciador de Conexões do Oracle

Aplica-se a:SQL Server SSIS Integration Runtime no Azure Data Factory

Um Gerenciador de Conexões do Oracle é usado para habilitar um pacote para extrair dados de Oracle Databases e carregar dados em Oracle Databases.

A propriedade ConnectionManagerType do Gerenciador de Conexões do Oracle está definida como ORACLE.

Nos logs de execução do SSIS, esse conector é conhecido como "Gerenciador de Conexões do Oracle".

Configurando o Gerenciador de Conexões do Oracle

As alterações de configuração do Gerenciador de Conexões do Oracle serão resolvidas por Integration Services no runtime. Use a caixa de diálogo Editor do Gerenciador de Conexões do Oracle para adicionar uma conexão com uma fonte de dados do Oracle.

Connection Manager

Opções

Informações do gerenciador de conexões

Insira as informações sobre a conexão do Oracle.

Nome

Insira um nome para a conexão do Oracle. O nome padrão é Gerenciador de Conexões do Oracle.

Descrição

Insira uma descrição da conexão. Esta entrada é opcional.

Nome do serviço TNS

Insira o nome do banco de dados do Oracle com o qual você deseja trabalhar. O nome do serviço TNS poderia ser:

  • O nome da conexão definido no arquivo tnsnames.ora

  • Formato EzConnect: [//]host[:port][/service_name]

Para usar um arquivo tnsnames.ora, talvez seja necessário adicionar uma variável de ambiente do sistema ao computador que executa o pacote SSIS. A variável de ambiente TNS_Admin especifica o local da pasta que contém o arquivo tnsnames.ora. Isso será necessário se você não tiver instalado um cliente Oracle. Para adicionar a variável de ambiente no Windows 10, Windows 11 ou Windows Server 2022:

  1. Clique com o botão direito do mouse no ícone Iniciar e selecione Sistema.
  2. Na janela Configurações, selecione Configurações Avançadas do Sistema.
  3. Na guia Avançado da janela Propriedades do Sistema, selecione Variáveis de Ambiente.
  4. Na janela Variáveis de Ambiente em Sistema, selecione Novo.
  5. Na janela Nova Variável do Sistema, insira "TNS_Admin" para o nome da variável e o caminho correto para a pasta que contém o arquivo tnsnames.ora para o valor da variável.
  6. Selecione OK nas janelas Nova Variável do Sistema, Variáveis de Ambiente e Propriedades do Sistema.

Para obter mais informações, consulte a documentação Oracle.

Registro em log do Gerenciador de Conexões

Selecione uma das opções a seguir:

  • Usar a autenticação do Windows: selecione esta opção para usar autenticação do Windows.

  • Usar a autenticação do Oracle: selecione esta opção para usar a autenticação do banco de dados do Oracle. Se você usar esta autenticação, insira suas credenciais do Oracle da seguinte forma:
    Nome de Usuário: digite o nome de usuário usado para se conectar ao banco de dados do Oracle.
    Senha: digite a senha do banco de dados Oracle para o usuário inserido no campo nome do usuário.

Observação

A Autenticação do Windows não é compatível com o Oracle Server 18c.

Testar Conexão

Clique em Testar Conexão para verificar se as informações fornecidas estão corretas. Você receberá a mensagem Teste de conexão bem-sucedido, se as informações inseridas puderem ser conectadas ao banco de dados do Oracle.

Observação

Para especificar o ConnectionString diretamente, este é o exemplo com a autenticação do Oracle:

SERVER=\<YourOracleServerName or EzConnect format>;USERNAME=\<YourUserName>;PWD=\<YourPassword>;WINAUTH=0

Propriedades personalizadas

Há as seguintes propriedades personalizadas do gerenciador de conexões no gerenciador de conexões do Oracle:

  • EnableDetailedTracing: não usado.

  • OracleHome: especifique o nome ou pasta de 32-bit do Oracle Home a ser usado pelo conector. (Opcional)

  • OracleHome64: especifique o nome ou pasta do Oracle Home de 64 bits a ser usado pelo conector durante a execução no modo 64 bits. (Opcional)

As propriedades personalizadas não são listadas no Editor do Gerenciador de Conexões do Oracle. Para definir as propriedades OracleHome e OracleHome64:

  1. Da área do Gerenciador de Conexões, clique com o botão direito do mouse no gerenciador de conexões do Oracle com o qual você está trabalhando e selecione Propriedades.

  2. No painel Propriedades, defina a propriedade OracleHome ou OracleHome64 com o caminho completo para o diretório base do Oracle.

Próximas etapas