Validate Schema Compatibility

Valida se o schema de um dataset é compatível com o schema de uma tabela antes de vincular.

Endpoint

POST /storage-explorer/tables/{tableId}/validate-compatibility/{datasetId}

Permissões Requeridas

• STORAGE_EXPLORER.READ

Path Parameters

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

Exemplo de Requisição

curl -X POST "https://maestro.dadosfera.ai/storage-explorer/tables/tbl_a1b2c3d4e5f6/validate-compatibility/ds_x1y2z3" \
  -H "Authorization: <JWT_TOKEN>"

Exemplo de Resposta

Compatible (200 OK):

{
  "compatible": true,
  "table_id": "tbl_a1b2c3d4e5f6",
  "dataset_id": "ds_x1y2z3",
  "validation_details": {
    "column_count_match": true,
    "all_columns_present": true,
    "type_compatibility": true,
    "warnings": [
      "Column 'total_amount' in dataset has more decimal places than table allows"
    ]
  },
  "column_mapping": [
    {
      "table_column": "order_id",
      "dataset_column": "order_id",
      "table_type": "VARCHAR(50)",
      "dataset_type": "TEXT",
      "compatible": true
    },
    {
      "table_column": "customer_id",
      "dataset_column": "customer_id",
      "table_type": "VARCHAR(50)",
      "dataset_type": "TEXT",
      "compatible": true
    },
    {
      "table_column": "order_date",
      "dataset_column": "order_date",
      "table_type": "TIMESTAMP",
      "dataset_type": "TIMESTAMP",
      "compatible": true
    },
    {
      "table_column": "total_amount",
      "dataset_column": "total_amount",
      "table_type": "DECIMAL(10,2)",
      "dataset_type": "DECIMAL(12,4)",
      "compatible": true,
      "warning": "Precision may be truncated"
    }
  ]
}

Incompatible (200 OK):

{
  "compatible": false,
  "table_id": "tbl_a1b2c3d4e5f6",
  "dataset_id": "ds_x1y2z3",
  "validation_details": {
    "column_count_match": false,
    "all_columns_present": false,
    "type_compatibility": false,
    "errors": [
      "Missing required column: customer_id",
      "Type mismatch on column: order_date"
    ]
  },
  "missing_columns": ["customer_id"],
  "extra_columns": ["client_id"],
  "type_mismatches": [
    {
      "column": "order_date",
      "table_type": "TIMESTAMP",
      "dataset_type": "VARCHAR",
      "compatible": false,
      "reason": "Cannot convert VARCHAR to TIMESTAMP automatically"
    }
  ]
}

Response Fields

Campo	Tipo	Descrição
compatible	boolean	Se o dataset é compatível com a tabela
validation_details	object	Detalhes da validação
column_mapping	array	Mapeamento de colunas
missing_columns	array	Colunas faltantes no dataset
extra_columns	array	Colunas extras no dataset
type_mismatches	array	Incompatibilidades de tipo

Códigos de Status

Código	Descrição
200	Validação realizada (compatível ou não)
401	Não autenticado
403	Sem permissão STORAGE_EXPLORER.READ
404	Tabela ou dataset não encontrado