• Português

      • Oracle

      Data source: External OracleEnterprise Edition+

      Introdução

      O Oracle pode ser conectado ao NocoBase como banco de dados externo. Após a conexão, o NocoBase lê as tabelas, os campos e as views do Oracle e os utiliza como tabelas de dados na fonte de dados externa.

      Diferentemente do banco de dados principal, a estrutura real das tabelas do Oracle externo continua sendo mantida pelo sistema de negócios original, pelo cliente de banco de dados ou por scripts de migração. O NocoBase é responsável por ler a estrutura, salvar os metadados dos campos e configurar blocos de página, permissões, workflows e APIs.

      Item de configuraçãoDescrição
      Versões compatíveisOracle >= 11g.
      Versão comercialCompatível com a edição Enterprise.
      Plugin correspondente@nocobase/plugin-data-source-external-oracle.
      Modo de conexãoAs versões do Oracle Database 12.1 e superiores normalmente usam o modo Thin; versões anteriores à 12.1 usam o modo Thick.

      Cenários adequados para usar um Oracle externo:

      • Conectar ao banco de dados Oracle de sistemas de negócios existentes, como ERP, MES, WMS e CRM
      • Criar uma interface de gerenciamento com o NocoBase sem migrar os dados históricos
      • Aplicar controle de permissões, processamento de workflows, correção de dados ou exibição de relatórios às tabelas existentes
      • Continuar mantendo a estrutura do banco de dados por DBAs, scripts de migração ou pelo sistema original
      Atenção

      O Oracle externo não é o banco de dados do sistema do NocoBase. O NocoBase não assume o controle do backup, restauração, migração ou alteração da estrutura das tabelas.

      Instalação do plugin

      Este plugin é comercial. Para obter detalhes sobre a ativação, consulte o Guia de ativação de plugins comerciais

      Se o modo de conexão escolhido for Thick, será necessário instalar as Oracle Client libraries no ambiente de execução do NocoBase e preencher «Client directory» na configuração da fonte de dados.

      Instalação do cliente Oracle

      As versões do Oracle Database 12.1 e superiores normalmente usam o modo Thin e não exigem a instalação adicional do Oracle Client. Só é necessário instalar o Oracle Client libraries no ambiente de execução do NocoBase quando você se conecta a uma versão anterior à 12.1 do Oracle Database ou quando precisa usar o modo Thick.

      Depois de selecionar o modo «Thick» na configuração da fonte de dados, confirme se a máquina onde o serviço do NocoBase está em execução consegue carregar o Oracle Client.

      20241204164359

      Em um ambiente Linux, você pode instalar o Oracle Instant Client da seguinte forma:

      apt-get update
