Get Table Schema

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âmetroTipoDescrição
tableIdstringID 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

CampoTipoDescrição
columnsarrayLista de colunas
columns[].namestringNome da coluna
columns[].typestringTipo de dado
columns[].nullablebooleanSe aceita NULL
columns[].primary_keybooleanSe é chave primária
columns[].positionintegerOrdem da coluna
columns[].default_valuestringValor padrão
constraintsobjectConstraints da tabela
indexesarrayÍndices da tabela

Códigos de Status

CódigoDescrição
200Schema retornado com sucesso
401Não autenticado
403Sem permissão STORAGE_EXPLORER.READ
404Tabela não encontrada