Get Table Details

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

CampoTipoDescrição
table_idstringIdentificador único da tabela
table_namestringNome da tabela
schema_namestringSchema da tabela
full_namestringNome completo (schema.table)
columnsarrayLista de colunas com detalhes
linked_datasetsarrayDatasets vinculados à tabela
statisticsobjectEstatísticas da tabela

Códigos de Status

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