Conexões
Aqui ligas o BeryX às tuas fontes de dados, sempre só de leitura, e decides quando cada uma é analisada. Usa esta página para acrescentar uma fonte, testar a ligação, descobrir tabelas ou pedir um scan.
O que podes fazer
- Criar uma fonte com «Nova conexão»: escolher o tipo, preencher as credenciais (cifradas antes de serem guardadas), carregar em «Guardar e testar» e depois em «Descobrir tabelas».
- Gerir cada conexão com «Testar», «Descobrir», «Scan» e «Apagar»; nos buckets e nas fontes documentais e de conversa, «Documentos» analisa ficheiros PDF, DOCX, TXT, MD e HTML para uso em RAG.
- Agendar a análise automática em «Agendar»: manual, diária, semanal ou mensal, com a hora no teu fuso horário (escolhido em «Segurança da conta»).
- Ligar ou desligar os monitores automáticos (atualização, volume e esquema) de cada conexão e ligar um catálogo externo para publicar os resultados dos scans ou importar domínios, owners, tags e descrições.
- Definir, nas bases de dados e warehouses, a «Boa vizinhança» com o DBA: janelas de blackout, queries em simultâneo, amostragem máxima e o registo das queries executadas (só os admins alteram a política).
- Indicar em «Fuso dos dados» → «Alterar» o fuso em que a fonte escreveu as datas guardadas sem fuso (comum em ERPs, em hora de Lisboa ou Madrid). A frescura, as regras e o SLO convertem essas datas para UTC a partir do próximo scan. Sem esta indicação, assume-se UTC.
- Indicar em «País dos dados» → «Alterar» o país a que os dados da fonte dizem respeito (não onde estão guardados). Com Portugal, um telefone de 9 dígitos sem indicativo e um código postal NNNN-NNN leem-se como portugueses; com outro país, não. Sem país próprio, a conexão herda o do workspace (em Equipa & Acessos), que é Portugal por omissão. Vale a partir do próximo scan.
- No BigQuery, fixar ao criar a conexão os «Tetos de custo»: o teto por query (o BigQuery recusa a query sem a faturar), o teto por tabela e scan e a janela de partições. Acima do teto, o perfil degrada, e uma tabela particionada por data é perfilada só nas partições dos últimos dias. Vazio, valem os valores da instalação.
- Experimentar sem os teus dados: as «Fontes públicas de exemplo» ligam-se com um clique e, enquanto não tens conexões, «Explorar com dados de demonstração» cria um ambiente demo.
Ver também
- Datasets — onde aparecem as tabelas descobertas.
- Scan ao vivo — acompanhar um scan pedido.
- Guia de conectores — credenciais e permissões de cada tipo de fonte.
English
Connections
This is where you connect BeryX to your data sources, always read-only, and decide when each one is analysed. Use this page to add a source, test the connection, discover tables or request a scan.
What you can do
- Create a source with “New connection”: choose the type, fill in the credentials (encrypted before they are stored), click “Save and test” and then “Discover tables”.
- Manage each connection with “Test”, “Discover”, “Scan” and “Delete”; on buckets and document and chat sources, “Documents” analyses PDF, DOCX, TXT, MD and HTML files for use in RAG.
- Schedule automatic analysis under “Schedule”: manual, daily, weekly or monthly, with the hour in your time zone (chosen under “Account security”).
- Turn the automatic monitors (freshness, volume and schema) on or off for each connection, and connect an external catalog to publish scan results or import domains, owners, tags and descriptions.
- Set the “DBA settings” on databases and warehouses: blackout windows, concurrent queries, maximum sampling and the log of executed queries (only admins change the policy).
- Under “Data time zone” → “Change”, enter the time zone in which the source wrote dates stored without a time zone (common in ERPs, in Lisbon or Madrid time). Freshness, rules and the SLO convert those dates to UTC from the next scan. Without it, UTC is assumed.
- Under “Data country” → “Change”, set the country the source's data is about (not where it is stored). With Portugal, a 9-digit phone number without a calling code and an NNNN-NNN postal code are read as Portuguese; with another country, they are not. Without its own country, the connection inherits the workspace's (in Team & Access), which is Portugal by default. Applies from the next scan.
- On BigQuery, set the “Cost caps” when you create the connection: the cap per query (BigQuery refuses the query without billing it), the cap per table and scan, and the partition window. Above the cap the profile is degraded, and a date-partitioned table is profiled only on the partitions of the last few days. Left empty, the installation values apply.
- Try it without your own data: “Public sample sources” connect in one click and, while you have no connections, “Explore with sample data” creates a demo environment.
See also
- Datasets — where the discovered tables show up.
- Live scan — follow a scan you requested.
- Connector guide — credentials and permissions for each source type.