Коннектор "Снежинка

Запрос информации из Snowflake для использования в приложениях Tulip

Коннектор Snowflake упрощает процесс запроса информации из облака данных Snowflake. Документацию по Snowflake SQL REST API можно найти здесь.

Контакт службы поддержки

Этот коннектор был создан в сотрудничестве с компанией Spaulding Ridge. Для получения дополнительной информации или вопросов, пожалуйста, свяжитесь с Spaulding Ridge по адресу info@spauldingridge.com.

Примечания к коннектору

Коннектор Snowflake может относительно легко работать с отдельными записями. Для запроса нескольких строк данных или манипулирования результатами в Tulip (интерактивная таблица и т. д.) могут потребоваться пользовательские виджеты.

Snowflake OAuth использует встроенный в Snowflake сервис OAuth и поддерживает Tulip в качестве пользовательского клиента. Документацию по Snowflake OAuth можно найти здесь. Подробности настройки пользовательского клиента можно найти здесь.

Настройка

В этом разделе описана процедура настройки OAuth-токена с OAuth-сервера Snowflake для установления соединения с Tulip в качестве клиента, а также шаги по настройке коннектора Snowflake в Tulip.

Регистрация Tulip в качестве клиентского приложения в Snowflake

1. Войдите в свой экземпляр Snowflake с пользователем, имеющим роль/привилегии для создания и управления интеграциями безопасности (ACCOUNTADMIN).
2. Создайте новую рабочую таблицу SQL в хранилище COMPUTE_WH.
3. Запустите следующий сценарий, чтобы создать интеграцию безопасности типа OAuth. Не забудьте обновить значения INTEGRATION_NAME, TULIP_INSTANCE_NAME и TIME_IN_SECONDS.

СОЗДАТЬ ИЛИ ЗАМЕНИТЬ ИНТЕГРАЦИЮ БЕЗОПАСНОСТИ <INTEGRATION_NAME>TYPE = OAUTHENABLED = TRUEOAUTH_CLIENT = CUSTOMOAUTH_CLIENT_TYPE = 'CONFIDENTIAL'OAUTH_REDIRECT_URI = 'https://<TULIP_INSTANCE_NAME>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

Примечание: Срок действия токена обновления может составлять 1 день (86400 секунд).

Получение подробной информации о конфигурации OAuth в Tulip

1. Выполните следующие команды, чтобы описать только что созданную интеграцию безопасности иDESCRIBE SECURITY INTEGRATION ;
2. Запишите следующие детали:OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. Выполнить:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<INTEGRATION_NAME>');

**должно быть полностью капитулировано,**например, не tulip_intergation, а TULIP_INTEGRATION

1. Запишите:OAUTH_CLIENT_SECRET

Настройте коннектор Snowflake

1. Войдите в Tulip и добавьте коннектор Snowflake из библиотеки Tulip сюда (Web или Embedded).
2. Перейдите в производственную среду
3. Установите следующие настройки:

Running On: Cloud Connector HostServer address: url сервера вашей учетной записи snowflake в формате .snowflakecomputing.comБазовый путь: api/v2AuthenticationВыберите службу или пользователя OAuthАвторизационный код URL - OAUTH_AUTHORIZATION_ENDPOINT из шага 2Адрес токена доступа URL - OAUTH_TOKEN_ENDPOINT из шага 2Идентификатор клиента - OAUTH_CLIENT_ID из шага 2Секрет клиента - OAUTH_CLIENT_SECRET из шага 2Установите флажки дляОтправлять заголовок аутентификацииКодировать идентификатор клиента при аутентификации

1. Нажмите кнопку Проверить. Вы попадете в окно входа в учетную запись Snowflake.

Пользователь должен войти в систему. Обратите внимание, что его роль по умолчанию не должна быть ACCOUNTADMIN, SECURITYADMIN или ORGADMIN. Вы можете изменить роль пользователя по умолчанию для OAuth, как подробно описано в этом ресурсе Snowflake: Управление согласием пользователей для OAuth.

1. После успешной аутентификации появится сообщение для получения согласия. Внимательно прочитайте его, чтобы понять, какая операция выполняется, а затем нажмите кнопку Разрешить.

Теперь вы можете безопасно подключаться к Snowflake из Tulip!

Использование

У вас есть два варианта начала использования коннектора:

Начните с настройки функций шаблона коннектора в соответствии с вашими конкретными требованиями.

Следуйте инструкциям Snowflake Unit Test для практической демонстрации того, как использовать коннектор для решения таких задач, как: получение всех записей таблицы Snowflake Table в Tulip, создание новой записи, обновление существующей записи и удаление записи.

Функции шаблонов

Коннектор Library включает в себя следующие шаблонные функции:Шаблон: Запрос к базе данныхОписание: Позволяет отправить один или несколько SQL-запросов на выполнение.Метод: POSTEndpoint: /api/v2/statementsReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: Проверить статус запросаОписание: Позволяет проверить статус выполнения запроса.Метод: GETEndpoint: /api/v2/statements/{statementHandle}Ссылка: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: Cancel QueryDescription: Позволяет отменить выполнение запроса.Метод: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel.

Дополнительные ссылки

Это руководство сообщества Snowflake содержит дополнительные сведения об интеграции Snowflake