Saltar para o conteúdo
BeryX
Voltar ao guia do aplicativo

Documentação do BeryX

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

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.