Refresh Dataset Schema

Atualiza o schema de um dataset reprocessando com novas opções de parsing. Útil principalmente para arquivos Excel.

Endpoint

PUT /storage-explorer/datasets/{datasetId}/refresh-schema

Permissões Requeridas

• STORAGE_EXPLORER.WRITE

Path Parameters

Parâmetro	Tipo	Descrição
datasetId	string	ID do dataset

Request Body

Campo	Tipo	Obrigatório	Descrição
sheet_name	string	Não	Nome da sheet (Excel)
skip_rows	integer	Não	Número de linhas para pular
header_row	integer	Não	Linha do cabeçalho (padrão: 0)
encoding	string	Não	Encoding do arquivo (CSV)
delimiter	string	Não	Delimitador (CSV)

Exemplo de Requisição - Excel

curl -X PUT "https://maestro.dadosfera.ai/storage-explorer/datasets/ds_a2b3c4/refresh-schema" \
  -H "Authorization: <JWT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "sheet_name": "Products",
    "skip_rows": 2,
    "header_row": 0
  }'

Exemplo de Requisição - CSV

curl -X PUT "https://maestro.dadosfera.ai/storage-explorer/datasets/ds_x1y2z3/refresh-schema" \
  -H "Authorization: <JWT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "delimiter": ";",
    "encoding": "ISO-8859-1",
    "skip_rows": 1
  }'

Exemplo de Resposta

Success (200 OK):

{
  "dataset_id": "ds_a2b3c4",
  "dataset_name": "products_jan.xlsx",
  "status": "schema_refreshed",
  "parsing_options": {
    "sheet_name": "Products",
    "skip_rows": 2,
    "header_row": 0
  },
  "schema": {
    "columns": [
      {
        "name": "product_id",
        "inferred_type": "VARCHAR",
        "nullable": false,
        "position": 0
      },
      {
        "name": "product_name",
        "inferred_type": "VARCHAR",
        "nullable": false,
        "position": 1
      },
      {
        "name": "price",
        "inferred_type": "DECIMAL",
        "nullable": true,
        "precision": 10,
        "scale": 2,
        "position": 2
      },
      {
        "name": "stock_quantity",
        "inferred_type": "INTEGER",
        "nullable": true,
        "position": 3
      }
    ],
    "row_count": 850,
    "analyzed_rows": 850
  },
  "refreshed_at": "2024-01-15T14:30:00Z"
}

Casos de Uso

Excel com Múltiplas Linhas de Cabeçalho

{
  "skip_rows": 3,
  "header_row": 0
}

CSV com Delimitador Diferente

{
  "delimiter": "|",
  "encoding": "UTF-8"
}

Excel - Selecionar Sheet Específica

{
  "sheet_name": "Sales_Q1"
}

Códigos de Status

Código	Descrição
200	Schema atualizado com sucesso
400	Opções de parsing inválidas
401	Não autenticado
403	Sem permissão STORAGE_EXPLORER.WRITE
404	Dataset não encontrado
422	Formato de arquivo não suporta as opções fornecidas