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