Руководство пользователя для разработчиков

Создание таблиц с помощью SQL API

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

Для создания и отображения связанных наборов данных в вашем аккаунте необходимо применить функцию CDB_CartodbfyTable к целевой таблице. Этот дополнительный шаг «CARTOfying» данных заключается в преобразовании произвольной таблицы PostgreSQL в допустимую таблицу Epsilon Metrics и регистрации ее в системе, чтобы она могла быть использована в графическом интерфейсе пользователя и Epsilon Metrics Engine для создания карт и анализа.

Создание таблиц

Чтобы создать видимую таблицу в Epsilon Metrics, выполните следующий SQL-запрос с помощью SQL API:

CREATE TABLE {table_name}
 (
 {column1} {data type},
 {column2} {data type},
 {column3} {data type},
 ...
 );

Хотя это начинает процесс создания структуры для таблицы, она все еще не видна на вашем дашборде. Выполните следующий запрос, чтобы сделать таблицу видимой.

SELECT cdb_cartodbfytable({table_name});

Подсказка: Если вы принадлежите к организации, вы также должны указать имя пользователя как часть запроса.

SELECT cdb_cartodbfytable({username}, {table_name});

Вы получите ошибку Please set user quota before cartodbfying tables, если не включите имя пользователя в запрос.

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

Переименование таблиц

Чтобы переименовать подключенный набор данных на дашборде Ваши наборы данных, выполните следующий SQL-запрос с помощью SQL API:

ALTER TABLE {table_name} RENAME to {renamed table_name};

Может потребоваться несколько секунд, чтобы переименованная таблица появилась. Обновите браузер, чтобы убедиться, что вы можете визуализировать изменения на дашборде Ваши наборы данных.

Удаление таблицы

Если вы удаляете таблицу, любые карты, использующие подключенный набор данных, будут затронуты. Удаленный набор данных невозможно восстановить. Даже если вы создадите новую таблицу с тем же именем, что и удаленная таблица, Epsilon Metrics все равно будет воспринимать ее как другую таблицу.

Некоторые пользователи и сторонние библиотеки обновляют данные из набора данных карты, выполняя DROP TABLE + CREATE TABLE + INSERT в таблице. Если вы делаете это, ваша карта будет затронута, если вы не выполните DROP TABLE + CREATE TABLE в рамках транзакции. Но наша рекомендация - использовать TRUNCATE TABLE + INSERT.

Для удаления подключенного набора данных с дашборда Ваши наборы данных выполните следующий SQL-запрос с помощью SQL API:

DROP TABLE {table_name};

Это удалит подключенную таблицу с дашборда Ваши наборы данных. Обновите браузер, чтобы убедиться, что подключенный набор данных был удален.