apt-get install -y unzip wget libaio1
wget https://download.oracle.com/otn_software/linux/instantclient/1925000/instantclient-basic-linux.x64-19.25.0.0.0dbru.zip
unzip instantclient-basic-linux.x64-19.25.0.0.0dbru.zip -d /opt/
echo /opt/instantclient_19_25 > /etc/ld.so.conf.d/oracle-instantclient.conf
ldconfig

      Se o Oracle Client não estiver instalado em um local que possa ser carregado por padrão pelo sistema, preencha o diretório das bibliotecas do cliente em «Client directory». Por exemplo, para o método de instalação acima, o diretório correspondente é /opt/instantclient_19_25.

      20241204165940

      Dica

      Client directory só precisa ser configurado no modo Thick. O modo Thin não utiliza essa configuração. Para obter mais informações sobre as regras de inicialização, consulte a documentação de inicialização do node-oracledb.

      Adicionar uma fonte de dados

      Em «Gerenciamento de fontes de dados», clique em «Add new», selecione Oracle e preencha as informações de conexão.

      20241204164359

      As configurações de conexão comuns são as seguintes:

      ConfiguraçãoDescrição
      Data source nameNome identificador da fonte de dados, usado para referenciá-la em blocos de página, permissões, workflows e APIs. Não pode ser alterado após a criação.
      Data source display nameNome exibido da fonte de dados na interface. Recomenda-se usar um nome que os usuários de negócio possam entender, como «ERP Oracle» ou «Banco financeiro».
      Host / PortEndereço e porta do host Oracle. A porta padrão geralmente é 1521.
      ServerNameNome do serviço Oracle. Preencha com o service name configurado no listener do banco de dados.
      Username / PasswordConta e senha usadas para conectar ao Oracle. O NocoBase lê as tabelas e views pertencentes ao Owner dessa conta, sem autorizar nem ler objetos pertencentes a outros Owners.
      Connection modeModo de conexão do Oracle. As versões do Oracle Database 12.1 e superiores normalmente usam o modo Thin; versões anteriores à 12.1 usam o modo Thick.
      Client directoryDiretório das Oracle Client libraries no modo Thick do Oracle. Só precisa ser configurado quando o modo Thick é selecionado.
      Table prefixPrefixo do nome das tabelas. Depois de configurado, o NocoBase lê apenas as tabelas e views que correspondem ao prefixo e gera no NocoBase nomes de tabelas sem o prefixo.
      Collections / Add all collectionsControla o escopo da conexão. Quando «Add all collections» está ativado, o NocoBase conecta todas as tabelas e views dentro do Owner e do escopo do prefixo atuais; quando desativado, conecta apenas os objetos selecionados em «Collections».
      Enabled the data sourceDefine se a fonte de dados está ativada. Quando desativada, a configuração da fonte de dados é mantida, mas os blocos de página, as permissões, os workflows e as APIs não podem mais ler seus dados.
      Dica

      O escopo de conexão no Oracle é determinado principalmente pelo Owner da conta de conexão, Table prefix e «Collections». Se houver muitos objetos na mesma instância, recomenda-se usar uma conta dedicada para conectar o schema necessário ao negócio, reduzindo a entrada de objetos irrelevantes no NocoBase.

      Selecionar tabelas de dados

      Depois de preencher as informações de conexão, clique em «Load Collections» para ler as tabelas de dados e views disponíveis no Oracle. Os resultados da leitura serão afetados pelo Owner da conta de conexão, Table prefix e pela configuração de «Collections».

      Por padrão, «Add all collections» estará ativado, indicando que todas as tabelas e views dentro do escopo atual serão conectadas. Se quiser conectar apenas alguns objetos, desative «Add all collections» e selecione na lista as tabelas ou views necessárias.

      add_new_database_configure_load_collection

      Atenção

      Uma única fonte de dados externa pode conectar no máximo 500 tabelas ou views por vez. Se houver muitos objetos no Oracle, recomenda-se restringir primeiro o escopo por meio do Owner da conta de conexão, Table prefix ou «Collections».

      Sincronizar e configurar campos

      A estrutura das tabelas do Oracle externo é mantida no lado do banco de dados. O NocoBase não cria campos, modifica tipos de campo nem exclui campos reais no Oracle externo.

      Quando a estrutura das tabelas no Oracle for alterada, você poderá executar «Sync from database» na fonte de dados para ler novamente os metadados das tabelas e dos campos. A sincronização atualizará as informações salvas no NocoBase sobre tabelas de dados, campos, chaves primárias, chaves exclusivas e mapeamentos de tipos de campo, mas não excluirá as tabelas ou os dados reais no Oracle.

      Após a sincronização dos campos, você poderá configurar no NocoBase o título do campo, o tipo de campo (Field type) e o componente do campo (Field interface). Se precisar criar campos de relação do NocoBase, os metadados da relação também serão salvos no NocoBase, sem adicionar automaticamente campos de chave estrangeira reais às tabelas do Oracle.

      Mapeamento de tipos de campo

      O NocoBase mapeia automaticamente os tipos de campo do Oracle para o Field type e o Field interface apropriados. Você pode ajustar a forma de exibição na interface de configuração do campo.

      Os mapeamentos comuns são os seguintes:

      Tipo de campo do OracleNocoBase Field typeField interface disponível
      NUMBERinteger、float、boolean、bigInt、unixTimestamp、sortInteger、Number、Sort、Checkbox、Switch、Select、Radio group。
      BINARY_FLOAT、BINARY_DOUBLE、FLOATfloatNumber、Percent。
      INTEGER、SMALLINT、PLSQL_INTEGERinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      CHAR、NCHAR、VARCHAR2、NVARCHAR2string、uuid、nanoid、datetimeNoTzInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      LONG、NCLOBstring、textInput、Textarea、Markdown、Vditor、Rich text。
      CLOBstringInput、Textarea、Rich text。
      DATEdatetimeNoTzDate、Time、Created at、Updated at。
      TIMESTAMPdatetimeNoTzDate、Time、Created at、Updated at。
      TIMESTAMP WITH TIME ZONE、TIMESTAMP WITH LOCAL TIME ZONEdatetimeTzDate、Time、Created at、Updated at。
      ROWID、UROWIDstring、text、integerInput、Textarea、Integer。
      JSONjsonJSON。
      Atenção

      BLOB、BFILE e outros tipos de objetos binários não serão usados automaticamente como campos de arquivo comuns. Se for necessário gerenciar anexos nas páginas, geralmente recomenda-se usar uma tabela de arquivos ou um campo de anexo no NocoBase para salvar os metadados dos arquivos.

      Chave primária e identificador exclusivo do registro

      Para tabelas de dados usadas na exibição e edição de blocos de página, recomenda-se ter uma chave primária ou um campo exclusivo. O NocoBase priorizará o uso da chave primária como identificador exclusivo do registro.

      Se a conexão for feita com uma view, uma tabela sem chave primária ou uma tabela com chave primária composta, será necessário definir manualmente «Record unique key» na configuração da tabela de dados. Sem um identificador exclusivo disponível, os blocos de página poderão não conseguir visualizar, editar ou excluir os registros corretamente.

      20260709210948 20260709211004