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

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

Связи

При разработке решения с использованием Epsilon важно учитывать, что запросы и заявки отправляются в ваше собственное хранилище данных (или в хранилище по умолчанию, предоставляемое Epsilon), что обеспечивает два основных преимущества:

  • Непревзойденная масштабируемость и производительность с большими наборами геопространственных данных

  • Нет необходимости создавать и управлять ETL; данные остаются в вашей базе данных.

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

Внутри соединения

Соединение — это объект, который хранится и управляется Epsilon, и который содержит всю необходимую информацию для выполнения запросов в вашем хранилище данных. Каждое соединение обычно состоит из следующих атрибутов:

  • name: Имя, которое будет идентифицировать соединение в коде и в пользовательском интерфейсе.
  • provider: Поставщик хранилища данных — например, «Snowflake» или «BigQuery»
  • config: Набор элементов, определяющих соединение, включая, помимо прочего:
  • type: Метод аутентификации, используемый для этого соединения — например, «service_account»
  • credentials: Фактические учетные данные (включая секреты), используемые для аутентификации запроса к хранилищу данных. Это зависит от каждого поставщика и типа. Например, в Snowflake вам потребуется указать учетную запись, имя пользователя, базу данных и хранилище, а также другие необязательные поля, такие как роль.
  • privacy: Подключения могут быть частными или общими для организации или определенных групп пользователей. Подключения, которые может использовать данный пользователь, определяются этим атрибутом.

Есть и другие атрибуты, но перечисленные выше — самые важные.

Это пример соединения Snowflake в синтаксисе JSON.

{
    "name": "example_snowflake_connection",
    "provider_id": "snowflake",
    "config": {
        "type": "snowflake_account",
        "credentials": {
            "username": "YOUR_SNOWFLAKE_USERNAME",
            "password": "XXX",
            "account": "your-snowflake-account.us-east-1",
            "database": "YOUR_SNOWFLAKE_DATABASE",
            "warehouse": "YOUR_SNOWFLAKE_WAREHOUSE"
        }
    },
    "privacy": "private"
}

Создание и управление соединениями

Подключения создаются и управляются в Epsilon Workspace, в его собственном разделе. Следуйте этой документации, чтобы узнать, как создавать Подключения

Использование подключений в ваших приложениях

При разработке с Epsilon все запросы, которые достигают хранилища данных, всегда должны использовать определенное соединение. В API Карт и API SQL это определяется с помощью пути запроса:

https://api_base_url/v3/sql/:connection/query?q=select * from epsilon-demo-data.demo_tables.airports

Поскольку Connections привязаны к определенным учетным данным, они являются хорошим способом ограничить доступ к данным. Вы можете создать определенные учетные данные в вашем Data Warehouse и использовать их в качестве первого элемента управления безопасностью для вашего приложения.