MinIO — Browse the object storage without leaving the console
Checking whether a file made it into the platform's object storage becomes a folder walk inside DATTA itself, under the platform's permissions and audit trail. It used to require a command-line tool, credentials copied back and forth and an external console. The screen brings together access configuration, the connectivity test and browsing of buckets and objects — including the Iceberg warehouse (datta-warehouse) that Apache Trino uses, plus the document and staging buckets.
The screen has three tabs:
| Tab | What it does | Permission |
|---|---|---|
| Conexão | Endpoint, access key, secret key, default bucket, region and path-style. The secret key stays masked once saved. | PLATFORM_ADMIN (write), PLATFORM_VIEW (read) |
| Status | Tests connectivity with the storage server. | PLATFORM_VIEW |
| Buckets & Objetos | Lists buckets, browses folders and objects and shows each file's detail (metadata). | PLATFORM_VIEW |
Conexão tab
Fill in the endpoint, the access key and the secret key, the default bucket, the region and the path-style option. Once saved, the secret key shows up masked — it cannot be read back in clear text from the screen. Use Salvar configuração to store it and Testar conectividade to validate it right away.
The configuration is kept as a platform secret, under the name datta-minio-config.
Status tab
Shows the result of the connectivity check against the configured endpoint — the test that answers "is the storage reachable from the platform?" before you investigate anything else.
Buckets & Objetos tab
- Bucket list — cards with name and creation date; click to open.
- Folder navigation — the listing respects the folder hierarchy (the
/delimiter), and the trail (bucket › folder › subfolder) takes you back to any level with one click. - Bucket summary — object count and total size. The scan is limited to 50,000 objects; above that the total appears with a
+. - Object detail — clicking a file opens a side panel with key, size,
Content-Type, modification date,ETagand the user metadata. - Read-only — the browser does no upload, download or deletion. Content mutations belong to the platform's ingestion tools (Extract, DATTABI) and, in documented operational procedures, to the storage's own command-line client. Here you inspect safely, with no risk of erasing anything.
Worked example — checking that a Parquet reached the warehouse
- Run your materialization flow in Extract and note the target dataset.
- Open › Buckets & Objetos and click the warehouse bucket (the same one shown as the default bucket in the Conexão tab).
- Browse the dataset folder down to the
.parquetfiles and check, in the detail panel, the size and the modification date — if the date matches the flow run, the materialization reached its destination. - Something odd? The trail lets you go up one level and compare with the other folders without losing context.
Where the credentials come from
Browsing resolves credentials in this order, never recording them in clear text in the logs:
- The
datta-minio-configsecret, managed by the Conexão tab — used when the access key and secret key are filled in there. - The storage credentials provisioned at installation (
MINIO_ACCESS_KEY,MINIO_SECRET_KEY,MINIO_ENDPOINT), available to every module of the platform — the same ones Trino uses for the warehouse.
If neither source has credentials, browsing returns a friendly error asking you to configure access in › Conexão.
Permissions
| Action | Permission |
|---|---|
| Browse buckets/objects, view detail, test status | PLATFORM_VIEW |
| Change endpoint/credentials (Conexão tab) | PLATFORM_ADMIN |
A denial returns the message "Acesso negado." in Portuguese. Enforcement is always on the server; the interface only hides or disables what you cannot use. See the roles and permissions guide.
Listing cache
So as not to hit the storage on every click, reads are cached for a few seconds:
| What is cached | Duration |
|---|---|
| Bucket list | 10 s |
| Object list of a folder | 10 s |
| Detail of an object | 10 s |
| Bucket summary (count and size) | 60 s — the scan is more expensive |
Automation
Everything the screen does — listing buckets, listing objects and folders, reading an object's detail, computing the bucket summary, reading/writing the access configuration and testing connectivity — is also available to verification automations; see the API reference.
Troubleshooting
| Symptom | Likely cause | Action |
|---|---|---|
| "Credenciais do MinIO não configuradas" | No credentials saved in the Conexão tab and none provisioned at installation | Fill in the access key and secret key in the Conexão tab — or ask the operations team to provision the installation's storage credentials |
| "Não foi possível listar buckets" | Endpoint unreachable or invalid credentials | Use Testar conectividade and review endpoint and keys |
| Bucket opens empty but has data | The objects sit under a prefix (folder) | Browse the folders using the trail |
Summary shows + in the total | Bucket with more than 50,000 objects (scan cap) | Expected — for an exact count, use the storage's native tools |
| "Acesso negado" | Missing the PLATFORM_VIEW permission | Assign the proper profile (roles and permissions) |
See also
- Object storage console architecture
- SIQL storage lineage — consumes the same warehouse.
- API reference