Link Dataset to Table

Vincula um dataset existente a uma tabela, permitindo importação de dados.

Endpoint

POST /storage-explorer/tables/{tableId}/datasets/{datasetId}

Permissões Requeridas

• STORAGE_EXPLORER.WRITE

Path Parameters

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

Validações

Antes de vincular, o endpoint valida:

• Compatibilidade de schemas entre dataset e tabela
• Tipos de dados compatíveis
• Nomes de colunas correspondentes

Exemplo de Requisição

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

Exemplo de Resposta

Success (201 Created):

{
  "link_id": "lnk_m1n2o3p4",
  "table_id": "tbl_a1b2c3d4e5f6",
  "dataset_id": "ds_x1y2z3",
  "linked_at": "2024-01-15T11:00:00Z",
  "status": "active",
  "validation": {
    "compatible": true,
    "schema_matched": true,
    "warnings": []
  }
}

Schema Incompatibility (400 Bad Request):

{
  "error": "Schema incompatibility",
  "message": "Dataset schema does not match table schema",
  "details": {
    "missing_columns": ["customer_id"],
    "extra_columns": ["client_id"],
    "type_mismatches": [
      {
        "column": "order_date",
        "table_type": "TIMESTAMP",
        "dataset_type": "VARCHAR"
      }
    ]
  }
}

Códigos de Status

Código	Descrição
201	Dataset vinculado com sucesso
400	Schemas incompatíveis
401	Não autenticado
403	Sem permissão STORAGE_EXPLORER.WRITE
404	Tabela ou dataset não encontrado
409	Dataset já vinculado a esta tabela