Руководство пользователя

Руководство пользователя

Как экспортировать данные в Epsilon Metrics

Обзор различных вариантов экспорта данных из вашей учетной записи Epsilon Metrics.

В Epsilon Metrics имеются различные варианты загрузки ваших наборов данных Epsilon Metrics или результатов SQL-запросов, примененных к вашим наборам данных Epsilon Metrics.

В этом руководстве мы расскажем вам о параметрах экспорта, доступных в интерфейсе набора данных Epsilon Metrics и API Epsilon Metrics SQL.

Набор данных Epsilon Metrics

Когда набор данных Epsilon Metrics открыт, Epsilon Metrics показывает интерфейс с различными элементами, такими как заголовок набора данных, сами данные, кнопка панели SQL и некоторые другие параметры.

Чтобы экспортировать данные набора данных Epsilon Metrics, нам нужно кликнуть по параметру экспорта, расположенному в верхней правой части набора данных:

export_dataset

После нажатия кнопки «Экспорт» появится меню с несколькими вариантами загрузки набора данных. Выберите нужный вам и нажмите на кнопку загрузки:

export_format

API Epsilon Metrics SQL используется в фоновом режиме при экспорте этих данных. Поэтому имеются ограничения API Epsilon Metrics SQL нашей учетной записи.

Важно отметить, что выбор опции экспорта не обязательно приводит к загрузке всех данных набора данных. Экспортируются только те данные, которые были получены в результате запроса панели SQL набора данных. Например, если вы примените пользовательский запрос SELECT * FROM tableName WHERE column < X вместо запроса SELECT * FROM tableName по умолчанию для набора данных, Epsilon Metrics загрузит результат пользовательского запроса, а не строки и столбцы всего набора данных.

API Epsilon Metrics SQL

API Epsilon Metrics SQL предлагает два способа загрузки данных нашего набора данных Epsilon Metrics.

1. Запрос API Epsilon Metrics SQL с параметром формата

Мы можем использовать API Epsilon Metrics SQL для получения результата SQL-запроса, примененного к нашему набору данных Epsilon Metrics. Результат содержится в ответе на запрос. Например:

https://username.epsilonmetrics.ru/api/v2/sql?q=SELECT * FROM table_name

Если мы хотим загрузить результат запроса в виде файла, нам нужно добавить в наш запрос API Epsilon Metrics SQL параметр формата. Например, в следующем запросе мы загружаем данные из таблицы с именем table_name в виде файла GeoJSON:

https://username.epsilonmetrics.ru/api/v2/sql?format=GeoJSON&q=SELECT * FROM table_name

Другие форматы, доступные для загрузки файлов данных, вы можете найти в этом разделе нашего Центра разработчиков.

2. COPY TO

API Epsilon Metrics SQL очень полезен, но может появляться ошибка времени ожидания, если вы пытаетесь экспортировать слишком большие наборы данных.

Вот почему в API Epsilon Metrics SQL мы рекомендуем использовать команду COPY TO для экспорта больших наборов данных в виде файлов CSV. Подробную информацию об использовании команды COPY TO для экспорта данных вы можете найти в этом разделе нашего Центра разработчиков.

Команда COPY также имеет ограничения. Но ее ограничения отличаются от ограничений по умолчанию для API Epsilon Metrics SQL. Подробную информацию об ограничениях команды COPY вы можете найти в этом разделе Центра разработчиков Epsilon Metrics.

Библиотеки Epsilon Metrics

Если вы используете Python в качестве языка программирования, вы можете использовать Epsilon Metrics Python SDK или Epsilon Metricsframes для экспорта данных из своей учетной записи Epsilon Metrics.

Эти две библиотеки предоставляют методы, использующие API SQL (и другие API Epsilon Metrics). Вы можете использовать эти методы, чтобы определить собственный рабочий процесс для экспорта данных из вашей учетной записи Epsilon Metrics.

Советы

  • Мы не рекомендуем вам загружать наборы данных с линейной или многоугольной геометрией в формате CSV.

  • Если вам нужно загрузить большие наборы данных Epsilon Metrics в формате, отличном от CSV, вы можете экспортировать их «по частям», чтобы избежать ограничений времени ожидания API SQL.
    Например, мы можем загрузить данные нашего набора данных Epsilon Metrics двумя разными запросами в виде файлов геопакетов:

https://username.epsilonmetrics.ru/api/v2/sql?format=GPKG&q=SELECT * FROM table_name WHERE cartodb_id < 100000
https://username.epsilonmetrics.ru/api/v2/sql?format=GPKG&q=SELECT * FROM table_name WHERE cartodb_id >= 100000