Преобразование Excel в SQL — API Aspose.Cells Cloud

Этот REST API преобразует файл таблицы в формат SQL.

Необходимые условия
Для использования этого эндпоинта необходимо иметь действительный JWT-токен, сгенерированный в соответствии с инструкциями, описанными в руководстве по аутентификации по JWT-токену. API поддерживает Excel-файлы размером до предельных значений, указанных в документации сервиса, и может обрабатывать защищённые паролем книги при условии передачи параметра запроса password.

API PostConvertWorkbookToSQL

POST https://api.aspose.cloud/v3.0/cells/convert/sql

Безопасность и аутентификация

Облачные API Aspose.Cells защищены и требуют аутентификации по JWT-токену.

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

Имя параметра Тип Описание
password string Пароль, необходимый для открытия Excel-файла.
storageName string Имя хранилища, в котором сохранён файл.
checkExcelRestriction bool Указывает, следует ли проверять ограничения Excel-файла при изменении объектов, связанных с ячейками.

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

Имя параметра Тип Описание
datafile data file Файл таблицы, подлежащий преобразованию; включается как первая часть запроса.

Ответ

API возвращает объект FileInfo, содержащий сгенерированный SQL-файл.

Поле Тип Описание
Filename string Имя SQL-файла (например, example.sql).
FileSize int Размер файла в байтах.
FileContent string Содержимое SQL-файла в кодировке Base64.

FileInfo

Коды HTTP-статуса

Код Значение Описание
200 OK (ОК) Фильтр применён успешно; ответ содержит данные об операции.
400 Bad Request (Неверный запрос) Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401 Unauthorized (Неавторизован) Неверный или отсутствующий JWT-токен.
413 Payload Too Large (Слишком большой payload) Загруженный файл превышает ограничение по размеру.
500 Internal Server Error (Внутренняя ошибка сервера) Непредвиденная ошибка сервера.

Как использовать API PostConvertWorkbookToSQL с SDK

Спецификация API PostConvertWorkbookToSQL

Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Для простого доступа к веб-сервисам Aspose.Cells можно использовать утилиту командной строки cURL. Пример ниже показывает, как выполнять вызовы облачного API с помощью cURL.

Использование SDK Aspose.Cells Cloud

Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.

Примеры кода ниже демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:

Другие API, реализующие эту функцию

  • POST /cells/{name}/saveAs – Сохраняет книгу в другом формате и сохраняет результат в указанном хранилище.

  • PUT /cells/convert – Преобразует книгу в другой формат с возможностью задать дополнительные настройки и возвращает результат в ответе.

  • GET /cells/{name} – Получает книгу с возможностью задать дополнительные настройки преобразования.

Примечания

  • При преобразовании защищённых паролем Excel-файлов обязательно передавайте параметр запроса password, иначе преобразование завершится с ошибкой 400.
  • Сервис возвращает содержимое SQL-файла в кодировке Base64; перед сохранением в файл .sql его необходимо декодировать.

Примеры файлов
Скачайте пример Excel-книги здесь и предварительно сгенерированный SQL-результат здесь, чтобы быстро протестировать API.

Конвертирование Excel в HTML