• Português

      • MariaDB

      Data source: External MariaDBStandard Edition+

      Introdução

      O MariaDB pode ser integrado ao NocoBase como banco de dados externo. Após a integração, o NocoBase lerá as tabelas, os campos e as views do MariaDB e os utilizará como tabelas de dados na fonte de dados externa.

      Ao contrário do banco de dados principal, a estrutura real das tabelas do MariaDB 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, configurar blocos de página, permissões, workflows e APIs.

      Item de configuraçãoDescrição
      Versões compatíveisMariaDB >= 10.3.
      Versões comerciaisCompatível com as edições Standard, Professional e Enterprise.
      Plugin correspondente@nocobase/plugin-data-source-external-mariadb.
      Protocolo compatívelA conexão usa o protocolo MySQL, e o mapeamento de campos segue, de modo geral, a lógica de compatibilidade do MySQL.

      Cenários adequados para usar o MariaDB externo:

      • Integrar o banco de dados MariaDB de sistemas de negócios existentes, como ERP, MES, WMS e CRM
      • Criar uma interface de gerenciamento com o NocoBase sem migrar dados históricos
      • Controlar permissões, processar workflows, corrigir dados ou exibir relatórios de tabelas existentes
      • Continuar mantendo a estrutura do banco de dados por DBAs, scripts de migração ou pelo sistema original
      Atenção

      O MariaDB externo não é o banco de dados do sistema NocoBase. O NocoBase não assumirá o controle do backup, da restauração, da migração nem das alterações na estrutura das tabelas.

      Instalação do plugin

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

      Adicionar fonte de dados

      Em「Gerenciamento de fontes de dados」, clique em「Add new」, selecione MariaDB e preencha as informações da conexão.

      20260709204413

      Configurações de conexão comuns:

      ConfiguraçãoDescrição
      Data source nameNome de identificação da fonte de dados, usado como referência 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 compreensível para os usuários de negócio, como「ERP MariaDB」「Banco de pedidos」.
      Host / PortEndereço do host e porta do MariaDB. A porta padrão geralmente é 3306.
      DatabaseNome do banco de dados MariaDB ao qual se conectar.
      Username / PasswordNome de usuário e senha usados para conectar ao MariaDB. O NocoBase só pode ler os objetos aos quais essa conta tem acesso; ele não concederá permissões nem lerá objetos privados de outras contas.
      Table prefixPrefixo dos nomes das tabelas. Após a configuração, o NocoBase lerá apenas as tabelas e views que correspondam a esse prefixo e gerará no NocoBase nomes de tabelas sem o prefixo.
      Collections / Add all collectionsControla o escopo da integração. Quando「Add all collections」está ativado, o NocoBase integra todas as tabelas e views dentro do escopo atual; quando desativado, integra apenas os objetos selecionados em「Collections」.
      Enabled the data sourceDefine se esta fonte de dados está ativada. Quando desativada, a configuração da fonte de dados será mantida, mas os blocos de página, as permissões, os workflows e as APIs não poderão continuar lendo seus dados.
      Dica

      Se houver muitos objetos no MariaDB, priorize restringir o escopo por meio de Database, Table prefix e「Collections」. Integre apenas as tabelas e views usadas pelo aplicativo atual; assim, a configuração posterior de permissões, a criação de páginas e a manutenção da sincronização serão mais simples.

      Selecionar tabelas de dados

      Depois de preencher as informações da conexão, clique em「Load Collections」para ler as tabelas e views disponíveis no MariaDB. Os resultados da leitura serão influenciados pela conta da conexão, por Database, 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 integradas. Se quiser integrar apenas alguns objetos, desative「Add all collections」e selecione na lista as tabelas ou views necessárias.

      20260709204452

      Atenção

      Cada fonte de dados externa pode integrar no máximo 500 tabelas ou views de uma vez. Se houver muitos objetos no MariaDB, recomenda-se restringir primeiro o escopo por meio de Database, Table prefix ou「Collections」.

      S sincronização e a configuração de campos

      A estrutura das tabelas do MariaDB externo é mantida no lado do banco de dados. O NocoBase não criará campos, modificará tipos de campos nem excluirá campos reais no MariaDB externo.

      Quando a estrutura das tabelas no MariaDB for alterada, você poderá executar「Sync from database」na fonte de dados para reler os metadados das tabelas e dos campos. A sincronização atualizará no NocoBase as informações salvas sobre tabelas de dados, campos, chaves primárias, chaves exclusivas e mapeamento de tipos de campos, mas não excluirá as tabelas ou os dados reais do MariaDB.

      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 à tabela do MariaDB.

      Mapeamento de tipos de campos

      O NocoBase mapeará automaticamente os tipos de campos do MariaDB para o Field type e o Field interface adequados. O mapeamento dos campos comuns do MariaDB é basicamente igual ao do MySQL, e você pode ajustar a forma de exibição na configuração do campo.

      Mapeamentos comuns:

      Tipo de campo do MariaDBNocoBase Field typeField interface disponível
      TINYINT、SMALLINT、MEDIUMINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      INT、INTEGERinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group。
      BIGINTbigInt、snowflakeId、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at。
      FLOAT、DOUBLEfloatNumber、Percent。
      DECIMALdecimalNumber、Percent、Currency。
      CHAR、VARCHARstring、uuid、nanoid、encryptionInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      TINYTEXT、TEXT、MEDIUMTEXT、LONGTEXTtextTextarea、Markdown、Vditor、Rich text、URL。
      DATEdateOnlyDate。
      TIMEtimeTime。
      DATETIMEdatetimeNoTz、datetimeTz、dateDate、Time、Created at、Updated at。
      TIMESTAMPdatetimeTz、dateDate、Time、Created at、Updated at。
      YEARstring、integerInput、Integer、Date。
      JSONjson、arrayJSON。
      Atenção

      Os tipos de campos do MariaDB não compatíveis serão exibidos separadamente na configuração dos campos. Para usar esses campos normalmente no NocoBase, será necessário desenvolver uma adaptação.

      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 que exista uma chave primária ou um campo exclusivo. O NocoBase dará prioridade à chave primária como identificador exclusivo do registro.

      Se a integração for de uma view, de uma tabela sem chave primária ou de 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 registros corretamente.

      20260709205835 20260709205854