Obter detalhes de uma tabela específica
Get Table Details
Retorna informações detalhadas de uma tabela específica, incluindo schema, metadados e datasets vinculados.
Endpoint
GET /storage-explorer/tables/{tableId}
Permissões Requeridas
STORAGE_EXPLORER.READ
Path Parameters
| Parâmetro | Tipo | Descrição |
|---|---|---|
tableId | string | ID da tabela |
Exemplo de Requisição
curl -X GET "https://maestro.dadosfera.ai/storage-explorer/tables/tbl_a1b2c3d4e5f6" \
-H "Authorization: <JWT_TOKEN>"Exemplo de Resposta
Success (200 OK):
{
"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",
"description": "Tabela de pedidos de clientes",
"row_count": 15420,
"size_bytes": 2048576,
"columns": [
{
"name": "order_id",
"type": "VARCHAR(50)",
"nullable": false,
"primary_key": true,
"position": 1
},
{
"name": "customer_id",
"type": "VARCHAR(50)",
"nullable": false,
"primary_key": false,
"position": 2
},
{
"name": "order_date",
"type": "TIMESTAMP",
"nullable": false,
"primary_key": false,
"position": 3
},
{
"name": "total_amount",
"type": "DECIMAL(10,2)",
"nullable": true,
"primary_key": false,
"position": 4
}
],
"linked_datasets": [
{
"dataset_id": "ds_x1y2z3",
"dataset_name": "orders_2024_01.csv",
"linked_at": "2024-01-15T11:00:00Z"
},
{
"dataset_id": "ds_a2b3c4",
"dataset_name": "orders_2024_02.csv",
"linked_at": "2024-02-01T09:30:00Z"
}
],
"statistics": {
"last_analyzed": "2024-01-16T08:00:00Z",
"estimated_size_mb": 1.95
}
}Response Fields
| Campo | Tipo | Descrição |
|---|---|---|
table_id | string | Identificador único da tabela |
table_name | string | Nome da tabela |
schema_name | string | Schema da tabela |
full_name | string | Nome completo (schema.table) |
columns | array | Lista de colunas com detalhes |
linked_datasets | array | Datasets vinculados à tabela |
statistics | object | Estatísticas da tabela |
Códigos de Status
| Código | Descrição |
|---|---|
200 | Detalhes retornados com sucesso |
401 | Não autenticado |
403 | Sem permissão STORAGE_EXPLORER.READ |
404 | Tabela não encontrada |
