Get Table Datasets

Obter todos os datasets vinculados a uma tabela

Get Table Datasets

Lista todos os datasets vinculados a uma tabela específica.

Endpoint

GET /storage-explorer/tables/{tableId}/datasets

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/datasets" \
  -H "Authorization: <JWT_TOKEN>"

Exemplo de Resposta

Success (200 OK):

{
  "table_id": "tbl_a1b2c3d4e5f6",
  "table_name": "customer_orders",
  "datasets": [
    {
      "dataset_id": "ds_x1y2z3",
      "dataset_name": "orders_2024_01.csv",
      "file_path": "/uploads/2024/01/orders_2024_01.csv",
      "file_size_bytes": 524288,
      "file_format": "csv",
      "linked_at": "2024-01-15T11:00:00Z",
      "row_count": 5420,
      "status": "active",
      "last_sync": "2024-01-15T12:00:00Z"
    },
    {
      "dataset_id": "ds_a2b3c4",
      "dataset_name": "orders_2024_02.csv",
      "file_path": "/uploads/2024/02/orders_2024_02.csv",
      "file_size_bytes": 612352,
      "file_format": "csv",
      "linked_at": "2024-02-01T09:30:00Z",
      "row_count": 6200,
      "status": "active",
      "last_sync": "2024-02-01T10:00:00Z"
    }
  ],
  "total_datasets": 2,
  "total_rows": 11620
}

Response Fields

CampoTipoDescrição
datasetsarrayLista de datasets vinculados
datasets[].dataset_idstringID do dataset
datasets[].dataset_namestringNome do arquivo do dataset
datasets[].file_pathstringCaminho do arquivo no storage
datasets[].file_formatstringFormato do arquivo (csv, json, parquet, excel)
datasets[].linked_atstringData de vinculação
datasets[].statusstringStatus do vínculo (active, inactive)
total_datasetsintegerTotal de datasets vinculados

Códigos de Status

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