#Banco de Dados Externo

#Introdução

Você pode usar um banco de dados externo existente como uma fonte de dados. Atualmente, os bancos de dados externos suportados incluem MySQL, MariaDB, PostgreSQL, MSSQL e Oracle.

#Instruções de Uso

#Adicionando um Banco de Dados Externo

Após ativar o plugin, você poderá selecioná-lo e adicioná-lo no menu suspenso "Adicionar novo" na gestão de fontes de dados.

Preencha as informações do banco de dados ao qual você deseja se conectar.

#Sincronização de Coleções

Após estabelecer uma conexão com um banco de dados externo, todas as coleções dentro da fonte de dados serão lidas diretamente. Bancos de dados externos não permitem adicionar coleções ou modificar a estrutura da tabela diretamente. Se precisar fazer modificações, você pode realizá-las através de um cliente de banco de dados e, em seguida, clicar no botão "Atualizar" na interface para sincronizar.

#Configurando Campos

O banco de dados externo lerá e exibirá automaticamente os campos das coleções existentes. Você pode visualizar e configurar rapidamente o título do campo, o tipo de dados (Field type) e o tipo de interface (Field interface). Você também pode clicar no botão "Editar" para modificar mais configurações.

Como bancos de dados externos não permitem modificar a estrutura da tabela, o único tipo disponível ao adicionar um novo campo é o campo de associação. Campos de associação não são campos reais, mas são usados para estabelecer conexões entre coleções.

Para mais detalhes, consulte o capítulo Campos da Coleção/Visão Geral.

#Mapeamento de Tipos de Campo

O NocoBase mapeia automaticamente os tipos de campo do banco de dados externo para o tipo de dados (Field type) e o tipo de interface (Field Interface) correspondentes.

• Tipo de dados (Field type): Define o tipo, formato e estrutura dos dados que um campo pode armazenar.
• Tipo de interface (Field interface): Refere-se ao tipo de controle usado na interface do usuário para exibir e inserir valores de campo.

PostgreSQL	MySQL/MariaDB	NocoBase Data Type	NocoBase Interface Type
BOOLEAN	BOOLEAN TINYINT(1)	boolean	checkbox switch
SMALLINT INTEGER SERIAL SMALLSERIAL	TINYINT SMALLINT MEDIUMINT INTEGER	integer boolean sort	integer sort checkbox switch select radioGroup
BIGINT BIGSERIAL	BIGINT	bigInt sort	integer sort checkbox switch select radioGroup unixTimestamp createdAt updatedAt
REAL	FLOAT	float	number percent
DOUBLE PRECISION	DOUBLE PRECISION	double	number percent
DECIMAL NUMERIC	DECIMAL	decimal	number percent currency
VARCHAR CHAR	VARCHAR CHAR	string password uuid nanoid	input email phone password color icon select radioGroup uuid nanoid
TEXT	TEXT TINYTEXT MEDIUMTEXT LONGTEXT	text json	textarea markdown vditor richText url json
UUID	-	uuid	uuid
JSON JSONB	JSON	json	json
TIMESTAMP	DATETIME TIMESTAMP	date	date time createdAt updatedAt
DATE	DATE	dateOnly	datetime
TIME	TIME	time	time
-	YEAR		datetime
CIRCLE		circle	json circle
PATH GEOMETRY(LINESTRING)	LINESTRING	lineString	Json lineString
POINT GEOMETRY(POINT)	POINT	point	json point
POLYGON GEOMETRY(POLYGON)	POLYGON	polygon	json polygon
GEOMETRY	GEOMETRY	-	-
BLOB	BLOB	blob	-
ENUM	ENUM	enum	select radioGroup
ARRAY	-	array	multipleSelect checkboxGroup
BIT	BIT	-	-
SET	SET	set	multipleSelect checkboxGroup
RANGE	-	-	-

#Tipos de Campo Não Suportados

Os tipos de campo não suportados são exibidos separadamente. Esses campos exigem adaptação de desenvolvimento antes de poderem ser utilizados.

#Chave de Destino do Filtro

As coleções exibidas como blocos devem ter uma Chave de Destino do Filtro (Filter target key) configurada. A chave de destino do filtro é usada para filtrar dados com base em um campo específico, e o valor do campo deve ser único. Por padrão, a chave de destino do filtro é o campo de chave primária da coleção. Para visualizações, coleções sem chave primária ou coleções com chave primária composta, você precisará definir uma chave de destino do filtro personalizada.

Apenas as coleções que possuem uma chave de destino do filtro configurada podem ser adicionadas à página.