Centro de suporte da Workiva

Com o conector Oracle® RDBMS | ADW, você pode usar os comandos em uma cadeia para executar operações de linguagem de consulta estruturada (SQL) no Oracle Relational Database Management System (RDBMS) ou no Autonomous Data Warehouse® (ADW). Por exemplo, com esse conector, você pode:

• Executar comandos SQL, incluindo uma instrução CREATE ou UPDATE ou uma consulta SELECT
• Recuperar detalhes sobre uma tabela no Oracle RDBMS ou ADW
• Inserir registros no Oracle RDBMS ou no ADW

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Requisitos

Para habilitar a conexão com o banco de dados Oracle, o conector usa a conectividade de banco de dados Java (JDBC), protegida com autenticação básica de nome de usuário e senha. Para configurar o conector, você precisará de:

• Um usuário de integração designado criado no Oracle RDBMS ou ADW para o conector
• O nome de usuário e a senha do usuário de integração
• O URL da conexão JDBC, como jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./
• Para se conectar ao Oracle ADW, às credenciais de cliente do banco de dados ou aos arquivos de carteira
• Para se conectar a um banco de dados local, um GroundRunner para a conexão

Versões suportadas

O conector Oracle® RDBMS | ADW é compatível com as seguintes versões de banco de dados :

• 21.x
• 19.x
• 18.3
• 12.2
• 12.1
• 11.2.0.4

Arquivos de carteira do ADW

Para habilitar uma conexão com o Oracle ADW, primeiro faça o download das credenciais de cliente ou dos arquivos de carteira do banco de dados . Ao configurar o conector, você carregará esses arquivos de carteira em Resources:

• cwallet.sso.lck\n* ewallet.p12.lck
• cwallet.sso
• ewallet.p12
• keystore.jks
• sqlnet.ora
• tnsnames.ora
• truststore.jks
• ojdbc.properties

Para indicar o local desses recursos na propriedade Connection URL do conector, insira o caminho TNS_ADMIN com base no sistema operacional do GroundRunner:

• Para UNIX, TNS_ADMIN=./
• Para o Microsoft® Windows®, TNS_ADMIN=.

Observação: Se o conector usar um CloudRunner, use o caminho TNS_ADMIN=./.

Configurar o conector Oracle RDBMS | ADW

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Connector Connection, selecione Oracle RDBMS | ADW e o executor a ser usado com o conector.
   
3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
4. Para se conectar ao Oracle ADW, em Resources, carregue os arquivos de carteira do banco de dados.
5. Em Propriedades, insira os detalhes do conector:
   
   

   Propriedade	Detalhes
   Nome de usuário	Digite o nome de usuário do usuário de integração do conector.
   Senha	Digite a senha da propriedade Nome de usuário.
   URL de conexão	Digite o URL da conexão JDBC, como jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./. Para Oracle RDBMS, acrescente quaisquer propriedades opcionais para a conexão. Para o Oracle ADW, acrescente o caminho TNS_ADMIN para os arquivos de carteira do banco de dados, com base no executor selecionado e em seu sistema operacional. Observação: Por padrão, a porta do Oracle RDBMS é 1521; no entanto, isso pode ser diferente para o seu ambiente.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256. Para fins de segurança, evite incluir credenciais de usuário como propriedades opcionais na propriedade URL de conexão.

6. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
7. Para testar a conexão, crie e execute uma cadeia com o comando Get Table Definition do conector e verifique se ele retorna uma saída válida. 

Solução de problemas

Se a conexão com o Oracle RDBMS ou ADW falhar:

• Verifique as credenciais de autenticação do usuário de integração.
• Verifique o URL da conexão JDBC.
• Se você estiver se conectando a um banco de dados local, verifique o GroundRunner selecionado para o conector.
• Se você estiver se conectando ao Oracle ADW, verifique se os arquivos de carteira do banco de dados foram carregados em Resources e verifique o caminho TNS_ADMIN na propriedade Connection URL. Se necessário, faça o download dos arquivos de carteira do Oracle ADW e carregue-os novamente em Resources.

Se a conexão não conseguir executar um comando, verifique se as entradas - como a sintaxe ou a tabela SQL - são válidas.