List Tables

Lista todas as tabelas disponíveis no storage do cliente com suporte a paginação.

Endpoint

GET /storage-explorer/tables

Permissões Requeridas

• STORAGE_EXPLORER.READ

Query Parameters

Parâmetro	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página (padrão: 1)
limit	integer	Não	Itens por página (padrão: 20, máx: 100)

Exemplo de Requisição

curl -X GET "https://maestro.dadosfera.ai/storage-explorer/tables?page=1" \
  -H "Authorization: <JWT_TOKEN>"

Exemplo de Resposta

Success (200 OK):

{
  "tables": [
    {
      "table_id": "tbl_a1b2c3d4e5f6",
      "table_name": "customer_orders",
      "schema_name": "RAW_DATA",
      "full_name": "RAW_DATA.customer_orders",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "row_count": 15420,
      "size_bytes": 2048576,
      "linked_datasets_count": 2,
      "description": "Tabela de pedidos de clientes"
    },
    {
      "table_id": "tbl_b2c3d4e5f6g7",
      "table_name": "products",
      "schema_name": "RAW_DATA",
      "full_name": "RAW_DATA.products",
      "created_at": "2024-01-14T14:20:00Z",
      "updated_at": "2024-01-16T08:15:00Z",
      "row_count": 850,
      "size_bytes": 153600,
      "linked_datasets_count": 1,
      "description": "Catálogo de produtos"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 5,
    "total_items": 98,
    "items_per_page": 20,
    "has_next": true,
    "has_previous": false
  }
}

Response Fields

Campo	Tipo	Descrição
tables	array	Lista de tabelas
tables[].table_id	string	Identificador único da tabela
tables[].table_name	string	Nome da tabela
tables[].schema_name	string	Schema da tabela
tables[].full_name	string	Nome completo (schema.table)
tables[].created_at	string	Data de criação (ISO 8601)
tables[].updated_at	string	Data da última atualização
tables[].row_count	integer	Número de linhas
tables[].size_bytes	integer	Tamanho em bytes
tables[].linked_datasets_count	integer	Número de datasets vinculados
pagination	object	Informações de paginação

Códigos de Status

Código	Descrição
200	Lista retornada com sucesso
401	Não autenticado
403	Sem permissão STORAGE_EXPLORER.READ