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