Skip to content

Automatic translation — the Portuguese version is the reference. View in Portuguese

Updated on 2026-10-03

Connections screens — the exact name of each button

The connections list, the four-step wizard, and a connection's detail page, with the literal label of each button, field, filter, and status.

On this page (10)

This page is an interface inventory: what's written here is the text that appears on screen, literally. To learn the task, go to Connect your first source.

Where it is: menu ETL/ELT → Connections.

A connection is access to a system (for example, your ERP's database), registered once and reused in as many pipelines as you like. It only reads data — and registering doesn't bring anything in: the pipeline does that.

Find a connection in the list (/conexoes)#

The list is called Your connections. Columns: Name · System · Status · Used in · Actions.

You want toClick
Register new accessNew connection (opens, at the top, the question Which system does your data come from?)
See if the access still worksTest (becomes Testing… while it runs)
Open the full detail pageOpen connection
Use this connection in a pipeline you're buildingUse connection
Connections screen, with search by name, the system and status filters, and the list with each connection's status in one sentence

In the More actions for connection {nome} menu: Edit configuration, Replace credential, Use in a new pipeline, See linked pipelines, Archive connection, and Delete connection.

Archive appears disabled, and that's on purpose

Archive connection is in the menu with the reason stated on the screen itself: archiving isn't available yet. The product prefers to say so rather than hide the action and leave you searching for it.

Status — a single answer

StatusWhat it means
WorkingThe last test got into the system with the current data
Has a problemThe last test failed, or the password was rejected/expired
Never testedWe haven't tested yet whether we can get in
Test againThe access data changed after the last test

Connections created inside a pipeline appear with the This pipeline only badge: they have no separate test, and their status comes from the pipeline's last run.

Filters

A single bar: Search by name · All systems · the status (All, Working, Has a problem, Never tested, Test again — only the ones present in your list appear, with the count) · Clear filters.

When the list is empty

  • No connections yet: Connect your first system + the New connection button
  • Filter with no results: No connection matches these filters + Clear filters
  • Failed to load: Couldn't load your connections + Try again

On a phone, the list appears as cards.

Register a connection — the four-step wizard (/conexoes/nova)#

Title New connection (when editing: Edit connection — {nome}). Four steps:

System → Address and password → Test → Done

StepHeading on screenWhat you do
1Where is your data?Choose the system (Postgres, MySQL, SQL Server, Oracle, BigQuery). If you came from a catalog card, this step is already done
2{Sistema} address and passwordConnection name (comes suggested), Server address, Port (default pre-filled), Database name, User, and Password. Each field has a help line with an example
3Let's test whether we can get inClick Test now
4All set to save?Review and save
Step 1 of the wizard: the question "Where is your data?" and the systems that can be connected
Step 2 of the wizard: suggested connection name, server address, port, database name, user, and password, each with its own help

Advanced options (in step 2, collapsed) holds what usually only IT touches: Schema, Connection security (SSL), How we reach the database (Direct over the internet, SSH tunnel (bastion), Cloud SQL (IP/Proxy), VPN (private IP)), and the SSH tunnel fields. It comes with the secure default.

The test result is one sentence: Connection working or We couldn't get in, with the reason and what to do (e.g., "The server didn't respond in time… ask your IT to allow access"). The per-stage detail is under See test details (for IT).

Step 3 of the wizard: the Test now button and what the test does

Footer: Back · Continue (on the test step: Continue without testing or Continue anyway) · Cancel. The final button is Save connection — or Save and use in pipeline when you got here from inside the building of a pipeline.

Step 4 of the wizard: the summary of what will be saved, without the password, and the test badge

When editing a saved connection, the password isn't shown: step 2 shows Change the password (and Keep the stored password to back out).

Changing the access calls for a new test

If you change any data, test again: the previous result doesn't apply to the new access.

You can save without testing — the connection stays as Never tested.

Configure, test, and revoke a saved connection (/conexoes/salva/[id])#

Top actions: Use in a new pipeline (or Use in pipeline, when you came from the builder) · Test connection · the More actions for connection {nome} menu, which has Edit configuration, Replace credential, See linked pipelines, Archive connection, Delete connection, and Revoke credential.

Detail of a saved connection: Use in a new pipeline, Test connection, the Summary, Linked pipelines, and History tabs, and the Last test panel

Replace and revoke are not the same thing

Replace credential swaps the secret and keeps the connection running. Revoke credential deletes the secret: the connection stays registered and stops working until you provide another one. Every pipeline that points to it fails on its next run.

Three tabs: Summary · Linked pipelines ({N}) · History.

The Summary has the Access configuration, Capabilities, Credential, Credential and vault, Last test, Test from the pipelines executor, and Ingestion panels. In Last test, the line that matters most is Valid for the current revision? — it tells you whether the test that passed applies to the access stored right now.

Right after creating it, the screen responds: "Connection registered. No load was started."

View the detail page of an already-ingested source (/conexoes/[id])#

A read-only view of an already-ingested source: Connection details ("This source's configuration (read-only). Credentials are never shown."), Ingested tables, Status (the Status, Last run, and Category lines), the Ingestion mode line, and the Encrypted credentials badge. The actions are Back and the Edit {nome} icon.

The four states behind the status (for IT)#

In the list you see ONE status. The connection's detail page shows the four states it comes from:

DimensionPossible values
RegistrationActive · Draft · Archived
ValidationValidated ✓ · Failed the test · Testing… · Validation outdated · Not tested
CredentialCredential configured · Credential expired · Credential revoked · Credential inaccessible · No credential
IngestionLast ingestion OK · Last ingestion failed · Ingestion running · Never ingested · No pipeline

As the screen itself says: a Validated ✓ connection doesn't mean data was loaded, and an Active registration doesn't mean the test passed.

Back to the app#

Next task#

Related links