Obter o schema de uma tabela
Get Table Schema
Retorna o schema completo de uma tabela, incluindo todas as colunas e seus tipos.
Endpoint
GET /storage-explorer/tables/{tableId}/schema
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/schema" \
-H "Authorization: <JWT_TOKEN>"Exemplo de Resposta
Success (200 OK):
{
"table_id": "tbl_a1b2c3d4e5f6",
"table_name": "customer_orders",
"schema_name": "RAW_DATA",
"columns": [
{
"name": "order_id",
"type": "VARCHAR(50)",
"nullable": false,
"primary_key": true,
"position": 1,
"default_value": null,
"description": "Identificador único do pedido"
},
{
"name": "customer_id",
"type": "VARCHAR(50)",
"nullable": false,
"primary_key": false,
"position": 2,
"default_value": null,
"description": "ID do cliente"
},
{
"name": "order_date",
"type": "TIMESTAMP",
"nullable": false,
"primary_key": false,
"position": 3,
"default_value": "CURRENT_TIMESTAMP",
"description": "Data do pedido"
},
{
"name": "total_amount",
"type": "DECIMAL(10,2)",
"nullable": true,
"primary_key": false,
"position": 4,
"default_value": "0.00",
"description": "Valor total do pedido"
},
{
"name": "status",
"type": "VARCHAR(20)",
"nullable": false,
"primary_key": false,
"position": 5,
"default_value": "'pending'",
"description": "Status do pedido"
}
],
"constraints": {
"primary_key": ["order_id"],
"unique_keys": [],
"foreign_keys": []
},
"indexes": [
{
"name": "idx_customer_id",
"columns": ["customer_id"],
"unique": false
},
{
"name": "idx_order_date",
"columns": ["order_date"],
"unique": false
}
]
}Response Fields
| Campo | Tipo | Descrição |
|---|---|---|
columns | array | Lista de colunas |
columns[].name | string | Nome da coluna |
columns[].type | string | Tipo de dado |
columns[].nullable | boolean | Se aceita NULL |
columns[].primary_key | boolean | Se é chave primária |
columns[].position | integer | Ordem da coluna |
columns[].default_value | string | Valor padrão |
constraints | object | Constraints da tabela |
indexes | array | Índices da tabela |
Códigos de Status
| Código | Descrição |
|---|---|
200 | Schema retornado com sucesso |
401 | Não autenticado |
403 | Sem permissão STORAGE_EXPLORER.READ |
404 | Tabela não encontrada |
