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