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.
Nas conexões Databricks e Snowflake, abrir a «Varredura de engenharia» → «Abrir»: o BeryX lê, só de leitura, os notebooks, os jobs, os pipelines, os modelos ML e o DDL de views, tasks e streams, e abre um problema por prática de risco (credenciais no código, SELECT *, jobs sem retry, timeout ou alerta, notebooks sem job, tasks suspensas, warehouses sem auto-suspend…). Os admins ativam-na e desativam-na; admins e membros carregam em «Pedir varredura», com um resumo por IA opcional que só leva metadados dos achados. «Ver os achados de engenharia em Problemas» abre a lista já filtrada.
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.
Varredura de engenharia — o que lê, as heurísticas, o que sai para a IA e os limites.

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 Databricks and Snowflake connections, open the “Engineering scan” → “Open”: BeryX reads, read-only, the notebooks, jobs, pipelines, ML models and the DDL of views, tasks and streams, and opens one issue per risky practice (credentials in code, SELECT *, jobs without retries, a timeout or an alert, notebooks without a job, suspended tasks, warehouses without auto-suspend…). Admins turn it on and off; admins and members click “Request scan”, with an optional AI summary that carries only the findings' metadata. “See the engineering findings in Issues” opens the list already filtered.
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.