Отображение данных в табличном формате

Большинство узлов PolyAnalyst представляют собой табличные данные. Результаты других узлов должны быть выведены в табличный формат явным образом, однако для этого их необходимо соединить с узлом Производная таблица. Существуют два способа получения доступа к табличному типу данных:

  • простой способ для небольших таблиц (меньше или равно 1000 записей);

  • комплексный способ для больших таблиц (более 1000 записей).

Простой метод выполняется с помощью простых команд, описанных ниже. При комплексном методе необходимо выполнить несколько команд. Каждая команда будет возвращать только часть табличных данных.

Предварительный просмотр таблицы

Данный запрос позволяет выполнить предварительный просмотр таблицы: для таблиц будут отображаться первые 1000 строк; для текста и строковых данных – 250 символов, для чисел – округление до 6 цифр после десятичной точки.

URL

/dataset/preview

Метод

GET

Диапазон

project_view

Тип ответа

sync

Параметры запроса

Имя Тип Обязательный Описание

prjUUID

строка

да

ID проекта.

name

строка

да

Имя узла.

type

строка

да

Тип узла (только "Dataset" и "DataSource").

writeEmptyValues

булевый

нет

Флаг, указывающий, показывать ли пустые значения, например, "" для строковых значений и null для чисел; "false" по умолчанию.

precision

число

нет

Количество цифр, отображаемых после десятичной точки для вещественных значений. Допустимые значения – от 0 до 17. Значение по умолчанию равно 6. Если данное значение меньше 0 или больше 17, вещественное значение будет приведено до нижней или верхней границы соответственно.

Параметр prjUUID должен являться действительным ID проекта.

Тело запроса (application/json)

<отсутствует>

Пример URL-запроса

https://your.polyanalyst.server:port/polyanalyst/api/v1.0/dataset/preview?prjUUID=78f885e1-cba9-47ac-a31b-daf0dda7a0e2&name=CarData.csv&type=DataSource&writeEmptyValues=false&precision=6

Тело ответа (application/json)

Данный метод вернет набор данных в формате JSON в виде массива объектов.

[
  {
    "Mpg": 18,
    "Cylinders": 8,
    "Displacement": 307,
    "Power": 130,
    "Weight": 3504,
    "Acceleration": 12,
    "Year": 70,
    "Origin": "USA",
    "Model": "Chevrolet Chevelle Malibu"
  },
  {
    "Mpg": 15,
    "Cylinders": 8,
    "Displacement": 350,
    "Power": 165,
    "Weight": 3693,
    "Acceleration": 11.5,
    "Year": 70,
    "Origin": "USA",
    "Model": "Buick Skylark 320"
  }
]

Каждая запись – это один объект, каждая строка представляет одно свойство этого объекта. Количество объектов в массиве равно количеству записей в наборе данных (при ограничении в 1000 строк в таблице).

Пример URL-запроса

https://your.polyanalyst.server:port/polyanalyst/api/v1.0/dataset/preview?prjUUID=78f885e1-cba9-47ac-a31b-daf0dda7a0e2&name=CarData.csv&type=DataSource&writeEmptyValues=false&precision=6

Примеры ответов

Код Тело ответа и его описание

200

Успех.

[
  {
    "Mpg": 18,
    "Cylinders": 8,
    "Displacement": 307,
    "Power": 130,
    "Weight": 3504,
    "Acceleration": 12,
    "Year": 70,
    "Origin": "USA",
    "Model": "Chevrolet Chevelle Malibu"
  },
  {
    "Mpg": 15,
    "Cylinders": 8,
    "Displacement": 350,
    "Power": 165,
    "Weight": 3693,
    "Acceleration": 11.5,
    "Year": 70,
    "Origin": "USA",
    "Model": "Buick Skylark 320"
  }
]

500

Ошибка – prjUUID является недопустимой строкой для UUID.

{
  "error": {
    "code": 500,
    "title": "",
    "message": "Failed to create UUID from string"
  }
}

500

Ошибка – проект с указанным ID не найден на сервере.

{
  "error": {
    "code": 500,
    "title": "",
    "message": "Project or report record '322cf2c1-d054-4963-a0e0-f5b189906301' is absent"
  }
}

500

Ошибка – объект с указанными именем и типом на найден на сервере.

{
  "error": {
    "code": 500,
    "title": "",
    "message": "Internal error - attempt to access object via null pointer"
  }
}

500

Ошибка – узел не выполнен.

{
  "error": {
    "code": 500,
    "title": "",
    "message": "Dataset is not executed"
  }
}